Method: projects.locations.conversations.upload

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

HTTP request

POST https://contactcenterinsights.googleapis.com/v1alpha1/{parent=projects/*/locations/*}/conversations:upload

The URL uses 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.