From b300fd0d0843cec7c1a990ffa03d6e17b085ee6f Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Fri, 15 Mar 2024 00:22:18 -0700 Subject: [PATCH] feat(all): auto-regenerate discovery clients (#2472) --- .../v1/androidmanagement-api.json | 4 +- androidmanagement/v1/androidmanagement-gen.go | 4 +- api-list.json | 15 - cloudbilling/v1beta/cloudbilling-api.json | 10 +- cloudbilling/v1beta/cloudbilling-gen.go | 3 +- cloudbuild/v2/cloudbuild-api.json | 5 +- cloudbuild/v2/cloudbuild-gen.go | 3 +- dataflow/v1b3/dataflow-api.json | 10 +- dataflow/v1b3/dataflow-gen.go | 16 +- dialogflow/v2/dialogflow-api.json | 94 +++- dialogflow/v2/dialogflow-gen.go | 136 +++++ dialogflow/v2beta1/dialogflow-api.json | 94 +++- dialogflow/v2beta1/dialogflow-gen.go | 136 +++++ dialogflow/v3/dialogflow-api.json | 320 +++++++++++- dialogflow/v3/dialogflow-gen.go | 475 +++++++++++++++++ dialogflow/v3beta1/dialogflow-api.json | 320 +++++++++++- dialogflow/v3beta1/dialogflow-gen.go | 477 ++++++++++++++++++ displayvideo/v2/displayvideo-api.json | 14 +- displayvideo/v2/displayvideo-gen.go | 42 +- displayvideo/v3/displayvideo-api.json | 14 +- displayvideo/v3/displayvideo-gen.go | 42 +- dlp/v2/dlp-api.json | 34 +- dlp/v2/dlp-gen.go | 128 ++--- firestore/v1/firestore-api.json | 27 +- firestore/v1/firestore-gen.go | 54 +- logging/v2/logging-api.json | 46 +- logging/v2/logging-gen.go | 109 ++++ .../v1alpha1/migrationcenter-api.json | 12 +- .../v1alpha1/migrationcenter-gen.go | 16 +- people/v1/people-api.json | 4 +- people/v1/people-gen.go | 2 + run/v2/run-api.json | 14 +- run/v2/run-gen.go | 14 + testing/v1/testing-api.json | 4 +- testing/v1/testing-gen.go | 2 +- 35 files changed, 2506 insertions(+), 194 deletions(-) diff --git a/androidmanagement/v1/androidmanagement-api.json b/androidmanagement/v1/androidmanagement-api.json index 22bdd98fca5..9fcfb905426 100644 --- a/androidmanagement/v1/androidmanagement-api.json +++ b/androidmanagement/v1/androidmanagement-api.json @@ -1163,7 +1163,7 @@ } } }, - "revision": "20240221", + "revision": "20240313", "rootUrl": "https://androidmanagement.googleapis.com/", "schemas": { "AdbShellCommandEvent": { @@ -2716,7 +2716,7 @@ "DISALLOW_USB_DATA_TRANSFER" ], "enumDescriptions": [ - "Unspecified. Defaults to ALLOW_USB_DATA_TRANSFER, unless usbFileTransferDisabled is set to true. If usbFileTransferDisabled is set to true, this is equivalent to DISALLOW_USB_FILE_TRANSFER.", + "Unspecified. Defaults to DISALLOW_USB_FILE_TRANSFER.", "All types of USB data transfers are allowed. usbFileTransferDisabled is ignored.", "Transferring files over USB is disallowed. Other types of USB data connections, such as mouse and keyboard connection, are allowed. usbFileTransferDisabled is ignored.", "When set, all types of USB data transfers are prohibited. Supported for devices running Android 12 or above with USB HAL 1.3 or above. If the setting is not supported, DISALLOW_USB_FILE_TRANSFER will be set. A nonComplianceDetail with API_LEVEL is reported if the Android version is less than 12. A nonComplianceDetail with DEVICE_INCOMPATIBLE is reported if the device does not have USB HAL 1.3 or above. usbFileTransferDisabled is ignored." diff --git a/androidmanagement/v1/androidmanagement-gen.go b/androidmanagement/v1/androidmanagement-gen.go index 401586193e8..8ed6680db16 100644 --- a/androidmanagement/v1/androidmanagement-gen.go +++ b/androidmanagement/v1/androidmanagement-gen.go @@ -2472,9 +2472,7 @@ type DeviceConnectivityManagement struct { // // Possible values: // "USB_DATA_ACCESS_UNSPECIFIED" - Unspecified. Defaults to - // ALLOW_USB_DATA_TRANSFER, unless usbFileTransferDisabled is set to - // true. If usbFileTransferDisabled is set to true, this is equivalent - // to DISALLOW_USB_FILE_TRANSFER. + // DISALLOW_USB_FILE_TRANSFER. // "ALLOW_USB_DATA_TRANSFER" - All types of USB data transfers are // allowed. usbFileTransferDisabled is ignored. // "DISALLOW_USB_FILE_TRANSFER" - Transferring files over USB is diff --git a/api-list.json b/api-list.json index 93624164645..592d4ec2ea4 100644 --- a/api-list.json +++ b/api-list.json @@ -3276,21 +3276,6 @@ "documentationLink": "https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster", "preferred": false }, - { - "kind": "discovery#directoryItem", - "id": "gkehub:v1alpha2", - "name": "gkehub", - "version": "v1alpha2", - "title": "GKE Hub API", - "description": "", - "discoveryRestUrl": "https://gkehub.googleapis.com/$discovery/rest?version=v1alpha2", - "icons": { - "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", - "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" - }, - "documentationLink": "https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster", - "preferred": false - }, { "kind": "discovery#directoryItem", "id": "gkehub:v2alpha", diff --git a/cloudbilling/v1beta/cloudbilling-api.json b/cloudbilling/v1beta/cloudbilling-api.json index d86e396c213..ac9829c56b5 100644 --- a/cloudbilling/v1beta/cloudbilling-api.json +++ b/cloudbilling/v1beta/cloudbilling-api.json @@ -910,7 +910,7 @@ } } }, - "revision": "20240301", + "revision": "20240311", "rootUrl": "https://cloudbilling.googleapis.com/", "schemas": { "CacheFillRegions": { @@ -1572,13 +1572,15 @@ "CAUSE_TYPE_UNSPECIFIED", "CAUSE_TYPE_PROJECT", "CAUSE_TYPE_SERVICE", - "CAUSE_TYPE_SKU" + "CAUSE_TYPE_SKU", + "CAUSE_TYPE_LOCATION" ], "enumDescriptions": [ "Default unspecified value.", "Caused by a project.", "Caused by a service.", - "Caused by a SKU." + "Caused by a SKU.", + "Caused by a location." ], "type": "string" }, @@ -1591,7 +1593,7 @@ "type": "string" }, "resource": { - "description": "The resource name of the cause. project: projects/{project}. service: services/{service}. sku: services/{service}/skus/{sku}.", + "description": "The resource name of the cause. project: projects/{project}. service: services/{service}. sku: services/{service}/skus/{sku}. location: locations/{location}.", "type": "string" }, "subCauses": { diff --git a/cloudbilling/v1beta/cloudbilling-gen.go b/cloudbilling/v1beta/cloudbilling-gen.go index 5d38970f6b1..cf385d36304 100644 --- a/cloudbilling/v1beta/cloudbilling-gen.go +++ b/cloudbilling/v1beta/cloudbilling-gen.go @@ -1463,6 +1463,7 @@ type GoogleCloudBillingAnomaliesV1betaCause struct { // "CAUSE_TYPE_PROJECT" - Caused by a project. // "CAUSE_TYPE_SERVICE" - Caused by a service. // "CAUSE_TYPE_SKU" - Caused by a SKU. + // "CAUSE_TYPE_LOCATION" - Caused by a location. CauseType string `json:"causeType,omitempty"` // Deviation: The deviation information for the cause. @@ -1473,7 +1474,7 @@ type GoogleCloudBillingAnomaliesV1betaCause struct { // Resource: The resource name of the cause. project: // projects/{project}. service: services/{service}. sku: - // services/{service}/skus/{sku}. + // services/{service}/skus/{sku}. location: locations/{location}. Resource string `json:"resource,omitempty"` // SubCauses: The sub causes. diff --git a/cloudbuild/v2/cloudbuild-api.json b/cloudbuild/v2/cloudbuild-api.json index 982d5a2310e..137fde979cf 100644 --- a/cloudbuild/v2/cloudbuild-api.json +++ b/cloudbuild/v2/cloudbuild-api.json @@ -844,7 +844,7 @@ } } }, - "revision": "20240305", + "revision": "20240310", "rootUrl": "https://cloudbuild.googleapis.com/", "schemas": { "AuditConfig": { @@ -2040,7 +2040,8 @@ "description": "Optional. Security configuration." }, "serviceAccount": { - "description": "Service account used in the Pipeline.", + "deprecated": true, + "description": "Service account used in the Pipeline. Deprecated; please use security.service_account instead.", "type": "string" }, "skippedTasks": { diff --git a/cloudbuild/v2/cloudbuild-gen.go b/cloudbuild/v2/cloudbuild-gen.go index 67a492d8b7a..014003fa856 100644 --- a/cloudbuild/v2/cloudbuild-gen.go +++ b/cloudbuild/v2/cloudbuild-gen.go @@ -2115,7 +2115,8 @@ type PipelineRun struct { // Security: Optional. Security configuration. Security *Security `json:"security,omitempty"` - // ServiceAccount: Service account used in the Pipeline. + // ServiceAccount: Service account used in the Pipeline. Deprecated; + // please use security.service_account instead. ServiceAccount string `json:"serviceAccount,omitempty"` // SkippedTasks: Output only. List of tasks that were skipped due to diff --git a/dataflow/v1b3/dataflow-api.json b/dataflow/v1b3/dataflow-api.json index 0556dc40913..b1e1bf5f4df 100644 --- a/dataflow/v1b3/dataflow-api.json +++ b/dataflow/v1b3/dataflow-api.json @@ -2182,7 +2182,7 @@ } } }, - "revision": "20240225", + "revision": "20240310", "rootUrl": "https://dataflow.googleapis.com/", "schemas": { "ApproximateProgress": { @@ -3201,7 +3201,7 @@ "type": "string" }, "streamingMode": { - "description": "Optional. Specifies the Streaming Engine message processing guarantees. Reduces cost and latency but might result in duplicate messages committed to storage. Designed to run simple mapping streaming ETL jobs at the lowest cost. For example, Change Data Capture (CDC) to BigQuery is a canonical use case.", + "description": "Optional. Specifies the Streaming Engine message processing guarantees. Reduces cost and latency but might result in duplicate messages committed to storage. Designed to run simple mapping streaming ETL jobs at the lowest cost. For example, Change Data Capture (CDC) to BigQuery is a canonical use case. For more information, see [Set the pipeline streaming mode](https://cloud.google.com/dataflow/docs/guides/streaming-modes).", "enum": [ "STREAMING_MODE_UNSPECIFIED", "STREAMING_MODE_EXACTLY_ONCE", @@ -3539,7 +3539,7 @@ "type": "string" }, "streamingMode": { - "description": "Optional. Specifies the Streaming Engine message processing guarantees. Reduces cost and latency but might result in duplicate messages committed to storage. Designed to run simple mapping streaming ETL jobs at the lowest cost. For example, Change Data Capture (CDC) to BigQuery is a canonical use case.", + "description": "Optional. Specifies the Streaming Engine message processing guarantees. Reduces cost and latency but might result in duplicate messages committed to storage. Designed to run simple mapping streaming ETL jobs at the lowest cost. For example, Change Data Capture (CDC) to BigQuery is a canonical use case. For more information, see [Set the pipeline streaming mode](https://cloud.google.com/dataflow/docs/guides/streaming-modes).", "enum": [ "STREAMING_MODE_UNSPECIFIED", "STREAMING_MODE_EXACTLY_ONCE", @@ -5484,7 +5484,7 @@ "type": "string" }, "streamingMode": { - "description": "Optional. Specifies the Streaming Engine message processing guarantees. Reduces cost and latency but might result in duplicate messages committed to storage. Designed to run simple mapping streaming ETL jobs at the lowest cost. For example, Change Data Capture (CDC) to BigQuery is a canonical use case.", + "description": "Optional. Specifies the Streaming Engine message processing guarantees. Reduces cost and latency but might result in duplicate messages committed to storage. Designed to run simple mapping streaming ETL jobs at the lowest cost. For example, Change Data Capture (CDC) to BigQuery is a canonical use case. For more information, see [Set the pipeline streaming mode](https://cloud.google.com/dataflow/docs/guides/streaming-modes).", "enum": [ "STREAMING_MODE_UNSPECIFIED", "STREAMING_MODE_EXACTLY_ONCE", @@ -5553,7 +5553,7 @@ "type": "integer" }, "workerUtilizationHint": { - "description": "Target worker utilization, compared against the aggregate utilization of the worker pool by autoscaler, to determine upscaling and downscaling when absent other constraints such as backlog.", + "description": "Target worker utilization, compared against the aggregate utilization of the worker pool by autoscaler, to determine upscaling and downscaling when absent other constraints such as backlog. For more information, see [Update an existing pipeline](https://cloud.google.com/dataflow/docs/guides/updating-a-pipeline).", "format": "double", "type": "number" } diff --git a/dataflow/v1b3/dataflow-gen.go b/dataflow/v1b3/dataflow-gen.go index eac32c896da..d080f533497 100644 --- a/dataflow/v1b3/dataflow-gen.go +++ b/dataflow/v1b3/dataflow-gen.go @@ -1994,7 +1994,9 @@ type Environment struct { // processing guarantees. Reduces cost and latency but might result in // duplicate messages committed to storage. Designed to run simple // mapping streaming ETL jobs at the lowest cost. For example, Change - // Data Capture (CDC) to BigQuery is a canonical use case. + // Data Capture (CDC) to BigQuery is a canonical use case. For more + // information, see Set the pipeline streaming mode + // (https://cloud.google.com/dataflow/docs/guides/streaming-modes). // // Possible values: // "STREAMING_MODE_UNSPECIFIED" - Run in the default mode. @@ -2429,7 +2431,9 @@ type FlexTemplateRuntimeEnvironment struct { // processing guarantees. Reduces cost and latency but might result in // duplicate messages committed to storage. Designed to run simple // mapping streaming ETL jobs at the lowest cost. For example, Change - // Data Capture (CDC) to BigQuery is a canonical use case. + // Data Capture (CDC) to BigQuery is a canonical use case. For more + // information, see Set the pipeline streaming mode + // (https://cloud.google.com/dataflow/docs/guides/streaming-modes). // // Possible values: // "STREAMING_MODE_UNSPECIFIED" - Run in the default mode. @@ -5615,7 +5619,9 @@ type RuntimeEnvironment struct { // processing guarantees. Reduces cost and latency but might result in // duplicate messages committed to storage. Designed to run simple // mapping streaming ETL jobs at the lowest cost. For example, Change - // Data Capture (CDC) to BigQuery is a canonical use case. + // Data Capture (CDC) to BigQuery is a canonical use case. For more + // information, see Set the pipeline streaming mode + // (https://cloud.google.com/dataflow/docs/guides/streaming-modes). // // Possible values: // "STREAMING_MODE_UNSPECIFIED" - Run in the default mode. @@ -5734,7 +5740,9 @@ type RuntimeUpdatableParams struct { // WorkerUtilizationHint: Target worker utilization, compared against // the aggregate utilization of the worker pool by autoscaler, to // determine upscaling and downscaling when absent other constraints - // such as backlog. + // such as backlog. For more information, see Update an existing + // pipeline + // (https://cloud.google.com/dataflow/docs/guides/updating-a-pipeline). WorkerUtilizationHint float64 `json:"workerUtilizationHint,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxNumWorkers") to diff --git a/dialogflow/v2/dialogflow-api.json b/dialogflow/v2/dialogflow-api.json index d331a358e81..71c29c0c40b 100644 --- a/dialogflow/v2/dialogflow-api.json +++ b/dialogflow/v2/dialogflow-api.json @@ -8327,7 +8327,7 @@ } } }, - "revision": "20240305", + "revision": "20240313", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -10373,6 +10373,10 @@ ], "type": "string" }, + "oauthConfig": { + "$ref": "GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig", + "description": "Optional. The OAuth configuration of the webhook. If specified, Dialogflow will initiate the OAuth client credential flow to exchange an access token from the 3rd party platform and put it in the auth header." + }, "parameterMapping": { "additionalProperties": { "type": "string" @@ -10396,6 +10400,22 @@ "description": "The HTTP request headers to send together with webhook requests.", "type": "object" }, + "serviceAgentAuth": { + "description": "Optional. Indicate the auth token type generated from the [Diglogflow service agent](https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). The generated token is sent in the Authorization header.", + "enum": [ + "SERVICE_AGENT_AUTH_UNSPECIFIED", + "NONE", + "ID_TOKEN", + "ACCESS_TOKEN" + ], + "enumDescriptions": [ + "Service agent auth type unspecified. Default to ID_TOKEN.", + "No token used.", + "Use [ID token](https://cloud.google.com/docs/authentication/token-types#id) generated from service agent. This can be used to access Cloud Function and Cloud Run after you grant Invoker role to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`.", + "Use [access token](https://cloud.google.com/docs/authentication/token-types#access) generated from service agent. This can be used to access other Google Cloud APIs after you grant required roles to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`." + ], + "type": "string" + }, "uri": { "description": "Required. The webhook URI for receiving POST requests. It must use https protocol.", "type": "string" @@ -10422,6 +10442,32 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig": { + "description": "Represents configuration of OAuth client credential flow for 3rd party API authentication.", + "id": "GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig", + "properties": { + "clientId": { + "description": "Required. The client ID provided by the 3rd party platform.", + "type": "string" + }, + "clientSecret": { + "description": "Required. The client secret provided by the 3rd party platform.", + "type": "string" + }, + "scopes": { + "description": "Optional. The OAuth scopes to grant.", + "items": { + "type": "string" + }, + "type": "array" + }, + "tokenEndpoint": { + "description": "Required. The token endpoint provided by the 3rd party platform to exchange an access token.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3WebhookRequest": { "description": "The request message for a webhook call. The request is sent as a JSON object and the field names will be presented in camel cases. You may see undocumented fields in an actual request. These fields are used internally by Dialogflow and should be ignored.", "id": "GoogleCloudDialogflowCxV3WebhookRequest", @@ -12667,6 +12713,10 @@ ], "type": "string" }, + "oauthConfig": { + "$ref": "GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig", + "description": "Optional. The OAuth configuration of the webhook. If specified, Dialogflow will initiate the OAuth client credential flow to exchange an access token from the 3rd party platform and put it in the auth header." + }, "parameterMapping": { "additionalProperties": { "type": "string" @@ -12690,6 +12740,22 @@ "description": "The HTTP request headers to send together with webhook requests.", "type": "object" }, + "serviceAgentAuth": { + "description": "Optional. Indicate the auth token type generated from the [Diglogflow service agent](https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). The generated token is sent in the Authorization header.", + "enum": [ + "SERVICE_AGENT_AUTH_UNSPECIFIED", + "NONE", + "ID_TOKEN", + "ACCESS_TOKEN" + ], + "enumDescriptions": [ + "Service agent auth type unspecified. Default to ID_TOKEN.", + "No token used.", + "Use [ID token](https://cloud.google.com/docs/authentication/token-types#id) generated from service agent. This can be used to access Cloud Function and Cloud Run after you grant Invoker role to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`.", + "Use [access token](https://cloud.google.com/docs/authentication/token-types#access) generated from service agent. This can be used to access other Google Cloud APIs after you grant required roles to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`." + ], + "type": "string" + }, "uri": { "description": "Required. The webhook URI for receiving POST requests. It must use https protocol.", "type": "string" @@ -12716,6 +12782,32 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig": { + "description": "Represents configuration of OAuth client credential flow for 3rd party API authentication.", + "id": "GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig", + "properties": { + "clientId": { + "description": "Required. The client ID provided by the 3rd party platform.", + "type": "string" + }, + "clientSecret": { + "description": "Required. The client secret provided by the 3rd party platform.", + "type": "string" + }, + "scopes": { + "description": "Optional. The OAuth scopes to grant.", + "items": { + "type": "string" + }, + "type": "array" + }, + "tokenEndpoint": { + "description": "Required. The token endpoint provided by the 3rd party platform to exchange an access token.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3beta1WebhookRequest": { "description": "The request message for a webhook call. The request is sent as a JSON object and the field names will be presented in camel cases. You may see undocumented fields in an actual request. These fields are used internally by Dialogflow and should be ignored.", "id": "GoogleCloudDialogflowCxV3beta1WebhookRequest", diff --git a/dialogflow/v2/dialogflow-gen.go b/dialogflow/v2/dialogflow-gen.go index 51fc17a3de9..ed70aef4858 100644 --- a/dialogflow/v2/dialogflow-gen.go +++ b/dialogflow/v2/dialogflow-gen.go @@ -4692,6 +4692,12 @@ type GoogleCloudDialogflowCxV3WebhookGenericWebService struct { // "OPTIONS" - HTTP OPTIONS Method. HttpMethod string `json:"httpMethod,omitempty"` + // OauthConfig: Optional. The OAuth configuration of the webhook. If + // specified, Dialogflow will initiate the OAuth client credential flow + // to exchange an access token from the 3rd party platform and put it in + // the auth header. + OauthConfig *GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig `json:"oauthConfig,omitempty"` + // ParameterMapping: Optional. Maps the values extracted from specific // fields of the flexible webhook response into session parameters. - // Key: session parameter name - Value: field path in the webhook @@ -4709,6 +4715,27 @@ type GoogleCloudDialogflowCxV3WebhookGenericWebService struct { // webhook requests. RequestHeaders map[string]string `json:"requestHeaders,omitempty"` + // ServiceAgentAuth: Optional. Indicate the auth token type generated + // from the Diglogflow service agent + // (https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). + // The generated token is sent in the Authorization header. + // + // Possible values: + // "SERVICE_AGENT_AUTH_UNSPECIFIED" - Service agent auth type + // unspecified. Default to ID_TOKEN. + // "NONE" - No token used. + // "ID_TOKEN" - Use [ID + // token](https://cloud.google.com/docs/authentication/token-types#id) + // generated from service agent. This can be used to access Cloud + // Function and Cloud Run after you grant Invoker role to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + // "ACCESS_TOKEN" - Use [access + // token](https://cloud.google.com/docs/authentication/token-types#access + // ) generated from service agent. This can be used to access other + // Google Cloud APIs after you grant required roles to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + ServiceAgentAuth string `json:"serviceAgentAuth,omitempty"` + // Uri: Required. The webhook URI for receiving POST requests. It must // use https protocol. Uri string `json:"uri,omitempty"` @@ -4748,6 +4775,47 @@ func (s *GoogleCloudDialogflowCxV3WebhookGenericWebService) MarshalJSON() ([]byt return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig: +// Represents configuration of OAuth client credential flow for 3rd +// party API authentication. +type GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig struct { + // ClientId: Required. The client ID provided by the 3rd party platform. + ClientId string `json:"clientId,omitempty"` + + // ClientSecret: Required. The client secret provided by the 3rd party + // platform. + ClientSecret string `json:"clientSecret,omitempty"` + + // Scopes: Optional. The OAuth scopes to grant. + Scopes []string `json:"scopes,omitempty"` + + // TokenEndpoint: Required. The token endpoint provided by the 3rd party + // platform to exchange an access token. + TokenEndpoint string `json:"tokenEndpoint,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ClientId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ClientId") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowCxV3WebhookRequest: The request message for a // webhook call. The request is sent as a JSON object and the field // names will be presented in camel cases. You may see undocumented @@ -8948,6 +9016,12 @@ type GoogleCloudDialogflowCxV3beta1WebhookGenericWebService struct { // "OPTIONS" - HTTP OPTIONS Method. HttpMethod string `json:"httpMethod,omitempty"` + // OauthConfig: Optional. The OAuth configuration of the webhook. If + // specified, Dialogflow will initiate the OAuth client credential flow + // to exchange an access token from the 3rd party platform and put it in + // the auth header. + OauthConfig *GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig `json:"oauthConfig,omitempty"` + // ParameterMapping: Optional. Maps the values extracted from specific // fields of the flexible webhook response into session parameters. - // Key: session parameter name - Value: field path in the webhook @@ -8965,6 +9039,27 @@ type GoogleCloudDialogflowCxV3beta1WebhookGenericWebService struct { // webhook requests. RequestHeaders map[string]string `json:"requestHeaders,omitempty"` + // ServiceAgentAuth: Optional. Indicate the auth token type generated + // from the Diglogflow service agent + // (https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). + // The generated token is sent in the Authorization header. + // + // Possible values: + // "SERVICE_AGENT_AUTH_UNSPECIFIED" - Service agent auth type + // unspecified. Default to ID_TOKEN. + // "NONE" - No token used. + // "ID_TOKEN" - Use [ID + // token](https://cloud.google.com/docs/authentication/token-types#id) + // generated from service agent. This can be used to access Cloud + // Function and Cloud Run after you grant Invoker role to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + // "ACCESS_TOKEN" - Use [access + // token](https://cloud.google.com/docs/authentication/token-types#access + // ) generated from service agent. This can be used to access other + // Google Cloud APIs after you grant required roles to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + ServiceAgentAuth string `json:"serviceAgentAuth,omitempty"` + // Uri: Required. The webhook URI for receiving POST requests. It must // use https protocol. Uri string `json:"uri,omitempty"` @@ -9004,6 +9099,47 @@ func (s *GoogleCloudDialogflowCxV3beta1WebhookGenericWebService) MarshalJSON() ( return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig: +// Represents configuration of OAuth client credential flow for 3rd +// party API authentication. +type GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig struct { + // ClientId: Required. The client ID provided by the 3rd party platform. + ClientId string `json:"clientId,omitempty"` + + // ClientSecret: Required. The client secret provided by the 3rd party + // platform. + ClientSecret string `json:"clientSecret,omitempty"` + + // Scopes: Optional. The OAuth scopes to grant. + Scopes []string `json:"scopes,omitempty"` + + // TokenEndpoint: Required. The token endpoint provided by the 3rd party + // platform to exchange an access token. + TokenEndpoint string `json:"tokenEndpoint,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ClientId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ClientId") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowCxV3beta1WebhookRequest: The request message for // a webhook call. The request is sent as a JSON object and the field // names will be presented in camel cases. You may see undocumented diff --git a/dialogflow/v2beta1/dialogflow-api.json b/dialogflow/v2beta1/dialogflow-api.json index 9db02c96917..5a026f87d23 100644 --- a/dialogflow/v2beta1/dialogflow-api.json +++ b/dialogflow/v2beta1/dialogflow-api.json @@ -7695,7 +7695,7 @@ } } }, - "revision": "20240305", + "revision": "20240313", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -9741,6 +9741,10 @@ ], "type": "string" }, + "oauthConfig": { + "$ref": "GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig", + "description": "Optional. The OAuth configuration of the webhook. If specified, Dialogflow will initiate the OAuth client credential flow to exchange an access token from the 3rd party platform and put it in the auth header." + }, "parameterMapping": { "additionalProperties": { "type": "string" @@ -9764,6 +9768,22 @@ "description": "The HTTP request headers to send together with webhook requests.", "type": "object" }, + "serviceAgentAuth": { + "description": "Optional. Indicate the auth token type generated from the [Diglogflow service agent](https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). The generated token is sent in the Authorization header.", + "enum": [ + "SERVICE_AGENT_AUTH_UNSPECIFIED", + "NONE", + "ID_TOKEN", + "ACCESS_TOKEN" + ], + "enumDescriptions": [ + "Service agent auth type unspecified. Default to ID_TOKEN.", + "No token used.", + "Use [ID token](https://cloud.google.com/docs/authentication/token-types#id) generated from service agent. This can be used to access Cloud Function and Cloud Run after you grant Invoker role to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`.", + "Use [access token](https://cloud.google.com/docs/authentication/token-types#access) generated from service agent. This can be used to access other Google Cloud APIs after you grant required roles to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`." + ], + "type": "string" + }, "uri": { "description": "Required. The webhook URI for receiving POST requests. It must use https protocol.", "type": "string" @@ -9790,6 +9810,32 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig": { + "description": "Represents configuration of OAuth client credential flow for 3rd party API authentication.", + "id": "GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig", + "properties": { + "clientId": { + "description": "Required. The client ID provided by the 3rd party platform.", + "type": "string" + }, + "clientSecret": { + "description": "Required. The client secret provided by the 3rd party platform.", + "type": "string" + }, + "scopes": { + "description": "Optional. The OAuth scopes to grant.", + "items": { + "type": "string" + }, + "type": "array" + }, + "tokenEndpoint": { + "description": "Required. The token endpoint provided by the 3rd party platform to exchange an access token.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3WebhookRequest": { "description": "The request message for a webhook call. The request is sent as a JSON object and the field names will be presented in camel cases. You may see undocumented fields in an actual request. These fields are used internally by Dialogflow and should be ignored.", "id": "GoogleCloudDialogflowCxV3WebhookRequest", @@ -12035,6 +12081,10 @@ ], "type": "string" }, + "oauthConfig": { + "$ref": "GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig", + "description": "Optional. The OAuth configuration of the webhook. If specified, Dialogflow will initiate the OAuth client credential flow to exchange an access token from the 3rd party platform and put it in the auth header." + }, "parameterMapping": { "additionalProperties": { "type": "string" @@ -12058,6 +12108,22 @@ "description": "The HTTP request headers to send together with webhook requests.", "type": "object" }, + "serviceAgentAuth": { + "description": "Optional. Indicate the auth token type generated from the [Diglogflow service agent](https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). The generated token is sent in the Authorization header.", + "enum": [ + "SERVICE_AGENT_AUTH_UNSPECIFIED", + "NONE", + "ID_TOKEN", + "ACCESS_TOKEN" + ], + "enumDescriptions": [ + "Service agent auth type unspecified. Default to ID_TOKEN.", + "No token used.", + "Use [ID token](https://cloud.google.com/docs/authentication/token-types#id) generated from service agent. This can be used to access Cloud Function and Cloud Run after you grant Invoker role to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`.", + "Use [access token](https://cloud.google.com/docs/authentication/token-types#access) generated from service agent. This can be used to access other Google Cloud APIs after you grant required roles to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`." + ], + "type": "string" + }, "uri": { "description": "Required. The webhook URI for receiving POST requests. It must use https protocol.", "type": "string" @@ -12084,6 +12150,32 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig": { + "description": "Represents configuration of OAuth client credential flow for 3rd party API authentication.", + "id": "GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig", + "properties": { + "clientId": { + "description": "Required. The client ID provided by the 3rd party platform.", + "type": "string" + }, + "clientSecret": { + "description": "Required. The client secret provided by the 3rd party platform.", + "type": "string" + }, + "scopes": { + "description": "Optional. The OAuth scopes to grant.", + "items": { + "type": "string" + }, + "type": "array" + }, + "tokenEndpoint": { + "description": "Required. The token endpoint provided by the 3rd party platform to exchange an access token.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3beta1WebhookRequest": { "description": "The request message for a webhook call. The request is sent as a JSON object and the field names will be presented in camel cases. You may see undocumented fields in an actual request. These fields are used internally by Dialogflow and should be ignored.", "id": "GoogleCloudDialogflowCxV3beta1WebhookRequest", diff --git a/dialogflow/v2beta1/dialogflow-gen.go b/dialogflow/v2beta1/dialogflow-gen.go index e7fd3021ae0..52440f40ebd 100644 --- a/dialogflow/v2beta1/dialogflow-gen.go +++ b/dialogflow/v2beta1/dialogflow-gen.go @@ -4620,6 +4620,12 @@ type GoogleCloudDialogflowCxV3WebhookGenericWebService struct { // "OPTIONS" - HTTP OPTIONS Method. HttpMethod string `json:"httpMethod,omitempty"` + // OauthConfig: Optional. The OAuth configuration of the webhook. If + // specified, Dialogflow will initiate the OAuth client credential flow + // to exchange an access token from the 3rd party platform and put it in + // the auth header. + OauthConfig *GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig `json:"oauthConfig,omitempty"` + // ParameterMapping: Optional. Maps the values extracted from specific // fields of the flexible webhook response into session parameters. - // Key: session parameter name - Value: field path in the webhook @@ -4637,6 +4643,27 @@ type GoogleCloudDialogflowCxV3WebhookGenericWebService struct { // webhook requests. RequestHeaders map[string]string `json:"requestHeaders,omitempty"` + // ServiceAgentAuth: Optional. Indicate the auth token type generated + // from the Diglogflow service agent + // (https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). + // The generated token is sent in the Authorization header. + // + // Possible values: + // "SERVICE_AGENT_AUTH_UNSPECIFIED" - Service agent auth type + // unspecified. Default to ID_TOKEN. + // "NONE" - No token used. + // "ID_TOKEN" - Use [ID + // token](https://cloud.google.com/docs/authentication/token-types#id) + // generated from service agent. This can be used to access Cloud + // Function and Cloud Run after you grant Invoker role to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + // "ACCESS_TOKEN" - Use [access + // token](https://cloud.google.com/docs/authentication/token-types#access + // ) generated from service agent. This can be used to access other + // Google Cloud APIs after you grant required roles to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + ServiceAgentAuth string `json:"serviceAgentAuth,omitempty"` + // Uri: Required. The webhook URI for receiving POST requests. It must // use https protocol. Uri string `json:"uri,omitempty"` @@ -4676,6 +4703,47 @@ func (s *GoogleCloudDialogflowCxV3WebhookGenericWebService) MarshalJSON() ([]byt return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig: +// Represents configuration of OAuth client credential flow for 3rd +// party API authentication. +type GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig struct { + // ClientId: Required. The client ID provided by the 3rd party platform. + ClientId string `json:"clientId,omitempty"` + + // ClientSecret: Required. The client secret provided by the 3rd party + // platform. + ClientSecret string `json:"clientSecret,omitempty"` + + // Scopes: Optional. The OAuth scopes to grant. + Scopes []string `json:"scopes,omitempty"` + + // TokenEndpoint: Required. The token endpoint provided by the 3rd party + // platform to exchange an access token. + TokenEndpoint string `json:"tokenEndpoint,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ClientId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ClientId") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowCxV3WebhookRequest: The request message for a // webhook call. The request is sent as a JSON object and the field // names will be presented in camel cases. You may see undocumented @@ -8876,6 +8944,12 @@ type GoogleCloudDialogflowCxV3beta1WebhookGenericWebService struct { // "OPTIONS" - HTTP OPTIONS Method. HttpMethod string `json:"httpMethod,omitempty"` + // OauthConfig: Optional. The OAuth configuration of the webhook. If + // specified, Dialogflow will initiate the OAuth client credential flow + // to exchange an access token from the 3rd party platform and put it in + // the auth header. + OauthConfig *GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig `json:"oauthConfig,omitempty"` + // ParameterMapping: Optional. Maps the values extracted from specific // fields of the flexible webhook response into session parameters. - // Key: session parameter name - Value: field path in the webhook @@ -8893,6 +8967,27 @@ type GoogleCloudDialogflowCxV3beta1WebhookGenericWebService struct { // webhook requests. RequestHeaders map[string]string `json:"requestHeaders,omitempty"` + // ServiceAgentAuth: Optional. Indicate the auth token type generated + // from the Diglogflow service agent + // (https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). + // The generated token is sent in the Authorization header. + // + // Possible values: + // "SERVICE_AGENT_AUTH_UNSPECIFIED" - Service agent auth type + // unspecified. Default to ID_TOKEN. + // "NONE" - No token used. + // "ID_TOKEN" - Use [ID + // token](https://cloud.google.com/docs/authentication/token-types#id) + // generated from service agent. This can be used to access Cloud + // Function and Cloud Run after you grant Invoker role to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + // "ACCESS_TOKEN" - Use [access + // token](https://cloud.google.com/docs/authentication/token-types#access + // ) generated from service agent. This can be used to access other + // Google Cloud APIs after you grant required roles to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + ServiceAgentAuth string `json:"serviceAgentAuth,omitempty"` + // Uri: Required. The webhook URI for receiving POST requests. It must // use https protocol. Uri string `json:"uri,omitempty"` @@ -8932,6 +9027,47 @@ func (s *GoogleCloudDialogflowCxV3beta1WebhookGenericWebService) MarshalJSON() ( return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig: +// Represents configuration of OAuth client credential flow for 3rd +// party API authentication. +type GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig struct { + // ClientId: Required. The client ID provided by the 3rd party platform. + ClientId string `json:"clientId,omitempty"` + + // ClientSecret: Required. The client secret provided by the 3rd party + // platform. + ClientSecret string `json:"clientSecret,omitempty"` + + // Scopes: Optional. The OAuth scopes to grant. + Scopes []string `json:"scopes,omitempty"` + + // TokenEndpoint: Required. The token endpoint provided by the 3rd party + // platform to exchange an access token. + TokenEndpoint string `json:"tokenEndpoint,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ClientId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ClientId") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowCxV3beta1WebhookRequest: The request message for // a webhook call. The request is sent as a JSON object and the field // names will be presented in camel cases. You may see undocumented diff --git a/dialogflow/v3/dialogflow-api.json b/dialogflow/v3/dialogflow-api.json index 44cf7c85370..59bd0e25f19 100644 --- a/dialogflow/v3/dialogflow-api.json +++ b/dialogflow/v3/dialogflow-api.json @@ -4453,7 +4453,7 @@ } } }, - "revision": "20240305", + "revision": "20240313", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -5203,6 +5203,224 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3DataStoreConnectionSignals": { + "description": "Data store connection feature output signals. Might be only partially field if processing stop before the final answer. Reasons for this can be, but are not limited to: empty UCS search results, positive RAI check outcome, grounding failure, ...", + "id": "GoogleCloudDialogflowCxV3DataStoreConnectionSignals", + "properties": { + "answer": { + "description": "Optional. The final compiled answer.", + "type": "string" + }, + "answerGenerationModelCallSignals": { + "$ref": "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsAnswerGenerationModelCallSignals", + "description": "Optional. Diagnostic info related to the answer generation model call." + }, + "answerParts": { + "description": "Optional. Answer parts with relevant citations. Concatenation of texts should add up the `answer` (not counting whitespaces).", + "items": { + "$ref": "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsAnswerPart" + }, + "type": "array" + }, + "citedSnippets": { + "description": "Optional. Snippets cited by the answer generation model from the most to least relevant.", + "items": { + "$ref": "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsCitedSnippet" + }, + "type": "array" + }, + "groundingSignals": { + "$ref": "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsGroundingSignals", + "description": "Optional. Grounding signals." + }, + "rewriterModelCallSignals": { + "$ref": "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsRewriterModelCallSignals", + "description": "Optional. Diagnostic info related to the rewriter model call." + }, + "rewrittenQuery": { + "description": "Optional. Rewritten string query used for search.", + "type": "string" + }, + "safetySignals": { + "$ref": "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSafetySignals", + "description": "Optional. Safety check result." + }, + "searchSnippets": { + "description": "Optional. Search snippets included in the answer generation prompt.", + "items": { + "$ref": "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSearchSnippet" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsAnswerGenerationModelCallSignals": { + "description": "Diagnostic info related to the answer generation model call.", + "id": "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsAnswerGenerationModelCallSignals", + "properties": { + "modelOutput": { + "description": "Output of the generative model.", + "type": "string" + }, + "renderedPrompt": { + "description": "Prompt as sent to the model.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsAnswerPart": { + "description": "Answer part with citation.", + "id": "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsAnswerPart", + "properties": { + "supportingIndices": { + "description": "Citations for this answer part. Indices of `search_snippets`.", + "items": { + "format": "int32", + "type": "integer" + }, + "type": "array" + }, + "text": { + "description": "Substring of the answer.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsCitedSnippet": { + "description": "Snippet cited by the answer generation model.", + "id": "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsCitedSnippet", + "properties": { + "searchSnippet": { + "$ref": "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSearchSnippet", + "description": "Details of the snippet." + }, + "snippetIndex": { + "description": "Index of the snippet in `search_snippets` field.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsGroundingSignals": { + "description": "Grounding signals.", + "id": "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsGroundingSignals", + "properties": { + "decision": { + "description": "Represents the decision of the grounding check.", + "enum": [ + "GROUNDING_DECISION_UNSPECIFIED", + "ACCEPTED_BY_GROUNDING", + "REJECTED_BY_GROUNDING" + ], + "enumDescriptions": [ + "Decision not specified.", + "Grounding have accepted the answer.", + "Grounding have rejected the answer." + ], + "type": "string" + }, + "score": { + "description": "Grounding score bucket setting.", + "enum": [ + "GROUNDING_SCORE_BUCKET_UNSPECIFIED", + "VERY_LOW", + "LOW", + "MEDIUM", + "HIGH", + "VERY_HIGH" + ], + "enumDescriptions": [ + "Score not specified.", + "We have very low confidence that the answer is grounded.", + "We have low confidence that the answer is grounded.", + "We have medium confidence that the answer is grounded.", + "We have high confidence that the answer is grounded.", + "We have very high confidence that the answer is grounded." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsRewriterModelCallSignals": { + "description": "Diagnostic info related to the rewriter model call.", + "id": "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsRewriterModelCallSignals", + "properties": { + "modelOutput": { + "description": "Output of the generative model.", + "type": "string" + }, + "renderedPrompt": { + "description": "Prompt as sent to the model.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSafetySignals": { + "description": "Safety check results.", + "id": "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSafetySignals", + "properties": { + "bannedPhraseMatch": { + "description": "Specifies banned phrase match subject.", + "enum": [ + "BANNED_PHRASE_MATCH_UNSPECIFIED", + "BANNED_PHRASE_MATCH_NONE", + "BANNED_PHRASE_MATCH_QUERY", + "BANNED_PHRASE_MATCH_RESPONSE" + ], + "enumDescriptions": [ + "No banned phrase check was executed.", + "All banned phrase checks led to no match.", + "A banned phrase matched the query.", + "A banned phrase matched the response." + ], + "type": "string" + }, + "decision": { + "description": "Safety decision.", + "enum": [ + "SAFETY_DECISION_UNSPECIFIED", + "ACCEPTED_BY_SAFETY_CHECK", + "REJECTED_BY_SAFETY_CHECK" + ], + "enumDescriptions": [ + "Decision not specified.", + "No manual or automatic safety check fired.", + "One ore more safety checks fired." + ], + "type": "string" + }, + "matchedBannedPhrase": { + "description": "The matched banned phrase if there was a match.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSearchSnippet": { + "description": "Search snippet details.", + "id": "GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSearchSnippet", + "properties": { + "documentTitle": { + "description": "Title of the enclosing document.", + "type": "string" + }, + "documentUri": { + "description": "Uri for the document. Present if specified for the document.", + "type": "string" + }, + "text": { + "description": "Text included in the prompt.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata": { "description": "Metadata for DeleteDocument operation.", "id": "GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata", @@ -7971,6 +8189,10 @@ "description": "This field can be used to pass custom data into the webhook associated with the agent. Arbitrary JSON objects are supported. Some integrations that query a Dialogflow agent may provide additional information in the payload. In particular, for the Dialogflow Phone Gateway integration, this field has the form: ``` { \"telephony\": { \"caller_id\": \"+18558363987\" } } ```", "type": "object" }, + "populateDataStoreConnectionSignals": { + "description": "Optional. If set to true and data stores are involved in serving the request then DetectIntentResponse.query_result.data_store_connection_signals will be filled with data that can help evaluations.", + "type": "boolean" + }, "searchConfig": { "$ref": "GoogleCloudDialogflowCxV3SearchConfig", "description": "Optional. Search configuration for UCS search queries." @@ -8017,6 +8239,10 @@ "$ref": "GoogleCloudDialogflowCxV3Page", "description": "The current Page. Some, not all fields are filled in this message, including but not limited to `name` and `display_name`." }, + "dataStoreConnectionSignals": { + "$ref": "GoogleCloudDialogflowCxV3DataStoreConnectionSignals", + "description": "Optional. Data store connection feature output signals. Filled only when data stores are involved in serving the query and DetectIntentRequest.populate data_store_connection_quality_signals is set to true in the request." + }, "diagnosticInfo": { "additionalProperties": { "description": "Properties of the object.", @@ -9598,6 +9824,10 @@ ], "type": "string" }, + "oauthConfig": { + "$ref": "GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig", + "description": "Optional. The OAuth configuration of the webhook. If specified, Dialogflow will initiate the OAuth client credential flow to exchange an access token from the 3rd party platform and put it in the auth header." + }, "parameterMapping": { "additionalProperties": { "type": "string" @@ -9621,6 +9851,22 @@ "description": "The HTTP request headers to send together with webhook requests.", "type": "object" }, + "serviceAgentAuth": { + "description": "Optional. Indicate the auth token type generated from the [Diglogflow service agent](https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). The generated token is sent in the Authorization header.", + "enum": [ + "SERVICE_AGENT_AUTH_UNSPECIFIED", + "NONE", + "ID_TOKEN", + "ACCESS_TOKEN" + ], + "enumDescriptions": [ + "Service agent auth type unspecified. Default to ID_TOKEN.", + "No token used.", + "Use [ID token](https://cloud.google.com/docs/authentication/token-types#id) generated from service agent. This can be used to access Cloud Function and Cloud Run after you grant Invoker role to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`.", + "Use [access token](https://cloud.google.com/docs/authentication/token-types#access) generated from service agent. This can be used to access other Google Cloud APIs after you grant required roles to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`." + ], + "type": "string" + }, "uri": { "description": "Required. The webhook URI for receiving POST requests. It must use https protocol.", "type": "string" @@ -9647,6 +9893,32 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig": { + "description": "Represents configuration of OAuth client credential flow for 3rd party API authentication.", + "id": "GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig", + "properties": { + "clientId": { + "description": "Required. The client ID provided by the 3rd party platform.", + "type": "string" + }, + "clientSecret": { + "description": "Required. The client secret provided by the 3rd party platform.", + "type": "string" + }, + "scopes": { + "description": "Optional. The OAuth scopes to grant.", + "items": { + "type": "string" + }, + "type": "array" + }, + "tokenEndpoint": { + "description": "Required. The token endpoint provided by the 3rd party platform to exchange an access token.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3WebhookRequest": { "description": "The request message for a webhook call. The request is sent as a JSON object and the field names will be presented in camel cases. You may see undocumented fields in an actual request. These fields are used internally by Dialogflow and should be ignored.", "id": "GoogleCloudDialogflowCxV3WebhookRequest", @@ -11892,6 +12164,10 @@ ], "type": "string" }, + "oauthConfig": { + "$ref": "GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig", + "description": "Optional. The OAuth configuration of the webhook. If specified, Dialogflow will initiate the OAuth client credential flow to exchange an access token from the 3rd party platform and put it in the auth header." + }, "parameterMapping": { "additionalProperties": { "type": "string" @@ -11915,6 +12191,22 @@ "description": "The HTTP request headers to send together with webhook requests.", "type": "object" }, + "serviceAgentAuth": { + "description": "Optional. Indicate the auth token type generated from the [Diglogflow service agent](https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). The generated token is sent in the Authorization header.", + "enum": [ + "SERVICE_AGENT_AUTH_UNSPECIFIED", + "NONE", + "ID_TOKEN", + "ACCESS_TOKEN" + ], + "enumDescriptions": [ + "Service agent auth type unspecified. Default to ID_TOKEN.", + "No token used.", + "Use [ID token](https://cloud.google.com/docs/authentication/token-types#id) generated from service agent. This can be used to access Cloud Function and Cloud Run after you grant Invoker role to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`.", + "Use [access token](https://cloud.google.com/docs/authentication/token-types#access) generated from service agent. This can be used to access other Google Cloud APIs after you grant required roles to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`." + ], + "type": "string" + }, "uri": { "description": "Required. The webhook URI for receiving POST requests. It must use https protocol.", "type": "string" @@ -11941,6 +12233,32 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig": { + "description": "Represents configuration of OAuth client credential flow for 3rd party API authentication.", + "id": "GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig", + "properties": { + "clientId": { + "description": "Required. The client ID provided by the 3rd party platform.", + "type": "string" + }, + "clientSecret": { + "description": "Required. The client secret provided by the 3rd party platform.", + "type": "string" + }, + "scopes": { + "description": "Optional. The OAuth scopes to grant.", + "items": { + "type": "string" + }, + "type": "array" + }, + "tokenEndpoint": { + "description": "Required. The token endpoint provided by the 3rd party platform to exchange an access token.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3beta1WebhookRequest": { "description": "The request message for a webhook call. The request is sent as a JSON object and the field names will be presented in camel cases. You may see undocumented fields in an actual request. These fields are used internally by Dialogflow and should be ignored.", "id": "GoogleCloudDialogflowCxV3beta1WebhookRequest", diff --git a/dialogflow/v3/dialogflow-gen.go b/dialogflow/v3/dialogflow-gen.go index 1e8f6913361..860f22483e9 100644 --- a/dialogflow/v3/dialogflow-gen.go +++ b/dialogflow/v3/dialogflow-gen.go @@ -1909,6 +1909,333 @@ func (s *GoogleCloudDialogflowCxV3DataStoreConnection) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowCxV3DataStoreConnectionSignals: Data store +// connection feature output signals. Might be only partially field if +// processing stop before the final answer. Reasons for this can be, but +// are not limited to: empty UCS search results, positive RAI check +// outcome, grounding failure, ... +type GoogleCloudDialogflowCxV3DataStoreConnectionSignals struct { + // Answer: Optional. The final compiled answer. + Answer string `json:"answer,omitempty"` + + // AnswerGenerationModelCallSignals: Optional. Diagnostic info related + // to the answer generation model call. + AnswerGenerationModelCallSignals *GoogleCloudDialogflowCxV3DataStoreConnectionSignalsAnswerGenerationModelCallSignals `json:"answerGenerationModelCallSignals,omitempty"` + + // AnswerParts: Optional. Answer parts with relevant citations. + // Concatenation of texts should add up the `answer` (not counting + // whitespaces). + AnswerParts []*GoogleCloudDialogflowCxV3DataStoreConnectionSignalsAnswerPart `json:"answerParts,omitempty"` + + // CitedSnippets: Optional. Snippets cited by the answer generation + // model from the most to least relevant. + CitedSnippets []*GoogleCloudDialogflowCxV3DataStoreConnectionSignalsCitedSnippet `json:"citedSnippets,omitempty"` + + // GroundingSignals: Optional. Grounding signals. + GroundingSignals *GoogleCloudDialogflowCxV3DataStoreConnectionSignalsGroundingSignals `json:"groundingSignals,omitempty"` + + // RewriterModelCallSignals: Optional. Diagnostic info related to the + // rewriter model call. + RewriterModelCallSignals *GoogleCloudDialogflowCxV3DataStoreConnectionSignalsRewriterModelCallSignals `json:"rewriterModelCallSignals,omitempty"` + + // RewrittenQuery: Optional. Rewritten string query used for search. + RewrittenQuery string `json:"rewrittenQuery,omitempty"` + + // SafetySignals: Optional. Safety check result. + SafetySignals *GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSafetySignals `json:"safetySignals,omitempty"` + + // SearchSnippets: Optional. Search snippets included in the answer + // generation prompt. + SearchSnippets []*GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSearchSnippet `json:"searchSnippets,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Answer") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Answer") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3DataStoreConnectionSignals) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3DataStoreConnectionSignals + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3DataStoreConnectionSignalsAnswerGenerationMod +// elCallSignals: Diagnostic info related to the answer generation model +// call. +type GoogleCloudDialogflowCxV3DataStoreConnectionSignalsAnswerGenerationModelCallSignals struct { + // ModelOutput: Output of the generative model. + ModelOutput string `json:"modelOutput,omitempty"` + + // RenderedPrompt: Prompt as sent to the model. + RenderedPrompt string `json:"renderedPrompt,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ModelOutput") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ModelOutput") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3DataStoreConnectionSignalsAnswerGenerationModelCallSignals) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3DataStoreConnectionSignalsAnswerGenerationModelCallSignals + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3DataStoreConnectionSignalsAnswerPart: Answer +// part with citation. +type GoogleCloudDialogflowCxV3DataStoreConnectionSignalsAnswerPart struct { + // SupportingIndices: Citations for this answer part. Indices of + // `search_snippets`. + SupportingIndices []int64 `json:"supportingIndices,omitempty"` + + // Text: Substring of the answer. + Text string `json:"text,omitempty"` + + // ForceSendFields is a list of field names (e.g. "SupportingIndices") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "SupportingIndices") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3DataStoreConnectionSignalsAnswerPart) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3DataStoreConnectionSignalsAnswerPart + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3DataStoreConnectionSignalsCitedSnippet: +// Snippet cited by the answer generation model. +type GoogleCloudDialogflowCxV3DataStoreConnectionSignalsCitedSnippet struct { + // SearchSnippet: Details of the snippet. + SearchSnippet *GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSearchSnippet `json:"searchSnippet,omitempty"` + + // SnippetIndex: Index of the snippet in `search_snippets` field. + SnippetIndex int64 `json:"snippetIndex,omitempty"` + + // ForceSendFields is a list of field names (e.g. "SearchSnippet") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "SearchSnippet") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3DataStoreConnectionSignalsCitedSnippet) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3DataStoreConnectionSignalsCitedSnippet + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3DataStoreConnectionSignalsGroundingSignals: +// Grounding signals. +type GoogleCloudDialogflowCxV3DataStoreConnectionSignalsGroundingSignals struct { + // Decision: Represents the decision of the grounding check. + // + // Possible values: + // "GROUNDING_DECISION_UNSPECIFIED" - Decision not specified. + // "ACCEPTED_BY_GROUNDING" - Grounding have accepted the answer. + // "REJECTED_BY_GROUNDING" - Grounding have rejected the answer. + Decision string `json:"decision,omitempty"` + + // Score: Grounding score bucket setting. + // + // Possible values: + // "GROUNDING_SCORE_BUCKET_UNSPECIFIED" - Score not specified. + // "VERY_LOW" - We have very low confidence that the answer is + // grounded. + // "LOW" - We have low confidence that the answer is grounded. + // "MEDIUM" - We have medium confidence that the answer is grounded. + // "HIGH" - We have high confidence that the answer is grounded. + // "VERY_HIGH" - We have very high confidence that the answer is + // grounded. + Score string `json:"score,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Decision") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Decision") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3DataStoreConnectionSignalsGroundingSignals) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3DataStoreConnectionSignalsGroundingSignals + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3DataStoreConnectionSignalsRewriterModelCallSi +// gnals: Diagnostic info related to the rewriter model call. +type GoogleCloudDialogflowCxV3DataStoreConnectionSignalsRewriterModelCallSignals struct { + // ModelOutput: Output of the generative model. + ModelOutput string `json:"modelOutput,omitempty"` + + // RenderedPrompt: Prompt as sent to the model. + RenderedPrompt string `json:"renderedPrompt,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ModelOutput") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ModelOutput") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3DataStoreConnectionSignalsRewriterModelCallSignals) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3DataStoreConnectionSignalsRewriterModelCallSignals + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSafetySignals: +// Safety check results. +type GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSafetySignals struct { + // BannedPhraseMatch: Specifies banned phrase match subject. + // + // Possible values: + // "BANNED_PHRASE_MATCH_UNSPECIFIED" - No banned phrase check was + // executed. + // "BANNED_PHRASE_MATCH_NONE" - All banned phrase checks led to no + // match. + // "BANNED_PHRASE_MATCH_QUERY" - A banned phrase matched the query. + // "BANNED_PHRASE_MATCH_RESPONSE" - A banned phrase matched the + // response. + BannedPhraseMatch string `json:"bannedPhraseMatch,omitempty"` + + // Decision: Safety decision. + // + // Possible values: + // "SAFETY_DECISION_UNSPECIFIED" - Decision not specified. + // "ACCEPTED_BY_SAFETY_CHECK" - No manual or automatic safety check + // fired. + // "REJECTED_BY_SAFETY_CHECK" - One ore more safety checks fired. + Decision string `json:"decision,omitempty"` + + // MatchedBannedPhrase: The matched banned phrase if there was a match. + MatchedBannedPhrase string `json:"matchedBannedPhrase,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BannedPhraseMatch") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BannedPhraseMatch") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSafetySignals) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSafetySignals + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSearchSnippet: +// Search snippet details. +type GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSearchSnippet struct { + // DocumentTitle: Title of the enclosing document. + DocumentTitle string `json:"documentTitle,omitempty"` + + // DocumentUri: Uri for the document. Present if specified for the + // document. + DocumentUri string `json:"documentUri,omitempty"` + + // Text: Text included in the prompt. + Text string `json:"text,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DocumentTitle") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DocumentTitle") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSearchSnippet) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSearchSnippet + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata: Metadata // for DeleteDocument operation. type GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata struct { @@ -7088,6 +7415,12 @@ type GoogleCloudDialogflowCxV3QueryParameters struct { // "caller_id": "+18558363987" } } ``` Payload googleapi.RawMessage `json:"payload,omitempty"` + // PopulateDataStoreConnectionSignals: Optional. If set to true and data + // stores are involved in serving the request then + // DetectIntentResponse.query_result.data_store_connection_signals will + // be filled with data that can help evaluations. + PopulateDataStoreConnectionSignals bool `json:"populateDataStoreConnectionSignals,omitempty"` + // SearchConfig: Optional. Search configuration for UCS search queries. SearchConfig *GoogleCloudDialogflowCxV3SearchConfig `json:"searchConfig,omitempty"` @@ -7164,6 +7497,12 @@ type GoogleCloudDialogflowCxV3QueryResult struct { // this message, including but not limited to `name` and `display_name`. CurrentPage *GoogleCloudDialogflowCxV3Page `json:"currentPage,omitempty"` + // DataStoreConnectionSignals: Optional. Data store connection feature + // output signals. Filled only when data stores are involved in serving + // the query and DetectIntentRequest.populate + // data_store_connection_quality_signals is set to true in the request. + DataStoreConnectionSignals *GoogleCloudDialogflowCxV3DataStoreConnectionSignals `json:"dataStoreConnectionSignals,omitempty"` + // DiagnosticInfo: The free-form diagnostic info. For example, this // field could contain webhook call latency. The fields of this data can // change without notice, so you should not write code that depends on @@ -10002,6 +10341,12 @@ type GoogleCloudDialogflowCxV3WebhookGenericWebService struct { // "OPTIONS" - HTTP OPTIONS Method. HttpMethod string `json:"httpMethod,omitempty"` + // OauthConfig: Optional. The OAuth configuration of the webhook. If + // specified, Dialogflow will initiate the OAuth client credential flow + // to exchange an access token from the 3rd party platform and put it in + // the auth header. + OauthConfig *GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig `json:"oauthConfig,omitempty"` + // ParameterMapping: Optional. Maps the values extracted from specific // fields of the flexible webhook response into session parameters. - // Key: session parameter name - Value: field path in the webhook @@ -10019,6 +10364,27 @@ type GoogleCloudDialogflowCxV3WebhookGenericWebService struct { // webhook requests. RequestHeaders map[string]string `json:"requestHeaders,omitempty"` + // ServiceAgentAuth: Optional. Indicate the auth token type generated + // from the Diglogflow service agent + // (https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). + // The generated token is sent in the Authorization header. + // + // Possible values: + // "SERVICE_AGENT_AUTH_UNSPECIFIED" - Service agent auth type + // unspecified. Default to ID_TOKEN. + // "NONE" - No token used. + // "ID_TOKEN" - Use [ID + // token](https://cloud.google.com/docs/authentication/token-types#id) + // generated from service agent. This can be used to access Cloud + // Function and Cloud Run after you grant Invoker role to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + // "ACCESS_TOKEN" - Use [access + // token](https://cloud.google.com/docs/authentication/token-types#access + // ) generated from service agent. This can be used to access other + // Google Cloud APIs after you grant required roles to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + ServiceAgentAuth string `json:"serviceAgentAuth,omitempty"` + // Uri: Required. The webhook URI for receiving POST requests. It must // use https protocol. Uri string `json:"uri,omitempty"` @@ -10058,6 +10424,47 @@ func (s *GoogleCloudDialogflowCxV3WebhookGenericWebService) MarshalJSON() ([]byt return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig: +// Represents configuration of OAuth client credential flow for 3rd +// party API authentication. +type GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig struct { + // ClientId: Required. The client ID provided by the 3rd party platform. + ClientId string `json:"clientId,omitempty"` + + // ClientSecret: Required. The client secret provided by the 3rd party + // platform. + ClientSecret string `json:"clientSecret,omitempty"` + + // Scopes: Optional. The OAuth scopes to grant. + Scopes []string `json:"scopes,omitempty"` + + // TokenEndpoint: Required. The token endpoint provided by the 3rd party + // platform to exchange an access token. + TokenEndpoint string `json:"tokenEndpoint,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ClientId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ClientId") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowCxV3WebhookRequest: The request message for a // webhook call. The request is sent as a JSON object and the field // names will be presented in camel cases. You may see undocumented @@ -14258,6 +14665,12 @@ type GoogleCloudDialogflowCxV3beta1WebhookGenericWebService struct { // "OPTIONS" - HTTP OPTIONS Method. HttpMethod string `json:"httpMethod,omitempty"` + // OauthConfig: Optional. The OAuth configuration of the webhook. If + // specified, Dialogflow will initiate the OAuth client credential flow + // to exchange an access token from the 3rd party platform and put it in + // the auth header. + OauthConfig *GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig `json:"oauthConfig,omitempty"` + // ParameterMapping: Optional. Maps the values extracted from specific // fields of the flexible webhook response into session parameters. - // Key: session parameter name - Value: field path in the webhook @@ -14275,6 +14688,27 @@ type GoogleCloudDialogflowCxV3beta1WebhookGenericWebService struct { // webhook requests. RequestHeaders map[string]string `json:"requestHeaders,omitempty"` + // ServiceAgentAuth: Optional. Indicate the auth token type generated + // from the Diglogflow service agent + // (https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). + // The generated token is sent in the Authorization header. + // + // Possible values: + // "SERVICE_AGENT_AUTH_UNSPECIFIED" - Service agent auth type + // unspecified. Default to ID_TOKEN. + // "NONE" - No token used. + // "ID_TOKEN" - Use [ID + // token](https://cloud.google.com/docs/authentication/token-types#id) + // generated from service agent. This can be used to access Cloud + // Function and Cloud Run after you grant Invoker role to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + // "ACCESS_TOKEN" - Use [access + // token](https://cloud.google.com/docs/authentication/token-types#access + // ) generated from service agent. This can be used to access other + // Google Cloud APIs after you grant required roles to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + ServiceAgentAuth string `json:"serviceAgentAuth,omitempty"` + // Uri: Required. The webhook URI for receiving POST requests. It must // use https protocol. Uri string `json:"uri,omitempty"` @@ -14314,6 +14748,47 @@ func (s *GoogleCloudDialogflowCxV3beta1WebhookGenericWebService) MarshalJSON() ( return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig: +// Represents configuration of OAuth client credential flow for 3rd +// party API authentication. +type GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig struct { + // ClientId: Required. The client ID provided by the 3rd party platform. + ClientId string `json:"clientId,omitempty"` + + // ClientSecret: Required. The client secret provided by the 3rd party + // platform. + ClientSecret string `json:"clientSecret,omitempty"` + + // Scopes: Optional. The OAuth scopes to grant. + Scopes []string `json:"scopes,omitempty"` + + // TokenEndpoint: Required. The token endpoint provided by the 3rd party + // platform to exchange an access token. + TokenEndpoint string `json:"tokenEndpoint,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ClientId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ClientId") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowCxV3beta1WebhookRequest: The request message for // a webhook call. The request is sent as a JSON object and the field // names will be presented in camel cases. You may see undocumented diff --git a/dialogflow/v3beta1/dialogflow-api.json b/dialogflow/v3beta1/dialogflow-api.json index 778b9131bb4..24bbcd71a76 100644 --- a/dialogflow/v3beta1/dialogflow-api.json +++ b/dialogflow/v3beta1/dialogflow-api.json @@ -4453,7 +4453,7 @@ } } }, - "revision": "20240305", + "revision": "20240313", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -6499,6 +6499,10 @@ ], "type": "string" }, + "oauthConfig": { + "$ref": "GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig", + "description": "Optional. The OAuth configuration of the webhook. If specified, Dialogflow will initiate the OAuth client credential flow to exchange an access token from the 3rd party platform and put it in the auth header." + }, "parameterMapping": { "additionalProperties": { "type": "string" @@ -6522,6 +6526,22 @@ "description": "The HTTP request headers to send together with webhook requests.", "type": "object" }, + "serviceAgentAuth": { + "description": "Optional. Indicate the auth token type generated from the [Diglogflow service agent](https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). The generated token is sent in the Authorization header.", + "enum": [ + "SERVICE_AGENT_AUTH_UNSPECIFIED", + "NONE", + "ID_TOKEN", + "ACCESS_TOKEN" + ], + "enumDescriptions": [ + "Service agent auth type unspecified. Default to ID_TOKEN.", + "No token used.", + "Use [ID token](https://cloud.google.com/docs/authentication/token-types#id) generated from service agent. This can be used to access Cloud Function and Cloud Run after you grant Invoker role to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`.", + "Use [access token](https://cloud.google.com/docs/authentication/token-types#access) generated from service agent. This can be used to access other Google Cloud APIs after you grant required roles to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`." + ], + "type": "string" + }, "uri": { "description": "Required. The webhook URI for receiving POST requests. It must use https protocol.", "type": "string" @@ -6548,6 +6568,32 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig": { + "description": "Represents configuration of OAuth client credential flow for 3rd party API authentication.", + "id": "GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig", + "properties": { + "clientId": { + "description": "Required. The client ID provided by the 3rd party platform.", + "type": "string" + }, + "clientSecret": { + "description": "Required. The client secret provided by the 3rd party platform.", + "type": "string" + }, + "scopes": { + "description": "Optional. The OAuth scopes to grant.", + "items": { + "type": "string" + }, + "type": "array" + }, + "tokenEndpoint": { + "description": "Required. The token endpoint provided by the 3rd party platform to exchange an access token.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3WebhookRequest": { "description": "The request message for a webhook call. The request is sent as a JSON object and the field names will be presented in camel cases. You may see undocumented fields in an actual request. These fields are used internally by Dialogflow and should be ignored.", "id": "GoogleCloudDialogflowCxV3WebhookRequest", @@ -7513,6 +7559,224 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignals": { + "description": "Data store connection feature output signals. Might be only partially field if processing stop before the final answer. Reasons for this can be, but are not limited to: empty UCS search results, positive RAI check outcome, grounding failure, ...", + "id": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignals", + "properties": { + "answer": { + "description": "Optional. The final compiled answer.", + "type": "string" + }, + "answerGenerationModelCallSignals": { + "$ref": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsAnswerGenerationModelCallSignals", + "description": "Optional. Diagnostic info related to the answer generation model call." + }, + "answerParts": { + "description": "Optional. Answer parts with relevant citations. Concatenation of texts should add up the `answer` (not counting whitespaces).", + "items": { + "$ref": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsAnswerPart" + }, + "type": "array" + }, + "citedSnippets": { + "description": "Optional. Snippets cited by the answer generation model from the most to least relevant.", + "items": { + "$ref": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsCitedSnippet" + }, + "type": "array" + }, + "groundingSignals": { + "$ref": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsGroundingSignals", + "description": "Optional. Grounding signals." + }, + "rewriterModelCallSignals": { + "$ref": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsRewriterModelCallSignals", + "description": "Optional. Diagnostic info related to the rewriter model call." + }, + "rewrittenQuery": { + "description": "Optional. Rewritten string query used for search.", + "type": "string" + }, + "safetySignals": { + "$ref": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSafetySignals", + "description": "Optional. Safety check result." + }, + "searchSnippets": { + "description": "Optional. Search snippets included in the answer generation prompt.", + "items": { + "$ref": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSearchSnippet" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsAnswerGenerationModelCallSignals": { + "description": "Diagnostic info related to the answer generation model call.", + "id": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsAnswerGenerationModelCallSignals", + "properties": { + "modelOutput": { + "description": "Output of the generative model.", + "type": "string" + }, + "renderedPrompt": { + "description": "Prompt as sent to the model.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsAnswerPart": { + "description": "Answer part with citation.", + "id": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsAnswerPart", + "properties": { + "supportingIndices": { + "description": "Citations for this answer part. Indices of `search_snippets`.", + "items": { + "format": "int32", + "type": "integer" + }, + "type": "array" + }, + "text": { + "description": "Substring of the answer.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsCitedSnippet": { + "description": "Snippet cited by the answer generation model.", + "id": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsCitedSnippet", + "properties": { + "searchSnippet": { + "$ref": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSearchSnippet", + "description": "Details of the snippet." + }, + "snippetIndex": { + "description": "Index of the snippet in `search_snippets` field.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsGroundingSignals": { + "description": "Grounding signals.", + "id": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsGroundingSignals", + "properties": { + "decision": { + "description": "Represents the decision of the grounding check.", + "enum": [ + "GROUNDING_DECISION_UNSPECIFIED", + "ACCEPTED_BY_GROUNDING", + "REJECTED_BY_GROUNDING" + ], + "enumDescriptions": [ + "Decision not specified.", + "Grounding have accepted the answer.", + "Grounding have rejected the answer." + ], + "type": "string" + }, + "score": { + "description": "Grounding score bucket setting.", + "enum": [ + "GROUNDING_SCORE_BUCKET_UNSPECIFIED", + "VERY_LOW", + "LOW", + "MEDIUM", + "HIGH", + "VERY_HIGH" + ], + "enumDescriptions": [ + "Score not specified.", + "We have very low confidence that the answer is grounded.", + "We have low confidence that the answer is grounded.", + "We have medium confidence that the answer is grounded.", + "We have high confidence that the answer is grounded.", + "We have very high confidence that the answer is grounded." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsRewriterModelCallSignals": { + "description": "Diagnostic info related to the rewriter model call.", + "id": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsRewriterModelCallSignals", + "properties": { + "modelOutput": { + "description": "Output of the generative model.", + "type": "string" + }, + "renderedPrompt": { + "description": "Prompt as sent to the model.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSafetySignals": { + "description": "Safety check results.", + "id": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSafetySignals", + "properties": { + "bannedPhraseMatch": { + "description": "Specifies banned phrase match subject.", + "enum": [ + "BANNED_PHRASE_MATCH_UNSPECIFIED", + "BANNED_PHRASE_MATCH_NONE", + "BANNED_PHRASE_MATCH_QUERY", + "BANNED_PHRASE_MATCH_RESPONSE" + ], + "enumDescriptions": [ + "No banned phrase check was executed.", + "All banned phrase checks led to no match.", + "A banned phrase matched the query.", + "A banned phrase matched the response." + ], + "type": "string" + }, + "decision": { + "description": "Safety decision.", + "enum": [ + "SAFETY_DECISION_UNSPECIFIED", + "ACCEPTED_BY_SAFETY_CHECK", + "REJECTED_BY_SAFETY_CHECK" + ], + "enumDescriptions": [ + "Decision not specified.", + "No manual or automatic safety check fired.", + "One ore more safety checks fired." + ], + "type": "string" + }, + "matchedBannedPhrase": { + "description": "The matched banned phrase if there was a match.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSearchSnippet": { + "description": "Search snippet details.", + "id": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSearchSnippet", + "properties": { + "documentTitle": { + "description": "Title of the enclosing document.", + "type": "string" + }, + "documentUri": { + "description": "Uri for the document. Present if specified for the document.", + "type": "string" + }, + "text": { + "description": "Text included in the prompt.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata": { "description": "Metadata for DeleteDocument operation.", "id": "GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata", @@ -10281,6 +10545,10 @@ "description": "This field can be used to pass custom data into the webhook associated with the agent. Arbitrary JSON objects are supported. Some integrations that query a Dialogflow agent may provide additional information in the payload. In particular, for the Dialogflow Phone Gateway integration, this field has the form: ``` { \"telephony\": { \"caller_id\": \"+18558363987\" } } ```", "type": "object" }, + "populateDataStoreConnectionSignals": { + "description": "Optional. If set to true and data stores are involved in serving the request then DetectIntentResponse.query_result.data_store_connection_signals will be filled with data that can help evaluations.", + "type": "boolean" + }, "searchConfig": { "$ref": "GoogleCloudDialogflowCxV3beta1SearchConfig", "description": "Optional. Search configuration for UCS search queries." @@ -10327,6 +10595,10 @@ "$ref": "GoogleCloudDialogflowCxV3beta1Page", "description": "The current Page. Some, not all fields are filled in this message, including but not limited to `name` and `display_name`." }, + "dataStoreConnectionSignals": { + "$ref": "GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignals", + "description": "Optional. Data store connection feature output signals. Filled only when data stores are involved in serving the query and DetectIntentRequest.populate data_store_connection_quality_signals is set to true in the request." + }, "diagnosticInfo": { "additionalProperties": { "description": "Properties of the object.", @@ -11921,6 +12193,10 @@ ], "type": "string" }, + "oauthConfig": { + "$ref": "GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig", + "description": "Optional. The OAuth configuration of the webhook. If specified, Dialogflow will initiate the OAuth client credential flow to exchange an access token from the 3rd party platform and put it in the auth header." + }, "parameterMapping": { "additionalProperties": { "type": "string" @@ -11944,6 +12220,22 @@ "description": "The HTTP request headers to send together with webhook requests.", "type": "object" }, + "serviceAgentAuth": { + "description": "Optional. Indicate the auth token type generated from the [Diglogflow service agent](https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). The generated token is sent in the Authorization header.", + "enum": [ + "SERVICE_AGENT_AUTH_UNSPECIFIED", + "NONE", + "ID_TOKEN", + "ACCESS_TOKEN" + ], + "enumDescriptions": [ + "Service agent auth type unspecified. Default to ID_TOKEN.", + "No token used.", + "Use [ID token](https://cloud.google.com/docs/authentication/token-types#id) generated from service agent. This can be used to access Cloud Function and Cloud Run after you grant Invoker role to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`.", + "Use [access token](https://cloud.google.com/docs/authentication/token-types#access) generated from service agent. This can be used to access other Google Cloud APIs after you grant required roles to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`." + ], + "type": "string" + }, "uri": { "description": "Required. The webhook URI for receiving POST requests. It must use https protocol.", "type": "string" @@ -11970,6 +12262,32 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig": { + "description": "Represents configuration of OAuth client credential flow for 3rd party API authentication.", + "id": "GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig", + "properties": { + "clientId": { + "description": "Required. The client ID provided by the 3rd party platform.", + "type": "string" + }, + "clientSecret": { + "description": "Required. The client secret provided by the 3rd party platform.", + "type": "string" + }, + "scopes": { + "description": "Optional. The OAuth scopes to grant.", + "items": { + "type": "string" + }, + "type": "array" + }, + "tokenEndpoint": { + "description": "Required. The token endpoint provided by the 3rd party platform to exchange an access token.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3beta1WebhookRequest": { "description": "The request message for a webhook call. The request is sent as a JSON object and the field names will be presented in camel cases. You may see undocumented fields in an actual request. These fields are used internally by Dialogflow and should be ignored.", "id": "GoogleCloudDialogflowCxV3beta1WebhookRequest", diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index 5d85d743a34..8498e083bae 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -4284,6 +4284,12 @@ type GoogleCloudDialogflowCxV3WebhookGenericWebService struct { // "OPTIONS" - HTTP OPTIONS Method. HttpMethod string `json:"httpMethod,omitempty"` + // OauthConfig: Optional. The OAuth configuration of the webhook. If + // specified, Dialogflow will initiate the OAuth client credential flow + // to exchange an access token from the 3rd party platform and put it in + // the auth header. + OauthConfig *GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig `json:"oauthConfig,omitempty"` + // ParameterMapping: Optional. Maps the values extracted from specific // fields of the flexible webhook response into session parameters. - // Key: session parameter name - Value: field path in the webhook @@ -4301,6 +4307,27 @@ type GoogleCloudDialogflowCxV3WebhookGenericWebService struct { // webhook requests. RequestHeaders map[string]string `json:"requestHeaders,omitempty"` + // ServiceAgentAuth: Optional. Indicate the auth token type generated + // from the Diglogflow service agent + // (https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). + // The generated token is sent in the Authorization header. + // + // Possible values: + // "SERVICE_AGENT_AUTH_UNSPECIFIED" - Service agent auth type + // unspecified. Default to ID_TOKEN. + // "NONE" - No token used. + // "ID_TOKEN" - Use [ID + // token](https://cloud.google.com/docs/authentication/token-types#id) + // generated from service agent. This can be used to access Cloud + // Function and Cloud Run after you grant Invoker role to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + // "ACCESS_TOKEN" - Use [access + // token](https://cloud.google.com/docs/authentication/token-types#access + // ) generated from service agent. This can be used to access other + // Google Cloud APIs after you grant required roles to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + ServiceAgentAuth string `json:"serviceAgentAuth,omitempty"` + // Uri: Required. The webhook URI for receiving POST requests. It must // use https protocol. Uri string `json:"uri,omitempty"` @@ -4340,6 +4367,47 @@ func (s *GoogleCloudDialogflowCxV3WebhookGenericWebService) MarshalJSON() ([]byt return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig: +// Represents configuration of OAuth client credential flow for 3rd +// party API authentication. +type GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig struct { + // ClientId: Required. The client ID provided by the 3rd party platform. + ClientId string `json:"clientId,omitempty"` + + // ClientSecret: Required. The client secret provided by the 3rd party + // platform. + ClientSecret string `json:"clientSecret,omitempty"` + + // Scopes: Optional. The OAuth scopes to grant. + Scopes []string `json:"scopes,omitempty"` + + // TokenEndpoint: Required. The token endpoint provided by the 3rd party + // platform to exchange an access token. + TokenEndpoint string `json:"tokenEndpoint,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ClientId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ClientId") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3WebhookGenericWebServiceOAuthConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowCxV3WebhookRequest: The request message for a // webhook call. The request is sent as a JSON object and the field // names will be presented in camel cases. You may see undocumented @@ -6167,6 +6235,335 @@ func (s *GoogleCloudDialogflowCxV3beta1DataStoreConnection) MarshalJSON() ([]byt return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignals: Data store +// connection feature output signals. Might be only partially field if +// processing stop before the final answer. Reasons for this can be, but +// are not limited to: empty UCS search results, positive RAI check +// outcome, grounding failure, ... +type GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignals struct { + // Answer: Optional. The final compiled answer. + Answer string `json:"answer,omitempty"` + + // AnswerGenerationModelCallSignals: Optional. Diagnostic info related + // to the answer generation model call. + AnswerGenerationModelCallSignals *GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsAnswerGenerationModelCallSignals `json:"answerGenerationModelCallSignals,omitempty"` + + // AnswerParts: Optional. Answer parts with relevant citations. + // Concatenation of texts should add up the `answer` (not counting + // whitespaces). + AnswerParts []*GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsAnswerPart `json:"answerParts,omitempty"` + + // CitedSnippets: Optional. Snippets cited by the answer generation + // model from the most to least relevant. + CitedSnippets []*GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsCitedSnippet `json:"citedSnippets,omitempty"` + + // GroundingSignals: Optional. Grounding signals. + GroundingSignals *GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsGroundingSignals `json:"groundingSignals,omitempty"` + + // RewriterModelCallSignals: Optional. Diagnostic info related to the + // rewriter model call. + RewriterModelCallSignals *GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsRewriterModelCallSignals `json:"rewriterModelCallSignals,omitempty"` + + // RewrittenQuery: Optional. Rewritten string query used for search. + RewrittenQuery string `json:"rewrittenQuery,omitempty"` + + // SafetySignals: Optional. Safety check result. + SafetySignals *GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSafetySignals `json:"safetySignals,omitempty"` + + // SearchSnippets: Optional. Search snippets included in the answer + // generation prompt. + SearchSnippets []*GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSearchSnippet `json:"searchSnippets,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Answer") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Answer") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignals) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignals + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsAnswerGenerati +// onModelCallSignals: Diagnostic info related to the answer generation +// model call. +type GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsAnswerGenerationModelCallSignals struct { + // ModelOutput: Output of the generative model. + ModelOutput string `json:"modelOutput,omitempty"` + + // RenderedPrompt: Prompt as sent to the model. + RenderedPrompt string `json:"renderedPrompt,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ModelOutput") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ModelOutput") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsAnswerGenerationModelCallSignals) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsAnswerGenerationModelCallSignals + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsAnswerPart: +// Answer part with citation. +type GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsAnswerPart struct { + // SupportingIndices: Citations for this answer part. Indices of + // `search_snippets`. + SupportingIndices []int64 `json:"supportingIndices,omitempty"` + + // Text: Substring of the answer. + Text string `json:"text,omitempty"` + + // ForceSendFields is a list of field names (e.g. "SupportingIndices") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "SupportingIndices") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsAnswerPart) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsAnswerPart + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsCitedSnippet: +// Snippet cited by the answer generation model. +type GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsCitedSnippet struct { + // SearchSnippet: Details of the snippet. + SearchSnippet *GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSearchSnippet `json:"searchSnippet,omitempty"` + + // SnippetIndex: Index of the snippet in `search_snippets` field. + SnippetIndex int64 `json:"snippetIndex,omitempty"` + + // ForceSendFields is a list of field names (e.g. "SearchSnippet") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "SearchSnippet") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsCitedSnippet) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsCitedSnippet + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsGroundingSigna +// ls: Grounding signals. +type GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsGroundingSignals struct { + // Decision: Represents the decision of the grounding check. + // + // Possible values: + // "GROUNDING_DECISION_UNSPECIFIED" - Decision not specified. + // "ACCEPTED_BY_GROUNDING" - Grounding have accepted the answer. + // "REJECTED_BY_GROUNDING" - Grounding have rejected the answer. + Decision string `json:"decision,omitempty"` + + // Score: Grounding score bucket setting. + // + // Possible values: + // "GROUNDING_SCORE_BUCKET_UNSPECIFIED" - Score not specified. + // "VERY_LOW" - We have very low confidence that the answer is + // grounded. + // "LOW" - We have low confidence that the answer is grounded. + // "MEDIUM" - We have medium confidence that the answer is grounded. + // "HIGH" - We have high confidence that the answer is grounded. + // "VERY_HIGH" - We have very high confidence that the answer is + // grounded. + Score string `json:"score,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Decision") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Decision") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsGroundingSignals) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsGroundingSignals + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsRewriterModelC +// allSignals: Diagnostic info related to the rewriter model call. +type GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsRewriterModelCallSignals struct { + // ModelOutput: Output of the generative model. + ModelOutput string `json:"modelOutput,omitempty"` + + // RenderedPrompt: Prompt as sent to the model. + RenderedPrompt string `json:"renderedPrompt,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ModelOutput") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ModelOutput") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsRewriterModelCallSignals) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsRewriterModelCallSignals + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSafetySignals: +// +// Safety check results. +type GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSafetySignals struct { + // BannedPhraseMatch: Specifies banned phrase match subject. + // + // Possible values: + // "BANNED_PHRASE_MATCH_UNSPECIFIED" - No banned phrase check was + // executed. + // "BANNED_PHRASE_MATCH_NONE" - All banned phrase checks led to no + // match. + // "BANNED_PHRASE_MATCH_QUERY" - A banned phrase matched the query. + // "BANNED_PHRASE_MATCH_RESPONSE" - A banned phrase matched the + // response. + BannedPhraseMatch string `json:"bannedPhraseMatch,omitempty"` + + // Decision: Safety decision. + // + // Possible values: + // "SAFETY_DECISION_UNSPECIFIED" - Decision not specified. + // "ACCEPTED_BY_SAFETY_CHECK" - No manual or automatic safety check + // fired. + // "REJECTED_BY_SAFETY_CHECK" - One ore more safety checks fired. + Decision string `json:"decision,omitempty"` + + // MatchedBannedPhrase: The matched banned phrase if there was a match. + MatchedBannedPhrase string `json:"matchedBannedPhrase,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BannedPhraseMatch") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BannedPhraseMatch") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSafetySignals) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSafetySignals + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSearchSnippet: +// +// Search snippet details. +type GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSearchSnippet struct { + // DocumentTitle: Title of the enclosing document. + DocumentTitle string `json:"documentTitle,omitempty"` + + // DocumentUri: Uri for the document. Present if specified for the + // document. + DocumentUri string `json:"documentUri,omitempty"` + + // Text: Text included in the prompt. + Text string `json:"text,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DocumentTitle") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DocumentTitle") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSearchSnippet) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSearchSnippet + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata: // Metadata for DeleteDocument operation. type GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata struct { @@ -11355,6 +11752,12 @@ type GoogleCloudDialogflowCxV3beta1QueryParameters struct { // "caller_id": "+18558363987" } } ``` Payload googleapi.RawMessage `json:"payload,omitempty"` + // PopulateDataStoreConnectionSignals: Optional. If set to true and data + // stores are involved in serving the request then + // DetectIntentResponse.query_result.data_store_connection_signals will + // be filled with data that can help evaluations. + PopulateDataStoreConnectionSignals bool `json:"populateDataStoreConnectionSignals,omitempty"` + // SearchConfig: Optional. Search configuration for UCS search queries. SearchConfig *GoogleCloudDialogflowCxV3beta1SearchConfig `json:"searchConfig,omitempty"` @@ -11431,6 +11834,12 @@ type GoogleCloudDialogflowCxV3beta1QueryResult struct { // this message, including but not limited to `name` and `display_name`. CurrentPage *GoogleCloudDialogflowCxV3beta1Page `json:"currentPage,omitempty"` + // DataStoreConnectionSignals: Optional. Data store connection feature + // output signals. Filled only when data stores are involved in serving + // the query and DetectIntentRequest.populate + // data_store_connection_quality_signals is set to true in the request. + DataStoreConnectionSignals *GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignals `json:"dataStoreConnectionSignals,omitempty"` + // DiagnosticInfo: The free-form diagnostic info. For example, this // field could contain webhook call latency. The fields of this data can // change without notice, so you should not write code that depends on @@ -14280,6 +14689,12 @@ type GoogleCloudDialogflowCxV3beta1WebhookGenericWebService struct { // "OPTIONS" - HTTP OPTIONS Method. HttpMethod string `json:"httpMethod,omitempty"` + // OauthConfig: Optional. The OAuth configuration of the webhook. If + // specified, Dialogflow will initiate the OAuth client credential flow + // to exchange an access token from the 3rd party platform and put it in + // the auth header. + OauthConfig *GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig `json:"oauthConfig,omitempty"` + // ParameterMapping: Optional. Maps the values extracted from specific // fields of the flexible webhook response into session parameters. - // Key: session parameter name - Value: field path in the webhook @@ -14297,6 +14712,27 @@ type GoogleCloudDialogflowCxV3beta1WebhookGenericWebService struct { // webhook requests. RequestHeaders map[string]string `json:"requestHeaders,omitempty"` + // ServiceAgentAuth: Optional. Indicate the auth token type generated + // from the Diglogflow service agent + // (https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). + // The generated token is sent in the Authorization header. + // + // Possible values: + // "SERVICE_AGENT_AUTH_UNSPECIFIED" - Service agent auth type + // unspecified. Default to ID_TOKEN. + // "NONE" - No token used. + // "ID_TOKEN" - Use [ID + // token](https://cloud.google.com/docs/authentication/token-types#id) + // generated from service agent. This can be used to access Cloud + // Function and Cloud Run after you grant Invoker role to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + // "ACCESS_TOKEN" - Use [access + // token](https://cloud.google.com/docs/authentication/token-types#access + // ) generated from service agent. This can be used to access other + // Google Cloud APIs after you grant required roles to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + ServiceAgentAuth string `json:"serviceAgentAuth,omitempty"` + // Uri: Required. The webhook URI for receiving POST requests. It must // use https protocol. Uri string `json:"uri,omitempty"` @@ -14336,6 +14772,47 @@ func (s *GoogleCloudDialogflowCxV3beta1WebhookGenericWebService) MarshalJSON() ( return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig: +// Represents configuration of OAuth client credential flow for 3rd +// party API authentication. +type GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig struct { + // ClientId: Required. The client ID provided by the 3rd party platform. + ClientId string `json:"clientId,omitempty"` + + // ClientSecret: Required. The client secret provided by the 3rd party + // platform. + ClientSecret string `json:"clientSecret,omitempty"` + + // Scopes: Optional. The OAuth scopes to grant. + Scopes []string `json:"scopes,omitempty"` + + // TokenEndpoint: Required. The token endpoint provided by the 3rd party + // platform to exchange an access token. + TokenEndpoint string `json:"tokenEndpoint,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ClientId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ClientId") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1WebhookGenericWebServiceOAuthConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowCxV3beta1WebhookRequest: The request message for // a webhook call. The request is sent as a JSON object and the field // names will be presented in camel cases. You may see undocumented diff --git a/displayvideo/v2/displayvideo-api.json b/displayvideo/v2/displayvideo-api.json index 593bfce9ddb..9b05d77601e 100644 --- a/displayvideo/v2/displayvideo-api.json +++ b/displayvideo/v2/displayvideo-api.json @@ -9200,7 +9200,7 @@ "parameterOrder": [], "parameters": { "filter": { - "description": "Allows filtering by user fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `budget.budget_segments.date_range.end_date` field must use the `LESS THAN (\u003c)` operator. * The `displayName and `email` field must use the `HAS (:)` operator. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `assignedUserRole.advertiserId` * `assignedUserRole.entityType` * This is synthetic field of `AssignedUserRole` used for filtering. Identifies the type of entity to which the user role is assigned. Valid values are `Partner` and `Advertiser`. * `assignedUserRole.parentPartnerId` * This is a synthetic field of `AssignedUserRole` used for filtering. Identifies the parent partner of the entity to which the user role is assigned. * `assignedUserRole.partnerId` * `assignedUserRole.userRole` * `displayName` * `email` Examples: * The user with `displayName` containing \"foo\": `displayName:\"foo\"` * The user with `email` containing \"bar\": `email:\"bar\"` * All users with standard user roles: `assignedUserRole.userRole=\"STANDARD\"` * All users with user roles for partner 123: `assignedUserRole.partnerId=\"123\"` * All users with user roles for advertiser 123: `assignedUserRole.advertiserId=\"123\"` * All users with partner level user roles: `entityType=\"PARTNER\"` * All users with user roles for partner 123 and advertisers under partner 123: `parentPartnerId=\"123\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", + "description": "Allows filtering by user fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `displayName` and `email` fields must use the `HAS (:)` operator. * The `lastLoginTime` field must use either the `LESS THAN OR EQUAL TO (\u003c=)` or `GREATER THAN OR EQUAL TO (\u003e=)` operator. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `assignedUserRole.advertiserId` * `assignedUserRole.entityType`: This is synthetic field of `AssignedUserRole` used for filtering. Identifies the type of entity to which the user role is assigned. Valid values are `Partner` and `Advertiser`. * `assignedUserRole.parentPartnerId`: This is a synthetic field of `AssignedUserRole` used for filtering. Identifies the parent partner of the entity to which the user role is assigned. * `assignedUserRole.partnerId` * `assignedUserRole.userRole` * `displayName` * `email` * `lastLoginTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * The user with `displayName` containing \"foo\": `displayName:\"foo\"` * The user with `email` containing \"bar\": `email:\"bar\"` * All users with standard user roles: `assignedUserRole.userRole=\"STANDARD\"` * All users with user roles for partner 123: `assignedUserRole.partnerId=\"123\"` * All users with user roles for advertiser 123: `assignedUserRole.advertiserId=\"123\"` * All users with partner level user roles: `entityType=\"PARTNER\"` * All users with user roles for partner 123 and advertisers under partner 123: `parentPartnerId=\"123\"` * All users that last logged in on or after 2023-01-01T00:00:00Z (format of ISO 8601): `lastLoginTime\u003e=\"2023-01-01T00:00:00Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -9267,7 +9267,7 @@ } } }, - "revision": "20240307", + "revision": "20240314", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActivateManualTriggerRequest": { @@ -9773,7 +9773,9 @@ "APP_PLATFORM_XBOX", "APP_PLATFORM_SAMSUNG_TV", "APP_PLATFORM_ANDROID_TV", - "APP_PLATFORM_GENERIC_CTV" + "APP_PLATFORM_GENERIC_CTV", + "APP_PLATFORM_LG_TV", + "APP_PLATFORM_VIZIO_TV" ], "enumDescriptions": [ "Default value when app platform is not specified in this version. This enum is a placeholder for default value and does not represent a real platform option.", @@ -9786,7 +9788,9 @@ "The app platform is Xbox.", "The app platform is Samsung TV.", "The app platform is Android TV.", - "The app platform is a CTV platform that is not explicitly listed elsewhere." + "The app platform is a CTV platform that is not explicitly listed elsewhere.", + "The app platform is LG TV.", + "The app platform is VIZIO TV." ], "type": "string" }, @@ -21407,6 +21411,7 @@ "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM", "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA", "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM", + "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM", "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT", "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS", "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV", @@ -21419,6 +21424,7 @@ "A bidding strategy that pays a configurable amount per impression.", "A bidding strategy that automatically optimizes conversions per dollar.", "A bidding strategy that pays a configurable amount per impression.", + "A bidding strategy for YouTube Instant Reserve line items that pays a fixed amount per impression.", "An automated bidding strategy that sets bids to achieve maximum lift.", "A bidding strategy that automatically maximizes number of conversions given a daily budget.", "A bidding strategy that automatically optimizes cost per video view.", diff --git a/displayvideo/v2/displayvideo-gen.go b/displayvideo/v2/displayvideo-gen.go index baf48afdbd0..3d2f39464ea 100644 --- a/displayvideo/v2/displayvideo-gen.go +++ b/displayvideo/v2/displayvideo-gen.go @@ -1528,6 +1528,8 @@ type AppAssignedTargetingOptionDetails struct { // "APP_PLATFORM_ANDROID_TV" - The app platform is Android TV. // "APP_PLATFORM_GENERIC_CTV" - The app platform is a CTV platform // that is not explicitly listed elsewhere. + // "APP_PLATFORM_LG_TV" - The app platform is LG TV. + // "APP_PLATFORM_VIZIO_TV" - The app platform is VIZIO TV. AppPlatform string `json:"appPlatform,omitempty"` // DisplayName: Output only. The display name of the app. @@ -18389,6 +18391,9 @@ type YoutubeAndPartnersBiddingStrategy struct { // strategy that automatically optimizes conversions per dollar. // "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM" - A bidding // strategy that pays a configurable amount per impression. + // "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM" - A + // bidding strategy for YouTube Instant Reserve line items that pays a + // fixed amount per impression. // "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT" - An // automated bidding strategy that sets bids to achieve maximum lift. // "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS" - @@ -51193,19 +51198,20 @@ func (r *UsersService) List() *UsersListCall { // fields. Supported syntax: * Filter expressions are made up of one or // more restrictions. * Restrictions can be combined by the logical // operator `AND`. * A restriction has the form of `{field} {operator} -// {value}`. * The `budget.budget_segments.date_range.end_date` field -// must use the `LESS THAN (<)` operator. * The `displayName and `email` -// field must use the `HAS (:)` operator. * All other fields must use -// the `EQUALS (=)` operator. Supported fields: * -// `assignedUserRole.advertiserId` * `assignedUserRole.entityType` * -// This is synthetic field of `AssignedUserRole` used for filtering. -// Identifies the type of entity to which the user role is assigned. -// Valid values are `Partner` and `Advertiser`. * -// `assignedUserRole.parentPartnerId` * This is a synthetic field of -// `AssignedUserRole` used for filtering. Identifies the parent partner -// of the entity to which the user role is assigned. * -// `assignedUserRole.partnerId` * `assignedUserRole.userRole` * -// `displayName` * `email` Examples: * The user with `displayName` +// {value}`. * The `displayName` and `email` fields must use the `HAS +// (:)` operator. * The `lastLoginTime` field must use either the `LESS +// THAN OR EQUAL TO (<=)` or `GREATER THAN OR EQUAL TO (>=)` operator. * +// All other fields must use the `EQUALS (=)` operator. Supported +// fields: * `assignedUserRole.advertiserId` * +// `assignedUserRole.entityType`: This is synthetic field of +// `AssignedUserRole` used for filtering. Identifies the type of entity +// to which the user role is assigned. Valid values are `Partner` and +// `Advertiser`. * `assignedUserRole.parentPartnerId`: This is a +// synthetic field of `AssignedUserRole` used for filtering. Identifies +// the parent partner of the entity to which the user role is assigned. +// * `assignedUserRole.partnerId` * `assignedUserRole.userRole` * +// `displayName` * `email` * `lastLoginTime` (input in ISO 8601 format, +// or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * The user with `displayName` // containing "foo": `displayName:"foo" * The user with `email` // containing "bar": `email:"bar" * All users with standard user roles: // `assignedUserRole.userRole="STANDARD" * All users with user roles @@ -51213,9 +51219,11 @@ func (r *UsersService) List() *UsersListCall { // user roles for advertiser 123: `assignedUserRole.advertiserId="123" // * All users with partner level user roles: `entityType="PARTNER" * // All users with user roles for partner 123 and advertisers under -// partner 123: `parentPartnerId="123" The length of this field should -// be no more than 500 characters. Reference our filter `LIST` requests -// (/display-video/api/guides/how-tos/filters) guide for more +// partner 123: `parentPartnerId="123" * All users that last logged in +// on or after 2023-01-01T00:00:00Z (format of ISO 8601): +// `lastLoginTime>="2023-01-01T00:00:00Z" The length of this field +// should be no more than 500 characters. Reference our filter `LIST` +// requests (/display-video/api/guides/how-tos/filters) guide for more // information. func (c *UsersListCall) Filter(filter string) *UsersListCall { c.urlParams_.Set("filter", filter) @@ -51352,7 +51360,7 @@ func (c *UsersListCall) Do(opts ...googleapi.CallOption) (*ListUsersResponse, er // "parameterOrder": [], // "parameters": { // "filter": { - // "description": "Allows filtering by user fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `budget.budget_segments.date_range.end_date` field must use the `LESS THAN (\u003c)` operator. * The `displayName and `email` field must use the `HAS (:)` operator. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `assignedUserRole.advertiserId` * `assignedUserRole.entityType` * This is synthetic field of `AssignedUserRole` used for filtering. Identifies the type of entity to which the user role is assigned. Valid values are `Partner` and `Advertiser`. * `assignedUserRole.parentPartnerId` * This is a synthetic field of `AssignedUserRole` used for filtering. Identifies the parent partner of the entity to which the user role is assigned. * `assignedUserRole.partnerId` * `assignedUserRole.userRole` * `displayName` * `email` Examples: * The user with `displayName` containing \"foo\": `displayName:\"foo\"` * The user with `email` containing \"bar\": `email:\"bar\"` * All users with standard user roles: `assignedUserRole.userRole=\"STANDARD\"` * All users with user roles for partner 123: `assignedUserRole.partnerId=\"123\"` * All users with user roles for advertiser 123: `assignedUserRole.advertiserId=\"123\"` * All users with partner level user roles: `entityType=\"PARTNER\"` * All users with user roles for partner 123 and advertisers under partner 123: `parentPartnerId=\"123\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", + // "description": "Allows filtering by user fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `displayName` and `email` fields must use the `HAS (:)` operator. * The `lastLoginTime` field must use either the `LESS THAN OR EQUAL TO (\u003c=)` or `GREATER THAN OR EQUAL TO (\u003e=)` operator. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `assignedUserRole.advertiserId` * `assignedUserRole.entityType`: This is synthetic field of `AssignedUserRole` used for filtering. Identifies the type of entity to which the user role is assigned. Valid values are `Partner` and `Advertiser`. * `assignedUserRole.parentPartnerId`: This is a synthetic field of `AssignedUserRole` used for filtering. Identifies the parent partner of the entity to which the user role is assigned. * `assignedUserRole.partnerId` * `assignedUserRole.userRole` * `displayName` * `email` * `lastLoginTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * The user with `displayName` containing \"foo\": `displayName:\"foo\"` * The user with `email` containing \"bar\": `email:\"bar\"` * All users with standard user roles: `assignedUserRole.userRole=\"STANDARD\"` * All users with user roles for partner 123: `assignedUserRole.partnerId=\"123\"` * All users with user roles for advertiser 123: `assignedUserRole.advertiserId=\"123\"` * All users with partner level user roles: `entityType=\"PARTNER\"` * All users with user roles for partner 123 and advertisers under partner 123: `parentPartnerId=\"123\"` * All users that last logged in on or after 2023-01-01T00:00:00Z (format of ISO 8601): `lastLoginTime\u003e=\"2023-01-01T00:00:00Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, diff --git a/displayvideo/v3/displayvideo-api.json b/displayvideo/v3/displayvideo-api.json index 7be0011867e..571045312bc 100644 --- a/displayvideo/v3/displayvideo-api.json +++ b/displayvideo/v3/displayvideo-api.json @@ -9155,7 +9155,7 @@ "parameterOrder": [], "parameters": { "filter": { - "description": "Allows filtering by user fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `budget.budget_segments.date_range.end_date` field must use the `LESS THAN (\u003c)` operator. * The `displayName and `email` field must use the `HAS (:)` operator. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `assignedUserRole.advertiserId` * `assignedUserRole.entityType` * This is synthetic field of `AssignedUserRole` used for filtering. Identifies the type of entity to which the user role is assigned. Valid values are `Partner` and `Advertiser`. * `assignedUserRole.parentPartnerId` * This is a synthetic field of `AssignedUserRole` used for filtering. Identifies the parent partner of the entity to which the user role is assigned. * `assignedUserRole.partnerId` * `assignedUserRole.userRole` * `displayName` * `email` Examples: * The user with `displayName` containing \"foo\": `displayName:\"foo\"` * The user with `email` containing \"bar\": `email:\"bar\"` * All users with standard user roles: `assignedUserRole.userRole=\"STANDARD\"` * All users with user roles for partner 123: `assignedUserRole.partnerId=\"123\"` * All users with user roles for advertiser 123: `assignedUserRole.advertiserId=\"123\"` * All users with partner level user roles: `entityType=\"PARTNER\"` * All users with user roles for partner 123 and advertisers under partner 123: `parentPartnerId=\"123\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", + "description": "Allows filtering by user fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `displayName` and `email` fields must use the `HAS (:)` operator. * The `lastLoginTime` field must use either the `LESS THAN OR EQUAL TO (\u003c=)` or `GREATER THAN OR EQUAL TO (\u003e=)` operator. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `assignedUserRole.advertiserId` * `assignedUserRole.entityType`: This is synthetic field of `AssignedUserRole` used for filtering. Identifies the type of entity to which the user role is assigned. Valid values are `Partner` and `Advertiser`. * `assignedUserRole.parentPartnerId`: This is a synthetic field of `AssignedUserRole` used for filtering. Identifies the parent partner of the entity to which the user role is assigned. * `assignedUserRole.partnerId` * `assignedUserRole.userRole` * `displayName` * `email` * `lastLoginTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * The user with `displayName` containing \"foo\": `displayName:\"foo\"` * The user with `email` containing \"bar\": `email:\"bar\"` * All users with standard user roles: `assignedUserRole.userRole=\"STANDARD\"` * All users with user roles for partner 123: `assignedUserRole.partnerId=\"123\"` * All users with user roles for advertiser 123: `assignedUserRole.advertiserId=\"123\"` * All users with partner level user roles: `entityType=\"PARTNER\"` * All users with user roles for partner 123 and advertisers under partner 123: `parentPartnerId=\"123\"` * All users that last logged in on or after 2023-01-01T00:00:00Z (format of ISO 8601): `lastLoginTime\u003e=\"2023-01-01T00:00:00Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -9222,7 +9222,7 @@ } } }, - "revision": "20240307", + "revision": "20240314", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActiveViewVideoViewabilityMetricConfig": { @@ -10340,7 +10340,9 @@ "APP_PLATFORM_XBOX", "APP_PLATFORM_SAMSUNG_TV", "APP_PLATFORM_ANDROID_TV", - "APP_PLATFORM_GENERIC_CTV" + "APP_PLATFORM_GENERIC_CTV", + "APP_PLATFORM_LG_TV", + "APP_PLATFORM_VIZIO_TV" ], "enumDescriptions": [ "Default value when app platform is not specified in this version. This enum is a placeholder for default value and does not represent a real platform option.", @@ -10353,7 +10355,9 @@ "The app platform is Xbox.", "The app platform is Samsung TV.", "The app platform is Android TV.", - "The app platform is a CTV platform that is not explicitly listed elsewhere." + "The app platform is a CTV platform that is not explicitly listed elsewhere.", + "The app platform is LG TV.", + "The app platform is VIZIO TV." ], "type": "string" }, @@ -21943,6 +21947,7 @@ "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM", "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA", "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM", + "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM", "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT", "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS", "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV", @@ -21955,6 +21960,7 @@ "A bidding strategy that pays a configurable amount per impression.", "A bidding strategy that automatically optimizes conversions per dollar.", "A bidding strategy that pays a configurable amount per impression.", + "A bidding strategy for YouTube Instant Reserve line items that pays a fixed amount per impression.", "An automated bidding strategy that sets bids to achieve maximum lift.", "A bidding strategy that automatically maximizes number of conversions given a daily budget.", "A bidding strategy that automatically optimizes cost per video view.", diff --git a/displayvideo/v3/displayvideo-gen.go b/displayvideo/v3/displayvideo-gen.go index 958217467d6..c0bfdd57b61 100644 --- a/displayvideo/v3/displayvideo-gen.go +++ b/displayvideo/v3/displayvideo-gen.go @@ -2259,6 +2259,8 @@ type AppAssignedTargetingOptionDetails struct { // "APP_PLATFORM_ANDROID_TV" - The app platform is Android TV. // "APP_PLATFORM_GENERIC_CTV" - The app platform is a CTV platform // that is not explicitly listed elsewhere. + // "APP_PLATFORM_LG_TV" - The app platform is LG TV. + // "APP_PLATFORM_VIZIO_TV" - The app platform is VIZIO TV. AppPlatform string `json:"appPlatform,omitempty"` // DisplayName: Output only. The display name of the app. @@ -19140,6 +19142,9 @@ type YoutubeAndPartnersBiddingStrategy struct { // strategy that automatically optimizes conversions per dollar. // "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM" - A bidding // strategy that pays a configurable amount per impression. + // "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM" - A + // bidding strategy for YouTube Instant Reserve line items that pays a + // fixed amount per impression. // "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT" - An // automated bidding strategy that sets bids to achieve maximum lift. // "YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS" - @@ -51620,19 +51625,20 @@ func (r *UsersService) List() *UsersListCall { // fields. Supported syntax: * Filter expressions are made up of one or // more restrictions. * Restrictions can be combined by the logical // operator `AND`. * A restriction has the form of `{field} {operator} -// {value}`. * The `budget.budget_segments.date_range.end_date` field -// must use the `LESS THAN (<)` operator. * The `displayName and `email` -// field must use the `HAS (:)` operator. * All other fields must use -// the `EQUALS (=)` operator. Supported fields: * -// `assignedUserRole.advertiserId` * `assignedUserRole.entityType` * -// This is synthetic field of `AssignedUserRole` used for filtering. -// Identifies the type of entity to which the user role is assigned. -// Valid values are `Partner` and `Advertiser`. * -// `assignedUserRole.parentPartnerId` * This is a synthetic field of -// `AssignedUserRole` used for filtering. Identifies the parent partner -// of the entity to which the user role is assigned. * -// `assignedUserRole.partnerId` * `assignedUserRole.userRole` * -// `displayName` * `email` Examples: * The user with `displayName` +// {value}`. * The `displayName` and `email` fields must use the `HAS +// (:)` operator. * The `lastLoginTime` field must use either the `LESS +// THAN OR EQUAL TO (<=)` or `GREATER THAN OR EQUAL TO (>=)` operator. * +// All other fields must use the `EQUALS (=)` operator. Supported +// fields: * `assignedUserRole.advertiserId` * +// `assignedUserRole.entityType`: This is synthetic field of +// `AssignedUserRole` used for filtering. Identifies the type of entity +// to which the user role is assigned. Valid values are `Partner` and +// `Advertiser`. * `assignedUserRole.parentPartnerId`: This is a +// synthetic field of `AssignedUserRole` used for filtering. Identifies +// the parent partner of the entity to which the user role is assigned. +// * `assignedUserRole.partnerId` * `assignedUserRole.userRole` * +// `displayName` * `email` * `lastLoginTime` (input in ISO 8601 format, +// or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * The user with `displayName` // containing "foo": `displayName:"foo" * The user with `email` // containing "bar": `email:"bar" * All users with standard user roles: // `assignedUserRole.userRole="STANDARD" * All users with user roles @@ -51640,9 +51646,11 @@ func (r *UsersService) List() *UsersListCall { // user roles for advertiser 123: `assignedUserRole.advertiserId="123" // * All users with partner level user roles: `entityType="PARTNER" * // All users with user roles for partner 123 and advertisers under -// partner 123: `parentPartnerId="123" The length of this field should -// be no more than 500 characters. Reference our filter `LIST` requests -// (/display-video/api/guides/how-tos/filters) guide for more +// partner 123: `parentPartnerId="123" * All users that last logged in +// on or after 2023-01-01T00:00:00Z (format of ISO 8601): +// `lastLoginTime>="2023-01-01T00:00:00Z" The length of this field +// should be no more than 500 characters. Reference our filter `LIST` +// requests (/display-video/api/guides/how-tos/filters) guide for more // information. func (c *UsersListCall) Filter(filter string) *UsersListCall { c.urlParams_.Set("filter", filter) @@ -51779,7 +51787,7 @@ func (c *UsersListCall) Do(opts ...googleapi.CallOption) (*ListUsersResponse, er // "parameterOrder": [], // "parameters": { // "filter": { - // "description": "Allows filtering by user fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `budget.budget_segments.date_range.end_date` field must use the `LESS THAN (\u003c)` operator. * The `displayName and `email` field must use the `HAS (:)` operator. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `assignedUserRole.advertiserId` * `assignedUserRole.entityType` * This is synthetic field of `AssignedUserRole` used for filtering. Identifies the type of entity to which the user role is assigned. Valid values are `Partner` and `Advertiser`. * `assignedUserRole.parentPartnerId` * This is a synthetic field of `AssignedUserRole` used for filtering. Identifies the parent partner of the entity to which the user role is assigned. * `assignedUserRole.partnerId` * `assignedUserRole.userRole` * `displayName` * `email` Examples: * The user with `displayName` containing \"foo\": `displayName:\"foo\"` * The user with `email` containing \"bar\": `email:\"bar\"` * All users with standard user roles: `assignedUserRole.userRole=\"STANDARD\"` * All users with user roles for partner 123: `assignedUserRole.partnerId=\"123\"` * All users with user roles for advertiser 123: `assignedUserRole.advertiserId=\"123\"` * All users with partner level user roles: `entityType=\"PARTNER\"` * All users with user roles for partner 123 and advertisers under partner 123: `parentPartnerId=\"123\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", + // "description": "Allows filtering by user fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `displayName` and `email` fields must use the `HAS (:)` operator. * The `lastLoginTime` field must use either the `LESS THAN OR EQUAL TO (\u003c=)` or `GREATER THAN OR EQUAL TO (\u003e=)` operator. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `assignedUserRole.advertiserId` * `assignedUserRole.entityType`: This is synthetic field of `AssignedUserRole` used for filtering. Identifies the type of entity to which the user role is assigned. Valid values are `Partner` and `Advertiser`. * `assignedUserRole.parentPartnerId`: This is a synthetic field of `AssignedUserRole` used for filtering. Identifies the parent partner of the entity to which the user role is assigned. * `assignedUserRole.partnerId` * `assignedUserRole.userRole` * `displayName` * `email` * `lastLoginTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * The user with `displayName` containing \"foo\": `displayName:\"foo\"` * The user with `email` containing \"bar\": `email:\"bar\"` * All users with standard user roles: `assignedUserRole.userRole=\"STANDARD\"` * All users with user roles for partner 123: `assignedUserRole.partnerId=\"123\"` * All users with user roles for advertiser 123: `assignedUserRole.advertiserId=\"123\"` * All users with partner level user roles: `entityType=\"PARTNER\"` * All users with user roles for partner 123 and advertisers under partner 123: `parentPartnerId=\"123\"` * All users that last logged in on or after 2023-01-01T00:00:00Z (format of ISO 8601): `lastLoginTime\u003e=\"2023-01-01T00:00:00Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, diff --git a/dlp/v2/dlp-api.json b/dlp/v2/dlp-api.json index 60987e793c8..600899f641d 100644 --- a/dlp/v2/dlp-api.json +++ b/dlp/v2/dlp-api.json @@ -537,7 +537,7 @@ ] }, "list": { - "description": "Lists data profiles for an organization.", + "description": "Lists column data profiles for an organization.", "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/columnDataProfiles", "httpMethod": "GET", "id": "dlp.organizations.locations.columnDataProfiles.list", @@ -567,7 +567,7 @@ "type": "string" }, "parent": { - "description": "Required. Resource name of the organization or project, for example `organizations/433245324/locations/europe` or projects/project-id/locations/asia.", + "description": "Required. Resource name of the organization or project, for example `organizations/433245324/locations/europe` or `projects/project-id/locations/asia`.", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, @@ -1321,7 +1321,7 @@ ] }, "list": { - "description": "Lists data profiles for an organization.", + "description": "Lists project data profiles for an organization.", "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/projectDataProfiles", "httpMethod": "GET", "id": "dlp.organizations.locations.projectDataProfiles.list", @@ -1330,12 +1330,12 @@ ], "parameters": { "filter": { - "description": "Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * project_id = 12345 AND status_code = 1 * project_id = 12345 AND sensitivity_level = HIGH The length of this field should be no more than 500 characters.", + "description": "Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * `project_id = 12345 AND status_code = 1` * `project_id = 12345 AND sensitivity_level = HIGH` The length of this field should be no more than 500 characters.", "location": "query", "type": "string" }, "orderBy": { - "description": "Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id` * `sensitivity_level desc` Supported fields are: - `project_id`: GCP project ID - `sensitivity_level`: How sensitive the data in a project is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds.", + "description": "Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id` * `sensitivity_level desc` Supported fields are: - `project_id`: Google Cloud project ID - `sensitivity_level`: How sensitive the data in a project is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds.", "location": "query", "type": "string" }, @@ -1552,7 +1552,7 @@ ] }, "list": { - "description": "Lists data profiles for an organization.", + "description": "Lists table data profiles for an organization.", "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/tableDataProfiles", "httpMethod": "GET", "id": "dlp.organizations.locations.tableDataProfiles.list", @@ -1561,12 +1561,12 @@ ], "parameters": { "filter": { - "description": "Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `project_id` - The GCP project ID. - `dataset_id` - The BigQuery dataset ID. - `table_id` - The ID of the BigQuery table. - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `resource_visibility`: PUBLIC|RESTRICTED - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * project_id = 12345 AND status_code = 1 * project_id = 12345 AND sensitivity_level = HIGH * project_id = 12345 AND resource_visibility = PUBLIC The length of this field should be no more than 500 characters.", + "description": "Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `project_id` - The Google Cloud project ID. - `dataset_id` - The BigQuery dataset ID. - `table_id` - The ID of the BigQuery table. - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `resource_visibility`: PUBLIC|RESTRICTED - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * `project_id = 12345 AND status_code = 1` * `project_id = 12345 AND sensitivity_level = HIGH` * `project_id = 12345 AND resource_visibility = PUBLIC` The length of this field should be no more than 500 characters.", "location": "query", "type": "string" }, "orderBy": { - "description": "Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id asc` * `table_id` * `sensitivity_level desc` Supported fields are: - `project_id`: The GCP project ID. - `dataset_id`: The ID of a BigQuery dataset. - `table_id`: The ID of a BigQuery table. - `sensitivity_level`: How sensitive the data in a table is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds. - `last_modified`: The last time the resource was modified. - `resource_visibility`: Visibility restriction for this resource. - `row_count`: Number of rows in this resource.", + "description": "Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id asc` * `table_id` * `sensitivity_level desc` Supported fields are: - `project_id`: The Google Cloud project ID. - `dataset_id`: The ID of a BigQuery dataset. - `table_id`: The ID of a BigQuery table. - `sensitivity_level`: How sensitive the data in a table is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds. - `last_modified`: The last time the resource was modified. - `resource_visibility`: Visibility restriction for this resource. - `row_count`: Number of rows in this resource.", "location": "query", "type": "string" }, @@ -2603,7 +2603,7 @@ ] }, "list": { - "description": "Lists data profiles for an organization.", + "description": "Lists column data profiles for an organization.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/columnDataProfiles", "httpMethod": "GET", "id": "dlp.projects.locations.columnDataProfiles.list", @@ -2633,7 +2633,7 @@ "type": "string" }, "parent": { - "description": "Required. Resource name of the organization or project, for example `organizations/433245324/locations/europe` or projects/project-id/locations/asia.", + "description": "Required. Resource name of the organization or project, for example `organizations/433245324/locations/europe` or `projects/project-id/locations/asia`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3725,7 +3725,7 @@ ] }, "list": { - "description": "Lists data profiles for an organization.", + "description": "Lists project data profiles for an organization.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/projectDataProfiles", "httpMethod": "GET", "id": "dlp.projects.locations.projectDataProfiles.list", @@ -3734,12 +3734,12 @@ ], "parameters": { "filter": { - "description": "Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * project_id = 12345 AND status_code = 1 * project_id = 12345 AND sensitivity_level = HIGH The length of this field should be no more than 500 characters.", + "description": "Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * `project_id = 12345 AND status_code = 1` * `project_id = 12345 AND sensitivity_level = HIGH` The length of this field should be no more than 500 characters.", "location": "query", "type": "string" }, "orderBy": { - "description": "Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id` * `sensitivity_level desc` Supported fields are: - `project_id`: GCP project ID - `sensitivity_level`: How sensitive the data in a project is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds.", + "description": "Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id` * `sensitivity_level desc` Supported fields are: - `project_id`: Google Cloud project ID - `sensitivity_level`: How sensitive the data in a project is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds.", "location": "query", "type": "string" }, @@ -3956,7 +3956,7 @@ ] }, "list": { - "description": "Lists data profiles for an organization.", + "description": "Lists table data profiles for an organization.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/tableDataProfiles", "httpMethod": "GET", "id": "dlp.projects.locations.tableDataProfiles.list", @@ -3965,12 +3965,12 @@ ], "parameters": { "filter": { - "description": "Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `project_id` - The GCP project ID. - `dataset_id` - The BigQuery dataset ID. - `table_id` - The ID of the BigQuery table. - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `resource_visibility`: PUBLIC|RESTRICTED - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * project_id = 12345 AND status_code = 1 * project_id = 12345 AND sensitivity_level = HIGH * project_id = 12345 AND resource_visibility = PUBLIC The length of this field should be no more than 500 characters.", + "description": "Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `project_id` - The Google Cloud project ID. - `dataset_id` - The BigQuery dataset ID. - `table_id` - The ID of the BigQuery table. - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `resource_visibility`: PUBLIC|RESTRICTED - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * `project_id = 12345 AND status_code = 1` * `project_id = 12345 AND sensitivity_level = HIGH` * `project_id = 12345 AND resource_visibility = PUBLIC` The length of this field should be no more than 500 characters.", "location": "query", "type": "string" }, "orderBy": { - "description": "Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id asc` * `table_id` * `sensitivity_level desc` Supported fields are: - `project_id`: The GCP project ID. - `dataset_id`: The ID of a BigQuery dataset. - `table_id`: The ID of a BigQuery table. - `sensitivity_level`: How sensitive the data in a table is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds. - `last_modified`: The last time the resource was modified. - `resource_visibility`: Visibility restriction for this resource. - `row_count`: Number of rows in this resource.", + "description": "Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id asc` * `table_id` * `sensitivity_level desc` Supported fields are: - `project_id`: The Google Cloud project ID. - `dataset_id`: The ID of a BigQuery dataset. - `table_id`: The ID of a BigQuery table. - `sensitivity_level`: How sensitive the data in a table is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds. - `last_modified`: The last time the resource was modified. - `resource_visibility`: Visibility restriction for this resource. - `row_count`: Number of rows in this resource.", "location": "query", "type": "string" }, @@ -4164,7 +4164,7 @@ } } }, - "revision": "20240225", + "revision": "20240310", "rootUrl": "https://dlp.googleapis.com/", "schemas": { "GooglePrivacyDlpV2Action": { diff --git a/dlp/v2/dlp-gen.go b/dlp/v2/dlp-gen.go index 106141622d6..0dd7f115232 100644 --- a/dlp/v2/dlp-gen.go +++ b/dlp/v2/dlp-gen.go @@ -13493,11 +13493,11 @@ type OrganizationsLocationsColumnDataProfilesListCall struct { header_ http.Header } -// List: Lists data profiles for an organization. +// List: Lists column data profiles for an organization. // // - parent: Resource name of the organization or project, for example // `organizations/433245324/locations/europe` or -// projects/project-id/locations/asia. +// `projects/project-id/locations/asia`. func (r *OrganizationsLocationsColumnDataProfilesService) List(parent string) *OrganizationsLocationsColumnDataProfilesListCall { c := &OrganizationsLocationsColumnDataProfilesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -13661,7 +13661,7 @@ func (c *OrganizationsLocationsColumnDataProfilesListCall) Do(opts ...googleapi. } return ret, nil // { - // "description": "Lists data profiles for an organization.", + // "description": "Lists column data profiles for an organization.", // "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/columnDataProfiles", // "httpMethod": "GET", // "id": "dlp.organizations.locations.columnDataProfiles.list", @@ -13691,7 +13691,7 @@ func (c *OrganizationsLocationsColumnDataProfilesListCall) Do(opts ...googleapi. // "type": "string" // }, // "parent": { - // "description": "Required. Resource name of the organization or project, for example `organizations/433245324/locations/europe` or projects/project-id/locations/asia.", + // "description": "Required. Resource name of the organization or project, for example `organizations/433245324/locations/europe` or `projects/project-id/locations/asia`.", // "location": "path", // "pattern": "^organizations/[^/]+/locations/[^/]+$", // "required": true, @@ -17528,7 +17528,7 @@ type OrganizationsLocationsProjectDataProfilesListCall struct { header_ http.Header } -// List: Lists data profiles for an organization. +// List: Lists project data profiles for an organization. // // - parent: organizations/{org_id}/locations/{loc_id}. func (r *OrganizationsLocationsProjectDataProfilesService) List(parent string) *OrganizationsLocationsProjectDataProfilesListCall { @@ -17546,9 +17546,9 @@ func (r *OrganizationsLocationsProjectDataProfilesService) List(parent string) * // `data_risk_level` - HIGH|MODERATE|LOW - `status_code` - an RPC status // code as defined in // https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto -// * The operator must be `=` or `!=`. Examples: * project_id = 12345 -// AND status_code = 1 * project_id = 12345 AND sensitivity_level = HIGH -// The length of this field should be no more than 500 characters. +// * The operator must be `=` or `!=`. Examples: * `project_id = 12345 +// AND status_code = 1` * `project_id = 12345 AND sensitivity_level = +// HIGH` The length of this field should be no more than 500 characters. func (c *OrganizationsLocationsProjectDataProfilesListCall) Filter(filter string) *OrganizationsLocationsProjectDataProfilesListCall { c.urlParams_.Set("filter", filter) return c @@ -17559,7 +17559,7 @@ func (c *OrganizationsLocationsProjectDataProfilesListCall) Filter(filter string // is case insensitive. The default sorting order is ascending. // Redundant space characters are insignificant. Only one order field at // a time is allowed. Examples: * `project_id` * `sensitivity_level -// desc` Supported fields are: - `project_id`: GCP project ID - +// desc` Supported fields are: - `project_id`: Google Cloud project ID - // `sensitivity_level`: How sensitive the data in a project is, at most. // - `data_risk_level`: How much risk is associated with this data. - // `profile_last_generated`: When the profile was last updated in epoch @@ -17685,7 +17685,7 @@ func (c *OrganizationsLocationsProjectDataProfilesListCall) Do(opts ...googleapi } return ret, nil // { - // "description": "Lists data profiles for an organization.", + // "description": "Lists project data profiles for an organization.", // "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/projectDataProfiles", // "httpMethod": "GET", // "id": "dlp.organizations.locations.projectDataProfiles.list", @@ -17694,12 +17694,12 @@ func (c *OrganizationsLocationsProjectDataProfilesListCall) Do(opts ...googleapi // ], // "parameters": { // "filter": { - // "description": "Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * project_id = 12345 AND status_code = 1 * project_id = 12345 AND sensitivity_level = HIGH The length of this field should be no more than 500 characters.", + // "description": "Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * `project_id = 12345 AND status_code = 1` * `project_id = 12345 AND sensitivity_level = HIGH` The length of this field should be no more than 500 characters.", // "location": "query", // "type": "string" // }, // "orderBy": { - // "description": "Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id` * `sensitivity_level desc` Supported fields are: - `project_id`: GCP project ID - `sensitivity_level`: How sensitive the data in a project is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds.", + // "description": "Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id` * `sensitivity_level desc` Supported fields are: - `project_id`: Google Cloud project ID - `sensitivity_level`: How sensitive the data in a project is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds.", // "location": "query", // "type": "string" // }, @@ -18747,7 +18747,7 @@ type OrganizationsLocationsTableDataProfilesListCall struct { header_ http.Header } -// List: Lists data profiles for an organization. +// List: Lists table data profiles for an organization. // // - parent: Resource name of the organization or project, for example // `organizations/433245324/locations/europe` or @@ -18763,16 +18763,16 @@ func (r *OrganizationsLocationsTableDataProfilesService) List(parent string) *Or // restrictions. * Restrictions can be combined by `AND` or `OR` logical // operators. A sequence of restrictions implicitly uses `AND`. * A // restriction has the form of `{field} {operator} {value}`. * Supported -// fields/values: - `project_id` - The GCP project ID. - `dataset_id` - -// The BigQuery dataset ID. - `table_id` - The ID of the BigQuery table. -// - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - -// HIGH|MODERATE|LOW - `resource_visibility`: PUBLIC|RESTRICTED - -// `status_code` - an RPC status code as defined in +// fields/values: - `project_id` - The Google Cloud project ID. - +// `dataset_id` - The BigQuery dataset ID. - `table_id` - The ID of the +// BigQuery table. - `sensitivity_level` - HIGH|MODERATE|LOW - +// `data_risk_level` - HIGH|MODERATE|LOW - `resource_visibility`: +// PUBLIC|RESTRICTED - `status_code` - an RPC status code as defined in // https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto -// * The operator must be `=` or `!=`. Examples: * project_id = 12345 -// AND status_code = 1 * project_id = 12345 AND sensitivity_level = HIGH -// * project_id = 12345 AND resource_visibility = PUBLIC The length of -// this field should be no more than 500 characters. +// * The operator must be `=` or `!=`. Examples: * `project_id = 12345 +// AND status_code = 1` * `project_id = 12345 AND sensitivity_level = +// HIGH` * `project_id = 12345 AND resource_visibility = PUBLIC` The +// length of this field should be no more than 500 characters. func (c *OrganizationsLocationsTableDataProfilesListCall) Filter(filter string) *OrganizationsLocationsTableDataProfilesListCall { c.urlParams_.Set("filter", filter) return c @@ -18784,13 +18784,13 @@ func (c *OrganizationsLocationsTableDataProfilesListCall) Filter(filter string) // Redundant space characters are insignificant. Only one order field at // a time is allowed. Examples: * `project_id asc` * `table_id` * // `sensitivity_level desc` Supported fields are: - `project_id`: The -// GCP project ID. - `dataset_id`: The ID of a BigQuery dataset. - -// `table_id`: The ID of a BigQuery table. - `sensitivity_level`: How -// sensitive the data in a table is, at most. - `data_risk_level`: How -// much risk is associated with this data. - `profile_last_generated`: -// When the profile was last updated in epoch seconds. - -// `last_modified`: The last time the resource was modified. - -// `resource_visibility`: Visibility restriction for this resource. - +// Google Cloud project ID. - `dataset_id`: The ID of a BigQuery +// dataset. - `table_id`: The ID of a BigQuery table. - +// `sensitivity_level`: How sensitive the data in a table is, at most. - +// `data_risk_level`: How much risk is associated with this data. - +// `profile_last_generated`: When the profile was last updated in epoch +// seconds. - `last_modified`: The last time the resource was modified. +// - `resource_visibility`: Visibility restriction for this resource. - // `row_count`: Number of rows in this resource. func (c *OrganizationsLocationsTableDataProfilesListCall) OrderBy(orderBy string) *OrganizationsLocationsTableDataProfilesListCall { c.urlParams_.Set("orderBy", orderBy) @@ -18915,7 +18915,7 @@ func (c *OrganizationsLocationsTableDataProfilesListCall) Do(opts ...googleapi.C } return ret, nil // { - // "description": "Lists data profiles for an organization.", + // "description": "Lists table data profiles for an organization.", // "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/tableDataProfiles", // "httpMethod": "GET", // "id": "dlp.organizations.locations.tableDataProfiles.list", @@ -18924,12 +18924,12 @@ func (c *OrganizationsLocationsTableDataProfilesListCall) Do(opts ...googleapi.C // ], // "parameters": { // "filter": { - // "description": "Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `project_id` - The GCP project ID. - `dataset_id` - The BigQuery dataset ID. - `table_id` - The ID of the BigQuery table. - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `resource_visibility`: PUBLIC|RESTRICTED - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * project_id = 12345 AND status_code = 1 * project_id = 12345 AND sensitivity_level = HIGH * project_id = 12345 AND resource_visibility = PUBLIC The length of this field should be no more than 500 characters.", + // "description": "Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `project_id` - The Google Cloud project ID. - `dataset_id` - The BigQuery dataset ID. - `table_id` - The ID of the BigQuery table. - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `resource_visibility`: PUBLIC|RESTRICTED - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * `project_id = 12345 AND status_code = 1` * `project_id = 12345 AND sensitivity_level = HIGH` * `project_id = 12345 AND resource_visibility = PUBLIC` The length of this field should be no more than 500 characters.", // "location": "query", // "type": "string" // }, // "orderBy": { - // "description": "Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id asc` * `table_id` * `sensitivity_level desc` Supported fields are: - `project_id`: The GCP project ID. - `dataset_id`: The ID of a BigQuery dataset. - `table_id`: The ID of a BigQuery table. - `sensitivity_level`: How sensitive the data in a table is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds. - `last_modified`: The last time the resource was modified. - `resource_visibility`: Visibility restriction for this resource. - `row_count`: Number of rows in this resource.", + // "description": "Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id asc` * `table_id` * `sensitivity_level desc` Supported fields are: - `project_id`: The Google Cloud project ID. - `dataset_id`: The ID of a BigQuery dataset. - `table_id`: The ID of a BigQuery table. - `sensitivity_level`: How sensitive the data in a table is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds. - `last_modified`: The last time the resource was modified. - `resource_visibility`: Visibility restriction for this resource. - `row_count`: Number of rows in this resource.", // "location": "query", // "type": "string" // }, @@ -24197,11 +24197,11 @@ type ProjectsLocationsColumnDataProfilesListCall struct { header_ http.Header } -// List: Lists data profiles for an organization. +// List: Lists column data profiles for an organization. // // - parent: Resource name of the organization or project, for example // `organizations/433245324/locations/europe` or -// projects/project-id/locations/asia. +// `projects/project-id/locations/asia`. func (r *ProjectsLocationsColumnDataProfilesService) List(parent string) *ProjectsLocationsColumnDataProfilesListCall { c := &ProjectsLocationsColumnDataProfilesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -24365,7 +24365,7 @@ func (c *ProjectsLocationsColumnDataProfilesListCall) Do(opts ...googleapi.CallO } return ret, nil // { - // "description": "Lists data profiles for an organization.", + // "description": "Lists column data profiles for an organization.", // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/columnDataProfiles", // "httpMethod": "GET", // "id": "dlp.projects.locations.columnDataProfiles.list", @@ -24395,7 +24395,7 @@ func (c *ProjectsLocationsColumnDataProfilesListCall) Do(opts ...googleapi.CallO // "type": "string" // }, // "parent": { - // "description": "Required. Resource name of the organization or project, for example `organizations/433245324/locations/europe` or projects/project-id/locations/asia.", + // "description": "Required. Resource name of the organization or project, for example `organizations/433245324/locations/europe` or `projects/project-id/locations/asia`.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, @@ -30040,7 +30040,7 @@ type ProjectsLocationsProjectDataProfilesListCall struct { header_ http.Header } -// List: Lists data profiles for an organization. +// List: Lists project data profiles for an organization. // // - parent: organizations/{org_id}/locations/{loc_id}. func (r *ProjectsLocationsProjectDataProfilesService) List(parent string) *ProjectsLocationsProjectDataProfilesListCall { @@ -30058,9 +30058,9 @@ func (r *ProjectsLocationsProjectDataProfilesService) List(parent string) *Proje // `data_risk_level` - HIGH|MODERATE|LOW - `status_code` - an RPC status // code as defined in // https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto -// * The operator must be `=` or `!=`. Examples: * project_id = 12345 -// AND status_code = 1 * project_id = 12345 AND sensitivity_level = HIGH -// The length of this field should be no more than 500 characters. +// * The operator must be `=` or `!=`. Examples: * `project_id = 12345 +// AND status_code = 1` * `project_id = 12345 AND sensitivity_level = +// HIGH` The length of this field should be no more than 500 characters. func (c *ProjectsLocationsProjectDataProfilesListCall) Filter(filter string) *ProjectsLocationsProjectDataProfilesListCall { c.urlParams_.Set("filter", filter) return c @@ -30071,7 +30071,7 @@ func (c *ProjectsLocationsProjectDataProfilesListCall) Filter(filter string) *Pr // is case insensitive. The default sorting order is ascending. // Redundant space characters are insignificant. Only one order field at // a time is allowed. Examples: * `project_id` * `sensitivity_level -// desc` Supported fields are: - `project_id`: GCP project ID - +// desc` Supported fields are: - `project_id`: Google Cloud project ID - // `sensitivity_level`: How sensitive the data in a project is, at most. // - `data_risk_level`: How much risk is associated with this data. - // `profile_last_generated`: When the profile was last updated in epoch @@ -30197,7 +30197,7 @@ func (c *ProjectsLocationsProjectDataProfilesListCall) Do(opts ...googleapi.Call } return ret, nil // { - // "description": "Lists data profiles for an organization.", + // "description": "Lists project data profiles for an organization.", // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/projectDataProfiles", // "httpMethod": "GET", // "id": "dlp.projects.locations.projectDataProfiles.list", @@ -30206,12 +30206,12 @@ func (c *ProjectsLocationsProjectDataProfilesListCall) Do(opts ...googleapi.Call // ], // "parameters": { // "filter": { - // "description": "Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * project_id = 12345 AND status_code = 1 * project_id = 12345 AND sensitivity_level = HIGH The length of this field should be no more than 500 characters.", + // "description": "Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * `project_id = 12345 AND status_code = 1` * `project_id = 12345 AND sensitivity_level = HIGH` The length of this field should be no more than 500 characters.", // "location": "query", // "type": "string" // }, // "orderBy": { - // "description": "Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id` * `sensitivity_level desc` Supported fields are: - `project_id`: GCP project ID - `sensitivity_level`: How sensitive the data in a project is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds.", + // "description": "Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id` * `sensitivity_level desc` Supported fields are: - `project_id`: Google Cloud project ID - `sensitivity_level`: How sensitive the data in a project is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds.", // "location": "query", // "type": "string" // }, @@ -31259,7 +31259,7 @@ type ProjectsLocationsTableDataProfilesListCall struct { header_ http.Header } -// List: Lists data profiles for an organization. +// List: Lists table data profiles for an organization. // // - parent: Resource name of the organization or project, for example // `organizations/433245324/locations/europe` or @@ -31275,16 +31275,16 @@ func (r *ProjectsLocationsTableDataProfilesService) List(parent string) *Project // restrictions. * Restrictions can be combined by `AND` or `OR` logical // operators. A sequence of restrictions implicitly uses `AND`. * A // restriction has the form of `{field} {operator} {value}`. * Supported -// fields/values: - `project_id` - The GCP project ID. - `dataset_id` - -// The BigQuery dataset ID. - `table_id` - The ID of the BigQuery table. -// - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - -// HIGH|MODERATE|LOW - `resource_visibility`: PUBLIC|RESTRICTED - -// `status_code` - an RPC status code as defined in +// fields/values: - `project_id` - The Google Cloud project ID. - +// `dataset_id` - The BigQuery dataset ID. - `table_id` - The ID of the +// BigQuery table. - `sensitivity_level` - HIGH|MODERATE|LOW - +// `data_risk_level` - HIGH|MODERATE|LOW - `resource_visibility`: +// PUBLIC|RESTRICTED - `status_code` - an RPC status code as defined in // https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto -// * The operator must be `=` or `!=`. Examples: * project_id = 12345 -// AND status_code = 1 * project_id = 12345 AND sensitivity_level = HIGH -// * project_id = 12345 AND resource_visibility = PUBLIC The length of -// this field should be no more than 500 characters. +// * The operator must be `=` or `!=`. Examples: * `project_id = 12345 +// AND status_code = 1` * `project_id = 12345 AND sensitivity_level = +// HIGH` * `project_id = 12345 AND resource_visibility = PUBLIC` The +// length of this field should be no more than 500 characters. func (c *ProjectsLocationsTableDataProfilesListCall) Filter(filter string) *ProjectsLocationsTableDataProfilesListCall { c.urlParams_.Set("filter", filter) return c @@ -31296,13 +31296,13 @@ func (c *ProjectsLocationsTableDataProfilesListCall) Filter(filter string) *Proj // Redundant space characters are insignificant. Only one order field at // a time is allowed. Examples: * `project_id asc` * `table_id` * // `sensitivity_level desc` Supported fields are: - `project_id`: The -// GCP project ID. - `dataset_id`: The ID of a BigQuery dataset. - -// `table_id`: The ID of a BigQuery table. - `sensitivity_level`: How -// sensitive the data in a table is, at most. - `data_risk_level`: How -// much risk is associated with this data. - `profile_last_generated`: -// When the profile was last updated in epoch seconds. - -// `last_modified`: The last time the resource was modified. - -// `resource_visibility`: Visibility restriction for this resource. - +// Google Cloud project ID. - `dataset_id`: The ID of a BigQuery +// dataset. - `table_id`: The ID of a BigQuery table. - +// `sensitivity_level`: How sensitive the data in a table is, at most. - +// `data_risk_level`: How much risk is associated with this data. - +// `profile_last_generated`: When the profile was last updated in epoch +// seconds. - `last_modified`: The last time the resource was modified. +// - `resource_visibility`: Visibility restriction for this resource. - // `row_count`: Number of rows in this resource. func (c *ProjectsLocationsTableDataProfilesListCall) OrderBy(orderBy string) *ProjectsLocationsTableDataProfilesListCall { c.urlParams_.Set("orderBy", orderBy) @@ -31427,7 +31427,7 @@ func (c *ProjectsLocationsTableDataProfilesListCall) Do(opts ...googleapi.CallOp } return ret, nil // { - // "description": "Lists data profiles for an organization.", + // "description": "Lists table data profiles for an organization.", // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/tableDataProfiles", // "httpMethod": "GET", // "id": "dlp.projects.locations.tableDataProfiles.list", @@ -31436,12 +31436,12 @@ func (c *ProjectsLocationsTableDataProfilesListCall) Do(opts ...googleapi.CallOp // ], // "parameters": { // "filter": { - // "description": "Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `project_id` - The GCP project ID. - `dataset_id` - The BigQuery dataset ID. - `table_id` - The ID of the BigQuery table. - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `resource_visibility`: PUBLIC|RESTRICTED - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * project_id = 12345 AND status_code = 1 * project_id = 12345 AND sensitivity_level = HIGH * project_id = 12345 AND resource_visibility = PUBLIC The length of this field should be no more than 500 characters.", + // "description": "Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * Supported fields/values: - `project_id` - The Google Cloud project ID. - `dataset_id` - The BigQuery dataset ID. - `table_id` - The ID of the BigQuery table. - `sensitivity_level` - HIGH|MODERATE|LOW - `data_risk_level` - HIGH|MODERATE|LOW - `resource_visibility`: PUBLIC|RESTRICTED - `status_code` - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto * The operator must be `=` or `!=`. Examples: * `project_id = 12345 AND status_code = 1` * `project_id = 12345 AND sensitivity_level = HIGH` * `project_id = 12345 AND resource_visibility = PUBLIC` The length of this field should be no more than 500 characters.", // "location": "query", // "type": "string" // }, // "orderBy": { - // "description": "Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id asc` * `table_id` * `sensitivity_level desc` Supported fields are: - `project_id`: The GCP project ID. - `dataset_id`: The ID of a BigQuery dataset. - `table_id`: The ID of a BigQuery table. - `sensitivity_level`: How sensitive the data in a table is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds. - `last_modified`: The last time the resource was modified. - `resource_visibility`: Visibility restriction for this resource. - `row_count`: Number of rows in this resource.", + // "description": "Comma separated list of fields to order by, followed by `asc` or `desc` postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed. Examples: * `project_id asc` * `table_id` * `sensitivity_level desc` Supported fields are: - `project_id`: The Google Cloud project ID. - `dataset_id`: The ID of a BigQuery dataset. - `table_id`: The ID of a BigQuery table. - `sensitivity_level`: How sensitive the data in a table is, at most. - `data_risk_level`: How much risk is associated with this data. - `profile_last_generated`: When the profile was last updated in epoch seconds. - `last_modified`: The last time the resource was modified. - `resource_visibility`: Visibility restriction for this resource. - `row_count`: Number of rows in this resource.", // "location": "query", // "type": "string" // }, diff --git a/firestore/v1/firestore-api.json b/firestore/v1/firestore-api.json index 5c6418b0be6..ab8d5bd69a1 100644 --- a/firestore/v1/firestore-api.json +++ b/firestore/v1/firestore-api.json @@ -1672,7 +1672,7 @@ } } }, - "revision": "20240226", + "revision": "20240307", "rootUrl": "https://firestore.googleapis.com/", "schemas": { "Aggregation": { @@ -2390,6 +2390,25 @@ }, "type": "object" }, + "GoogleFirestoreAdminV1CmekConfig": { + "description": "The CMEK (Customer Managed Encryption Key) configuration for a Firestore database. If not present, the database is secured by the default Google encryption key.", + "id": "GoogleFirestoreAdminV1CmekConfig", + "properties": { + "activeKeyVersion": { + "description": "Output only. Currently in-use [KMS key versions](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions). During [key rotation](https://cloud.google.com/kms/docs/key-rotation), there can be multiple in-use key versions. The expected format is `projects/{project_id}/locations/{kms_location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{key_version}`.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "kmsKeyName": { + "description": "Required. Only keys in the same location as this database are allowed to be used for encryption. For Firestore's nam5 multi-region, this corresponds to Cloud KMS multi-region us. For Firestore's eur3 multi-region, this corresponds to Cloud KMS multi-region europe. See https://cloud.google.com/kms/docs/locations. The expected format is `projects/{project_id}/locations/{kms_location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.", + "type": "string" + } + }, + "type": "object" + }, "GoogleFirestoreAdminV1CreateDatabaseMetadata": { "description": "Metadata related to the create database operation.", "id": "GoogleFirestoreAdminV1CreateDatabaseMetadata", @@ -2420,6 +2439,10 @@ ], "type": "string" }, + "cmekConfig": { + "$ref": "GoogleFirestoreAdminV1CmekConfig", + "description": "Optional. Presence indicates CMEK is enabled for this database." + }, "concurrencyMode": { "description": "The concurrency control mode to use for this database.", "enum": [ @@ -3069,7 +3092,7 @@ "id": "GoogleFirestoreAdminV1ListBackupsResponse", "properties": { "backups": { - "description": "List of all backups for the project. Ordered by `location ASC, create_time DESC, name ASC`.", + "description": "List of all backups for the project.", "items": { "$ref": "GoogleFirestoreAdminV1Backup" }, diff --git a/firestore/v1/firestore-gen.go b/firestore/v1/firestore-gen.go index c77cbd6bb9e..512562e8712 100644 --- a/firestore/v1/firestore-gen.go +++ b/firestore/v1/firestore-gen.go @@ -1658,6 +1658,53 @@ func (s *GoogleFirestoreAdminV1BackupSchedule) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleFirestoreAdminV1CmekConfig: The CMEK (Customer Managed +// Encryption Key) configuration for a Firestore database. If not +// present, the database is secured by the default Google encryption +// key. +type GoogleFirestoreAdminV1CmekConfig struct { + // ActiveKeyVersion: Output only. Currently in-use KMS key versions + // (https://cloud.google.com/kms/docs/resource-hierarchy#key_versions). + // During key rotation (https://cloud.google.com/kms/docs/key-rotation), + // there can be multiple in-use key versions. The expected format is + // `projects/{project_id}/locations/{kms_location}/keyRings/{key_ring}/cr + // yptoKeys/{crypto_key}/cryptoKeyVersions/{key_version}`. + ActiveKeyVersion []string `json:"activeKeyVersion,omitempty"` + + // KmsKeyName: Required. Only keys in the same location as this database + // are allowed to be used for encryption. For Firestore's nam5 + // multi-region, this corresponds to Cloud KMS multi-region us. For + // Firestore's eur3 multi-region, this corresponds to Cloud KMS + // multi-region europe. See https://cloud.google.com/kms/docs/locations. + // The expected format is + // `projects/{project_id}/locations/{kms_location}/keyRings/{key_ring}/cr + // yptoKeys/{crypto_key}`. + KmsKeyName string `json:"kmsKeyName,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ActiveKeyVersion") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ActiveKeyVersion") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleFirestoreAdminV1CmekConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleFirestoreAdminV1CmekConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleFirestoreAdminV1CreateDatabaseMetadata: Metadata related to the // create database operation. type GoogleFirestoreAdminV1CreateDatabaseMetadata struct { @@ -1684,6 +1731,10 @@ type GoogleFirestoreAdminV1Database struct { // created with the Firestore API. AppEngineIntegrationMode string `json:"appEngineIntegrationMode,omitempty"` + // CmekConfig: Optional. Presence indicates CMEK is enabled for this + // database. + CmekConfig *GoogleFirestoreAdminV1CmekConfig `json:"cmekConfig,omitempty"` + // ConcurrencyMode: The concurrency control mode to use for this // database. // @@ -2603,8 +2654,7 @@ func (s *GoogleFirestoreAdminV1ListBackupSchedulesResponse) MarshalJSON() ([]byt // GoogleFirestoreAdminV1ListBackupsResponse: The response for // FirestoreAdmin.ListBackups. type GoogleFirestoreAdminV1ListBackupsResponse struct { - // Backups: List of all backups for the project. Ordered by `location - // ASC, create_time DESC, name ASC`. + // Backups: List of all backups for the project. Backups []*GoogleFirestoreAdminV1Backup `json:"backups,omitempty"` // Unreachable: List of locations that existing backups were not able to diff --git a/logging/v2/logging-api.json b/logging/v2/logging-api.json index 00bf5c1a2dd..e5ca929fed9 100644 --- a/logging/v2/logging-api.json +++ b/logging/v2/logging-api.json @@ -28,6 +28,11 @@ "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/logging/docs/", "endpoints": [ + { + "description": "Regional Endpoint", + "endpointUrl": "https://logging.me-central2.rep.googleapis.com/", + "location": "me-central2" + }, { "description": "Regional Endpoint", "endpointUrl": "https://logging.europe-west3.rep.googleapis.com/", @@ -43,11 +48,6 @@ "endpointUrl": "https://logging.europe-west9.rep.googleapis.com/", "location": "europe-west9" }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://logging.me-central2.rep.googleapis.com/", - "location": "me-central2" - }, { "description": "Regional Endpoint", "endpointUrl": "https://logging.us-central1.rep.googleapis.com/", @@ -1542,6 +1542,11 @@ "parent" ], "parameters": { + "filter": { + "description": "Optional. A filter expression to constrain the sinks returned. Today, this only supports the following strings: '' 'in_scope(\"ALL\")', 'in_scope(\"ANCESTOR\")', 'in_scope(\"DEFAULT\")'.Description of scopes below. ALL: Includes all of the sinks which can be returned in any other scope. ANCESTOR: Includes intercepting sinks owned by ancestor resources. DEFAULT: Includes sinks owned by parent.When the empty string is provided, then the filter 'in_scope(\"DEFAULT\")' is applied.", + "location": "query", + "type": "string" + }, "pageSize": { "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", "format": "int32", @@ -3290,6 +3295,11 @@ "parent" ], "parameters": { + "filter": { + "description": "Optional. A filter expression to constrain the sinks returned. Today, this only supports the following strings: '' 'in_scope(\"ALL\")', 'in_scope(\"ANCESTOR\")', 'in_scope(\"DEFAULT\")'.Description of scopes below. ALL: Includes all of the sinks which can be returned in any other scope. ANCESTOR: Includes intercepting sinks owned by ancestor resources. DEFAULT: Includes sinks owned by parent.When the empty string is provided, then the filter 'in_scope(\"DEFAULT\")' is applied.", + "location": "query", + "type": "string" + }, "pageSize": { "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", "format": "int32", @@ -5682,6 +5692,11 @@ "parent" ], "parameters": { + "filter": { + "description": "Optional. A filter expression to constrain the sinks returned. Today, this only supports the following strings: '' 'in_scope(\"ALL\")', 'in_scope(\"ANCESTOR\")', 'in_scope(\"DEFAULT\")'.Description of scopes below. ALL: Includes all of the sinks which can be returned in any other scope. ANCESTOR: Includes intercepting sinks owned by ancestor resources. DEFAULT: Includes sinks owned by parent.When the empty string is provided, then the filter 'in_scope(\"DEFAULT\")' is applied.", + "location": "query", + "type": "string" + }, "pageSize": { "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", "format": "int32", @@ -7307,6 +7322,11 @@ "parent" ], "parameters": { + "filter": { + "description": "Optional. A filter expression to constrain the sinks returned. Today, this only supports the following strings: '' 'in_scope(\"ALL\")', 'in_scope(\"ANCESTOR\")', 'in_scope(\"DEFAULT\")'.Description of scopes below. ALL: Includes all of the sinks which can be returned in any other scope. ANCESTOR: Includes intercepting sinks owned by ancestor resources. DEFAULT: Includes sinks owned by parent.When the empty string is provided, then the filter 'in_scope(\"DEFAULT\")' is applied.", + "location": "query", + "type": "string" + }, "pageSize": { "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", "format": "int32", @@ -7535,6 +7555,11 @@ "parent" ], "parameters": { + "filter": { + "description": "Optional. A filter expression to constrain the sinks returned. Today, this only supports the following strings: '' 'in_scope(\"ALL\")', 'in_scope(\"ANCESTOR\")', 'in_scope(\"DEFAULT\")'.Description of scopes below. ALL: Includes all of the sinks which can be returned in any other scope. ANCESTOR: Includes intercepting sinks owned by ancestor resources. DEFAULT: Includes sinks owned by parent.When the empty string is provided, then the filter 'in_scope(\"DEFAULT\")' is applied.", + "location": "query", + "type": "string" + }, "pageSize": { "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", "format": "int32", @@ -7743,7 +7768,7 @@ } } }, - "revision": "20240301", + "revision": "20240311", "rootUrl": "https://logging.googleapis.com/", "schemas": { "BigQueryDataset": { @@ -9138,6 +9163,10 @@ "description": "Optional. This field applies only to sinks owned by organizations and folders. If the field is false, the default, only the logs owned by the sink's parent resource are available for export. If the field is true, then log entries from all the projects, folders, and billing accounts contained in the sink's parent resource are also available for export. Whether a particular log entry from the children is exported depends on the sink's filter expression.For example, if this field is true, then the filter resource.type=gce_instance would export all Compute Engine VM instance log entries from all projects in the sink's parent.To only export entries from certain child projects, filter on the project part of the log name:logName:(\"projects/test-project1/\" OR \"projects/test-project2/\") AND resource.type=gce_instance", "type": "boolean" }, + "interceptChildren": { + "description": "Optional. This field applies only to sinks owned by organizations and folders.When the value of 'intercept_children' is true, the following restrictions apply: The sink must have the include_children flag set to true. The sink destination must be a Cloud project.Also, the following behaviors apply: Any logs matched by the sink won't be included by non-_Required sinks owned by child resources. The sink appears in the results of a ListSinks call from a child resource if the value of the filter field in its request is either 'in_scope(\"ALL\")' or 'in_scope(\"ANCESTOR\")'.", + "type": "boolean" + }, "name": { "description": "Output only. The client-assigned sink identifier, unique within the project.For example: \"my-syslog-errors-to-pubsub\".Sink identifiers are limited to 100 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, periods.First character has to be alphanumeric.", "readOnly": true, @@ -9158,6 +9187,11 @@ ], "type": "string" }, + "resourceName": { + "description": "Output only. The resource name of the sink. \"projects/[PROJECT_ID]/sinks/[SINK_NAME] \"organizations/[ORGANIZATION_ID]/sinks/[SINK_NAME] \"billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_NAME] \"folders/[FOLDER_ID]/sinks/[SINK_NAME] For example: projects/my_project/sinks/SINK_NAME", + "readOnly": true, + "type": "string" + }, "updateTime": { "description": "Output only. The last update timestamp of the sink.This field may not be present for older sinks.", "format": "google-datetime", diff --git a/logging/v2/logging-gen.go b/logging/v2/logging-gen.go index a3892a720cf..dff96bf46ba 100644 --- a/logging/v2/logging-gen.go +++ b/logging/v2/logging-gen.go @@ -3392,6 +3392,17 @@ type LogSink struct { // "projects/test-project2/") AND resource.type=gce_instance IncludeChildren bool `json:"includeChildren,omitempty"` + // InterceptChildren: Optional. This field applies only to sinks owned + // by organizations and folders.When the value of 'intercept_children' + // is true, the following restrictions apply: The sink must have the + // include_children flag set to true. The sink destination must be a + // Cloud project.Also, the following behaviors apply: Any logs matched + // by the sink won't be included by non-_Required sinks owned by child + // resources. The sink appears in the results of a ListSinks call from a + // child resource if the value of the filter field in its request is + // either 'in_scope("ALL")' or 'in_scope("ANCESTOR")'. + InterceptChildren bool `json:"interceptChildren,omitempty"` + // Name: Output only. The client-assigned sink identifier, unique within // the project.For example: "my-syslog-errors-to-pubsub".Sink // identifiers are limited to 100 characters and can include only the @@ -3408,6 +3419,14 @@ type LogSink struct { // "V1" - LogEntry version 1 format. OutputVersionFormat string `json:"outputVersionFormat,omitempty"` + // ResourceName: Output only. The resource name of the sink. + // "projects/[PROJECT_ID]/sinks/[SINK_NAME] + // "organizations/[ORGANIZATION_ID]/sinks/[SINK_NAME] + // "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_NAME] + // "folders/[FOLDER_ID]/sinks/[SINK_NAME] For example: + // projects/my_project/sinks/SINK_NAME + ResourceName string `json:"resourceName,omitempty"` + // UpdateTime: Output only. The last update timestamp of the sink.This // field may not be present for older sinks. UpdateTime string `json:"updateTime,omitempty"` @@ -11599,6 +11618,19 @@ func (r *BillingAccountsSinksService) List(parent string) *BillingAccountsSinksL return c } +// Filter sets the optional parameter "filter": A filter expression to +// constrain the sinks returned. Today, this only supports the following +// strings: ” 'in_scope("ALL")', 'in_scope("ANCESTOR")', +// 'in_scope("DEFAULT")'.Description of scopes below. ALL: Includes all +// of the sinks which can be returned in any other scope. ANCESTOR: +// Includes intercepting sinks owned by ancestor resources. DEFAULT: +// Includes sinks owned by parent.When the empty string is provided, +// then the filter 'in_scope("DEFAULT")' is applied. +func (c *BillingAccountsSinksListCall) Filter(filter string) *BillingAccountsSinksListCall { + c.urlParams_.Set("filter", filter) + return c +} + // PageSize sets the optional parameter "pageSize": The maximum number // of results to return from this request. Non-positive values are // ignored. The presence of nextPageToken in the response indicates that @@ -11725,6 +11757,11 @@ func (c *BillingAccountsSinksListCall) Do(opts ...googleapi.CallOption) (*ListSi // "parent" // ], // "parameters": { + // "filter": { + // "description": "Optional. A filter expression to constrain the sinks returned. Today, this only supports the following strings: '' 'in_scope(\"ALL\")', 'in_scope(\"ANCESTOR\")', 'in_scope(\"DEFAULT\")'.Description of scopes below. ALL: Includes all of the sinks which can be returned in any other scope. ANCESTOR: Includes intercepting sinks owned by ancestor resources. DEFAULT: Includes sinks owned by parent.When the empty string is provided, then the filter 'in_scope(\"DEFAULT\")' is applied.", + // "location": "query", + // "type": "string" + // }, // "pageSize": { // "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", // "format": "int32", @@ -20373,6 +20410,19 @@ func (r *FoldersSinksService) List(parent string) *FoldersSinksListCall { return c } +// Filter sets the optional parameter "filter": A filter expression to +// constrain the sinks returned. Today, this only supports the following +// strings: ” 'in_scope("ALL")', 'in_scope("ANCESTOR")', +// 'in_scope("DEFAULT")'.Description of scopes below. ALL: Includes all +// of the sinks which can be returned in any other scope. ANCESTOR: +// Includes intercepting sinks owned by ancestor resources. DEFAULT: +// Includes sinks owned by parent.When the empty string is provided, +// then the filter 'in_scope("DEFAULT")' is applied. +func (c *FoldersSinksListCall) Filter(filter string) *FoldersSinksListCall { + c.urlParams_.Set("filter", filter) + return c +} + // PageSize sets the optional parameter "pageSize": The maximum number // of results to return from this request. Non-positive values are // ignored. The presence of nextPageToken in the response indicates that @@ -20499,6 +20549,11 @@ func (c *FoldersSinksListCall) Do(opts ...googleapi.CallOption) (*ListSinksRespo // "parent" // ], // "parameters": { + // "filter": { + // "description": "Optional. A filter expression to constrain the sinks returned. Today, this only supports the following strings: '' 'in_scope(\"ALL\")', 'in_scope(\"ANCESTOR\")', 'in_scope(\"DEFAULT\")'.Description of scopes below. ALL: Includes all of the sinks which can be returned in any other scope. ANCESTOR: Includes intercepting sinks owned by ancestor resources. DEFAULT: Includes sinks owned by parent.When the empty string is provided, then the filter 'in_scope(\"DEFAULT\")' is applied.", + // "location": "query", + // "type": "string" + // }, // "pageSize": { // "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", // "format": "int32", @@ -32219,6 +32274,19 @@ func (r *OrganizationsSinksService) List(parent string) *OrganizationsSinksListC return c } +// Filter sets the optional parameter "filter": A filter expression to +// constrain the sinks returned. Today, this only supports the following +// strings: ” 'in_scope("ALL")', 'in_scope("ANCESTOR")', +// 'in_scope("DEFAULT")'.Description of scopes below. ALL: Includes all +// of the sinks which can be returned in any other scope. ANCESTOR: +// Includes intercepting sinks owned by ancestor resources. DEFAULT: +// Includes sinks owned by parent.When the empty string is provided, +// then the filter 'in_scope("DEFAULT")' is applied. +func (c *OrganizationsSinksListCall) Filter(filter string) *OrganizationsSinksListCall { + c.urlParams_.Set("filter", filter) + return c +} + // PageSize sets the optional parameter "pageSize": The maximum number // of results to return from this request. Non-positive values are // ignored. The presence of nextPageToken in the response indicates that @@ -32345,6 +32413,11 @@ func (c *OrganizationsSinksListCall) Do(opts ...googleapi.CallOption) (*ListSink // "parent" // ], // "parameters": { + // "filter": { + // "description": "Optional. A filter expression to constrain the sinks returned. Today, this only supports the following strings: '' 'in_scope(\"ALL\")', 'in_scope(\"ANCESTOR\")', 'in_scope(\"DEFAULT\")'.Description of scopes below. ALL: Includes all of the sinks which can be returned in any other scope. ANCESTOR: Includes intercepting sinks owned by ancestor resources. DEFAULT: Includes sinks owned by parent.When the empty string is provided, then the filter 'in_scope(\"DEFAULT\")' is applied.", + // "location": "query", + // "type": "string" + // }, // "pageSize": { // "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", // "format": "int32", @@ -40250,6 +40323,19 @@ func (r *ProjectsSinksService) List(parent string) *ProjectsSinksListCall { return c } +// Filter sets the optional parameter "filter": A filter expression to +// constrain the sinks returned. Today, this only supports the following +// strings: ” 'in_scope("ALL")', 'in_scope("ANCESTOR")', +// 'in_scope("DEFAULT")'.Description of scopes below. ALL: Includes all +// of the sinks which can be returned in any other scope. ANCESTOR: +// Includes intercepting sinks owned by ancestor resources. DEFAULT: +// Includes sinks owned by parent.When the empty string is provided, +// then the filter 'in_scope("DEFAULT")' is applied. +func (c *ProjectsSinksListCall) Filter(filter string) *ProjectsSinksListCall { + c.urlParams_.Set("filter", filter) + return c +} + // PageSize sets the optional parameter "pageSize": The maximum number // of results to return from this request. Non-positive values are // ignored. The presence of nextPageToken in the response indicates that @@ -40376,6 +40462,11 @@ func (c *ProjectsSinksListCall) Do(opts ...googleapi.CallOption) (*ListSinksResp // "parent" // ], // "parameters": { + // "filter": { + // "description": "Optional. A filter expression to constrain the sinks returned. Today, this only supports the following strings: '' 'in_scope(\"ALL\")', 'in_scope(\"ANCESTOR\")', 'in_scope(\"DEFAULT\")'.Description of scopes below. ALL: Includes all of the sinks which can be returned in any other scope. ANCESTOR: Includes intercepting sinks owned by ancestor resources. DEFAULT: Includes sinks owned by parent.When the empty string is provided, then the filter 'in_scope(\"DEFAULT\")' is applied.", + // "location": "query", + // "type": "string" + // }, // "pageSize": { // "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", // "format": "int32", @@ -41354,6 +41445,19 @@ func (r *SinksService) List(parent string) *SinksListCall { return c } +// Filter sets the optional parameter "filter": A filter expression to +// constrain the sinks returned. Today, this only supports the following +// strings: ” 'in_scope("ALL")', 'in_scope("ANCESTOR")', +// 'in_scope("DEFAULT")'.Description of scopes below. ALL: Includes all +// of the sinks which can be returned in any other scope. ANCESTOR: +// Includes intercepting sinks owned by ancestor resources. DEFAULT: +// Includes sinks owned by parent.When the empty string is provided, +// then the filter 'in_scope("DEFAULT")' is applied. +func (c *SinksListCall) Filter(filter string) *SinksListCall { + c.urlParams_.Set("filter", filter) + return c +} + // PageSize sets the optional parameter "pageSize": The maximum number // of results to return from this request. Non-positive values are // ignored. The presence of nextPageToken in the response indicates that @@ -41480,6 +41584,11 @@ func (c *SinksListCall) Do(opts ...googleapi.CallOption) (*ListSinksResponse, er // "parent" // ], // "parameters": { + // "filter": { + // "description": "Optional. A filter expression to constrain the sinks returned. Today, this only supports the following strings: '' 'in_scope(\"ALL\")', 'in_scope(\"ANCESTOR\")', 'in_scope(\"DEFAULT\")'.Description of scopes below. ALL: Includes all of the sinks which can be returned in any other scope. ANCESTOR: Includes intercepting sinks owned by ancestor resources. DEFAULT: Includes sinks owned by parent.When the empty string is provided, then the filter 'in_scope(\"DEFAULT\")' is applied.", + // "location": "query", + // "type": "string" + // }, // "pageSize": { // "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", // "format": "int32", diff --git a/migrationcenter/v1alpha1/migrationcenter-api.json b/migrationcenter/v1alpha1/migrationcenter-api.json index e7185543a5a..711468c82ed 100644 --- a/migrationcenter/v1alpha1/migrationcenter-api.json +++ b/migrationcenter/v1alpha1/migrationcenter-api.json @@ -2107,7 +2107,7 @@ } } }, - "revision": "20240122", + "revision": "20240307", "rootUrl": "https://migrationcenter.googleapis.com/", "schemas": { "AddAssetsToGroupRequest": { @@ -2600,7 +2600,7 @@ "id": "ComputeEnginePreferences", "properties": { "licenseType": { - "description": "License type to consider when calculating costs for virtual machine insights and recommendations. If unspecified, costs are calculated based on the default licensing plan.", + "description": "Overridden by os_pricing_preferences if specified. License type to consider when calculating costs for virtual machine insights and recommendations. If unspecified, costs are calculated based on the default licensing plan.", "enum": [ "LICENSE_TYPE_UNSPECIFIED", "LICENSE_TYPE_DEFAULT", @@ -5404,8 +5404,8 @@ "enumDescriptions": [ "Unspecified commitment plan.", "No commitment plan (on-demand usage).", - "1 year commitment.", - "3 years commitment." + "1-year regular committed use discount.", + "3-year regular committed use discount." ], "type": "string" }, @@ -5871,8 +5871,8 @@ "enumDescriptions": [ "Unspecified commitment plan.", "No commitment plan.", - "1 year commitment.", - "3 years commitment." + "1-year regular committed use discount.", + "3-year regular committed use discount." ], "type": "string" }, diff --git a/migrationcenter/v1alpha1/migrationcenter-gen.go b/migrationcenter/v1alpha1/migrationcenter-gen.go index 03b506b728d..cacb3d2bef2 100644 --- a/migrationcenter/v1alpha1/migrationcenter-gen.go +++ b/migrationcenter/v1alpha1/migrationcenter-gen.go @@ -1164,9 +1164,10 @@ func (s *ComputeEngineMigrationTarget) MarshalJSON() ([]byte, error) { // ComputeEnginePreferences: The user preferences relating to Compute // Engine target platform. type ComputeEnginePreferences struct { - // LicenseType: License type to consider when calculating costs for - // virtual machine insights and recommendations. If unspecified, costs - // are calculated based on the default licensing plan. + // LicenseType: Overridden by os_pricing_preferences if specified. + // License type to consider when calculating costs for virtual machine + // insights and recommendations. If unspecified, costs are calculated + // based on the default licensing plan. // // Possible values: // "LICENSE_TYPE_UNSPECIFIED" - Unspecified (default value). @@ -5599,8 +5600,8 @@ type SoleTenancyPreferences struct { // Possible values: // "COMMITMENT_PLAN_UNSPECIFIED" - Unspecified commitment plan. // "ON_DEMAND" - No commitment plan (on-demand usage). - // "COMMITMENT_1_YEAR" - 1 year commitment. - // "COMMITMENT_3_YEAR" - 3 years commitment. + // "COMMITMENT_1_YEAR" - 1-year regular committed use discount. + // "COMMITMENT_3_YEAR" - 3-year regular committed use discount. CommitmentPlan string `json:"commitmentPlan,omitempty"` // CpuOvercommitRatio: CPU overcommit ratio. Acceptable values are @@ -6242,8 +6243,9 @@ type VirtualMachinePreferences struct { // Possible values: // "COMMITMENT_PLAN_UNSPECIFIED" - Unspecified commitment plan. // "COMMITMENT_PLAN_NONE" - No commitment plan. - // "COMMITMENT_PLAN_ONE_YEAR" - 1 year commitment. - // "COMMITMENT_PLAN_THREE_YEARS" - 3 years commitment. + // "COMMITMENT_PLAN_ONE_YEAR" - 1-year regular committed use discount. + // "COMMITMENT_PLAN_THREE_YEARS" - 3-year regular committed use + // discount. CommitmentPlan string `json:"commitmentPlan,omitempty"` // ComputeEnginePreferences: Compute Engine preferences concern insights diff --git a/people/v1/people-api.json b/people/v1/people-api.json index 1a52d87dec0..d633677ac41 100644 --- a/people/v1/people-api.json +++ b/people/v1/people-api.json @@ -724,6 +724,7 @@ }, "scopes": [ "https://www.googleapis.com/auth/contacts", + "https://www.googleapis.com/auth/contacts.other.readonly", "https://www.googleapis.com/auth/contacts.readonly", "https://www.googleapis.com/auth/directory.readonly", "https://www.googleapis.com/auth/user.addresses.read", @@ -788,6 +789,7 @@ }, "scopes": [ "https://www.googleapis.com/auth/contacts", + "https://www.googleapis.com/auth/contacts.other.readonly", "https://www.googleapis.com/auth/contacts.readonly", "https://www.googleapis.com/auth/directory.readonly", "https://www.googleapis.com/auth/user.addresses.read", @@ -1188,7 +1190,7 @@ } } }, - "revision": "20240312", + "revision": "20240313", "rootUrl": "https://people.googleapis.com/", "schemas": { "Address": { diff --git a/people/v1/people-gen.go b/people/v1/people-gen.go index f82690b8571..1ab4898ed5f 100644 --- a/people/v1/people-gen.go +++ b/people/v1/people-gen.go @@ -6324,6 +6324,7 @@ func (c *PeopleGetCall) Do(opts ...googleapi.CallOption) (*Person, error) { // }, // "scopes": [ // "https://www.googleapis.com/auth/contacts", + // "https://www.googleapis.com/auth/contacts.other.readonly", // "https://www.googleapis.com/auth/contacts.readonly", // "https://www.googleapis.com/auth/directory.readonly", // "https://www.googleapis.com/auth/user.addresses.read", @@ -6566,6 +6567,7 @@ func (c *PeopleGetBatchGetCall) Do(opts ...googleapi.CallOption) (*GetPeopleResp // }, // "scopes": [ // "https://www.googleapis.com/auth/contacts", + // "https://www.googleapis.com/auth/contacts.other.readonly", // "https://www.googleapis.com/auth/contacts.readonly", // "https://www.googleapis.com/auth/directory.readonly", // "https://www.googleapis.com/auth/user.addresses.read", diff --git a/run/v2/run-api.json b/run/v2/run-api.json index 32cd45037e9..c7db4c2ea46 100644 --- a/run/v2/run-api.json +++ b/run/v2/run-api.json @@ -1130,6 +1130,12 @@ "required": true, "type": "string" }, + "updateMask": { + "description": "Optional. The list of fields to be updated.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, "validateOnly": { "description": "Indicates that the request should be validated and default values populated, without persisting the request or updating any resources.", "location": "query", @@ -1317,7 +1323,7 @@ } } }, - "revision": "20240303", + "revision": "20240310", "rootUrl": "https://run.googleapis.com/", "schemas": { "GoogleCloudRunV2BinaryAuthorization": { @@ -2829,13 +2835,15 @@ "INGRESS_TRAFFIC_UNSPECIFIED", "INGRESS_TRAFFIC_ALL", "INGRESS_TRAFFIC_INTERNAL_ONLY", - "INGRESS_TRAFFIC_INTERNAL_LOAD_BALANCER" + "INGRESS_TRAFFIC_INTERNAL_LOAD_BALANCER", + "INGRESS_TRAFFIC_NONE" ], "enumDescriptions": [ "Unspecified", "All inbound traffic is allowed.", "Only internal traffic is allowed.", - "Both internal and Google Cloud Load Balancer traffic is allowed." + "Both internal and Google Cloud Load Balancer traffic is allowed.", + "No ingress traffic is allowed." ], "type": "string" }, diff --git a/run/v2/run-gen.go b/run/v2/run-gen.go index 148b912347a..70c10e884c1 100644 --- a/run/v2/run-gen.go +++ b/run/v2/run-gen.go @@ -2414,6 +2414,7 @@ type GoogleCloudRunV2Service struct { // "INGRESS_TRAFFIC_INTERNAL_ONLY" - Only internal traffic is allowed. // "INGRESS_TRAFFIC_INTERNAL_LOAD_BALANCER" - Both internal and Google // Cloud Load Balancer traffic is allowed. + // "INGRESS_TRAFFIC_NONE" - No ingress traffic is allowed. Ingress string `json:"ingress,omitempty"` // Labels: Optional. Unstructured key value map that can be used to @@ -9736,6 +9737,13 @@ func (c *ProjectsLocationsServicesPatchCall) AllowMissing(allowMissing bool) *Pr return c } +// UpdateMask sets the optional parameter "updateMask": The list of +// fields to be updated. +func (c *ProjectsLocationsServicesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsServicesPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + // ValidateOnly sets the optional parameter "validateOnly": Indicates // that the request should be validated and default values populated, // without persisting the request or updating any resources. @@ -9855,6 +9863,12 @@ func (c *ProjectsLocationsServicesPatchCall) Do(opts ...googleapi.CallOption) (* // "required": true, // "type": "string" // }, + // "updateMask": { + // "description": "Optional. The list of fields to be updated.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // }, // "validateOnly": { // "description": "Indicates that the request should be validated and default values populated, without persisting the request or updating any resources.", // "location": "query", diff --git a/testing/v1/testing-api.json b/testing/v1/testing-api.json index 778a224db96..a40e4ce41c4 100644 --- a/testing/v1/testing-api.json +++ b/testing/v1/testing-api.json @@ -448,7 +448,7 @@ } } }, - "revision": "20240213", + "revision": "20240311", "rootUrl": "https://testing.googleapis.com/", "schemas": { "Account": { @@ -1227,7 +1227,7 @@ "type": "array" }, "ttl": { - "description": "Optional. The amount of time that a device will be initially allocated for. This can eventually be extended with the UpdateDeviceSession RPC. Default: 30 minutes.", + "description": "Optional. The amount of time that a device will be initially allocated for. This can eventually be extended with the UpdateDeviceSession RPC. Default: 15 minutes.", "format": "google-duration", "type": "string" } diff --git a/testing/v1/testing-gen.go b/testing/v1/testing-gen.go index 65c59fb3912..3659bea84bd 100644 --- a/testing/v1/testing-gen.go +++ b/testing/v1/testing-gen.go @@ -1308,7 +1308,7 @@ type DeviceSession struct { // Ttl: Optional. The amount of time that a device will be initially // allocated for. This can eventually be extended with the - // UpdateDeviceSession RPC. Default: 30 minutes. + // UpdateDeviceSession RPC. Default: 15 minutes. Ttl string `json:"ttl,omitempty"` // ServerResponse contains the HTTP response code and headers from the