---
title: "POST /v1/{+parent}:bulkDownloadFeedbackLabels"
method: POST
path: "/v1/{+parent}:bulkDownloadFeedbackLabels"
tags: ["projects"]
---

# POST /v1/{+parent}:bulkDownloadFeedbackLabels

`POST /v1/{+parent}:bulkDownloadFeedbackLabels`

Download feedback labels in bulk from an external source. Currently supports exporting Quality AI example conversations with transcripts and question bodies.

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudContactcenterinsightsV1BulkDownloadFeedbackLabelsRequest — Request for the BulkDownloadFeedbackLabel endpoint.
  - `sheetsDestination` GoogleCloudContactcenterinsightsV1BulkDownloadFeedbackLabelsRequestSheetsDestination — Google Sheets document details to write the feedback labels to.
    - `spreadsheetUri` string — Required. The Google Sheets document to write the feedback labels to. Retrieved from Google Sheets URI. E.g. `https://docs.google.com/spreadsheets/d/1234567890` The spreadsheet must be shared with the Insights P4SA. The spreadsheet ID written to will be returned as `file_names` in the BulkDownloadFeedbackLabelsMetadata.
    - `sheetTitle` string — Optional. The title of the new sheet to write the feedback labels to.
  - `filter` string — Optional. A filter to reduce results to a specific subset. Supports disjunctions (OR) and conjunctions (AND). Supported fields: * `issue_model_id` * `qa_question_id` * `qa_scorecard_id` * `min_create_time` * `max_create_time` * `min_update_time` * `max_update_time` * `feedback_label_type`: QUALITY_AI, TOPIC_MODELING
  - `feedbackLabelType` 'FEEDBACK_LABEL_TYPE_UNSPECIFIED' | 'QUALITY_AI' | 'TOPIC_MODELING' | 'AGENT_ASSIST_SUMMARY' — Optional. The type of feedback labels that will be downloaded.
  - `gcsDestination` GoogleCloudContactcenterinsightsV1BulkDownloadFeedbackLabelsRequestGcsDestination — Google Cloud Storage Object details to write the feedback labels to.
    - `recordsPerFileCount` string, int64 — Optional. The number of records per file. Applicable for either format.
    - `alwaysPrintEmptyFields` boolean — Optional. Always print fields with no presence. This is useful for printing fields that are not set, like implicit 0 value or empty lists/maps. Only applicable for JSON format.
    - `addWhitespace` boolean — Optional. Add whitespace to the JSON file. Makes easier to read, but increases file size. Only applicable for JSON format.
    - `format` 'FORMAT_UNSPECIFIED' | 'CSV' | 'JSON' — Required. File format in which the labels will be exported.
    - `objectUri` string — Required. The Google Cloud Storage URI to write the feedback labels to. The file name will be used as a prefix for the files written to the bucket if the output needs to be split across multiple files, otherwise it will be used as is. The file extension will be appended to the file name based on the format selected. E.g. `gs://bucket_name/object_uri_prefix`
  - `parent` string — Required. The parent resource for new feedback labels.
  - `maxDownloadCount` integer — Optional. Limits the maximum number of feedback labels that will be downloaded. The first `N` feedback labels will be downloaded.
  - `templateQaScorecardId` string[] — Optional. If set, a template for labeling conversations and scorecard questions will be created from the conversation_filter and the questions under the scorecard(s). The feedback label `filter` will be ignored.
  - `conversationFilter` string — Optional. Filter parent conversations to download feedback labels for. When specified, the feedback labels will be downloaded for the conversations that match the filter. If `template_qa_scorecard_id` is set, all the conversations that match the filter will be paired with the questions under the scorecard for labeling.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/contactcenterinsights.md) · [All operations](https://skmtc.net/google/apis/contactcenterinsights/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/contactcenterinsights/versions/e071ddf4dfc3/schema)