Contact Center AI Insights API . projects . locations

Instance Methods

analysisRules()

Returns the analysisRules Resource.

authorizedViewSets()

Returns the authorizedViewSets Resource.

conversations()

Returns the conversations Resource.

encryptionSpec()

Returns the encryptionSpec Resource.

insightsdata()

Returns the insightsdata Resource.

issueModels()

Returns the issueModels Resource.

operations()

Returns the operations Resource.

phraseMatchers()

Returns the phraseMatchers Resource.

qaScorecards()

Returns the qaScorecards Resource.

views()

Returns the views Resource.

bulkDownloadFeedbackLabels(parent, body=None, x__xgafv=None)

Download feedback labels in bulk.

bulkUploadFeedbackLabels(parent, body=None, x__xgafv=None)

Upload feedback labels in bulk.

close()

Close httplib2 connections.

getEncryptionSpec(name, x__xgafv=None)

Gets location-level encryption key specification.

getSettings(name, x__xgafv=None)

Gets project-level settings.

listAllFeedbackLabels(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

List all feedback labels by project number.

listAllFeedbackLabels_next()

Retrieves the next page of results.

queryMetrics(location, body=None, x__xgafv=None)

Query metrics.

updateSettings(name, body=None, updateMask=None, x__xgafv=None)

Updates project-level settings.

Method Details

bulkDownloadFeedbackLabels(parent, body=None, x__xgafv=None)
Download feedback labels in bulk.

Args:
  parent: string, Required. The parent resource for new feedback labels. (required)
  body: object, The request body.
    The object takes the form of:

{ # Request for the BulkDownloadFeedbackLabel endpoint.
  "conversationFilter": "A 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": "A String", # Optional. The type of feedback labels that will be downloaded.
  "filter": "A 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": { # Google Cloud Storage Object details to write the feedback labels to. # A cloud storage bucket destination.
    "addWhitespace": True or False, # Optional. Add whitespace to the JSON file. Makes easier to read, but increases file size. Only applicable for JSON format.
    "alwaysPrintEmptyFields": True or False, # 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": "A String", # Required. File format in which the labels will be exported.
    "objectUri": "A 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": "A String", # Optional. The number of records per file. Applicable for either format.
  },
  "maxDownloadCount": 42, # Optional. Limits the maximum number of feedback labels that will be downloaded. The first `N` feedback labels will be downloaded.
  "parent": "A String", # Required. The parent resource for new feedback labels.
  "templateQaScorecardId": [ # 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.
    "A String",
  ],
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # This resource represents a long-running operation that is the result of a network API call.
  "done": True or False, # 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": { # 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). # The error result of the operation in case of failure or cancellation.
    "code": 42, # The status code, which should be an enum value of google.rpc.Code.
    "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
      {
        "a_key": "", # Properties of the object. Contains field @type with type URL.
      },
    ],
    "message": "A 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": { # 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.
    "a_key": "", # Properties of the object. Contains field @type with type URL.
  },
  "name": "A 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": { # 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`.
    "a_key": "", # Properties of the object. Contains field @type with type URL.
  },
}
bulkUploadFeedbackLabels(parent, body=None, x__xgafv=None)
Upload feedback labels in bulk.

Args:
  parent: string, Required. The parent resource for new feedback labels. (required)
  body: object, The request body.
    The object takes the form of:

{ # The request for bulk uploading feedback labels.
  "gcsSource": { # Google Cloud Storage Object details to get the feedback label file from. # A cloud storage bucket source.
    "format": "A String", # Required. File format which will be ingested.
    "objectUri": "A String", # Required. The Google Cloud Storage URI of the file to import. Format: `gs://bucket_name/object_name`
  },
  "validateOnly": True or False, # Optional. If set, upload will not happen and the labels will be validated. If not set, then default behavior will be to upload the labels after validation is complete.
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # This resource represents a long-running operation that is the result of a network API call.
  "done": True or False, # 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": { # 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). # The error result of the operation in case of failure or cancellation.
    "code": 42, # The status code, which should be an enum value of google.rpc.Code.
    "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
      {
        "a_key": "", # Properties of the object. Contains field @type with type URL.
      },
    ],
    "message": "A 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": { # 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.
    "a_key": "", # Properties of the object. Contains field @type with type URL.
  },
  "name": "A 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": { # 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`.
    "a_key": "", # Properties of the object. Contains field @type with type URL.
  },
}
close()
Close httplib2 connections.
getEncryptionSpec(name, x__xgafv=None)
Gets location-level encryption key specification.

