--- title: "POST /v1/projects/{projectsId}/locations/{locationsId}:bulkDownloadFeedbackLabels" method: POST path: "/v1/projects/{projectsId}/locations/{locationsId}:bulkDownloadFeedbackLabels" tags: ["projects"] --- # POST /v1/projects/{projectsId}/locations/{locationsId}:bulkDownloadFeedbackLabels `POST /v1/projects/{projectsId}/locations/{locationsId}:bulkDownloadFeedbackLabels` ## Request - Base URL: `https://contactcenterinsights.googleapis.com` - URL: `https://contactcenterinsights.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}:bulkDownloadFeedbackLabels` - Auth: OAuth 2 and OAuth 2 - Implicit: `https://accounts.google.com/o/oauth2/auth` - Scopes: `https://www.googleapis.com/auth/cloud-platform` - Authorization code: `https://accounts.google.com/o/oauth2/auth` - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform` Download feedback labels in bulk from an external source. Currently supports exporting Quality AI example conversations with transcripts and question bodies. ## Path parameters - `projectsId` string, required - `locationsId` string, required ## Request body - GoogleCloudContactcenterinsightsV1BulkDownloadFeedbackLabelsRequest: Request for the BulkDownloadFeedbackLabel endpoint. - `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. - `feedbackLabelType` 'FEEDBACK_LABEL_TYPE_UNSPECIFIED' | 'QUALITY_AI' | 'TOPIC_MODELING' | 'AGENT_ASSIST_SUMMARY': Optional. The type of feedback labels that will be downloaded. - `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 - `gcsDestination` GoogleCloudContactcenterinsightsV1BulkDownloadFeedbackLabelsRequestGcsDestination: Google Cloud Storage Object details to write the feedback labels to. - `addWhitespace` boolean: Optional. Add whitespace to the JSON file. Makes easier to read, but increases file size. Only applicable for JSON 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. - `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` - `recordsPerFileCount` string, int64: Optional. The number of records per file. Applicable for either format. - `maxDownloadCount` integer: Optional. Limits the maximum number of feedback labels that will be downloaded. The first `N` feedback labels will be downloaded. - `parent` string: Required. The parent resource for new feedback labels. - `sheetsDestination` GoogleCloudContactcenterinsightsV1BulkDownloadFeedbackLabelsRequestSheetsDestination: Google Sheets document details to write the feedback labels to. - `sheetTitle` string: Optional. The title of the new sheet 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. - `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. ## Response `200` Successful response - GoogleLongrunningOperation: This resource represents a long-running operation that is the result of a network API call. - `done` boolean: If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available. - `error` GoogleRpcStatus: The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `code` integer: The status code, which should be an enum value of google.rpc.Code. - `details` object[]: A list of messages that carry the error details. There is a common set of message types for APIs to use. - `message` string: A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client. - `metadata` object: Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any. - `name` string: The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`. - `response` object: The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`. --- [API](https://skmtc.dev/google/apis/contactcenterinsights.md) - [All operations](https://skmtc.dev/google/apis/contactcenterinsights/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/contactcenterinsights/revisions/895c3ce55ea0?raw)