{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-cloud-contact-center-ai/json-schema/google-cloud-contact-center-ai-google-cloud-contactcenterinsights-v1-settings-schema.json",
  "title": "GoogleCloudContactcenterinsightsV1Settings",
  "description": "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).",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-cloud-contact-center-ai-contactcenterinsights-projects-api-openapi.yml#/components/schemas/GoogleCloudContactcenterinsightsV1Settings",
  "properties": {
    "languageCode": {
      "description": "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.",
      "type": "string"
    },
    "speechConfig": {
      "$ref": "#/$defs/GoogleCloudContactcenterinsightsV1SpeechConfig",
      "description": "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."
    },
    "redactionConfig": {
      "$ref": "#/$defs/GoogleCloudContactcenterinsightsV1RedactionConfig",
      "description": "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."
    },
    "updateTime": {
      "readOnly": true,
      "type": "string",
      "description": "Output only. The time at which the settings were last updated.",
      "format": "google-datetime"
    },
    "name": {
      "description": "Immutable. The resource name of the settings resource. Format: projects/{project}/locations/{location}/settings",
      "type": "string"
    },
    "screenRecordingBucketUri": {
      "type": "string",
      "description": "Optional. The path to a Cloud Storage bucket containing conversation screen recordings. If provided, Insights will search in the bucket for a screen recording file matching the conversation data source object name prefix. If matches are found, these file URIs will be stored in the conversation screen recordings field."
    },
    "diagnosticMetricConfig": {
      "$ref": "#/$defs/GoogleCloudContactcenterinsightsV1SettingsDiagnosticMetricConfig",
      "description": "Optional. Configuration for diagnostic metrics."
    },
    "conversationTtl": {
      "description": "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.",
      "type": "string",
      "format": "google-duration"
    },
    "satisfiesPzs": {
      "type": "boolean",
      "description": "Output only. Whether this resource is zone separated.",
      "readOnly": true
    },
    "createTime": {
      "readOnly": true,
      "type": "string",
      "format": "google-datetime",
      "description": "Output only. The time at which the settings was created."
    },
    "analysisConfig": {
      "$ref": "#/$defs/GoogleCloudContactcenterinsightsV1SettingsAnalysisConfig",
      "description": "Default analysis settings."
    },
    "satisfiesPzi": {
      "type": "boolean",
      "description": "Output only. Whether this resource is zone isolated.",
      "readOnly": true
    },
    "timeZone": {
      "type": "string",
      "description": "Optional. The time zone applied to the project. This is a string representation of the time zone, for example, \"America/New_York\". This field follows the IANA TZ database format. See https://www.iana.org/time-zones for a list of valid values. If no value is set the user time zone will be used."
    },
    "pubsubNotificationSettings": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "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. * \"update-or-analyze-conversation\": Notify when an analysis for a conversation is completed or when the conversation is updated. The message will contain the conversation with transcript, analysis and other metadata. Values are Pub/Sub topics. The format of each Pub/Sub topic is: projects/{project}/topics/{topic}"
    }
  },
  "type": "object",
  "$defs": {
    "GoogleCloudContactcenterinsightsV1AnnotatorSelector": {
      "description": "Selector of all available annotators and phrase matchers to run.",
      "properties": {
        "runSilenceAnnotator": {
          "description": "Whether to run the silence annotator.",
          "type": "boolean"
        },
        "runSentimentAnnotator": {
          "type": "boolean",
          "description": "Whether to run the sentiment annotator."
        },
        "runEntityAnnotator": {
          "description": "Whether to run the entity annotator.",
          "type": "boolean"
        },
        "runQaAnnotator": {
          "type": "boolean",
          "description": "Whether to run the QA annotator."
        },
        "runIntentAnnotator": {
          "description": "Whether to run the intent annotator.",
          "type": "boolean"
        },
        "runInterruptionAnnotator": {
          "type": "boolean",
          "description": "Whether to run the interruption annotator."
        },
        "issueModels": {
          "description": "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.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "phraseMatchers": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "description": "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}"
        },
        "runAutoLabelingAnnotator": {
          "type": "boolean",
          "description": "Optional. Whether to run the auto-labeling annotator. If true, the auto-labeling annotator will be run. This is a non-billable operation designed for fixing or backfilling custom labels."
        },
        "runIssueModelAnnotator": {
          "description": "Whether to run the issue model annotator. A model should have already been deployed for this to take effect.",
          "type": "boolean"
        },
        "runSummarizationAnnotator": {
          "description": "Whether to run the summarization annotator.",
          "type": "boolean"
        },
        "summarizationConfig": {
          "$ref": "#/$defs/GoogleCloudContactcenterinsightsV1AnnotatorSelectorSummarizationConfig",
          "description": "Configuration for the summarization annotator."
        },
        "qaConfig": {
          "$ref": "#/$defs/GoogleCloudContactcenterinsightsV1AnnotatorSelectorQaConfig",
          "description": "Configuration for the QA annotator."
        },
        "runPhraseMatcherAnnotator": {
          "description": "Whether to run the active phrase matcher annotator(s).",
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "GoogleCloudContactcenterinsightsV1AnnotatorSelectorQaConfig": {
      "type": "object",
      "properties": {
        "scorecardList": {
          "$ref": "#/$defs/GoogleCloudContactcenterinsightsV1AnnotatorSelectorQaConfigScorecardList",
          "description": "A manual list of scorecards to score."
        }
      },
      "description": "Configuration for the QA feature."
    },
    "GoogleCloudContactcenterinsightsV1AnnotatorSelectorQaConfigScorecardList": {
      "type": "object",
      "properties": {
        "qaScorecardRevisions": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "List of QaScorecardRevisions."
        }
      },
      "description": "Container for a list of scorecards."
    },
    "GoogleCloudContactcenterinsightsV1AnnotatorSelectorSummarizationConfig": {
      "properties": {
        "generator": {
          "description": "The resource name of the existing created generator. Format: projects//locations//generators/",
          "type": "string"
        },
        "summarizationModel": {
          "enum": [
            "SUMMARIZATION_MODEL_UNSPECIFIED",
            "BASELINE_MODEL",
            "BASELINE_MODEL_V2_0"
          ],
          "description": "Default summarization model to be used.",
          "type": "string"
        },
        "conversationProfile": {
          "type": "string",
          "description": "Resource name of the Dialogflow conversation profile. Format: projects/{project}/locations/{location}/conversationProfiles/{conversation_profile}"
        }
      },
      "description": "Configuration for summarization.",
      "type": "object"
    },
    "GoogleCloudContactcenterinsightsV1MetricDefinition": {
      "properties": {
        "displayName": {
          "type": "string",
          "description": "Output only. The user-visible name of the metric (e.g., \"Containment Rate\").",
          "readOnly": true
        },
        "sourceId": {
          "readOnly": true,
          "description": "Output only. The resource name of the underlying Insights primitive (e.g., Tag or QaQuestion) used to calculate this metric.",
          "type": "string"
        }
      },
      "type": "object",
      "description": "A definition for a metric to be calculated during analysis."
    },
    "GoogleCloudContactcenterinsightsV1RedactionConfig": {
      "description": "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.",
      "type": "object",
      "properties": {
        "deidentifyTemplate": {
          "description": "The fully-qualified DLP deidentify template resource name. Format: `projects/{project}/deidentifyTemplates/{template}`",
          "type": "string"
        },
        "inspectTemplate": {
          "description": "The fully-qualified DLP inspect template resource name. Format: `projects/{project}/locations/{location}/inspectTemplates/{template}`",
          "type": "string"
        }
      }
    },
    "GoogleCloudContactcenterinsightsV1SettingsAnalysisConfig": {
      "properties": {
        "annotatorSelector": {
          "$ref": "#/$defs/GoogleCloudContactcenterinsightsV1AnnotatorSelector",
          "description": "To select the annotators to run and the phrase matchers to use (if any). If not specified, all annotators will be run."
        },
        "runtimeIntegrationAnalysisPercentage": {
          "description": "Percentage of conversations created using Dialogflow runtime integration to analyze automatically, between [0, 100].",
          "type": "number",
          "format": "double"
        },
        "uploadConversationAnalysisPercentage": {
          "format": "double",
          "type": "number",
          "description": "Percentage of conversations created using the UploadConversation endpoint to analyze automatically, between [0, 100]."
        }
      },
      "description": "Default configuration when creating Analyses in Insights.",
      "type": "object"
    },
    "GoogleCloudContactcenterinsightsV1SettingsDiagnosticMetricConfig": {
      "description": "Configuration for diagnostic metrics.",
      "type": "object",
      "properties": {
        "metrics": {
          "additionalProperties": {
            "$ref": "#/$defs/GoogleCloudContactcenterinsightsV1MetricDefinition"
          },
          "description": "Optional. A map of diagnostic metrics. The key is a unique identifier for the metric (e.g., \"containment\").",
          "type": "object"
        }
      }
    },
    "GoogleCloudContactcenterinsightsV1SpeechConfig": {
      "type": "object",
      "properties": {
        "speechRecognizer": {
          "description": "The fully-qualified Speech Recognizer resource name. Format: `projects/{project_id}/locations/{location}/recognizer/{recognizer}`",
          "type": "string"
        },
        "disableWordTimeOffsets": {
          "description": "Whether to disable word time offsets. If true, the `enable_word_time_offsets` field in the recognition config will be set to false.",
          "type": "boolean"
        }
      },
      "description": "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."
    }
  }
}