Args:
  name: string, Required. The name of the encryption spec resource to get. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A customer-managed encryption key specification that can be applied to all created resources (e.g. `Conversation`).
  "kmsKey": "A String", # Required. The name of customer-managed encryption key that is used to secure a resource and its sub-resources. If empty, the resource is secured by our default encryption key. Only the key in the same location as this resource is allowed to be used for encryption. Format: `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{key}`
  "name": "A String", # Immutable. The resource name of the encryption key specification resource. Format: projects/{project}/locations/{location}/encryptionSpec
}
getSettings(name, x__xgafv=None)
Gets project-level settings.

Args:
  name: string, Required. The name of the settings resource to get. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # The CCAI Insights project wide settings. Use these settings to configure the behavior of Insights. View these settings with [`getsettings`](https://cloud.google.com/contact-center/insights/docs/reference/rest/v1/projects.locations/getSettings) and change the settings with [`updateSettings`](https://cloud.google.com/contact-center/insights/docs/reference/rest/v1/projects.locations/updateSettings).
  "analysisConfig": { # Default configuration when creating Analyses in Insights. # Default analysis settings.
    "annotatorSelector": { # Selector of all available annotators and phrase matchers to run. # To select the annotators to run and the phrase matchers to use (if any). If not specified, all annotators will be run.
      "issueModels": [ # The issue model to run. If not provided, the most recently deployed topic model will be used. The provided issue model will only be used for inference if the issue model is deployed and if run_issue_model_annotator is set to true. If more than one issue model is provided, only the first provided issue model will be used for inference.
        "A String",
      ],
      "phraseMatchers": [ # The list of phrase matchers to run. If not provided, all active phrase matchers will be used. If inactive phrase matchers are provided, they will not be used. Phrase matchers will be run only if run_phrase_matcher_annotator is set to true. Format: projects/{project}/locations/{location}/phraseMatchers/{phrase_matcher}
        "A String",
      ],
      "qaConfig": { # Configuration for the QA feature. # Configuration for the QA annotator.
        "scorecardList": { # Container for a list of scorecards. # A manual list of scorecards to score.
          "qaScorecardRevisions": [ # List of QaScorecardRevisions.
            "A String",
          ],
        },
      },
      "runEntityAnnotator": True or False, # Whether to run the entity annotator.
      "runIntentAnnotator": True or False, # Whether to run the intent annotator.
      "runInterruptionAnnotator": True or False, # Whether to run the interruption annotator.
      "runIssueModelAnnotator": True or False, # Whether to run the issue model annotator. A model should have already been deployed for this to take effect.
      "runPhraseMatcherAnnotator": True or False, # Whether to run the active phrase matcher annotator(s).
      "runQaAnnotator": True or False, # Whether to run the QA annotator.
      "runSentimentAnnotator": True or False, # Whether to run the sentiment annotator.
      "runSilenceAnnotator": True or False, # Whether to run the silence annotator.
      "runSummarizationAnnotator": True or False, # Whether to run the summarization annotator.
      "summarizationConfig": { # Configuration for summarization. # Configuration for the summarization annotator.
        "conversationProfile": "A String", # Resource name of the Dialogflow conversation profile. Format: projects/{project}/locations/{location}/conversationProfiles/{conversation_profile}
        "summarizationModel": "A String", # Default summarization model to be used.
      },
    },
    "runtimeIntegrationAnalysisPercentage": 3.14, # Percentage of conversations created using Dialogflow runtime integration to analyze automatically, between [0, 100].
    "uploadConversationAnalysisPercentage": 3.14, # Percentage of conversations created using the UploadConversation endpoint to analyze automatically, between [0, 100].
  },
  "conversationTtl": "A String", # The default TTL for newly-created conversations. If a conversation has a specified expiration, that value will be used instead. Changing this value will not change the expiration of existing conversations. Conversations with no expire time persist until they are deleted.
  "createTime": "A String", # Output only. The time at which the settings was created.
  "languageCode": "A String", # A language code to be applied to each transcript segment unless the segment already specifies a language code. Language code defaults to "en-US" if it is neither specified on the segment nor here.
  "name": "A String", # Immutable. The resource name of the settings resource. Format: projects/{project}/locations/{location}/settings
  "pubsubNotificationSettings": { # A map that maps a notification trigger to a Pub/Sub topic. Each time a specified trigger occurs, Insights will notify the corresponding Pub/Sub topic. Keys are notification triggers. Supported keys are: * "all-triggers": Notify each time any of the supported triggers occurs. * "create-analysis": Notify each time an analysis is created. * "create-conversation": Notify each time a conversation is created. * "export-insights-data": Notify each time an export is complete. * "ingest-conversations": Notify each time an IngestConversations LRO is complete. * "update-conversation": Notify each time a conversation is updated via UpdateConversation. * "upload-conversation": Notify when an UploadConversation LRO is complete. Values are Pub/Sub topics. The format of each Pub/Sub topic is: projects/{project}/topics/{topic}
    "a_key": "A String",
  },
  "redactionConfig": { # DLP resources used for redaction while ingesting conversations. DLP settings are applied to conversations ingested from the `UploadConversation` and `IngestConversations` endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the `CreateConversation` endpoint or the Dialogflow / Agent Assist runtime integrations. When using Dialogflow / Agent Assist runtime integrations, redaction should be performed in Dialogflow / Agent Assist. # Default DLP redaction resources to be applied while ingesting conversations. This applies to conversations ingested from the `UploadConversation` and `IngestConversations` endpoints, including conversations coming from CCAI Platform.
    "deidentifyTemplate": "A String", # The fully-qualified DLP deidentify template resource name. Format: `projects/{project}/deidentifyTemplates/{template}`
    "inspectTemplate": "A String", # The fully-qualified DLP inspect template resource name. Format: `projects/{project}/locations/{location}/inspectTemplates/{template}`
  },
  "speechConfig": { # Speech-to-Text configuration. Speech-to-Text settings are applied to conversations ingested from the `UploadConversation` and `IngestConversations` endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the `CreateConversation` endpoint. # Optional. Default Speech-to-Text resources to use while ingesting audio files. Optional, CCAI Insights will create a default if not provided. This applies to conversations ingested from the `UploadConversation` and `IngestConversations` endpoints, including conversations coming from CCAI Platform.
    "speechRecognizer": "A String", # The fully-qualified Speech Recognizer resource name. Format: `projects/{project_id}/locations/{location}/recognizer/{recognizer}`
  },
  "updateTime": "A String", # Output only. The time at which the settings were last updated.
}
listAllFeedbackLabels(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)
List all feedback labels by project number.

