Method: projects.locations.conversations.upload

Create a long-running conversation upload operation. This method differs from conversations.create by allowing audio transcription and optional DLP redaction.

HTTP request

POST https://{endpoint}/v1alpha1/{parent=projects/*/locations/*}/conversations:upload

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent resource of the conversation.

Request body

The request body contains data with the following structure:

JSON representation
{
  "conversation": {
    object (Conversation)
  },
  "conversationId": string,
  "redactionConfig": {
    object (RedactionConfig)
  },
  "speechConfig": {
    object (SpeechConfig)
  }
}
Fields
conversation

object (Conversation)

Required. The conversation resource to create.

conversationId

string

Optional. A unique ID for the new conversation. This ID will become the final component of the conversation's resource name. If no ID is specified, a server-generated ID will be used.

This value should be 4-64 characters and must match the regular expression ^[a-z0-9-]{4,64}$. Valid characters are [a-z][0-9]-

redactionConfig

object (RedactionConfig)

Optional. DLP settings for transcript redaction. Will default to the config specified in Settings.

speechConfig

object (SpeechConfig)

Optional. Speech-to-Text configuration. Will default to the config specified in Settings.

Response body

If successful, the response body contains an instance of Operation.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • contactcenterinsights.conversations.upload

For more information, see the IAM documentation.