Method: projects.locations.conversations.ingest

Stay organized with collections Save and categorize content based on your preferences.

Imports conversations and processes them according to the user's configuration.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent resource for new conversations.

Request body

The request body contains data with the following structure:

JSON representation
{
  "conversationConfig": {
    object (ConversationConfig)
  },

  // Union field source can be only one of the following:
  "gcsSource": {
    object (GcsSource)
  }
  // End of list of possible types for union field source.

  // Union field object_config can be only one of the following:
  "transcriptObjectConfig": {
    object (TranscriptObjectConfig)
  }
  // End of list of possible types for union field object_config.
}
Fields
conversationConfig

object (ConversationConfig)

Configuration that applies to all conversations.

Union field source. Configuration for an external data store containing objects that will be converted to conversations. source can be only one of the following:
gcsSource

object (GcsSource)

A cloud storage bucket source.

Union field object_config. Configuration for converting individual source objects to conversations. object_config can be only one of the following:
transcriptObjectConfig

object (TranscriptObjectConfig)

Configuration for when source contains conversation transcripts.

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.create

For more information, see the IAM documentation.

GcsSource

Configuration for Cloud Storage bucket sources.

JSON representation
{
  "bucketUri": string
}
Fields
bucketUri

string

Required. The Cloud Storage bucket containing source objects.

TranscriptObjectConfig

Configuration for processing transcript objects.

JSON representation
{
  "medium": enum (Medium)
}
Fields
medium

enum (Medium)

Required. The medium transcript objects represent.

ConversationConfig

Configuration that applies to all conversations.

JSON representation
{
  "agentId": string
}
Fields
agentId

string

An opaque, user-specified string representing the human agent who handled the conversations.