Args:
  parent: string, Required. The parent resource of all feedback labels per project. (required)
  filter: string, Optional. A filter to reduce results to a specific subset in the entire project. Supports disjunctions (OR) and conjunctions (AND). Supported fields: * `issue_model_id` * `qa_question_id` * `min_create_time` * `max_create_time` * `min_update_time` * `max_update_time` * `feedback_label_type`: QUALITY_AI, TOPIC_MODELING
  pageSize: integer, Optional. The maximum number of feedback labels to return in the response. A valid page size ranges from 0 to 100,000 inclusive. If the page size is zero or unspecified, a default page size of 100 will be chosen. Note that a call might return fewer results than the requested page size.
  pageToken: string, Optional. The value returned by the last `ListAllFeedbackLabelsResponse`. This value indicates that this is a continuation of a prior `ListAllFeedbackLabels` call and that the system should return the next page of data.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # The response for listing all feedback labels.
  "feedbackLabels": [ # The feedback labels that match the request.
    { # Represents a conversation, resource, and label provided by the user.
      "createTime": "A String", # Output only. Create time of the label.
      "label": "A String", # String label.
      "labeledResource": "A String", # Resource name of the resource to be labeled.
      "name": "A String", # Immutable. Resource name of the FeedbackLabel. Format: projects/{project}/locations/{location}/conversations/{conversation}/feedbackLabels/{feedback_label}
      "qaAnswerLabel": { # Message for holding the value of a QaAnswer. QaQuestion.AnswerChoice defines the possible answer values for a question. # QaAnswer label.
        "boolValue": True or False, # Boolean value.
        "key": "A String", # A short string used as an identifier. Matches the value used in QaQuestion.AnswerChoice.key.
        "naValue": True or False, # A value of "Not Applicable (N/A)". Should only ever be `true`.
        "normalizedScore": 3.14, # Output only. Normalized score of the questions. Calculated as score / potential_score.
        "numValue": 3.14, # Numerical value.
        "potentialScore": 3.14, # Output only. The maximum potential score of the question.
        "score": 3.14, # Output only. Numerical score of the answer.
        "strValue": "A String", # String value.
      },
      "updateTime": "A String", # Output only. Update time of the label.
    },
  ],
  "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
}
listAllFeedbackLabels_next()
Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.
        
queryMetrics(location, body=None, x__xgafv=None)
Query metrics.

Args:
  location: string, Required. The location of the data. "projects/{project}/locations/{location}" (required)
  body: object, The request body.
    The object takes the form of:

{ # The request for querying metrics.
  "dimensions": [ # The dimensions that determine the grouping key for the query. Defaults to no dimension if this field is unspecified. If a dimension is specified, its key must also be specified. Each dimension's key must be unique. If a time granularity is also specified, metric values in the dimension will be bucketed by this granularity. Up to one dimension is supported for now.
    { # A dimension determines the grouping key for the query. In SQL terms, these would be part of both the "SELECT" and "GROUP BY" clauses.
      "agentDimensionMetadata": { # Metadata about the agent dimension. # Output only. Metadata about the agent dimension.
        "agentDisplayName": "A String", # Optional. The agent's name
        "agentId": "A String", # Optional. A user-specified string representing the agent.
        "agentTeam": "A String", # Optional. A user-specified string representing the agent's team.
      },
      "dimensionKey": "A String", # The key of the dimension.
      "issueDimensionMetadata": { # Metadata about the issue dimension. # Output only. Metadata about the issue dimension.
        "issueDisplayName": "A String", # The issue display name.
        "issueId": "A String", # The issue ID.
        "issueModelId": "A String", # The parent issue model ID.
      },
      "qaQuestionAnswerDimensionMetadata": { # Metadata about the QA question-answer dimension. This is useful for showing the answer distribution for questions for a given scorecard. # Output only. Metadata about the QA question-answer dimension.
        "answerValue": "A String", # Optional. The full body of the question.
        "qaQuestionId": "A String", # Optional. The QA question ID.
        "qaScorecardId": "A String", # Optional. The QA scorecard ID.
        "questionBody": "A String", # Optional. The full body of the question.
      },
      "qaQuestionDimensionMetadata": { # Metadata about the QA question dimension. # Output only. Metadata about the QA question dimension.
        "qaQuestionId": "A String", # Optional. The QA question ID.
        "qaScorecardId": "A String", # Optional. The QA scorecard ID.
        "questionBody": "A String", # Optional. The full body of the question.
      },
    },
  ],
  "filter": "A String", # Required. Filter to select a subset of conversations to compute the metrics. Must specify a window of the conversation create time to compute the metrics. The returned metrics will be from the range [DATE(starting create time), DATE(ending create time)).
  "measureMask": "A String", # Measures to return. Defaults to all measures if this field is unspecified. A valid mask should traverse from the `measure` field from the response. For example, a path from a measure mask to get the conversation count is "conversation_measure.count".
  "timeGranularity": "A String", # The time granularity of each data point in the time series. Defaults to NONE if this field is unspecified.
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # This resource represents a long-running operation that is the result of a network API call.
  "done": True or False, # 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": { # 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). # The error result of the operation in case of failure or cancellation.
    "code": 42, # The status code, which should be an enum value of google.rpc.Code.
    "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
      {
        "a_key": "", # Properties of the object. Contains field @type with type URL.
      },
    ],
    "message": "A 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": { # 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.
    "a_key": "", # Properties of the object. Contains field @type with type URL.
  },
  "name": "A 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": { # 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`.
    "a_key": "", # Properties of the object. Contains field @type with type URL.
  },
}
updateSettings(name, body=None, updateMask=None, x__xgafv=None)
Updates project-level settings.

Args:
  name: string, Immutable. The resource name of the settings resource. Format: projects/{project}/locations/{location}/settings (required)
  body: object, The request body.
    The object takes the form of:

{ # The CCAI Insights project wide settings. Use these settings to configure the behavior of Insights. View these settings with [`getsettings`](https://cloud.google.com/contact-center/insights/docs/reference/rest/v1/projects.locations/getSettings) and change the settings with [`updateSettings`](https://cloud.google.com/contact-center/insights/docs/reference/rest/v1/projects.locations/updateSettings).
  "analysisConfig": { # Default configuration when creating Analyses in Insights. # Default analysis settings.
    "annotatorSelector": { # Selector of all available annotators and phrase matchers to run. # To select the annotators to run and the phrase matchers to use (if any). If not specified, all annotators will be run.
      "issueModels": [ # The issue model to run. If not provided, the most recently deployed topic model will be used. The provided issue model will only be used for inference if the issue model is deployed and if run_issue_model_annotator is set to true. If more than one issue model is provided, only the first provided issue model will be used for inference.
        "A String",
      ],
      "phraseMatchers": [ # The list of phrase matchers to run. If not provided, all active phrase matchers will be used. If inactive phrase matchers are provided, they will not be used. Phrase matchers will be run only if run_phrase_matcher_annotator is set to true. Format: projects/{project}/locations/{location}/phraseMatchers/{phrase_matcher}
        "A String",
      ],
      "qaConfig": { # Configuration for the QA feature. # Configuration for the QA annotator.
        "scorecardList": { # Container for a list of scorecards. # A manual list of scorecards to score.
          "qaScorecardRevisions": [ # List of QaScorecardRevisions.
            "A String",
          ],
        },
      },
      "runEntityAnnotator": True or False, # Whether to run the entity annotator.
      "runIntentAnnotator": True or False, # Whether to run the intent annotator.
      "runInterruptionAnnotator": True or False, # Whether to run the interruption annotator.
      "runIssueModelAnnotator": True or False, # Whether to run the issue model annotator. A model should have already been deployed for this to take effect.
      "runPhraseMatcherAnnotator": True or False, # Whether to run the active phrase matcher annotator(s).
      "runQaAnnotator": True or False, # Whether to run the QA annotator.
      "runSentimentAnnotator": True or False, # Whether to run the sentiment annotator.
      "runSilenceAnnotator": True or False, # Whether to run the silence annotator.
      "runSummarizationAnnotator": True or False, # Whether to run the summarization annotator.
      "summarizationConfig": { # Configuration for summarization. # Configuration for the summarization annotator.
        "conversationProfile": "A String", # Resource name of the Dialogflow conversation profile. Format: projects/{project}/locations/{location}/conversationProfiles/{conversation_profile}
        "summarizationModel": "A String", # Default summarization model to be used.
      },
    },
    "runtimeIntegrationAnalysisPercentage": 3.14, # Percentage of conversations created using Dialogflow runtime integration to analyze automatically, between [0, 100].
    "uploadConversationAnalysisPercentage": 3.14, # Percentage of conversations created using the UploadConversation endpoint to analyze automatically, between [0, 100].
  },
  "conversationTtl": "A String", # The default TTL for newly-created conversations. If a conversation has a specified expiration, that value will be used instead. Changing this value will not change the expiration of existing conversations. Conversations with no expire time persist until they are deleted.
  "createTime": "A String", # Output only. The time at which the settings was created.
  "languageCode": "A String", # A language code to be applied to each transcript segment unless the segment already specifies a language code. Language code defaults to "en-US" if it is neither specified on the segment nor here.
  "name": "A String", # Immutable. The resource name of the settings resource. Format: projects/{project}/locations/{location}/settings
  "pubsubNotificationSettings": { # A map that maps a notification trigger to a Pub/Sub topic. Each time a specified trigger occurs, Insights will notify the corresponding Pub/Sub topic. Keys are notification triggers. Supported keys are: * "all-triggers": Notify each time any of the supported triggers occurs. * "create-analysis": Notify each time an analysis is created. * "create-conversation": Notify each time a conversation is created. * "export-insights-data": Notify each time an export is complete. * "ingest-conversations": Notify each time an IngestConversations LRO is complete. * "update-conversation": Notify each time a conversation is updated via UpdateConversation. * "upload-conversation": Notify when an UploadConversation LRO is complete. Values are Pub/Sub topics. The format of each Pub/Sub topic is: projects/{project}/topics/{topic}
    "a_key": "A String",
  },
  "redactionConfig": { # DLP resources used for redaction while ingesting conversations. DLP settings are applied to conversations ingested from the `UploadConversation` and `IngestConversations` endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the `CreateConversation` endpoint or the Dialogflow / Agent Assist runtime integrations. When using Dialogflow / Agent Assist runtime integrations, redaction should be performed in Dialogflow / Agent Assist. # Default DLP redaction resources to be applied while ingesting conversations. This applies to conversations ingested from the `UploadConversation` and `IngestConversations` endpoints, including conversations coming from CCAI Platform.
    "deidentifyTemplate": "A String", # The fully-qualified DLP deidentify template resource name. Format: `projects/{project}/deidentifyTemplates/{template}`
    "inspectTemplate": "A String", # The fully-qualified DLP inspect template resource name. Format: `projects/{project}/locations/{location}/inspectTemplates/{template}`
  },
  "speechConfig": { # Speech-to-Text configuration. Speech-to-Text settings are applied to conversations ingested from the `UploadConversation` and `IngestConversations` endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the `CreateConversation` endpoint. # Optional. Default Speech-to-Text resources to use while ingesting audio files. Optional, CCAI Insights will create a default if not provided. This applies to conversations ingested from the `UploadConversation` and `IngestConversations` endpoints, including conversations coming from CCAI Platform.
    "speechRecognizer": "A String", # The fully-qualified Speech Recognizer resource name. Format: `projects/{project_id}/locations/{location}/recognizer/{recognizer}`
  },
  "updateTime": "A String", # Output only. The time at which the settings were last updated.
}

  updateMask: string, Required. The list of fields to be updated.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # The CCAI Insights project wide settings. Use these settings to configure the behavior of Insights. View these settings with [`getsettings`](https://cloud.google.com/contact-center/insights/docs/reference/rest/v1/projects.locations/getSettings) and change the settings with [`updateSettings`](https://cloud.google.com/contact-center/insights/docs/reference/rest/v1/projects.locations/updateSettings).
  "analysisConfig": { # Default configuration when creating Analyses in Insights. # Default analysis settings.
    "annotatorSelector": { # Selector of all available annotators and phrase matchers to run. # To select the annotators to run and the phrase matchers to use (if any). If not specified, all annotators will be run.
      "issueModels": [ # The issue model to run. If not provided, the most recently deployed topic model will be used. The provided issue model will only be used for inference if the issue model is deployed and if run_issue_model_annotator is set to true. If more than one issue model is provided, only the first provided issue model will be used for inference.
        "A String",
      ],
      "phraseMatchers": [ # The list of phrase matchers to run. If not provided, all active phrase matchers will be used. If inactive phrase matchers are provided, they will not be used. Phrase matchers will be run only if run_phrase_matcher_annotator is set to true. Format: projects/{project}/locations/{location}/phraseMatchers/{phrase_matcher}
        "A String",
      ],
      "qaConfig": { # Configuration for the QA feature. # Configuration for the QA annotator.
        "scorecardList": { # Container for a list of scorecards. # A manual list of scorecards to score.
          "qaScorecardRevisions": [ # List of QaScorecardRevisions.
            "A String",
          ],
        },
      },
      "runEntityAnnotator": True or False, # Whether to run the entity annotator.
      "runIntentAnnotator": True or False, # Whether to run the intent annotator.
      "runInterruptionAnnotator": True or False, # Whether to run the interruption annotator.
      "runIssueModelAnnotator": True or False, # Whether to run the issue model annotator. A model should have already been deployed for this to take effect.
      "runPhraseMatcherAnnotator": True or False, # Whether to run the active phrase matcher annotator(s).
      "runQaAnnotator": True or False, # Whether to run the QA annotator.
      "runSentimentAnnotator": True or False, # Whether to run the sentiment annotator.
      "runSilenceAnnotator": True or False, # Whether to run the silence annotator.
      "runSummarizationAnnotator": True or False, # Whether to run the summarization annotator.
      "summarizationConfig": { # Configuration for summarization. # Configuration for the summarization annotator.
        "conversationProfile": "A String", # Resource name of the Dialogflow conversation profile. Format: projects/{project}/locations/{location}/conversationProfiles/{conversation_profile}
        "summarizationModel": "A String", # Default summarization model to be used.
      },
    },
    "runtimeIntegrationAnalysisPercentage": 3.14, # Percentage of conversations created using Dialogflow runtime integration to analyze automatically, between [0, 100].
    "uploadConversationAnalysisPercentage": 3.14, # Percentage of conversations created using the UploadConversation endpoint to analyze automatically, between [0, 100].
  },
  "conversationTtl": "A String", # The default TTL for newly-created conversations. If a conversation has a specified expiration, that value will be used instead. Changing this value will not change the expiration of existing conversations. Conversations with no expire time persist until they are deleted.
  "createTime": "A String", # Output only. The time at which the settings was created.
  "languageCode": "A String", # A language code to be applied to each transcript segment unless the segment already specifies a language code. Language code defaults to "en-US" if it is neither specified on the segment nor here.
  "name": "A String", # Immutable. The resource name of the settings resource. Format: projects/{project}/locations/{location}/settings
  "pubsubNotificationSettings": { # A map that maps a notification trigger to a Pub/Sub topic. Each time a specified trigger occurs, Insights will notify the corresponding Pub/Sub topic. Keys are notification triggers. Supported keys are: * "all-triggers": Notify each time any of the supported triggers occurs. * "create-analysis": Notify each time an analysis is created. * "create-conversation": Notify each time a conversation is created. * "export-insights-data": Notify each time an export is complete. * "ingest-conversations": Notify each time an IngestConversations LRO is complete. * "update-conversation": Notify each time a conversation is updated via UpdateConversation. * "upload-conversation": Notify when an UploadConversation LRO is complete. Values are Pub/Sub topics. The format of each Pub/Sub topic is: projects/{project}/topics/{topic}
    "a_key": "A String",
  },
  "redactionConfig": { # DLP resources used for redaction while ingesting conversations. DLP settings are applied to conversations ingested from the `UploadConversation` and `IngestConversations` endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the `CreateConversation` endpoint or the Dialogflow / Agent Assist runtime integrations. When using Dialogflow / Agent Assist runtime integrations, redaction should be performed in Dialogflow / Agent Assist. # Default DLP redaction resources to be applied while ingesting conversations. This applies to conversations ingested from the `UploadConversation` and `IngestConversations` endpoints, including conversations coming from CCAI Platform.
    "deidentifyTemplate": "A String", # The fully-qualified DLP deidentify template resource name. Format: `projects/{project}/deidentifyTemplates/{template}`
    "inspectTemplate": "A String", # The fully-qualified DLP inspect template resource name. Format: `projects/{project}/locations/{location}/inspectTemplates/{template}`
  },
  "speechConfig": { # Speech-to-Text configuration. Speech-to-Text settings are applied to conversations ingested from the `UploadConversation` and `IngestConversations` endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the `CreateConversation` endpoint. # Optional. Default Speech-to-Text resources to use while ingesting audio files. Optional, CCAI Insights will create a default if not provided. This applies to conversations ingested from the `UploadConversation` and `IngestConversations` endpoints, including conversations coming from CCAI Platform.
    "speechRecognizer": "A String", # The fully-qualified Speech Recognizer resource name. Format: `projects/{project_id}/locations/{location}/recognizer/{recognizer}`
  },
  "updateTime": "A String", # Output only. The time at which the settings were last updated.
}