diff --git a/DiscoveryJson/androidenterprise.v1.json b/DiscoveryJson/androidenterprise.v1.json index 1505d698ee6..94eda845bde 100644 --- a/DiscoveryJson/androidenterprise.v1.json +++ b/DiscoveryJson/androidenterprise.v1.json @@ -2654,7 +2654,7 @@ } } }, - "revision": "20241021", + "revision": "20241028", "rootUrl": "https://androidenterprise.googleapis.com/", "schemas": { "Administrator": { @@ -4015,7 +4015,7 @@ "properties": { "autoUpdatePolicy": { "deprecated": true, - "description": "Controls when automatic app updates on the device can be applied. Recommended alternative: autoUpdateMode which is set per app, provides greater flexibility around update frequency. When autoUpdateMode is set to AUTO_UPDATE_POSTPONED or AUTO_UPDATE_HIGH_PRIORITY, autoUpdatePolicy has no effect. \"choiceToTheUser\" allows the device's user to configure the app update policy. \"always\" enables auto updates. \"never\" disables auto updates. \"wifiOnly\" enables auto updates only when the device is connected to wifi.", + "description": "Controls when automatic app updates on the device can be applied. Recommended alternative: autoUpdateMode which is set per app, provides greater flexibility around update frequency. When autoUpdateMode is set to AUTO_UPDATE_POSTPONED or AUTO_UPDATE_HIGH_PRIORITY, autoUpdatePolicy has no effect. - choiceToTheUser allows the device's user to configure the app update policy. - always enables auto updates. - never disables auto updates. - wifiOnly enables auto updates only when the device is connected to wifi. *Important:* Changes to app update policies don't affect updates that are in progress. Any policy changes will apply to subsequent app updates. ", "enum": [ "autoUpdatePolicyUnspecified", "choiceToTheUser", diff --git a/DiscoveryJson/bigqueryreservation.v1.json b/DiscoveryJson/bigqueryreservation.v1.json index 9f4708c8b3e..1a5e3c53b74 100644 --- a/DiscoveryJson/bigqueryreservation.v1.json +++ b/DiscoveryJson/bigqueryreservation.v1.json @@ -935,7 +935,7 @@ } } }, - "revision": "20240921", + "revision": "20241023", "rootUrl": "https://bigqueryreservation.googleapis.com/", "schemas": { "Assignment": { @@ -946,6 +946,10 @@ "description": "The resource which will use the reservation. E.g. `projects/myproject`, `folders/123`, or `organizations/456`.", "type": "string" }, + "enableGeminiInBigquery": { + "description": "Optional. This field controls if \"Gemini in BigQuery\" (https://cloud.google.com/gemini/docs/bigquery/overview) features should be enabled for this reservation assignment, which is not on by default. \"Gemini in BigQuery\" has a distinct compliance posture from BigQuery. If this field is set to true, the assignment job type is QUERY, and the parent reservation edition is ENTERPRISE_PLUS, then the assignment will give the grantee project/organization access to \"Gemini in BigQuery\" features.", + "type": "boolean" + }, "jobType": { "description": "Which type of jobs will use the reservation.", "enum": [ @@ -994,7 +998,7 @@ "id": "Autoscale", "properties": { "currentSlots": { - "description": "Output only. The slot capacity added to this reservation when autoscale happens. Will be between [0, max_slots].", + "description": "Output only. The slot capacity added to this reservation when autoscale happens. Will be between [0, max_slots]. Note: after users reduce max_slots, it may take a while before it can be propagated, so current_slots may stay in the original value and could be larger than max_slots for that brief period (less than one minute)", "format": "int64", "readOnly": true, "type": "string" @@ -1326,6 +1330,13 @@ "description": "If false, any query or pipeline job using this reservation will use idle slots from other reservations within the same admin project. If true, a query or pipeline job using this reservation will execute with the slot capacity specified in the slot_capacity field at most.", "type": "boolean" }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. The labels associated with this reservation. You can use these to organize and group your reservations. You can set this property when inserting or updating a reservation.", + "type": "object" + }, "multiRegionAuxiliary": { "description": "Applicable only for reservations located within one of the BigQuery multi-regions (US or EU). If set to true, this reservation is placed in the organization's secondary region which is designated for disaster recovery purposes. If false, this reservation is placed in the organization's default region. NOTE: this is a preview feature. Project must be allow-listed in order to set this field.", "type": "boolean" diff --git a/DiscoveryJson/cloudbuild.v1.json b/DiscoveryJson/cloudbuild.v1.json index 7bf4fa27a16..b65bf1f1d27 100644 --- a/DiscoveryJson/cloudbuild.v1.json +++ b/DiscoveryJson/cloudbuild.v1.json @@ -2346,7 +2346,7 @@ } } }, - "revision": "20240923", + "revision": "20241025", "rootUrl": "https://cloudbuild.googleapis.com/", "schemas": { "ApprovalConfig": { @@ -4631,6 +4631,10 @@ "$ref": "NetworkConfig", "description": "Network configuration for the pool." }, + "privateServiceConnect": { + "$ref": "PrivateServiceConnect", + "description": "Immutable. Private Service Connect(PSC) Network configuration for the pool." + }, "workerConfig": { "$ref": "WorkerConfig", "description": "Machine configuration for the workers in the pool." @@ -4638,6 +4642,25 @@ }, "type": "object" }, + "PrivateServiceConnect": { + "description": "Defines the Private Service Connect network configuration for the pool.", + "id": "PrivateServiceConnect", + "properties": { + "networkAttachment": { + "description": "Required. Immutable. The network attachment that the worker network interface is peered to. Must be in the format `projects/{project}/regions/{region}/networkAttachments/{networkAttachment}`. The region of network attachment must be the same as the worker pool. See [Network Attachments](https://cloud.google.com/vpc/docs/about-network-attachments)", + "type": "string" + }, + "publicIpAddressDisabled": { + "description": "Required. Immutable. Disable public IP on the primary network interface. If true, workers are created without any public address, which prevents network egress to public IPs unless a network proxy is configured. If false, workers are created with a public address which allows for public internet egress. The public address only applies to traffic through the primary network interface. If `route_all_traffic` is set to true, all traffic will go through the non-primary network interface, this boolean has no effect.", + "type": "boolean" + }, + "routeAllTraffic": { + "description": "Immutable. Route all traffic through PSC interface. Enable this if you want full control of traffic in the private pool. Configure Cloud NAT for the subnet of network attachment if you need to access public Internet. If false, Only route private IPs, e.g. 10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16 through PSC interface.", + "type": "boolean" + } + }, + "type": "object" + }, "ProcessAppManifestCallbackOperationMetadata": { "description": "Metadata for `ProcessAppManifestCallback` operation.", "id": "ProcessAppManifestCallbackOperationMetadata", diff --git a/DiscoveryJson/compute.alpha.json b/DiscoveryJson/compute.alpha.json index aaa7fb5d237..5a6c00a817f 100644 --- a/DiscoveryJson/compute.alpha.json +++ b/DiscoveryJson/compute.alpha.json @@ -11621,7 +11621,7 @@ ] }, "addNetworkInterface": { - "description": "Adds a network interface to an instance.", + "description": "Adds one dynamic network interface to an active instance.", "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/addNetworkInterface", "httpMethod": "POST", "id": "compute.instances.addNetworkInterface", @@ -11996,7 +11996,7 @@ ] }, "deleteNetworkInterface": { - "description": "Deletes one network interface from an active instance. InstancesDeleteNetworkInterfaceRequest indicates: - instance from which to delete, using project+zone+resource_id fields; - network interface to be deleted, using network_interface_name field; Only VLAN interface deletion is supported for now.", + "description": "Deletes one dynamic network interface from an active instance. InstancesDeleteNetworkInterfaceRequest indicates: - instance from which to delete, using project+zone+resource_id fields; - dynamic network interface to be deleted, using network_interface_name field;", "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/deleteNetworkInterface", "httpMethod": "POST", "id": "compute.instances.deleteNetworkInterface", @@ -12014,7 +12014,7 @@ "type": "string" }, "networkInterfaceName": { - "description": "The name of the network interface to be deleted from the instance. Only VLAN network interface deletion is supported.", + "description": "The name of the dynamic network interface to be deleted from the instance.", "location": "query", "required": true, "type": "string" @@ -12438,7 +12438,7 @@ "type": "string" }, "start": { - "description": "Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console.", + "description": "Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console. Note that the negative start is bounded by the retained buffer size, and the returned serial console output will not exceed the max buffer size.", "format": "int64", "location": "query", "type": "string" @@ -47179,7 +47179,7 @@ } } }, - "revision": "20241015", + "revision": "20241021", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -50161,7 +50161,7 @@ "description": "The CacheKeyPolicy for this CdnPolicy." }, "cacheMode": { - "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", + "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC.", "enum": [ "CACHE_ALL_STATIC", "FORCE_CACHE_ALL", @@ -51152,7 +51152,7 @@ "description": "The CacheKeyPolicy for this CdnPolicy." }, "cacheMode": { - "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", + "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC.", "enum": [ "CACHE_ALL_STATIC", "FORCE_CACHE_ALL", @@ -75595,19 +75595,23 @@ "enum": [ "GVNIC", "IDPF", + "IRDMA", + "MRDMA", "UNSPECIFIED_NIC_TYPE", "VIRTIO_NET" ], "enumDescriptions": [ "GVNIC", "IDPF", + "IRDMA", + "MRDMA", "No type specified.", "VIRTIO" ], "type": "string" }, "parentNicName": { - "description": "Name of the parent network interface of a VLAN based nic. If this field is specified, vlan must be set.", + "description": "Name of the parent network interface of a dynamic network interface.", "type": "string" }, "queueCount": { @@ -75641,7 +75645,7 @@ "type": "string" }, "vlan": { - "description": "VLAN tag of a VLAN based network interface, must be in range from 2 to 4094 inclusively. This field is mandatory if the parent network interface name is set.", + "description": "VLAN tag of a dynamic network interface, must be in range from 2 to 4094 inclusively.", "format": "int32", "type": "integer" } @@ -75962,6 +75966,10 @@ "description": "[Output Only] Type of the resource. Always compute#networkProfile for network profiles.", "type": "string" }, + "location": { + "$ref": "NetworkProfileLocation", + "description": "[Output Only] Location to which the network is restricted." + }, "name": { "description": "[Output Only] Name of the resource.", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", @@ -75982,6 +75990,26 @@ }, "type": "object" }, + "NetworkProfileLocation": { + "id": "NetworkProfileLocation", + "properties": { + "name": { + "type": "string" + }, + "scope": { + "enum": [ + "REGION", + "ZONE" + ], + "enumDescriptions": [ + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, "NetworkProfileNetworkFeatures": { "id": "NetworkProfileNetworkFeatures", "properties": { @@ -76224,12 +76252,16 @@ "enum": [ "GVNIC", "IDPF", + "IRDMA", + "MRDMA", "UNSPECIFIED_NIC_TYPE", "VIRTIO_NET" ], "enumDescriptions": [ "GVNIC", "IDPF", + "IRDMA", + "MRDMA", "No type specified.", "VIRTIO" ], @@ -97266,7 +97298,7 @@ "type": "string" }, "purpose": { - "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", + "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", "enum": [ "AGGREGATE", "CLOUD_EXTENSION", @@ -102923,7 +102955,7 @@ "type": "string" }, "purpose": { - "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", + "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", "enum": [ "AGGREGATE", "CLOUD_EXTENSION", diff --git a/DiscoveryJson/dataplex.v1.json b/DiscoveryJson/dataplex.v1.json index 6c52fc46237..329fa70929f 100644 --- a/DiscoveryJson/dataplex.v1.json +++ b/DiscoveryJson/dataplex.v1.json @@ -15,6 +15,233 @@ "description": "Dataplex API is used to manage the lifecycle of data lakes.", "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/dataplex/docs", + "endpoints": [ + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.africa-south1.rep.googleapis.com/", + "location": "africa-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-east1.rep.googleapis.com/", + "location": "asia-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-east2.rep.googleapis.com/", + "location": "asia-east2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-northeast1.rep.googleapis.com/", + "location": "asia-northeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-northeast2.rep.googleapis.com/", + "location": "asia-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-northeast3.rep.googleapis.com/", + "location": "asia-northeast3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-south1.rep.googleapis.com/", + "location": "asia-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-south2.rep.googleapis.com/", + "location": "asia-south2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-southeast1.rep.googleapis.com/", + "location": "asia-southeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-southeast2.rep.googleapis.com/", + "location": "asia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.australia-southeast1.rep.googleapis.com/", + "location": "australia-southeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.australia-southeast2.rep.googleapis.com/", + "location": "australia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-central2.rep.googleapis.com/", + "location": "europe-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-north1.rep.googleapis.com/", + "location": "europe-north1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-north2.rep.googleapis.com/", + "location": "europe-north2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-southwest1.rep.googleapis.com/", + "location": "europe-southwest1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west1.rep.googleapis.com/", + "location": "europe-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west10.rep.googleapis.com/", + "location": "europe-west10" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west12.rep.googleapis.com/", + "location": "europe-west12" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west2.rep.googleapis.com/", + "location": "europe-west2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west3.rep.googleapis.com/", + "location": "europe-west3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west4.rep.googleapis.com/", + "location": "europe-west4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west6.rep.googleapis.com/", + "location": "europe-west6" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west8.rep.googleapis.com/", + "location": "europe-west8" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west9.rep.googleapis.com/", + "location": "europe-west9" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.me-central1.rep.googleapis.com/", + "location": "me-central1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.me-central2.rep.googleapis.com/", + "location": "me-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.me-west1.rep.googleapis.com/", + "location": "me-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.northamerica-northeast1.rep.googleapis.com/", + "location": "northamerica-northeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.northamerica-northeast2.rep.googleapis.com/", + "location": "northamerica-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.northamerica-south1.rep.googleapis.com/", + "location": "northamerica-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.southamerica-east1.rep.googleapis.com/", + "location": "southamerica-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.southamerica-west1.rep.googleapis.com/", + "location": "southamerica-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-central1.rep.googleapis.com/", + "location": "us-central1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-central2.rep.googleapis.com/", + "location": "us-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-east1.rep.googleapis.com/", + "location": "us-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-east4.rep.googleapis.com/", + "location": "us-east4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-east5.rep.googleapis.com/", + "location": "us-east5" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-east7.rep.googleapis.com/", + "location": "us-east7" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-south1.rep.googleapis.com/", + "location": "us-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-west1.rep.googleapis.com/", + "location": "us-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-west2.rep.googleapis.com/", + "location": "us-west2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-west3.rep.googleapis.com/", + "location": "us-west3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-west4.rep.googleapis.com/", + "location": "us-west4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-west8.rep.googleapis.com/", + "location": "us-west8" + } + ], "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -5997,7 +6224,7 @@ } } }, - "revision": "20241001", + "revision": "20241019", "rootUrl": "https://dataplex.googleapis.com/", "schemas": { "Empty": { @@ -7118,6 +7345,142 @@ }, "type": "object" }, + "GoogleCloudDataplexV1DataDiscoveryResult": { + "description": "The output of a data discovery scan.", + "id": "GoogleCloudDataplexV1DataDiscoveryResult", + "properties": { + "bigqueryPublishing": { + "$ref": "GoogleCloudDataplexV1DataDiscoveryResultBigQueryPublishing", + "description": "Output only. Configuration for metadata publishing.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleCloudDataplexV1DataDiscoveryResultBigQueryPublishing": { + "description": "Describes BigQuery publishing configurations.", + "id": "GoogleCloudDataplexV1DataDiscoveryResultBigQueryPublishing", + "properties": { + "dataset": { + "description": "Output only. The BigQuery dataset to publish to. It takes the form projects/{project_id}/datasets/{dataset_id}. If not set, the service creates a default publishing dataset.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDataplexV1DataDiscoverySpec": { + "description": "Spec for a data discovery scan.", + "id": "GoogleCloudDataplexV1DataDiscoverySpec", + "properties": { + "bigqueryPublishingConfig": { + "$ref": "GoogleCloudDataplexV1DataDiscoverySpecBigQueryPublishingConfig", + "description": "Optional. Configuration for metadata publishing." + }, + "storageConfig": { + "$ref": "GoogleCloudDataplexV1DataDiscoverySpecStorageConfig", + "description": "Cloud Storage related configurations." + } + }, + "type": "object" + }, + "GoogleCloudDataplexV1DataDiscoverySpecBigQueryPublishingConfig": { + "description": "Describes BigQuery publishing configurations.", + "id": "GoogleCloudDataplexV1DataDiscoverySpecBigQueryPublishingConfig", + "properties": { + "connection": { + "description": "Optional. The BigQuery connection used to create BigLake tables. Must be in the form projects/{project_id}/locations/{location_id}/connections/{connection_id}", + "type": "string" + }, + "tableType": { + "description": "Optional. Determines whether to publish discovered tables as BigLake external tables or non-BigLake external tables.", + "enum": [ + "TABLE_TYPE_UNSPECIFIED", + "EXTERNAL", + "BIGLAKE" + ], + "enumDescriptions": [ + "Table type unspecified.", + "Default. Discovered tables are published as BigQuery external tables whose data is accessed using the credentials of the user querying the table.", + "Discovered tables are published as BigLake external tables whose data is accessed using the credentials of the associated BigQuery connection." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDataplexV1DataDiscoverySpecStorageConfig": { + "description": "Configurations related to Cloud Storage as the data source.", + "id": "GoogleCloudDataplexV1DataDiscoverySpecStorageConfig", + "properties": { + "csvOptions": { + "$ref": "GoogleCloudDataplexV1DataDiscoverySpecStorageConfigCsvOptions", + "description": "Optional. Configuration for CSV data." + }, + "excludePatterns": { + "description": "Optional. Defines the data to exclude during discovery. Provide a list of patterns that identify the data to exclude. For Cloud Storage bucket assets, these patterns are interpreted as glob patterns used to match object names. For BigQuery dataset assets, these patterns are interpreted as patterns to match table names.", + "items": { + "type": "string" + }, + "type": "array" + }, + "includePatterns": { + "description": "Optional. Defines the data to include during discovery when only a subset of the data should be considered. Provide a list of patterns that identify the data to include. For Cloud Storage bucket assets, these patterns are interpreted as glob patterns used to match object names. For BigQuery dataset assets, these patterns are interpreted as patterns to match table names.", + "items": { + "type": "string" + }, + "type": "array" + }, + "jsonOptions": { + "$ref": "GoogleCloudDataplexV1DataDiscoverySpecStorageConfigJsonOptions", + "description": "Optional. Configuration for JSON data." + } + }, + "type": "object" + }, + "GoogleCloudDataplexV1DataDiscoverySpecStorageConfigCsvOptions": { + "description": "Describes CSV and similar semi-structured data formats.", + "id": "GoogleCloudDataplexV1DataDiscoverySpecStorageConfigCsvOptions", + "properties": { + "delimiter": { + "description": "Optional. The delimiter that is used to separate values. The default is , (comma).", + "type": "string" + }, + "encoding": { + "description": "Optional. The character encoding of the data. The default is UTF-8.", + "type": "string" + }, + "headerRows": { + "description": "Optional. The number of rows to interpret as header rows that should be skipped when reading data rows.", + "format": "int32", + "type": "integer" + }, + "quote": { + "description": "Optional. The character used to quote column values. Accepts \" (double quotation mark) or ' (single quotation mark). If unspecified, defaults to \" (double quotation mark).", + "type": "string" + }, + "typeInferenceDisabled": { + "description": "Optional. Whether to disable the inference of data types for CSV data. If true, all columns are registered as strings.", + "type": "boolean" + } + }, + "type": "object" + }, + "GoogleCloudDataplexV1DataDiscoverySpecStorageConfigJsonOptions": { + "description": "Describes JSON data format.", + "id": "GoogleCloudDataplexV1DataDiscoverySpecStorageConfigJsonOptions", + "properties": { + "encoding": { + "description": "Optional. The character encoding of the data. The default is UTF-8.", + "type": "string" + }, + "typeInferenceDisabled": { + "description": "Optional. Whether to disable the inference of data types for JSON data. If true, all columns are registered as their primitive types (strings, number, or boolean).", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDataplexV1DataProfileResult": { "description": "DataProfileResult defines the output of DataProfileScan. Each field of the table will have field type specific profile result.", "id": "GoogleCloudDataplexV1DataProfileResult", @@ -8064,6 +8427,15 @@ "$ref": "GoogleCloudDataplexV1DataSource", "description": "Required. The data source for DataScan." }, + "dataDiscoveryResult": { + "$ref": "GoogleCloudDataplexV1DataDiscoveryResult", + "description": "Output only. The result of a data discovery scan.", + "readOnly": true + }, + "dataDiscoverySpec": { + "$ref": "GoogleCloudDataplexV1DataDiscoverySpec", + "description": "Settings for a data discovery scan." + }, "dataProfileResult": { "$ref": "GoogleCloudDataplexV1DataProfileResult", "description": "Output only. The result of a data profile scan.", @@ -8135,12 +8507,14 @@ "enum": [ "DATA_SCAN_TYPE_UNSPECIFIED", "DATA_QUALITY", - "DATA_PROFILE" + "DATA_PROFILE", + "DATA_DISCOVERY" ], "enumDescriptions": [ "The data scan type is unspecified.", "Data quality scan.", - "Data profile scan." + "Data profile scan.", + "Data discovery scan." ], "readOnly": true, "type": "string" @@ -8456,6 +8830,16 @@ "readOnly": true, "type": "string" }, + "dataDiscoveryResult": { + "$ref": "GoogleCloudDataplexV1DataDiscoveryResult", + "description": "Output only. The result of a data discovery scan.", + "readOnly": true + }, + "dataDiscoverySpec": { + "$ref": "GoogleCloudDataplexV1DataDiscoverySpec", + "description": "Output only. Settings for a data discovery scan.", + "readOnly": true + }, "dataProfileResult": { "$ref": "GoogleCloudDataplexV1DataProfileResult", "description": "Output only. The result of a data profile scan.", @@ -8526,12 +8910,14 @@ "enum": [ "DATA_SCAN_TYPE_UNSPECIFIED", "DATA_QUALITY", - "DATA_PROFILE" + "DATA_PROFILE", + "DATA_DISCOVERY" ], "enumDescriptions": [ "The data scan type is unspecified.", "Data quality scan.", - "Data profile scan." + "Data profile scan.", + "Data discovery scan." ], "readOnly": true, "type": "string" diff --git a/DiscoveryJson/datastore.v1.json b/DiscoveryJson/datastore.v1.json index c90156478ef..870a2fbc4cc 100644 --- a/DiscoveryJson/datastore.v1.json +++ b/DiscoveryJson/datastore.v1.json @@ -654,7 +654,7 @@ } } }, - "revision": "20241008", + "revision": "20241018", "rootUrl": "https://datastore.googleapis.com/", "schemas": { "Aggregation": { @@ -1064,6 +1064,51 @@ }, "type": "object" }, + "FindNearest": { + "description": "Nearest Neighbors search config. The ordering provided by FindNearest supersedes the order_by stage. If multiple documents have the same vector distance, the returned document order is not guaranteed to be stable between queries.", + "id": "FindNearest", + "properties": { + "distanceMeasure": { + "description": "Required. The Distance Measure to use, required.", + "enum": [ + "DISTANCE_MEASURE_UNSPECIFIED", + "EUCLIDEAN", + "COSINE", + "DOT_PRODUCT" + ], + "enumDescriptions": [ + "Should not be set.", + "Measures the EUCLIDEAN distance between the vectors. See [Euclidean](https://en.wikipedia.org/wiki/Euclidean_distance) to learn more. The resulting distance decreases the more similar two vectors are.", + "COSINE distance compares vectors based on the angle between them, which allows you to measure similarity that isn't based on the vectors magnitude. We recommend using DOT_PRODUCT with unit normalized vectors instead of COSINE distance, which is mathematically equivalent with better performance. See [Cosine Similarity](https://en.wikipedia.org/wiki/Cosine_similarity) to learn more about COSINE similarity and COSINE distance. The resulting COSINE distance decreases the more similar two vectors are.", + "Similar to cosine but is affected by the magnitude of the vectors. See [Dot Product](https://en.wikipedia.org/wiki/Dot_product) to learn more. The resulting distance increases the more similar two vectors are." + ], + "type": "string" + }, + "distanceResultProperty": { + "description": "Optional. Optional name of the field to output the result of the vector distance calculation. Must conform to entity property limitations.", + "type": "string" + }, + "distanceThreshold": { + "description": "Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT distances increase when the vectors are more similar, the comparison is inverted. * For EUCLIDEAN, COSINE: WHERE distance <= distance_threshold * For DOT_PRODUCT: WHERE distance >= distance_threshold", + "format": "double", + "type": "number" + }, + "limit": { + "description": "Required. The number of nearest neighbors to return. Must be a positive integer of no more than 100.", + "format": "int32", + "type": "integer" + }, + "queryVector": { + "$ref": "Value", + "description": "Required. The query vector that we are searching on. Must be a vector of no more than 2048 dimensions." + }, + "vectorProperty": { + "$ref": "PropertyReference", + "description": "Required. An indexed vector property to search upon. Only documents which contain vectors whose dimensionality match the query_vector can be returned." + } + }, + "type": "object" + }, "GoogleDatastoreAdminV1CommonMetadata": { "description": "Metadata common to all Datastore Admin operations.", "id": "GoogleDatastoreAdminV1CommonMetadata", @@ -2228,7 +2273,7 @@ "type": "object" }, "Query": { - "description": "A query for entities.", + "description": "A query for entities. The query stages are executed in the following order: 1. kind 2. filter 3. projection 4. order + start_cursor + end_cursor 5. offset 6. limit 7. find_nearest", "id": "Query", "properties": { "distinctOn": { @@ -2247,6 +2292,10 @@ "$ref": "Filter", "description": "The filter to apply." }, + "findNearest": { + "$ref": "FindNearest", + "description": "Optional. A potential Nearest Neighbors Search. Applies after all other filters and ordering. Finds the closest vector embeddings to the given query vector." + }, "kind": { "description": "The kinds to query (if empty, returns entities of all kinds). Currently at most 1 kind may be specified.", "items": { diff --git a/DiscoveryJson/datastore.v1beta3.json b/DiscoveryJson/datastore.v1beta3.json index 3ca50524a54..0f691f48eb4 100644 --- a/DiscoveryJson/datastore.v1beta3.json +++ b/DiscoveryJson/datastore.v1beta3.json @@ -336,7 +336,7 @@ } } }, - "revision": "20241008", + "revision": "20241018", "rootUrl": "https://datastore.googleapis.com/", "schemas": { "Aggregation": { @@ -724,6 +724,51 @@ }, "type": "object" }, + "FindNearest": { + "description": "Nearest Neighbors search config. The ordering provided by FindNearest supersedes the order_by stage. If multiple documents have the same vector distance, the returned document order is not guaranteed to be stable between queries.", + "id": "FindNearest", + "properties": { + "distanceMeasure": { + "description": "Required. The Distance Measure to use, required.", + "enum": [ + "DISTANCE_MEASURE_UNSPECIFIED", + "EUCLIDEAN", + "COSINE", + "DOT_PRODUCT" + ], + "enumDescriptions": [ + "Should not be set.", + "Measures the EUCLIDEAN distance between the vectors. See [Euclidean](https://en.wikipedia.org/wiki/Euclidean_distance) to learn more. The resulting distance decreases the more similar two vectors are.", + "COSINE distance compares vectors based on the angle between them, which allows you to measure similarity that isn't based on the vectors magnitude. We recommend using DOT_PRODUCT with unit normalized vectors instead of COSINE distance, which is mathematically equivalent with better performance. See [Cosine Similarity](https://en.wikipedia.org/wiki/Cosine_similarity) to learn more about COSINE similarity and COSINE distance. The resulting COSINE distance decreases the more similar two vectors are.", + "Similar to cosine but is affected by the magnitude of the vectors. See [Dot Product](https://en.wikipedia.org/wiki/Dot_product) to learn more. The resulting distance increases the more similar two vectors are." + ], + "type": "string" + }, + "distanceResultProperty": { + "description": "Optional. Optional name of the field to output the result of the vector distance calculation. Must conform to entity property limitations.", + "type": "string" + }, + "distanceThreshold": { + "description": "Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT distances increase when the vectors are more similar, the comparison is inverted. * For EUCLIDEAN, COSINE: WHERE distance <= distance_threshold * For DOT_PRODUCT: WHERE distance >= distance_threshold", + "format": "double", + "type": "number" + }, + "limit": { + "description": "Required. The number of nearest neighbors to return. Must be a positive integer of no more than 100.", + "format": "int32", + "type": "integer" + }, + "queryVector": { + "$ref": "Value", + "description": "Required. The query vector that we are searching on. Must be a vector of no more than 2048 dimensions." + }, + "vectorProperty": { + "$ref": "PropertyReference", + "description": "Required. An indexed vector property to search upon. Only documents which contain vectors whose dimensionality match the query_vector can be returned." + } + }, + "type": "object" + }, "GoogleDatastoreAdminV1CommonMetadata": { "description": "Metadata common to all Datastore Admin operations.", "id": "GoogleDatastoreAdminV1CommonMetadata", @@ -1674,7 +1719,7 @@ "type": "object" }, "Query": { - "description": "A query for entities.", + "description": "A query for entities. The query stages are executed in the following order: 1. kind 2. filter 3. projection 4. order + start_cursor + end_cursor 5. offset 6. limit 7. find_nearest", "id": "Query", "properties": { "distinctOn": { @@ -1693,6 +1738,10 @@ "$ref": "Filter", "description": "The filter to apply." }, + "findNearest": { + "$ref": "FindNearest", + "description": "Optional. A potential Nearest Neighbors Search. Applies after all other filters and ordering. Finds the closest vector embeddings to the given query vector." + }, "kind": { "description": "The kinds to query (if empty, returns entities of all kinds). Currently at most 1 kind may be specified.", "items": { diff --git a/DiscoveryJson/discoveryengine.v1.json b/DiscoveryJson/discoveryengine.v1.json index de36a0da9fb..7f2268ae15f 100644 --- a/DiscoveryJson/discoveryengine.v1.json +++ b/DiscoveryJson/discoveryengine.v1.json @@ -1752,6 +1752,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.dataStores.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1SearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1SearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -3283,6 +3311,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1SearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1SearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -4961,6 +5017,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.dataStores.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1SearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1SearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -6006,9 +6090,177 @@ } } }, - "revision": "20241020", + "revision": "20241025", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { + "GoogleApiDistribution": { + "description": "`Distribution` contains summary statistics for a population of values. It optionally contains a histogram representing the distribution of those values across a set of buckets. The summary statistics are the count, mean, sum of the squared deviation from the mean, the minimum, and the maximum of the set of population of values. The histogram is based on a sequence of buckets and gives a count of values that fall into each bucket. The boundaries of the buckets are given either explicitly or by formulas for buckets of fixed or exponentially increasing widths. Although it is not forbidden, it is generally a bad idea to include non-finite values (infinities or NaNs) in the population of values, as this will render the `mean` and `sum_of_squared_deviation` fields meaningless.", + "id": "GoogleApiDistribution", + "properties": { + "bucketCounts": { + "description": "The number of values in each bucket of the histogram, as described in `bucket_options`. If the distribution does not have a histogram, then omit this field. If there is a histogram, then the sum of the values in `bucket_counts` must equal the value in the `count` field of the distribution. If present, `bucket_counts` should contain N values, where N is the number of buckets specified in `bucket_options`. If you supply fewer than N values, the remaining values are assumed to be 0. The order of the values in `bucket_counts` follows the bucket numbering schemes described for the three bucket types. The first value must be the count for the underflow bucket (number 0). The next N-2 values are the counts for the finite buckets (number 1 through N-2). The N'th value in `bucket_counts` is the count for the overflow bucket (number N-1).", + "items": { + "format": "int64", + "type": "string" + }, + "type": "array" + }, + "bucketOptions": { + "$ref": "GoogleApiDistributionBucketOptions", + "description": "Defines the histogram bucket boundaries. If the distribution does not contain a histogram, then omit this field." + }, + "count": { + "description": "The number of values in the population. Must be non-negative. This value must equal the sum of the values in `bucket_counts` if a histogram is provided.", + "format": "int64", + "type": "string" + }, + "exemplars": { + "description": "Must be in increasing order of `value` field.", + "items": { + "$ref": "GoogleApiDistributionExemplar" + }, + "type": "array" + }, + "mean": { + "description": "The arithmetic mean of the values in the population. If `count` is zero then this field must be zero.", + "format": "double", + "type": "number" + }, + "range": { + "$ref": "GoogleApiDistributionRange", + "description": "If specified, contains the range of the population values. The field must not be present if the `count` is zero." + }, + "sumOfSquaredDeviation": { + "description": "The sum of squared deviations from the mean of the values in the population. For values x_i this is: Sum[i=1..n]((x_i - mean)^2) Knuth, \"The Art of Computer Programming\", Vol. 2, page 232, 3rd edition describes Welford's method for accumulating this sum in one pass. If `count` is zero then this field must be zero.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleApiDistributionBucketOptions": { + "description": "`BucketOptions` describes the bucket boundaries used to create a histogram for the distribution. The buckets can be in a linear sequence, an exponential sequence, or each bucket can be specified explicitly. `BucketOptions` does not include the number of values in each bucket. A bucket has an inclusive lower bound and exclusive upper bound for the values that are counted for that bucket. The upper bound of a bucket must be strictly greater than the lower bound. The sequence of N buckets for a distribution consists of an underflow bucket (number 0), zero or more finite buckets (number 1 through N - 2) and an overflow bucket (number N - 1). The buckets are contiguous: the lower bound of bucket i (i > 0) is the same as the upper bound of bucket i - 1. The buckets span the whole range of finite values: lower bound of the underflow bucket is -infinity and the upper bound of the overflow bucket is +infinity. The finite buckets are so-called because both bounds are finite.", + "id": "GoogleApiDistributionBucketOptions", + "properties": { + "explicitBuckets": { + "$ref": "GoogleApiDistributionBucketOptionsExplicit", + "description": "The explicit buckets." + }, + "exponentialBuckets": { + "$ref": "GoogleApiDistributionBucketOptionsExponential", + "description": "The exponential buckets." + }, + "linearBuckets": { + "$ref": "GoogleApiDistributionBucketOptionsLinear", + "description": "The linear bucket." + } + }, + "type": "object" + }, + "GoogleApiDistributionBucketOptionsExplicit": { + "description": "Specifies a set of buckets with arbitrary widths. There are `size(bounds) + 1` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 <= i < N-1): bounds[i] Lower bound (1 <= i < N); bounds[i - 1] The `bounds` field must contain at least one element. If `bounds` has only one element, then there are no finite buckets, and that single element is the common boundary of the overflow and underflow buckets.", + "id": "GoogleApiDistributionBucketOptionsExplicit", + "properties": { + "bounds": { + "description": "The values must be monotonically increasing.", + "items": { + "format": "double", + "type": "number" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleApiDistributionBucketOptionsExponential": { + "description": "Specifies an exponential sequence of buckets that have a width that is proportional to the value of the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket. There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 <= i < N-1): scale * (growth_factor ^ i). Lower bound (1 <= i < N): scale * (growth_factor ^ (i - 1)).", + "id": "GoogleApiDistributionBucketOptionsExponential", + "properties": { + "growthFactor": { + "description": "Must be greater than 1.", + "format": "double", + "type": "number" + }, + "numFiniteBuckets": { + "description": "Must be greater than 0.", + "format": "int32", + "type": "integer" + }, + "scale": { + "description": "Must be greater than 0.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleApiDistributionBucketOptionsLinear": { + "description": "Specifies a linear sequence of buckets that all have the same width (except overflow and underflow). Each bucket represents a constant absolute uncertainty on the specific value in the bucket. There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 <= i < N-1): offset + (width * i). Lower bound (1 <= i < N): offset + (width * (i - 1)).", + "id": "GoogleApiDistributionBucketOptionsLinear", + "properties": { + "numFiniteBuckets": { + "description": "Must be greater than 0.", + "format": "int32", + "type": "integer" + }, + "offset": { + "description": "Lower bound of the first bucket.", + "format": "double", + "type": "number" + }, + "width": { + "description": "Must be greater than 0.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleApiDistributionExemplar": { + "description": "Exemplars are example points that may be used to annotate aggregated distribution values. They are metadata that gives information about a particular value added to a Distribution bucket, such as a trace ID that was active when a value was added. They may contain further information, such as a example values and timestamps, origin, etc.", + "id": "GoogleApiDistributionExemplar", + "properties": { + "attachments": { + "description": "Contextual information about the example value. Examples are: Trace: type.googleapis.com/google.monitoring.v3.SpanContext Literal string: type.googleapis.com/google.protobuf.StringValue Labels dropped during aggregation: type.googleapis.com/google.monitoring.v3.DroppedLabels There may be only a single attachment of any given message type in a single exemplar, and this is enforced by the system.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "type": "object" + }, + "type": "array" + }, + "timestamp": { + "description": "The observation (sampling) time of the above value.", + "format": "google-datetime", + "type": "string" + }, + "value": { + "description": "Value of the exemplar point. This value determines to which bucket the exemplar belongs.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleApiDistributionRange": { + "description": "The range of the population values.", + "id": "GoogleApiDistributionRange", + "properties": { + "max": { + "description": "The maximum of the population values.", + "format": "double", + "type": "number" + }, + "min": { + "description": "The minimum of the population values.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, "GoogleApiHttpBody": { "description": "Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.", "id": "GoogleApiHttpBody", @@ -6036,6 +6288,64 @@ }, "type": "object" }, + "GoogleApiMetric": { + "description": "A specific metric, identified by specifying values for all of the labels of a `MetricDescriptor`.", + "id": "GoogleApiMetric", + "properties": { + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "The set of label values that uniquely identify this metric. All labels listed in the `MetricDescriptor` must be assigned values.", + "type": "object" + }, + "type": { + "description": "An existing metric type, see google.api.MetricDescriptor. For example, `custom.googleapis.com/invoice/paid/amount`.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleApiMonitoredResource": { + "description": "An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The `type` field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the `labels` field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for `\"gce_instance\"` has labels `\"project_id\"`, `\"instance_id\"` and `\"zone\"`: { \"type\": \"gce_instance\", \"labels\": { \"project_id\": \"my-project\", \"instance_id\": \"12345678901234\", \"zone\": \"us-central1-a\" }}", + "id": "GoogleApiMonitoredResource", + "properties": { + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Compute Engine VM instances use the labels `\"project_id\"`, `\"instance_id\"`, and `\"zone\"`.", + "type": "object" + }, + "type": { + "description": "Required. The monitored resource type. This field must match the `type` field of a MonitoredResourceDescriptor object. For example, the type of a Compute Engine VM instance is `gce_instance`. Some descriptors include the service name in the type; for example, the type of a Datastream stream is `datastream.googleapis.com/Stream`.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleApiMonitoredResourceMetadata": { + "description": "Auxiliary metadata for a MonitoredResource object. MonitoredResource objects contain the minimum set of information to uniquely identify a monitored resource instance. There is some other useful auxiliary metadata. Monitoring and Logging use an ingestion pipeline to extract metadata for cloud resources of all types, and store the metadata in this message.", + "id": "GoogleApiMonitoredResourceMetadata", + "properties": { + "systemLabels": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Output only. Values for predefined system metadata labels. System labels are a kind of metadata extracted by Google, including \"machine_image\", \"vpc\", \"subnet_id\", \"security_group\", \"name\", etc. System label values can be only strings, Boolean values, or a list of strings. For example: { \"name\": \"my-test-instance\", \"security_group\": [\"a\", \"b\", \"c\"], \"spot_instance\": false }", + "type": "object" + }, + "userLabels": { + "additionalProperties": { + "type": "string" + }, + "description": "Output only. A map of user-defined metadata labels.", + "type": "object" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineLoggingErrorContext": { "description": "A description of the context in which an error occurred.", "id": "GoogleCloudDiscoveryengineLoggingErrorContext", @@ -6346,6 +6656,10 @@ "description": "Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.", "type": "boolean" }, + "groundingSpec": { + "$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec", + "description": "Optional. Grounding specification." + }, "query": { "$ref": "GoogleCloudDiscoveryengineV1Query", "description": "Required. Current user query." @@ -6445,6 +6759,17 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec": { + "description": "Grounding specification.", + "id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec", + "properties": { + "includeGroundingSupports": { + "description": "Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports for each claim.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpec": { "description": "Query understanding specification.", "id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpec", @@ -11729,7 +12054,7 @@ "type": "string" }, "eventType": { - "description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.", + "description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans * `add-feedback`: Add a user feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.", "type": "string" }, "filter": { @@ -12639,6 +12964,17 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries": { + "description": "The historical crawl rate timeseries data, used for monitoring.", + "id": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "properties": { + "qpsTimeSeries": { + "$ref": "GoogleMonitoringV3TimeSeries", + "description": "The QPS of the crawl rate." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.CreateDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata", @@ -12971,6 +13307,21 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries": { + "description": "The historical dedicated crawl rate timeseries data, used for monitoring. Dedicated crawl is used by Vertex AI to crawl the user's website when dedicate crawl is set.", + "id": "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries", + "properties": { + "autoRefreshCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's dedicated crawl rate time series of auto-refresh, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is set, and the crawl rate is for best effort use cases like refreshing urls periodically." + }, + "userTriggeredCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's dedicated crawl rate time series of user triggered crawl, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is set, and user triggered crawl rate is for deterministic use cases like crawling urls or sitemaps specified by users." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata", @@ -14161,6 +14512,55 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse": { + "description": "Response message for CrawlRateManagementService.ObtainCrawlRate method. The response contains organcic or dedicated crawl rate time series data for monitoring, depending on whether dedicated crawl rate is set.", + "id": "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse", + "properties": { + "dedicatedCrawlRateTimeSeries": { + "$ref": "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries", + "description": "The historical dedicated crawl rate timeseries data, used for monitoring." + }, + "error": { + "$ref": "GoogleRpcStatus", + "description": "Errors from service when handling the request." + }, + "organicCrawlRateTimeSeries": { + "$ref": "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries", + "description": "The historical organic crawl rate timeseries data, used for monitoring." + }, + "state": { + "description": "Output only. The state of the response.", + "enum": [ + "STATE_UNSPECIFIED", + "SUCCEEDED", + "FAILED" + ], + "enumDescriptions": [ + "The state is unspecified.", + "The state is successful.", + "The state is failed." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries": { + "description": "The historical organic crawl rate timeseries data, used for monitoring. Organic crawl is auto-determined by Google to crawl the user's website when dedicate crawl is not set. Crawl rate is the QPS of crawl request Google sends to the user's website.", + "id": "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries", + "properties": { + "googleOrganicCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Google's organic crawl rate time series, which is the sum of all googlebots' crawl rate. Please refer to https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers for more details about googlebots." + }, + "vertexAiOrganicCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's organic crawl rate time series, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is not set. Please refer to https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot for more details about Google-CloudVertexBot." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaProject": { "description": "Metadata and configurations for a Google Cloud project in the service.", "id": "GoogleCloudDiscoveryengineV1alphaProject", @@ -18445,6 +18845,139 @@ }, "type": "object" }, + "GoogleMonitoringV3Point": { + "description": "A single data point in a time series.", + "id": "GoogleMonitoringV3Point", + "properties": { + "interval": { + "$ref": "GoogleMonitoringV3TimeInterval", + "description": "The time interval to which the data point applies. For `GAUGE` metrics, the start time is optional, but if it is supplied, it must equal the end time. For `DELTA` metrics, the start and end time should specify a non-zero interval, with subsequent points specifying contiguous and non-overlapping intervals. For `CUMULATIVE` metrics, the start and end time should specify a non-zero interval, with subsequent points specifying the same start time and increasing end times, until an event resets the cumulative value to zero and sets a new start time for the following points." + }, + "value": { + "$ref": "GoogleMonitoringV3TypedValue", + "description": "The value of the data point." + } + }, + "type": "object" + }, + "GoogleMonitoringV3TimeInterval": { + "description": "A time interval extending just after a start time through an end time. If the start time is the same as the end time, then the interval represents a single point in time.", + "id": "GoogleMonitoringV3TimeInterval", + "properties": { + "endTime": { + "description": "Required. The end of the time interval.", + "format": "google-datetime", + "type": "string" + }, + "startTime": { + "description": "Optional. The beginning of the time interval. The default value for the start time is the end time. The start time must not be later than the end time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleMonitoringV3TimeSeries": { + "description": "A collection of data points that describes the time-varying values of a metric. A time series is identified by a combination of a fully-specified monitored resource and a fully-specified metric. This type is used for both listing and creating time series.", + "id": "GoogleMonitoringV3TimeSeries", + "properties": { + "description": { + "description": "Input only. A detailed description of the time series that will be associated with the google.api.MetricDescriptor for the metric. Once set, this field cannot be changed through CreateTimeSeries.", + "type": "string" + }, + "metadata": { + "$ref": "GoogleApiMonitoredResourceMetadata", + "description": "Output only. The associated monitored resource metadata. When reading a time series, this field will include metadata labels that are explicitly named in the reduction. When creating a time series, this field is ignored." + }, + "metric": { + "$ref": "GoogleApiMetric", + "description": "The associated metric. A fully-specified metric used to identify the time series." + }, + "metricKind": { + "description": "The metric kind of the time series. When listing time series, this metric kind might be different from the metric kind of the associated metric if this time series is an alignment or reduction of other time series. When creating a time series, this field is optional. If present, it must be the same as the metric kind of the associated metric. If the associated metric's descriptor must be auto-created, then this field specifies the metric kind of the new descriptor and must be either `GAUGE` (the default) or `CUMULATIVE`.", + "enum": [ + "METRIC_KIND_UNSPECIFIED", + "GAUGE", + "DELTA", + "CUMULATIVE" + ], + "enumDescriptions": [ + "Do not use this default value.", + "An instantaneous measurement of a value.", + "The change in a value during a time interval.", + "A value accumulated over a time interval. Cumulative measurements in a time series should have the same start time and increasing end times, until an event resets the cumulative value to zero and sets a new start time for the following points." + ], + "type": "string" + }, + "points": { + "description": "The data points of this time series. When listing time series, points are returned in reverse time order. When creating a time series, this field must contain exactly one point and the point's type must be the same as the value type of the associated metric. If the associated metric's descriptor must be auto-created, then the value type of the descriptor is determined by the point's type, which must be `BOOL`, `INT64`, `DOUBLE`, or `DISTRIBUTION`.", + "items": { + "$ref": "GoogleMonitoringV3Point" + }, + "type": "array" + }, + "resource": { + "$ref": "GoogleApiMonitoredResource", + "description": "The associated monitored resource. Custom metrics can use only certain monitored resource types in their time series data. For more information, see [Monitored resources for custom metrics](https://cloud.google.com/monitoring/custom-metrics/creating-metrics#custom-metric-resources)." + }, + "unit": { + "description": "The units in which the metric value is reported. It is only applicable if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit` defines the representation of the stored metric values. This field can only be changed through CreateTimeSeries when it is empty.", + "type": "string" + }, + "valueType": { + "description": "The value type of the time series. When listing time series, this value type might be different from the value type of the associated metric if this time series is an alignment or reduction of other time series. When creating a time series, this field is optional. If present, it must be the same as the type of the data in the `points` field.", + "enum": [ + "VALUE_TYPE_UNSPECIFIED", + "BOOL", + "INT64", + "DOUBLE", + "STRING", + "DISTRIBUTION", + "MONEY" + ], + "enumDescriptions": [ + "Do not use this default value.", + "The value is a boolean. This value type can be used only if the metric kind is `GAUGE`.", + "The value is a signed 64-bit integer.", + "The value is a double precision floating point number.", + "The value is a text string. This value type can be used only if the metric kind is `GAUGE`.", + "The value is a `Distribution`.", + "The value is money." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleMonitoringV3TypedValue": { + "description": "A single strongly-typed value.", + "id": "GoogleMonitoringV3TypedValue", + "properties": { + "boolValue": { + "description": "A Boolean value: `true` or `false`.", + "type": "boolean" + }, + "distributionValue": { + "$ref": "GoogleApiDistribution", + "description": "A distribution value." + }, + "doubleValue": { + "description": "A 64-bit double-precision floating-point number. Its magnitude is approximately \u00b110\u00b1300 and it has 16 significant digits of precision.", + "format": "double", + "type": "number" + }, + "int64Value": { + "description": "A 64-bit integer. Its range is approximately \u00b19.2x1018.", + "format": "int64", + "type": "string" + }, + "stringValue": { + "description": "A variable-length string value.", + "type": "string" + } + }, + "type": "object" + }, "GoogleProtobufEmpty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "GoogleProtobufEmpty", diff --git a/DiscoveryJson/discoveryengine.v1alpha.json b/DiscoveryJson/discoveryengine.v1alpha.json index ffc273bafb2..70141b91354 100644 --- a/DiscoveryJson/discoveryengine.v1alpha.json +++ b/DiscoveryJson/discoveryengine.v1alpha.json @@ -1316,6 +1316,38 @@ } } }, + "completionConfig": { + "methods": { + "completeQuery": { + "description": "Completes the user input with advanced keyword suggestions.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/completionConfig:completeQuery", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.dataStores.completionConfig.completeQuery", + "parameterOrder": [ + "completionConfig" + ], + "parameters": { + "completionConfig": { + "description": "Required. The completion_config of the parent dataStore or engine resource name for which the completion is performed, such as `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/completionConfig$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+completionConfig}:completeQuery", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "completionSuggestions": { "methods": { "import": { @@ -2309,6 +2341,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.dataStores.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -3470,6 +3530,38 @@ } }, "resources": { + "completionConfig": { + "methods": { + "completeQuery": { + "description": "Completes the user input with advanced keyword suggestions.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/completionConfig:completeQuery", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.completionConfig.completeQuery", + "parameterOrder": [ + "completionConfig" + ], + "parameters": { + "completionConfig": { + "description": "Required. The completion_config of the parent dataStore or engine resource name for which the completion is performed, such as `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/completionConfig$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+completionConfig}:completeQuery", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "controls": { "methods": { "create": { @@ -4072,6 +4164,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -5134,6 +5254,38 @@ } } }, + "completionConfig": { + "methods": { + "completeQuery": { + "description": "Completes the user input with advanced keyword suggestions.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/completionConfig:completeQuery", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.dataStores.completionConfig.completeQuery", + "parameterOrder": [ + "completionConfig" + ], + "parameters": { + "completionConfig": { + "description": "Required. The completion_config of the parent dataStore or engine resource name for which the completion is performed, such as `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/completionConfig$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+completionConfig}:completeQuery", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "completionSuggestions": { "methods": { "import": { @@ -6026,6 +6178,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.dataStores.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -7682,7 +7862,7 @@ } } }, - "revision": "20241020", + "revision": "20241025", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -7880,6 +8060,24 @@ }, "type": "object" }, + "GoogleApiMetric": { + "description": "A specific metric, identified by specifying values for all of the labels of a `MetricDescriptor`.", + "id": "GoogleApiMetric", + "properties": { + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "The set of label values that uniquely identify this metric. All labels listed in the `MetricDescriptor` must be assigned values.", + "type": "object" + }, + "type": { + "description": "An existing metric type, see google.api.MetricDescriptor. For example, `custom.googleapis.com/invoice/paid/amount`.", + "type": "string" + } + }, + "type": "object" + }, "GoogleApiMonitoredResource": { "description": "An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The `type` field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the `labels` field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for `\"gce_instance\"` has labels `\"project_id\"`, `\"instance_id\"` and `\"zone\"`: { \"type\": \"gce_instance\", \"labels\": { \"project_id\": \"my-project\", \"instance_id\": \"12345678901234\", \"zone\": \"us-central1-a\" }}", "id": "GoogleApiMonitoredResource", @@ -7898,6 +8096,28 @@ }, "type": "object" }, + "GoogleApiMonitoredResourceMetadata": { + "description": "Auxiliary metadata for a MonitoredResource object. MonitoredResource objects contain the minimum set of information to uniquely identify a monitored resource instance. There is some other useful auxiliary metadata. Monitoring and Logging use an ingestion pipeline to extract metadata for cloud resources of all types, and store the metadata in this message.", + "id": "GoogleApiMonitoredResourceMetadata", + "properties": { + "systemLabels": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Output only. Values for predefined system metadata labels. System labels are a kind of metadata extracted by Google, including \"machine_image\", \"vpc\", \"subnet_id\", \"security_group\", \"name\", etc. System label values can be only strings, Boolean values, or a list of strings. For example: { \"name\": \"my-test-instance\", \"security_group\": [\"a\", \"b\", \"c\"], \"spot_instance\": false }", + "type": "object" + }, + "userLabels": { + "additionalProperties": { + "type": "string" + }, + "description": "Output only. A map of user-defined metadata labels.", + "type": "object" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineLoggingErrorContext": { "description": "A description of the context in which an error occurred.", "id": "GoogleCloudDiscoveryengineLoggingErrorContext", @@ -9654,6 +9874,236 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest": { + "description": "Request message for CompletionService.AdvancedCompleteQuery method. .", + "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest", + "properties": { + "boostSpec": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpec", + "description": "Optional. Specification to boost suggestions matching the condition." + }, + "includeTailSuggestions": { + "description": "Indicates if tail suggestions should be returned if there are no suggestions that match the full query. Even if set to true, if there are suggestions that match the full query, those are returned and no tail suggestions are returned.", + "type": "boolean" + }, + "query": { + "description": "Required. The typeahead input used to fetch suggestions. Maximum length is 128 characters. The query can not be empty for most of the suggestion types. If it is empty, an `INVALID_ARGUMENT` error is returned. The exception is when the suggestion_types contains only the type `RECENT_SEARCH`, the query can be an empty string. The is called \"zero prefix\" feature, which returns user's recently searched queries given the empty query.", + "type": "string" + }, + "queryModel": { + "description": "Specifies the autocomplete data model. This overrides any model specified in the Configuration > Autocomplete section of the Cloud console. Currently supported values: * `document` - Using suggestions generated from user-imported documents. * `search-history` - Using suggestions generated from the past history of SearchService.Search API calls. Do not use it when there is no traffic for Search API. * `user-event` - Using suggestions generated from user-imported search events. * `document-completable` - Using suggestions taken directly from user-imported document fields marked as completable. Default values: * `document` is the default model for regular dataStores. * `search-history` is the default model for site search dataStores.", + "type": "string" + }, + "suggestionTypes": { + "description": "Optional. Suggestion types to return. If empty or unspecified, query suggestions are returned. Only one suggestion type is supported at the moment.", + "items": { + "enum": [ + "SUGGESTION_TYPE_UNSPECIFIED", + "QUERY", + "PEOPLE", + "CONTENT", + "RECENT_SEARCH", + "GOOGLE_WORKSPACE" + ], + "enumDescriptions": [ + "Default value.", + "Returns query suggestions.", + "Returns people suggestions.", + "Returns content suggestions.", + "Returns recent search suggestions.", + "Returns Google Workspace suggestions." + ], + "type": "string" + }, + "type": "array" + }, + "userInfo": { + "$ref": "GoogleCloudDiscoveryengineV1alphaUserInfo", + "description": "Optional. Information about the end user. This should be the same identifier information as UserEvent.user_info and SearchRequest.user_info." + }, + "userPseudoId": { + "description": "A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. This field should NOT have a fixed value such as `unknown_visitor`. This should be the same identifier as UserEvent.user_pseudo_id and SearchRequest.user_pseudo_id. The field must be a UTF-8 encoded string with a length limit of 128", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpec": { + "description": "Specification to boost suggestions based on the condtion of the suggestion.", + "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpec", + "properties": { + "conditionBoostSpecs": { + "description": "Condition boost specifications. If a suggestion matches multiple conditions in the specifictions, boost values from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20. Note: Currently only support language condition boost.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec": { + "description": "Boost applies to suggestions which match a condition.", + "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec", + "properties": { + "boost": { + "description": "Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the suggestions a big promotion. However, it does not necessarily mean that the top result will be a boosted suggestion. Setting to -1.0 gives the suggestions a big demotion. However, other suggestions that are relevant might still be shown. Setting to 0.0 means no boost applied. The boosting condition is ignored.", + "format": "float", + "type": "number" + }, + "condition": { + "description": "An expression which specifies a boost condition. The syntax is the same as [filter expression syntax](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax). Currently, the only supported condition is a list of BCP-47 lang codes. Example: * To boost suggestions in languages `en` or `fr`: `(lang_code: ANY(\"en\", \"fr\"))`", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse": { + "description": "Response message for CompletionService.AdvancedCompleteQuery method.", + "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse", + "properties": { + "contentSuggestions": { + "description": "Results of the matched content suggestions. The result list is ordered and the first result is the top suggestion.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseContentSuggestion" + }, + "type": "array" + }, + "peopleSuggestions": { + "description": "Results of the matched people suggestions. The result list is ordered and the first result is the top suggestion.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponsePersonSuggestion" + }, + "type": "array" + }, + "querySuggestions": { + "description": "Results of the matched query suggestions. The result list is ordered and the first result is a top suggestion.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseQuerySuggestion" + }, + "type": "array" + }, + "recentSearchSuggestions": { + "description": "Results of the matched \"recent search\" suggestions. The result list is ordered and the first result is the top suggestion.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseRecentSearchSuggestion" + }, + "type": "array" + }, + "tailMatchTriggered": { + "description": "True if the returned suggestions are all tail suggestions. For tail matching to be triggered, include_tail_suggestions in the request must be true and there must be no suggestions that match the full query.", + "type": "boolean" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseContentSuggestion": { + "description": "Suggestions as content.", + "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseContentSuggestion", + "properties": { + "contentType": { + "description": "The type of the content suggestion.", + "enum": [ + "CONTENT_TYPE_UNSPECIFIED", + "GOOGLE_WORKSPACE", + "THIRD_PARTY" + ], + "enumDescriptions": [ + "Default value.", + "The suggestion is from a Google Workspace source.", + "The suggestion is from a third party source." + ], + "type": "string" + }, + "dataStore": { + "description": "The name of the dataStore that this suggestion belongs to.", + "type": "string" + }, + "document": { + "$ref": "GoogleCloudDiscoveryengineV1alphaDocument", + "description": "The document data snippet in the suggestion. Only a subset of fields will be populated." + }, + "suggestion": { + "description": "The suggestion for the query.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponsePersonSuggestion": { + "description": "Suggestions as people.", + "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponsePersonSuggestion", + "properties": { + "dataStore": { + "description": "The name of the dataStore that this suggestion belongs to.", + "type": "string" + }, + "document": { + "$ref": "GoogleCloudDiscoveryengineV1alphaDocument", + "description": "The document data snippet in the suggestion. Only a subset of fields is populated." + }, + "personType": { + "description": "The type of the person.", + "enum": [ + "PERSON_TYPE_UNSPECIFIED", + "CLOUD_IDENTITY", + "THIRD_PARTY_IDENTITY" + ], + "enumDescriptions": [ + "Default value.", + "The suggestion is from a GOOGLE_IDENTITY source.", + "The suggestion is from a THIRD_PARTY_IDENTITY source." + ], + "type": "string" + }, + "suggestion": { + "description": "The suggestion for the query.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseQuerySuggestion": { + "description": "Suggestions as search queries.", + "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseQuerySuggestion", + "properties": { + "completableFieldPaths": { + "description": "The unique document field paths that serve as the source of this suggestion if it was generated from completable fields. This field is only populated for the document-completable model.", + "items": { + "type": "string" + }, + "type": "array" + }, + "dataStore": { + "description": "The name of the dataStore that this suggestion belongs to.", + "items": { + "type": "string" + }, + "type": "array" + }, + "suggestion": { + "description": "The suggestion for the query.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseRecentSearchSuggestion": { + "description": "Suggestions from recent search history.", + "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseRecentSearchSuggestion", + "properties": { + "recentSearchTime": { + "description": "The time when this recent rearch happened.", + "format": "google-datetime", + "type": "string" + }, + "suggestion": { + "description": "The suggestion for the query.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaAdvancedSiteSearchConfig": { "description": "Configuration data for advance site search.", "id": "GoogleCloudDiscoveryengineV1alphaAdvancedSiteSearchConfig", @@ -9854,6 +10304,10 @@ "description": "Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.", "type": "boolean" }, + "groundingSpec": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestGroundingSpec", + "description": "Optional. Grounding specification." + }, "query": { "$ref": "GoogleCloudDiscoveryengineV1alphaQuery", "description": "Required. Current user query." @@ -9953,6 +10407,31 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestGroundingSpec": { + "description": "Grounding specification.", + "id": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestGroundingSpec", + "properties": { + "filteringLevel": { + "description": "Optional. Specifies whether to enable the filtering based on grounding score and at what level.", + "enum": [ + "FILTERING_LEVEL_UNSPECIFIED", + "FILTERING_LEVEL_LOW", + "FILTERING_LEVEL_HIGH" + ], + "enumDescriptions": [ + "Default is no filter", + "Filter answers based on a low threshold.", + "Filter answers based on a high threshold." + ], + "type": "string" + }, + "includeGroundingSupports": { + "description": "Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports for each claim.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestQueryUnderstandingSpec": { "description": "Query understanding specification.", "id": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestQueryUnderstandingSpec", @@ -11756,6 +12235,17 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries": { + "description": "The historical crawl rate timeseries data, used for monitoring.", + "id": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "properties": { + "qpsTimeSeries": { + "$ref": "GoogleMonitoringV3TimeSeries", + "description": "The QPS of the crawl rate." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.CreateDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata", @@ -12125,6 +12615,21 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries": { + "description": "The historical dedicated crawl rate timeseries data, used for monitoring. Dedicated crawl is used by Vertex AI to crawl the user's website when dedicate crawl is set.", + "id": "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries", + "properties": { + "autoRefreshCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's dedicated crawl rate time series of auto-refresh, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is set, and the crawl rate is for best effort use cases like refreshing urls periodically." + }, + "userTriggeredCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's dedicated crawl rate time series of user triggered crawl, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is set, and user triggered crawl rate is for deterministic use cases like crawling urls or sitemaps specified by users." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata", @@ -14243,6 +14748,55 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse": { + "description": "Response message for CrawlRateManagementService.ObtainCrawlRate method. The response contains organcic or dedicated crawl rate time series data for monitoring, depending on whether dedicated crawl rate is set.", + "id": "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse", + "properties": { + "dedicatedCrawlRateTimeSeries": { + "$ref": "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries", + "description": "The historical dedicated crawl rate timeseries data, used for monitoring." + }, + "error": { + "$ref": "GoogleRpcStatus", + "description": "Errors from service when handling the request." + }, + "organicCrawlRateTimeSeries": { + "$ref": "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries", + "description": "The historical organic crawl rate timeseries data, used for monitoring." + }, + "state": { + "description": "Output only. The state of the response.", + "enum": [ + "STATE_UNSPECIFIED", + "SUCCEEDED", + "FAILED" + ], + "enumDescriptions": [ + "The state is unspecified.", + "The state is successful.", + "The state is failed." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries": { + "description": "The historical organic crawl rate timeseries data, used for monitoring. Organic crawl is auto-determined by Google to crawl the user's website when dedicate crawl is not set. Crawl rate is the QPS of crawl request Google sends to the user's website.", + "id": "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries", + "properties": { + "googleOrganicCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Google's organic crawl rate time series, which is the sum of all googlebots' crawl rate. Please refer to https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers for more details about googlebots." + }, + "vertexAiOrganicCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's organic crawl rate time series, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is not set. Please refer to https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot for more details about Google-CloudVertexBot." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaPageInfo": { "description": "Detailed page information.", "id": "GoogleCloudDiscoveryengineV1alphaPageInfo", @@ -17456,7 +18010,7 @@ "type": "string" }, "eventType": { - "description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.", + "description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans * `add-feedback`: Add a user feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.", "type": "string" }, "filter": { @@ -20294,6 +20848,110 @@ }, "type": "object" }, + "GoogleMonitoringV3Point": { + "description": "A single data point in a time series.", + "id": "GoogleMonitoringV3Point", + "properties": { + "interval": { + "$ref": "GoogleMonitoringV3TimeInterval", + "description": "The time interval to which the data point applies. For `GAUGE` metrics, the start time is optional, but if it is supplied, it must equal the end time. For `DELTA` metrics, the start and end time should specify a non-zero interval, with subsequent points specifying contiguous and non-overlapping intervals. For `CUMULATIVE` metrics, the start and end time should specify a non-zero interval, with subsequent points specifying the same start time and increasing end times, until an event resets the cumulative value to zero and sets a new start time for the following points." + }, + "value": { + "$ref": "GoogleMonitoringV3TypedValue", + "description": "The value of the data point." + } + }, + "type": "object" + }, + "GoogleMonitoringV3TimeInterval": { + "description": "A time interval extending just after a start time through an end time. If the start time is the same as the end time, then the interval represents a single point in time.", + "id": "GoogleMonitoringV3TimeInterval", + "properties": { + "endTime": { + "description": "Required. The end of the time interval.", + "format": "google-datetime", + "type": "string" + }, + "startTime": { + "description": "Optional. The beginning of the time interval. The default value for the start time is the end time. The start time must not be later than the end time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleMonitoringV3TimeSeries": { + "description": "A collection of data points that describes the time-varying values of a metric. A time series is identified by a combination of a fully-specified monitored resource and a fully-specified metric. This type is used for both listing and creating time series.", + "id": "GoogleMonitoringV3TimeSeries", + "properties": { + "description": { + "description": "Input only. A detailed description of the time series that will be associated with the google.api.MetricDescriptor for the metric. Once set, this field cannot be changed through CreateTimeSeries.", + "type": "string" + }, + "metadata": { + "$ref": "GoogleApiMonitoredResourceMetadata", + "description": "Output only. The associated monitored resource metadata. When reading a time series, this field will include metadata labels that are explicitly named in the reduction. When creating a time series, this field is ignored." + }, + "metric": { + "$ref": "GoogleApiMetric", + "description": "The associated metric. A fully-specified metric used to identify the time series." + }, + "metricKind": { + "description": "The metric kind of the time series. When listing time series, this metric kind might be different from the metric kind of the associated metric if this time series is an alignment or reduction of other time series. When creating a time series, this field is optional. If present, it must be the same as the metric kind of the associated metric. If the associated metric's descriptor must be auto-created, then this field specifies the metric kind of the new descriptor and must be either `GAUGE` (the default) or `CUMULATIVE`.", + "enum": [ + "METRIC_KIND_UNSPECIFIED", + "GAUGE", + "DELTA", + "CUMULATIVE" + ], + "enumDescriptions": [ + "Do not use this default value.", + "An instantaneous measurement of a value.", + "The change in a value during a time interval.", + "A value accumulated over a time interval. Cumulative measurements in a time series should have the same start time and increasing end times, until an event resets the cumulative value to zero and sets a new start time for the following points." + ], + "type": "string" + }, + "points": { + "description": "The data points of this time series. When listing time series, points are returned in reverse time order. When creating a time series, this field must contain exactly one point and the point's type must be the same as the value type of the associated metric. If the associated metric's descriptor must be auto-created, then the value type of the descriptor is determined by the point's type, which must be `BOOL`, `INT64`, `DOUBLE`, or `DISTRIBUTION`.", + "items": { + "$ref": "GoogleMonitoringV3Point" + }, + "type": "array" + }, + "resource": { + "$ref": "GoogleApiMonitoredResource", + "description": "The associated monitored resource. Custom metrics can use only certain monitored resource types in their time series data. For more information, see [Monitored resources for custom metrics](https://cloud.google.com/monitoring/custom-metrics/creating-metrics#custom-metric-resources)." + }, + "unit": { + "description": "The units in which the metric value is reported. It is only applicable if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit` defines the representation of the stored metric values. This field can only be changed through CreateTimeSeries when it is empty.", + "type": "string" + }, + "valueType": { + "description": "The value type of the time series. When listing time series, this value type might be different from the value type of the associated metric if this time series is an alignment or reduction of other time series. When creating a time series, this field is optional. If present, it must be the same as the type of the data in the `points` field.", + "enum": [ + "VALUE_TYPE_UNSPECIFIED", + "BOOL", + "INT64", + "DOUBLE", + "STRING", + "DISTRIBUTION", + "MONEY" + ], + "enumDescriptions": [ + "Do not use this default value.", + "The value is a boolean. This value type can be used only if the metric kind is `GAUGE`.", + "The value is a signed 64-bit integer.", + "The value is a double precision floating point number.", + "The value is a text string. This value type can be used only if the metric kind is `GAUGE`.", + "The value is a `Distribution`.", + "The value is money." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleMonitoringV3TypedValue": { "description": "A single strongly-typed value.", "id": "GoogleMonitoringV3TypedValue", diff --git a/DiscoveryJson/discoveryengine.v1beta.json b/DiscoveryJson/discoveryengine.v1beta.json index 59181aec675..b6cbbcc30db 100644 --- a/DiscoveryJson/discoveryengine.v1beta.json +++ b/DiscoveryJson/discoveryengine.v1beta.json @@ -854,6 +854,38 @@ } } }, + "completionConfig": { + "methods": { + "completeQuery": { + "description": "Completes the user input with advanced keyword suggestions.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/completionConfig:completeQuery", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.dataStores.completionConfig.completeQuery", + "parameterOrder": [ + "completionConfig" + ], + "parameters": { + "completionConfig": { + "description": "Required. The completion_config of the parent dataStore or engine resource name for which the completion is performed, such as `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/completionConfig$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+completionConfig}:completeQuery", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "completionSuggestions": { "methods": { "import": { @@ -1847,6 +1879,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.dataStores.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -2955,6 +3015,38 @@ } }, "resources": { + "completionConfig": { + "methods": { + "completeQuery": { + "description": "Completes the user input with advanced keyword suggestions.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/completionConfig:completeQuery", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.completionConfig.completeQuery", + "parameterOrder": [ + "completionConfig" + ], + "parameters": { + "completionConfig": { + "description": "Required. The completion_config of the parent dataStore or engine resource name for which the completion is performed, such as `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/completionConfig$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+completionConfig}:completeQuery", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "controls": { "methods": { "create": { @@ -3557,6 +3649,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -4438,6 +4558,38 @@ } } }, + "completionConfig": { + "methods": { + "completeQuery": { + "description": "Completes the user input with advanced keyword suggestions.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/completionConfig:completeQuery", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.dataStores.completionConfig.completeQuery", + "parameterOrder": [ + "completionConfig" + ], + "parameters": { + "completionConfig": { + "description": "Required. The completion_config of the parent dataStore or engine resource name for which the completion is performed, such as `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/completionConfig$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+completionConfig}:completeQuery", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "completionSuggestions": { "methods": { "import": { @@ -5330,6 +5482,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.dataStores.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -6880,9 +7060,177 @@ } } }, - "revision": "20241020", + "revision": "20241025", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { + "GoogleApiDistribution": { + "description": "`Distribution` contains summary statistics for a population of values. It optionally contains a histogram representing the distribution of those values across a set of buckets. The summary statistics are the count, mean, sum of the squared deviation from the mean, the minimum, and the maximum of the set of population of values. The histogram is based on a sequence of buckets and gives a count of values that fall into each bucket. The boundaries of the buckets are given either explicitly or by formulas for buckets of fixed or exponentially increasing widths. Although it is not forbidden, it is generally a bad idea to include non-finite values (infinities or NaNs) in the population of values, as this will render the `mean` and `sum_of_squared_deviation` fields meaningless.", + "id": "GoogleApiDistribution", + "properties": { + "bucketCounts": { + "description": "The number of values in each bucket of the histogram, as described in `bucket_options`. If the distribution does not have a histogram, then omit this field. If there is a histogram, then the sum of the values in `bucket_counts` must equal the value in the `count` field of the distribution. If present, `bucket_counts` should contain N values, where N is the number of buckets specified in `bucket_options`. If you supply fewer than N values, the remaining values are assumed to be 0. The order of the values in `bucket_counts` follows the bucket numbering schemes described for the three bucket types. The first value must be the count for the underflow bucket (number 0). The next N-2 values are the counts for the finite buckets (number 1 through N-2). The N'th value in `bucket_counts` is the count for the overflow bucket (number N-1).", + "items": { + "format": "int64", + "type": "string" + }, + "type": "array" + }, + "bucketOptions": { + "$ref": "GoogleApiDistributionBucketOptions", + "description": "Defines the histogram bucket boundaries. If the distribution does not contain a histogram, then omit this field." + }, + "count": { + "description": "The number of values in the population. Must be non-negative. This value must equal the sum of the values in `bucket_counts` if a histogram is provided.", + "format": "int64", + "type": "string" + }, + "exemplars": { + "description": "Must be in increasing order of `value` field.", + "items": { + "$ref": "GoogleApiDistributionExemplar" + }, + "type": "array" + }, + "mean": { + "description": "The arithmetic mean of the values in the population. If `count` is zero then this field must be zero.", + "format": "double", + "type": "number" + }, + "range": { + "$ref": "GoogleApiDistributionRange", + "description": "If specified, contains the range of the population values. The field must not be present if the `count` is zero." + }, + "sumOfSquaredDeviation": { + "description": "The sum of squared deviations from the mean of the values in the population. For values x_i this is: Sum[i=1..n]((x_i - mean)^2) Knuth, \"The Art of Computer Programming\", Vol. 2, page 232, 3rd edition describes Welford's method for accumulating this sum in one pass. If `count` is zero then this field must be zero.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleApiDistributionBucketOptions": { + "description": "`BucketOptions` describes the bucket boundaries used to create a histogram for the distribution. The buckets can be in a linear sequence, an exponential sequence, or each bucket can be specified explicitly. `BucketOptions` does not include the number of values in each bucket. A bucket has an inclusive lower bound and exclusive upper bound for the values that are counted for that bucket. The upper bound of a bucket must be strictly greater than the lower bound. The sequence of N buckets for a distribution consists of an underflow bucket (number 0), zero or more finite buckets (number 1 through N - 2) and an overflow bucket (number N - 1). The buckets are contiguous: the lower bound of bucket i (i > 0) is the same as the upper bound of bucket i - 1. The buckets span the whole range of finite values: lower bound of the underflow bucket is -infinity and the upper bound of the overflow bucket is +infinity. The finite buckets are so-called because both bounds are finite.", + "id": "GoogleApiDistributionBucketOptions", + "properties": { + "explicitBuckets": { + "$ref": "GoogleApiDistributionBucketOptionsExplicit", + "description": "The explicit buckets." + }, + "exponentialBuckets": { + "$ref": "GoogleApiDistributionBucketOptionsExponential", + "description": "The exponential buckets." + }, + "linearBuckets": { + "$ref": "GoogleApiDistributionBucketOptionsLinear", + "description": "The linear bucket." + } + }, + "type": "object" + }, + "GoogleApiDistributionBucketOptionsExplicit": { + "description": "Specifies a set of buckets with arbitrary widths. There are `size(bounds) + 1` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 <= i < N-1): bounds[i] Lower bound (1 <= i < N); bounds[i - 1] The `bounds` field must contain at least one element. If `bounds` has only one element, then there are no finite buckets, and that single element is the common boundary of the overflow and underflow buckets.", + "id": "GoogleApiDistributionBucketOptionsExplicit", + "properties": { + "bounds": { + "description": "The values must be monotonically increasing.", + "items": { + "format": "double", + "type": "number" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleApiDistributionBucketOptionsExponential": { + "description": "Specifies an exponential sequence of buckets that have a width that is proportional to the value of the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket. There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 <= i < N-1): scale * (growth_factor ^ i). Lower bound (1 <= i < N): scale * (growth_factor ^ (i - 1)).", + "id": "GoogleApiDistributionBucketOptionsExponential", + "properties": { + "growthFactor": { + "description": "Must be greater than 1.", + "format": "double", + "type": "number" + }, + "numFiniteBuckets": { + "description": "Must be greater than 0.", + "format": "int32", + "type": "integer" + }, + "scale": { + "description": "Must be greater than 0.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleApiDistributionBucketOptionsLinear": { + "description": "Specifies a linear sequence of buckets that all have the same width (except overflow and underflow). Each bucket represents a constant absolute uncertainty on the specific value in the bucket. There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 <= i < N-1): offset + (width * i). Lower bound (1 <= i < N): offset + (width * (i - 1)).", + "id": "GoogleApiDistributionBucketOptionsLinear", + "properties": { + "numFiniteBuckets": { + "description": "Must be greater than 0.", + "format": "int32", + "type": "integer" + }, + "offset": { + "description": "Lower bound of the first bucket.", + "format": "double", + "type": "number" + }, + "width": { + "description": "Must be greater than 0.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleApiDistributionExemplar": { + "description": "Exemplars are example points that may be used to annotate aggregated distribution values. They are metadata that gives information about a particular value added to a Distribution bucket, such as a trace ID that was active when a value was added. They may contain further information, such as a example values and timestamps, origin, etc.", + "id": "GoogleApiDistributionExemplar", + "properties": { + "attachments": { + "description": "Contextual information about the example value. Examples are: Trace: type.googleapis.com/google.monitoring.v3.SpanContext Literal string: type.googleapis.com/google.protobuf.StringValue Labels dropped during aggregation: type.googleapis.com/google.monitoring.v3.DroppedLabels There may be only a single attachment of any given message type in a single exemplar, and this is enforced by the system.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "type": "object" + }, + "type": "array" + }, + "timestamp": { + "description": "The observation (sampling) time of the above value.", + "format": "google-datetime", + "type": "string" + }, + "value": { + "description": "Value of the exemplar point. This value determines to which bucket the exemplar belongs.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleApiDistributionRange": { + "description": "The range of the population values.", + "id": "GoogleApiDistributionRange", + "properties": { + "max": { + "description": "The maximum of the population values.", + "format": "double", + "type": "number" + }, + "min": { + "description": "The minimum of the population values.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, "GoogleApiHttpBody": { "description": "Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.", "id": "GoogleApiHttpBody", @@ -6910,6 +7258,64 @@ }, "type": "object" }, + "GoogleApiMetric": { + "description": "A specific metric, identified by specifying values for all of the labels of a `MetricDescriptor`.", + "id": "GoogleApiMetric", + "properties": { + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "The set of label values that uniquely identify this metric. All labels listed in the `MetricDescriptor` must be assigned values.", + "type": "object" + }, + "type": { + "description": "An existing metric type, see google.api.MetricDescriptor. For example, `custom.googleapis.com/invoice/paid/amount`.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleApiMonitoredResource": { + "description": "An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The `type` field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the `labels` field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for `\"gce_instance\"` has labels `\"project_id\"`, `\"instance_id\"` and `\"zone\"`: { \"type\": \"gce_instance\", \"labels\": { \"project_id\": \"my-project\", \"instance_id\": \"12345678901234\", \"zone\": \"us-central1-a\" }}", + "id": "GoogleApiMonitoredResource", + "properties": { + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Compute Engine VM instances use the labels `\"project_id\"`, `\"instance_id\"`, and `\"zone\"`.", + "type": "object" + }, + "type": { + "description": "Required. The monitored resource type. This field must match the `type` field of a MonitoredResourceDescriptor object. For example, the type of a Compute Engine VM instance is `gce_instance`. Some descriptors include the service name in the type; for example, the type of a Datastream stream is `datastream.googleapis.com/Stream`.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleApiMonitoredResourceMetadata": { + "description": "Auxiliary metadata for a MonitoredResource object. MonitoredResource objects contain the minimum set of information to uniquely identify a monitored resource instance. There is some other useful auxiliary metadata. Monitoring and Logging use an ingestion pipeline to extract metadata for cloud resources of all types, and store the metadata in this message.", + "id": "GoogleApiMonitoredResourceMetadata", + "properties": { + "systemLabels": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Output only. Values for predefined system metadata labels. System labels are a kind of metadata extracted by Google, including \"machine_image\", \"vpc\", \"subnet_id\", \"security_group\", \"name\", etc. System label values can be only strings, Boolean values, or a list of strings. For example: { \"name\": \"my-test-instance\", \"security_group\": [\"a\", \"b\", \"c\"], \"spot_instance\": false }", + "type": "object" + }, + "userLabels": { + "additionalProperties": { + "type": "string" + }, + "description": "Output only. A map of user-defined metadata labels.", + "type": "object" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineLoggingErrorContext": { "description": "A description of the context in which an error occurred.", "id": "GoogleCloudDiscoveryengineLoggingErrorContext", @@ -9447,6 +9853,17 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries": { + "description": "The historical crawl rate timeseries data, used for monitoring.", + "id": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "properties": { + "qpsTimeSeries": { + "$ref": "GoogleMonitoringV3TimeSeries", + "description": "The QPS of the crawl rate." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.CreateDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata", @@ -9779,6 +10196,21 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries": { + "description": "The historical dedicated crawl rate timeseries data, used for monitoring. Dedicated crawl is used by Vertex AI to crawl the user's website when dedicate crawl is set.", + "id": "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries", + "properties": { + "autoRefreshCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's dedicated crawl rate time series of auto-refresh, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is set, and the crawl rate is for best effort use cases like refreshing urls periodically." + }, + "userTriggeredCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's dedicated crawl rate time series of user triggered crawl, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is set, and user triggered crawl rate is for deterministic use cases like crawling urls or sitemaps specified by users." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata", @@ -10952,23 +11384,72 @@ "description": "Configuration for Natural Language Query Understanding.", "id": "GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig", "properties": { - "mode": { - "description": "Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.", + "mode": { + "description": "Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.", + "enum": [ + "MODE_UNSPECIFIED", + "DISABLED", + "ENABLED" + ], + "enumDescriptions": [ + "Default value.", + "Natural Language Query Understanding is disabled.", + "Natural Language Query Understanding is enabled." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse": { + "description": "Response message for CrawlRateManagementService.ObtainCrawlRate method. The response contains organcic or dedicated crawl rate time series data for monitoring, depending on whether dedicated crawl rate is set.", + "id": "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse", + "properties": { + "dedicatedCrawlRateTimeSeries": { + "$ref": "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries", + "description": "The historical dedicated crawl rate timeseries data, used for monitoring." + }, + "error": { + "$ref": "GoogleRpcStatus", + "description": "Errors from service when handling the request." + }, + "organicCrawlRateTimeSeries": { + "$ref": "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries", + "description": "The historical organic crawl rate timeseries data, used for monitoring." + }, + "state": { + "description": "Output only. The state of the response.", "enum": [ - "MODE_UNSPECIFIED", - "DISABLED", - "ENABLED" + "STATE_UNSPECIFIED", + "SUCCEEDED", + "FAILED" ], "enumDescriptions": [ - "Default value.", - "Natural Language Query Understanding is disabled.", - "Natural Language Query Understanding is enabled." + "The state is unspecified.", + "The state is successful.", + "The state is failed." ], + "readOnly": true, "type": "string" } }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries": { + "description": "The historical organic crawl rate timeseries data, used for monitoring. Organic crawl is auto-determined by Google to crawl the user's website when dedicate crawl is not set. Crawl rate is the QPS of crawl request Google sends to the user's website.", + "id": "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries", + "properties": { + "googleOrganicCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Google's organic crawl rate time series, which is the sum of all googlebots' crawl rate. Please refer to https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers for more details about googlebots." + }, + "vertexAiOrganicCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's organic crawl rate time series, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is not set. Please refer to https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot for more details about Google-CloudVertexBot." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaProject": { "description": "Metadata and configurations for a Google Cloud project in the service.", "id": "GoogleCloudDiscoveryengineV1alphaProject", @@ -12529,6 +13010,236 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest": { + "description": "Request message for CompletionService.AdvancedCompleteQuery method. .", + "id": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest", + "properties": { + "boostSpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpec", + "description": "Optional. Specification to boost suggestions matching the condition." + }, + "includeTailSuggestions": { + "description": "Indicates if tail suggestions should be returned if there are no suggestions that match the full query. Even if set to true, if there are suggestions that match the full query, those are returned and no tail suggestions are returned.", + "type": "boolean" + }, + "query": { + "description": "Required. The typeahead input used to fetch suggestions. Maximum length is 128 characters. The query can not be empty for most of the suggestion types. If it is empty, an `INVALID_ARGUMENT` error is returned. The exception is when the suggestion_types contains only the type `RECENT_SEARCH`, the query can be an empty string. The is called \"zero prefix\" feature, which returns user's recently searched queries given the empty query.", + "type": "string" + }, + "queryModel": { + "description": "Specifies the autocomplete data model. This overrides any model specified in the Configuration > Autocomplete section of the Cloud console. Currently supported values: * `document` - Using suggestions generated from user-imported documents. * `search-history` - Using suggestions generated from the past history of SearchService.Search API calls. Do not use it when there is no traffic for Search API. * `user-event` - Using suggestions generated from user-imported search events. * `document-completable` - Using suggestions taken directly from user-imported document fields marked as completable. Default values: * `document` is the default model for regular dataStores. * `search-history` is the default model for site search dataStores.", + "type": "string" + }, + "suggestionTypes": { + "description": "Optional. Suggestion types to return. If empty or unspecified, query suggestions are returned. Only one suggestion type is supported at the moment.", + "items": { + "enum": [ + "SUGGESTION_TYPE_UNSPECIFIED", + "QUERY", + "PEOPLE", + "CONTENT", + "RECENT_SEARCH", + "GOOGLE_WORKSPACE" + ], + "enumDescriptions": [ + "Default value.", + "Returns query suggestions.", + "Returns people suggestions.", + "Returns content suggestions.", + "Returns recent search suggestions.", + "Returns Google Workspace suggestions." + ], + "type": "string" + }, + "type": "array" + }, + "userInfo": { + "$ref": "GoogleCloudDiscoveryengineV1betaUserInfo", + "description": "Optional. Information about the end user. This should be the same identifier information as UserEvent.user_info and SearchRequest.user_info." + }, + "userPseudoId": { + "description": "A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. This field should NOT have a fixed value such as `unknown_visitor`. This should be the same identifier as UserEvent.user_pseudo_id and SearchRequest.user_pseudo_id. The field must be a UTF-8 encoded string with a length limit of 128", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpec": { + "description": "Specification to boost suggestions based on the condtion of the suggestion.", + "id": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpec", + "properties": { + "conditionBoostSpecs": { + "description": "Condition boost specifications. If a suggestion matches multiple conditions in the specifictions, boost values from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20. Note: Currently only support language condition boost.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec": { + "description": "Boost applies to suggestions which match a condition.", + "id": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec", + "properties": { + "boost": { + "description": "Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the suggestions a big promotion. However, it does not necessarily mean that the top result will be a boosted suggestion. Setting to -1.0 gives the suggestions a big demotion. However, other suggestions that are relevant might still be shown. Setting to 0.0 means no boost applied. The boosting condition is ignored.", + "format": "float", + "type": "number" + }, + "condition": { + "description": "An expression which specifies a boost condition. The syntax is the same as [filter expression syntax](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax). Currently, the only supported condition is a list of BCP-47 lang codes. Example: * To boost suggestions in languages `en` or `fr`: `(lang_code: ANY(\"en\", \"fr\"))`", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse": { + "description": "Response message for CompletionService.AdvancedCompleteQuery method.", + "id": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse", + "properties": { + "contentSuggestions": { + "description": "Results of the matched content suggestions. The result list is ordered and the first result is the top suggestion.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseContentSuggestion" + }, + "type": "array" + }, + "peopleSuggestions": { + "description": "Results of the matched people suggestions. The result list is ordered and the first result is the top suggestion.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponsePersonSuggestion" + }, + "type": "array" + }, + "querySuggestions": { + "description": "Results of the matched query suggestions. The result list is ordered and the first result is a top suggestion.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseQuerySuggestion" + }, + "type": "array" + }, + "recentSearchSuggestions": { + "description": "Results of the matched \"recent search\" suggestions. The result list is ordered and the first result is the top suggestion.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseRecentSearchSuggestion" + }, + "type": "array" + }, + "tailMatchTriggered": { + "description": "True if the returned suggestions are all tail suggestions. For tail matching to be triggered, include_tail_suggestions in the request must be true and there must be no suggestions that match the full query.", + "type": "boolean" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseContentSuggestion": { + "description": "Suggestions as content.", + "id": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseContentSuggestion", + "properties": { + "contentType": { + "description": "The type of the content suggestion.", + "enum": [ + "CONTENT_TYPE_UNSPECIFIED", + "GOOGLE_WORKSPACE", + "THIRD_PARTY" + ], + "enumDescriptions": [ + "Default value.", + "The suggestion is from a Google Workspace source.", + "The suggestion is from a third party source." + ], + "type": "string" + }, + "dataStore": { + "description": "The name of the dataStore that this suggestion belongs to.", + "type": "string" + }, + "document": { + "$ref": "GoogleCloudDiscoveryengineV1betaDocument", + "description": "The document data snippet in the suggestion. Only a subset of fields will be populated." + }, + "suggestion": { + "description": "The suggestion for the query.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponsePersonSuggestion": { + "description": "Suggestions as people.", + "id": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponsePersonSuggestion", + "properties": { + "dataStore": { + "description": "The name of the dataStore that this suggestion belongs to.", + "type": "string" + }, + "document": { + "$ref": "GoogleCloudDiscoveryengineV1betaDocument", + "description": "The document data snippet in the suggestion. Only a subset of fields is populated." + }, + "personType": { + "description": "The type of the person.", + "enum": [ + "PERSON_TYPE_UNSPECIFIED", + "CLOUD_IDENTITY", + "THIRD_PARTY_IDENTITY" + ], + "enumDescriptions": [ + "Default value.", + "The suggestion is from a GOOGLE_IDENTITY source.", + "The suggestion is from a THIRD_PARTY_IDENTITY source." + ], + "type": "string" + }, + "suggestion": { + "description": "The suggestion for the query.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseQuerySuggestion": { + "description": "Suggestions as search queries.", + "id": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseQuerySuggestion", + "properties": { + "completableFieldPaths": { + "description": "The unique document field paths that serve as the source of this suggestion if it was generated from completable fields. This field is only populated for the document-completable model.", + "items": { + "type": "string" + }, + "type": "array" + }, + "dataStore": { + "description": "The name of the dataStore that this suggestion belongs to.", + "items": { + "type": "string" + }, + "type": "array" + }, + "suggestion": { + "description": "The suggestion for the query.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseRecentSearchSuggestion": { + "description": "Suggestions from recent search history.", + "id": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseRecentSearchSuggestion", + "properties": { + "recentSearchTime": { + "description": "The time when this recent rearch happened.", + "format": "google-datetime", + "type": "string" + }, + "suggestion": { + "description": "The suggestion for the query.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig": { "description": "Configuration data for advance site search.", "id": "GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig", @@ -12720,6 +13431,10 @@ "description": "Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.", "type": "boolean" }, + "groundingSpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestGroundingSpec", + "description": "Optional. Grounding specification." + }, "query": { "$ref": "GoogleCloudDiscoveryengineV1betaQuery", "description": "Required. Current user query." @@ -12819,6 +13534,31 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestGroundingSpec": { + "description": "Grounding specification.", + "id": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestGroundingSpec", + "properties": { + "filteringLevel": { + "description": "Optional. Specifies whether to enable the filtering based on grounding score and at what level.", + "enum": [ + "FILTERING_LEVEL_UNSPECIFIED", + "FILTERING_LEVEL_LOW", + "FILTERING_LEVEL_HIGH" + ], + "enumDescriptions": [ + "Default is no filter", + "Filter answers based on a low threshold.", + "Filter answers based on a high threshold." + ], + "type": "string" + }, + "includeGroundingSupports": { + "description": "Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports for each claim.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestQueryUnderstandingSpec": { "description": "Query understanding specification.", "id": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestQueryUnderstandingSpec", @@ -19239,7 +19979,7 @@ "type": "string" }, "eventType": { - "description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.", + "description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans * `add-feedback`: Add a user feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.", "type": "string" }, "filter": { @@ -19412,6 +20152,139 @@ }, "type": "object" }, + "GoogleMonitoringV3Point": { + "description": "A single data point in a time series.", + "id": "GoogleMonitoringV3Point", + "properties": { + "interval": { + "$ref": "GoogleMonitoringV3TimeInterval", + "description": "The time interval to which the data point applies. For `GAUGE` metrics, the start time is optional, but if it is supplied, it must equal the end time. For `DELTA` metrics, the start and end time should specify a non-zero interval, with subsequent points specifying contiguous and non-overlapping intervals. For `CUMULATIVE` metrics, the start and end time should specify a non-zero interval, with subsequent points specifying the same start time and increasing end times, until an event resets the cumulative value to zero and sets a new start time for the following points." + }, + "value": { + "$ref": "GoogleMonitoringV3TypedValue", + "description": "The value of the data point." + } + }, + "type": "object" + }, + "GoogleMonitoringV3TimeInterval": { + "description": "A time interval extending just after a start time through an end time. If the start time is the same as the end time, then the interval represents a single point in time.", + "id": "GoogleMonitoringV3TimeInterval", + "properties": { + "endTime": { + "description": "Required. The end of the time interval.", + "format": "google-datetime", + "type": "string" + }, + "startTime": { + "description": "Optional. The beginning of the time interval. The default value for the start time is the end time. The start time must not be later than the end time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleMonitoringV3TimeSeries": { + "description": "A collection of data points that describes the time-varying values of a metric. A time series is identified by a combination of a fully-specified monitored resource and a fully-specified metric. This type is used for both listing and creating time series.", + "id": "GoogleMonitoringV3TimeSeries", + "properties": { + "description": { + "description": "Input only. A detailed description of the time series that will be associated with the google.api.MetricDescriptor for the metric. Once set, this field cannot be changed through CreateTimeSeries.", + "type": "string" + }, + "metadata": { + "$ref": "GoogleApiMonitoredResourceMetadata", + "description": "Output only. The associated monitored resource metadata. When reading a time series, this field will include metadata labels that are explicitly named in the reduction. When creating a time series, this field is ignored." + }, + "metric": { + "$ref": "GoogleApiMetric", + "description": "The associated metric. A fully-specified metric used to identify the time series." + }, + "metricKind": { + "description": "The metric kind of the time series. When listing time series, this metric kind might be different from the metric kind of the associated metric if this time series is an alignment or reduction of other time series. When creating a time series, this field is optional. If present, it must be the same as the metric kind of the associated metric. If the associated metric's descriptor must be auto-created, then this field specifies the metric kind of the new descriptor and must be either `GAUGE` (the default) or `CUMULATIVE`.", + "enum": [ + "METRIC_KIND_UNSPECIFIED", + "GAUGE", + "DELTA", + "CUMULATIVE" + ], + "enumDescriptions": [ + "Do not use this default value.", + "An instantaneous measurement of a value.", + "The change in a value during a time interval.", + "A value accumulated over a time interval. Cumulative measurements in a time series should have the same start time and increasing end times, until an event resets the cumulative value to zero and sets a new start time for the following points." + ], + "type": "string" + }, + "points": { + "description": "The data points of this time series. When listing time series, points are returned in reverse time order. When creating a time series, this field must contain exactly one point and the point's type must be the same as the value type of the associated metric. If the associated metric's descriptor must be auto-created, then the value type of the descriptor is determined by the point's type, which must be `BOOL`, `INT64`, `DOUBLE`, or `DISTRIBUTION`.", + "items": { + "$ref": "GoogleMonitoringV3Point" + }, + "type": "array" + }, + "resource": { + "$ref": "GoogleApiMonitoredResource", + "description": "The associated monitored resource. Custom metrics can use only certain monitored resource types in their time series data. For more information, see [Monitored resources for custom metrics](https://cloud.google.com/monitoring/custom-metrics/creating-metrics#custom-metric-resources)." + }, + "unit": { + "description": "The units in which the metric value is reported. It is only applicable if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit` defines the representation of the stored metric values. This field can only be changed through CreateTimeSeries when it is empty.", + "type": "string" + }, + "valueType": { + "description": "The value type of the time series. When listing time series, this value type might be different from the value type of the associated metric if this time series is an alignment or reduction of other time series. When creating a time series, this field is optional. If present, it must be the same as the type of the data in the `points` field.", + "enum": [ + "VALUE_TYPE_UNSPECIFIED", + "BOOL", + "INT64", + "DOUBLE", + "STRING", + "DISTRIBUTION", + "MONEY" + ], + "enumDescriptions": [ + "Do not use this default value.", + "The value is a boolean. This value type can be used only if the metric kind is `GAUGE`.", + "The value is a signed 64-bit integer.", + "The value is a double precision floating point number.", + "The value is a text string. This value type can be used only if the metric kind is `GAUGE`.", + "The value is a `Distribution`.", + "The value is money." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleMonitoringV3TypedValue": { + "description": "A single strongly-typed value.", + "id": "GoogleMonitoringV3TypedValue", + "properties": { + "boolValue": { + "description": "A Boolean value: `true` or `false`.", + "type": "boolean" + }, + "distributionValue": { + "$ref": "GoogleApiDistribution", + "description": "A distribution value." + }, + "doubleValue": { + "description": "A 64-bit double-precision floating-point number. Its magnitude is approximately \u00b110\u00b1300 and it has 16 significant digits of precision.", + "format": "double", + "type": "number" + }, + "int64Value": { + "description": "A 64-bit integer. Its range is approximately \u00b19.2x1018.", + "format": "int64", + "type": "string" + }, + "stringValue": { + "description": "A variable-length string value.", + "type": "string" + } + }, + "type": "object" + }, "GoogleProtobufEmpty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "GoogleProtobufEmpty", diff --git a/DiscoveryJson/documentai.v1beta3.json b/DiscoveryJson/documentai.v1beta3.json index 17500500705..cbb3b2a61de 100644 --- a/DiscoveryJson/documentai.v1beta3.json +++ b/DiscoveryJson/documentai.v1beta3.json @@ -1284,7 +1284,7 @@ } } }, - "revision": "20240911", + "revision": "20241025", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -3004,6 +3004,16 @@ "name": { "description": "Dataset schema resource name. Format: `projects/{project}/locations/{location}/processors/{processor}/dataset/datasetSchema`", "type": "string" + }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" } }, "type": "object" diff --git a/DiscoveryJson/firebase.v1beta1.json b/DiscoveryJson/firebase.v1beta1.json index 6b0e107cba6..9520c6f85ff 100644 --- a/DiscoveryJson/firebase.v1beta1.json +++ b/DiscoveryJson/firebase.v1beta1.json @@ -1324,7 +1324,7 @@ } } }, - "revision": "20240913", + "revision": "20241025", "rootUrl": "https://firebase.googleapis.com/", "schemas": { "AddFirebaseRequest": { @@ -1436,7 +1436,7 @@ "type": "string" }, "expireTime": { - "description": "Output only. Timestamp of when the App will be considered expired and cannot be undeleted. This value is only provided if the App is in the `DELETED` state.", + "description": "Output only. If the App has been removed from the Project, this is the timestamp of when the App is considered expired and will be permanently deleted. After this time, the App cannot be undeleted (that is, restored to the Project). This value is only provided if the App is in the `DELETED` state.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -1569,7 +1569,7 @@ "type": "string" }, "expireTime": { - "description": "Output only. Timestamp of when the App will be considered expired and cannot be undeleted. This value is only provided if the App is in the `DELETED` state.", + "description": "Output only. If the App has been removed from the Project, this is the timestamp of when the App is considered expired and will be permanently deleted. After this time, the App cannot be undeleted (that is, restored to the Project). This value is only provided if the App is in the `DELETED` state.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -1705,7 +1705,7 @@ "type": "string" }, "expireTime": { - "description": "Output only. Timestamp of when the App will be considered expired and cannot be undeleted. This value is only provided if the App is in the `DELETED` state.", + "description": "Output only. If the App has been removed from the Project, this is the timestamp of when the App is considered expired and will be permanently deleted. After this time, the App cannot be undeleted (that is, restored to the Project). This value is only provided if the App is in the `DELETED` state.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -2020,7 +2020,7 @@ "type": "string" }, "immediate": { - "description": "Determines whether to _immediately_ delete the AndroidApp. If set to true, the App is immediately deleted from the Project and cannot be restored to the Project. If not set, defaults to false, which means the App will be set to expire in 30 days. Within the 30 days, the App may be restored to the Project using UndeleteAndroidApp.", + "description": "Determines whether to _immediately_ delete the AndroidApp. If set to true, the App is immediately deleted from the Project and cannot be undeleted (that is, restored to the Project). If not set, defaults to false, which means the App will be set to expire in 30 days. Within the 30 days, the App may be restored to the Project using UndeleteAndroidApp.", "type": "boolean" }, "validateOnly": { @@ -2042,7 +2042,7 @@ "type": "string" }, "immediate": { - "description": "Determines whether to _immediately_ delete the IosApp. If set to true, the App is immediately deleted from the Project and cannot be restored to the Project. If not set, defaults to false, which means the App will be set to expire in 30 days. Within the 30 days, the App may be restored to the Project using UndeleteIosApp", + "description": "Determines whether to _immediately_ delete the IosApp. If set to true, the App is immediately deleted from the Project and cannot be undeleted (that is, restored to the Project). If not set, defaults to false, which means the App will be set to expire in 30 days. Within the 30 days, the App may be restored to the Project using UndeleteIosApp", "type": "boolean" }, "validateOnly": { @@ -2064,7 +2064,7 @@ "type": "string" }, "immediate": { - "description": "Determines whether to _immediately_ delete the WebApp. If set to true, the App is immediately deleted from the Project and cannot be restored to the Project. If not set, defaults to false, which means the App will be set to expire in 30 days. Within the 30 days, the App may be restored to the Project using UndeleteWebApp", + "description": "Determines whether to _immediately_ delete the WebApp. If set to true, the App is immediately deleted from the Project and cannot be undeleted (that is, restored to the Project). If not set, defaults to false, which means the App will be set to expire in 30 days. Within the 30 days, the App may be restored to the Project using UndeleteWebApp", "type": "boolean" }, "validateOnly": { @@ -2267,7 +2267,7 @@ "type": "string" }, "expireTime": { - "description": "Output only. Timestamp of when the App will be considered expired and cannot be undeleted. This value is only provided if the App is in the `DELETED` state.", + "description": "Output only. If the App has been removed from the Project, this is the timestamp of when the App is considered expired and will be permanently deleted. After this time, the App cannot be undeleted (that is, restored to the Project). This value is only provided if the App is in the `DELETED` state.", "format": "google-datetime", "readOnly": true, "type": "string" diff --git a/DiscoveryJson/firebaseappdistribution.v1alpha.json b/DiscoveryJson/firebaseappdistribution.v1alpha.json index bc41ddaa414..d4b361a0b48 100644 --- a/DiscoveryJson/firebaseappdistribution.v1alpha.json +++ b/DiscoveryJson/firebaseappdistribution.v1alpha.json @@ -625,7 +625,7 @@ } } }, - "revision": "20241018", + "revision": "20241028", "rootUrl": "https://firebaseappdistribution.googleapis.com/", "schemas": { "AndroidxCrawlerOutputPoint": { @@ -1488,6 +1488,10 @@ }, "type": "array" }, + "displayName": { + "description": "Optional. Display name of the release test. Required if the release test is created with multiple goals", + "type": "string" + }, "loginCredential": { "$ref": "GoogleFirebaseAppdistroV1alphaLoginCredential", "description": "Optional. Input only. Login credentials for the test. Input only." diff --git a/DiscoveryJson/firestore.v1.json b/DiscoveryJson/firestore.v1.json index 963529a5d4a..a9a165d33f5 100644 --- a/DiscoveryJson/firestore.v1.json +++ b/DiscoveryJson/firestore.v1.json @@ -1711,7 +1711,7 @@ } } }, - "revision": "20240904", + "revision": "20241018", "rootUrl": "https://firestore.googleapis.com/", "schemas": { "Aggregation": { @@ -2417,7 +2417,7 @@ "type": "string" }, "distanceThreshold": { - "description": "Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT distances increase when the vectors are more similar, the comparison is inverted. For EUCLIDEAN, COSINE: WHERE distance <= distance_threshold For DOT_PRODUCT: WHERE distance >= distance_threshold", + "description": "Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT distances increase when the vectors are more similar, the comparison is inverted. * For EUCLIDEAN, COSINE: WHERE distance <= distance_threshold * For DOT_PRODUCT: WHERE distance >= distance_threshold", "format": "double", "type": "number" }, @@ -4264,7 +4264,7 @@ "type": "object" }, "StructuredQuery": { - "description": "A Firestore query. The query stages are executed in the following order: 1. from 2. where 3. select 4. order_by + start_at + end_at 5. offset 6. limit", + "description": "A Firestore query. The query stages are executed in the following order: 1. from 2. where 3. select 4. order_by + start_at + end_at 5. offset 6. limit 7. find_nearest", "id": "StructuredQuery", "properties": { "endAt": { diff --git a/DiscoveryJson/firestore.v1beta1.json b/DiscoveryJson/firestore.v1beta1.json index c7f464b1d2f..475eed53999 100644 --- a/DiscoveryJson/firestore.v1beta1.json +++ b/DiscoveryJson/firestore.v1beta1.json @@ -950,7 +950,7 @@ } } }, - "revision": "20240822", + "revision": "20241018", "rootUrl": "https://firestore.googleapis.com/", "schemas": { "Aggregation": { @@ -1656,7 +1656,7 @@ "type": "string" }, "distanceThreshold": { - "description": "Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT distances increase when the vectors are more similar, the comparison is inverted. For EUCLIDEAN, COSINE: WHERE distance <= distance_threshold For DOT_PRODUCT: WHERE distance >= distance_threshold", + "description": "Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT distances increase when the vectors are more similar, the comparison is inverted. * For EUCLIDEAN, COSINE: WHERE distance <= distance_threshold * For DOT_PRODUCT: WHERE distance >= distance_threshold", "format": "double", "type": "number" }, @@ -2654,7 +2654,7 @@ "type": "object" }, "StructuredQuery": { - "description": "A Firestore query. The query stages are executed in the following order: 1. from 2. where 3. select 4. order_by + start_at + end_at 5. offset 6. limit", + "description": "A Firestore query. The query stages are executed in the following order: 1. from 2. where 3. select 4. order_by + start_at + end_at 5. offset 6. limit 7. find_nearest", "id": "StructuredQuery", "properties": { "endAt": { diff --git a/DiscoveryJson/iam.v1.json b/DiscoveryJson/iam.v1.json index dbbb12a417a..55ecd1e083e 100644 --- a/DiscoveryJson/iam.v1.json +++ b/DiscoveryJson/iam.v1.json @@ -159,14 +159,14 @@ ], "parameters": { "location": { - "description": "The location of the pool to create. Format: `locations/{location}`.", + "description": "Optional. The location of the pool to create. Format: `locations/{location}`.", "location": "path", "pattern": "^locations/[^/]+$", "required": true, "type": "string" }, "workforcePoolId": { - "description": "The ID to use for the pool, which becomes the final component of the resource name. The IDs must be a globally unique string of 6 to 63 lowercase letters, digits, or hyphens. It must start with a letter, and cannot have a trailing hyphen. The prefix `gcp-` is reserved for use by Google, and may not be specified.", + "description": "Optional. The ID to use for the pool, which becomes the final component of the resource name. The IDs must be a globally unique string of 6 to 63 lowercase letters, digits, or hyphens. It must start with a letter, and cannot have a trailing hyphen. The prefix `gcp-` is reserved for use by Google, and may not be specified.", "location": "query", "type": "string" } @@ -3188,7 +3188,7 @@ } } }, - "revision": "20241017", + "revision": "20241028", "rootUrl": "https://iam.googleapis.com/", "schemas": { "AccessRestrictions": { @@ -3599,14 +3599,14 @@ }, "clientSecret": { "$ref": "GoogleIamAdminV1WorkforcePoolProviderOidcClientSecret", - "description": "The optional client secret. Required to enable Authorization Code flow for web sign-in." + "description": "Optional. The optional client secret. Required to enable Authorization Code flow for web sign-in." }, "issuerUri": { "description": "Required. The OIDC issuer URI. Must be a valid URI using the `https` scheme.", "type": "string" }, "jwksJson": { - "description": "OIDC JWKs in JSON String format. For details on the definition of a JWK, see https://tools.ietf.org/html/rfc7517. If not set, the `jwks_uri` from the discovery document(fetched from the .well-known path of the `issuer_uri`) will be used. Currently, RSA and EC asymmetric keys are supported. The JWK must use following format and include only the following fields: { \"keys\": [ { \"kty\": \"RSA/EC\", \"alg\": \"\", \"use\": \"sig\", \"kid\": \"\", \"n\": \"\", \"e\": \"\", \"x\": \"\", \"y\": \"\", \"crv\": \"\" } ] }", + "description": "Optional. OIDC JWKs in JSON String format. For details on the definition of a JWK, see https://tools.ietf.org/html/rfc7517. If not set, the `jwks_uri` from the discovery document(fetched from the .well-known path of the `issuer_uri`) will be used. Currently, RSA and EC asymmetric keys are supported. The JWK must use following format and include only the following fields: { \"keys\": [ { \"kty\": \"RSA/EC\", \"alg\": \"\", \"use\": \"sig\", \"kid\": \"\", \"n\": \"\", \"e\": \"\", \"x\": \"\", \"y\": \"\", \"crv\": \"\" } ] }", "type": "string" }, "webSsoConfig": { @@ -3632,7 +3632,7 @@ "id": "GoogleIamAdminV1WorkforcePoolProviderOidcClientSecretValue", "properties": { "plainText": { - "description": "Input only. The plain text of the client secret value. For security reasons, this field is only used for input and will never be populated in any response.", + "description": "Optional. Input only. The plain text of the client secret value. For security reasons, this field is only used for input and will never be populated in any response.", "type": "string" }, "thumbprint": { @@ -3648,7 +3648,7 @@ "id": "GoogleIamAdminV1WorkforcePoolProviderOidcWebSsoConfig", "properties": { "additionalScopes": { - "description": "Additional scopes to request for in the OIDC authentication request on top of scopes requested by default. By default, the `openid`, `profile` and `email` scopes that are supported by the identity provider are requested. Each additional scope may be at most 256 characters. A maximum of 10 additional scopes may be configured.", + "description": "Optional. Additional scopes to request for in the OIDC authentication request on top of scopes requested by default. By default, the `openid`, `profile` and `email` scopes that are supported by the identity provider are requested. Each additional scope may be at most 256 characters. A maximum of 10 additional scopes may be configured.", "items": { "type": "string" }, @@ -4998,15 +4998,15 @@ "description": "Optional. Configure access restrictions on the workforce pool users. This is an optional field. If specified web sign-in can be restricted to given set of services or programmatic sign-in can be disabled for pool users." }, "description": { - "description": "A user-specified description of the pool. Cannot exceed 256 characters.", + "description": "Optional. A user-specified description of the pool. Cannot exceed 256 characters.", "type": "string" }, "disabled": { - "description": "Disables the workforce pool. You cannot use a disabled pool to exchange tokens, or use existing tokens to access resources. If the pool is re-enabled, existing tokens grant access again.", + "description": "Optional. Disables the workforce pool. You cannot use a disabled pool to exchange tokens, or use existing tokens to access resources. If the pool is re-enabled, existing tokens grant access again.", "type": "boolean" }, "displayName": { - "description": "A user-specified display name of the pool in Google Cloud Console. Cannot exceed 32 characters.", + "description": "Optional. A user-specified display name of the pool in Google Cloud Console. Cannot exceed 32 characters.", "type": "string" }, "expireTime": { @@ -5025,7 +5025,7 @@ "type": "string" }, "sessionDuration": { - "description": "Duration that the Google Cloud access tokens, console sign-in sessions, and `gcloud` sign-in sessions from this pool are valid. Must be greater than 15 minutes (900s) and less than 12 hours (43200s). If `session_duration` is not configured, minted credentials have a default duration of one hour (3600s). For SAML providers, the lifetime of the token is the minimum of the `session_duration` and the `SessionNotOnOrAfter` claim in the SAML assertion.", + "description": "Optional. Duration that the Google Cloud access tokens, console sign-in sessions, and `gcloud` sign-in sessions from this pool are valid. Must be greater than 15 minutes (900s) and less than 12 hours (43200s). If `session_duration` is not configured, minted credentials have a default duration of one hour (3600s). For SAML providers, the lifetime of the token is the minimum of the `session_duration` and the `SessionNotOnOrAfter` claim in the SAML assertion.", "format": "google-duration", "type": "string" }, @@ -5052,7 +5052,7 @@ "id": "WorkforcePoolProvider", "properties": { "attributeCondition": { - "description": "A [Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. `google.profile_photo`, `google.display_name` and `google.posix_username` are not supported. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the attribute condition expression is 4096 characters. If unspecified, all valid authentication credentials will be accepted. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` \"'admins' in google.groups\" ```", + "description": "Optional. A [Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. `google.profile_photo`, `google.display_name` and `google.posix_username` are not supported. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the attribute condition expression is 4096 characters. If unspecified, all valid authentication credentials will be accepted. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` \"'admins' in google.groups\" ```", "type": "string" }, "attributeMapping": { @@ -5063,15 +5063,15 @@ "type": "object" }, "description": { - "description": "A user-specified description of the provider. Cannot exceed 256 characters.", + "description": "Optional. A user-specified description of the provider. Cannot exceed 256 characters.", "type": "string" }, "disabled": { - "description": "Disables the workforce pool provider. You cannot use a disabled provider to exchange tokens. However, existing tokens still grant access.", + "description": "Optional. Disables the workforce pool provider. You cannot use a disabled provider to exchange tokens. However, existing tokens still grant access.", "type": "boolean" }, "displayName": { - "description": "A user-specified display name for the provider. Cannot exceed 32 characters.", + "description": "Optional. A user-specified display name for the provider. Cannot exceed 32 characters.", "type": "string" }, "expireTime": { diff --git a/DiscoveryJson/looker.v1.json b/DiscoveryJson/looker.v1.json index d961b6e1010..e9c8b482418 100644 --- a/DiscoveryJson/looker.v1.json +++ b/DiscoveryJson/looker.v1.json @@ -731,7 +731,7 @@ } } }, - "revision": "20240910", + "revision": "20241016", "rootUrl": "https://looker.googleapis.com/", "schemas": { "AdminSettings": { @@ -1636,22 +1636,22 @@ "id": "TimeOfDay", "properties": { "hours": { - "description": "Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.", + "description": "Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.", "format": "int32", "type": "integer" }, "minutes": { - "description": "Minutes of hour of day. Must be from 0 to 59.", + "description": "Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.", "format": "int32", "type": "integer" }, "nanos": { - "description": "Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.", + "description": "Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.", "format": "int32", "type": "integer" }, "seconds": { - "description": "Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.", + "description": "Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.", "format": "int32", "type": "integer" } diff --git a/DiscoveryJson/merchantapi.accounts_v1beta.json b/DiscoveryJson/merchantapi.accounts_v1beta.json index 50687469b16..fbd728822db 100644 --- a/DiscoveryJson/merchantapi.accounts_v1beta.json +++ b/DiscoveryJson/merchantapi.accounts_v1beta.json @@ -1417,7 +1417,7 @@ } } }, - "revision": "20241023", + "revision": "20241028", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "Accepted": { @@ -1714,7 +1714,7 @@ "type": "object" }, "CarrierRate": { - "description": "A list of carrier rates that can be referred to by `main_table` or `single_value`.", + "description": "A list of carrier rates that can be referred to by `main_table` or `single_value`. Supported carrier services are defined in https://support.google.com/merchants/answer/12577710?hl=en&ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.", "id": "CarrierRate", "properties": { "carrier": { @@ -3455,7 +3455,7 @@ "id": "WarehouseBasedDeliveryTime", "properties": { "carrier": { - "description": "Required. Carrier, such as `\"UPS\"` or `\"Fedex\"`.", + "description": "Required. Carrier, such as `\"UPS\"` or `\"Fedex\"`. [supported carriers](https://support.google.com/merchants/answer/7050921#zippy=%2Ccarrier-rates-au-de-uk-and-us-only)", "type": "string" }, "carrierService": { diff --git a/DiscoveryJson/osconfig.v2beta.json b/DiscoveryJson/osconfig.v2beta.json new file mode 100644 index 00000000000..a5f77c9145d --- /dev/null +++ b/DiscoveryJson/osconfig.v2beta.json @@ -0,0 +1,756 @@ +{ + "auth": { + "oauth2": { + "scopes": { + "https://www.googleapis.com/auth/cloud-platform": { + "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." + } + } + } + }, + "basePath": "", + "baseUrl": "https://osconfig.googleapis.com/", + "batchPath": "batch", + "canonicalName": "OS Config", + "description": "OS management tools that can be used for patch management, patch compliance, and configuration management on VM instances.", + "discoveryVersion": "v1", + "documentationLink": "https://cloud.google.com/compute/docs/osconfig/rest", + "fullyEncodeReservedExpansion": true, + "icons": { + "x16": "http://www.google.com/images/icons/product/search-16.gif", + "x32": "http://www.google.com/images/icons/product/search-32.gif" + }, + "id": "osconfig:v2beta", + "kind": "discovery#restDescription", + "mtlsRootUrl": "https://osconfig.mtls.googleapis.com/", + "name": "osconfig", + "ownerDomain": "google.com", + "ownerName": "Google", + "parameters": { + "$.xgafv": { + "description": "V1 error format.", + "enum": [ + "1", + "2" + ], + "enumDescriptions": [ + "v1 error format", + "v2 error format" + ], + "location": "query", + "type": "string" + }, + "access_token": { + "description": "OAuth access token.", + "location": "query", + "type": "string" + }, + "alt": { + "default": "json", + "description": "Data format for response.", + "enum": [ + "json", + "media", + "proto" + ], + "enumDescriptions": [ + "Responses with Content-Type of application/json", + "Media download with context-dependent Content-Type", + "Responses with Content-Type of application/x-protobuf" + ], + "location": "query", + "type": "string" + }, + "callback": { + "description": "JSONP", + "location": "query", + "type": "string" + }, + "fields": { + "description": "Selector specifying which fields to include in a partial response.", + "location": "query", + "type": "string" + }, + "key": { + "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", + "location": "query", + "type": "string" + }, + "oauth_token": { + "description": "OAuth 2.0 token for the current user.", + "location": "query", + "type": "string" + }, + "prettyPrint": { + "default": "true", + "description": "Returns response with indentations and line breaks.", + "location": "query", + "type": "boolean" + }, + "quotaUser": { + "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", + "location": "query", + "type": "string" + }, + "uploadType": { + "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", + "location": "query", + "type": "string" + }, + "upload_protocol": { + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", + "location": "query", + "type": "string" + } + }, + "protocol": "rest", + "resources": { + "folders": { + "resources": { + "locations": { + "resources": { + "operations": { + "methods": { + "cancel": { + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "flatPath": "v2beta/folders/{foldersId}/locations/{locationsId}/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "osconfig.folders.locations.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^folders/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}:cancel", + "request": { + "$ref": "CancelOperationRequest" + }, + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", + "flatPath": "v2beta/folders/{foldersId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "DELETE", + "id": "osconfig.folders.locations.operations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be deleted.", + "location": "path", + "pattern": "^folders/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", + "flatPath": "v2beta/folders/{foldersId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "osconfig.folders.locations.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^folders/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", + "flatPath": "v2beta/folders/{foldersId}/locations/{locationsId}/operations", + "httpMethod": "GET", + "id": "osconfig.folders.locations.operations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "The standard list filter.", + "location": "query", + "type": "string" + }, + "name": { + "description": "The name of the operation's parent resource.", + "location": "path", + "pattern": "^folders/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v2beta/{+name}/operations", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + }, + "organizations": { + "resources": { + "locations": { + "resources": { + "operations": { + "methods": { + "cancel": { + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "flatPath": "v2beta/organizations/{organizationsId}/locations/{locationsId}/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "osconfig.organizations.locations.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}:cancel", + "request": { + "$ref": "CancelOperationRequest" + }, + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", + "flatPath": "v2beta/organizations/{organizationsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "DELETE", + "id": "osconfig.organizations.locations.operations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be deleted.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", + "flatPath": "v2beta/organizations/{organizationsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "osconfig.organizations.locations.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", + "flatPath": "v2beta/organizations/{organizationsId}/locations/{locationsId}/operations", + "httpMethod": "GET", + "id": "osconfig.organizations.locations.operations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "The standard list filter.", + "location": "query", + "type": "string" + }, + "name": { + "description": "The name of the operation's parent resource.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v2beta/{+name}/operations", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + }, + "projects": { + "resources": { + "locations": { + "resources": { + "operations": { + "methods": { + "cancel": { + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "osconfig.projects.locations.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}:cancel", + "request": { + "$ref": "CancelOperationRequest" + }, + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", + "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "DELETE", + "id": "osconfig.projects.locations.operations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be deleted.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", + "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "osconfig.projects.locations.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", + "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/operations", + "httpMethod": "GET", + "id": "osconfig.projects.locations.operations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "The standard list filter.", + "location": "query", + "type": "string" + }, + "name": { + "description": "The name of the operation's parent resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v2beta/{+name}/operations", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + } + }, + "revision": "20241021", + "rootUrl": "https://osconfig.googleapis.com/", + "schemas": { + "CancelOperationRequest": { + "description": "The request message for Operations.CancelOperation.", + "id": "CancelOperationRequest", + "properties": {}, + "type": "object" + }, + "Empty": { + "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", + "id": "Empty", + "properties": {}, + "type": "object" + }, + "GoogleCloudOsconfigV1__OSPolicyAssignmentOperationMetadata": { + "description": "OS policy assignment operation metadata provided by OS policy assignment API methods that return long running operations.", + "id": "GoogleCloudOsconfigV1__OSPolicyAssignmentOperationMetadata", + "properties": { + "apiMethod": { + "description": "The OS policy assignment API method.", + "enum": [ + "API_METHOD_UNSPECIFIED", + "CREATE", + "UPDATE", + "DELETE" + ], + "enumDescriptions": [ + "Invalid value", + "Create OS policy assignment API method", + "Update OS policy assignment API method", + "Delete OS policy assignment API method" + ], + "type": "string" + }, + "osPolicyAssignment": { + "description": "Reference to the `OSPolicyAssignment` API resource. Format: `projects/{project_number}/locations/{location}/osPolicyAssignments/{os_policy_assignment_id@revision_id}`", + "type": "string" + }, + "rolloutStartTime": { + "description": "Rollout start time", + "format": "google-datetime", + "type": "string" + }, + "rolloutState": { + "description": "State of the rollout", + "enum": [ + "ROLLOUT_STATE_UNSPECIFIED", + "IN_PROGRESS", + "CANCELLING", + "CANCELLED", + "SUCCEEDED" + ], + "enumDescriptions": [ + "Invalid value", + "The rollout is in progress.", + "The rollout is being cancelled.", + "The rollout is cancelled.", + "The rollout has completed successfully." + ], + "type": "string" + }, + "rolloutUpdateTime": { + "description": "Rollout update time", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudOsconfigV2beta__OperationMetadata": { + "description": "Represents the metadata of the long-running operation.", + "id": "GoogleCloudOsconfigV2beta__OperationMetadata", + "properties": { + "apiVersion": { + "description": "Output only. API version used to start the operation.", + "readOnly": true, + "type": "string" + }, + "createTime": { + "description": "Output only. The time the operation was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "endTime": { + "description": "Output only. The time the operation finished running.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "requestedCancellation": { + "description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "readOnly": true, + "type": "boolean" + }, + "statusMessage": { + "description": "Output only. Human-readable status of the operation, if any.", + "readOnly": true, + "type": "string" + }, + "target": { + "description": "Output only. Server-defined resource path for the target of the operation.", + "readOnly": true, + "type": "string" + }, + "verb": { + "description": "Output only. Name of the verb executed by the operation.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ListOperationsResponse": { + "description": "The response message for Operations.ListOperations.", + "id": "ListOperationsResponse", + "properties": { + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + }, + "operations": { + "description": "A list of operations that matches the specified filter in the request.", + "items": { + "$ref": "Operation" + }, + "type": "array" + } + }, + "type": "object" + }, + "OSPolicyAssignmentOperationMetadata": { + "description": "OS policy assignment operation metadata provided by OS policy assignment API methods that return long running operations.", + "id": "OSPolicyAssignmentOperationMetadata", + "properties": { + "apiMethod": { + "description": "The OS policy assignment API method.", + "enum": [ + "API_METHOD_UNSPECIFIED", + "CREATE", + "UPDATE", + "DELETE" + ], + "enumDescriptions": [ + "Invalid value", + "Create OS policy assignment API method", + "Update OS policy assignment API method", + "Delete OS policy assignment API method" + ], + "type": "string" + }, + "osPolicyAssignment": { + "description": "Reference to the `OSPolicyAssignment` API resource. Format: `projects/{project_number}/locations/{location}/osPolicyAssignments/{os_policy_assignment_id@revision_id}`", + "type": "string" + }, + "rolloutStartTime": { + "description": "Rollout start time", + "format": "google-datetime", + "type": "string" + }, + "rolloutState": { + "description": "State of the rollout", + "enum": [ + "ROLLOUT_STATE_UNSPECIFIED", + "IN_PROGRESS", + "CANCELLING", + "CANCELLED", + "SUCCEEDED" + ], + "enumDescriptions": [ + "Invalid value", + "The rollout is in progress.", + "The rollout is being cancelled.", + "The rollout is cancelled.", + "The rollout has completed successfully." + ], + "type": "string" + }, + "rolloutUpdateTime": { + "description": "Rollout update time", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "Operation": { + "description": "This resource represents a long-running operation that is the result of a network API call.", + "id": "Operation", + "properties": { + "done": { + "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.", + "type": "boolean" + }, + "error": { + "$ref": "Status", + "description": "The error result of the operation in case of failure or cancellation." + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.", + "type": "object" + }, + "name": { + "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.", + "type": "string" + }, + "response": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", + "type": "object" + } + }, + "type": "object" + }, + "Status": { + "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", + "id": "Status", + "properties": { + "code": { + "description": "The status code, which should be an enum value of google.rpc.Code.", + "format": "int32", + "type": "integer" + }, + "details": { + "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", + "type": "string" + } + }, + "type": "object" + } + }, + "servicePath": "", + "title": "OS Config API", + "version": "v2beta", + "version_module": true +} \ No newline at end of file diff --git a/DiscoveryJson/places.v1.json b/DiscoveryJson/places.v1.json index 9cd5421ee4e..b41816a6186 100644 --- a/DiscoveryJson/places.v1.json +++ b/DiscoveryJson/places.v1.json @@ -280,7 +280,7 @@ } } }, - "revision": "20241022", + "revision": "20241028", "rootUrl": "https://places.googleapis.com/", "schemas": { "GoogleGeoTypeViewport": { @@ -957,6 +957,14 @@ }, "type": "array" }, + "flagContentUri": { + "description": "A link where users can flag a problem with the photo.", + "type": "string" + }, + "googleMapsUri": { + "description": "A link to show the photo on Google Maps.", + "type": "string" + }, "heightPx": { "description": "The maximum available height, in pixels.", "format": "int32", @@ -1102,6 +1110,10 @@ "description": "Place is suitable for watching sports.", "type": "boolean" }, + "googleMapsLinks": { + "$ref": "GoogleMapsPlacesV1PlaceGoogleMapsLinks", + "description": "Links to trigger different Google Maps actions." + }, "googleMapsUri": { "description": "A URL providing more information about this place.", "type": "string" @@ -1366,6 +1378,10 @@ "$ref": "GoogleMapsPlacesV1ContentBlock" }, "type": "array" + }, + "flagContentUri": { + "description": "A link where users can flag a problem with the summary.", + "type": "string" } }, "type": "object" @@ -1393,10 +1409,18 @@ "$ref": "GoogleTypeLocalizedText", "description": "The detailed description of the place." }, + "descriptionFlagContentUri": { + "description": "A link where users can flag a problem with the description summary.", + "type": "string" + }, "overview": { "$ref": "GoogleTypeLocalizedText", "description": "The overview of the place." }, + "overviewFlagContentUri": { + "description": "A link where users can flag a problem with the overview summary.", + "type": "string" + }, "references": { "$ref": "GoogleMapsPlacesV1References", "description": "References that are used to generate the summary description." @@ -1404,6 +1428,33 @@ }, "type": "object" }, + "GoogleMapsPlacesV1PlaceGoogleMapsLinks": { + "description": "Links to trigger different Google Maps actions.", + "id": "GoogleMapsPlacesV1PlaceGoogleMapsLinks", + "properties": { + "directionsUri": { + "description": "A link to show the directions to the place. The link only populates the destination location and uses the default travel mode `DRIVE`.", + "type": "string" + }, + "photosUri": { + "description": "A link to show photos of this place. This link is currently not supported on Google Maps Mobile and only works on the web version of Google Maps.", + "type": "string" + }, + "placeUri": { + "description": "A link to show this place.", + "type": "string" + }, + "reviewsUri": { + "description": "A link to show reviews of this place. This link is currently not supported on Google Maps Mobile and only works on the web version of Google Maps.", + "type": "string" + }, + "writeAReviewUri": { + "description": "A link to write a review for this place. This link is currently not supported on Google Maps Mobile and only works on the web version of Google Maps.", + "type": "string" + } + }, + "type": "object" + }, "GoogleMapsPlacesV1PlaceOpeningHours": { "description": "Information about business hour of the place.", "id": "GoogleMapsPlacesV1PlaceOpeningHours", @@ -1656,6 +1707,14 @@ "$ref": "GoogleMapsPlacesV1AuthorAttribution", "description": "This review's author." }, + "flagContentUri": { + "description": "A link where users can flag a problem with the review.", + "type": "string" + }, + "googleMapsUri": { + "description": "A link to show the review on Google Maps.", + "type": "string" + }, "name": { "description": "A reference representing this place review which may be used to look up this place review again (also called the API \"resource\" name: `places/{place_id}/reviews/{review}`).", "type": "string" @@ -1761,6 +1820,10 @@ "description": "The duration and distance from the routing origin to a place in the response, and a second leg from that place to the destination, if requested. **Note:** Adding `routingSummaries` in the field mask without also including either the `routingParameters.origin` parameter or the `searchAlongRouteParameters.polyline.encodedPolyline` parameter in the request causes an error.", "id": "GoogleMapsPlacesV1RoutingSummary", "properties": { + "directionsUri": { + "description": "A link to show directions on Google Maps using the waypoints from the given routing summary. The route generated by this link is not guaranteed to be the same as the route used to generate the routing summary. The link uses information provided in the request, from fields including `routingParameters` and `searchAlongRouteParameters` when applicable, to generate the directions link.", + "type": "string" + }, "legs": { "description": "The legs of the trip. When you calculate travel duration and distance from a set origin, `legs` contains a single leg containing the duration and distance from the origin to the destination. When you do a search along route, `legs` contains two legs: one from the origin to place, and one from the place to the destination.", "items": { @@ -2106,6 +2169,10 @@ "$ref": "GoogleMapsPlacesV1RoutingSummary" }, "type": "array" + }, + "searchUri": { + "description": "A link allows the user to search with the same text query as specified in the request on Google Maps.", + "type": "string" } }, "type": "object" diff --git a/DiscoveryJson/retail.v2.json b/DiscoveryJson/retail.v2.json index 0591cd497ce..f537b1a66d3 100644 --- a/DiscoveryJson/retail.v2.json +++ b/DiscoveryJson/retail.v2.json @@ -2246,7 +2246,7 @@ } } }, - "revision": "20241017", + "revision": "20241024", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -4041,6 +4041,41 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2PinControlMetadata": { + "description": "Metadata for pinning to be returned in the response. This is used for distinguishing between applied vs dropped pins.", + "id": "GoogleCloudRetailV2PinControlMetadata", + "properties": { + "allMatchedPins": { + "additionalProperties": { + "$ref": "GoogleCloudRetailV2PinControlMetadataProductPins" + }, + "description": "Map of all matched pins, keyed by pin position.", + "type": "object" + }, + "droppedPins": { + "additionalProperties": { + "$ref": "GoogleCloudRetailV2PinControlMetadataProductPins" + }, + "description": "Map of pins that were dropped due to overlap with other matching pins, keyed by pin position.", + "type": "object" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2PinControlMetadataProductPins": { + "description": "List of product ids which have associated pins.", + "id": "GoogleCloudRetailV2PinControlMetadataProductPins", + "properties": { + "productId": { + "description": "List of product ids which have associated pins.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudRetailV2PredictRequest": { "description": "Request message for Predict method.", "id": "GoogleCloudRetailV2PredictRequest", @@ -5504,6 +5539,10 @@ "description": "A token that can be sent as SearchRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, + "pinControlMetadata": { + "$ref": "GoogleCloudRetailV2PinControlMetadata", + "description": "Metadata for pin controls which were applicable to the request. This contains two map fields, one for all matched pins and one for pins which were matched but not applied. The two maps are keyed by pin position, and the values are the product ids which were matched to that pin." + }, "queryExpansionInfo": { "$ref": "GoogleCloudRetailV2SearchResponseQueryExpansionInfo", "description": "Query expansion information for the returned results." diff --git a/DiscoveryJson/retail.v2alpha.json b/DiscoveryJson/retail.v2alpha.json index baa320e7762..64c66af6841 100644 --- a/DiscoveryJson/retail.v2alpha.json +++ b/DiscoveryJson/retail.v2alpha.json @@ -2767,7 +2767,7 @@ } } }, - "revision": "20241017", + "revision": "20241024", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -5864,6 +5864,41 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2alphaPinControlMetadata": { + "description": "Metadata for pinning to be returned in the response. This is used for distinguishing between applied vs dropped pins.", + "id": "GoogleCloudRetailV2alphaPinControlMetadata", + "properties": { + "allMatchedPins": { + "additionalProperties": { + "$ref": "GoogleCloudRetailV2alphaPinControlMetadataProductPins" + }, + "description": "Map of all matched pins, keyed by pin position.", + "type": "object" + }, + "droppedPins": { + "additionalProperties": { + "$ref": "GoogleCloudRetailV2alphaPinControlMetadataProductPins" + }, + "description": "Map of pins that were dropped due to overlap with other matching pins, keyed by pin position.", + "type": "object" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2alphaPinControlMetadataProductPins": { + "description": "List of product ids which have associated pins.", + "id": "GoogleCloudRetailV2alphaPinControlMetadataProductPins", + "properties": { + "productId": { + "description": "List of product ids which have associated pins.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudRetailV2alphaPredictRequest": { "description": "Request message for Predict method.", "id": "GoogleCloudRetailV2alphaPredictRequest", @@ -7375,6 +7410,10 @@ "description": "A token that can be sent as SearchRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, + "pinControlMetadata": { + "$ref": "GoogleCloudRetailV2alphaPinControlMetadata", + "description": "Metadata for pin controls which were applicable to the request. This contains two map fields, one for all matched pins and one for pins which were matched but not applied. The two maps are keyed by pin position, and the values are the product ids which were matched to that pin." + }, "queryExpansionInfo": { "$ref": "GoogleCloudRetailV2alphaSearchResponseQueryExpansionInfo", "description": "Query expansion information for the returned results." diff --git a/DiscoveryJson/securitycenter.v1.json b/DiscoveryJson/securitycenter.v1.json index fda8866f43f..d709f4711bf 100644 --- a/DiscoveryJson/securitycenter.v1.json +++ b/DiscoveryJson/securitycenter.v1.json @@ -1509,6 +1509,7 @@ ], "parameters": { "compareDuration": { + "deprecated": true, "description": "When compare_duration is set, the ListFindingsResult's \"state_change\" attribute is updated to indicate whether the finding had its state changed, the finding's state remained unchanged, or if the finding was added in any state during the compare_duration period of time that precedes the read_time. This is the time between (read_time - compare_duration) and read_time. The state_change value is derived based on the presence and state of the finding at the two points in time. Intermediate state changes between the two times don't affect the result. For example, the results aren't affected if the finding is made inactive and then active again. Possible \"state_change\" values when compare_duration is specified: * \"CHANGED\": indicates that the finding was present and matched the given filter at the start of compare_duration, but changed its state at read_time. * \"UNCHANGED\": indicates that the finding was present and matched the given filter at the start of compare_duration and did not change state at read_time. * \"ADDED\": indicates that the finding did not match the given filter or was not present at the start of compare_duration, but was present at read_time. * \"REMOVED\": indicates that the finding was present and matched the filter at the start of compare_duration, but did not match the filter at read_time. If compare_duration is not specified, then the only possible state_change is \"UNUSED\", which will be the state_change set for all findings present at read_time.", "format": "google-duration", "location": "query", @@ -1549,6 +1550,7 @@ "type": "string" }, "readTime": { + "deprecated": true, "description": "Time used as a reference point when filtering findings. The filter is limited to findings existing at the supplied time and their values are those at that specific time. Absence of this field will default to the API's version of NOW.", "format": "google-datetime", "location": "query", @@ -3989,6 +3991,7 @@ ], "parameters": { "compareDuration": { + "deprecated": true, "description": "When compare_duration is set, the ListFindingsResult's \"state_change\" attribute is updated to indicate whether the finding had its state changed, the finding's state remained unchanged, or if the finding was added in any state during the compare_duration period of time that precedes the read_time. This is the time between (read_time - compare_duration) and read_time. The state_change value is derived based on the presence and state of the finding at the two points in time. Intermediate state changes between the two times don't affect the result. For example, the results aren't affected if the finding is made inactive and then active again. Possible \"state_change\" values when compare_duration is specified: * \"CHANGED\": indicates that the finding was present and matched the given filter at the start of compare_duration, but changed its state at read_time. * \"UNCHANGED\": indicates that the finding was present and matched the given filter at the start of compare_duration and did not change state at read_time. * \"ADDED\": indicates that the finding did not match the given filter or was not present at the start of compare_duration, but was present at read_time. * \"REMOVED\": indicates that the finding was present and matched the filter at the start of compare_duration, but did not match the filter at read_time. If compare_duration is not specified, then the only possible state_change is \"UNUSED\", which will be the state_change set for all findings present at read_time.", "format": "google-duration", "location": "query", @@ -4029,6 +4032,7 @@ "type": "string" }, "readTime": { + "deprecated": true, "description": "Time used as a reference point when filtering findings. The filter is limited to findings existing at the supplied time and their values are those at that specific time. Absence of this field will default to the API's version of NOW.", "format": "google-datetime", "location": "query", @@ -5656,6 +5660,7 @@ ], "parameters": { "compareDuration": { + "deprecated": true, "description": "When compare_duration is set, the ListFindingsResult's \"state_change\" attribute is updated to indicate whether the finding had its state changed, the finding's state remained unchanged, or if the finding was added in any state during the compare_duration period of time that precedes the read_time. This is the time between (read_time - compare_duration) and read_time. The state_change value is derived based on the presence and state of the finding at the two points in time. Intermediate state changes between the two times don't affect the result. For example, the results aren't affected if the finding is made inactive and then active again. Possible \"state_change\" values when compare_duration is specified: * \"CHANGED\": indicates that the finding was present and matched the given filter at the start of compare_duration, but changed its state at read_time. * \"UNCHANGED\": indicates that the finding was present and matched the given filter at the start of compare_duration and did not change state at read_time. * \"ADDED\": indicates that the finding did not match the given filter or was not present at the start of compare_duration, but was present at read_time. * \"REMOVED\": indicates that the finding was present and matched the filter at the start of compare_duration, but did not match the filter at read_time. If compare_duration is not specified, then the only possible state_change is \"UNUSED\", which will be the state_change set for all findings present at read_time.", "format": "google-duration", "location": "query", @@ -5696,6 +5701,7 @@ "type": "string" }, "readTime": { + "deprecated": true, "description": "Time used as a reference point when filtering findings. The filter is limited to findings existing at the supplied time and their values are those at that specific time. Absence of this field will default to the API's version of NOW.", "format": "google-datetime", "location": "query", @@ -5887,7 +5893,7 @@ } } }, - "revision": "20241018", + "revision": "20241026", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -12034,6 +12040,7 @@ "id": "GroupFindingsRequest", "properties": { "compareDuration": { + "deprecated": true, "description": "When compare_duration is set, the GroupResult's \"state_change\" attribute is updated to indicate whether the finding had its state changed, the finding's state remained unchanged, or if the finding was added during the compare_duration period of time that precedes the read_time. This is the time between (read_time - compare_duration) and read_time. The state_change value is derived based on the presence and state of the finding at the two points in time. Intermediate state changes between the two times don't affect the result. For example, the results aren't affected if the finding is made inactive and then active again. Possible \"state_change\" values when compare_duration is specified: * \"CHANGED\": indicates that the finding was present and matched the given filter at the start of compare_duration, but changed its state at read_time. * \"UNCHANGED\": indicates that the finding was present and matched the given filter at the start of compare_duration and did not change state at read_time. * \"ADDED\": indicates that the finding did not match the given filter or was not present at the start of compare_duration, but was present at read_time. * \"REMOVED\": indicates that the finding was present and matched the filter at the start of compare_duration, but did not match the filter at read_time. If compare_duration is not specified, then the only possible state_change is \"UNUSED\", which will be the state_change set for all findings present at read_time. If this field is set then `state_change` must be a specified field in `group_by`.", "format": "google-duration", "type": "string" @@ -12056,6 +12063,7 @@ "type": "string" }, "readTime": { + "deprecated": true, "description": "Time used as a reference point when filtering findings. The filter is limited to findings existing at the supplied time and their values are those at that specific time. Absence of this field will default to the API's version of NOW.", "format": "google-datetime", "type": "string" @@ -13936,6 +13944,7 @@ "id": "SetFindingStateRequest", "properties": { "startTime": { + "deprecated": true, "description": "Optional. The time at which the updated state takes effect. If unset, defaults to the request time.", "format": "google-datetime", "type": "string" diff --git a/DiscoveryJson/securitycenter.v1beta1.json b/DiscoveryJson/securitycenter.v1beta1.json index 46b2c19951b..f381994ef44 100644 --- a/DiscoveryJson/securitycenter.v1beta1.json +++ b/DiscoveryJson/securitycenter.v1beta1.json @@ -913,7 +913,7 @@ } } }, - "revision": "20241018", + "revision": "20241026", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -8233,7 +8233,7 @@ "id": "SetFindingStateRequest", "properties": { "startTime": { - "description": "Required. The time at which the updated state takes effect.", + "description": "Optional. The time at which the updated state takes effect. If not set uses the current time.", "format": "google-datetime", "type": "string" }, diff --git a/DiscoveryJson/spanner.v1.json b/DiscoveryJson/spanner.v1.json index 0a63e54662e..d961d60e6c7 100644 --- a/DiscoveryJson/spanner.v1.json +++ b/DiscoveryJson/spanner.v1.json @@ -1044,7 +1044,7 @@ "type": "string" }, "encryptionConfig.kmsKeyNames": { - "description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by kms_key_names must fully cover all regions of the backup's instance configuration. Some examples: * For single region instance configs, specify a single regional location KMS key. * For multi-regional instance configs of type GOOGLE_MANAGED, either specify a multi-regional location KMS key or multiple regional location KMS keys that cover all regions in the instance config. * For an instance config of type USER_MANAGED, please specify only regional location KMS keys to cover each region in the instance config. Multi-regional location KMS keys are not supported for USER_MANAGED instance configs.", + "description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.", "location": "query", "repeated": true, "type": "string" @@ -1122,7 +1122,7 @@ ] }, "getIamPolicy": { - "description": "Gets the access control policy for a database or backup resource. Returns an empty policy if a database or backup exists but does not have a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource.", + "description": "Gets the access control policy for a database or backup resource. Returns an empty policy if a database or backup exists but does not have a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.getIamPolicy` permission on resource.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/backups/{backupsId}:getIamPolicy", "httpMethod": "POST", "id": "spanner.projects.instances.backups.getIamPolicy", @@ -1228,7 +1228,7 @@ ] }, "setIamPolicy": { - "description": "Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource.", + "description": "Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.setIamPolicy` permission on resource.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/backups/{backupsId}:setIamPolicy", "httpMethod": "POST", "id": "spanner.projects.instances.backups.setIamPolicy", @@ -1257,7 +1257,7 @@ ] }, "testIamPermissions": { - "description": "Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance.", + "description": "Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance. Calling this method on a backup schedule that does not exist will result in a NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on the containing database.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/backups/{backupsId}:testIamPermissions", "httpMethod": "POST", "id": "spanner.projects.instances.backups.testIamPermissions", @@ -1425,7 +1425,7 @@ ], "parameters": { "filter": { - "description": "An expression that filters the list of returned operations. A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`. Colon `:` is the contains operator. Filter rules are not case sensitive. The following fields in the Operation are eligible for filtering: * `name` - The name of the long-running operation * `done` - False if the operation is in progress, else true. * `metadata.@type` - the type of metadata. For example, the type string for RestoreDatabaseMetadata is `type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata`. * `metadata.` - any field in metadata.value. `metadata.@type` must be specified first, if filtering on metadata fields. * `error` - Error associated with the long-running operation. * `response.@type` - the type of response. * `response.` - any field in response.value. You can combine multiple expressions by enclosing each expression in parentheses. By default, expressions are combined with AND logic. However, you can specify AND, OR, and NOT logic explicitly. Here are a few examples: * `done:true` - The operation is complete. * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata) AND` \\ `(metadata.source_type:BACKUP) AND` \\ `(metadata.backup_info.backup:backup_howl) AND` \\ `(metadata.name:restored_howl) AND` \\ `(metadata.progress.start_time < \\\"2018-03-28T14:50:00Z\\\") AND` \\ `(error:*)` - Return operations where: * The operation's metadata type is RestoreDatabaseMetadata. * The database is restored from a backup. * The backup name contains \"backup_howl\". * The restored database's name contains \"restored_howl\". * The operation started before 2018-03-28T14:50:00Z. * The operation resulted in an error.", + "description": "An expression that filters the list of returned operations. A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`. Colon `:` is the contains operator. Filter rules are not case sensitive. The following fields in the operation are eligible for filtering: * `name` - The name of the long-running operation * `done` - False if the operation is in progress, else true. * `metadata.@type` - the type of metadata. For example, the type string for RestoreDatabaseMetadata is `type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata`. * `metadata.` - any field in metadata.value. `metadata.@type` must be specified first, if filtering on metadata fields. * `error` - Error associated with the long-running operation. * `response.@type` - the type of response. * `response.` - any field in response.value. You can combine multiple expressions by enclosing each expression in parentheses. By default, expressions are combined with AND logic. However, you can specify AND, OR, and NOT logic explicitly. Here are a few examples: * `done:true` - The operation is complete. * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata) AND` \\ `(metadata.source_type:BACKUP) AND` \\ `(metadata.backup_info.backup:backup_howl) AND` \\ `(metadata.name:restored_howl) AND` \\ `(metadata.progress.start_time < \\\"2018-03-28T14:50:00Z\\\") AND` \\ `(error:*)` - Return operations where: * The operation's metadata type is RestoreDatabaseMetadata. * The database is restored from a backup. * The backup name contains \"backup_howl\". * The restored database's name contains \"restored_howl\". * The operation started before 2018-03-28T14:50:00Z. * The operation resulted in an error.", "location": "query", "type": "string" }, @@ -1598,7 +1598,7 @@ ] }, "getIamPolicy": { - "description": "Gets the access control policy for a database or backup resource. Returns an empty policy if a database or backup exists but does not have a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource.", + "description": "Gets the access control policy for a database or backup resource. Returns an empty policy if a database or backup exists but does not have a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.getIamPolicy` permission on resource.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}:getIamPolicy", "httpMethod": "POST", "id": "spanner.projects.instances.databases.getIamPolicy", @@ -1781,7 +1781,7 @@ ] }, "setIamPolicy": { - "description": "Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource.", + "description": "Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.setIamPolicy` permission on resource.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}:setIamPolicy", "httpMethod": "POST", "id": "spanner.projects.instances.databases.setIamPolicy", @@ -1810,7 +1810,7 @@ ] }, "testIamPermissions": { - "description": "Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance.", + "description": "Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance. Calling this method on a backup schedule that does not exist will result in a NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on the containing database.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}:testIamPermissions", "httpMethod": "POST", "id": "spanner.projects.instances.databases.testIamPermissions", @@ -1958,7 +1958,7 @@ ] }, "getIamPolicy": { - "description": "Gets the access control policy for a database or backup resource. Returns an empty policy if a database or backup exists but does not have a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource.", + "description": "Gets the access control policy for a database or backup resource. Returns an empty policy if a database or backup exists but does not have a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.getIamPolicy` permission on resource.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/backupSchedules/{backupSchedulesId}:getIamPolicy", "httpMethod": "POST", "id": "spanner.projects.instances.databases.backupSchedules.getIamPolicy", @@ -2059,7 +2059,7 @@ ] }, "setIamPolicy": { - "description": "Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource.", + "description": "Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.setIamPolicy` permission on resource.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/backupSchedules/{backupSchedulesId}:setIamPolicy", "httpMethod": "POST", "id": "spanner.projects.instances.databases.backupSchedules.setIamPolicy", @@ -2088,7 +2088,7 @@ ] }, "testIamPermissions": { - "description": "Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance.", + "description": "Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance. Calling this method on a backup schedule that does not exist will result in a NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on the containing database.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/backupSchedules/{backupSchedulesId}:testIamPermissions", "httpMethod": "POST", "id": "spanner.projects.instances.databases.backupSchedules.testIamPermissions", @@ -2158,7 +2158,7 @@ ] }, "testIamPermissions": { - "description": "Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance.", + "description": "Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance. Calling this method on a backup schedule that does not exist will result in a NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on the containing database.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/databaseRoles/{databaseRolesId}:testIamPermissions", "httpMethod": "POST", "id": "spanner.projects.instances.databases.databaseRoles.testIamPermissions", @@ -3319,7 +3319,7 @@ } } }, - "revision": "20241010", + "revision": "20241020", "rootUrl": "https://spanner.googleapis.com/", "schemas": { "AsymmetricAutoscalingOption": { @@ -3462,7 +3462,7 @@ "readOnly": true }, "encryptionInformation": { - "description": "Output only. The encryption information for the backup, whether it is protected by one or more KMS keys. The information includes all Cloud KMS key versions used to encrypt the backup. The `encryption_status' field inside of each `EncryptionInfo` is not populated. At least one of the key versions must be available for the backup to be restored. If a key version is revoked in the middle of a restore, the restore behavior is undefined.", + "description": "Output only. The encryption information for the backup, whether it is protected by one or more KMS keys. The information includes all Cloud KMS key versions used to encrypt the backup. The `encryption_status` field inside of each `EncryptionInfo` is not populated. At least one of the key versions must be available for the backup to be restored. If a key version is revoked in the middle of a restore, the restore behavior is undefined.", "items": { "$ref": "EncryptionInfo" }, @@ -3706,6 +3706,10 @@ "description": "The request for BeginTransaction.", "id": "BeginTransactionRequest", "properties": { + "mutationKey": { + "$ref": "Mutation", + "description": "Optional. Required for read-write transactions on a multiplexed session that commit mutations but do not perform any reads or queries. Clients should randomly select one of the mutations from the mutation set and send it as a part of this request." + }, "options": { "$ref": "TransactionOptions", "description": "Required. Options for the new transaction." @@ -3815,6 +3819,10 @@ }, "type": "array" }, + "precommitToken": { + "$ref": "MultiplexedSessionPrecommitToken", + "description": "Optional. If the read-write transaction was executed on a multiplexed session, the precommit token with the highest sequence number received in this transaction attempt, should be included here. Failing to do so will result in a FailedPrecondition error." + }, "requestOptions": { "$ref": "RequestOptions", "description": "Common options for this request." @@ -3847,6 +3855,10 @@ "description": "The Cloud Spanner timestamp at which the transaction committed.", "format": "google-datetime", "type": "string" + }, + "precommitToken": { + "$ref": "MultiplexedSessionPrecommitToken", + "description": "If specified, transaction has not committed yet. Clients must retry the commit with the new precommit token." } }, "type": "object" @@ -3926,7 +3938,7 @@ "type": "string" }, "kmsKeyNames": { - "description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. Kms keys specified can be in any order. The keys referenced by kms_key_names must fully cover all regions of the backup's instance configuration. Some examples: * For single region instance configs, specify a single regional location KMS key. * For multi-regional instance configs of type GOOGLE_MANAGED, either specify a multi-regional location KMS key or multiple regional location KMS keys that cover all regions in the instance config. * For an instance config of type USER_MANAGED, please specify only regional location KMS keys to cover each region in the instance config. Multi-regional location KMS keys are not supported for USER_MANAGED instance configs.", + "description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. KMS keys specified can be in any order. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.", "items": { "type": "string" }, @@ -4008,7 +4020,7 @@ "type": "string" }, "kmsKeyNames": { - "description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by kms_key_names must fully cover all regions of the backup's instance configuration. Some examples: * For single region instance configs, specify a single regional location KMS key. * For multi-regional instance configs of type GOOGLE_MANAGED, either specify a multi-regional location KMS key or multiple regional location KMS keys that cover all regions in the instance config. * For an instance config of type USER_MANAGED, please specify only regional location KMS keys to cover each region in the instance config. Multi-regional location KMS keys are not supported for USER_MANAGED instance configs.", + "description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.", "items": { "type": "string" }, @@ -4307,7 +4319,7 @@ "readOnly": true }, "encryptionInfo": { - "description": "Output only. For databases that are using customer managed encryption, this field contains the encryption information for the database, such as all Cloud KMS key versions that are in use. The `encryption_status' field inside of each `EncryptionInfo` is not populated. For databases that are using Google default or other types of encryption, this field is empty. This field is propagated lazily from the backend. There might be a delay from when a key version is being used and when it appears in this field.", + "description": "Output only. For databases that are using customer managed encryption, this field contains the encryption information for the database, such as all Cloud KMS key versions that are in use. The `encryption_status` field inside of each `EncryptionInfo` is not populated. For databases that are using Google default or other types of encryption, this field is empty. This field is propagated lazily from the backend. There might be a delay from when a key version is being used and when it appears in this field.", "items": { "$ref": "EncryptionInfo" }, @@ -4498,7 +4510,7 @@ "type": "string" }, "kmsKeyNames": { - "description": "Specifies the KMS configuration for the one or more keys used to encrypt the database. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by kms_key_names must fully cover all regions of the database instance configuration. Some examples: * For single region database instance configs, specify a single regional location KMS key. * For multi-regional database instance configs of type GOOGLE_MANAGED, either specify a multi-regional location KMS key or multiple regional location KMS keys that cover all regions in the instance config. * For a database instance config of type USER_MANAGED, please specify only regional location KMS keys to cover each region in the instance config. Multi-regional location KMS keys are not supported for USER_MANAGED instance configs.", + "description": "Specifies the KMS configuration for one or more keys used to encrypt the database. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the database's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.", "items": { "type": "string" }, @@ -4584,6 +4596,10 @@ "description": "The response for ExecuteBatchDml. Contains a list of ResultSet messages, one for each DML statement that has successfully executed, in the same order as the statements in the request. If a statement fails, the status in the response body identifies the cause of the failure. To check for DML statements that failed, use the following approach: 1. Check the status in the response message. The google.rpc.Code enum value `OK` indicates that all statements were executed successfully. 2. If the status was not `OK`, check the number of result sets in the response. If the response contains `N` ResultSet messages, then statement `N+1` in the request failed. Example 1: * Request: 5 DML statements, all executed successfully. * Response: 5 ResultSet messages, with the status `OK`. Example 2: * Request: 5 DML statements. The third statement has a syntax error. * Response: 2 ResultSet messages, and a syntax error (`INVALID_ARGUMENT`) status. The number of ResultSet messages indicates that the third statement failed, and the fourth and fifth statements were not executed.", "id": "ExecuteBatchDmlResponse", "properties": { + "precommitToken": { + "$ref": "MultiplexedSessionPrecommitToken", + "description": "Optional. A precommit token will be included if the read-write transaction is on a multiplexed session. The precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction." + }, "resultSets": { "description": "One ResultSet for each statement in the request that ran successfully, in the same order as the statements in the request. Each ResultSet does not contain any rows. The ResultSetStats in each ResultSet contain the number of rows modified by the statement. Only the first ResultSet in the response contains valid ResultSetMetadata.", "items": { @@ -4886,6 +4902,20 @@ "readOnly": true, "type": "string" }, + "defaultBackupScheduleType": { + "description": "Optional. Controls the default backup behavior for new databases within the instance. Note that `AUTOMATIC` is not permitted for free instances, as backups and backup schedules are not allowed for free instances. In the `GetInstance` or `ListInstances` response, if the value of default_backup_schedule_type is unset or NONE, no default backup schedule will be created for new databases within the instance.", + "enum": [ + "DEFAULT_BACKUP_SCHEDULE_TYPE_UNSPECIFIED", + "NONE", + "AUTOMATIC" + ], + "enumDescriptions": [ + "Not specified.", + "No default backup schedule will be created automatically on creation of a database within the instance.", + "A default backup schedule will be created automatically on creation of a database within the instance. The default backup schedule creates a full backup every 24 hours and retains the backup for a period of 7 days. Once created, the default backup schedule can be edited/deleted similar to any other backup schedule." + ], + "type": "string" + }, "displayName": { "description": "Required. The descriptive name for this instance as it appears in UIs. Must be unique per project and between 4 and 30 characters in length.", "type": "string" @@ -4943,12 +4973,12 @@ "type": "string" }, "nodeCount": { - "description": "The number of nodes allocated to this instance. At most, one of either `node_count` or `processing_units` should be present in the message. Users can set the `node_count` field to specify the target number of nodes allocated to the instance. If autoscaling is enabled, `node_count` is treated as an `OUTPUT_ONLY` field and reflects the current number of nodes allocated to the instance. This might be zero in API responses for instances that are not yet in the `READY` state. If the instance has varying node count across replicas (achieved by setting asymmetric_autoscaling_options in autoscaling config), the node_count here is the maximum node count across all replicas. For more information, see [Compute capacity, nodes, and processing units](https://cloud.google.com/spanner/docs/compute-capacity).", + "description": "The number of nodes allocated to this instance. At most, one of either `node_count` or `processing_units` should be present in the message. Users can set the `node_count` field to specify the target number of nodes allocated to the instance. If autoscaling is enabled, `node_count` is treated as an `OUTPUT_ONLY` field and reflects the current number of nodes allocated to the instance. This might be zero in API responses for instances that are not yet in the `READY` state. For more information, see [Compute capacity, nodes, and processing units](https://cloud.google.com/spanner/docs/compute-capacity).", "format": "int32", "type": "integer" }, "processingUnits": { - "description": "The number of processing units allocated to this instance. At most, one of either `processing_units` or `node_count` should be present in the message. Users can set the `processing_units` field to specify the target number of processing units allocated to the instance. If autoscaling is enabled, `processing_units` is treated as an `OUTPUT_ONLY` field and reflects the current number of processing units allocated to the instance. This might be zero in API responses for instances that are not yet in the `READY` state. If the instance has varying processing units per replica (achieved by setting asymmetric_autoscaling_options in autoscaling config), the processing_units here is the maximum processing units across all replicas. For more information, see [Compute capacity, nodes and processing units](https://cloud.google.com/spanner/docs/compute-capacity).", + "description": "The number of processing units allocated to this instance. At most, one of either `processing_units` or `node_count` should be present in the message. Users can set the `processing_units` field to specify the target number of processing units allocated to the instance. If autoscaling is enabled, `processing_units` is treated as an `OUTPUT_ONLY` field and reflects the current number of processing units allocated to the instance. This might be zero in API responses for instances that are not yet in the `READY` state. For more information, see [Compute capacity, nodes and processing units](https://cloud.google.com/spanner/docs/compute-capacity).", "format": "int32", "type": "integer" }, @@ -5905,6 +5935,10 @@ "$ref": "ResultSetMetadata", "description": "Metadata about the result set, such as row type information. Only present in the first response." }, + "precommitToken": { + "$ref": "MultiplexedSessionPrecommitToken", + "description": "Optional. A precommit token will be included if the read-write transaction is on a multiplexed session. The precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction." + }, "resumeToken": { "description": "Streaming calls might be interrupted for a variety of reasons, such as TCP connection loss. If this occurs, the stream of results can be resumed by re-sending the original request and including `resume_token`. Note that executing any other transaction in the same session invalidates the token.", "format": "byte", @@ -6380,6 +6414,11 @@ "description": "Message type to initiate a read-write transaction. Currently this transaction type has no options.", "id": "ReadWrite", "properties": { + "multiplexedSessionPreviousTransactionId": { + "description": "Optional. Clients should pass the transaction ID of the previous transaction attempt that was aborted if this transaction is being executed on a multiplexed session.", + "format": "byte", + "type": "string" + }, "readLockMode": { "description": "Read lock mode for the transaction.", "enum": [ @@ -6529,7 +6568,7 @@ "type": "string" }, "kmsKeyNames": { - "description": "Optional. Specifies the KMS configuration for the one or more keys used to encrypt the database. Values have the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by kms_key_names must fully cover all regions of the database instance configuration. Some examples: * For single region database instance configurations, specify a single regional location KMS key. * For multi-regional database instance configurations of type `GOOGLE_MANAGED`, either specify a multi-regional location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For a database instance configuration of type `USER_MANAGED`, please specify only regional location KMS keys to cover each region in the instance configuration. Multi-regional location KMS keys are not supported for USER_MANAGED instance configurations.", + "description": "Optional. Specifies the KMS configuration for one or more keys used to encrypt the database. Values have the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the database's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.", "items": { "type": "string" }, @@ -6628,6 +6667,10 @@ "$ref": "ResultSetMetadata", "description": "Metadata about the result set, such as row type information." }, + "precommitToken": { + "$ref": "MultiplexedSessionPrecommitToken", + "description": "Optional. A precommit token will be included if the read-write transaction is on a multiplexed session. The precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction." + }, "rows": { "description": "Each element in `rows` is a row whose format is defined by metadata.row_type. The ith element in each row matches the ith field in metadata.row_type. Elements are encoded based on type as described here.", "items": { @@ -7122,7 +7165,7 @@ "id": "UpdateDatabaseDdlRequest", "properties": { "operationId": { - "description": "If empty, the new update request is assigned an automatically-generated operation ID. Otherwise, `operation_id` is used to construct the name of the resulting Operation. Specifying an explicit operation ID simplifies determining whether the statements were executed in the event that the UpdateDatabaseDdl call is replayed, or the return value is otherwise lost: the database and `operation_id` fields can be combined to form the name of the resulting longrunning.Operation: `/operations/`. `operation_id` should be unique within the database, and must be a valid identifier: `a-z*`. Note that automatically-generated operation IDs always begin with an underscore. If the named operation already exists, UpdateDatabaseDdl returns `ALREADY_EXISTS`.", + "description": "If empty, the new update request is assigned an automatically-generated operation ID. Otherwise, `operation_id` is used to construct the name of the resulting Operation. Specifying an explicit operation ID simplifies determining whether the statements were executed in the event that the UpdateDatabaseDdl call is replayed, or the return value is otherwise lost: the database and `operation_id` fields can be combined to form the `name` of the resulting longrunning.Operation: `/operations/`. `operation_id` should be unique within the database, and must be a valid identifier: `a-z*`. Note that automatically-generated operation IDs always begin with an underscore. If the named operation already exists, UpdateDatabaseDdl returns `ALREADY_EXISTS`.", "type": "string" }, "protoDescriptors": { diff --git a/DiscoveryJson/texttospeech.v1.json b/DiscoveryJson/texttospeech.v1.json index 782a11f4fdc..4fc5b872a6b 100644 --- a/DiscoveryJson/texttospeech.v1.json +++ b/DiscoveryJson/texttospeech.v1.json @@ -318,7 +318,7 @@ } } }, - "revision": "20241008", + "revision": "20241026", "rootUrl": "https://texttospeech.googleapis.com/", "schemas": { "AdvancedVoiceOptions": { @@ -326,7 +326,7 @@ "id": "AdvancedVoiceOptions", "properties": { "lowLatencyJourneySynthesis": { - "description": "Only for Jounrney voices. If false, the synthesis will be context aware and have higher latency.", + "description": "Only for Journey voices. If false, the synthesis will be context aware and have higher latency.", "type": "boolean" } }, @@ -522,6 +522,20 @@ }, "type": "object" }, + "MultiSpeakerMarkup": { + "description": "A collection of turns for multi-speaker synthesis.", + "id": "MultiSpeakerMarkup", + "properties": { + "turns": { + "description": "Required. Speaker turns.", + "items": { + "$ref": "Turn" + }, + "type": "array" + } + }, + "type": "object" + }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -592,6 +606,10 @@ "$ref": "CustomPronunciations", "description": "Optional. The pronunciation customizations to be applied to the input. If this is set, the input will be synthesized using the given pronunciation customizations. The initial support will be for EFIGS (English, French, Italian, German, Spanish) languages, as provided in VoiceSelectionParams. Journey and Instant Clone voices are not supported yet. In order to customize the pronunciation of a phrase, there must be an exact match of the phrase in the input types. If using SSML, the phrase must not be inside a phoneme tag (entirely or partially)." }, + "multiSpeakerMarkup": { + "$ref": "MultiSpeakerMarkup", + "description": "The multi-speaker input to be synthesized. Only applicable for multi-speaker synthesis." + }, "ssml": { "description": "The SSML document to be synthesized. The SSML document must be valid and well-formed. Otherwise the RPC will fail and return google.rpc.Code.INVALID_ARGUMENT. For more information, see [SSML](https://cloud.google.com/text-to-speech/docs/ssml).", "type": "string" @@ -655,7 +673,7 @@ "properties": { "advancedVoiceOptions": { "$ref": "AdvancedVoiceOptions", - "description": "Adnanced voice options." + "description": "Advanced voice options." }, "audioConfig": { "$ref": "AudioConfig", @@ -684,6 +702,21 @@ }, "type": "object" }, + "Turn": { + "description": "A Multi-speaker turn.", + "id": "Turn", + "properties": { + "speaker": { + "description": "Required. The speaker of the turn, for example, 'O' or 'Q'. Please refer to documentation for available speakers.", + "type": "string" + }, + "text": { + "description": "Required. The text to speak.", + "type": "string" + } + }, + "type": "object" + }, "Voice": { "description": "Description of a voice supported by the TTS service.", "id": "Voice", @@ -723,6 +756,17 @@ }, "type": "object" }, + "VoiceCloneParams": { + "description": "The configuration of Voice Clone feature.", + "id": "VoiceCloneParams", + "properties": { + "voiceCloningKey": { + "description": "Required. Created by GenerateVoiceCloningKey.", + "type": "string" + } + }, + "type": "object" + }, "VoiceSelectionParams": { "description": "Description of which voice to use for a synthesis request.", "id": "VoiceSelectionParams", @@ -754,6 +798,10 @@ "A gender-neutral voice. This voice is not yet supported." ], "type": "string" + }, + "voiceClone": { + "$ref": "VoiceCloneParams", + "description": "Optional. The configuration for a voice clone. If [VoiceCloneParams.voice_clone_key] is set, the service will choose the voice clone matching the specified configuration." } }, "type": "object" diff --git a/DiscoveryJson/texttospeech.v1beta1.json b/DiscoveryJson/texttospeech.v1beta1.json index 11bf3960958..46a98dc5e10 100644 --- a/DiscoveryJson/texttospeech.v1beta1.json +++ b/DiscoveryJson/texttospeech.v1beta1.json @@ -261,7 +261,7 @@ } } }, - "revision": "20241008", + "revision": "20241026", "rootUrl": "https://texttospeech.googleapis.com/", "schemas": { "AdvancedVoiceOptions": { @@ -269,7 +269,7 @@ "id": "AdvancedVoiceOptions", "properties": { "lowLatencyJourneySynthesis": { - "description": "Only for Jounrney voices. If false, the synthesis will be context aware and have higher latency.", + "description": "Only for Journey voices. If false, the synthesis will be context aware and have higher latency.", "type": "boolean" } }, @@ -455,6 +455,20 @@ }, "type": "object" }, + "MultiSpeakerMarkup": { + "description": "A collection of turns for multi-speaker synthesis.", + "id": "MultiSpeakerMarkup", + "properties": { + "turns": { + "description": "Required. Speaker turns.", + "items": { + "$ref": "Turn" + }, + "type": "array" + } + }, + "type": "object" + }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -525,6 +539,10 @@ "$ref": "CustomPronunciations", "description": "Optional. The pronunciation customizations to be applied to the input. If this is set, the input will be synthesized using the given pronunciation customizations. The initial support will be for EFIGS (English, French, Italian, German, Spanish) languages, as provided in VoiceSelectionParams. Journey and Instant Clone voices are not supported yet. In order to customize the pronunciation of a phrase, there must be an exact match of the phrase in the input types. If using SSML, the phrase must not be inside a phoneme tag (entirely or partially)." }, + "multiSpeakerMarkup": { + "$ref": "MultiSpeakerMarkup", + "description": "The multi-speaker input to be synthesized. Only applicable for multi-speaker synthesis." + }, "ssml": { "description": "The SSML document to be synthesized. The SSML document must be valid and well-formed. Otherwise the RPC will fail and return google.rpc.Code.INVALID_ARGUMENT. For more information, see [SSML](https://cloud.google.com/text-to-speech/docs/ssml).", "type": "string" @@ -588,7 +606,7 @@ "properties": { "advancedVoiceOptions": { "$ref": "AdvancedVoiceOptions", - "description": "Adnanced voice options." + "description": "Advanced voice options." }, "audioConfig": { "$ref": "AudioConfig", @@ -659,6 +677,21 @@ }, "type": "object" }, + "Turn": { + "description": "A Multi-speaker turn.", + "id": "Turn", + "properties": { + "speaker": { + "description": "Required. The speaker of the turn, for example, 'O' or 'Q'. Please refer to documentation for available speakers.", + "type": "string" + }, + "text": { + "description": "Required. The text to speak.", + "type": "string" + } + }, + "type": "object" + }, "Voice": { "description": "Description of a voice supported by the TTS service.", "id": "Voice", @@ -698,6 +731,17 @@ }, "type": "object" }, + "VoiceCloneParams": { + "description": "The configuration of Voice Clone feature.", + "id": "VoiceCloneParams", + "properties": { + "voiceCloningKey": { + "description": "Required. Created by GenerateVoiceCloningKey.", + "type": "string" + } + }, + "type": "object" + }, "VoiceSelectionParams": { "description": "Description of which voice to use for a synthesis request.", "id": "VoiceSelectionParams", @@ -729,6 +773,10 @@ "A gender-neutral voice. This voice is not yet supported." ], "type": "string" + }, + "voiceClone": { + "$ref": "VoiceCloneParams", + "description": "Optional. The configuration for a voice clone. If [VoiceCloneParams.voice_clone_key] is set, the service will choose the voice clone matching the specified configuration." } }, "type": "object" diff --git a/DiscoveryJson/travelimpactmodel.v1.json b/DiscoveryJson/travelimpactmodel.v1.json index c8414996aba..e2c075395d1 100644 --- a/DiscoveryJson/travelimpactmodel.v1.json +++ b/DiscoveryJson/travelimpactmodel.v1.json @@ -116,7 +116,7 @@ } } }, - "revision": "20231012", + "revision": "20241027", "rootUrl": "https://travelimpactmodel.googleapis.com/", "schemas": { "ComputeFlightEmissionsRequest": { @@ -234,7 +234,7 @@ "properties": { "emissionsGramsPerPax": { "$ref": "EmissionsGramsPerPax", - "description": "Optional. Per-passenger emission estimate numbers. Will not be present if emissions could not be computed. For the list of reasons why emissions could not be computed, see ComputeFlightEmissions. Note this field is currently equivalent to ttw_emissions_grams_per_pax until TIM version 1.X.0 which will update this to be total wtw emissions aka wtt_emissions_grams_per_pax + ttw_emissions_grams_per_pax." + "description": "Optional. Per-passenger emission estimate numbers. Will not be present if emissions could not be computed. For the list of reasons why emissions could not be computed, see ComputeFlightEmissions. This field uses wtw emissions aka ttw_emissions_grams_per_pax + wtt_emissions_grams_per_pax." }, "flight": { "$ref": "Flight", diff --git a/EnumStorage/osconfig.v2beta.json b/EnumStorage/osconfig.v2beta.json new file mode 100644 index 00000000000..601becdf492 --- /dev/null +++ b/EnumStorage/osconfig.v2beta.json @@ -0,0 +1,11 @@ +{ + "Google.Apis.OSConfig.v2beta.OSConfigBaseServiceRequest<>.AltEnum": [ + "json", + "media", + "proto" + ], + "Google.Apis.OSConfig.v2beta.OSConfigBaseServiceRequest<>.XgafvEnum": [ + "1", + "2" + ] +} \ No newline at end of file diff --git a/README.md b/README.md index f3bf9662578..042daca579b 100644 --- a/README.md +++ b/README.md @@ -384,6 +384,7 @@ The libraries are shown in the following table. | [Google.Apis.OSConfig.v1](https://googleapis.dev/dotnet/Google.Apis.OSConfig.v1/latest/api/Google.Apis.OSConfig.v1.html) | [![NuGet](https://img.shields.io/nuget/v/Google.Apis.OSConfig.v1)](https://www.nuget.org/packages/Google.Apis.OSConfig.v1) | [OS Config API v1](https://cloud.google.com/compute/docs/osconfig/rest) | | [Google.Apis.OSConfig.v1alpha](https://googleapis.dev/dotnet/Google.Apis.OSConfig.v1alpha/latest/api/Google.Apis.OSConfig.v1alpha.html) | [![NuGet](https://img.shields.io/nuget/v/Google.Apis.OSConfig.v1alpha)](https://www.nuget.org/packages/Google.Apis.OSConfig.v1alpha) | [OS Config API v1alpha](https://cloud.google.com/compute/docs/osconfig/rest) | | [Google.Apis.OSConfig.v1beta](https://googleapis.dev/dotnet/Google.Apis.OSConfig.v1beta/latest/api/Google.Apis.OSConfig.v1beta.html) | [![NuGet](https://img.shields.io/nuget/v/Google.Apis.OSConfig.v1beta)](https://www.nuget.org/packages/Google.Apis.OSConfig.v1beta) | [OS Config API v1beta](https://cloud.google.com/compute/docs/osconfig/rest) | +| [Google.Apis.OSConfig.v2beta](https://googleapis.dev/dotnet/Google.Apis.OSConfig.v2beta/latest/api/Google.Apis.OSConfig.v2beta.html) | [![NuGet](https://img.shields.io/nuget/v/Google.Apis.OSConfig.v2beta)](https://www.nuget.org/packages/Google.Apis.OSConfig.v2beta) | [OS Config API v2beta](https://cloud.google.com/compute/docs/osconfig/rest) | | [Google.Apis.Oauth2.v2](https://googleapis.dev/dotnet/Google.Apis.Oauth2.v2/latest/api/Google.Apis.Oauth2.v2.html) | [![NuGet](https://img.shields.io/nuget/v/Google.Apis.Oauth2.v2)](https://www.nuget.org/packages/Google.Apis.Oauth2.v2) | [Google OAuth2 API v2](https://developers.google.com/identity/protocols/oauth2/) | | [Google.Apis.OnDemandScanning.v1](https://googleapis.dev/dotnet/Google.Apis.OnDemandScanning.v1/latest/api/Google.Apis.OnDemandScanning.v1.html) | [![NuGet](https://img.shields.io/nuget/v/Google.Apis.OnDemandScanning.v1)](https://www.nuget.org/packages/Google.Apis.OnDemandScanning.v1) | [On-Demand Scanning API v1](https://cloud.google.com/container-analysis/docs/on-demand-scanning/) | | [Google.Apis.OnDemandScanning.v1beta1](https://googleapis.dev/dotnet/Google.Apis.OnDemandScanning.v1beta1/latest/api/Google.Apis.OnDemandScanning.v1beta1.html) | [![NuGet](https://img.shields.io/nuget/v/Google.Apis.OnDemandScanning.v1beta1)](https://www.nuget.org/packages/Google.Apis.OnDemandScanning.v1beta1) | [On-Demand Scanning API v1beta1](https://cloud.google.com/container-analysis/docs/on-demand-scanning/) | diff --git a/Src/Generated/Google.Apis.AndroidEnterprise.v1/Google.Apis.AndroidEnterprise.v1.cs b/Src/Generated/Google.Apis.AndroidEnterprise.v1/Google.Apis.AndroidEnterprise.v1.cs index 494470d2acb..96bc2dc570f 100644 --- a/Src/Generated/Google.Apis.AndroidEnterprise.v1/Google.Apis.AndroidEnterprise.v1.cs +++ b/Src/Generated/Google.Apis.AndroidEnterprise.v1/Google.Apis.AndroidEnterprise.v1.cs @@ -7171,9 +7171,11 @@ public class Policy : Google.Apis.Requests.IDirectResponseSchema /// /// Controls when automatic app updates on the device can be applied. Recommended alternative: autoUpdateMode /// which is set per app, provides greater flexibility around update frequency. When autoUpdateMode is set to - /// AUTO_UPDATE_POSTPONED or AUTO_UPDATE_HIGH_PRIORITY, autoUpdatePolicy has no effect. "choiceToTheUser" allows - /// the device's user to configure the app update policy. "always" enables auto updates. "never" disables auto - /// updates. "wifiOnly" enables auto updates only when the device is connected to wifi. + /// AUTO_UPDATE_POSTPONED or AUTO_UPDATE_HIGH_PRIORITY, autoUpdatePolicy has no effect. - choiceToTheUser allows + /// the device's user to configure the app update policy. - always enables auto updates. - never disables auto + /// updates. - wifiOnly enables auto updates only when the device is connected to wifi. *Important:* Changes to + /// app update policies don't affect updates that are in progress. Any policy changes will apply to subsequent + /// app updates. /// [Newtonsoft.Json.JsonPropertyAttribute("autoUpdatePolicy")] public virtual string AutoUpdatePolicy { get; set; } diff --git a/Src/Generated/Google.Apis.AndroidEnterprise.v1/Google.Apis.AndroidEnterprise.v1.csproj b/Src/Generated/Google.Apis.AndroidEnterprise.v1/Google.Apis.AndroidEnterprise.v1.csproj index d3e33ee5489..e76036f6e06 100644 --- a/Src/Generated/Google.Apis.AndroidEnterprise.v1/Google.Apis.AndroidEnterprise.v1.csproj +++ b/Src/Generated/Google.Apis.AndroidEnterprise.v1/Google.Apis.AndroidEnterprise.v1.csproj @@ -3,7 +3,7 @@ Google.Apis.AndroidEnterprise.v1 Client Library - 1.68.0.3581 + 1.68.0.3588 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.BigQueryReservation.v1/Google.Apis.BigQueryReservation.v1.cs b/Src/Generated/Google.Apis.BigQueryReservation.v1/Google.Apis.BigQueryReservation.v1.cs index f4b6b86e5e3..7a85e613c56 100644 --- a/Src/Generated/Google.Apis.BigQueryReservation.v1/Google.Apis.BigQueryReservation.v1.cs +++ b/Src/Generated/Google.Apis.BigQueryReservation.v1/Google.Apis.BigQueryReservation.v1.cs @@ -2035,6 +2035,17 @@ public class Assignment : Google.Apis.Requests.IDirectResponseSchema [Newtonsoft.Json.JsonPropertyAttribute("assignee")] public virtual string Assignee { get; set; } + /// + /// Optional. This field controls if "Gemini in BigQuery" + /// (https://cloud.google.com/gemini/docs/bigquery/overview) features should be enabled for this reservation + /// assignment, which is not on by default. "Gemini in BigQuery" has a distinct compliance posture from + /// BigQuery. If this field is set to true, the assignment job type is QUERY, and the parent reservation edition + /// is ENTERPRISE_PLUS, then the assignment will give the grantee project/organization access to "Gemini in + /// BigQuery" features. + /// + [Newtonsoft.Json.JsonPropertyAttribute("enableGeminiInBigquery")] + public virtual System.Nullable EnableGeminiInBigquery { get; set; } + /// Which type of jobs will use the reservation. [Newtonsoft.Json.JsonPropertyAttribute("jobType")] public virtual string JobType { get; set; } @@ -2060,7 +2071,9 @@ public class Autoscale : Google.Apis.Requests.IDirectResponseSchema { /// /// Output only. The slot capacity added to this reservation when autoscale happens. Will be between [0, - /// max_slots]. + /// max_slots]. Note: after users reduce max_slots, it may take a while before it can be propagated, so + /// current_slots may stay in the original value and could be larger than max_slots for that brief period (less + /// than one minute) /// [Newtonsoft.Json.JsonPropertyAttribute("currentSlots")] public virtual System.Nullable CurrentSlots { get; set; } @@ -2455,6 +2468,13 @@ public virtual System.DateTimeOffset? CreationTimeDateTimeOffset [Newtonsoft.Json.JsonPropertyAttribute("ignoreIdleSlots")] public virtual System.Nullable IgnoreIdleSlots { get; set; } + /// + /// Optional. The labels associated with this reservation. You can use these to organize and group your + /// reservations. You can set this property when inserting or updating a reservation. + /// + [Newtonsoft.Json.JsonPropertyAttribute("labels")] + public virtual System.Collections.Generic.IDictionary Labels { get; set; } + /// /// Applicable only for reservations located within one of the BigQuery multi-regions (US or EU). If set to /// true, this reservation is placed in the organization's secondary region which is designated for disaster diff --git a/Src/Generated/Google.Apis.BigQueryReservation.v1/Google.Apis.BigQueryReservation.v1.csproj b/Src/Generated/Google.Apis.BigQueryReservation.v1/Google.Apis.BigQueryReservation.v1.csproj index 35b959a3b3a..35b71989953 100644 --- a/Src/Generated/Google.Apis.BigQueryReservation.v1/Google.Apis.BigQueryReservation.v1.csproj +++ b/Src/Generated/Google.Apis.BigQueryReservation.v1/Google.Apis.BigQueryReservation.v1.csproj @@ -3,7 +3,7 @@ Google.Apis.BigQueryReservation.v1 Client Library - 1.68.0.3551 + 1.68.0.3583 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.CloudBuild.v1/Google.Apis.CloudBuild.v1.cs b/Src/Generated/Google.Apis.CloudBuild.v1/Google.Apis.CloudBuild.v1.cs index 9087df07531..b963dce8055 100644 --- a/Src/Generated/Google.Apis.CloudBuild.v1/Google.Apis.CloudBuild.v1.cs +++ b/Src/Generated/Google.Apis.CloudBuild.v1/Google.Apis.CloudBuild.v1.cs @@ -8683,6 +8683,10 @@ public class PrivatePoolV1Config : Google.Apis.Requests.IDirectResponseSchema [Newtonsoft.Json.JsonPropertyAttribute("networkConfig")] public virtual NetworkConfig NetworkConfig { get; set; } + /// Immutable. Private Service Connect(PSC) Network configuration for the pool. + [Newtonsoft.Json.JsonPropertyAttribute("privateServiceConnect")] + public virtual PrivateServiceConnect PrivateServiceConnect { get; set; } + /// Machine configuration for the workers in the pool. [Newtonsoft.Json.JsonPropertyAttribute("workerConfig")] public virtual WorkerConfig WorkerConfig { get; set; } @@ -8691,6 +8695,41 @@ public class PrivatePoolV1Config : Google.Apis.Requests.IDirectResponseSchema public virtual string ETag { get; set; } } + /// Defines the Private Service Connect network configuration for the pool. + public class PrivateServiceConnect : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Required. Immutable. The network attachment that the worker network interface is peered to. Must be in the + /// format `projects/{project}/regions/{region}/networkAttachments/{networkAttachment}`. The region of network + /// attachment must be the same as the worker pool. See [Network + /// Attachments](https://cloud.google.com/vpc/docs/about-network-attachments) + /// + [Newtonsoft.Json.JsonPropertyAttribute("networkAttachment")] + public virtual string NetworkAttachment { get; set; } + + /// + /// Required. Immutable. Disable public IP on the primary network interface. If true, workers are created + /// without any public address, which prevents network egress to public IPs unless a network proxy is + /// configured. If false, workers are created with a public address which allows for public internet egress. The + /// public address only applies to traffic through the primary network interface. If `route_all_traffic` is set + /// to true, all traffic will go through the non-primary network interface, this boolean has no effect. + /// + [Newtonsoft.Json.JsonPropertyAttribute("publicIpAddressDisabled")] + public virtual System.Nullable PublicIpAddressDisabled { get; set; } + + /// + /// Immutable. Route all traffic through PSC interface. Enable this if you want full control of traffic in the + /// private pool. Configure Cloud NAT for the subnet of network attachment if you need to access public + /// Internet. If false, Only route private IPs, e.g. 10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16 through PSC + /// interface. + /// + [Newtonsoft.Json.JsonPropertyAttribute("routeAllTraffic")] + public virtual System.Nullable RouteAllTraffic { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Metadata for `ProcessAppManifestCallback` operation. public class ProcessAppManifestCallbackOperationMetadata : Google.Apis.Requests.IDirectResponseSchema { diff --git a/Src/Generated/Google.Apis.CloudBuild.v1/Google.Apis.CloudBuild.v1.csproj b/Src/Generated/Google.Apis.CloudBuild.v1/Google.Apis.CloudBuild.v1.csproj index 55009048b6e..906919e7d40 100644 --- a/Src/Generated/Google.Apis.CloudBuild.v1/Google.Apis.CloudBuild.v1.csproj +++ b/Src/Generated/Google.Apis.CloudBuild.v1/Google.Apis.CloudBuild.v1.csproj @@ -3,7 +3,7 @@ Google.Apis.CloudBuild.v1 Client Library - 1.68.0.3553 + 1.68.0.3585 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.CloudDataplex.v1/Google.Apis.CloudDataplex.v1.cs b/Src/Generated/Google.Apis.CloudDataplex.v1/Google.Apis.CloudDataplex.v1.cs index 6df262123fa..083e856b7d5 100644 --- a/Src/Generated/Google.Apis.CloudDataplex.v1/Google.Apis.CloudDataplex.v1.cs +++ b/Src/Generated/Google.Apis.CloudDataplex.v1/Google.Apis.CloudDataplex.v1.cs @@ -15966,6 +15966,152 @@ public class GoogleCloudDataplexV1DataAttributeBindingPath : Google.Apis.Request public virtual string ETag { get; set; } } + /// The output of a data discovery scan. + public class GoogleCloudDataplexV1DataDiscoveryResult : Google.Apis.Requests.IDirectResponseSchema + { + /// Output only. Configuration for metadata publishing. + [Newtonsoft.Json.JsonPropertyAttribute("bigqueryPublishing")] + public virtual GoogleCloudDataplexV1DataDiscoveryResultBigQueryPublishing BigqueryPublishing { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Describes BigQuery publishing configurations. + public class GoogleCloudDataplexV1DataDiscoveryResultBigQueryPublishing : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Output only. The BigQuery dataset to publish to. It takes the form + /// projects/{project_id}/datasets/{dataset_id}. If not set, the service creates a default publishing dataset. + /// + [Newtonsoft.Json.JsonPropertyAttribute("dataset")] + public virtual string Dataset { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Spec for a data discovery scan. + public class GoogleCloudDataplexV1DataDiscoverySpec : Google.Apis.Requests.IDirectResponseSchema + { + /// Optional. Configuration for metadata publishing. + [Newtonsoft.Json.JsonPropertyAttribute("bigqueryPublishingConfig")] + public virtual GoogleCloudDataplexV1DataDiscoverySpecBigQueryPublishingConfig BigqueryPublishingConfig { get; set; } + + /// Cloud Storage related configurations. + [Newtonsoft.Json.JsonPropertyAttribute("storageConfig")] + public virtual GoogleCloudDataplexV1DataDiscoverySpecStorageConfig StorageConfig { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Describes BigQuery publishing configurations. + public class GoogleCloudDataplexV1DataDiscoverySpecBigQueryPublishingConfig : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Optional. The BigQuery connection used to create BigLake tables. Must be in the form + /// projects/{project_id}/locations/{location_id}/connections/{connection_id} + /// + [Newtonsoft.Json.JsonPropertyAttribute("connection")] + public virtual string Connection { get; set; } + + /// + /// Optional. Determines whether to publish discovered tables as BigLake external tables or non-BigLake external + /// tables. + /// + [Newtonsoft.Json.JsonPropertyAttribute("tableType")] + public virtual string TableType { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Configurations related to Cloud Storage as the data source. + public class GoogleCloudDataplexV1DataDiscoverySpecStorageConfig : Google.Apis.Requests.IDirectResponseSchema + { + /// Optional. Configuration for CSV data. + [Newtonsoft.Json.JsonPropertyAttribute("csvOptions")] + public virtual GoogleCloudDataplexV1DataDiscoverySpecStorageConfigCsvOptions CsvOptions { get; set; } + + /// + /// Optional. Defines the data to exclude during discovery. Provide a list of patterns that identify the data to + /// exclude. For Cloud Storage bucket assets, these patterns are interpreted as glob patterns used to match + /// object names. For BigQuery dataset assets, these patterns are interpreted as patterns to match table names. + /// + [Newtonsoft.Json.JsonPropertyAttribute("excludePatterns")] + public virtual System.Collections.Generic.IList ExcludePatterns { get; set; } + + /// + /// Optional. Defines the data to include during discovery when only a subset of the data should be considered. + /// Provide a list of patterns that identify the data to include. For Cloud Storage bucket assets, these + /// patterns are interpreted as glob patterns used to match object names. For BigQuery dataset assets, these + /// patterns are interpreted as patterns to match table names. + /// + [Newtonsoft.Json.JsonPropertyAttribute("includePatterns")] + public virtual System.Collections.Generic.IList IncludePatterns { get; set; } + + /// Optional. Configuration for JSON data. + [Newtonsoft.Json.JsonPropertyAttribute("jsonOptions")] + public virtual GoogleCloudDataplexV1DataDiscoverySpecStorageConfigJsonOptions JsonOptions { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Describes CSV and similar semi-structured data formats. + public class GoogleCloudDataplexV1DataDiscoverySpecStorageConfigCsvOptions : Google.Apis.Requests.IDirectResponseSchema + { + /// Optional. The delimiter that is used to separate values. The default is , (comma). + [Newtonsoft.Json.JsonPropertyAttribute("delimiter")] + public virtual string Delimiter { get; set; } + + /// Optional. The character encoding of the data. The default is UTF-8. + [Newtonsoft.Json.JsonPropertyAttribute("encoding")] + public virtual string Encoding { get; set; } + + /// + /// Optional. The number of rows to interpret as header rows that should be skipped when reading data rows. + /// + [Newtonsoft.Json.JsonPropertyAttribute("headerRows")] + public virtual System.Nullable HeaderRows { get; set; } + + /// + /// Optional. The character used to quote column values. Accepts " (double quotation mark) or ' (single + /// quotation mark). If unspecified, defaults to " (double quotation mark). + /// + [Newtonsoft.Json.JsonPropertyAttribute("quote")] + public virtual string Quote { get; set; } + + /// + /// Optional. Whether to disable the inference of data types for CSV data. If true, all columns are registered + /// as strings. + /// + [Newtonsoft.Json.JsonPropertyAttribute("typeInferenceDisabled")] + public virtual System.Nullable TypeInferenceDisabled { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Describes JSON data format. + public class GoogleCloudDataplexV1DataDiscoverySpecStorageConfigJsonOptions : Google.Apis.Requests.IDirectResponseSchema + { + /// Optional. The character encoding of the data. The default is UTF-8. + [Newtonsoft.Json.JsonPropertyAttribute("encoding")] + public virtual string Encoding { get; set; } + + /// + /// Optional. Whether to disable the inference of data types for JSON data. If true, all columns are registered + /// as their primitive types (strings, number, or boolean). + /// + [Newtonsoft.Json.JsonPropertyAttribute("typeInferenceDisabled")] + public virtual System.Nullable TypeInferenceDisabled { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// /// DataProfileResult defines the output of DataProfileScan. Each field of the table will have field type specific /// profile result. @@ -16963,6 +17109,14 @@ public virtual System.DateTimeOffset? CreateTimeDateTimeOffset [Newtonsoft.Json.JsonPropertyAttribute("data")] public virtual GoogleCloudDataplexV1DataSource Data { get; set; } + /// Output only. The result of a data discovery scan. + [Newtonsoft.Json.JsonPropertyAttribute("dataDiscoveryResult")] + public virtual GoogleCloudDataplexV1DataDiscoveryResult DataDiscoveryResult { get; set; } + + /// Settings for a data discovery scan. + [Newtonsoft.Json.JsonPropertyAttribute("dataDiscoverySpec")] + public virtual GoogleCloudDataplexV1DataDiscoverySpec DataDiscoverySpec { get; set; } + /// Output only. The result of a data profile scan. [Newtonsoft.Json.JsonPropertyAttribute("dataProfileResult")] public virtual GoogleCloudDataplexV1DataProfileResult DataProfileResult { get; set; } @@ -17544,6 +17698,14 @@ public virtual System.DateTimeOffset? CreateTimeDateTimeOffset set => CreateTimeRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); } + /// Output only. The result of a data discovery scan. + [Newtonsoft.Json.JsonPropertyAttribute("dataDiscoveryResult")] + public virtual GoogleCloudDataplexV1DataDiscoveryResult DataDiscoveryResult { get; set; } + + /// Output only. Settings for a data discovery scan. + [Newtonsoft.Json.JsonPropertyAttribute("dataDiscoverySpec")] + public virtual GoogleCloudDataplexV1DataDiscoverySpec DataDiscoverySpec { get; set; } + /// Output only. The result of a data profile scan. [Newtonsoft.Json.JsonPropertyAttribute("dataProfileResult")] public virtual GoogleCloudDataplexV1DataProfileResult DataProfileResult { get; set; } diff --git a/Src/Generated/Google.Apis.CloudDataplex.v1/Google.Apis.CloudDataplex.v1.csproj b/Src/Generated/Google.Apis.CloudDataplex.v1/Google.Apis.CloudDataplex.v1.csproj index 7a93d81d60d..e75132e2f99 100644 --- a/Src/Generated/Google.Apis.CloudDataplex.v1/Google.Apis.CloudDataplex.v1.csproj +++ b/Src/Generated/Google.Apis.CloudDataplex.v1/Google.Apis.CloudDataplex.v1.csproj @@ -3,7 +3,7 @@ Google.Apis.CloudDataplex.v1 Client Library - 1.68.0.3561 + 1.68.0.3579 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.CloudRetail.v2/Google.Apis.CloudRetail.v2.cs b/Src/Generated/Google.Apis.CloudRetail.v2/Google.Apis.CloudRetail.v2.cs index b3b822e4eb0..3ff7cf73dd0 100644 --- a/Src/Generated/Google.Apis.CloudRetail.v2/Google.Apis.CloudRetail.v2.cs +++ b/Src/Generated/Google.Apis.CloudRetail.v2/Google.Apis.CloudRetail.v2.cs @@ -8026,6 +8026,37 @@ public class GoogleCloudRetailV2PauseModelRequest : Google.Apis.Requests.IDirect public virtual string ETag { get; set; } } + /// + /// Metadata for pinning to be returned in the response. This is used for distinguishing between applied vs dropped + /// pins. + /// + public class GoogleCloudRetailV2PinControlMetadata : Google.Apis.Requests.IDirectResponseSchema + { + /// Map of all matched pins, keyed by pin position. + [Newtonsoft.Json.JsonPropertyAttribute("allMatchedPins")] + public virtual System.Collections.Generic.IDictionary AllMatchedPins { get; set; } + + /// + /// Map of pins that were dropped due to overlap with other matching pins, keyed by pin position. + /// + [Newtonsoft.Json.JsonPropertyAttribute("droppedPins")] + public virtual System.Collections.Generic.IDictionary DroppedPins { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// List of product ids which have associated pins. + public class GoogleCloudRetailV2PinControlMetadataProductPins : Google.Apis.Requests.IDirectResponseSchema + { + /// List of product ids which have associated pins. + [Newtonsoft.Json.JsonPropertyAttribute("productId")] + public virtual System.Collections.Generic.IList ProductId { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Request message for Predict method. public class GoogleCloudRetailV2PredictRequest : Google.Apis.Requests.IDirectResponseSchema { @@ -10323,6 +10354,14 @@ public class GoogleCloudRetailV2SearchResponse : Google.Apis.Requests.IDirectRes [Newtonsoft.Json.JsonPropertyAttribute("nextPageToken")] public virtual string NextPageToken { get; set; } + /// + /// Metadata for pin controls which were applicable to the request. This contains two map fields, one for all + /// matched pins and one for pins which were matched but not applied. The two maps are keyed by pin position, + /// and the values are the product ids which were matched to that pin. + /// + [Newtonsoft.Json.JsonPropertyAttribute("pinControlMetadata")] + public virtual GoogleCloudRetailV2PinControlMetadata PinControlMetadata { get; set; } + /// Query expansion information for the returned results. [Newtonsoft.Json.JsonPropertyAttribute("queryExpansionInfo")] public virtual GoogleCloudRetailV2SearchResponseQueryExpansionInfo QueryExpansionInfo { get; set; } diff --git a/Src/Generated/Google.Apis.CloudRetail.v2/Google.Apis.CloudRetail.v2.csproj b/Src/Generated/Google.Apis.CloudRetail.v2/Google.Apis.CloudRetail.v2.csproj index b72c853384f..dc65e331c03 100644 --- a/Src/Generated/Google.Apis.CloudRetail.v2/Google.Apis.CloudRetail.v2.csproj +++ b/Src/Generated/Google.Apis.CloudRetail.v2/Google.Apis.CloudRetail.v2.csproj @@ -3,7 +3,7 @@ Google.Apis.CloudRetail.v2 Client Library - 1.68.0.3577 + 1.68.0.3584 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.CloudRetail.v2alpha/Google.Apis.CloudRetail.v2alpha.cs b/Src/Generated/Google.Apis.CloudRetail.v2alpha/Google.Apis.CloudRetail.v2alpha.cs index 44f85c9e885..2bcdcb0e46d 100644 --- a/Src/Generated/Google.Apis.CloudRetail.v2alpha/Google.Apis.CloudRetail.v2alpha.cs +++ b/Src/Generated/Google.Apis.CloudRetail.v2alpha/Google.Apis.CloudRetail.v2alpha.cs @@ -10987,6 +10987,37 @@ public class GoogleCloudRetailV2alphaPauseModelRequest : Google.Apis.Requests.ID public virtual string ETag { get; set; } } + /// + /// Metadata for pinning to be returned in the response. This is used for distinguishing between applied vs dropped + /// pins. + /// + public class GoogleCloudRetailV2alphaPinControlMetadata : Google.Apis.Requests.IDirectResponseSchema + { + /// Map of all matched pins, keyed by pin position. + [Newtonsoft.Json.JsonPropertyAttribute("allMatchedPins")] + public virtual System.Collections.Generic.IDictionary AllMatchedPins { get; set; } + + /// + /// Map of pins that were dropped due to overlap with other matching pins, keyed by pin position. + /// + [Newtonsoft.Json.JsonPropertyAttribute("droppedPins")] + public virtual System.Collections.Generic.IDictionary DroppedPins { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// List of product ids which have associated pins. + public class GoogleCloudRetailV2alphaPinControlMetadataProductPins : Google.Apis.Requests.IDirectResponseSchema + { + /// List of product ids which have associated pins. + [Newtonsoft.Json.JsonPropertyAttribute("productId")] + public virtual System.Collections.Generic.IList ProductId { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Request message for Predict method. public class GoogleCloudRetailV2alphaPredictRequest : Google.Apis.Requests.IDirectResponseSchema { @@ -13310,6 +13341,14 @@ public class GoogleCloudRetailV2alphaSearchResponse : Google.Apis.Requests.IDire [Newtonsoft.Json.JsonPropertyAttribute("nextPageToken")] public virtual string NextPageToken { get; set; } + /// + /// Metadata for pin controls which were applicable to the request. This contains two map fields, one for all + /// matched pins and one for pins which were matched but not applied. The two maps are keyed by pin position, + /// and the values are the product ids which were matched to that pin. + /// + [Newtonsoft.Json.JsonPropertyAttribute("pinControlMetadata")] + public virtual GoogleCloudRetailV2alphaPinControlMetadata PinControlMetadata { get; set; } + /// Query expansion information for the returned results. [Newtonsoft.Json.JsonPropertyAttribute("queryExpansionInfo")] public virtual GoogleCloudRetailV2alphaSearchResponseQueryExpansionInfo QueryExpansionInfo { get; set; } diff --git a/Src/Generated/Google.Apis.CloudRetail.v2alpha/Google.Apis.CloudRetail.v2alpha.csproj b/Src/Generated/Google.Apis.CloudRetail.v2alpha/Google.Apis.CloudRetail.v2alpha.csproj index 125696e640b..8801a3451ab 100644 --- a/Src/Generated/Google.Apis.CloudRetail.v2alpha/Google.Apis.CloudRetail.v2alpha.csproj +++ b/Src/Generated/Google.Apis.CloudRetail.v2alpha/Google.Apis.CloudRetail.v2alpha.csproj @@ -3,7 +3,7 @@ Google.Apis.CloudRetail.v2alpha Client Library - 1.68.0.3577 + 1.68.0.3584 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.Compute.alpha/Google.Apis.Compute.alpha.cs b/Src/Generated/Google.Apis.Compute.alpha/Google.Apis.Compute.alpha.cs index ad51aa39c89..6c85968042a 100644 --- a/Src/Generated/Google.Apis.Compute.alpha/Google.Apis.Compute.alpha.cs +++ b/Src/Generated/Google.Apis.Compute.alpha/Google.Apis.Compute.alpha.cs @@ -27140,7 +27140,7 @@ protected override void InitParameters() } } - /// Adds a network interface to an instance. + /// Adds one dynamic network interface to an active instance. /// The body of the request. /// Project ID for this request. /// The name of the zone for this request. @@ -27153,7 +27153,7 @@ public virtual AddNetworkInterfaceRequest AddNetworkInterface(Google.Apis.Comput return new AddNetworkInterfaceRequest(this.service, body, project, zone, instance); } - /// Adds a network interface to an instance. + /// Adds one dynamic network interface to an active instance. public class AddNetworkInterfaceRequest : ComputeBaseServiceRequest { /// Constructs a new AddNetworkInterface request. @@ -27998,9 +27998,9 @@ protected override void InitParameters() } /// - /// Deletes one network interface from an active instance. InstancesDeleteNetworkInterfaceRequest indicates: - - /// instance from which to delete, using project+zone+resource_id fields; - network interface to be deleted, - /// using network_interface_name field; Only VLAN interface deletion is supported for now. + /// Deletes one dynamic network interface from an active instance. InstancesDeleteNetworkInterfaceRequest + /// indicates: - instance from which to delete, using project+zone+resource_id fields; - dynamic network + /// interface to be deleted, using network_interface_name field; /// /// Project ID for this request. /// The name of the zone for this request. @@ -28009,8 +28009,7 @@ protected override void InitParameters() /// long integer. /// /// - /// The name of the network interface to be deleted from the instance. Only VLAN network interface deletion is - /// supported. + /// The name of the dynamic network interface to be deleted from the instance. /// public virtual DeleteNetworkInterfaceRequest DeleteNetworkInterface(string project, string zone, string instance, string networkInterfaceName) { @@ -28018,9 +28017,9 @@ public virtual DeleteNetworkInterfaceRequest DeleteNetworkInterface(string proje } /// - /// Deletes one network interface from an active instance. InstancesDeleteNetworkInterfaceRequest indicates: - - /// instance from which to delete, using project+zone+resource_id fields; - network interface to be deleted, - /// using network_interface_name field; Only VLAN interface deletion is supported for now. + /// Deletes one dynamic network interface from an active instance. InstancesDeleteNetworkInterfaceRequest + /// indicates: - instance from which to delete, using project+zone+resource_id fields; - dynamic network + /// interface to be deleted, using network_interface_name field; /// public class DeleteNetworkInterfaceRequest : ComputeBaseServiceRequest { @@ -28049,10 +28048,7 @@ public DeleteNetworkInterfaceRequest(Google.Apis.Services.IClientService service [Google.Apis.Util.RequestParameterAttribute("instance", Google.Apis.Util.RequestParameterType.Path)] public virtual string Instance { get; private set; } - /// - /// The name of the network interface to be deleted from the instance. Only VLAN network interface deletion - /// is supported. - /// + /// The name of the dynamic network interface to be deleted from the instance. [Google.Apis.Util.RequestParameterAttribute("networkInterfaceName", Google.Apis.Util.RequestParameterType.Query)] public virtual string NetworkInterfaceName { get; private set; } @@ -28815,6 +28811,8 @@ public GetSerialPortOutputRequest(Google.Apis.Services.IClientService service, s /// still available, and the adjusted start position is returned as the `start` property value. You can also /// provide a negative start position, which translates to the most recent number of bytes written to the /// serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console. + /// Note that the negative start is bounded by the retained buffer size, and the returned serial console + /// output will not exceed the max buffer size. /// [Google.Apis.Util.RequestParameterAttribute("start", Google.Apis.Util.RequestParameterType.Query)] public virtual System.Nullable Start { get; set; } @@ -108594,7 +108592,7 @@ public class BackendBucketCdnPolicy : Google.Apis.Requests.IDirectResponseSchema /// result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically /// cache static content, including common image formats, media (video and audio), and web assets (JavaScript /// and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including - /// HTML), will not be cached. + /// HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. /// [Newtonsoft.Json.JsonPropertyAttribute("cacheMode")] public virtual string CacheMode { get; set; } @@ -109483,7 +109481,7 @@ public class BackendServiceCdnPolicy : Google.Apis.Requests.IDirectResponseSchem /// result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically /// cache static content, including common image formats, media (video and audio), and web assets (JavaScript /// and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including - /// HTML), will not be cached. + /// HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. /// [Newtonsoft.Json.JsonPropertyAttribute("cacheMode")] public virtual string CacheMode { get; set; } @@ -129194,9 +129192,7 @@ public class NetworkInterface : Google.Apis.Requests.IDirectResponseSchema [Newtonsoft.Json.JsonPropertyAttribute("nicType")] public virtual string NicType { get; set; } - /// - /// Name of the parent network interface of a VLAN based nic. If this field is specified, vlan must be set. - /// + /// Name of the parent network interface of a dynamic network interface. [Newtonsoft.Json.JsonPropertyAttribute("parentNicName")] public virtual string ParentNicName { get; set; } @@ -129234,10 +129230,7 @@ public class NetworkInterface : Google.Apis.Requests.IDirectResponseSchema [Newtonsoft.Json.JsonPropertyAttribute("subnetwork")] public virtual string Subnetwork { get; set; } - /// - /// VLAN tag of a VLAN based network interface, must be in range from 2 to 4094 inclusively. This field is - /// mandatory if the parent network interface name is set. - /// + /// VLAN tag of a dynamic network interface, must be in range from 2 to 4094 inclusively. [Newtonsoft.Json.JsonPropertyAttribute("vlan")] public virtual System.Nullable Vlan { get; set; } @@ -129487,6 +129480,10 @@ public class NetworkProfile : Google.Apis.Requests.IDirectResponseSchema [Newtonsoft.Json.JsonPropertyAttribute("kind")] public virtual string Kind { get; set; } + /// [Output Only] Location to which the network is restricted. + [Newtonsoft.Json.JsonPropertyAttribute("location")] + public virtual NetworkProfileLocation Location { get; set; } + /// [Output Only] Name of the resource. [Newtonsoft.Json.JsonPropertyAttribute("name")] public virtual string Name { get; set; } @@ -129507,6 +129504,18 @@ public class NetworkProfile : Google.Apis.Requests.IDirectResponseSchema public virtual string ETag { get; set; } } + public class NetworkProfileLocation : Google.Apis.Requests.IDirectResponseSchema + { + [Newtonsoft.Json.JsonPropertyAttribute("name")] + public virtual string Name { get; set; } + + [Newtonsoft.Json.JsonPropertyAttribute("scope")] + public virtual string Scope { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + public class NetworkProfileNetworkFeatures : Google.Apis.Requests.IDirectResponseSchema { /// @@ -144474,7 +144483,7 @@ public class Subnetwork : Google.Apis.Requests.IDirectResponseSchema /// /// The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, - /// PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are + /// or PRIVATE_SERVICE_CONNECT. PRIVATE is the default purpose for user-created subnets or subnets that are /// automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or /// REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A /// subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service @@ -148383,7 +148392,7 @@ public class UsableSubnetwork : Google.Apis.Requests.IDirectResponseSchema /// /// The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, - /// PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are + /// or PRIVATE_SERVICE_CONNECT. PRIVATE is the default purpose for user-created subnets or subnets that are /// automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or /// REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A /// subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service diff --git a/Src/Generated/Google.Apis.Compute.alpha/Google.Apis.Compute.alpha.csproj b/Src/Generated/Google.Apis.Compute.alpha/Google.Apis.Compute.alpha.csproj index 7ce81f214a3..50ad5270f0f 100644 --- a/Src/Generated/Google.Apis.Compute.alpha/Google.Apis.Compute.alpha.csproj +++ b/Src/Generated/Google.Apis.Compute.alpha/Google.Apis.Compute.alpha.csproj @@ -3,7 +3,7 @@ Google.Apis.Compute.alpha Client Library - 1.68.0.3575 + 1.68.0.3581 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.Datastore.v1/Google.Apis.Datastore.v1.cs b/Src/Generated/Google.Apis.Datastore.v1/Google.Apis.Datastore.v1.cs index 2e90d0d65dd..4116db0836d 100644 --- a/Src/Generated/Google.Apis.Datastore.v1/Google.Apis.Datastore.v1.cs +++ b/Src/Generated/Google.Apis.Datastore.v1/Google.Apis.Datastore.v1.cs @@ -1991,6 +1991,56 @@ public class Filter : Google.Apis.Requests.IDirectResponseSchema public virtual string ETag { get; set; } } + /// + /// Nearest Neighbors search config. The ordering provided by FindNearest supersedes the order_by stage. If multiple + /// documents have the same vector distance, the returned document order is not guaranteed to be stable between + /// queries. + /// + public class FindNearest : Google.Apis.Requests.IDirectResponseSchema + { + /// Required. The Distance Measure to use, required. + [Newtonsoft.Json.JsonPropertyAttribute("distanceMeasure")] + public virtual string DistanceMeasure { get; set; } + + /// + /// Optional. Optional name of the field to output the result of the vector distance calculation. Must conform + /// to entity property limitations. + /// + [Newtonsoft.Json.JsonPropertyAttribute("distanceResultProperty")] + public virtual string DistanceResultProperty { get; set; } + + /// + /// Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior + /// of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT + /// distances increase when the vectors are more similar, the comparison is inverted. * For EUCLIDEAN, COSINE: + /// WHERE distance &lt;= distance_threshold * For DOT_PRODUCT: WHERE distance &gt;= distance_threshold + /// + [Newtonsoft.Json.JsonPropertyAttribute("distanceThreshold")] + public virtual System.Nullable DistanceThreshold { get; set; } + + /// + /// Required. The number of nearest neighbors to return. Must be a positive integer of no more than 100. + /// + [Newtonsoft.Json.JsonPropertyAttribute("limit")] + public virtual System.Nullable Limit { get; set; } + + /// + /// Required. The query vector that we are searching on. Must be a vector of no more than 2048 dimensions. + /// + [Newtonsoft.Json.JsonPropertyAttribute("queryVector")] + public virtual Value QueryVector { get; set; } + + /// + /// Required. An indexed vector property to search upon. Only documents which contain vectors whose + /// dimensionality match the query_vector can be returned. + /// + [Newtonsoft.Json.JsonPropertyAttribute("vectorProperty")] + public virtual PropertyReference VectorProperty { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Metadata common to all Datastore Admin operations. public class GoogleDatastoreAdminV1CommonMetadata : Google.Apis.Requests.IDirectResponseSchema { @@ -3365,7 +3415,10 @@ public class PropertyTransform : Google.Apis.Requests.IDirectResponseSchema public virtual string ETag { get; set; } } - /// A query for entities. + /// + /// A query for entities. The query stages are executed in the following order: 1. kind 2. filter 3. projection 4. + /// order + start_cursor + end_cursor 5. offset 6. limit 7. find_nearest + /// public class Query : Google.Apis.Requests.IDirectResponseSchema { /// @@ -3389,6 +3442,13 @@ public class Query : Google.Apis.Requests.IDirectResponseSchema [Newtonsoft.Json.JsonPropertyAttribute("filter")] public virtual Filter Filter { get; set; } + /// + /// Optional. A potential Nearest Neighbors Search. Applies after all other filters and ordering. Finds the + /// closest vector embeddings to the given query vector. + /// + [Newtonsoft.Json.JsonPropertyAttribute("findNearest")] + public virtual FindNearest FindNearest { get; set; } + /// /// The kinds to query (if empty, returns entities of all kinds). Currently at most 1 kind may be specified. /// diff --git a/Src/Generated/Google.Apis.Datastore.v1/Google.Apis.Datastore.v1.csproj b/Src/Generated/Google.Apis.Datastore.v1/Google.Apis.Datastore.v1.csproj index a0c42cd5b81..76a9ed2290b 100644 --- a/Src/Generated/Google.Apis.Datastore.v1/Google.Apis.Datastore.v1.csproj +++ b/Src/Generated/Google.Apis.Datastore.v1/Google.Apis.Datastore.v1.csproj @@ -3,7 +3,7 @@ Google.Apis.Datastore.v1 Client Library - 1.68.0.3568 + 1.68.0.3578 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.Datastore.v1beta3/Google.Apis.Datastore.v1beta3.cs b/Src/Generated/Google.Apis.Datastore.v1beta3/Google.Apis.Datastore.v1beta3.cs index 2970777a3c2..ae9f9bf602f 100644 --- a/Src/Generated/Google.Apis.Datastore.v1beta3/Google.Apis.Datastore.v1beta3.cs +++ b/Src/Generated/Google.Apis.Datastore.v1beta3/Google.Apis.Datastore.v1beta3.cs @@ -1251,6 +1251,56 @@ public class Filter : Google.Apis.Requests.IDirectResponseSchema public virtual string ETag { get; set; } } + /// + /// Nearest Neighbors search config. The ordering provided by FindNearest supersedes the order_by stage. If multiple + /// documents have the same vector distance, the returned document order is not guaranteed to be stable between + /// queries. + /// + public class FindNearest : Google.Apis.Requests.IDirectResponseSchema + { + /// Required. The Distance Measure to use, required. + [Newtonsoft.Json.JsonPropertyAttribute("distanceMeasure")] + public virtual string DistanceMeasure { get; set; } + + /// + /// Optional. Optional name of the field to output the result of the vector distance calculation. Must conform + /// to entity property limitations. + /// + [Newtonsoft.Json.JsonPropertyAttribute("distanceResultProperty")] + public virtual string DistanceResultProperty { get; set; } + + /// + /// Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior + /// of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT + /// distances increase when the vectors are more similar, the comparison is inverted. * For EUCLIDEAN, COSINE: + /// WHERE distance &lt;= distance_threshold * For DOT_PRODUCT: WHERE distance &gt;= distance_threshold + /// + [Newtonsoft.Json.JsonPropertyAttribute("distanceThreshold")] + public virtual System.Nullable DistanceThreshold { get; set; } + + /// + /// Required. The number of nearest neighbors to return. Must be a positive integer of no more than 100. + /// + [Newtonsoft.Json.JsonPropertyAttribute("limit")] + public virtual System.Nullable Limit { get; set; } + + /// + /// Required. The query vector that we are searching on. Must be a vector of no more than 2048 dimensions. + /// + [Newtonsoft.Json.JsonPropertyAttribute("queryVector")] + public virtual Value QueryVector { get; set; } + + /// + /// Required. An indexed vector property to search upon. Only documents which contain vectors whose + /// dimensionality match the query_vector can be returned. + /// + [Newtonsoft.Json.JsonPropertyAttribute("vectorProperty")] + public virtual PropertyReference VectorProperty { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Metadata common to all Datastore Admin operations. public class GoogleDatastoreAdminV1CommonMetadata : Google.Apis.Requests.IDirectResponseSchema { @@ -2423,7 +2473,10 @@ public class PropertyTransform : Google.Apis.Requests.IDirectResponseSchema public virtual string ETag { get; set; } } - /// A query for entities. + /// + /// A query for entities. The query stages are executed in the following order: 1. kind 2. filter 3. projection 4. + /// order + start_cursor + end_cursor 5. offset 6. limit 7. find_nearest + /// public class Query : Google.Apis.Requests.IDirectResponseSchema { /// @@ -2447,6 +2500,13 @@ public class Query : Google.Apis.Requests.IDirectResponseSchema [Newtonsoft.Json.JsonPropertyAttribute("filter")] public virtual Filter Filter { get; set; } + /// + /// Optional. A potential Nearest Neighbors Search. Applies after all other filters and ordering. Finds the + /// closest vector embeddings to the given query vector. + /// + [Newtonsoft.Json.JsonPropertyAttribute("findNearest")] + public virtual FindNearest FindNearest { get; set; } + /// /// The kinds to query (if empty, returns entities of all kinds). Currently at most 1 kind may be specified. /// diff --git a/Src/Generated/Google.Apis.Datastore.v1beta3/Google.Apis.Datastore.v1beta3.csproj b/Src/Generated/Google.Apis.Datastore.v1beta3/Google.Apis.Datastore.v1beta3.csproj index b00061e130e..5632f4cb973 100644 --- a/Src/Generated/Google.Apis.Datastore.v1beta3/Google.Apis.Datastore.v1beta3.csproj +++ b/Src/Generated/Google.Apis.Datastore.v1beta3/Google.Apis.Datastore.v1beta3.csproj @@ -3,7 +3,7 @@ Google.Apis.Datastore.v1beta3 Client Library - 1.68.0.3568 + 1.68.0.3578 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.DiscoveryEngine.v1/Google.Apis.DiscoveryEngine.v1.cs b/Src/Generated/Google.Apis.DiscoveryEngine.v1/Google.Apis.DiscoveryEngine.v1.cs index b398f192291..6a74d1dd184 100644 --- a/Src/Generated/Google.Apis.DiscoveryEngine.v1/Google.Apis.DiscoveryEngine.v1.cs +++ b/Src/Generated/Google.Apis.DiscoveryEngine.v1/Google.Apis.DiscoveryEngine.v1.cs @@ -3503,6 +3503,89 @@ protected override void InitParameters() }); } } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that + /// allows API key for authentication, where OAuth and IAM checks are not required. Only public + /// website search is supported by this method. If data stores and engines not associated with + /// public website search are specified, a `FAILED_PRECONDITION` error is returned. This method + /// can be used for easy onboarding without having to implement an authentication backend. + /// However, it is strongly recommended to use SearchService.Search instead with required OAuth + /// and IAM checks to provide better data security. + /// + /// The body of the request. + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to make + /// the search. + /// + public virtual SearchLiteRequest SearchLite(Google.Apis.DiscoveryEngine.v1.Data.GoogleCloudDiscoveryengineV1SearchRequest body, string servingConfig) + { + return new SearchLiteRequest(this.service, body, servingConfig); + } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that + /// allows API key for authentication, where OAuth and IAM checks are not required. Only public + /// website search is supported by this method. If data stores and engines not associated with + /// public website search are specified, a `FAILED_PRECONDITION` error is returned. This method + /// can be used for easy onboarding without having to implement an authentication backend. + /// However, it is strongly recommended to use SearchService.Search instead with required OAuth + /// and IAM checks to provide better data security. + /// + public class SearchLiteRequest : DiscoveryEngineBaseServiceRequest + { + /// Constructs a new SearchLite request. + public SearchLiteRequest(Google.Apis.Services.IClientService service, Google.Apis.DiscoveryEngine.v1.Data.GoogleCloudDiscoveryengineV1SearchRequest body, string servingConfig) : base(service) + { + ServingConfig = servingConfig; + Body = body; + InitParameters(); + } + + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to + /// make the search. + /// + [Google.Apis.Util.RequestParameterAttribute("servingConfig", Google.Apis.Util.RequestParameterType.Path)] + public virtual string ServingConfig { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.DiscoveryEngine.v1.Data.GoogleCloudDiscoveryengineV1SearchRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "searchLite"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v1/{+servingConfig}:searchLite"; + + /// Initializes SearchLite parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("servingConfig", new Google.Apis.Discovery.Parameter + { + Name = "servingConfig", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + }); + } + } } /// Gets the Sessions resource. @@ -7425,6 +7508,89 @@ protected override void InitParameters() }); } } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that + /// allows API key for authentication, where OAuth and IAM checks are not required. Only public + /// website search is supported by this method. If data stores and engines not associated with + /// public website search are specified, a `FAILED_PRECONDITION` error is returned. This method + /// can be used for easy onboarding without having to implement an authentication backend. + /// However, it is strongly recommended to use SearchService.Search instead with required OAuth + /// and IAM checks to provide better data security. + /// + /// The body of the request. + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to make + /// the search. + /// + public virtual SearchLiteRequest SearchLite(Google.Apis.DiscoveryEngine.v1.Data.GoogleCloudDiscoveryengineV1SearchRequest body, string servingConfig) + { + return new SearchLiteRequest(this.service, body, servingConfig); + } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that + /// allows API key for authentication, where OAuth and IAM checks are not required. Only public + /// website search is supported by this method. If data stores and engines not associated with + /// public website search are specified, a `FAILED_PRECONDITION` error is returned. This method + /// can be used for easy onboarding without having to implement an authentication backend. + /// However, it is strongly recommended to use SearchService.Search instead with required OAuth + /// and IAM checks to provide better data security. + /// + public class SearchLiteRequest : DiscoveryEngineBaseServiceRequest + { + /// Constructs a new SearchLite request. + public SearchLiteRequest(Google.Apis.Services.IClientService service, Google.Apis.DiscoveryEngine.v1.Data.GoogleCloudDiscoveryengineV1SearchRequest body, string servingConfig) : base(service) + { + ServingConfig = servingConfig; + Body = body; + InitParameters(); + } + + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to + /// make the search. + /// + [Google.Apis.Util.RequestParameterAttribute("servingConfig", Google.Apis.Util.RequestParameterType.Path)] + public virtual string ServingConfig { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.DiscoveryEngine.v1.Data.GoogleCloudDiscoveryengineV1SearchRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "searchLite"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v1/{+servingConfig}:searchLite"; + + /// Initializes SearchLite parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("servingConfig", new Google.Apis.Discovery.Parameter + { + Name = "servingConfig", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + }); + } + } } /// Gets the Sessions resource. @@ -11157,6 +11323,89 @@ protected override void InitParameters() }); } } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that allows + /// API key for authentication, where OAuth and IAM checks are not required. Only public website + /// search is supported by this method. If data stores and engines not associated with public + /// website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used + /// for easy onboarding without having to implement an authentication backend. However, it is + /// strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to + /// provide better data security. + /// + /// The body of the request. + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to make the + /// search. + /// + public virtual SearchLiteRequest SearchLite(Google.Apis.DiscoveryEngine.v1.Data.GoogleCloudDiscoveryengineV1SearchRequest body, string servingConfig) + { + return new SearchLiteRequest(this.service, body, servingConfig); + } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that allows + /// API key for authentication, where OAuth and IAM checks are not required. Only public website + /// search is supported by this method. If data stores and engines not associated with public + /// website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used + /// for easy onboarding without having to implement an authentication backend. However, it is + /// strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to + /// provide better data security. + /// + public class SearchLiteRequest : DiscoveryEngineBaseServiceRequest + { + /// Constructs a new SearchLite request. + public SearchLiteRequest(Google.Apis.Services.IClientService service, Google.Apis.DiscoveryEngine.v1.Data.GoogleCloudDiscoveryengineV1SearchRequest body, string servingConfig) : base(service) + { + ServingConfig = servingConfig; + Body = body; + InitParameters(); + } + + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to make + /// the search. + /// + [Google.Apis.Util.RequestParameterAttribute("servingConfig", Google.Apis.Util.RequestParameterType.Path)] + public virtual string ServingConfig { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.DiscoveryEngine.v1.Data.GoogleCloudDiscoveryengineV1SearchRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "searchLite"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v1/{+servingConfig}:searchLite"; + + /// Initializes SearchLite parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("servingConfig", new Google.Apis.Discovery.Parameter + { + Name = "servingConfig", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + }); + } + } } /// Gets the Sessions resource. @@ -14268,9 +14517,251 @@ protected override void InitParameters() } } } -} -namespace Google.Apis.DiscoveryEngine.v1.Data -{ +} +namespace Google.Apis.DiscoveryEngine.v1.Data +{ + /// + /// `Distribution` contains summary statistics for a population of values. It optionally contains a histogram + /// representing the distribution of those values across a set of buckets. The summary statistics are the count, + /// mean, sum of the squared deviation from the mean, the minimum, and the maximum of the set of population of + /// values. The histogram is based on a sequence of buckets and gives a count of values that fall into each bucket. + /// The boundaries of the buckets are given either explicitly or by formulas for buckets of fixed or exponentially + /// increasing widths. Although it is not forbidden, it is generally a bad idea to include non-finite values + /// (infinities or NaNs) in the population of values, as this will render the `mean` and `sum_of_squared_deviation` + /// fields meaningless. + /// + public class GoogleApiDistribution : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// The number of values in each bucket of the histogram, as described in `bucket_options`. If the distribution + /// does not have a histogram, then omit this field. If there is a histogram, then the sum of the values in + /// `bucket_counts` must equal the value in the `count` field of the distribution. If present, `bucket_counts` + /// should contain N values, where N is the number of buckets specified in `bucket_options`. If you supply fewer + /// than N values, the remaining values are assumed to be 0. The order of the values in `bucket_counts` follows + /// the bucket numbering schemes described for the three bucket types. The first value must be the count for the + /// underflow bucket (number 0). The next N-2 values are the counts for the finite buckets (number 1 through + /// N-2). The N'th value in `bucket_counts` is the count for the overflow bucket (number N-1). + /// + [Newtonsoft.Json.JsonPropertyAttribute("bucketCounts")] + public virtual System.Collections.Generic.IList> BucketCounts { get; set; } + + /// + /// Defines the histogram bucket boundaries. If the distribution does not contain a histogram, then omit this + /// field. + /// + [Newtonsoft.Json.JsonPropertyAttribute("bucketOptions")] + public virtual GoogleApiDistributionBucketOptions BucketOptions { get; set; } + + /// + /// The number of values in the population. Must be non-negative. This value must equal the sum of the values in + /// `bucket_counts` if a histogram is provided. + /// + [Newtonsoft.Json.JsonPropertyAttribute("count")] + public virtual System.Nullable Count { get; set; } + + /// Must be in increasing order of `value` field. + [Newtonsoft.Json.JsonPropertyAttribute("exemplars")] + public virtual System.Collections.Generic.IList Exemplars { get; set; } + + /// + /// The arithmetic mean of the values in the population. If `count` is zero then this field must be zero. + /// + [Newtonsoft.Json.JsonPropertyAttribute("mean")] + public virtual System.Nullable Mean { get; set; } + + /// + /// If specified, contains the range of the population values. The field must not be present if the `count` is + /// zero. + /// + [Newtonsoft.Json.JsonPropertyAttribute("range")] + public virtual GoogleApiDistributionRange Range { get; set; } + + /// + /// The sum of squared deviations from the mean of the values in the population. For values x_i this is: + /// Sum[i=1..n]((x_i - mean)^2) Knuth, "The Art of Computer Programming", Vol. 2, page 232, 3rd edition + /// describes Welford's method for accumulating this sum in one pass. If `count` is zero then this field must be + /// zero. + /// + [Newtonsoft.Json.JsonPropertyAttribute("sumOfSquaredDeviation")] + public virtual System.Nullable SumOfSquaredDeviation { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// `BucketOptions` describes the bucket boundaries used to create a histogram for the distribution. The buckets can + /// be in a linear sequence, an exponential sequence, or each bucket can be specified explicitly. `BucketOptions` + /// does not include the number of values in each bucket. A bucket has an inclusive lower bound and exclusive upper + /// bound for the values that are counted for that bucket. The upper bound of a bucket must be strictly greater than + /// the lower bound. The sequence of N buckets for a distribution consists of an underflow bucket (number 0), zero + /// or more finite buckets (number 1 through N - 2) and an overflow bucket (number N - 1). The buckets are + /// contiguous: the lower bound of bucket i (i &gt; 0) is the same as the upper bound of bucket i - 1. The + /// buckets span the whole range of finite values: lower bound of the underflow bucket is -infinity and the upper + /// bound of the overflow bucket is +infinity. The finite buckets are so-called because both bounds are finite. + /// + public class GoogleApiDistributionBucketOptions : Google.Apis.Requests.IDirectResponseSchema + { + /// The explicit buckets. + [Newtonsoft.Json.JsonPropertyAttribute("explicitBuckets")] + public virtual GoogleApiDistributionBucketOptionsExplicit ExplicitBuckets { get; set; } + + /// The exponential buckets. + [Newtonsoft.Json.JsonPropertyAttribute("exponentialBuckets")] + public virtual GoogleApiDistributionBucketOptionsExponential ExponentialBuckets { get; set; } + + /// The linear bucket. + [Newtonsoft.Json.JsonPropertyAttribute("linearBuckets")] + public virtual GoogleApiDistributionBucketOptionsLinear LinearBuckets { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// Specifies a set of buckets with arbitrary widths. There are `size(bounds) + 1` (= N) buckets. Bucket `i` has the + /// following boundaries: Upper bound (0 &lt;= i &lt; N-1): bounds[i] Lower bound (1 &lt;= i &lt; + /// N); bounds[i - 1] The `bounds` field must contain at least one element. If `bounds` has only one element, then + /// there are no finite buckets, and that single element is the common boundary of the overflow and underflow + /// buckets. + /// + public class GoogleApiDistributionBucketOptionsExplicit : Google.Apis.Requests.IDirectResponseSchema + { + /// The values must be monotonically increasing. + [Newtonsoft.Json.JsonPropertyAttribute("bounds")] + public virtual System.Collections.Generic.IList> Bounds { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// Specifies an exponential sequence of buckets that have a width that is proportional to the value of the lower + /// bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket. There are + /// `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 &lt;= i + /// &lt; N-1): scale * (growth_factor ^ i). Lower bound (1 &lt;= i &lt; N): scale * (growth_factor ^ (i + /// - 1)). + /// + public class GoogleApiDistributionBucketOptionsExponential : Google.Apis.Requests.IDirectResponseSchema + { + /// Must be greater than 1. + [Newtonsoft.Json.JsonPropertyAttribute("growthFactor")] + public virtual System.Nullable GrowthFactor { get; set; } + + /// Must be greater than 0. + [Newtonsoft.Json.JsonPropertyAttribute("numFiniteBuckets")] + public virtual System.Nullable NumFiniteBuckets { get; set; } + + /// Must be greater than 0. + [Newtonsoft.Json.JsonPropertyAttribute("scale")] + public virtual System.Nullable Scale { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// Specifies a linear sequence of buckets that all have the same width (except overflow and underflow). Each bucket + /// represents a constant absolute uncertainty on the specific value in the bucket. There are `num_finite_buckets + + /// 2` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 &lt;= i &lt; N-1): offset + + /// (width * i). Lower bound (1 &lt;= i &lt; N): offset + (width * (i - 1)). + /// + public class GoogleApiDistributionBucketOptionsLinear : Google.Apis.Requests.IDirectResponseSchema + { + /// Must be greater than 0. + [Newtonsoft.Json.JsonPropertyAttribute("numFiniteBuckets")] + public virtual System.Nullable NumFiniteBuckets { get; set; } + + /// Lower bound of the first bucket. + [Newtonsoft.Json.JsonPropertyAttribute("offset")] + public virtual System.Nullable Offset { get; set; } + + /// Must be greater than 0. + [Newtonsoft.Json.JsonPropertyAttribute("width")] + public virtual System.Nullable Width { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// Exemplars are example points that may be used to annotate aggregated distribution values. They are metadata that + /// gives information about a particular value added to a Distribution bucket, such as a trace ID that was active + /// when a value was added. They may contain further information, such as a example values and timestamps, origin, + /// etc. + /// + public class GoogleApiDistributionExemplar : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Contextual information about the example value. Examples are: Trace: + /// type.googleapis.com/google.monitoring.v3.SpanContext Literal string: + /// type.googleapis.com/google.protobuf.StringValue Labels dropped during aggregation: + /// type.googleapis.com/google.monitoring.v3.DroppedLabels There may be only a single attachment of any given + /// message type in a single exemplar, and this is enforced by the system. + /// + [Newtonsoft.Json.JsonPropertyAttribute("attachments")] + public virtual System.Collections.Generic.IList> Attachments { get; set; } + + private string _timestampRaw; + + private object _timestamp; + + /// The observation (sampling) time of the above value. + [Newtonsoft.Json.JsonPropertyAttribute("timestamp")] + public virtual string TimestampRaw + { + get => _timestampRaw; + set + { + _timestamp = Google.Apis.Util.Utilities.DeserializeForGoogleFormat(value); + _timestampRaw = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + [System.ObsoleteAttribute("This property is obsolete and may behave unexpectedly; please use TimestampDateTimeOffset instead.")] + public virtual object Timestamp + { + get => _timestamp; + set + { + _timestampRaw = Google.Apis.Util.Utilities.SerializeForGoogleFormat(value); + _timestamp = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + public virtual System.DateTimeOffset? TimestampDateTimeOffset + { + get => Google.Apis.Util.DiscoveryFormat.ParseGoogleDateTimeToDateTimeOffset(TimestampRaw); + set => TimestampRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); + } + + /// Value of the exemplar point. This value determines to which bucket the exemplar belongs. + [Newtonsoft.Json.JsonPropertyAttribute("value")] + public virtual System.Nullable Value { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// The range of the population values. + public class GoogleApiDistributionRange : Google.Apis.Requests.IDirectResponseSchema + { + /// The maximum of the population values. + [Newtonsoft.Json.JsonPropertyAttribute("max")] + public virtual System.Nullable Max { get; set; } + + /// The minimum of the population values. + [Newtonsoft.Json.JsonPropertyAttribute("min")] + public virtual System.Nullable Min { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// /// Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be /// represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and @@ -14304,6 +14795,85 @@ public class GoogleApiHttpBody : Google.Apis.Requests.IDirectResponseSchema public virtual string ETag { get; set; } } + /// + /// A specific metric, identified by specifying values for all of the labels of a `MetricDescriptor`. + /// + public class GoogleApiMetric : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// The set of label values that uniquely identify this metric. All labels listed in the `MetricDescriptor` must + /// be assigned values. + /// + [Newtonsoft.Json.JsonPropertyAttribute("labels")] + public virtual System.Collections.Generic.IDictionary Labels { get; set; } + + /// + /// An existing metric type, see google.api.MetricDescriptor. For example, + /// `custom.googleapis.com/invoice/paid/amount`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("type")] + public virtual string Type { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples + /// include virtual machine instances, databases, and storage devices such as disks. The `type` field identifies a + /// MonitoredResourceDescriptor object that describes the resource's schema. Information in the `labels` field + /// identifies the actual resource and its attributes according to the schema. For example, a particular Compute + /// Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for + /// `"gce_instance"` has labels `"project_id"`, `"instance_id"` and `"zone"`: { "type": "gce_instance", "labels": { + /// "project_id": "my-project", "instance_id": "12345678901234", "zone": "us-central1-a" }} + /// + public class GoogleApiMonitoredResource : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, + /// Compute Engine VM instances use the labels `"project_id"`, `"instance_id"`, and `"zone"`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("labels")] + public virtual System.Collections.Generic.IDictionary Labels { get; set; } + + /// + /// Required. The monitored resource type. This field must match the `type` field of a + /// MonitoredResourceDescriptor object. For example, the type of a Compute Engine VM instance is `gce_instance`. + /// Some descriptors include the service name in the type; for example, the type of a Datastream stream is + /// `datastream.googleapis.com/Stream`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("type")] + public virtual string Type { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// Auxiliary metadata for a MonitoredResource object. MonitoredResource objects contain the minimum set of + /// information to uniquely identify a monitored resource instance. There is some other useful auxiliary metadata. + /// Monitoring and Logging use an ingestion pipeline to extract metadata for cloud resources of all types, and store + /// the metadata in this message. + /// + public class GoogleApiMonitoredResourceMetadata : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Output only. Values for predefined system metadata labels. System labels are a kind of metadata extracted by + /// Google, including "machine_image", "vpc", "subnet_id", "security_group", "name", etc. System label values + /// can be only strings, Boolean values, or a list of strings. For example: { "name": "my-test-instance", + /// "security_group": ["a", "b", "c"], "spot_instance": false } + /// + [Newtonsoft.Json.JsonPropertyAttribute("systemLabels")] + public virtual System.Collections.Generic.IDictionary SystemLabels { get; set; } + + /// Output only. A map of user-defined metadata labels. + [Newtonsoft.Json.JsonPropertyAttribute("userLabels")] + public virtual System.Collections.Generic.IDictionary UserLabels { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// A description of the context in which an error occurred. public class GoogleCloudDiscoveryengineLoggingErrorContext : Google.Apis.Requests.IDirectResponseSchema { @@ -14660,6 +15230,10 @@ public class GoogleCloudDiscoveryengineV1AnswerQueryRequest : Google.Apis.Reques [Newtonsoft.Json.JsonPropertyAttribute("asynchronousMode")] public virtual System.Nullable AsynchronousMode { get; set; } + /// Optional. Grounding specification. + [Newtonsoft.Json.JsonPropertyAttribute("groundingSpec")] + public virtual GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec GroundingSpec { get; set; } + /// Required. Current user query. [Newtonsoft.Json.JsonPropertyAttribute("query")] public virtual GoogleCloudDiscoveryengineV1Query Query { get; set; } @@ -14806,6 +15380,21 @@ public class GoogleCloudDiscoveryengineV1AnswerQueryRequestAnswerGenerationSpecP public virtual string ETag { get; set; } } + /// Grounding specification. + public class GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When + /// this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports + /// for each claim. + /// + [Newtonsoft.Json.JsonPropertyAttribute("includeGroundingSupports")] + public virtual System.Nullable IncludeGroundingSupports { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Query understanding specification. public class GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpec : Google.Apis.Requests.IDirectResponseSchema { @@ -22805,10 +23394,10 @@ public virtual System.DateTimeOffset? EventTimeDateTimeOffset /// Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * /// `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of /// Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. - /// Home &gt; Men &gt; Jeans Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in - /// Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume - /// watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, - /// etc. + /// Home &gt; Men &gt; Jeans * `add-feedback`: Add a user feedback. Retail-related values: * + /// `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) + /// Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * + /// `media-complete`: Finished or stopped midway through a video, song, etc. /// [Newtonsoft.Json.JsonPropertyAttribute("eventType")] public virtual string EventType { get; set; } @@ -23846,6 +24435,17 @@ public class GoogleCloudDiscoveryengineV1alphaControlSynonymsAction : Google.Api public virtual string ETag { get; set; } } + /// The historical crawl rate timeseries data, used for monitoring. + public class GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries : Google.Apis.Requests.IDirectResponseSchema + { + /// The QPS of the crawl rate. + [Newtonsoft.Json.JsonPropertyAttribute("qpsTimeSeries")] + public virtual GoogleMonitoringV3TimeSeries QpsTimeSeries { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// /// Metadata related to the progress of the DataStoreService.CreateDataStore operation. This will be returned by the /// google.longrunning.Operation.metadata field. @@ -24605,6 +25205,32 @@ public class GoogleCloudDiscoveryengineV1alphaDataStoreServingConfigDataStore : public virtual string ETag { get; set; } } + /// + /// The historical dedicated crawl rate timeseries data, used for monitoring. Dedicated crawl is used by Vertex AI + /// to crawl the user's website when dedicate crawl is set. + /// + public class GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Vertex AI's dedicated crawl rate time series of auto-refresh, which is the crawl rate of + /// Google-CloudVertexBot when dedicate crawl is set, and the crawl rate is for best effort use cases like + /// refreshing urls periodically. + /// + [Newtonsoft.Json.JsonPropertyAttribute("autoRefreshCrawlRate")] + public virtual GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries AutoRefreshCrawlRate { get; set; } + + /// + /// Vertex AI's dedicated crawl rate time series of user triggered crawl, which is the crawl rate of + /// Google-CloudVertexBot when dedicate crawl is set, and user triggered crawl rate is for deterministic use + /// cases like crawling urls or sitemaps specified by users. + /// + [Newtonsoft.Json.JsonPropertyAttribute("userTriggeredCrawlRate")] + public virtual GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries UserTriggeredCrawlRate { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// /// Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the /// google.longrunning.Operation.metadata field. @@ -26691,6 +27317,60 @@ public class GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingC public virtual string ETag { get; set; } } + /// + /// Response message for CrawlRateManagementService.ObtainCrawlRate method. The response contains organcic or + /// dedicated crawl rate time series data for monitoring, depending on whether dedicated crawl rate is set. + /// + public class GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse : Google.Apis.Requests.IDirectResponseSchema + { + /// The historical dedicated crawl rate timeseries data, used for monitoring. + [Newtonsoft.Json.JsonPropertyAttribute("dedicatedCrawlRateTimeSeries")] + public virtual GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries DedicatedCrawlRateTimeSeries { get; set; } + + /// Errors from service when handling the request. + [Newtonsoft.Json.JsonPropertyAttribute("error")] + public virtual GoogleRpcStatus Error { get; set; } + + /// The historical organic crawl rate timeseries data, used for monitoring. + [Newtonsoft.Json.JsonPropertyAttribute("organicCrawlRateTimeSeries")] + public virtual GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries OrganicCrawlRateTimeSeries { get; set; } + + /// Output only. The state of the response. + [Newtonsoft.Json.JsonPropertyAttribute("state")] + public virtual string State { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// The historical organic crawl rate timeseries data, used for monitoring. Organic crawl is auto-determined by + /// Google to crawl the user's website when dedicate crawl is not set. Crawl rate is the QPS of crawl request Google + /// sends to the user's website. + /// + public class GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Google's organic crawl rate time series, which is the sum of all googlebots' crawl rate. Please refer to + /// https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers for more details about + /// googlebots. + /// + [Newtonsoft.Json.JsonPropertyAttribute("googleOrganicCrawlRate")] + public virtual GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries GoogleOrganicCrawlRate { get; set; } + + /// + /// Vertex AI's organic crawl rate time series, which is the crawl rate of Google-CloudVertexBot when dedicate + /// crawl is not set. Please refer to + /// https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot for + /// more details about Google-CloudVertexBot. + /// + [Newtonsoft.Json.JsonPropertyAttribute("vertexAiOrganicCrawlRate")] + public virtual GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries VertexAiOrganicCrawlRate { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Metadata and configurations for a Google Cloud project in the service. public class GoogleCloudDiscoveryengineV1alphaProject : Google.Apis.Requests.IDirectResponseSchema { @@ -34246,6 +34926,220 @@ public class GoogleLongrunningOperation : Google.Apis.Requests.IDirectResponseSc public virtual string ETag { get; set; } } + /// A single data point in a time series. + public class GoogleMonitoringV3Point : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// The time interval to which the data point applies. For `GAUGE` metrics, the start time is optional, but if + /// it is supplied, it must equal the end time. For `DELTA` metrics, the start and end time should specify a + /// non-zero interval, with subsequent points specifying contiguous and non-overlapping intervals. For + /// `CUMULATIVE` metrics, the start and end time should specify a non-zero interval, with subsequent points + /// specifying the same start time and increasing end times, until an event resets the cumulative value to zero + /// and sets a new start time for the following points. + /// + [Newtonsoft.Json.JsonPropertyAttribute("interval")] + public virtual GoogleMonitoringV3TimeInterval Interval { get; set; } + + /// The value of the data point. + [Newtonsoft.Json.JsonPropertyAttribute("value")] + public virtual GoogleMonitoringV3TypedValue Value { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// A time interval extending just after a start time through an end time. If the start time is the same as the end + /// time, then the interval represents a single point in time. + /// + public class GoogleMonitoringV3TimeInterval : Google.Apis.Requests.IDirectResponseSchema + { + private string _endTimeRaw; + + private object _endTime; + + /// Required. The end of the time interval. + [Newtonsoft.Json.JsonPropertyAttribute("endTime")] + public virtual string EndTimeRaw + { + get => _endTimeRaw; + set + { + _endTime = Google.Apis.Util.Utilities.DeserializeForGoogleFormat(value); + _endTimeRaw = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + [System.ObsoleteAttribute("This property is obsolete and may behave unexpectedly; please use EndTimeDateTimeOffset instead.")] + public virtual object EndTime + { + get => _endTime; + set + { + _endTimeRaw = Google.Apis.Util.Utilities.SerializeForGoogleFormat(value); + _endTime = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + public virtual System.DateTimeOffset? EndTimeDateTimeOffset + { + get => Google.Apis.Util.DiscoveryFormat.ParseGoogleDateTimeToDateTimeOffset(EndTimeRaw); + set => EndTimeRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); + } + + private string _startTimeRaw; + + private object _startTime; + + /// + /// Optional. The beginning of the time interval. The default value for the start time is the end time. The + /// start time must not be later than the end time. + /// + [Newtonsoft.Json.JsonPropertyAttribute("startTime")] + public virtual string StartTimeRaw + { + get => _startTimeRaw; + set + { + _startTime = Google.Apis.Util.Utilities.DeserializeForGoogleFormat(value); + _startTimeRaw = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + [System.ObsoleteAttribute("This property is obsolete and may behave unexpectedly; please use StartTimeDateTimeOffset instead.")] + public virtual object StartTime + { + get => _startTime; + set + { + _startTimeRaw = Google.Apis.Util.Utilities.SerializeForGoogleFormat(value); + _startTime = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + public virtual System.DateTimeOffset? StartTimeDateTimeOffset + { + get => Google.Apis.Util.DiscoveryFormat.ParseGoogleDateTimeToDateTimeOffset(StartTimeRaw); + set => StartTimeRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); + } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// A collection of data points that describes the time-varying values of a metric. A time series is identified by a + /// combination of a fully-specified monitored resource and a fully-specified metric. This type is used for both + /// listing and creating time series. + /// + public class GoogleMonitoringV3TimeSeries : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Input only. A detailed description of the time series that will be associated with the + /// google.api.MetricDescriptor for the metric. Once set, this field cannot be changed through CreateTimeSeries. + /// + [Newtonsoft.Json.JsonPropertyAttribute("description")] + public virtual string Description { get; set; } + + /// + /// Output only. The associated monitored resource metadata. When reading a time series, this field will include + /// metadata labels that are explicitly named in the reduction. When creating a time series, this field is + /// ignored. + /// + [Newtonsoft.Json.JsonPropertyAttribute("metadata")] + public virtual GoogleApiMonitoredResourceMetadata Metadata { get; set; } + + /// The associated metric. A fully-specified metric used to identify the time series. + [Newtonsoft.Json.JsonPropertyAttribute("metric")] + public virtual GoogleApiMetric Metric { get; set; } + + /// + /// The metric kind of the time series. When listing time series, this metric kind might be different from the + /// metric kind of the associated metric if this time series is an alignment or reduction of other time series. + /// When creating a time series, this field is optional. If present, it must be the same as the metric kind of + /// the associated metric. If the associated metric's descriptor must be auto-created, then this field specifies + /// the metric kind of the new descriptor and must be either `GAUGE` (the default) or `CUMULATIVE`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("metricKind")] + public virtual string MetricKind { get; set; } + + /// + /// The data points of this time series. When listing time series, points are returned in reverse time order. + /// When creating a time series, this field must contain exactly one point and the point's type must be the same + /// as the value type of the associated metric. If the associated metric's descriptor must be auto-created, then + /// the value type of the descriptor is determined by the point's type, which must be `BOOL`, `INT64`, `DOUBLE`, + /// or `DISTRIBUTION`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("points")] + public virtual System.Collections.Generic.IList Points { get; set; } + + /// + /// The associated monitored resource. Custom metrics can use only certain monitored resource types in their + /// time series data. For more information, see [Monitored resources for custom + /// metrics](https://cloud.google.com/monitoring/custom-metrics/creating-metrics#custom-metric-resources). + /// + [Newtonsoft.Json.JsonPropertyAttribute("resource")] + public virtual GoogleApiMonitoredResource Resource { get; set; } + + /// + /// The units in which the metric value is reported. It is only applicable if the `value_type` is `INT64`, + /// `DOUBLE`, or `DISTRIBUTION`. The `unit` defines the representation of the stored metric values. This field + /// can only be changed through CreateTimeSeries when it is empty. + /// + [Newtonsoft.Json.JsonPropertyAttribute("unit")] + public virtual string Unit { get; set; } + + /// + /// The value type of the time series. When listing time series, this value type might be different from the + /// value type of the associated metric if this time series is an alignment or reduction of other time series. + /// When creating a time series, this field is optional. If present, it must be the same as the type of the data + /// in the `points` field. + /// + [Newtonsoft.Json.JsonPropertyAttribute("valueType")] + public virtual string ValueType { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// A single strongly-typed value. + public class GoogleMonitoringV3TypedValue : Google.Apis.Requests.IDirectResponseSchema + { + /// A Boolean value: `true` or `false`. + [Newtonsoft.Json.JsonPropertyAttribute("boolValue")] + public virtual System.Nullable BoolValue { get; set; } + + /// A distribution value. + [Newtonsoft.Json.JsonPropertyAttribute("distributionValue")] + public virtual GoogleApiDistribution DistributionValue { get; set; } + + /// + /// A 64-bit double-precision floating-point number. Its magnitude is approximately ±10±300 and it has 16 + /// significant digits of precision. + /// + [Newtonsoft.Json.JsonPropertyAttribute("doubleValue")] + public virtual System.Nullable DoubleValue { get; set; } + + /// A 64-bit integer. Its range is approximately ±9.2x1018. + [Newtonsoft.Json.JsonPropertyAttribute("int64Value")] + public virtual System.Nullable Int64Value { get; set; } + + /// A variable-length string value. + [Newtonsoft.Json.JsonPropertyAttribute("stringValue")] + public virtual string StringValue { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// /// A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical /// example is to use it as the request or the response type of an API method. For instance: service Foo { rpc diff --git a/Src/Generated/Google.Apis.DiscoveryEngine.v1/Google.Apis.DiscoveryEngine.v1.csproj b/Src/Generated/Google.Apis.DiscoveryEngine.v1/Google.Apis.DiscoveryEngine.v1.csproj index f6705652fd2..70f252a1e05 100644 --- a/Src/Generated/Google.Apis.DiscoveryEngine.v1/Google.Apis.DiscoveryEngine.v1.csproj +++ b/Src/Generated/Google.Apis.DiscoveryEngine.v1/Google.Apis.DiscoveryEngine.v1.csproj @@ -3,7 +3,7 @@ Google.Apis.DiscoveryEngine.v1 Client Library - 1.68.0.3580 + 1.68.0.3585 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.DiscoveryEngine.v1alpha/Google.Apis.DiscoveryEngine.v1alpha.cs b/Src/Generated/Google.Apis.DiscoveryEngine.v1alpha/Google.Apis.DiscoveryEngine.v1alpha.cs index 45b6e67c3b9..a3b75acb7a4 100644 --- a/Src/Generated/Google.Apis.DiscoveryEngine.v1alpha/Google.Apis.DiscoveryEngine.v1alpha.cs +++ b/Src/Generated/Google.Apis.DiscoveryEngine.v1alpha/Google.Apis.DiscoveryEngine.v1alpha.cs @@ -726,6 +726,7 @@ public DataStoresResource(Google.Apis.Services.IClientService service) { this.service = service; Branches = new BranchesResource(service); + CompletionConfig = new CompletionConfigResource(service); CompletionSuggestions = new CompletionSuggestionsResource(service); Controls = new ControlsResource(service); Conversations = new ConversationsResource(service); @@ -1886,6 +1887,87 @@ protected override void InitParameters() } } + /// Gets the CompletionConfig resource. + public virtual CompletionConfigResource CompletionConfig { get; } + + /// The "completionConfig" collection of methods. + public class CompletionConfigResource + { + private const string Resource = "completionConfig"; + + /// The service which this resource belongs to. + private readonly Google.Apis.Services.IClientService service; + + /// Constructs a new resource. + public CompletionConfigResource(Google.Apis.Services.IClientService service) + { + this.service = service; + } + + /// Completes the user input with advanced keyword suggestions. + /// The body of the request. + /// + /// Required. The completion_config of the parent dataStore or engine resource name for which + /// the completion is performed, such as + /// `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` + /// `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`. + /// + public virtual CompleteQueryRequest CompleteQuery(Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest body, string completionConfig) + { + return new CompleteQueryRequest(this.service, body, completionConfig); + } + + /// Completes the user input with advanced keyword suggestions. + public class CompleteQueryRequest : DiscoveryEngineBaseServiceRequest + { + /// Constructs a new CompleteQuery request. + public CompleteQueryRequest(Google.Apis.Services.IClientService service, Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest body, string completionConfig) : base(service) + { + CompletionConfig = completionConfig; + Body = body; + InitParameters(); + } + + /// + /// Required. The completion_config of the parent dataStore or engine resource name for + /// which the completion is performed, such as + /// `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` + /// `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`. + /// + [Google.Apis.Util.RequestParameterAttribute("completionConfig", Google.Apis.Util.RequestParameterType.Path)] + public virtual string CompletionConfig { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "completeQuery"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v1alpha/{+completionConfig}:completeQuery"; + + /// Initializes CompleteQuery parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("completionConfig", new Google.Apis.Discovery.Parameter + { + Name = "completionConfig", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/completionConfig$", + }); + } + } + } + /// Gets the CompletionSuggestions resource. public virtual CompletionSuggestionsResource CompletionSuggestions { get; } @@ -4215,6 +4297,89 @@ protected override void InitParameters() }); } } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that + /// allows API key for authentication, where OAuth and IAM checks are not required. Only public + /// website search is supported by this method. If data stores and engines not associated with + /// public website search are specified, a `FAILED_PRECONDITION` error is returned. This method + /// can be used for easy onboarding without having to implement an authentication backend. + /// However, it is strongly recommended to use SearchService.Search instead with required OAuth + /// and IAM checks to provide better data security. + /// + /// The body of the request. + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to make + /// the search. + /// + public virtual SearchLiteRequest SearchLite(Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaSearchRequest body, string servingConfig) + { + return new SearchLiteRequest(this.service, body, servingConfig); + } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that + /// allows API key for authentication, where OAuth and IAM checks are not required. Only public + /// website search is supported by this method. If data stores and engines not associated with + /// public website search are specified, a `FAILED_PRECONDITION` error is returned. This method + /// can be used for easy onboarding without having to implement an authentication backend. + /// However, it is strongly recommended to use SearchService.Search instead with required OAuth + /// and IAM checks to provide better data security. + /// + public class SearchLiteRequest : DiscoveryEngineBaseServiceRequest + { + /// Constructs a new SearchLite request. + public SearchLiteRequest(Google.Apis.Services.IClientService service, Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaSearchRequest body, string servingConfig) : base(service) + { + ServingConfig = servingConfig; + Body = body; + InitParameters(); + } + + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to + /// make the search. + /// + [Google.Apis.Util.RequestParameterAttribute("servingConfig", Google.Apis.Util.RequestParameterType.Path)] + public virtual string ServingConfig { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaSearchRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "searchLite"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v1alpha/{+servingConfig}:searchLite"; + + /// Initializes SearchLite parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("servingConfig", new Google.Apis.Discovery.Parameter + { + Name = "servingConfig", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + }); + } + } } /// Gets the Sessions resource. @@ -7161,6 +7326,7 @@ public class EnginesResource public EnginesResource(Google.Apis.Services.IClientService service) { this.service = service; + CompletionConfig = new CompletionConfigResource(service); Controls = new ControlsResource(service); Conversations = new ConversationsResource(service); Operations = new OperationsResource(service); @@ -7168,6 +7334,87 @@ public EnginesResource(Google.Apis.Services.IClientService service) Sessions = new SessionsResource(service); } + /// Gets the CompletionConfig resource. + public virtual CompletionConfigResource CompletionConfig { get; } + + /// The "completionConfig" collection of methods. + public class CompletionConfigResource + { + private const string Resource = "completionConfig"; + + /// The service which this resource belongs to. + private readonly Google.Apis.Services.IClientService service; + + /// Constructs a new resource. + public CompletionConfigResource(Google.Apis.Services.IClientService service) + { + this.service = service; + } + + /// Completes the user input with advanced keyword suggestions. + /// The body of the request. + /// + /// Required. The completion_config of the parent dataStore or engine resource name for which + /// the completion is performed, such as + /// `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` + /// `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`. + /// + public virtual CompleteQueryRequest CompleteQuery(Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest body, string completionConfig) + { + return new CompleteQueryRequest(this.service, body, completionConfig); + } + + /// Completes the user input with advanced keyword suggestions. + public class CompleteQueryRequest : DiscoveryEngineBaseServiceRequest + { + /// Constructs a new CompleteQuery request. + public CompleteQueryRequest(Google.Apis.Services.IClientService service, Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest body, string completionConfig) : base(service) + { + CompletionConfig = completionConfig; + Body = body; + InitParameters(); + } + + /// + /// Required. The completion_config of the parent dataStore or engine resource name for + /// which the completion is performed, such as + /// `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` + /// `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`. + /// + [Google.Apis.Util.RequestParameterAttribute("completionConfig", Google.Apis.Util.RequestParameterType.Path)] + public virtual string CompletionConfig { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "completeQuery"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v1alpha/{+completionConfig}:completeQuery"; + + /// Initializes CompleteQuery parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("completionConfig", new Google.Apis.Discovery.Parameter + { + Name = "completionConfig", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/completionConfig$", + }); + } + } + } + /// Gets the Controls resource. public virtual ControlsResource Controls { get; } @@ -8603,6 +8850,89 @@ protected override void InitParameters() }); } } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that + /// allows API key for authentication, where OAuth and IAM checks are not required. Only public + /// website search is supported by this method. If data stores and engines not associated with + /// public website search are specified, a `FAILED_PRECONDITION` error is returned. This method + /// can be used for easy onboarding without having to implement an authentication backend. + /// However, it is strongly recommended to use SearchService.Search instead with required OAuth + /// and IAM checks to provide better data security. + /// + /// The body of the request. + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to make + /// the search. + /// + public virtual SearchLiteRequest SearchLite(Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaSearchRequest body, string servingConfig) + { + return new SearchLiteRequest(this.service, body, servingConfig); + } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that + /// allows API key for authentication, where OAuth and IAM checks are not required. Only public + /// website search is supported by this method. If data stores and engines not associated with + /// public website search are specified, a `FAILED_PRECONDITION` error is returned. This method + /// can be used for easy onboarding without having to implement an authentication backend. + /// However, it is strongly recommended to use SearchService.Search instead with required OAuth + /// and IAM checks to provide better data security. + /// + public class SearchLiteRequest : DiscoveryEngineBaseServiceRequest + { + /// Constructs a new SearchLite request. + public SearchLiteRequest(Google.Apis.Services.IClientService service, Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaSearchRequest body, string servingConfig) : base(service) + { + ServingConfig = servingConfig; + Body = body; + InitParameters(); + } + + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to + /// make the search. + /// + [Google.Apis.Util.RequestParameterAttribute("servingConfig", Google.Apis.Util.RequestParameterType.Path)] + public virtual string ServingConfig { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaSearchRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "searchLite"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v1alpha/{+servingConfig}:searchLite"; + + /// Initializes SearchLite parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("servingConfig", new Google.Apis.Discovery.Parameter + { + Name = "servingConfig", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + }); + } + } } /// Gets the Sessions resource. @@ -9776,6 +10106,7 @@ public DataStoresResource(Google.Apis.Services.IClientService service) { this.service = service; Branches = new BranchesResource(service); + CompletionConfig = new CompletionConfigResource(service); CompletionSuggestions = new CompletionSuggestionsResource(service); Controls = new ControlsResource(service); Conversations = new ConversationsResource(service); @@ -10927,6 +11258,87 @@ protected override void InitParameters() } } + /// Gets the CompletionConfig resource. + public virtual CompletionConfigResource CompletionConfig { get; } + + /// The "completionConfig" collection of methods. + public class CompletionConfigResource + { + private const string Resource = "completionConfig"; + + /// The service which this resource belongs to. + private readonly Google.Apis.Services.IClientService service; + + /// Constructs a new resource. + public CompletionConfigResource(Google.Apis.Services.IClientService service) + { + this.service = service; + } + + /// Completes the user input with advanced keyword suggestions. + /// The body of the request. + /// + /// Required. The completion_config of the parent dataStore or engine resource name for which the + /// completion is performed, such as + /// `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` + /// `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`. + /// + public virtual CompleteQueryRequest CompleteQuery(Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest body, string completionConfig) + { + return new CompleteQueryRequest(this.service, body, completionConfig); + } + + /// Completes the user input with advanced keyword suggestions. + public class CompleteQueryRequest : DiscoveryEngineBaseServiceRequest + { + /// Constructs a new CompleteQuery request. + public CompleteQueryRequest(Google.Apis.Services.IClientService service, Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest body, string completionConfig) : base(service) + { + CompletionConfig = completionConfig; + Body = body; + InitParameters(); + } + + /// + /// Required. The completion_config of the parent dataStore or engine resource name for which + /// the completion is performed, such as + /// `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` + /// `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`. + /// + [Google.Apis.Util.RequestParameterAttribute("completionConfig", Google.Apis.Util.RequestParameterType.Path)] + public virtual string CompletionConfig { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "completeQuery"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v1alpha/{+completionConfig}:completeQuery"; + + /// Initializes CompleteQuery parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("completionConfig", new Google.Apis.Discovery.Parameter + { + Name = "completionConfig", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/completionConfig$", + }); + } + } + } + /// Gets the CompletionSuggestions resource. public virtual CompletionSuggestionsResource CompletionSuggestions { get; } @@ -13023,6 +13435,89 @@ protected override void InitParameters() }); } } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that allows + /// API key for authentication, where OAuth and IAM checks are not required. Only public website + /// search is supported by this method. If data stores and engines not associated with public + /// website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used + /// for easy onboarding without having to implement an authentication backend. However, it is + /// strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to + /// provide better data security. + /// + /// The body of the request. + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to make the + /// search. + /// + public virtual SearchLiteRequest SearchLite(Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaSearchRequest body, string servingConfig) + { + return new SearchLiteRequest(this.service, body, servingConfig); + } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that allows + /// API key for authentication, where OAuth and IAM checks are not required. Only public website + /// search is supported by this method. If data stores and engines not associated with public + /// website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used + /// for easy onboarding without having to implement an authentication backend. However, it is + /// strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to + /// provide better data security. + /// + public class SearchLiteRequest : DiscoveryEngineBaseServiceRequest + { + /// Constructs a new SearchLite request. + public SearchLiteRequest(Google.Apis.Services.IClientService service, Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaSearchRequest body, string servingConfig) : base(service) + { + ServingConfig = servingConfig; + Body = body; + InitParameters(); + } + + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to make + /// the search. + /// + [Google.Apis.Util.RequestParameterAttribute("servingConfig", Google.Apis.Util.RequestParameterType.Path)] + public virtual string ServingConfig { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.DiscoveryEngine.v1alpha.Data.GoogleCloudDiscoveryengineV1alphaSearchRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "searchLite"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v1alpha/{+servingConfig}:searchLite"; + + /// Initializes SearchLite parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("servingConfig", new Google.Apis.Discovery.Parameter + { + Name = "servingConfig", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + }); + } + } } /// Gets the Sessions resource. @@ -18416,6 +18911,29 @@ public class GoogleApiHttpBody : Google.Apis.Requests.IDirectResponseSchema public virtual string ETag { get; set; } } + /// + /// A specific metric, identified by specifying values for all of the labels of a `MetricDescriptor`. + /// + public class GoogleApiMetric : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// The set of label values that uniquely identify this metric. All labels listed in the `MetricDescriptor` must + /// be assigned values. + /// + [Newtonsoft.Json.JsonPropertyAttribute("labels")] + public virtual System.Collections.Generic.IDictionary Labels { get; set; } + + /// + /// An existing metric type, see google.api.MetricDescriptor. For example, + /// `custom.googleapis.com/invoice/paid/amount`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("type")] + public virtual string Type { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// /// An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples /// include virtual machine instances, databases, and storage devices such as disks. The `type` field identifies a @@ -18447,6 +18965,31 @@ public class GoogleApiMonitoredResource : Google.Apis.Requests.IDirectResponseSc public virtual string ETag { get; set; } } + /// + /// Auxiliary metadata for a MonitoredResource object. MonitoredResource objects contain the minimum set of + /// information to uniquely identify a monitored resource instance. There is some other useful auxiliary metadata. + /// Monitoring and Logging use an ingestion pipeline to extract metadata for cloud resources of all types, and store + /// the metadata in this message. + /// + public class GoogleApiMonitoredResourceMetadata : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Output only. Values for predefined system metadata labels. System labels are a kind of metadata extracted by + /// Google, including "machine_image", "vpc", "subnet_id", "security_group", "name", etc. System label values + /// can be only strings, Boolean values, or a list of strings. For example: { "name": "my-test-instance", + /// "security_group": ["a", "b", "c"], "spot_instance": false } + /// + [Newtonsoft.Json.JsonPropertyAttribute("systemLabels")] + public virtual System.Collections.Generic.IDictionary SystemLabels { get; set; } + + /// Output only. A map of user-defined metadata labels. + [Newtonsoft.Json.JsonPropertyAttribute("userLabels")] + public virtual System.Collections.Generic.IDictionary UserLabels { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// A description of the context in which an error occurred. public class GoogleCloudDiscoveryengineLoggingErrorContext : Google.Apis.Requests.IDirectResponseSchema { @@ -22083,6 +22626,273 @@ public class GoogleCloudDiscoveryengineV1alphaAclConfig : Google.Apis.Requests.I public virtual string ETag { get; set; } } + /// Request message for CompletionService.AdvancedCompleteQuery method. . + public class GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest : Google.Apis.Requests.IDirectResponseSchema + { + /// Optional. Specification to boost suggestions matching the condition. + [Newtonsoft.Json.JsonPropertyAttribute("boostSpec")] + public virtual GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpec BoostSpec { get; set; } + + /// + /// Indicates if tail suggestions should be returned if there are no suggestions that match the full query. Even + /// if set to true, if there are suggestions that match the full query, those are returned and no tail + /// suggestions are returned. + /// + [Newtonsoft.Json.JsonPropertyAttribute("includeTailSuggestions")] + public virtual System.Nullable IncludeTailSuggestions { get; set; } + + /// + /// Required. The typeahead input used to fetch suggestions. Maximum length is 128 characters. The query can not + /// be empty for most of the suggestion types. If it is empty, an `INVALID_ARGUMENT` error is returned. The + /// exception is when the suggestion_types contains only the type `RECENT_SEARCH`, the query can be an empty + /// string. The is called "zero prefix" feature, which returns user's recently searched queries given the empty + /// query. + /// + [Newtonsoft.Json.JsonPropertyAttribute("query")] + public virtual string Query { get; set; } + + /// + /// Specifies the autocomplete data model. This overrides any model specified in the Configuration &gt; + /// Autocomplete section of the Cloud console. Currently supported values: * `document` - Using suggestions + /// generated from user-imported documents. * `search-history` - Using suggestions generated from the past + /// history of SearchService.Search API calls. Do not use it when there is no traffic for Search API. * + /// `user-event` - Using suggestions generated from user-imported search events. * `document-completable` - + /// Using suggestions taken directly from user-imported document fields marked as completable. Default values: * + /// `document` is the default model for regular dataStores. * `search-history` is the default model for site + /// search dataStores. + /// + [Newtonsoft.Json.JsonPropertyAttribute("queryModel")] + public virtual string QueryModel { get; set; } + + /// + /// Optional. Suggestion types to return. If empty or unspecified, query suggestions are returned. Only one + /// suggestion type is supported at the moment. + /// + [Newtonsoft.Json.JsonPropertyAttribute("suggestionTypes")] + public virtual System.Collections.Generic.IList SuggestionTypes { get; set; } + + /// + /// Optional. Information about the end user. This should be the same identifier information as + /// UserEvent.user_info and SearchRequest.user_info. + /// + [Newtonsoft.Json.JsonPropertyAttribute("userInfo")] + public virtual GoogleCloudDiscoveryengineV1alphaUserInfo UserInfo { get; set; } + + /// + /// A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which + /// should be able to uniquely identify a visitor on a single device. This unique identifier should not change + /// if the visitor logs in or out of the website. This field should NOT have a fixed value such as + /// `unknown_visitor`. This should be the same identifier as UserEvent.user_pseudo_id and + /// SearchRequest.user_pseudo_id. The field must be a UTF-8 encoded string with a length limit of 128 + /// + [Newtonsoft.Json.JsonPropertyAttribute("userPseudoId")] + public virtual string UserPseudoId { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Specification to boost suggestions based on the condtion of the suggestion. + public class GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpec : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Condition boost specifications. If a suggestion matches multiple conditions in the specifictions, boost + /// values from these specifications are all applied and combined in a non-linear way. Maximum number of + /// specifications is 20. Note: Currently only support language condition boost. + /// + [Newtonsoft.Json.JsonPropertyAttribute("conditionBoostSpecs")] + public virtual System.Collections.Generic.IList ConditionBoostSpecs { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Boost applies to suggestions which match a condition. + public class GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to + /// 1.0 gives the suggestions a big promotion. However, it does not necessarily mean that the top result will be + /// a boosted suggestion. Setting to -1.0 gives the suggestions a big demotion. However, other suggestions that + /// are relevant might still be shown. Setting to 0.0 means no boost applied. The boosting condition is ignored. + /// + [Newtonsoft.Json.JsonPropertyAttribute("boost")] + public virtual System.Nullable Boost { get; set; } + + /// + /// An expression which specifies a boost condition. The syntax is the same as [filter expression + /// syntax](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax). + /// Currently, the only supported condition is a list of BCP-47 lang codes. Example: * To boost suggestions in + /// languages `en` or `fr`: `(lang_code: ANY("en", "fr"))` + /// + [Newtonsoft.Json.JsonPropertyAttribute("condition")] + public virtual string Condition { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Response message for CompletionService.AdvancedCompleteQuery method. + public class GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Results of the matched content suggestions. The result list is ordered and the first result is the top + /// suggestion. + /// + [Newtonsoft.Json.JsonPropertyAttribute("contentSuggestions")] + public virtual System.Collections.Generic.IList ContentSuggestions { get; set; } + + /// + /// Results of the matched people suggestions. The result list is ordered and the first result is the top + /// suggestion. + /// + [Newtonsoft.Json.JsonPropertyAttribute("peopleSuggestions")] + public virtual System.Collections.Generic.IList PeopleSuggestions { get; set; } + + /// + /// Results of the matched query suggestions. The result list is ordered and the first result is a top + /// suggestion. + /// + [Newtonsoft.Json.JsonPropertyAttribute("querySuggestions")] + public virtual System.Collections.Generic.IList QuerySuggestions { get; set; } + + /// + /// Results of the matched "recent search" suggestions. The result list is ordered and the first result is the + /// top suggestion. + /// + [Newtonsoft.Json.JsonPropertyAttribute("recentSearchSuggestions")] + public virtual System.Collections.Generic.IList RecentSearchSuggestions { get; set; } + + /// + /// True if the returned suggestions are all tail suggestions. For tail matching to be triggered, + /// include_tail_suggestions in the request must be true and there must be no suggestions that match the full + /// query. + /// + [Newtonsoft.Json.JsonPropertyAttribute("tailMatchTriggered")] + public virtual System.Nullable TailMatchTriggered { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Suggestions as content. + public class GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseContentSuggestion : Google.Apis.Requests.IDirectResponseSchema + { + /// The type of the content suggestion. + [Newtonsoft.Json.JsonPropertyAttribute("contentType")] + public virtual string ContentType { get; set; } + + /// The name of the dataStore that this suggestion belongs to. + [Newtonsoft.Json.JsonPropertyAttribute("dataStore")] + public virtual string DataStore { get; set; } + + /// The document data snippet in the suggestion. Only a subset of fields will be populated. + [Newtonsoft.Json.JsonPropertyAttribute("document")] + public virtual GoogleCloudDiscoveryengineV1alphaDocument Document { get; set; } + + /// The suggestion for the query. + [Newtonsoft.Json.JsonPropertyAttribute("suggestion")] + public virtual string Suggestion { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Suggestions as people. + public class GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponsePersonSuggestion : Google.Apis.Requests.IDirectResponseSchema + { + /// The name of the dataStore that this suggestion belongs to. + [Newtonsoft.Json.JsonPropertyAttribute("dataStore")] + public virtual string DataStore { get; set; } + + /// The document data snippet in the suggestion. Only a subset of fields is populated. + [Newtonsoft.Json.JsonPropertyAttribute("document")] + public virtual GoogleCloudDiscoveryengineV1alphaDocument Document { get; set; } + + /// The type of the person. + [Newtonsoft.Json.JsonPropertyAttribute("personType")] + public virtual string PersonType { get; set; } + + /// The suggestion for the query. + [Newtonsoft.Json.JsonPropertyAttribute("suggestion")] + public virtual string Suggestion { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Suggestions as search queries. + public class GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseQuerySuggestion : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// The unique document field paths that serve as the source of this suggestion if it was generated from + /// completable fields. This field is only populated for the document-completable model. + /// + [Newtonsoft.Json.JsonPropertyAttribute("completableFieldPaths")] + public virtual System.Collections.Generic.IList CompletableFieldPaths { get; set; } + + /// The name of the dataStore that this suggestion belongs to. + [Newtonsoft.Json.JsonPropertyAttribute("dataStore")] + public virtual System.Collections.Generic.IList DataStore { get; set; } + + /// The suggestion for the query. + [Newtonsoft.Json.JsonPropertyAttribute("suggestion")] + public virtual string Suggestion { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Suggestions from recent search history. + public class GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseRecentSearchSuggestion : Google.Apis.Requests.IDirectResponseSchema + { + private string _recentSearchTimeRaw; + + private object _recentSearchTime; + + /// The time when this recent rearch happened. + [Newtonsoft.Json.JsonPropertyAttribute("recentSearchTime")] + public virtual string RecentSearchTimeRaw + { + get => _recentSearchTimeRaw; + set + { + _recentSearchTime = Google.Apis.Util.Utilities.DeserializeForGoogleFormat(value); + _recentSearchTimeRaw = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + [System.ObsoleteAttribute("This property is obsolete and may behave unexpectedly; please use RecentSearchTimeDateTimeOffset instead.")] + public virtual object RecentSearchTime + { + get => _recentSearchTime; + set + { + _recentSearchTimeRaw = Google.Apis.Util.Utilities.SerializeForGoogleFormat(value); + _recentSearchTime = value; + } + } + + /// + /// representation of . + /// + [Newtonsoft.Json.JsonIgnoreAttribute] + public virtual System.DateTimeOffset? RecentSearchTimeDateTimeOffset + { + get => Google.Apis.Util.DiscoveryFormat.ParseGoogleDateTimeToDateTimeOffset(RecentSearchTimeRaw); + set => RecentSearchTimeRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); + } + + /// The suggestion for the query. + [Newtonsoft.Json.JsonPropertyAttribute("suggestion")] + public virtual string Suggestion { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Configuration data for advance site search. public class GoogleCloudDiscoveryengineV1alphaAdvancedSiteSearchConfig : Google.Apis.Requests.IDirectResponseSchema { @@ -22312,6 +23122,10 @@ public class GoogleCloudDiscoveryengineV1alphaAnswerQueryRequest : Google.Apis.R [Newtonsoft.Json.JsonPropertyAttribute("asynchronousMode")] public virtual System.Nullable AsynchronousMode { get; set; } + /// Optional. Grounding specification. + [Newtonsoft.Json.JsonPropertyAttribute("groundingSpec")] + public virtual GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestGroundingSpec GroundingSpec { get; set; } + /// Required. Current user query. [Newtonsoft.Json.JsonPropertyAttribute("query")] public virtual GoogleCloudDiscoveryengineV1alphaQuery Query { get; set; } @@ -22458,6 +23272,27 @@ public class GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGeneration public virtual string ETag { get; set; } } + /// Grounding specification. + public class GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestGroundingSpec : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Optional. Specifies whether to enable the filtering based on grounding score and at what level. + /// + [Newtonsoft.Json.JsonPropertyAttribute("filteringLevel")] + public virtual string FilteringLevel { get; set; } + + /// + /// Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When + /// this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports + /// for each claim. + /// + [Newtonsoft.Json.JsonPropertyAttribute("includeGroundingSupports")] + public virtual System.Nullable IncludeGroundingSupports { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Query understanding specification. public class GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestQueryUnderstandingSpec : Google.Apis.Requests.IDirectResponseSchema { @@ -24578,6 +25413,17 @@ public class GoogleCloudDiscoveryengineV1alphaConverseConversationResponse : Goo public virtual string ETag { get; set; } } + /// The historical crawl rate timeseries data, used for monitoring. + public class GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries : Google.Apis.Requests.IDirectResponseSchema + { + /// The QPS of the crawl rate. + [Newtonsoft.Json.JsonPropertyAttribute("qpsTimeSeries")] + public virtual GoogleMonitoringV3TimeSeries QpsTimeSeries { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// /// Metadata related to the progress of the DataStoreService.CreateDataStore operation. This will be returned by the /// google.longrunning.Operation.metadata field. @@ -25379,6 +26225,32 @@ public class GoogleCloudDiscoveryengineV1alphaDataStoreServingConfigDataStore : public virtual string ETag { get; set; } } + /// + /// The historical dedicated crawl rate timeseries data, used for monitoring. Dedicated crawl is used by Vertex AI + /// to crawl the user's website when dedicate crawl is set. + /// + public class GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Vertex AI's dedicated crawl rate time series of auto-refresh, which is the crawl rate of + /// Google-CloudVertexBot when dedicate crawl is set, and the crawl rate is for best effort use cases like + /// refreshing urls periodically. + /// + [Newtonsoft.Json.JsonPropertyAttribute("autoRefreshCrawlRate")] + public virtual GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries AutoRefreshCrawlRate { get; set; } + + /// + /// Vertex AI's dedicated crawl rate time series of user triggered crawl, which is the crawl rate of + /// Google-CloudVertexBot when dedicate crawl is set, and user triggered crawl rate is for deterministic use + /// cases like crawling urls or sitemaps specified by users. + /// + [Newtonsoft.Json.JsonPropertyAttribute("userTriggeredCrawlRate")] + public virtual GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries UserTriggeredCrawlRate { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// /// Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the /// google.longrunning.Operation.metadata field. @@ -28527,6 +29399,60 @@ public class GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingC public virtual string ETag { get; set; } } + /// + /// Response message for CrawlRateManagementService.ObtainCrawlRate method. The response contains organcic or + /// dedicated crawl rate time series data for monitoring, depending on whether dedicated crawl rate is set. + /// + public class GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse : Google.Apis.Requests.IDirectResponseSchema + { + /// The historical dedicated crawl rate timeseries data, used for monitoring. + [Newtonsoft.Json.JsonPropertyAttribute("dedicatedCrawlRateTimeSeries")] + public virtual GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries DedicatedCrawlRateTimeSeries { get; set; } + + /// Errors from service when handling the request. + [Newtonsoft.Json.JsonPropertyAttribute("error")] + public virtual GoogleRpcStatus Error { get; set; } + + /// The historical organic crawl rate timeseries data, used for monitoring. + [Newtonsoft.Json.JsonPropertyAttribute("organicCrawlRateTimeSeries")] + public virtual GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries OrganicCrawlRateTimeSeries { get; set; } + + /// Output only. The state of the response. + [Newtonsoft.Json.JsonPropertyAttribute("state")] + public virtual string State { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// The historical organic crawl rate timeseries data, used for monitoring. Organic crawl is auto-determined by + /// Google to crawl the user's website when dedicate crawl is not set. Crawl rate is the QPS of crawl request Google + /// sends to the user's website. + /// + public class GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Google's organic crawl rate time series, which is the sum of all googlebots' crawl rate. Please refer to + /// https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers for more details about + /// googlebots. + /// + [Newtonsoft.Json.JsonPropertyAttribute("googleOrganicCrawlRate")] + public virtual GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries GoogleOrganicCrawlRate { get; set; } + + /// + /// Vertex AI's organic crawl rate time series, which is the crawl rate of Google-CloudVertexBot when dedicate + /// crawl is not set. Please refer to + /// https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot for + /// more details about Google-CloudVertexBot. + /// + [Newtonsoft.Json.JsonPropertyAttribute("vertexAiOrganicCrawlRate")] + public virtual GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries VertexAiOrganicCrawlRate { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Detailed page information. public class GoogleCloudDiscoveryengineV1alphaPageInfo : Google.Apis.Requests.IDirectResponseSchema { @@ -33270,10 +34196,10 @@ public virtual System.DateTimeOffset? EventTimeDateTimeOffset /// Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * /// `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of /// Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. - /// Home &gt; Men &gt; Jeans Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in - /// Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume - /// watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, - /// etc. + /// Home &gt; Men &gt; Jeans * `add-feedback`: Add a user feedback. Retail-related values: * + /// `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) + /// Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * + /// `media-complete`: Finished or stopped midway through a video, song, etc. /// [Newtonsoft.Json.JsonPropertyAttribute("eventType")] public virtual string EventType { get; set; } @@ -38304,6 +39230,190 @@ public class GoogleLongrunningOperation : Google.Apis.Requests.IDirectResponseSc public virtual string ETag { get; set; } } + /// A single data point in a time series. + public class GoogleMonitoringV3Point : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// The time interval to which the data point applies. For `GAUGE` metrics, the start time is optional, but if + /// it is supplied, it must equal the end time. For `DELTA` metrics, the start and end time should specify a + /// non-zero interval, with subsequent points specifying contiguous and non-overlapping intervals. For + /// `CUMULATIVE` metrics, the start and end time should specify a non-zero interval, with subsequent points + /// specifying the same start time and increasing end times, until an event resets the cumulative value to zero + /// and sets a new start time for the following points. + /// + [Newtonsoft.Json.JsonPropertyAttribute("interval")] + public virtual GoogleMonitoringV3TimeInterval Interval { get; set; } + + /// The value of the data point. + [Newtonsoft.Json.JsonPropertyAttribute("value")] + public virtual GoogleMonitoringV3TypedValue Value { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// A time interval extending just after a start time through an end time. If the start time is the same as the end + /// time, then the interval represents a single point in time. + /// + public class GoogleMonitoringV3TimeInterval : Google.Apis.Requests.IDirectResponseSchema + { + private string _endTimeRaw; + + private object _endTime; + + /// Required. The end of the time interval. + [Newtonsoft.Json.JsonPropertyAttribute("endTime")] + public virtual string EndTimeRaw + { + get => _endTimeRaw; + set + { + _endTime = Google.Apis.Util.Utilities.DeserializeForGoogleFormat(value); + _endTimeRaw = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + [System.ObsoleteAttribute("This property is obsolete and may behave unexpectedly; please use EndTimeDateTimeOffset instead.")] + public virtual object EndTime + { + get => _endTime; + set + { + _endTimeRaw = Google.Apis.Util.Utilities.SerializeForGoogleFormat(value); + _endTime = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + public virtual System.DateTimeOffset? EndTimeDateTimeOffset + { + get => Google.Apis.Util.DiscoveryFormat.ParseGoogleDateTimeToDateTimeOffset(EndTimeRaw); + set => EndTimeRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); + } + + private string _startTimeRaw; + + private object _startTime; + + /// + /// Optional. The beginning of the time interval. The default value for the start time is the end time. The + /// start time must not be later than the end time. + /// + [Newtonsoft.Json.JsonPropertyAttribute("startTime")] + public virtual string StartTimeRaw + { + get => _startTimeRaw; + set + { + _startTime = Google.Apis.Util.Utilities.DeserializeForGoogleFormat(value); + _startTimeRaw = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + [System.ObsoleteAttribute("This property is obsolete and may behave unexpectedly; please use StartTimeDateTimeOffset instead.")] + public virtual object StartTime + { + get => _startTime; + set + { + _startTimeRaw = Google.Apis.Util.Utilities.SerializeForGoogleFormat(value); + _startTime = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + public virtual System.DateTimeOffset? StartTimeDateTimeOffset + { + get => Google.Apis.Util.DiscoveryFormat.ParseGoogleDateTimeToDateTimeOffset(StartTimeRaw); + set => StartTimeRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); + } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// A collection of data points that describes the time-varying values of a metric. A time series is identified by a + /// combination of a fully-specified monitored resource and a fully-specified metric. This type is used for both + /// listing and creating time series. + /// + public class GoogleMonitoringV3TimeSeries : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Input only. A detailed description of the time series that will be associated with the + /// google.api.MetricDescriptor for the metric. Once set, this field cannot be changed through CreateTimeSeries. + /// + [Newtonsoft.Json.JsonPropertyAttribute("description")] + public virtual string Description { get; set; } + + /// + /// Output only. The associated monitored resource metadata. When reading a time series, this field will include + /// metadata labels that are explicitly named in the reduction. When creating a time series, this field is + /// ignored. + /// + [Newtonsoft.Json.JsonPropertyAttribute("metadata")] + public virtual GoogleApiMonitoredResourceMetadata Metadata { get; set; } + + /// The associated metric. A fully-specified metric used to identify the time series. + [Newtonsoft.Json.JsonPropertyAttribute("metric")] + public virtual GoogleApiMetric Metric { get; set; } + + /// + /// The metric kind of the time series. When listing time series, this metric kind might be different from the + /// metric kind of the associated metric if this time series is an alignment or reduction of other time series. + /// When creating a time series, this field is optional. If present, it must be the same as the metric kind of + /// the associated metric. If the associated metric's descriptor must be auto-created, then this field specifies + /// the metric kind of the new descriptor and must be either `GAUGE` (the default) or `CUMULATIVE`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("metricKind")] + public virtual string MetricKind { get; set; } + + /// + /// The data points of this time series. When listing time series, points are returned in reverse time order. + /// When creating a time series, this field must contain exactly one point and the point's type must be the same + /// as the value type of the associated metric. If the associated metric's descriptor must be auto-created, then + /// the value type of the descriptor is determined by the point's type, which must be `BOOL`, `INT64`, `DOUBLE`, + /// or `DISTRIBUTION`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("points")] + public virtual System.Collections.Generic.IList Points { get; set; } + + /// + /// The associated monitored resource. Custom metrics can use only certain monitored resource types in their + /// time series data. For more information, see [Monitored resources for custom + /// metrics](https://cloud.google.com/monitoring/custom-metrics/creating-metrics#custom-metric-resources). + /// + [Newtonsoft.Json.JsonPropertyAttribute("resource")] + public virtual GoogleApiMonitoredResource Resource { get; set; } + + /// + /// The units in which the metric value is reported. It is only applicable if the `value_type` is `INT64`, + /// `DOUBLE`, or `DISTRIBUTION`. The `unit` defines the representation of the stored metric values. This field + /// can only be changed through CreateTimeSeries when it is empty. + /// + [Newtonsoft.Json.JsonPropertyAttribute("unit")] + public virtual string Unit { get; set; } + + /// + /// The value type of the time series. When listing time series, this value type might be different from the + /// value type of the associated metric if this time series is an alignment or reduction of other time series. + /// When creating a time series, this field is optional. If present, it must be the same as the type of the data + /// in the `points` field. + /// + [Newtonsoft.Json.JsonPropertyAttribute("valueType")] + public virtual string ValueType { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// A single strongly-typed value. public class GoogleMonitoringV3TypedValue : Google.Apis.Requests.IDirectResponseSchema { diff --git a/Src/Generated/Google.Apis.DiscoveryEngine.v1alpha/Google.Apis.DiscoveryEngine.v1alpha.csproj b/Src/Generated/Google.Apis.DiscoveryEngine.v1alpha/Google.Apis.DiscoveryEngine.v1alpha.csproj index 2cf924226dc..2d2d7e7dd1a 100644 --- a/Src/Generated/Google.Apis.DiscoveryEngine.v1alpha/Google.Apis.DiscoveryEngine.v1alpha.csproj +++ b/Src/Generated/Google.Apis.DiscoveryEngine.v1alpha/Google.Apis.DiscoveryEngine.v1alpha.csproj @@ -3,7 +3,7 @@ Google.Apis.DiscoveryEngine.v1alpha Client Library - 1.68.0.3580 + 1.68.0.3585 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.DiscoveryEngine.v1beta/Google.Apis.DiscoveryEngine.v1beta.cs b/Src/Generated/Google.Apis.DiscoveryEngine.v1beta/Google.Apis.DiscoveryEngine.v1beta.cs index d7206045ac1..322c229e6f4 100644 --- a/Src/Generated/Google.Apis.DiscoveryEngine.v1beta/Google.Apis.DiscoveryEngine.v1beta.cs +++ b/Src/Generated/Google.Apis.DiscoveryEngine.v1beta/Google.Apis.DiscoveryEngine.v1beta.cs @@ -516,6 +516,7 @@ public DataStoresResource(Google.Apis.Services.IClientService service) { this.service = service; Branches = new BranchesResource(service); + CompletionConfig = new CompletionConfigResource(service); CompletionSuggestions = new CompletionSuggestionsResource(service); Controls = new ControlsResource(service); Conversations = new ConversationsResource(service); @@ -1390,6 +1391,87 @@ protected override void InitParameters() } } + /// Gets the CompletionConfig resource. + public virtual CompletionConfigResource CompletionConfig { get; } + + /// The "completionConfig" collection of methods. + public class CompletionConfigResource + { + private const string Resource = "completionConfig"; + + /// The service which this resource belongs to. + private readonly Google.Apis.Services.IClientService service; + + /// Constructs a new resource. + public CompletionConfigResource(Google.Apis.Services.IClientService service) + { + this.service = service; + } + + /// Completes the user input with advanced keyword suggestions. + /// The body of the request. + /// + /// Required. The completion_config of the parent dataStore or engine resource name for which + /// the completion is performed, such as + /// `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` + /// `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`. + /// + public virtual CompleteQueryRequest CompleteQuery(Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest body, string completionConfig) + { + return new CompleteQueryRequest(this.service, body, completionConfig); + } + + /// Completes the user input with advanced keyword suggestions. + public class CompleteQueryRequest : DiscoveryEngineBaseServiceRequest + { + /// Constructs a new CompleteQuery request. + public CompleteQueryRequest(Google.Apis.Services.IClientService service, Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest body, string completionConfig) : base(service) + { + CompletionConfig = completionConfig; + Body = body; + InitParameters(); + } + + /// + /// Required. The completion_config of the parent dataStore or engine resource name for + /// which the completion is performed, such as + /// `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` + /// `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`. + /// + [Google.Apis.Util.RequestParameterAttribute("completionConfig", Google.Apis.Util.RequestParameterType.Path)] + public virtual string CompletionConfig { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "completeQuery"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v1beta/{+completionConfig}:completeQuery"; + + /// Initializes CompleteQuery parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("completionConfig", new Google.Apis.Discovery.Parameter + { + Name = "completionConfig", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/completionConfig$", + }); + } + } + } + /// Gets the CompletionSuggestions resource. public virtual CompletionSuggestionsResource CompletionSuggestions { get; } @@ -3719,6 +3801,89 @@ protected override void InitParameters() }); } } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that + /// allows API key for authentication, where OAuth and IAM checks are not required. Only public + /// website search is supported by this method. If data stores and engines not associated with + /// public website search are specified, a `FAILED_PRECONDITION` error is returned. This method + /// can be used for easy onboarding without having to implement an authentication backend. + /// However, it is strongly recommended to use SearchService.Search instead with required OAuth + /// and IAM checks to provide better data security. + /// + /// The body of the request. + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to make + /// the search. + /// + public virtual SearchLiteRequest SearchLite(Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaSearchRequest body, string servingConfig) + { + return new SearchLiteRequest(this.service, body, servingConfig); + } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that + /// allows API key for authentication, where OAuth and IAM checks are not required. Only public + /// website search is supported by this method. If data stores and engines not associated with + /// public website search are specified, a `FAILED_PRECONDITION` error is returned. This method + /// can be used for easy onboarding without having to implement an authentication backend. + /// However, it is strongly recommended to use SearchService.Search instead with required OAuth + /// and IAM checks to provide better data security. + /// + public class SearchLiteRequest : DiscoveryEngineBaseServiceRequest + { + /// Constructs a new SearchLite request. + public SearchLiteRequest(Google.Apis.Services.IClientService service, Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaSearchRequest body, string servingConfig) : base(service) + { + ServingConfig = servingConfig; + Body = body; + InitParameters(); + } + + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to + /// make the search. + /// + [Google.Apis.Util.RequestParameterAttribute("servingConfig", Google.Apis.Util.RequestParameterType.Path)] + public virtual string ServingConfig { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaSearchRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "searchLite"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v1beta/{+servingConfig}:searchLite"; + + /// Initializes SearchLite parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("servingConfig", new Google.Apis.Discovery.Parameter + { + Name = "servingConfig", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + }); + } + } } /// Gets the Sessions resource. @@ -6413,6 +6578,7 @@ public class EnginesResource public EnginesResource(Google.Apis.Services.IClientService service) { this.service = service; + CompletionConfig = new CompletionConfigResource(service); Controls = new ControlsResource(service); Conversations = new ConversationsResource(service); Operations = new OperationsResource(service); @@ -6420,6 +6586,87 @@ public EnginesResource(Google.Apis.Services.IClientService service) Sessions = new SessionsResource(service); } + /// Gets the CompletionConfig resource. + public virtual CompletionConfigResource CompletionConfig { get; } + + /// The "completionConfig" collection of methods. + public class CompletionConfigResource + { + private const string Resource = "completionConfig"; + + /// The service which this resource belongs to. + private readonly Google.Apis.Services.IClientService service; + + /// Constructs a new resource. + public CompletionConfigResource(Google.Apis.Services.IClientService service) + { + this.service = service; + } + + /// Completes the user input with advanced keyword suggestions. + /// The body of the request. + /// + /// Required. The completion_config of the parent dataStore or engine resource name for which + /// the completion is performed, such as + /// `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` + /// `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`. + /// + public virtual CompleteQueryRequest CompleteQuery(Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest body, string completionConfig) + { + return new CompleteQueryRequest(this.service, body, completionConfig); + } + + /// Completes the user input with advanced keyword suggestions. + public class CompleteQueryRequest : DiscoveryEngineBaseServiceRequest + { + /// Constructs a new CompleteQuery request. + public CompleteQueryRequest(Google.Apis.Services.IClientService service, Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest body, string completionConfig) : base(service) + { + CompletionConfig = completionConfig; + Body = body; + InitParameters(); + } + + /// + /// Required. The completion_config of the parent dataStore or engine resource name for + /// which the completion is performed, such as + /// `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` + /// `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`. + /// + [Google.Apis.Util.RequestParameterAttribute("completionConfig", Google.Apis.Util.RequestParameterType.Path)] + public virtual string CompletionConfig { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "completeQuery"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v1beta/{+completionConfig}:completeQuery"; + + /// Initializes CompleteQuery parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("completionConfig", new Google.Apis.Discovery.Parameter + { + Name = "completionConfig", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/completionConfig$", + }); + } + } + } + /// Gets the Controls resource. public virtual ControlsResource Controls { get; } @@ -7855,6 +8102,89 @@ protected override void InitParameters() }); } } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that + /// allows API key for authentication, where OAuth and IAM checks are not required. Only public + /// website search is supported by this method. If data stores and engines not associated with + /// public website search are specified, a `FAILED_PRECONDITION` error is returned. This method + /// can be used for easy onboarding without having to implement an authentication backend. + /// However, it is strongly recommended to use SearchService.Search instead with required OAuth + /// and IAM checks to provide better data security. + /// + /// The body of the request. + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to make + /// the search. + /// + public virtual SearchLiteRequest SearchLite(Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaSearchRequest body, string servingConfig) + { + return new SearchLiteRequest(this.service, body, servingConfig); + } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that + /// allows API key for authentication, where OAuth and IAM checks are not required. Only public + /// website search is supported by this method. If data stores and engines not associated with + /// public website search are specified, a `FAILED_PRECONDITION` error is returned. This method + /// can be used for easy onboarding without having to implement an authentication backend. + /// However, it is strongly recommended to use SearchService.Search instead with required OAuth + /// and IAM checks to provide better data security. + /// + public class SearchLiteRequest : DiscoveryEngineBaseServiceRequest + { + /// Constructs a new SearchLite request. + public SearchLiteRequest(Google.Apis.Services.IClientService service, Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaSearchRequest body, string servingConfig) : base(service) + { + ServingConfig = servingConfig; + Body = body; + InitParameters(); + } + + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to + /// make the search. + /// + [Google.Apis.Util.RequestParameterAttribute("servingConfig", Google.Apis.Util.RequestParameterType.Path)] + public virtual string ServingConfig { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaSearchRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "searchLite"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v1beta/{+servingConfig}:searchLite"; + + /// Initializes SearchLite parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("servingConfig", new Google.Apis.Discovery.Parameter + { + Name = "servingConfig", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + }); + } + } } /// Gets the Sessions resource. @@ -9028,6 +9358,7 @@ public DataStoresResource(Google.Apis.Services.IClientService service) { this.service = service; Branches = new BranchesResource(service); + CompletionConfig = new CompletionConfigResource(service); CompletionSuggestions = new CompletionSuggestionsResource(service); Controls = new ControlsResource(service); Conversations = new ConversationsResource(service); @@ -9898,6 +10229,87 @@ protected override void InitParameters() } } + /// Gets the CompletionConfig resource. + public virtual CompletionConfigResource CompletionConfig { get; } + + /// The "completionConfig" collection of methods. + public class CompletionConfigResource + { + private const string Resource = "completionConfig"; + + /// The service which this resource belongs to. + private readonly Google.Apis.Services.IClientService service; + + /// Constructs a new resource. + public CompletionConfigResource(Google.Apis.Services.IClientService service) + { + this.service = service; + } + + /// Completes the user input with advanced keyword suggestions. + /// The body of the request. + /// + /// Required. The completion_config of the parent dataStore or engine resource name for which the + /// completion is performed, such as + /// `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` + /// `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`. + /// + public virtual CompleteQueryRequest CompleteQuery(Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest body, string completionConfig) + { + return new CompleteQueryRequest(this.service, body, completionConfig); + } + + /// Completes the user input with advanced keyword suggestions. + public class CompleteQueryRequest : DiscoveryEngineBaseServiceRequest + { + /// Constructs a new CompleteQuery request. + public CompleteQueryRequest(Google.Apis.Services.IClientService service, Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest body, string completionConfig) : base(service) + { + CompletionConfig = completionConfig; + Body = body; + InitParameters(); + } + + /// + /// Required. The completion_config of the parent dataStore or engine resource name for which + /// the completion is performed, such as + /// `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` + /// `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`. + /// + [Google.Apis.Util.RequestParameterAttribute("completionConfig", Google.Apis.Util.RequestParameterType.Path)] + public virtual string CompletionConfig { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "completeQuery"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v1beta/{+completionConfig}:completeQuery"; + + /// Initializes CompleteQuery parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("completionConfig", new Google.Apis.Discovery.Parameter + { + Name = "completionConfig", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/completionConfig$", + }); + } + } + } + /// Gets the CompletionSuggestions resource. public virtual CompletionSuggestionsResource CompletionSuggestions { get; } @@ -11994,6 +12406,89 @@ protected override void InitParameters() }); } } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that allows + /// API key for authentication, where OAuth and IAM checks are not required. Only public website + /// search is supported by this method. If data stores and engines not associated with public + /// website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used + /// for easy onboarding without having to implement an authentication backend. However, it is + /// strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to + /// provide better data security. + /// + /// The body of the request. + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to make the + /// search. + /// + public virtual SearchLiteRequest SearchLite(Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaSearchRequest body, string servingConfig) + { + return new SearchLiteRequest(this.service, body, servingConfig); + } + + /// + /// Performs a search. Similar to the SearchService.Search method, but a lite version that allows + /// API key for authentication, where OAuth and IAM checks are not required. Only public website + /// search is supported by this method. If data stores and engines not associated with public + /// website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used + /// for easy onboarding without having to implement an authentication backend. However, it is + /// strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to + /// provide better data security. + /// + public class SearchLiteRequest : DiscoveryEngineBaseServiceRequest + { + /// Constructs a new SearchLite request. + public SearchLiteRequest(Google.Apis.Services.IClientService service, Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaSearchRequest body, string servingConfig) : base(service) + { + ServingConfig = servingConfig; + Body = body; + InitParameters(); + } + + /// + /// Required. The resource name of the Search serving config, such as + /// `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, + /// or + /// `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. + /// This field is used to identify the serving configuration name, set of models used to make + /// the search. + /// + [Google.Apis.Util.RequestParameterAttribute("servingConfig", Google.Apis.Util.RequestParameterType.Path)] + public virtual string ServingConfig { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.DiscoveryEngine.v1beta.Data.GoogleCloudDiscoveryengineV1betaSearchRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "searchLite"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v1beta/{+servingConfig}:searchLite"; + + /// Initializes SearchLite parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("servingConfig", new Google.Apis.Discovery.Parameter + { + Name = "servingConfig", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + }); + } + } } /// Gets the Sessions resource. @@ -16307,6 +16802,248 @@ protected override void InitParameters() } namespace Google.Apis.DiscoveryEngine.v1beta.Data { + /// + /// `Distribution` contains summary statistics for a population of values. It optionally contains a histogram + /// representing the distribution of those values across a set of buckets. The summary statistics are the count, + /// mean, sum of the squared deviation from the mean, the minimum, and the maximum of the set of population of + /// values. The histogram is based on a sequence of buckets and gives a count of values that fall into each bucket. + /// The boundaries of the buckets are given either explicitly or by formulas for buckets of fixed or exponentially + /// increasing widths. Although it is not forbidden, it is generally a bad idea to include non-finite values + /// (infinities or NaNs) in the population of values, as this will render the `mean` and `sum_of_squared_deviation` + /// fields meaningless. + /// + public class GoogleApiDistribution : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// The number of values in each bucket of the histogram, as described in `bucket_options`. If the distribution + /// does not have a histogram, then omit this field. If there is a histogram, then the sum of the values in + /// `bucket_counts` must equal the value in the `count` field of the distribution. If present, `bucket_counts` + /// should contain N values, where N is the number of buckets specified in `bucket_options`. If you supply fewer + /// than N values, the remaining values are assumed to be 0. The order of the values in `bucket_counts` follows + /// the bucket numbering schemes described for the three bucket types. The first value must be the count for the + /// underflow bucket (number 0). The next N-2 values are the counts for the finite buckets (number 1 through + /// N-2). The N'th value in `bucket_counts` is the count for the overflow bucket (number N-1). + /// + [Newtonsoft.Json.JsonPropertyAttribute("bucketCounts")] + public virtual System.Collections.Generic.IList> BucketCounts { get; set; } + + /// + /// Defines the histogram bucket boundaries. If the distribution does not contain a histogram, then omit this + /// field. + /// + [Newtonsoft.Json.JsonPropertyAttribute("bucketOptions")] + public virtual GoogleApiDistributionBucketOptions BucketOptions { get; set; } + + /// + /// The number of values in the population. Must be non-negative. This value must equal the sum of the values in + /// `bucket_counts` if a histogram is provided. + /// + [Newtonsoft.Json.JsonPropertyAttribute("count")] + public virtual System.Nullable Count { get; set; } + + /// Must be in increasing order of `value` field. + [Newtonsoft.Json.JsonPropertyAttribute("exemplars")] + public virtual System.Collections.Generic.IList Exemplars { get; set; } + + /// + /// The arithmetic mean of the values in the population. If `count` is zero then this field must be zero. + /// + [Newtonsoft.Json.JsonPropertyAttribute("mean")] + public virtual System.Nullable Mean { get; set; } + + /// + /// If specified, contains the range of the population values. The field must not be present if the `count` is + /// zero. + /// + [Newtonsoft.Json.JsonPropertyAttribute("range")] + public virtual GoogleApiDistributionRange Range { get; set; } + + /// + /// The sum of squared deviations from the mean of the values in the population. For values x_i this is: + /// Sum[i=1..n]((x_i - mean)^2) Knuth, "The Art of Computer Programming", Vol. 2, page 232, 3rd edition + /// describes Welford's method for accumulating this sum in one pass. If `count` is zero then this field must be + /// zero. + /// + [Newtonsoft.Json.JsonPropertyAttribute("sumOfSquaredDeviation")] + public virtual System.Nullable SumOfSquaredDeviation { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// `BucketOptions` describes the bucket boundaries used to create a histogram for the distribution. The buckets can + /// be in a linear sequence, an exponential sequence, or each bucket can be specified explicitly. `BucketOptions` + /// does not include the number of values in each bucket. A bucket has an inclusive lower bound and exclusive upper + /// bound for the values that are counted for that bucket. The upper bound of a bucket must be strictly greater than + /// the lower bound. The sequence of N buckets for a distribution consists of an underflow bucket (number 0), zero + /// or more finite buckets (number 1 through N - 2) and an overflow bucket (number N - 1). The buckets are + /// contiguous: the lower bound of bucket i (i &gt; 0) is the same as the upper bound of bucket i - 1. The + /// buckets span the whole range of finite values: lower bound of the underflow bucket is -infinity and the upper + /// bound of the overflow bucket is +infinity. The finite buckets are so-called because both bounds are finite. + /// + public class GoogleApiDistributionBucketOptions : Google.Apis.Requests.IDirectResponseSchema + { + /// The explicit buckets. + [Newtonsoft.Json.JsonPropertyAttribute("explicitBuckets")] + public virtual GoogleApiDistributionBucketOptionsExplicit ExplicitBuckets { get; set; } + + /// The exponential buckets. + [Newtonsoft.Json.JsonPropertyAttribute("exponentialBuckets")] + public virtual GoogleApiDistributionBucketOptionsExponential ExponentialBuckets { get; set; } + + /// The linear bucket. + [Newtonsoft.Json.JsonPropertyAttribute("linearBuckets")] + public virtual GoogleApiDistributionBucketOptionsLinear LinearBuckets { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// Specifies a set of buckets with arbitrary widths. There are `size(bounds) + 1` (= N) buckets. Bucket `i` has the + /// following boundaries: Upper bound (0 &lt;= i &lt; N-1): bounds[i] Lower bound (1 &lt;= i &lt; + /// N); bounds[i - 1] The `bounds` field must contain at least one element. If `bounds` has only one element, then + /// there are no finite buckets, and that single element is the common boundary of the overflow and underflow + /// buckets. + /// + public class GoogleApiDistributionBucketOptionsExplicit : Google.Apis.Requests.IDirectResponseSchema + { + /// The values must be monotonically increasing. + [Newtonsoft.Json.JsonPropertyAttribute("bounds")] + public virtual System.Collections.Generic.IList> Bounds { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// Specifies an exponential sequence of buckets that have a width that is proportional to the value of the lower + /// bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket. There are + /// `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 &lt;= i + /// &lt; N-1): scale * (growth_factor ^ i). Lower bound (1 &lt;= i &lt; N): scale * (growth_factor ^ (i + /// - 1)). + /// + public class GoogleApiDistributionBucketOptionsExponential : Google.Apis.Requests.IDirectResponseSchema + { + /// Must be greater than 1. + [Newtonsoft.Json.JsonPropertyAttribute("growthFactor")] + public virtual System.Nullable GrowthFactor { get; set; } + + /// Must be greater than 0. + [Newtonsoft.Json.JsonPropertyAttribute("numFiniteBuckets")] + public virtual System.Nullable NumFiniteBuckets { get; set; } + + /// Must be greater than 0. + [Newtonsoft.Json.JsonPropertyAttribute("scale")] + public virtual System.Nullable Scale { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// Specifies a linear sequence of buckets that all have the same width (except overflow and underflow). Each bucket + /// represents a constant absolute uncertainty on the specific value in the bucket. There are `num_finite_buckets + + /// 2` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 &lt;= i &lt; N-1): offset + + /// (width * i). Lower bound (1 &lt;= i &lt; N): offset + (width * (i - 1)). + /// + public class GoogleApiDistributionBucketOptionsLinear : Google.Apis.Requests.IDirectResponseSchema + { + /// Must be greater than 0. + [Newtonsoft.Json.JsonPropertyAttribute("numFiniteBuckets")] + public virtual System.Nullable NumFiniteBuckets { get; set; } + + /// Lower bound of the first bucket. + [Newtonsoft.Json.JsonPropertyAttribute("offset")] + public virtual System.Nullable Offset { get; set; } + + /// Must be greater than 0. + [Newtonsoft.Json.JsonPropertyAttribute("width")] + public virtual System.Nullable Width { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// Exemplars are example points that may be used to annotate aggregated distribution values. They are metadata that + /// gives information about a particular value added to a Distribution bucket, such as a trace ID that was active + /// when a value was added. They may contain further information, such as a example values and timestamps, origin, + /// etc. + /// + public class GoogleApiDistributionExemplar : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Contextual information about the example value. Examples are: Trace: + /// type.googleapis.com/google.monitoring.v3.SpanContext Literal string: + /// type.googleapis.com/google.protobuf.StringValue Labels dropped during aggregation: + /// type.googleapis.com/google.monitoring.v3.DroppedLabels There may be only a single attachment of any given + /// message type in a single exemplar, and this is enforced by the system. + /// + [Newtonsoft.Json.JsonPropertyAttribute("attachments")] + public virtual System.Collections.Generic.IList> Attachments { get; set; } + + private string _timestampRaw; + + private object _timestamp; + + /// The observation (sampling) time of the above value. + [Newtonsoft.Json.JsonPropertyAttribute("timestamp")] + public virtual string TimestampRaw + { + get => _timestampRaw; + set + { + _timestamp = Google.Apis.Util.Utilities.DeserializeForGoogleFormat(value); + _timestampRaw = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + [System.ObsoleteAttribute("This property is obsolete and may behave unexpectedly; please use TimestampDateTimeOffset instead.")] + public virtual object Timestamp + { + get => _timestamp; + set + { + _timestampRaw = Google.Apis.Util.Utilities.SerializeForGoogleFormat(value); + _timestamp = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + public virtual System.DateTimeOffset? TimestampDateTimeOffset + { + get => Google.Apis.Util.DiscoveryFormat.ParseGoogleDateTimeToDateTimeOffset(TimestampRaw); + set => TimestampRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); + } + + /// Value of the exemplar point. This value determines to which bucket the exemplar belongs. + [Newtonsoft.Json.JsonPropertyAttribute("value")] + public virtual System.Nullable Value { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// The range of the population values. + public class GoogleApiDistributionRange : Google.Apis.Requests.IDirectResponseSchema + { + /// The maximum of the population values. + [Newtonsoft.Json.JsonPropertyAttribute("max")] + public virtual System.Nullable Max { get; set; } + + /// The minimum of the population values. + [Newtonsoft.Json.JsonPropertyAttribute("min")] + public virtual System.Nullable Min { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// /// Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be /// represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and @@ -16340,6 +17077,85 @@ public class GoogleApiHttpBody : Google.Apis.Requests.IDirectResponseSchema public virtual string ETag { get; set; } } + /// + /// A specific metric, identified by specifying values for all of the labels of a `MetricDescriptor`. + /// + public class GoogleApiMetric : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// The set of label values that uniquely identify this metric. All labels listed in the `MetricDescriptor` must + /// be assigned values. + /// + [Newtonsoft.Json.JsonPropertyAttribute("labels")] + public virtual System.Collections.Generic.IDictionary Labels { get; set; } + + /// + /// An existing metric type, see google.api.MetricDescriptor. For example, + /// `custom.googleapis.com/invoice/paid/amount`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("type")] + public virtual string Type { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples + /// include virtual machine instances, databases, and storage devices such as disks. The `type` field identifies a + /// MonitoredResourceDescriptor object that describes the resource's schema. Information in the `labels` field + /// identifies the actual resource and its attributes according to the schema. For example, a particular Compute + /// Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for + /// `"gce_instance"` has labels `"project_id"`, `"instance_id"` and `"zone"`: { "type": "gce_instance", "labels": { + /// "project_id": "my-project", "instance_id": "12345678901234", "zone": "us-central1-a" }} + /// + public class GoogleApiMonitoredResource : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, + /// Compute Engine VM instances use the labels `"project_id"`, `"instance_id"`, and `"zone"`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("labels")] + public virtual System.Collections.Generic.IDictionary Labels { get; set; } + + /// + /// Required. The monitored resource type. This field must match the `type` field of a + /// MonitoredResourceDescriptor object. For example, the type of a Compute Engine VM instance is `gce_instance`. + /// Some descriptors include the service name in the type; for example, the type of a Datastream stream is + /// `datastream.googleapis.com/Stream`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("type")] + public virtual string Type { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// Auxiliary metadata for a MonitoredResource object. MonitoredResource objects contain the minimum set of + /// information to uniquely identify a monitored resource instance. There is some other useful auxiliary metadata. + /// Monitoring and Logging use an ingestion pipeline to extract metadata for cloud resources of all types, and store + /// the metadata in this message. + /// + public class GoogleApiMonitoredResourceMetadata : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Output only. Values for predefined system metadata labels. System labels are a kind of metadata extracted by + /// Google, including "machine_image", "vpc", "subnet_id", "security_group", "name", etc. System label values + /// can be only strings, Boolean values, or a list of strings. For example: { "name": "my-test-instance", + /// "security_group": ["a", "b", "c"], "spot_instance": false } + /// + [Newtonsoft.Json.JsonPropertyAttribute("systemLabels")] + public virtual System.Collections.Generic.IDictionary SystemLabels { get; set; } + + /// Output only. A map of user-defined metadata labels. + [Newtonsoft.Json.JsonPropertyAttribute("userLabels")] + public virtual System.Collections.Generic.IDictionary UserLabels { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// A description of the context in which an error occurred. public class GoogleCloudDiscoveryengineLoggingErrorContext : Google.Apis.Requests.IDirectResponseSchema { @@ -20854,6 +21670,17 @@ public class GoogleCloudDiscoveryengineV1alphaControlSynonymsAction : Google.Api public virtual string ETag { get; set; } } + /// The historical crawl rate timeseries data, used for monitoring. + public class GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries : Google.Apis.Requests.IDirectResponseSchema + { + /// The QPS of the crawl rate. + [Newtonsoft.Json.JsonPropertyAttribute("qpsTimeSeries")] + public virtual GoogleMonitoringV3TimeSeries QpsTimeSeries { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// /// Metadata related to the progress of the DataStoreService.CreateDataStore operation. This will be returned by the /// google.longrunning.Operation.metadata field. @@ -21613,6 +22440,32 @@ public class GoogleCloudDiscoveryengineV1alphaDataStoreServingConfigDataStore : public virtual string ETag { get; set; } } + /// + /// The historical dedicated crawl rate timeseries data, used for monitoring. Dedicated crawl is used by Vertex AI + /// to crawl the user's website when dedicate crawl is set. + /// + public class GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Vertex AI's dedicated crawl rate time series of auto-refresh, which is the crawl rate of + /// Google-CloudVertexBot when dedicate crawl is set, and the crawl rate is for best effort use cases like + /// refreshing urls periodically. + /// + [Newtonsoft.Json.JsonPropertyAttribute("autoRefreshCrawlRate")] + public virtual GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries AutoRefreshCrawlRate { get; set; } + + /// + /// Vertex AI's dedicated crawl rate time series of user triggered crawl, which is the crawl rate of + /// Google-CloudVertexBot when dedicate crawl is set, and user triggered crawl rate is for deterministic use + /// cases like crawling urls or sitemaps specified by users. + /// + [Newtonsoft.Json.JsonPropertyAttribute("userTriggeredCrawlRate")] + public virtual GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries UserTriggeredCrawlRate { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// /// Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the /// google.longrunning.Operation.metadata field. @@ -23699,6 +24552,60 @@ public class GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingC public virtual string ETag { get; set; } } + /// + /// Response message for CrawlRateManagementService.ObtainCrawlRate method. The response contains organcic or + /// dedicated crawl rate time series data for monitoring, depending on whether dedicated crawl rate is set. + /// + public class GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse : Google.Apis.Requests.IDirectResponseSchema + { + /// The historical dedicated crawl rate timeseries data, used for monitoring. + [Newtonsoft.Json.JsonPropertyAttribute("dedicatedCrawlRateTimeSeries")] + public virtual GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries DedicatedCrawlRateTimeSeries { get; set; } + + /// Errors from service when handling the request. + [Newtonsoft.Json.JsonPropertyAttribute("error")] + public virtual GoogleRpcStatus Error { get; set; } + + /// The historical organic crawl rate timeseries data, used for monitoring. + [Newtonsoft.Json.JsonPropertyAttribute("organicCrawlRateTimeSeries")] + public virtual GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries OrganicCrawlRateTimeSeries { get; set; } + + /// Output only. The state of the response. + [Newtonsoft.Json.JsonPropertyAttribute("state")] + public virtual string State { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// The historical organic crawl rate timeseries data, used for monitoring. Organic crawl is auto-determined by + /// Google to crawl the user's website when dedicate crawl is not set. Crawl rate is the QPS of crawl request Google + /// sends to the user's website. + /// + public class GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Google's organic crawl rate time series, which is the sum of all googlebots' crawl rate. Please refer to + /// https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers for more details about + /// googlebots. + /// + [Newtonsoft.Json.JsonPropertyAttribute("googleOrganicCrawlRate")] + public virtual GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries GoogleOrganicCrawlRate { get; set; } + + /// + /// Vertex AI's organic crawl rate time series, which is the crawl rate of Google-CloudVertexBot when dedicate + /// crawl is not set. Please refer to + /// https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot for + /// more details about Google-CloudVertexBot. + /// + [Newtonsoft.Json.JsonPropertyAttribute("vertexAiOrganicCrawlRate")] + public virtual GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries VertexAiOrganicCrawlRate { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Metadata and configurations for a Google Cloud project in the service. public class GoogleCloudDiscoveryengineV1alphaProject : Google.Apis.Requests.IDirectResponseSchema { @@ -26364,6 +27271,273 @@ public class GoogleCloudDiscoveryengineV1alphaWorkspaceConfig : Google.Apis.Requ public virtual string ETag { get; set; } } + /// Request message for CompletionService.AdvancedCompleteQuery method. . + public class GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest : Google.Apis.Requests.IDirectResponseSchema + { + /// Optional. Specification to boost suggestions matching the condition. + [Newtonsoft.Json.JsonPropertyAttribute("boostSpec")] + public virtual GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpec BoostSpec { get; set; } + + /// + /// Indicates if tail suggestions should be returned if there are no suggestions that match the full query. Even + /// if set to true, if there are suggestions that match the full query, those are returned and no tail + /// suggestions are returned. + /// + [Newtonsoft.Json.JsonPropertyAttribute("includeTailSuggestions")] + public virtual System.Nullable IncludeTailSuggestions { get; set; } + + /// + /// Required. The typeahead input used to fetch suggestions. Maximum length is 128 characters. The query can not + /// be empty for most of the suggestion types. If it is empty, an `INVALID_ARGUMENT` error is returned. The + /// exception is when the suggestion_types contains only the type `RECENT_SEARCH`, the query can be an empty + /// string. The is called "zero prefix" feature, which returns user's recently searched queries given the empty + /// query. + /// + [Newtonsoft.Json.JsonPropertyAttribute("query")] + public virtual string Query { get; set; } + + /// + /// Specifies the autocomplete data model. This overrides any model specified in the Configuration &gt; + /// Autocomplete section of the Cloud console. Currently supported values: * `document` - Using suggestions + /// generated from user-imported documents. * `search-history` - Using suggestions generated from the past + /// history of SearchService.Search API calls. Do not use it when there is no traffic for Search API. * + /// `user-event` - Using suggestions generated from user-imported search events. * `document-completable` - + /// Using suggestions taken directly from user-imported document fields marked as completable. Default values: * + /// `document` is the default model for regular dataStores. * `search-history` is the default model for site + /// search dataStores. + /// + [Newtonsoft.Json.JsonPropertyAttribute("queryModel")] + public virtual string QueryModel { get; set; } + + /// + /// Optional. Suggestion types to return. If empty or unspecified, query suggestions are returned. Only one + /// suggestion type is supported at the moment. + /// + [Newtonsoft.Json.JsonPropertyAttribute("suggestionTypes")] + public virtual System.Collections.Generic.IList SuggestionTypes { get; set; } + + /// + /// Optional. Information about the end user. This should be the same identifier information as + /// UserEvent.user_info and SearchRequest.user_info. + /// + [Newtonsoft.Json.JsonPropertyAttribute("userInfo")] + public virtual GoogleCloudDiscoveryengineV1betaUserInfo UserInfo { get; set; } + + /// + /// A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which + /// should be able to uniquely identify a visitor on a single device. This unique identifier should not change + /// if the visitor logs in or out of the website. This field should NOT have a fixed value such as + /// `unknown_visitor`. This should be the same identifier as UserEvent.user_pseudo_id and + /// SearchRequest.user_pseudo_id. The field must be a UTF-8 encoded string with a length limit of 128 + /// + [Newtonsoft.Json.JsonPropertyAttribute("userPseudoId")] + public virtual string UserPseudoId { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Specification to boost suggestions based on the condtion of the suggestion. + public class GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpec : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Condition boost specifications. If a suggestion matches multiple conditions in the specifictions, boost + /// values from these specifications are all applied and combined in a non-linear way. Maximum number of + /// specifications is 20. Note: Currently only support language condition boost. + /// + [Newtonsoft.Json.JsonPropertyAttribute("conditionBoostSpecs")] + public virtual System.Collections.Generic.IList ConditionBoostSpecs { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Boost applies to suggestions which match a condition. + public class GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to + /// 1.0 gives the suggestions a big promotion. However, it does not necessarily mean that the top result will be + /// a boosted suggestion. Setting to -1.0 gives the suggestions a big demotion. However, other suggestions that + /// are relevant might still be shown. Setting to 0.0 means no boost applied. The boosting condition is ignored. + /// + [Newtonsoft.Json.JsonPropertyAttribute("boost")] + public virtual System.Nullable Boost { get; set; } + + /// + /// An expression which specifies a boost condition. The syntax is the same as [filter expression + /// syntax](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax). + /// Currently, the only supported condition is a list of BCP-47 lang codes. Example: * To boost suggestions in + /// languages `en` or `fr`: `(lang_code: ANY("en", "fr"))` + /// + [Newtonsoft.Json.JsonPropertyAttribute("condition")] + public virtual string Condition { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Response message for CompletionService.AdvancedCompleteQuery method. + public class GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Results of the matched content suggestions. The result list is ordered and the first result is the top + /// suggestion. + /// + [Newtonsoft.Json.JsonPropertyAttribute("contentSuggestions")] + public virtual System.Collections.Generic.IList ContentSuggestions { get; set; } + + /// + /// Results of the matched people suggestions. The result list is ordered and the first result is the top + /// suggestion. + /// + [Newtonsoft.Json.JsonPropertyAttribute("peopleSuggestions")] + public virtual System.Collections.Generic.IList PeopleSuggestions { get; set; } + + /// + /// Results of the matched query suggestions. The result list is ordered and the first result is a top + /// suggestion. + /// + [Newtonsoft.Json.JsonPropertyAttribute("querySuggestions")] + public virtual System.Collections.Generic.IList QuerySuggestions { get; set; } + + /// + /// Results of the matched "recent search" suggestions. The result list is ordered and the first result is the + /// top suggestion. + /// + [Newtonsoft.Json.JsonPropertyAttribute("recentSearchSuggestions")] + public virtual System.Collections.Generic.IList RecentSearchSuggestions { get; set; } + + /// + /// True if the returned suggestions are all tail suggestions. For tail matching to be triggered, + /// include_tail_suggestions in the request must be true and there must be no suggestions that match the full + /// query. + /// + [Newtonsoft.Json.JsonPropertyAttribute("tailMatchTriggered")] + public virtual System.Nullable TailMatchTriggered { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Suggestions as content. + public class GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseContentSuggestion : Google.Apis.Requests.IDirectResponseSchema + { + /// The type of the content suggestion. + [Newtonsoft.Json.JsonPropertyAttribute("contentType")] + public virtual string ContentType { get; set; } + + /// The name of the dataStore that this suggestion belongs to. + [Newtonsoft.Json.JsonPropertyAttribute("dataStore")] + public virtual string DataStore { get; set; } + + /// The document data snippet in the suggestion. Only a subset of fields will be populated. + [Newtonsoft.Json.JsonPropertyAttribute("document")] + public virtual GoogleCloudDiscoveryengineV1betaDocument Document { get; set; } + + /// The suggestion for the query. + [Newtonsoft.Json.JsonPropertyAttribute("suggestion")] + public virtual string Suggestion { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Suggestions as people. + public class GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponsePersonSuggestion : Google.Apis.Requests.IDirectResponseSchema + { + /// The name of the dataStore that this suggestion belongs to. + [Newtonsoft.Json.JsonPropertyAttribute("dataStore")] + public virtual string DataStore { get; set; } + + /// The document data snippet in the suggestion. Only a subset of fields is populated. + [Newtonsoft.Json.JsonPropertyAttribute("document")] + public virtual GoogleCloudDiscoveryengineV1betaDocument Document { get; set; } + + /// The type of the person. + [Newtonsoft.Json.JsonPropertyAttribute("personType")] + public virtual string PersonType { get; set; } + + /// The suggestion for the query. + [Newtonsoft.Json.JsonPropertyAttribute("suggestion")] + public virtual string Suggestion { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Suggestions as search queries. + public class GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseQuerySuggestion : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// The unique document field paths that serve as the source of this suggestion if it was generated from + /// completable fields. This field is only populated for the document-completable model. + /// + [Newtonsoft.Json.JsonPropertyAttribute("completableFieldPaths")] + public virtual System.Collections.Generic.IList CompletableFieldPaths { get; set; } + + /// The name of the dataStore that this suggestion belongs to. + [Newtonsoft.Json.JsonPropertyAttribute("dataStore")] + public virtual System.Collections.Generic.IList DataStore { get; set; } + + /// The suggestion for the query. + [Newtonsoft.Json.JsonPropertyAttribute("suggestion")] + public virtual string Suggestion { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Suggestions from recent search history. + public class GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseRecentSearchSuggestion : Google.Apis.Requests.IDirectResponseSchema + { + private string _recentSearchTimeRaw; + + private object _recentSearchTime; + + /// The time when this recent rearch happened. + [Newtonsoft.Json.JsonPropertyAttribute("recentSearchTime")] + public virtual string RecentSearchTimeRaw + { + get => _recentSearchTimeRaw; + set + { + _recentSearchTime = Google.Apis.Util.Utilities.DeserializeForGoogleFormat(value); + _recentSearchTimeRaw = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + [System.ObsoleteAttribute("This property is obsolete and may behave unexpectedly; please use RecentSearchTimeDateTimeOffset instead.")] + public virtual object RecentSearchTime + { + get => _recentSearchTime; + set + { + _recentSearchTimeRaw = Google.Apis.Util.Utilities.SerializeForGoogleFormat(value); + _recentSearchTime = value; + } + } + + /// + /// representation of . + /// + [Newtonsoft.Json.JsonIgnoreAttribute] + public virtual System.DateTimeOffset? RecentSearchTimeDateTimeOffset + { + get => Google.Apis.Util.DiscoveryFormat.ParseGoogleDateTimeToDateTimeOffset(RecentSearchTimeRaw); + set => RecentSearchTimeRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); + } + + /// The suggestion for the query. + [Newtonsoft.Json.JsonPropertyAttribute("suggestion")] + public virtual string Suggestion { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Configuration data for advance site search. public class GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig : Google.Apis.Requests.IDirectResponseSchema { @@ -26585,6 +27759,10 @@ public class GoogleCloudDiscoveryengineV1betaAnswerQueryRequest : Google.Apis.Re [Newtonsoft.Json.JsonPropertyAttribute("asynchronousMode")] public virtual System.Nullable AsynchronousMode { get; set; } + /// Optional. Grounding specification. + [Newtonsoft.Json.JsonPropertyAttribute("groundingSpec")] + public virtual GoogleCloudDiscoveryengineV1betaAnswerQueryRequestGroundingSpec GroundingSpec { get; set; } + /// Required. Current user query. [Newtonsoft.Json.JsonPropertyAttribute("query")] public virtual GoogleCloudDiscoveryengineV1betaQuery Query { get; set; } @@ -26731,6 +27909,27 @@ public class GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationS public virtual string ETag { get; set; } } + /// Grounding specification. + public class GoogleCloudDiscoveryengineV1betaAnswerQueryRequestGroundingSpec : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Optional. Specifies whether to enable the filtering based on grounding score and at what level. + /// + [Newtonsoft.Json.JsonPropertyAttribute("filteringLevel")] + public virtual string FilteringLevel { get; set; } + + /// + /// Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When + /// this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports + /// for each claim. + /// + [Newtonsoft.Json.JsonPropertyAttribute("includeGroundingSupports")] + public virtual System.Nullable IncludeGroundingSupports { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Query understanding specification. public class GoogleCloudDiscoveryengineV1betaAnswerQueryRequestQueryUnderstandingSpec : Google.Apis.Requests.IDirectResponseSchema { @@ -36019,10 +37218,10 @@ public virtual System.DateTimeOffset? EventTimeDateTimeOffset /// Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * /// `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of /// Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. - /// Home &gt; Men &gt; Jeans Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in - /// Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume - /// watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, - /// etc. + /// Home &gt; Men &gt; Jeans * `add-feedback`: Add a user feedback. Retail-related values: * + /// `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) + /// Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * + /// `media-complete`: Finished or stopped midway through a video, song, etc. /// [Newtonsoft.Json.JsonPropertyAttribute("eventType")] public virtual string EventType { get; set; } @@ -36228,6 +37427,220 @@ public class GoogleLongrunningOperation : Google.Apis.Requests.IDirectResponseSc public virtual string ETag { get; set; } } + /// A single data point in a time series. + public class GoogleMonitoringV3Point : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// The time interval to which the data point applies. For `GAUGE` metrics, the start time is optional, but if + /// it is supplied, it must equal the end time. For `DELTA` metrics, the start and end time should specify a + /// non-zero interval, with subsequent points specifying contiguous and non-overlapping intervals. For + /// `CUMULATIVE` metrics, the start and end time should specify a non-zero interval, with subsequent points + /// specifying the same start time and increasing end times, until an event resets the cumulative value to zero + /// and sets a new start time for the following points. + /// + [Newtonsoft.Json.JsonPropertyAttribute("interval")] + public virtual GoogleMonitoringV3TimeInterval Interval { get; set; } + + /// The value of the data point. + [Newtonsoft.Json.JsonPropertyAttribute("value")] + public virtual GoogleMonitoringV3TypedValue Value { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// A time interval extending just after a start time through an end time. If the start time is the same as the end + /// time, then the interval represents a single point in time. + /// + public class GoogleMonitoringV3TimeInterval : Google.Apis.Requests.IDirectResponseSchema + { + private string _endTimeRaw; + + private object _endTime; + + /// Required. The end of the time interval. + [Newtonsoft.Json.JsonPropertyAttribute("endTime")] + public virtual string EndTimeRaw + { + get => _endTimeRaw; + set + { + _endTime = Google.Apis.Util.Utilities.DeserializeForGoogleFormat(value); + _endTimeRaw = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + [System.ObsoleteAttribute("This property is obsolete and may behave unexpectedly; please use EndTimeDateTimeOffset instead.")] + public virtual object EndTime + { + get => _endTime; + set + { + _endTimeRaw = Google.Apis.Util.Utilities.SerializeForGoogleFormat(value); + _endTime = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + public virtual System.DateTimeOffset? EndTimeDateTimeOffset + { + get => Google.Apis.Util.DiscoveryFormat.ParseGoogleDateTimeToDateTimeOffset(EndTimeRaw); + set => EndTimeRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); + } + + private string _startTimeRaw; + + private object _startTime; + + /// + /// Optional. The beginning of the time interval. The default value for the start time is the end time. The + /// start time must not be later than the end time. + /// + [Newtonsoft.Json.JsonPropertyAttribute("startTime")] + public virtual string StartTimeRaw + { + get => _startTimeRaw; + set + { + _startTime = Google.Apis.Util.Utilities.DeserializeForGoogleFormat(value); + _startTimeRaw = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + [System.ObsoleteAttribute("This property is obsolete and may behave unexpectedly; please use StartTimeDateTimeOffset instead.")] + public virtual object StartTime + { + get => _startTime; + set + { + _startTimeRaw = Google.Apis.Util.Utilities.SerializeForGoogleFormat(value); + _startTime = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + public virtual System.DateTimeOffset? StartTimeDateTimeOffset + { + get => Google.Apis.Util.DiscoveryFormat.ParseGoogleDateTimeToDateTimeOffset(StartTimeRaw); + set => StartTimeRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); + } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// A collection of data points that describes the time-varying values of a metric. A time series is identified by a + /// combination of a fully-specified monitored resource and a fully-specified metric. This type is used for both + /// listing and creating time series. + /// + public class GoogleMonitoringV3TimeSeries : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Input only. A detailed description of the time series that will be associated with the + /// google.api.MetricDescriptor for the metric. Once set, this field cannot be changed through CreateTimeSeries. + /// + [Newtonsoft.Json.JsonPropertyAttribute("description")] + public virtual string Description { get; set; } + + /// + /// Output only. The associated monitored resource metadata. When reading a time series, this field will include + /// metadata labels that are explicitly named in the reduction. When creating a time series, this field is + /// ignored. + /// + [Newtonsoft.Json.JsonPropertyAttribute("metadata")] + public virtual GoogleApiMonitoredResourceMetadata Metadata { get; set; } + + /// The associated metric. A fully-specified metric used to identify the time series. + [Newtonsoft.Json.JsonPropertyAttribute("metric")] + public virtual GoogleApiMetric Metric { get; set; } + + /// + /// The metric kind of the time series. When listing time series, this metric kind might be different from the + /// metric kind of the associated metric if this time series is an alignment or reduction of other time series. + /// When creating a time series, this field is optional. If present, it must be the same as the metric kind of + /// the associated metric. If the associated metric's descriptor must be auto-created, then this field specifies + /// the metric kind of the new descriptor and must be either `GAUGE` (the default) or `CUMULATIVE`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("metricKind")] + public virtual string MetricKind { get; set; } + + /// + /// The data points of this time series. When listing time series, points are returned in reverse time order. + /// When creating a time series, this field must contain exactly one point and the point's type must be the same + /// as the value type of the associated metric. If the associated metric's descriptor must be auto-created, then + /// the value type of the descriptor is determined by the point's type, which must be `BOOL`, `INT64`, `DOUBLE`, + /// or `DISTRIBUTION`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("points")] + public virtual System.Collections.Generic.IList Points { get; set; } + + /// + /// The associated monitored resource. Custom metrics can use only certain monitored resource types in their + /// time series data. For more information, see [Monitored resources for custom + /// metrics](https://cloud.google.com/monitoring/custom-metrics/creating-metrics#custom-metric-resources). + /// + [Newtonsoft.Json.JsonPropertyAttribute("resource")] + public virtual GoogleApiMonitoredResource Resource { get; set; } + + /// + /// The units in which the metric value is reported. It is only applicable if the `value_type` is `INT64`, + /// `DOUBLE`, or `DISTRIBUTION`. The `unit` defines the representation of the stored metric values. This field + /// can only be changed through CreateTimeSeries when it is empty. + /// + [Newtonsoft.Json.JsonPropertyAttribute("unit")] + public virtual string Unit { get; set; } + + /// + /// The value type of the time series. When listing time series, this value type might be different from the + /// value type of the associated metric if this time series is an alignment or reduction of other time series. + /// When creating a time series, this field is optional. If present, it must be the same as the type of the data + /// in the `points` field. + /// + [Newtonsoft.Json.JsonPropertyAttribute("valueType")] + public virtual string ValueType { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// A single strongly-typed value. + public class GoogleMonitoringV3TypedValue : Google.Apis.Requests.IDirectResponseSchema + { + /// A Boolean value: `true` or `false`. + [Newtonsoft.Json.JsonPropertyAttribute("boolValue")] + public virtual System.Nullable BoolValue { get; set; } + + /// A distribution value. + [Newtonsoft.Json.JsonPropertyAttribute("distributionValue")] + public virtual GoogleApiDistribution DistributionValue { get; set; } + + /// + /// A 64-bit double-precision floating-point number. Its magnitude is approximately ±10±300 and it has 16 + /// significant digits of precision. + /// + [Newtonsoft.Json.JsonPropertyAttribute("doubleValue")] + public virtual System.Nullable DoubleValue { get; set; } + + /// A 64-bit integer. Its range is approximately ±9.2x1018. + [Newtonsoft.Json.JsonPropertyAttribute("int64Value")] + public virtual System.Nullable Int64Value { get; set; } + + /// A variable-length string value. + [Newtonsoft.Json.JsonPropertyAttribute("stringValue")] + public virtual string StringValue { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// /// A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical /// example is to use it as the request or the response type of an API method. For instance: service Foo { rpc diff --git a/Src/Generated/Google.Apis.DiscoveryEngine.v1beta/Google.Apis.DiscoveryEngine.v1beta.csproj b/Src/Generated/Google.Apis.DiscoveryEngine.v1beta/Google.Apis.DiscoveryEngine.v1beta.csproj index 0a4cca8e66b..972a835f23f 100644 --- a/Src/Generated/Google.Apis.DiscoveryEngine.v1beta/Google.Apis.DiscoveryEngine.v1beta.csproj +++ b/Src/Generated/Google.Apis.DiscoveryEngine.v1beta/Google.Apis.DiscoveryEngine.v1beta.csproj @@ -3,7 +3,7 @@ Google.Apis.DiscoveryEngine.v1beta Client Library - 1.68.0.3580 + 1.68.0.3585 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.Document.v1beta3/Google.Apis.Document.v1beta3.cs b/Src/Generated/Google.Apis.Document.v1beta3/Google.Apis.Document.v1beta3.cs index b1aec96caaf..b768885fbfa 100644 --- a/Src/Generated/Google.Apis.Document.v1beta3/Google.Apis.Document.v1beta3.cs +++ b/Src/Generated/Google.Apis.Document.v1beta3/Google.Apis.Document.v1beta3.cs @@ -4751,6 +4751,14 @@ public class GoogleCloudDocumentaiV1beta3DatasetSchema : Google.Apis.Requests.ID [Newtonsoft.Json.JsonPropertyAttribute("name")] public virtual string Name { get; set; } + /// Output only. Reserved for future use. + [Newtonsoft.Json.JsonPropertyAttribute("satisfiesPzi")] + public virtual System.Nullable SatisfiesPzi { get; set; } + + /// Output only. Reserved for future use. + [Newtonsoft.Json.JsonPropertyAttribute("satisfiesPzs")] + public virtual System.Nullable SatisfiesPzs { get; set; } + /// The ETag of the item. public virtual string ETag { get; set; } } diff --git a/Src/Generated/Google.Apis.Document.v1beta3/Google.Apis.Document.v1beta3.csproj b/Src/Generated/Google.Apis.Document.v1beta3/Google.Apis.Document.v1beta3.csproj index b6b84a13a5d..873fe9c4779 100644 --- a/Src/Generated/Google.Apis.Document.v1beta3/Google.Apis.Document.v1beta3.csproj +++ b/Src/Generated/Google.Apis.Document.v1beta3/Google.Apis.Document.v1beta3.csproj @@ -3,7 +3,7 @@ Google.Apis.Document.v1beta3 Client Library - 1.68.0.3541 + 1.68.0.3585 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.FirebaseAppDistribution.v1alpha/Google.Apis.FirebaseAppDistribution.v1alpha.cs b/Src/Generated/Google.Apis.FirebaseAppDistribution.v1alpha/Google.Apis.FirebaseAppDistribution.v1alpha.cs index 0a3c7b31794..83cc6fa9232 100644 --- a/Src/Generated/Google.Apis.FirebaseAppDistribution.v1alpha/Google.Apis.FirebaseAppDistribution.v1alpha.cs +++ b/Src/Generated/Google.Apis.FirebaseAppDistribution.v1alpha/Google.Apis.FirebaseAppDistribution.v1alpha.cs @@ -2320,6 +2320,12 @@ public virtual System.DateTimeOffset? CreateTimeDateTimeOffset [Newtonsoft.Json.JsonPropertyAttribute("deviceExecutions")] public virtual System.Collections.Generic.IList DeviceExecutions { get; set; } + /// + /// Optional. Display name of the release test. Required if the release test is created with multiple goals + /// + [Newtonsoft.Json.JsonPropertyAttribute("displayName")] + public virtual string DisplayName { get; set; } + /// Optional. Input only. Login credentials for the test. Input only. [Newtonsoft.Json.JsonPropertyAttribute("loginCredential")] public virtual GoogleFirebaseAppdistroV1alphaLoginCredential LoginCredential { get; set; } diff --git a/Src/Generated/Google.Apis.FirebaseAppDistribution.v1alpha/Google.Apis.FirebaseAppDistribution.v1alpha.csproj b/Src/Generated/Google.Apis.FirebaseAppDistribution.v1alpha/Google.Apis.FirebaseAppDistribution.v1alpha.csproj index 4428678ea87..256bb2f353e 100644 --- a/Src/Generated/Google.Apis.FirebaseAppDistribution.v1alpha/Google.Apis.FirebaseAppDistribution.v1alpha.csproj +++ b/Src/Generated/Google.Apis.FirebaseAppDistribution.v1alpha/Google.Apis.FirebaseAppDistribution.v1alpha.csproj @@ -3,7 +3,7 @@ Google.Apis.FirebaseAppDistribution.v1alpha Client Library - 1.68.0.3578 + 1.68.0.3588 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.FirebaseManagement.v1beta1/Google.Apis.FirebaseManagement.v1beta1.cs b/Src/Generated/Google.Apis.FirebaseManagement.v1beta1/Google.Apis.FirebaseManagement.v1beta1.cs index 3acb1df3757..c95f8e687b1 100644 --- a/Src/Generated/Google.Apis.FirebaseManagement.v1beta1/Google.Apis.FirebaseManagement.v1beta1.cs +++ b/Src/Generated/Google.Apis.FirebaseManagement.v1beta1/Google.Apis.FirebaseManagement.v1beta1.cs @@ -3459,8 +3459,9 @@ public class AndroidApp : Google.Apis.Requests.IDirectResponseSchema private object _expireTime; /// - /// Output only. Timestamp of when the App will be considered expired and cannot be undeleted. This value is - /// only provided if the App is in the `DELETED` state. + /// Output only. If the App has been removed from the Project, this is the timestamp of when the App is + /// considered expired and will be permanently deleted. After this time, the App cannot be undeleted (that is, + /// restored to the Project). This value is only provided if the App is in the `DELETED` state. /// [Newtonsoft.Json.JsonPropertyAttribute("expireTime")] public virtual string ExpireTimeRaw @@ -3673,8 +3674,9 @@ public class FirebaseAppInfo : Google.Apis.Requests.IDirectResponseSchema private object _expireTime; /// - /// Output only. Timestamp of when the App will be considered expired and cannot be undeleted. This value is - /// only provided if the App is in the `DELETED` state. + /// Output only. If the App has been removed from the Project, this is the timestamp of when the App is + /// considered expired and will be permanently deleted. After this time, the App cannot be undeleted (that is, + /// restored to the Project). This value is only provided if the App is in the `DELETED` state. /// [Newtonsoft.Json.JsonPropertyAttribute("expireTime")] public virtual string ExpireTimeRaw @@ -3861,8 +3863,9 @@ public class IosApp : Google.Apis.Requests.IDirectResponseSchema private object _expireTime; /// - /// Output only. Timestamp of when the App will be considered expired and cannot be undeleted. This value is - /// only provided if the App is in the `DELETED` state. + /// Output only. If the App has been removed from the Project, this is the timestamp of when the App is + /// considered expired and will be permanently deleted. After this time, the App cannot be undeleted (that is, + /// restored to the Project). This value is only provided if the App is in the `DELETED` state. /// [Newtonsoft.Json.JsonPropertyAttribute("expireTime")] public virtual string ExpireTimeRaw @@ -4222,9 +4225,9 @@ public class RemoveAndroidAppRequest : Google.Apis.Requests.IDirectResponseSchem /// /// Determines whether to _immediately_ delete the AndroidApp. If set to true, the App is immediately deleted - /// from the Project and cannot be restored to the Project. If not set, defaults to false, which means the App - /// will be set to expire in 30 days. Within the 30 days, the App may be restored to the Project using - /// UndeleteAndroidApp. + /// from the Project and cannot be undeleted (that is, restored to the Project). If not set, defaults to false, + /// which means the App will be set to expire in 30 days. Within the 30 days, the App may be restored to the + /// Project using UndeleteAndroidApp. /// [Newtonsoft.Json.JsonPropertyAttribute("immediate")] public virtual System.Nullable Immediate { get; set; } @@ -4252,8 +4255,9 @@ public class RemoveIosAppRequest : Google.Apis.Requests.IDirectResponseSchema /// /// Determines whether to _immediately_ delete the IosApp. If set to true, the App is immediately deleted from - /// the Project and cannot be restored to the Project. If not set, defaults to false, which means the App will - /// be set to expire in 30 days. Within the 30 days, the App may be restored to the Project using UndeleteIosApp + /// the Project and cannot be undeleted (that is, restored to the Project). If not set, defaults to false, which + /// means the App will be set to expire in 30 days. Within the 30 days, the App may be restored to the Project + /// using UndeleteIosApp /// [Newtonsoft.Json.JsonPropertyAttribute("immediate")] public virtual System.Nullable Immediate { get; set; } @@ -4281,8 +4285,9 @@ public class RemoveWebAppRequest : Google.Apis.Requests.IDirectResponseSchema /// /// Determines whether to _immediately_ delete the WebApp. If set to true, the App is immediately deleted from - /// the Project and cannot be restored to the Project. If not set, defaults to false, which means the App will - /// be set to expire in 30 days. Within the 30 days, the App may be restored to the Project using UndeleteWebApp + /// the Project and cannot be undeleted (that is, restored to the Project). If not set, defaults to false, which + /// means the App will be set to expire in 30 days. Within the 30 days, the App may be restored to the Project + /// using UndeleteWebApp /// [Newtonsoft.Json.JsonPropertyAttribute("immediate")] public virtual System.Nullable Immediate { get; set; } @@ -4523,8 +4528,9 @@ public class WebApp : Google.Apis.Requests.IDirectResponseSchema private object _expireTime; /// - /// Output only. Timestamp of when the App will be considered expired and cannot be undeleted. This value is - /// only provided if the App is in the `DELETED` state. + /// Output only. If the App has been removed from the Project, this is the timestamp of when the App is + /// considered expired and will be permanently deleted. After this time, the App cannot be undeleted (that is, + /// restored to the Project). This value is only provided if the App is in the `DELETED` state. /// [Newtonsoft.Json.JsonPropertyAttribute("expireTime")] public virtual string ExpireTimeRaw diff --git a/Src/Generated/Google.Apis.FirebaseManagement.v1beta1/Google.Apis.FirebaseManagement.v1beta1.csproj b/Src/Generated/Google.Apis.FirebaseManagement.v1beta1/Google.Apis.FirebaseManagement.v1beta1.csproj index 2105775cb73..72a91b5073b 100644 --- a/Src/Generated/Google.Apis.FirebaseManagement.v1beta1/Google.Apis.FirebaseManagement.v1beta1.csproj +++ b/Src/Generated/Google.Apis.FirebaseManagement.v1beta1/Google.Apis.FirebaseManagement.v1beta1.csproj @@ -3,7 +3,7 @@ Google.Apis.FirebaseManagement.v1beta1 Client Library - 1.68.0.3543 + 1.68.0.3585 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.Firestore.v1/Google.Apis.Firestore.v1.cs b/Src/Generated/Google.Apis.Firestore.v1/Google.Apis.Firestore.v1.cs index 0d41e138032..0e7eb5703d5 100644 --- a/Src/Generated/Google.Apis.Firestore.v1/Google.Apis.Firestore.v1.cs +++ b/Src/Generated/Google.Apis.Firestore.v1/Google.Apis.Firestore.v1.cs @@ -5050,8 +5050,8 @@ public class FindNearest : Google.Apis.Requests.IDirectResponseSchema /// /// Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior /// of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT - /// distances increase when the vectors are more similar, the comparison is inverted. For EUCLIDEAN, COSINE: - /// WHERE distance &lt;= distance_threshold For DOT_PRODUCT: WHERE distance &gt;= distance_threshold + /// distances increase when the vectors are more similar, the comparison is inverted. * For EUCLIDEAN, COSINE: + /// WHERE distance &lt;= distance_threshold * For DOT_PRODUCT: WHERE distance &gt;= distance_threshold /// [Newtonsoft.Json.JsonPropertyAttribute("distanceThreshold")] public virtual System.Nullable DistanceThreshold { get; set; } @@ -7859,7 +7859,7 @@ public class StructuredAggregationQuery : Google.Apis.Requests.IDirectResponseSc /// /// A Firestore query. The query stages are executed in the following order: 1. from 2. where 3. select 4. order_by - /// + start_at + end_at 5. offset 6. limit + /// + start_at + end_at 5. offset 6. limit 7. find_nearest /// public class StructuredQuery : Google.Apis.Requests.IDirectResponseSchema { diff --git a/Src/Generated/Google.Apis.Firestore.v1/Google.Apis.Firestore.v1.csproj b/Src/Generated/Google.Apis.Firestore.v1/Google.Apis.Firestore.v1.csproj index 646870cc447..41c0f6134a3 100644 --- a/Src/Generated/Google.Apis.Firestore.v1/Google.Apis.Firestore.v1.csproj +++ b/Src/Generated/Google.Apis.Firestore.v1/Google.Apis.Firestore.v1.csproj @@ -3,7 +3,7 @@ Google.Apis.Firestore.v1 Client Library - 1.68.0.3534 + 1.68.0.3578 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.Firestore.v1beta1/Google.Apis.Firestore.v1beta1.cs b/Src/Generated/Google.Apis.Firestore.v1beta1/Google.Apis.Firestore.v1beta1.cs index 6d3760f84ef..91a2eefc240 100644 --- a/Src/Generated/Google.Apis.Firestore.v1beta1/Google.Apis.Firestore.v1beta1.cs +++ b/Src/Generated/Google.Apis.Firestore.v1beta1/Google.Apis.Firestore.v1beta1.cs @@ -3356,8 +3356,8 @@ public class FindNearest : Google.Apis.Requests.IDirectResponseSchema /// /// Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior /// of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT - /// distances increase when the vectors are more similar, the comparison is inverted. For EUCLIDEAN, COSINE: - /// WHERE distance &lt;= distance_threshold For DOT_PRODUCT: WHERE distance &gt;= distance_threshold + /// distances increase when the vectors are more similar, the comparison is inverted. * For EUCLIDEAN, COSINE: + /// WHERE distance &lt;= distance_threshold * For DOT_PRODUCT: WHERE distance &gt;= distance_threshold /// [Newtonsoft.Json.JsonPropertyAttribute("distanceThreshold")] public virtual System.Nullable DistanceThreshold { get; set; } @@ -4972,7 +4972,7 @@ public class StructuredAggregationQuery : Google.Apis.Requests.IDirectResponseSc /// /// A Firestore query. The query stages are executed in the following order: 1. from 2. where 3. select 4. order_by - /// + start_at + end_at 5. offset 6. limit + /// + start_at + end_at 5. offset 6. limit 7. find_nearest /// public class StructuredQuery : Google.Apis.Requests.IDirectResponseSchema { diff --git a/Src/Generated/Google.Apis.Firestore.v1beta1/Google.Apis.Firestore.v1beta1.csproj b/Src/Generated/Google.Apis.Firestore.v1beta1/Google.Apis.Firestore.v1beta1.csproj index 72d0b20e483..26a3b70a80b 100644 --- a/Src/Generated/Google.Apis.Firestore.v1beta1/Google.Apis.Firestore.v1beta1.csproj +++ b/Src/Generated/Google.Apis.Firestore.v1beta1/Google.Apis.Firestore.v1beta1.csproj @@ -3,7 +3,7 @@ Google.Apis.Firestore.v1beta1 Client Library - 1.68.0.3521 + 1.68.0.3578 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.Iam.v1/Google.Apis.Iam.v1.cs b/Src/Generated/Google.Apis.Iam.v1/Google.Apis.Iam.v1.cs index 86045216fb4..7e6ad73ef6b 100644 --- a/Src/Generated/Google.Apis.Iam.v1/Google.Apis.Iam.v1.cs +++ b/Src/Generated/Google.Apis.Iam.v1/Google.Apis.Iam.v1.cs @@ -1652,7 +1652,9 @@ protected override void InitParameters() /// Creates a new WorkforcePool. You cannot reuse the name of a deleted pool until 30 days after deletion. /// /// The body of the request. - /// The location of the pool to create. Format: `locations/{location}`. + /// + /// Optional. The location of the pool to create. Format: `locations/{location}`. + /// public virtual CreateRequest Create(Google.Apis.Iam.v1.Data.WorkforcePool body, string location) { return new CreateRequest(this.service, body, location); @@ -1671,15 +1673,15 @@ public CreateRequest(Google.Apis.Services.IClientService service, Google.Apis.Ia InitParameters(); } - /// The location of the pool to create. Format: `locations/{location}`. + /// Optional. The location of the pool to create. Format: `locations/{location}`. [Google.Apis.Util.RequestParameterAttribute("location", Google.Apis.Util.RequestParameterType.Path)] public virtual string Location { get; private set; } /// - /// The ID to use for the pool, which becomes the final component of the resource name. The IDs must be - /// a globally unique string of 6 to 63 lowercase letters, digits, or hyphens. It must start with a - /// letter, and cannot have a trailing hyphen. The prefix `gcp-` is reserved for use by Google, and may - /// not be specified. + /// Optional. The ID to use for the pool, which becomes the final component of the resource name. The + /// IDs must be a globally unique string of 6 to 63 lowercase letters, digits, or hyphens. It must start + /// with a letter, and cannot have a trailing hyphen. The prefix `gcp-` is reserved for use by Google, + /// and may not be specified. /// [Google.Apis.Util.RequestParameterAttribute("workforcePoolId", Google.Apis.Util.RequestParameterType.Query)] public virtual string WorkforcePoolId { get; set; } @@ -8542,7 +8544,9 @@ public class GoogleIamAdminV1WorkforcePoolProviderOidc : Google.Apis.Requests.ID [Newtonsoft.Json.JsonPropertyAttribute("clientId")] public virtual string ClientId { get; set; } - /// The optional client secret. Required to enable Authorization Code flow for web sign-in. + /// + /// Optional. The optional client secret. Required to enable Authorization Code flow for web sign-in. + /// [Newtonsoft.Json.JsonPropertyAttribute("clientSecret")] public virtual GoogleIamAdminV1WorkforcePoolProviderOidcClientSecret ClientSecret { get; set; } @@ -8551,7 +8555,7 @@ public class GoogleIamAdminV1WorkforcePoolProviderOidc : Google.Apis.Requests.ID public virtual string IssuerUri { get; set; } /// - /// OIDC JWKs in JSON String format. For details on the definition of a JWK, see + /// Optional. OIDC JWKs in JSON String format. For details on the definition of a JWK, see /// https://tools.ietf.org/html/rfc7517. If not set, the `jwks_uri` from the discovery document(fetched from the /// .well-known path of the `issuer_uri`) will be used. Currently, RSA and EC asymmetric keys are supported. The /// JWK must use following format and include only the following fields: { "keys": [ { "kty": "RSA/EC", "alg": @@ -8586,8 +8590,8 @@ public class GoogleIamAdminV1WorkforcePoolProviderOidcClientSecret : Google.Apis public class GoogleIamAdminV1WorkforcePoolProviderOidcClientSecretValue : Google.Apis.Requests.IDirectResponseSchema { /// - /// Input only. The plain text of the client secret value. For security reasons, this field is only used for - /// input and will never be populated in any response. + /// Optional. Input only. The plain text of the client secret value. For security reasons, this field is only + /// used for input and will never be populated in any response. /// [Newtonsoft.Json.JsonPropertyAttribute("plainText")] public virtual string PlainText { get; set; } @@ -8604,9 +8608,9 @@ public class GoogleIamAdminV1WorkforcePoolProviderOidcClientSecretValue : Google public class GoogleIamAdminV1WorkforcePoolProviderOidcWebSsoConfig : Google.Apis.Requests.IDirectResponseSchema { /// - /// Additional scopes to request for in the OIDC authentication request on top of scopes requested by default. - /// By default, the `openid`, `profile` and `email` scopes that are supported by the identity provider are - /// requested. Each additional scope may be at most 256 characters. A maximum of 10 additional scopes may be + /// Optional. Additional scopes to request for in the OIDC authentication request on top of scopes requested by + /// default. By default, the `openid`, `profile` and `email` scopes that are supported by the identity provider + /// are requested. Each additional scope may be at most 256 characters. A maximum of 10 additional scopes may be /// configured. /// [Newtonsoft.Json.JsonPropertyAttribute("additionalScopes")] @@ -10193,19 +10197,19 @@ public class WorkforcePool : Google.Apis.Requests.IDirectResponseSchema [Newtonsoft.Json.JsonPropertyAttribute("accessRestrictions")] public virtual AccessRestrictions AccessRestrictions { get; set; } - /// A user-specified description of the pool. Cannot exceed 256 characters. + /// Optional. A user-specified description of the pool. Cannot exceed 256 characters. [Newtonsoft.Json.JsonPropertyAttribute("description")] public virtual string Description { get; set; } /// - /// Disables the workforce pool. You cannot use a disabled pool to exchange tokens, or use existing tokens to - /// access resources. If the pool is re-enabled, existing tokens grant access again. + /// Optional. Disables the workforce pool. You cannot use a disabled pool to exchange tokens, or use existing + /// tokens to access resources. If the pool is re-enabled, existing tokens grant access again. /// [Newtonsoft.Json.JsonPropertyAttribute("disabled")] public virtual System.Nullable Disabled { get; set; } /// - /// A user-specified display name of the pool in Google Cloud Console. Cannot exceed 32 characters. + /// Optional. A user-specified display name of the pool in Google Cloud Console. Cannot exceed 32 characters. /// [Newtonsoft.Json.JsonPropertyAttribute("displayName")] public virtual string DisplayName { get; set; } @@ -10261,9 +10265,9 @@ public virtual System.DateTimeOffset? ExpireTimeDateTimeOffset public virtual string Parent { get; set; } /// - /// Duration that the Google Cloud access tokens, console sign-in sessions, and `gcloud` sign-in sessions from - /// this pool are valid. Must be greater than 15 minutes (900s) and less than 12 hours (43200s). If - /// `session_duration` is not configured, minted credentials have a default duration of one hour (3600s). For + /// Optional. Duration that the Google Cloud access tokens, console sign-in sessions, and `gcloud` sign-in + /// sessions from this pool are valid. Must be greater than 15 minutes (900s) and less than 12 hours (43200s). + /// If `session_duration` is not configured, minted credentials have a default duration of one hour (3600s). For /// SAML providers, the lifetime of the token is the minimum of the `session_duration` and the /// `SessionNotOnOrAfter` claim in the SAML assertion. /// @@ -10282,11 +10286,11 @@ public virtual System.DateTimeOffset? ExpireTimeDateTimeOffset public class WorkforcePoolProvider : Google.Apis.Requests.IDirectResponseSchema { /// - /// A [Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to - /// restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The - /// expression must output a boolean representing whether to allow the federation. The following keywords may be - /// referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the - /// provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. + /// Optional. A [Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, + /// to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. + /// The expression must output a boolean representing whether to allow the federation. The following keywords + /// may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued + /// by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. /// `google.profile_photo`, `google.display_name` and `google.posix_username` are not supported. * `attribute`: /// The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the /// attribute condition expression is 4096 characters. If unspecified, all valid authentication credentials will @@ -10338,18 +10342,18 @@ public class WorkforcePoolProvider : Google.Apis.Requests.IDirectResponseSchema [Newtonsoft.Json.JsonPropertyAttribute("attributeMapping")] public virtual System.Collections.Generic.IDictionary AttributeMapping { get; set; } - /// A user-specified description of the provider. Cannot exceed 256 characters. + /// Optional. A user-specified description of the provider. Cannot exceed 256 characters. [Newtonsoft.Json.JsonPropertyAttribute("description")] public virtual string Description { get; set; } /// - /// Disables the workforce pool provider. You cannot use a disabled provider to exchange tokens. However, - /// existing tokens still grant access. + /// Optional. Disables the workforce pool provider. You cannot use a disabled provider to exchange tokens. + /// However, existing tokens still grant access. /// [Newtonsoft.Json.JsonPropertyAttribute("disabled")] public virtual System.Nullable Disabled { get; set; } - /// A user-specified display name for the provider. Cannot exceed 32 characters. + /// Optional. A user-specified display name for the provider. Cannot exceed 32 characters. [Newtonsoft.Json.JsonPropertyAttribute("displayName")] public virtual string DisplayName { get; set; } diff --git a/Src/Generated/Google.Apis.Iam.v1/Google.Apis.Iam.v1.csproj b/Src/Generated/Google.Apis.Iam.v1/Google.Apis.Iam.v1.csproj index ea37b14025a..f7c768d48a6 100644 --- a/Src/Generated/Google.Apis.Iam.v1/Google.Apis.Iam.v1.csproj +++ b/Src/Generated/Google.Apis.Iam.v1/Google.Apis.Iam.v1.csproj @@ -3,7 +3,7 @@ Google.Apis.Iam.v1 Client Library - 1.68.0.3577 + 1.68.0.3588 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.Looker.v1/Google.Apis.Looker.v1.cs b/Src/Generated/Google.Apis.Looker.v1/Google.Apis.Looker.v1.cs index e8ff25f1e9c..b78c40268d6 100644 --- a/Src/Generated/Google.Apis.Looker.v1/Google.Apis.Looker.v1.cs +++ b/Src/Generated/Google.Apis.Looker.v1/Google.Apis.Looker.v1.cs @@ -2830,23 +2830,26 @@ public class TestIamPermissionsResponse : Google.Apis.Requests.IDirectResponseSc public class TimeOfDay : Google.Apis.Requests.IDirectResponseSchema { /// - /// Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for - /// scenarios like business closing time. + /// Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or + /// equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. /// [Newtonsoft.Json.JsonPropertyAttribute("hours")] public virtual System.Nullable Hours { get; set; } - /// Minutes of hour of day. Must be from 0 to 59. + /// Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59. [Newtonsoft.Json.JsonPropertyAttribute("minutes")] public virtual System.Nullable Minutes { get; set; } - /// Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. + /// + /// Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to + /// 999,999,999. + /// [Newtonsoft.Json.JsonPropertyAttribute("nanos")] public virtual System.Nullable Nanos { get; set; } /// - /// Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows - /// leap-seconds. + /// Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An + /// API may allow the value 60 if it allows leap-seconds. /// [Newtonsoft.Json.JsonPropertyAttribute("seconds")] public virtual System.Nullable Seconds { get; set; } diff --git a/Src/Generated/Google.Apis.Looker.v1/Google.Apis.Looker.v1.csproj b/Src/Generated/Google.Apis.Looker.v1/Google.Apis.Looker.v1.csproj index 88ea1702d2f..ac2cb824970 100644 --- a/Src/Generated/Google.Apis.Looker.v1/Google.Apis.Looker.v1.csproj +++ b/Src/Generated/Google.Apis.Looker.v1/Google.Apis.Looker.v1.csproj @@ -3,7 +3,7 @@ Google.Apis.Looker.v1 Client Library - 1.68.0.3540 + 1.68.0.3576 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.MapsPlaces.v1/Google.Apis.MapsPlaces.v1.cs b/Src/Generated/Google.Apis.MapsPlaces.v1/Google.Apis.MapsPlaces.v1.cs index 755e3343c38..6263709b16e 100644 --- a/Src/Generated/Google.Apis.MapsPlaces.v1/Google.Apis.MapsPlaces.v1.cs +++ b/Src/Generated/Google.Apis.MapsPlaces.v1/Google.Apis.MapsPlaces.v1.cs @@ -1456,6 +1456,14 @@ public class GoogleMapsPlacesV1Photo : Google.Apis.Requests.IDirectResponseSchem [Newtonsoft.Json.JsonPropertyAttribute("authorAttributions")] public virtual System.Collections.Generic.IList AuthorAttributions { get; set; } + /// A link where users can flag a problem with the photo. + [Newtonsoft.Json.JsonPropertyAttribute("flagContentUri")] + public virtual string FlagContentUri { get; set; } + + /// A link to show the photo on Google Maps. + [Newtonsoft.Json.JsonPropertyAttribute("googleMapsUri")] + public virtual string GoogleMapsUri { get; set; } + /// The maximum available height, in pixels. [Newtonsoft.Json.JsonPropertyAttribute("heightPx")] public virtual System.Nullable HeightPx { get; set; } @@ -1625,6 +1633,10 @@ public class GoogleMapsPlacesV1Place : Google.Apis.Requests.IDirectResponseSchem [Newtonsoft.Json.JsonPropertyAttribute("goodForWatchingSports")] public virtual System.Nullable GoodForWatchingSports { get; set; } + /// Links to trigger different Google Maps actions. + [Newtonsoft.Json.JsonPropertyAttribute("googleMapsLinks")] + public virtual GoogleMapsPlacesV1PlaceGoogleMapsLinks GoogleMapsLinks { get; set; } + /// A URL providing more information about this place. [Newtonsoft.Json.JsonPropertyAttribute("googleMapsUri")] public virtual string GoogleMapsUri { get; set; } @@ -1902,6 +1914,10 @@ public class GoogleMapsPlacesV1PlaceAreaSummary : Google.Apis.Requests.IDirectRe [Newtonsoft.Json.JsonPropertyAttribute("contentBlocks")] public virtual System.Collections.Generic.IList ContentBlocks { get; set; } + /// A link where users can flag a problem with the summary. + [Newtonsoft.Json.JsonPropertyAttribute("flagContentUri")] + public virtual string FlagContentUri { get; set; } + /// The ETag of the item. public virtual string ETag { get; set; } } @@ -1932,10 +1948,18 @@ public class GoogleMapsPlacesV1PlaceGenerativeSummary : Google.Apis.Requests.IDi [Newtonsoft.Json.JsonPropertyAttribute("description")] public virtual GoogleTypeLocalizedText Description { get; set; } + /// A link where users can flag a problem with the description summary. + [Newtonsoft.Json.JsonPropertyAttribute("descriptionFlagContentUri")] + public virtual string DescriptionFlagContentUri { get; set; } + /// The overview of the place. [Newtonsoft.Json.JsonPropertyAttribute("overview")] public virtual GoogleTypeLocalizedText Overview { get; set; } + /// A link where users can flag a problem with the overview summary. + [Newtonsoft.Json.JsonPropertyAttribute("overviewFlagContentUri")] + public virtual string OverviewFlagContentUri { get; set; } + /// References that are used to generate the summary description. [Newtonsoft.Json.JsonPropertyAttribute("references")] public virtual GoogleMapsPlacesV1References References { get; set; } @@ -1944,6 +1968,45 @@ public class GoogleMapsPlacesV1PlaceGenerativeSummary : Google.Apis.Requests.IDi public virtual string ETag { get; set; } } + /// Links to trigger different Google Maps actions. + public class GoogleMapsPlacesV1PlaceGoogleMapsLinks : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// A link to show the directions to the place. The link only populates the destination location and uses the + /// default travel mode `DRIVE`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("directionsUri")] + public virtual string DirectionsUri { get; set; } + + /// + /// A link to show photos of this place. This link is currently not supported on Google Maps Mobile and only + /// works on the web version of Google Maps. + /// + [Newtonsoft.Json.JsonPropertyAttribute("photosUri")] + public virtual string PhotosUri { get; set; } + + /// A link to show this place. + [Newtonsoft.Json.JsonPropertyAttribute("placeUri")] + public virtual string PlaceUri { get; set; } + + /// + /// A link to show reviews of this place. This link is currently not supported on Google Maps Mobile and only + /// works on the web version of Google Maps. + /// + [Newtonsoft.Json.JsonPropertyAttribute("reviewsUri")] + public virtual string ReviewsUri { get; set; } + + /// + /// A link to write a review for this place. This link is currently not supported on Google Maps Mobile and only + /// works on the web version of Google Maps. + /// + [Newtonsoft.Json.JsonPropertyAttribute("writeAReviewUri")] + public virtual string WriteAReviewUri { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Information about business hour of the place. public class GoogleMapsPlacesV1PlaceOpeningHours : Google.Apis.Requests.IDirectResponseSchema { @@ -2201,6 +2264,14 @@ public class GoogleMapsPlacesV1Review : Google.Apis.Requests.IDirectResponseSche [Newtonsoft.Json.JsonPropertyAttribute("authorAttribution")] public virtual GoogleMapsPlacesV1AuthorAttribution AuthorAttribution { get; set; } + /// A link where users can flag a problem with the review. + [Newtonsoft.Json.JsonPropertyAttribute("flagContentUri")] + public virtual string FlagContentUri { get; set; } + + /// A link to show the review on Google Maps. + [Newtonsoft.Json.JsonPropertyAttribute("googleMapsUri")] + public virtual string GoogleMapsUri { get; set; } + /// /// A reference representing this place review which may be used to look up this place review again (also called /// the API "resource" name: `places/{place_id}/reviews/{review}`). @@ -2344,6 +2415,15 @@ public class GoogleMapsPlacesV1RoutingParameters : Google.Apis.Requests.IDirectR /// public class GoogleMapsPlacesV1RoutingSummary : Google.Apis.Requests.IDirectResponseSchema { + /// + /// A link to show directions on Google Maps using the waypoints from the given routing summary. The route + /// generated by this link is not guaranteed to be the same as the route used to generate the routing summary. + /// The link uses information provided in the request, from fields including `routingParameters` and + /// `searchAlongRouteParameters` when applicable, to generate the directions link. + /// + [Newtonsoft.Json.JsonPropertyAttribute("directionsUri")] + public virtual string DirectionsUri { get; set; } + /// /// The legs of the trip. When you calculate travel duration and distance from a set origin, `legs` contains a /// single leg containing the duration and distance from the origin to the destination. When you do a search @@ -2750,6 +2830,12 @@ public class GoogleMapsPlacesV1SearchTextResponse : Google.Apis.Requests.IDirect [Newtonsoft.Json.JsonPropertyAttribute("routingSummaries")] public virtual System.Collections.Generic.IList RoutingSummaries { get; set; } + /// + /// A link allows the user to search with the same text query as specified in the request on Google Maps. + /// + [Newtonsoft.Json.JsonPropertyAttribute("searchUri")] + public virtual string SearchUri { get; set; } + /// The ETag of the item. public virtual string ETag { get; set; } } diff --git a/Src/Generated/Google.Apis.MapsPlaces.v1/Google.Apis.MapsPlaces.v1.csproj b/Src/Generated/Google.Apis.MapsPlaces.v1/Google.Apis.MapsPlaces.v1.csproj index 67424b92c38..de685139cbd 100644 --- a/Src/Generated/Google.Apis.MapsPlaces.v1/Google.Apis.MapsPlaces.v1.csproj +++ b/Src/Generated/Google.Apis.MapsPlaces.v1/Google.Apis.MapsPlaces.v1.csproj @@ -3,7 +3,7 @@ Google.Apis.MapsPlaces.v1 Client Library - 1.68.0.3582 + 1.68.0.3588 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.Merchant.accounts_v1beta/Google.Apis.Merchant.accounts_v1beta.cs b/Src/Generated/Google.Apis.Merchant.accounts_v1beta/Google.Apis.Merchant.accounts_v1beta.cs index cad98621a58..c8cbf3f6f02 100644 --- a/Src/Generated/Google.Apis.Merchant.accounts_v1beta/Google.Apis.Merchant.accounts_v1beta.cs +++ b/Src/Generated/Google.Apis.Merchant.accounts_v1beta/Google.Apis.Merchant.accounts_v1beta.cs @@ -3596,7 +3596,11 @@ public class BusinessInfo : Google.Apis.Requests.IDirectResponseSchema public virtual string ETag { get; set; } } - /// A list of carrier rates that can be referred to by `main_table` or `single_value`. + /// + /// A list of carrier rates that can be referred to by `main_table` or `single_value`. Supported carrier services + /// are defined in + /// https://support.google.com/merchants/answer/12577710?hl=en&amp;ref_topic=12570808&amp;sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only. + /// public class CarrierRate : Google.Apis.Requests.IDirectResponseSchema { /// Required. Carrier service, such as `"UPS"` or `"Fedex"`. @@ -5402,7 +5406,10 @@ public class Warehouse : Google.Apis.Requests.IDirectResponseSchema /// public class WarehouseBasedDeliveryTime : Google.Apis.Requests.IDirectResponseSchema { - /// Required. Carrier, such as `"UPS"` or `"Fedex"`. + /// + /// Required. Carrier, such as `"UPS"` or `"Fedex"`. [supported + /// carriers](https://support.google.com/merchants/answer/7050921#zippy=%2Ccarrier-rates-au-de-uk-and-us-only) + /// [Newtonsoft.Json.JsonPropertyAttribute("carrier")] public virtual string Carrier { get; set; } diff --git a/Src/Generated/Google.Apis.Merchant.accounts_v1beta/Google.Apis.Merchant.accounts_v1beta.csproj b/Src/Generated/Google.Apis.Merchant.accounts_v1beta/Google.Apis.Merchant.accounts_v1beta.csproj index 39578e81b9f..bd4bbdc3d42 100644 --- a/Src/Generated/Google.Apis.Merchant.accounts_v1beta/Google.Apis.Merchant.accounts_v1beta.csproj +++ b/Src/Generated/Google.Apis.Merchant.accounts_v1beta/Google.Apis.Merchant.accounts_v1beta.csproj @@ -3,7 +3,7 @@ Google.Apis.Merchant.accounts_v1beta Client Library - 1.68.0.3583 + 1.68.0.3588 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.OSConfig.v2beta/Google.Apis.OSConfig.v2beta.cs b/Src/Generated/Google.Apis.OSConfig.v2beta/Google.Apis.OSConfig.v2beta.cs new file mode 100644 index 00000000000..7058b5db043 --- /dev/null +++ b/Src/Generated/Google.Apis.OSConfig.v2beta/Google.Apis.OSConfig.v2beta.cs @@ -0,0 +1,1623 @@ +// Copyright 2024 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// https://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// Generated code. DO NOT EDIT! + +namespace Google.Apis.OSConfig.v2beta +{ + /// The OSConfig Service. + public class OSConfigService : Google.Apis.Services.BaseClientService + { + /// The API version. + public const string Version = "v2beta"; + + /// The discovery version used to generate this service. + public static Google.Apis.Discovery.DiscoveryVersion DiscoveryVersionUsed = Google.Apis.Discovery.DiscoveryVersion.Version_1_0; + + /// Constructs a new service. + public OSConfigService() : this(new Google.Apis.Services.BaseClientService.Initializer()) + { + } + + /// Constructs a new service. + /// The service initializer. + public OSConfigService(Google.Apis.Services.BaseClientService.Initializer initializer) : base(initializer) + { + Folders = new FoldersResource(this); + Organizations = new OrganizationsResource(this); + Projects = new ProjectsResource(this); + BaseUri = GetEffectiveUri(BaseUriOverride, "https://osconfig.googleapis.com/"); + BatchUri = GetEffectiveUri(null, "https://osconfig.googleapis.com/batch"); + } + + /// Gets the service supported features. + public override System.Collections.Generic.IList Features => new string[0]; + + /// Gets the service name. + public override string Name => "osconfig"; + + /// Gets the service base URI. + public override string BaseUri { get; } + + /// Gets the service base path. + public override string BasePath => ""; + + /// Gets the batch base URI; null if unspecified. + public override string BatchUri { get; } + + /// Gets the batch base path; null if unspecified. + public override string BatchPath => "batch"; + + /// Available OAuth 2.0 scopes for use with the OS Config API. + public class Scope + { + /// + /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google + /// Account. + /// + public static string CloudPlatform = "https://www.googleapis.com/auth/cloud-platform"; + } + + /// Available OAuth 2.0 scope constants for use with the OS Config API. + public static class ScopeConstants + { + /// + /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google + /// Account. + /// + public const string CloudPlatform = "https://www.googleapis.com/auth/cloud-platform"; + } + + /// Gets the Folders resource. + public virtual FoldersResource Folders { get; } + + /// Gets the Organizations resource. + public virtual OrganizationsResource Organizations { get; } + + /// Gets the Projects resource. + public virtual ProjectsResource Projects { get; } + } + + /// A base abstract class for OSConfig requests. + public abstract class OSConfigBaseServiceRequest : Google.Apis.Requests.ClientServiceRequest + { + /// Constructs a new OSConfigBaseServiceRequest instance. + protected OSConfigBaseServiceRequest(Google.Apis.Services.IClientService service) : base(service) + { + } + + /// V1 error format. + [Google.Apis.Util.RequestParameterAttribute("$.xgafv", Google.Apis.Util.RequestParameterType.Query)] + public virtual System.Nullable Xgafv { get; set; } + + /// V1 error format. + public enum XgafvEnum + { + /// v1 error format + [Google.Apis.Util.StringValueAttribute("1")] + Value1 = 0, + + /// v2 error format + [Google.Apis.Util.StringValueAttribute("2")] + Value2 = 1, + } + + /// OAuth access token. + [Google.Apis.Util.RequestParameterAttribute("access_token", Google.Apis.Util.RequestParameterType.Query)] + public virtual string AccessToken { get; set; } + + /// Data format for response. + [Google.Apis.Util.RequestParameterAttribute("alt", Google.Apis.Util.RequestParameterType.Query)] + public virtual System.Nullable Alt { get; set; } + + /// Data format for response. + public enum AltEnum + { + /// Responses with Content-Type of application/json + [Google.Apis.Util.StringValueAttribute("json")] + Json = 0, + + /// Media download with context-dependent Content-Type + [Google.Apis.Util.StringValueAttribute("media")] + Media = 1, + + /// Responses with Content-Type of application/x-protobuf + [Google.Apis.Util.StringValueAttribute("proto")] + Proto = 2, + } + + /// JSONP + [Google.Apis.Util.RequestParameterAttribute("callback", Google.Apis.Util.RequestParameterType.Query)] + public virtual string Callback { get; set; } + + /// Selector specifying which fields to include in a partial response. + [Google.Apis.Util.RequestParameterAttribute("fields", Google.Apis.Util.RequestParameterType.Query)] + public virtual string Fields { get; set; } + + /// + /// API key. Your API key identifies your project and provides you with API access, quota, and reports. Required + /// unless you provide an OAuth 2.0 token. + /// + [Google.Apis.Util.RequestParameterAttribute("key", Google.Apis.Util.RequestParameterType.Query)] + public virtual string Key { get; set; } + + /// OAuth 2.0 token for the current user. + [Google.Apis.Util.RequestParameterAttribute("oauth_token", Google.Apis.Util.RequestParameterType.Query)] + public virtual string OauthToken { get; set; } + + /// Returns response with indentations and line breaks. + [Google.Apis.Util.RequestParameterAttribute("prettyPrint", Google.Apis.Util.RequestParameterType.Query)] + public virtual System.Nullable PrettyPrint { get; set; } + + /// + /// Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a + /// user, but should not exceed 40 characters. + /// + [Google.Apis.Util.RequestParameterAttribute("quotaUser", Google.Apis.Util.RequestParameterType.Query)] + public virtual string QuotaUser { get; set; } + + /// Legacy upload protocol for media (e.g. "media", "multipart"). + [Google.Apis.Util.RequestParameterAttribute("uploadType", Google.Apis.Util.RequestParameterType.Query)] + public virtual string UploadType { get; set; } + + /// Upload protocol for media (e.g. "raw", "multipart"). + [Google.Apis.Util.RequestParameterAttribute("upload_protocol", Google.Apis.Util.RequestParameterType.Query)] + public virtual string UploadProtocol { get; set; } + + /// Initializes OSConfig parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("$.xgafv", new Google.Apis.Discovery.Parameter + { + Name = "$.xgafv", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + RequestParameters.Add("access_token", new Google.Apis.Discovery.Parameter + { + Name = "access_token", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + RequestParameters.Add("alt", new Google.Apis.Discovery.Parameter + { + Name = "alt", + IsRequired = false, + ParameterType = "query", + DefaultValue = "json", + Pattern = null, + }); + RequestParameters.Add("callback", new Google.Apis.Discovery.Parameter + { + Name = "callback", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + RequestParameters.Add("fields", new Google.Apis.Discovery.Parameter + { + Name = "fields", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + RequestParameters.Add("key", new Google.Apis.Discovery.Parameter + { + Name = "key", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + RequestParameters.Add("oauth_token", new Google.Apis.Discovery.Parameter + { + Name = "oauth_token", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + RequestParameters.Add("prettyPrint", new Google.Apis.Discovery.Parameter + { + Name = "prettyPrint", + IsRequired = false, + ParameterType = "query", + DefaultValue = "true", + Pattern = null, + }); + RequestParameters.Add("quotaUser", new Google.Apis.Discovery.Parameter + { + Name = "quotaUser", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + RequestParameters.Add("uploadType", new Google.Apis.Discovery.Parameter + { + Name = "uploadType", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + RequestParameters.Add("upload_protocol", new Google.Apis.Discovery.Parameter + { + Name = "upload_protocol", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + } + } + + /// The "folders" collection of methods. + public class FoldersResource + { + private const string Resource = "folders"; + + /// The service which this resource belongs to. + private readonly Google.Apis.Services.IClientService service; + + /// Constructs a new resource. + public FoldersResource(Google.Apis.Services.IClientService service) + { + this.service = service; + Locations = new LocationsResource(service); + } + + /// Gets the Locations resource. + public virtual LocationsResource Locations { get; } + + /// The "locations" collection of methods. + public class LocationsResource + { + private const string Resource = "locations"; + + /// The service which this resource belongs to. + private readonly Google.Apis.Services.IClientService service; + + /// Constructs a new resource. + public LocationsResource(Google.Apis.Services.IClientService service) + { + this.service = service; + Operations = new OperationsResource(service); + } + + /// Gets the Operations resource. + public virtual OperationsResource Operations { get; } + + /// The "operations" collection of methods. + public class OperationsResource + { + private const string Resource = "operations"; + + /// The service which this resource belongs to. + private readonly Google.Apis.Services.IClientService service; + + /// Constructs a new resource. + public OperationsResource(Google.Apis.Services.IClientService service) + { + this.service = service; + } + + /// + /// Starts asynchronous cancellation on a long-running operation. The server makes a best effort to + /// cancel the operation, but success is not guaranteed. If the server doesn't support this method, it + /// returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to + /// check whether the cancellation succeeded or whether the operation completed despite cancellation. On + /// successful cancellation, the operation is not deleted; instead, it becomes an operation with an + /// Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`. + /// + /// The body of the request. + /// The name of the operation resource to be cancelled. + public virtual CancelRequest Cancel(Google.Apis.OSConfig.v2beta.Data.CancelOperationRequest body, string name) + { + return new CancelRequest(this.service, body, name); + } + + /// + /// Starts asynchronous cancellation on a long-running operation. The server makes a best effort to + /// cancel the operation, but success is not guaranteed. If the server doesn't support this method, it + /// returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to + /// check whether the cancellation succeeded or whether the operation completed despite cancellation. On + /// successful cancellation, the operation is not deleted; instead, it becomes an operation with an + /// Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`. + /// + public class CancelRequest : OSConfigBaseServiceRequest + { + /// Constructs a new Cancel request. + public CancelRequest(Google.Apis.Services.IClientService service, Google.Apis.OSConfig.v2beta.Data.CancelOperationRequest body, string name) : base(service) + { + Name = name; + Body = body; + InitParameters(); + } + + /// The name of the operation resource to be cancelled. + [Google.Apis.Util.RequestParameterAttribute("name", Google.Apis.Util.RequestParameterType.Path)] + public virtual string Name { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.OSConfig.v2beta.Data.CancelOperationRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "cancel"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v2beta/{+name}:cancel"; + + /// Initializes Cancel parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("name", new Google.Apis.Discovery.Parameter + { + Name = "name", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^folders/[^/]+/locations/[^/]+/operations/[^/]+$", + }); + } + } + + /// + /// Deletes a long-running operation. This method indicates that the client is no longer interested in + /// the operation result. It does not cancel the operation. If the server doesn't support this method, + /// it returns `google.rpc.Code.UNIMPLEMENTED`. + /// + /// The name of the operation resource to be deleted. + public virtual DeleteRequest Delete(string name) + { + return new DeleteRequest(this.service, name); + } + + /// + /// Deletes a long-running operation. This method indicates that the client is no longer interested in + /// the operation result. It does not cancel the operation. If the server doesn't support this method, + /// it returns `google.rpc.Code.UNIMPLEMENTED`. + /// + public class DeleteRequest : OSConfigBaseServiceRequest + { + /// Constructs a new Delete request. + public DeleteRequest(Google.Apis.Services.IClientService service, string name) : base(service) + { + Name = name; + InitParameters(); + } + + /// The name of the operation resource to be deleted. + [Google.Apis.Util.RequestParameterAttribute("name", Google.Apis.Util.RequestParameterType.Path)] + public virtual string Name { get; private set; } + + /// Gets the method name. + public override string MethodName => "delete"; + + /// Gets the HTTP method. + public override string HttpMethod => "DELETE"; + + /// Gets the REST path. + public override string RestPath => "v2beta/{+name}"; + + /// Initializes Delete parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("name", new Google.Apis.Discovery.Parameter + { + Name = "name", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^folders/[^/]+/locations/[^/]+/operations/[^/]+$", + }); + } + } + + /// + /// Gets the latest state of a long-running operation. Clients can use this method to poll the operation + /// result at intervals as recommended by the API service. + /// + /// The name of the operation resource. + public virtual GetRequest Get(string name) + { + return new GetRequest(this.service, name); + } + + /// + /// Gets the latest state of a long-running operation. Clients can use this method to poll the operation + /// result at intervals as recommended by the API service. + /// + public class GetRequest : OSConfigBaseServiceRequest + { + /// Constructs a new Get request. + public GetRequest(Google.Apis.Services.IClientService service, string name) : base(service) + { + Name = name; + InitParameters(); + } + + /// The name of the operation resource. + [Google.Apis.Util.RequestParameterAttribute("name", Google.Apis.Util.RequestParameterType.Path)] + public virtual string Name { get; private set; } + + /// Gets the method name. + public override string MethodName => "get"; + + /// Gets the HTTP method. + public override string HttpMethod => "GET"; + + /// Gets the REST path. + public override string RestPath => "v2beta/{+name}"; + + /// Initializes Get parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("name", new Google.Apis.Discovery.Parameter + { + Name = "name", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^folders/[^/]+/locations/[^/]+/operations/[^/]+$", + }); + } + } + + /// + /// Lists operations that match the specified filter in the request. If the server doesn't support this + /// method, it returns `UNIMPLEMENTED`. + /// + /// The name of the operation's parent resource. + public virtual ListRequest List(string name) + { + return new ListRequest(this.service, name); + } + + /// + /// Lists operations that match the specified filter in the request. If the server doesn't support this + /// method, it returns `UNIMPLEMENTED`. + /// + public class ListRequest : OSConfigBaseServiceRequest + { + /// Constructs a new List request. + public ListRequest(Google.Apis.Services.IClientService service, string name) : base(service) + { + Name = name; + InitParameters(); + } + + /// The name of the operation's parent resource. + [Google.Apis.Util.RequestParameterAttribute("name", Google.Apis.Util.RequestParameterType.Path)] + public virtual string Name { get; private set; } + + /// The standard list filter. + [Google.Apis.Util.RequestParameterAttribute("filter", Google.Apis.Util.RequestParameterType.Query)] + public virtual string Filter { get; set; } + + /// The standard list page size. + [Google.Apis.Util.RequestParameterAttribute("pageSize", Google.Apis.Util.RequestParameterType.Query)] + public virtual System.Nullable PageSize { get; set; } + + /// The standard list page token. + [Google.Apis.Util.RequestParameterAttribute("pageToken", Google.Apis.Util.RequestParameterType.Query)] + public virtual string PageToken { get; set; } + + /// Gets the method name. + public override string MethodName => "list"; + + /// Gets the HTTP method. + public override string HttpMethod => "GET"; + + /// Gets the REST path. + public override string RestPath => "v2beta/{+name}/operations"; + + /// Initializes List parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("name", new Google.Apis.Discovery.Parameter + { + Name = "name", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^folders/[^/]+/locations/[^/]+$", + }); + RequestParameters.Add("filter", new Google.Apis.Discovery.Parameter + { + Name = "filter", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + RequestParameters.Add("pageSize", new Google.Apis.Discovery.Parameter + { + Name = "pageSize", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + RequestParameters.Add("pageToken", new Google.Apis.Discovery.Parameter + { + Name = "pageToken", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + } + } + } + } + } + + /// The "organizations" collection of methods. + public class OrganizationsResource + { + private const string Resource = "organizations"; + + /// The service which this resource belongs to. + private readonly Google.Apis.Services.IClientService service; + + /// Constructs a new resource. + public OrganizationsResource(Google.Apis.Services.IClientService service) + { + this.service = service; + Locations = new LocationsResource(service); + } + + /// Gets the Locations resource. + public virtual LocationsResource Locations { get; } + + /// The "locations" collection of methods. + public class LocationsResource + { + private const string Resource = "locations"; + + /// The service which this resource belongs to. + private readonly Google.Apis.Services.IClientService service; + + /// Constructs a new resource. + public LocationsResource(Google.Apis.Services.IClientService service) + { + this.service = service; + Operations = new OperationsResource(service); + } + + /// Gets the Operations resource. + public virtual OperationsResource Operations { get; } + + /// The "operations" collection of methods. + public class OperationsResource + { + private const string Resource = "operations"; + + /// The service which this resource belongs to. + private readonly Google.Apis.Services.IClientService service; + + /// Constructs a new resource. + public OperationsResource(Google.Apis.Services.IClientService service) + { + this.service = service; + } + + /// + /// Starts asynchronous cancellation on a long-running operation. The server makes a best effort to + /// cancel the operation, but success is not guaranteed. If the server doesn't support this method, it + /// returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to + /// check whether the cancellation succeeded or whether the operation completed despite cancellation. On + /// successful cancellation, the operation is not deleted; instead, it becomes an operation with an + /// Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`. + /// + /// The body of the request. + /// The name of the operation resource to be cancelled. + public virtual CancelRequest Cancel(Google.Apis.OSConfig.v2beta.Data.CancelOperationRequest body, string name) + { + return new CancelRequest(this.service, body, name); + } + + /// + /// Starts asynchronous cancellation on a long-running operation. The server makes a best effort to + /// cancel the operation, but success is not guaranteed. If the server doesn't support this method, it + /// returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to + /// check whether the cancellation succeeded or whether the operation completed despite cancellation. On + /// successful cancellation, the operation is not deleted; instead, it becomes an operation with an + /// Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`. + /// + public class CancelRequest : OSConfigBaseServiceRequest + { + /// Constructs a new Cancel request. + public CancelRequest(Google.Apis.Services.IClientService service, Google.Apis.OSConfig.v2beta.Data.CancelOperationRequest body, string name) : base(service) + { + Name = name; + Body = body; + InitParameters(); + } + + /// The name of the operation resource to be cancelled. + [Google.Apis.Util.RequestParameterAttribute("name", Google.Apis.Util.RequestParameterType.Path)] + public virtual string Name { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.OSConfig.v2beta.Data.CancelOperationRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "cancel"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v2beta/{+name}:cancel"; + + /// Initializes Cancel parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("name", new Google.Apis.Discovery.Parameter + { + Name = "name", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^organizations/[^/]+/locations/[^/]+/operations/[^/]+$", + }); + } + } + + /// + /// Deletes a long-running operation. This method indicates that the client is no longer interested in + /// the operation result. It does not cancel the operation. If the server doesn't support this method, + /// it returns `google.rpc.Code.UNIMPLEMENTED`. + /// + /// The name of the operation resource to be deleted. + public virtual DeleteRequest Delete(string name) + { + return new DeleteRequest(this.service, name); + } + + /// + /// Deletes a long-running operation. This method indicates that the client is no longer interested in + /// the operation result. It does not cancel the operation. If the server doesn't support this method, + /// it returns `google.rpc.Code.UNIMPLEMENTED`. + /// + public class DeleteRequest : OSConfigBaseServiceRequest + { + /// Constructs a new Delete request. + public DeleteRequest(Google.Apis.Services.IClientService service, string name) : base(service) + { + Name = name; + InitParameters(); + } + + /// The name of the operation resource to be deleted. + [Google.Apis.Util.RequestParameterAttribute("name", Google.Apis.Util.RequestParameterType.Path)] + public virtual string Name { get; private set; } + + /// Gets the method name. + public override string MethodName => "delete"; + + /// Gets the HTTP method. + public override string HttpMethod => "DELETE"; + + /// Gets the REST path. + public override string RestPath => "v2beta/{+name}"; + + /// Initializes Delete parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("name", new Google.Apis.Discovery.Parameter + { + Name = "name", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^organizations/[^/]+/locations/[^/]+/operations/[^/]+$", + }); + } + } + + /// + /// Gets the latest state of a long-running operation. Clients can use this method to poll the operation + /// result at intervals as recommended by the API service. + /// + /// The name of the operation resource. + public virtual GetRequest Get(string name) + { + return new GetRequest(this.service, name); + } + + /// + /// Gets the latest state of a long-running operation. Clients can use this method to poll the operation + /// result at intervals as recommended by the API service. + /// + public class GetRequest : OSConfigBaseServiceRequest + { + /// Constructs a new Get request. + public GetRequest(Google.Apis.Services.IClientService service, string name) : base(service) + { + Name = name; + InitParameters(); + } + + /// The name of the operation resource. + [Google.Apis.Util.RequestParameterAttribute("name", Google.Apis.Util.RequestParameterType.Path)] + public virtual string Name { get; private set; } + + /// Gets the method name. + public override string MethodName => "get"; + + /// Gets the HTTP method. + public override string HttpMethod => "GET"; + + /// Gets the REST path. + public override string RestPath => "v2beta/{+name}"; + + /// Initializes Get parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("name", new Google.Apis.Discovery.Parameter + { + Name = "name", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^organizations/[^/]+/locations/[^/]+/operations/[^/]+$", + }); + } + } + + /// + /// Lists operations that match the specified filter in the request. If the server doesn't support this + /// method, it returns `UNIMPLEMENTED`. + /// + /// The name of the operation's parent resource. + public virtual ListRequest List(string name) + { + return new ListRequest(this.service, name); + } + + /// + /// Lists operations that match the specified filter in the request. If the server doesn't support this + /// method, it returns `UNIMPLEMENTED`. + /// + public class ListRequest : OSConfigBaseServiceRequest + { + /// Constructs a new List request. + public ListRequest(Google.Apis.Services.IClientService service, string name) : base(service) + { + Name = name; + InitParameters(); + } + + /// The name of the operation's parent resource. + [Google.Apis.Util.RequestParameterAttribute("name", Google.Apis.Util.RequestParameterType.Path)] + public virtual string Name { get; private set; } + + /// The standard list filter. + [Google.Apis.Util.RequestParameterAttribute("filter", Google.Apis.Util.RequestParameterType.Query)] + public virtual string Filter { get; set; } + + /// The standard list page size. + [Google.Apis.Util.RequestParameterAttribute("pageSize", Google.Apis.Util.RequestParameterType.Query)] + public virtual System.Nullable PageSize { get; set; } + + /// The standard list page token. + [Google.Apis.Util.RequestParameterAttribute("pageToken", Google.Apis.Util.RequestParameterType.Query)] + public virtual string PageToken { get; set; } + + /// Gets the method name. + public override string MethodName => "list"; + + /// Gets the HTTP method. + public override string HttpMethod => "GET"; + + /// Gets the REST path. + public override string RestPath => "v2beta/{+name}/operations"; + + /// Initializes List parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("name", new Google.Apis.Discovery.Parameter + { + Name = "name", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^organizations/[^/]+/locations/[^/]+$", + }); + RequestParameters.Add("filter", new Google.Apis.Discovery.Parameter + { + Name = "filter", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + RequestParameters.Add("pageSize", new Google.Apis.Discovery.Parameter + { + Name = "pageSize", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + RequestParameters.Add("pageToken", new Google.Apis.Discovery.Parameter + { + Name = "pageToken", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + } + } + } + } + } + + /// The "projects" collection of methods. + public class ProjectsResource + { + private const string Resource = "projects"; + + /// The service which this resource belongs to. + private readonly Google.Apis.Services.IClientService service; + + /// Constructs a new resource. + public ProjectsResource(Google.Apis.Services.IClientService service) + { + this.service = service; + Locations = new LocationsResource(service); + } + + /// Gets the Locations resource. + public virtual LocationsResource Locations { get; } + + /// The "locations" collection of methods. + public class LocationsResource + { + private const string Resource = "locations"; + + /// The service which this resource belongs to. + private readonly Google.Apis.Services.IClientService service; + + /// Constructs a new resource. + public LocationsResource(Google.Apis.Services.IClientService service) + { + this.service = service; + Operations = new OperationsResource(service); + } + + /// Gets the Operations resource. + public virtual OperationsResource Operations { get; } + + /// The "operations" collection of methods. + public class OperationsResource + { + private const string Resource = "operations"; + + /// The service which this resource belongs to. + private readonly Google.Apis.Services.IClientService service; + + /// Constructs a new resource. + public OperationsResource(Google.Apis.Services.IClientService service) + { + this.service = service; + } + + /// + /// Starts asynchronous cancellation on a long-running operation. The server makes a best effort to + /// cancel the operation, but success is not guaranteed. If the server doesn't support this method, it + /// returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to + /// check whether the cancellation succeeded or whether the operation completed despite cancellation. On + /// successful cancellation, the operation is not deleted; instead, it becomes an operation with an + /// Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`. + /// + /// The body of the request. + /// The name of the operation resource to be cancelled. + public virtual CancelRequest Cancel(Google.Apis.OSConfig.v2beta.Data.CancelOperationRequest body, string name) + { + return new CancelRequest(this.service, body, name); + } + + /// + /// Starts asynchronous cancellation on a long-running operation. The server makes a best effort to + /// cancel the operation, but success is not guaranteed. If the server doesn't support this method, it + /// returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to + /// check whether the cancellation succeeded or whether the operation completed despite cancellation. On + /// successful cancellation, the operation is not deleted; instead, it becomes an operation with an + /// Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`. + /// + public class CancelRequest : OSConfigBaseServiceRequest + { + /// Constructs a new Cancel request. + public CancelRequest(Google.Apis.Services.IClientService service, Google.Apis.OSConfig.v2beta.Data.CancelOperationRequest body, string name) : base(service) + { + Name = name; + Body = body; + InitParameters(); + } + + /// The name of the operation resource to be cancelled. + [Google.Apis.Util.RequestParameterAttribute("name", Google.Apis.Util.RequestParameterType.Path)] + public virtual string Name { get; private set; } + + /// Gets or sets the body of this request. + Google.Apis.OSConfig.v2beta.Data.CancelOperationRequest Body { get; set; } + + /// Returns the body of the request. + protected override object GetBody() => Body; + + /// Gets the method name. + public override string MethodName => "cancel"; + + /// Gets the HTTP method. + public override string HttpMethod => "POST"; + + /// Gets the REST path. + public override string RestPath => "v2beta/{+name}:cancel"; + + /// Initializes Cancel parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("name", new Google.Apis.Discovery.Parameter + { + Name = "name", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + }); + } + } + + /// + /// Deletes a long-running operation. This method indicates that the client is no longer interested in + /// the operation result. It does not cancel the operation. If the server doesn't support this method, + /// it returns `google.rpc.Code.UNIMPLEMENTED`. + /// + /// The name of the operation resource to be deleted. + public virtual DeleteRequest Delete(string name) + { + return new DeleteRequest(this.service, name); + } + + /// + /// Deletes a long-running operation. This method indicates that the client is no longer interested in + /// the operation result. It does not cancel the operation. If the server doesn't support this method, + /// it returns `google.rpc.Code.UNIMPLEMENTED`. + /// + public class DeleteRequest : OSConfigBaseServiceRequest + { + /// Constructs a new Delete request. + public DeleteRequest(Google.Apis.Services.IClientService service, string name) : base(service) + { + Name = name; + InitParameters(); + } + + /// The name of the operation resource to be deleted. + [Google.Apis.Util.RequestParameterAttribute("name", Google.Apis.Util.RequestParameterType.Path)] + public virtual string Name { get; private set; } + + /// Gets the method name. + public override string MethodName => "delete"; + + /// Gets the HTTP method. + public override string HttpMethod => "DELETE"; + + /// Gets the REST path. + public override string RestPath => "v2beta/{+name}"; + + /// Initializes Delete parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("name", new Google.Apis.Discovery.Parameter + { + Name = "name", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + }); + } + } + + /// + /// Gets the latest state of a long-running operation. Clients can use this method to poll the operation + /// result at intervals as recommended by the API service. + /// + /// The name of the operation resource. + public virtual GetRequest Get(string name) + { + return new GetRequest(this.service, name); + } + + /// + /// Gets the latest state of a long-running operation. Clients can use this method to poll the operation + /// result at intervals as recommended by the API service. + /// + public class GetRequest : OSConfigBaseServiceRequest + { + /// Constructs a new Get request. + public GetRequest(Google.Apis.Services.IClientService service, string name) : base(service) + { + Name = name; + InitParameters(); + } + + /// The name of the operation resource. + [Google.Apis.Util.RequestParameterAttribute("name", Google.Apis.Util.RequestParameterType.Path)] + public virtual string Name { get; private set; } + + /// Gets the method name. + public override string MethodName => "get"; + + /// Gets the HTTP method. + public override string HttpMethod => "GET"; + + /// Gets the REST path. + public override string RestPath => "v2beta/{+name}"; + + /// Initializes Get parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("name", new Google.Apis.Discovery.Parameter + { + Name = "name", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + }); + } + } + + /// + /// Lists operations that match the specified filter in the request. If the server doesn't support this + /// method, it returns `UNIMPLEMENTED`. + /// + /// The name of the operation's parent resource. + public virtual ListRequest List(string name) + { + return new ListRequest(this.service, name); + } + + /// + /// Lists operations that match the specified filter in the request. If the server doesn't support this + /// method, it returns `UNIMPLEMENTED`. + /// + public class ListRequest : OSConfigBaseServiceRequest + { + /// Constructs a new List request. + public ListRequest(Google.Apis.Services.IClientService service, string name) : base(service) + { + Name = name; + InitParameters(); + } + + /// The name of the operation's parent resource. + [Google.Apis.Util.RequestParameterAttribute("name", Google.Apis.Util.RequestParameterType.Path)] + public virtual string Name { get; private set; } + + /// The standard list filter. + [Google.Apis.Util.RequestParameterAttribute("filter", Google.Apis.Util.RequestParameterType.Query)] + public virtual string Filter { get; set; } + + /// The standard list page size. + [Google.Apis.Util.RequestParameterAttribute("pageSize", Google.Apis.Util.RequestParameterType.Query)] + public virtual System.Nullable PageSize { get; set; } + + /// The standard list page token. + [Google.Apis.Util.RequestParameterAttribute("pageToken", Google.Apis.Util.RequestParameterType.Query)] + public virtual string PageToken { get; set; } + + /// Gets the method name. + public override string MethodName => "list"; + + /// Gets the HTTP method. + public override string HttpMethod => "GET"; + + /// Gets the REST path. + public override string RestPath => "v2beta/{+name}/operations"; + + /// Initializes List parameter list. + protected override void InitParameters() + { + base.InitParameters(); + RequestParameters.Add("name", new Google.Apis.Discovery.Parameter + { + Name = "name", + IsRequired = true, + ParameterType = "path", + DefaultValue = null, + Pattern = @"^projects/[^/]+/locations/[^/]+$", + }); + RequestParameters.Add("filter", new Google.Apis.Discovery.Parameter + { + Name = "filter", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + RequestParameters.Add("pageSize", new Google.Apis.Discovery.Parameter + { + Name = "pageSize", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + RequestParameters.Add("pageToken", new Google.Apis.Discovery.Parameter + { + Name = "pageToken", + IsRequired = false, + ParameterType = "query", + DefaultValue = null, + Pattern = null, + }); + } + } + } + } + } +} +namespace Google.Apis.OSConfig.v2beta.Data +{ + /// The request message for Operations.CancelOperation. + public class CancelOperationRequest : Google.Apis.Requests.IDirectResponseSchema + { + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical + /// example is to use it as the request or the response type of an API method. For instance: service Foo { rpc + /// Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } + /// + public class Empty : Google.Apis.Requests.IDirectResponseSchema + { + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// OS policy assignment operation metadata provided by OS policy assignment API methods that return long running + /// operations. + /// + public class GoogleCloudOsconfigV1OSPolicyAssignmentOperationMetadata : Google.Apis.Requests.IDirectResponseSchema + { + /// The OS policy assignment API method. + [Newtonsoft.Json.JsonPropertyAttribute("apiMethod")] + public virtual string ApiMethod { get; set; } + + /// + /// Reference to the `OSPolicyAssignment` API resource. Format: + /// `projects/{project_number}/locations/{location}/osPolicyAssignments/{os_policy_assignment_id@revision_id}` + /// + [Newtonsoft.Json.JsonPropertyAttribute("osPolicyAssignment")] + public virtual string OsPolicyAssignment { get; set; } + + private string _rolloutStartTimeRaw; + + private object _rolloutStartTime; + + /// Rollout start time + [Newtonsoft.Json.JsonPropertyAttribute("rolloutStartTime")] + public virtual string RolloutStartTimeRaw + { + get => _rolloutStartTimeRaw; + set + { + _rolloutStartTime = Google.Apis.Util.Utilities.DeserializeForGoogleFormat(value); + _rolloutStartTimeRaw = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + [System.ObsoleteAttribute("This property is obsolete and may behave unexpectedly; please use RolloutStartTimeDateTimeOffset instead.")] + public virtual object RolloutStartTime + { + get => _rolloutStartTime; + set + { + _rolloutStartTimeRaw = Google.Apis.Util.Utilities.SerializeForGoogleFormat(value); + _rolloutStartTime = value; + } + } + + /// + /// representation of . + /// + [Newtonsoft.Json.JsonIgnoreAttribute] + public virtual System.DateTimeOffset? RolloutStartTimeDateTimeOffset + { + get => Google.Apis.Util.DiscoveryFormat.ParseGoogleDateTimeToDateTimeOffset(RolloutStartTimeRaw); + set => RolloutStartTimeRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); + } + + /// State of the rollout + [Newtonsoft.Json.JsonPropertyAttribute("rolloutState")] + public virtual string RolloutState { get; set; } + + private string _rolloutUpdateTimeRaw; + + private object _rolloutUpdateTime; + + /// Rollout update time + [Newtonsoft.Json.JsonPropertyAttribute("rolloutUpdateTime")] + public virtual string RolloutUpdateTimeRaw + { + get => _rolloutUpdateTimeRaw; + set + { + _rolloutUpdateTime = Google.Apis.Util.Utilities.DeserializeForGoogleFormat(value); + _rolloutUpdateTimeRaw = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + [System.ObsoleteAttribute("This property is obsolete and may behave unexpectedly; please use RolloutUpdateTimeDateTimeOffset instead.")] + public virtual object RolloutUpdateTime + { + get => _rolloutUpdateTime; + set + { + _rolloutUpdateTimeRaw = Google.Apis.Util.Utilities.SerializeForGoogleFormat(value); + _rolloutUpdateTime = value; + } + } + + /// + /// representation of . + /// + [Newtonsoft.Json.JsonIgnoreAttribute] + public virtual System.DateTimeOffset? RolloutUpdateTimeDateTimeOffset + { + get => Google.Apis.Util.DiscoveryFormat.ParseGoogleDateTimeToDateTimeOffset(RolloutUpdateTimeRaw); + set => RolloutUpdateTimeRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); + } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// Represents the metadata of the long-running operation. + public class GoogleCloudOsconfigV2betaOperationMetadata : Google.Apis.Requests.IDirectResponseSchema + { + /// Output only. API version used to start the operation. + [Newtonsoft.Json.JsonPropertyAttribute("apiVersion")] + public virtual string ApiVersion { get; set; } + + private string _createTimeRaw; + + private object _createTime; + + /// Output only. The time the operation was created. + [Newtonsoft.Json.JsonPropertyAttribute("createTime")] + public virtual string CreateTimeRaw + { + get => _createTimeRaw; + set + { + _createTime = Google.Apis.Util.Utilities.DeserializeForGoogleFormat(value); + _createTimeRaw = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + [System.ObsoleteAttribute("This property is obsolete and may behave unexpectedly; please use CreateTimeDateTimeOffset instead.")] + public virtual object CreateTime + { + get => _createTime; + set + { + _createTimeRaw = Google.Apis.Util.Utilities.SerializeForGoogleFormat(value); + _createTime = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + public virtual System.DateTimeOffset? CreateTimeDateTimeOffset + { + get => Google.Apis.Util.DiscoveryFormat.ParseGoogleDateTimeToDateTimeOffset(CreateTimeRaw); + set => CreateTimeRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); + } + + private string _endTimeRaw; + + private object _endTime; + + /// Output only. The time the operation finished running. + [Newtonsoft.Json.JsonPropertyAttribute("endTime")] + public virtual string EndTimeRaw + { + get => _endTimeRaw; + set + { + _endTime = Google.Apis.Util.Utilities.DeserializeForGoogleFormat(value); + _endTimeRaw = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + [System.ObsoleteAttribute("This property is obsolete and may behave unexpectedly; please use EndTimeDateTimeOffset instead.")] + public virtual object EndTime + { + get => _endTime; + set + { + _endTimeRaw = Google.Apis.Util.Utilities.SerializeForGoogleFormat(value); + _endTime = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + public virtual System.DateTimeOffset? EndTimeDateTimeOffset + { + get => Google.Apis.Util.DiscoveryFormat.ParseGoogleDateTimeToDateTimeOffset(EndTimeRaw); + set => EndTimeRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); + } + + /// + /// Output only. Identifies whether the user has requested cancellation of the operation. Operations that have + /// been cancelled successfully have Operation.error value with a google.rpc.Status.code of 1, corresponding to + /// `Code.CANCELLED`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("requestedCancellation")] + public virtual System.Nullable RequestedCancellation { get; set; } + + /// Output only. Human-readable status of the operation, if any. + [Newtonsoft.Json.JsonPropertyAttribute("statusMessage")] + public virtual string StatusMessage { get; set; } + + /// Output only. Server-defined resource path for the target of the operation. + [Newtonsoft.Json.JsonPropertyAttribute("target")] + public virtual string Target { get; set; } + + /// Output only. Name of the verb executed by the operation. + [Newtonsoft.Json.JsonPropertyAttribute("verb")] + public virtual string Verb { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// The response message for Operations.ListOperations. + public class ListOperationsResponse : Google.Apis.Requests.IDirectResponseSchema + { + /// The standard List next-page token. + [Newtonsoft.Json.JsonPropertyAttribute("nextPageToken")] + public virtual string NextPageToken { get; set; } + + /// A list of operations that matches the specified filter in the request. + [Newtonsoft.Json.JsonPropertyAttribute("operations")] + public virtual System.Collections.Generic.IList Operations { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// OS policy assignment operation metadata provided by OS policy assignment API methods that return long running + /// operations. + /// + public class OSPolicyAssignmentOperationMetadata : Google.Apis.Requests.IDirectResponseSchema + { + /// The OS policy assignment API method. + [Newtonsoft.Json.JsonPropertyAttribute("apiMethod")] + public virtual string ApiMethod { get; set; } + + /// + /// Reference to the `OSPolicyAssignment` API resource. Format: + /// `projects/{project_number}/locations/{location}/osPolicyAssignments/{os_policy_assignment_id@revision_id}` + /// + [Newtonsoft.Json.JsonPropertyAttribute("osPolicyAssignment")] + public virtual string OsPolicyAssignment { get; set; } + + private string _rolloutStartTimeRaw; + + private object _rolloutStartTime; + + /// Rollout start time + [Newtonsoft.Json.JsonPropertyAttribute("rolloutStartTime")] + public virtual string RolloutStartTimeRaw + { + get => _rolloutStartTimeRaw; + set + { + _rolloutStartTime = Google.Apis.Util.Utilities.DeserializeForGoogleFormat(value); + _rolloutStartTimeRaw = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + [System.ObsoleteAttribute("This property is obsolete and may behave unexpectedly; please use RolloutStartTimeDateTimeOffset instead.")] + public virtual object RolloutStartTime + { + get => _rolloutStartTime; + set + { + _rolloutStartTimeRaw = Google.Apis.Util.Utilities.SerializeForGoogleFormat(value); + _rolloutStartTime = value; + } + } + + /// + /// representation of . + /// + [Newtonsoft.Json.JsonIgnoreAttribute] + public virtual System.DateTimeOffset? RolloutStartTimeDateTimeOffset + { + get => Google.Apis.Util.DiscoveryFormat.ParseGoogleDateTimeToDateTimeOffset(RolloutStartTimeRaw); + set => RolloutStartTimeRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); + } + + /// State of the rollout + [Newtonsoft.Json.JsonPropertyAttribute("rolloutState")] + public virtual string RolloutState { get; set; } + + private string _rolloutUpdateTimeRaw; + + private object _rolloutUpdateTime; + + /// Rollout update time + [Newtonsoft.Json.JsonPropertyAttribute("rolloutUpdateTime")] + public virtual string RolloutUpdateTimeRaw + { + get => _rolloutUpdateTimeRaw; + set + { + _rolloutUpdateTime = Google.Apis.Util.Utilities.DeserializeForGoogleFormat(value); + _rolloutUpdateTimeRaw = value; + } + } + + /// representation of . + [Newtonsoft.Json.JsonIgnoreAttribute] + [System.ObsoleteAttribute("This property is obsolete and may behave unexpectedly; please use RolloutUpdateTimeDateTimeOffset instead.")] + public virtual object RolloutUpdateTime + { + get => _rolloutUpdateTime; + set + { + _rolloutUpdateTimeRaw = Google.Apis.Util.Utilities.SerializeForGoogleFormat(value); + _rolloutUpdateTime = value; + } + } + + /// + /// representation of . + /// + [Newtonsoft.Json.JsonIgnoreAttribute] + public virtual System.DateTimeOffset? RolloutUpdateTimeDateTimeOffset + { + get => Google.Apis.Util.DiscoveryFormat.ParseGoogleDateTimeToDateTimeOffset(RolloutUpdateTimeRaw); + set => RolloutUpdateTimeRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); + } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// This resource represents a long-running operation that is the result of a network API call. + public class Operation : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, + /// and either `error` or `response` is available. + /// + [Newtonsoft.Json.JsonPropertyAttribute("done")] + public virtual System.Nullable Done { get; set; } + + /// The error result of the operation in case of failure or cancellation. + [Newtonsoft.Json.JsonPropertyAttribute("error")] + public virtual Status Error { get; set; } + + /// + /// Service-specific metadata associated with the operation. It typically contains progress information and + /// common metadata such as create time. Some services might not provide such metadata. Any method that returns + /// a long-running operation should document the metadata type, if any. + /// + [Newtonsoft.Json.JsonPropertyAttribute("metadata")] + public virtual System.Collections.Generic.IDictionary Metadata { get; set; } + + /// + /// The server-assigned name, which is only unique within the same service that originally returns it. If you + /// use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("name")] + public virtual string Name { get; set; } + + /// + /// The normal, successful response of the operation. If the original method returns no data on success, such as + /// `Delete`, the response is `google.protobuf.Empty`. If the original method is standard + /// `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have + /// the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is + /// `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`. + /// + [Newtonsoft.Json.JsonPropertyAttribute("response")] + public virtual System.Collections.Generic.IDictionary Response { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + + /// + /// The `Status` type defines a logical error model that is suitable for different programming environments, + /// including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains + /// three pieces of data: error code, error message, and error details. You can find out more about this error model + /// and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). + /// + public class Status : Google.Apis.Requests.IDirectResponseSchema + { + /// The status code, which should be an enum value of google.rpc.Code. + [Newtonsoft.Json.JsonPropertyAttribute("code")] + public virtual System.Nullable Code { get; set; } + + /// + /// A list of messages that carry the error details. There is a common set of message types for APIs to use. + /// + [Newtonsoft.Json.JsonPropertyAttribute("details")] + public virtual System.Collections.Generic.IList> Details { get; set; } + + /// + /// A developer-facing error message, which should be in English. Any user-facing error message should be + /// localized and sent in the google.rpc.Status.details field, or localized by the client. + /// + [Newtonsoft.Json.JsonPropertyAttribute("message")] + public virtual string Message { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } +} diff --git a/Src/Generated/Google.Apis.OSConfig.v2beta/Google.Apis.OSConfig.v2beta.csproj b/Src/Generated/Google.Apis.OSConfig.v2beta/Google.Apis.OSConfig.v2beta.csproj new file mode 100644 index 00000000000..b824579d6dc --- /dev/null +++ b/Src/Generated/Google.Apis.OSConfig.v2beta/Google.Apis.OSConfig.v2beta.csproj @@ -0,0 +1,66 @@ + + + + + Google.Apis.OSConfig.v2beta Client Library + 1.68.0.3581 + Google LLC + Copyright 2024 Google LLC + Google + https://github.com/google/google-api-dotnet-client + Apache-2.0 + git + https://github.com/google/google-api-dotnet-client + https://www.gstatic.com/images/branding/product/1x/google_developers_64dp.png + NuGetIcon.png + + Google APIs Client Library for working with Osconfig v2beta. + + Product documentation is available at: + https://cloud.google.com/compute/docs/osconfig/rest + + API reference documentation for this package is available at: + https://googleapis.dev/dotnet/Google.Apis.OSConfig.v2beta/latest/api/Google.Apis.OSConfig.v2beta.html + + The source code for this package is available at: + https://github.com/google/google-api-dotnet-client/tree/master/Src/Generated/Google.Apis.OSConfig.v2beta + + Supported Platforms: + - .NET Framework 4.6.2+ + - .NET Standard 2.0 + - .NET 6.0+ + + Incompatible platforms: + - .NET Framework < 4.6.2 + - Silverlight + - UWP (will build, but is known not to work at runtime) + - Xamarin/MAUI + - Windows 8 Apps + - Windows Phone 8.1 + - Windows Phone Silverlight 8.0 + + + + + + + + + + + netstandard2.0;net462;net6.0 + true + ..\..\..\google.apis.snk + portable + true + 1570,1587,1591 + + + + + + + + + + diff --git a/Src/Generated/Google.Apis.SecurityCommandCenter.v1/Google.Apis.SecurityCommandCenter.v1.csproj b/Src/Generated/Google.Apis.SecurityCommandCenter.v1/Google.Apis.SecurityCommandCenter.v1.csproj index a8e497b569e..2da7a55a64f 100644 --- a/Src/Generated/Google.Apis.SecurityCommandCenter.v1/Google.Apis.SecurityCommandCenter.v1.csproj +++ b/Src/Generated/Google.Apis.SecurityCommandCenter.v1/Google.Apis.SecurityCommandCenter.v1.csproj @@ -3,7 +3,7 @@ Google.Apis.SecurityCommandCenter.v1 Client Library - 1.68.0.3578 + 1.68.0.3586 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.SecurityCommandCenter.v1beta1/Google.Apis.SecurityCommandCenter.v1beta1.cs b/Src/Generated/Google.Apis.SecurityCommandCenter.v1beta1/Google.Apis.SecurityCommandCenter.v1beta1.cs index ef1f72c9901..dfb4c45cb28 100644 --- a/Src/Generated/Google.Apis.SecurityCommandCenter.v1beta1/Google.Apis.SecurityCommandCenter.v1beta1.cs +++ b/Src/Generated/Google.Apis.SecurityCommandCenter.v1beta1/Google.Apis.SecurityCommandCenter.v1beta1.cs @@ -11284,7 +11284,9 @@ public class SetFindingStateRequest : Google.Apis.Requests.IDirectResponseSchema private object _startTime; - /// Required. The time at which the updated state takes effect. + /// + /// Optional. The time at which the updated state takes effect. If not set uses the current time. + /// [Newtonsoft.Json.JsonPropertyAttribute("startTime")] public virtual string StartTimeRaw { diff --git a/Src/Generated/Google.Apis.SecurityCommandCenter.v1beta1/Google.Apis.SecurityCommandCenter.v1beta1.csproj b/Src/Generated/Google.Apis.SecurityCommandCenter.v1beta1/Google.Apis.SecurityCommandCenter.v1beta1.csproj index 75f466468d1..8765f49a73d 100644 --- a/Src/Generated/Google.Apis.SecurityCommandCenter.v1beta1/Google.Apis.SecurityCommandCenter.v1beta1.csproj +++ b/Src/Generated/Google.Apis.SecurityCommandCenter.v1beta1/Google.Apis.SecurityCommandCenter.v1beta1.csproj @@ -3,7 +3,7 @@ Google.Apis.SecurityCommandCenter.v1beta1 Client Library - 1.68.0.3578 + 1.68.0.3586 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.Spanner.v1/Google.Apis.Spanner.v1.cs b/Src/Generated/Google.Apis.Spanner.v1/Google.Apis.Spanner.v1.cs index 154755737c2..de96e1232b7 100644 --- a/Src/Generated/Google.Apis.Spanner.v1/Google.Apis.Spanner.v1.cs +++ b/Src/Generated/Google.Apis.Spanner.v1/Google.Apis.Spanner.v1.cs @@ -2067,13 +2067,13 @@ public enum EncryptionConfigEncryptionTypeEnum /// /// Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. /// Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by - /// kms_key_names must fully cover all regions of the backup's instance configuration. Some - /// examples: * For single region instance configs, specify a single regional location KMS key. * - /// For multi-regional instance configs of type GOOGLE_MANAGED, either specify a multi-regional - /// location KMS key or multiple regional location KMS keys that cover all regions in the instance - /// config. * For an instance config of type USER_MANAGED, please specify only regional location KMS - /// keys to cover each region in the instance config. Multi-regional location KMS keys are not - /// supported for USER_MANAGED instance configs. + /// `kms_key_names` must fully cover all regions of the backup's instance configuration. Some + /// examples: * For regional (single-region) instance configurations, specify a regional location + /// KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a + /// multi-region location KMS key or multiple regional location KMS keys that cover all regions in + /// the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only + /// regional location KMS keys to cover each region in the instance configuration. Multi-region + /// location KMS keys aren't supported for `USER_MANAGED` type instance configurations. /// [Google.Apis.Util.RequestParameterAttribute("encryptionConfig.kmsKeyNames", Google.Apis.Util.RequestParameterType.Query)] public virtual Google.Apis.Util.Repeatable EncryptionConfigKmsKeyNames { get; set; } @@ -2242,7 +2242,8 @@ protected override void InitParameters() /// Gets the access control policy for a database or backup resource. Returns an empty policy if a /// database or backup exists but does not have a policy set. Authorization requires /// `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires - /// `spanner.backups.getIamPolicy` permission on resource. + /// `spanner.backups.getIamPolicy` permission on resource. For backup schedules, authorization requires + /// `spanner.backupSchedules.getIamPolicy` permission on resource. /// /// The body of the request. /// @@ -2259,7 +2260,8 @@ public virtual GetIamPolicyRequest GetIamPolicy(Google.Apis.Spanner.v1.Data.GetI /// Gets the access control policy for a database or backup resource. Returns an empty policy if a /// database or backup exists but does not have a policy set. Authorization requires /// `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires - /// `spanner.backups.getIamPolicy` permission on resource. + /// `spanner.backups.getIamPolicy` permission on resource. For backup schedules, authorization requires + /// `spanner.backupSchedules.getIamPolicy` permission on resource. /// public class GetIamPolicyRequest : SpannerBaseServiceRequest { @@ -2512,7 +2514,8 @@ protected override void InitParameters() /// /// Sets the access control policy on a database or backup resource. Replaces any existing policy. /// Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, - /// authorization requires `spanner.backups.setIamPolicy` permission on resource. + /// authorization requires `spanner.backups.setIamPolicy` permission on resource. For backup schedules, + /// authorization requires `spanner.backupSchedules.setIamPolicy` permission on resource. /// /// The body of the request. /// @@ -2528,7 +2531,8 @@ public virtual SetIamPolicyRequest SetIamPolicy(Google.Apis.Spanner.v1.Data.SetI /// /// Sets the access control policy on a database or backup resource. Replaces any existing policy. /// Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, - /// authorization requires `spanner.backups.setIamPolicy` permission on resource. + /// authorization requires `spanner.backups.setIamPolicy` permission on resource. For backup schedules, + /// authorization requires `spanner.backupSchedules.setIamPolicy` permission on resource. /// public class SetIamPolicyRequest : SpannerBaseServiceRequest { @@ -2584,6 +2588,8 @@ protected override void InitParameters() /// `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an /// empty set of permissions. Calling this method on a backup that does not exist will result in a /// NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance. + /// Calling this method on a backup schedule that does not exist will result in a NOT_FOUND error if the + /// user has `spanner.backupSchedules.list` permission on the containing database. /// /// The body of the request. /// @@ -2602,6 +2608,8 @@ public virtual TestIamPermissionsRequest TestIamPermissions(Google.Apis.Spanner. /// `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an /// empty set of permissions. Calling this method on a backup that does not exist will result in a /// NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance. + /// Calling this method on a backup schedule that does not exist will result in a NOT_FOUND error if the + /// user has `spanner.backupSchedules.list` permission on the containing database. /// public class TestIamPermissionsRequest : SpannerBaseServiceRequest { @@ -2710,7 +2718,7 @@ public ListRequest(Google.Apis.Services.IClientService service, string parent) : /// field name, a comparison operator, and a value for filtering. The value must be a string, a /// number, or a boolean. The comparison operator must be one of: `&lt;`, `&gt;`, /// `&lt;=`, `&gt;=`, `!=`, `=`, or `:`. Colon `:` is the contains operator. Filter rules - /// are not case sensitive. The following fields in the Operation are eligible for filtering: * + /// are not case sensitive. The following fields in the operation are eligible for filtering: * /// `name` - The name of the long-running operation * `done` - False if the operation is in /// progress, else true. * `metadata.@type` - the type of metadata. For example, the type string for /// RestoreDatabaseMetadata is @@ -3010,7 +3018,8 @@ protected override void InitParameters() /// Gets the access control policy for a database or backup resource. Returns an empty policy if a /// database or backup exists but does not have a policy set. Authorization requires /// `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires - /// `spanner.backups.getIamPolicy` permission on resource. + /// `spanner.backups.getIamPolicy` permission on resource. For backup schedules, authorization + /// requires `spanner.backupSchedules.getIamPolicy` permission on resource. /// /// The body of the request. /// @@ -3027,7 +3036,8 @@ public virtual GetIamPolicyRequest GetIamPolicy(Google.Apis.Spanner.v1.Data.GetI /// Gets the access control policy for a database or backup resource. Returns an empty policy if a /// database or backup exists but does not have a policy set. Authorization requires /// `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires - /// `spanner.backups.getIamPolicy` permission on resource. + /// `spanner.backups.getIamPolicy` permission on resource. For backup schedules, authorization + /// requires `spanner.backupSchedules.getIamPolicy` permission on resource. /// public class GetIamPolicyRequest : SpannerBaseServiceRequest { @@ -3243,7 +3253,8 @@ protected override void InitParameters() /// /// Sets the access control policy on a database or backup resource. Replaces any existing policy. /// Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, - /// authorization requires `spanner.backups.setIamPolicy` permission on resource. + /// authorization requires `spanner.backups.setIamPolicy` permission on resource. For backup + /// schedules, authorization requires `spanner.backupSchedules.setIamPolicy` permission on resource. /// /// The body of the request. /// @@ -3259,7 +3270,8 @@ public virtual SetIamPolicyRequest SetIamPolicy(Google.Apis.Spanner.v1.Data.SetI /// /// Sets the access control policy on a database or backup resource. Replaces any existing policy. /// Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, - /// authorization requires `spanner.backups.setIamPolicy` permission on resource. + /// authorization requires `spanner.backups.setIamPolicy` permission on resource. For backup + /// schedules, authorization requires `spanner.backupSchedules.setIamPolicy` permission on resource. /// public class SetIamPolicyRequest : SpannerBaseServiceRequest { @@ -3315,7 +3327,9 @@ protected override void InitParameters() /// has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise /// returns an empty set of permissions. Calling this method on a backup that does not exist will /// result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing - /// instance. + /// instance. Calling this method on a backup schedule that does not exist will result in a + /// NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on the containing + /// database. /// /// The body of the request. /// @@ -3334,7 +3348,9 @@ public virtual TestIamPermissionsRequest TestIamPermissions(Google.Apis.Spanner. /// has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise /// returns an empty set of permissions. Calling this method on a backup that does not exist will /// result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing - /// instance. + /// instance. Calling this method on a backup schedule that does not exist will result in a + /// NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on the containing + /// database. /// public class TestIamPermissionsRequest : SpannerBaseServiceRequest { @@ -3489,7 +3505,9 @@ protected override void InitParameters() /// has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise /// returns an empty set of permissions. Calling this method on a backup that does not exist will /// result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing - /// instance. + /// instance. Calling this method on a backup schedule that does not exist will result in a + /// NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on the containing + /// database. /// /// The body of the request. /// @@ -3508,7 +3526,9 @@ public virtual TestIamPermissionsRequest TestIamPermissions(Google.Apis.Spanner. /// has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise /// returns an empty set of permissions. Calling this method on a backup that does not exist will /// result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing - /// instance. + /// instance. Calling this method on a backup schedule that does not exist will result in a + /// NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on the containing + /// database. /// public class TestIamPermissionsRequest : SpannerBaseServiceRequest { @@ -5228,7 +5248,8 @@ protected override void InitParameters() /// Gets the access control policy for a database or backup resource. Returns an empty policy if a /// database or backup exists but does not have a policy set. Authorization requires /// `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires - /// `spanner.backups.getIamPolicy` permission on resource. + /// `spanner.backups.getIamPolicy` permission on resource. For backup schedules, authorization requires + /// `spanner.backupSchedules.getIamPolicy` permission on resource. /// /// The body of the request. /// @@ -5245,7 +5266,8 @@ public virtual GetIamPolicyRequest GetIamPolicy(Google.Apis.Spanner.v1.Data.GetI /// Gets the access control policy for a database or backup resource. Returns an empty policy if a /// database or backup exists but does not have a policy set. Authorization requires /// `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires - /// `spanner.backups.getIamPolicy` permission on resource. + /// `spanner.backups.getIamPolicy` permission on resource. For backup schedules, authorization requires + /// `spanner.backupSchedules.getIamPolicy` permission on resource. /// public class GetIamPolicyRequest : SpannerBaseServiceRequest { @@ -5731,7 +5753,8 @@ protected override void InitParameters() /// /// Sets the access control policy on a database or backup resource. Replaces any existing policy. /// Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, - /// authorization requires `spanner.backups.setIamPolicy` permission on resource. + /// authorization requires `spanner.backups.setIamPolicy` permission on resource. For backup schedules, + /// authorization requires `spanner.backupSchedules.setIamPolicy` permission on resource. /// /// The body of the request. /// @@ -5747,7 +5770,8 @@ public virtual SetIamPolicyRequest SetIamPolicy(Google.Apis.Spanner.v1.Data.SetI /// /// Sets the access control policy on a database or backup resource. Replaces any existing policy. /// Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, - /// authorization requires `spanner.backups.setIamPolicy` permission on resource. + /// authorization requires `spanner.backups.setIamPolicy` permission on resource. For backup schedules, + /// authorization requires `spanner.backupSchedules.setIamPolicy` permission on resource. /// public class SetIamPolicyRequest : SpannerBaseServiceRequest { @@ -5803,6 +5827,8 @@ protected override void InitParameters() /// `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an /// empty set of permissions. Calling this method on a backup that does not exist will result in a /// NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance. + /// Calling this method on a backup schedule that does not exist will result in a NOT_FOUND error if the + /// user has `spanner.backupSchedules.list` permission on the containing database. /// /// The body of the request. /// @@ -5821,6 +5847,8 @@ public virtual TestIamPermissionsRequest TestIamPermissions(Google.Apis.Spanner. /// `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an /// empty set of permissions. Calling this method on a backup that does not exist will result in a /// NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance. + /// Calling this method on a backup schedule that does not exist will result in a NOT_FOUND error if the + /// user has `spanner.backupSchedules.list` permission on the containing database. /// public class TestIamPermissionsRequest : SpannerBaseServiceRequest { @@ -8217,7 +8245,7 @@ public virtual System.DateTimeOffset? CreateTimeDateTimeOffset /// /// Output only. The encryption information for the backup, whether it is protected by one or more KMS keys. The - /// information includes all Cloud KMS key versions used to encrypt the backup. The `encryption_status' field + /// information includes all Cloud KMS key versions used to encrypt the backup. The `encryption_status` field /// inside of each `EncryptionInfo` is not populated. At least one of the key versions must be available for the /// backup to be restored. If a key version is revoked in the middle of a restore, the restore behavior is /// undefined. @@ -8774,6 +8802,14 @@ public virtual System.DateTimeOffset? CommitTimestampDateTimeOffset /// The request for BeginTransaction. public class BeginTransactionRequest : Google.Apis.Requests.IDirectResponseSchema { + /// + /// Optional. Required for read-write transactions on a multiplexed session that commit mutations but do not + /// perform any reads or queries. Clients should randomly select one of the mutations from the mutation set and + /// send it as a part of this request. + /// + [Newtonsoft.Json.JsonPropertyAttribute("mutationKey")] + public virtual Mutation MutationKey { get; set; } + /// Required. Options for the new transaction. [Newtonsoft.Json.JsonPropertyAttribute("options")] public virtual TransactionOptions Options { get; set; } @@ -9019,6 +9055,14 @@ public class CommitRequest : Google.Apis.Requests.IDirectResponseSchema [Newtonsoft.Json.JsonPropertyAttribute("mutations")] public virtual System.Collections.Generic.IList Mutations { get; set; } + /// + /// Optional. If the read-write transaction was executed on a multiplexed session, the precommit token with the + /// highest sequence number received in this transaction attempt, should be included here. Failing to do so will + /// result in a FailedPrecondition error. + /// + [Newtonsoft.Json.JsonPropertyAttribute("precommitToken")] + public virtual MultiplexedSessionPrecommitToken PrecommitToken { get; set; } + /// Common options for this request. [Newtonsoft.Json.JsonPropertyAttribute("requestOptions")] public virtual RequestOptions RequestOptions { get; set; } @@ -9097,6 +9141,12 @@ public virtual System.DateTimeOffset? CommitTimestampDateTimeOffset set => CommitTimestampRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); } + /// + /// If specified, transaction has not committed yet. Clients must retry the commit with the new precommit token. + /// + [Newtonsoft.Json.JsonPropertyAttribute("precommitToken")] + public virtual MultiplexedSessionPrecommitToken PrecommitToken { get; set; } + /// The ETag of the item. public virtual string ETag { get; set; } } @@ -9161,13 +9211,14 @@ public class CopyBackupEncryptionConfig : Google.Apis.Requests.IDirectResponseSc /// /// Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of - /// the form `projects//locations//keyRings//cryptoKeys/`. Kms keys specified can be in any order. The keys - /// referenced by kms_key_names must fully cover all regions of the backup's instance configuration. Some - /// examples: * For single region instance configs, specify a single regional location KMS key. * For - /// multi-regional instance configs of type GOOGLE_MANAGED, either specify a multi-regional location KMS key or - /// multiple regional location KMS keys that cover all regions in the instance config. * For an instance config - /// of type USER_MANAGED, please specify only regional location KMS keys to cover each region in the instance - /// config. Multi-regional location KMS keys are not supported for USER_MANAGED instance configs. + /// the form `projects//locations//keyRings//cryptoKeys/`. KMS keys specified can be in any order. The keys + /// referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some + /// examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For + /// multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS + /// key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an + /// instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region + /// in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type + /// instance configurations. /// [Newtonsoft.Json.JsonPropertyAttribute("kmsKeyNames")] public virtual System.Collections.Generic.IList KmsKeyNames { get; set; } @@ -9333,13 +9384,13 @@ public class CreateBackupEncryptionConfig : Google.Apis.Requests.IDirectResponse /// /// Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of - /// the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by kms_key_names must fully cover - /// all regions of the backup's instance configuration. Some examples: * For single region instance configs, - /// specify a single regional location KMS key. * For multi-regional instance configs of type GOOGLE_MANAGED, - /// either specify a multi-regional location KMS key or multiple regional location KMS keys that cover all - /// regions in the instance config. * For an instance config of type USER_MANAGED, please specify only regional - /// location KMS keys to cover each region in the instance config. Multi-regional location KMS keys are not - /// supported for USER_MANAGED instance configs. + /// the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully + /// cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) + /// instance configurations, specify a regional location KMS key. * For multi-region instance configurations of + /// type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys + /// that cover all regions in the instance configuration. * For an instance configuration of type + /// `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. + /// Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations. /// [Newtonsoft.Json.JsonPropertyAttribute("kmsKeyNames")] public virtual System.Collections.Generic.IList KmsKeyNames { get; set; } @@ -10010,7 +10061,7 @@ public virtual System.DateTimeOffset? EarliestVersionTimeDateTimeOffset /// /// Output only. For databases that are using customer managed encryption, this field contains the encryption - /// information for the database, such as all Cloud KMS key versions that are in use. The `encryption_status' + /// information for the database, such as all Cloud KMS key versions that are in use. The `encryption_status` /// field inside of each `EncryptionInfo` is not populated. For databases that are using Google default or other /// types of encryption, this field is empty. This field is propagated lazily from the backend. There might be a /// delay from when a key version is being used and when it appears in this field. @@ -10231,14 +10282,14 @@ public class EncryptionConfig : Google.Apis.Requests.IDirectResponseSchema public virtual string KmsKeyName { get; set; } /// - /// Specifies the KMS configuration for the one or more keys used to encrypt the database. Values are of the - /// form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by kms_key_names must fully cover all - /// regions of the database instance configuration. Some examples: * For single region database instance - /// configs, specify a single regional location KMS key. * For multi-regional database instance configs of type - /// GOOGLE_MANAGED, either specify a multi-regional location KMS key or multiple regional location KMS keys that - /// cover all regions in the instance config. * For a database instance config of type USER_MANAGED, please - /// specify only regional location KMS keys to cover each region in the instance config. Multi-regional location - /// KMS keys are not supported for USER_MANAGED instance configs. + /// Specifies the KMS configuration for one or more keys used to encrypt the database. Values are of the form + /// `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all + /// regions of the database's instance configuration. Some examples: * For regional (single-region) instance + /// configurations, specify a regional location KMS key. * For multi-region instance configurations of type + /// `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that + /// cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, + /// specify only regional location KMS keys to cover each region in the instance configuration. Multi-region + /// location KMS keys aren't supported for `USER_MANAGED` type instance configurations. /// [Newtonsoft.Json.JsonPropertyAttribute("kmsKeyNames")] public virtual System.Collections.Generic.IList KmsKeyNames { get; set; } @@ -10336,6 +10387,14 @@ public class ExecuteBatchDmlRequest : Google.Apis.Requests.IDirectResponseSchema /// public class ExecuteBatchDmlResponse : Google.Apis.Requests.IDirectResponseSchema { + /// + /// Optional. A precommit token will be included if the read-write transaction is on a multiplexed session. The + /// precommit token with the highest sequence number from this transaction attempt should be passed to the + /// Commit request for this transaction. + /// + [Newtonsoft.Json.JsonPropertyAttribute("precommitToken")] + public virtual MultiplexedSessionPrecommitToken PrecommitToken { get; set; } + /// /// One ResultSet for each statement in the request that ran successfully, in the same order as the statements /// in the request. Each ResultSet does not contain any rows. The ResultSetStats in each ResultSet contain the @@ -10804,6 +10863,15 @@ public virtual System.DateTimeOffset? CreateTimeDateTimeOffset set => CreateTimeRaw = Google.Apis.Util.DiscoveryFormat.FormatDateTimeOffsetToGoogleDateTime(value); } + /// + /// Optional. Controls the default backup behavior for new databases within the instance. Note that `AUTOMATIC` + /// is not permitted for free instances, as backups and backup schedules are not allowed for free instances. In + /// the `GetInstance` or `ListInstances` response, if the value of default_backup_schedule_type is unset or + /// NONE, no default backup schedule will be created for new databases within the instance. + /// + [Newtonsoft.Json.JsonPropertyAttribute("defaultBackupScheduleType")] + public virtual string DefaultBackupScheduleType { get; set; } + /// /// Required. The descriptive name for this instance as it appears in UIs. Must be unique per project and /// between 4 and 30 characters in length. @@ -10857,10 +10925,8 @@ public virtual System.DateTimeOffset? CreateTimeDateTimeOffset /// should be present in the message. Users can set the `node_count` field to specify the target number of nodes /// allocated to the instance. If autoscaling is enabled, `node_count` is treated as an `OUTPUT_ONLY` field and /// reflects the current number of nodes allocated to the instance. This might be zero in API responses for - /// instances that are not yet in the `READY` state. If the instance has varying node count across replicas - /// (achieved by setting asymmetric_autoscaling_options in autoscaling config), the node_count here is the - /// maximum node count across all replicas. For more information, see [Compute capacity, nodes, and processing - /// units](https://cloud.google.com/spanner/docs/compute-capacity). + /// instances that are not yet in the `READY` state. For more information, see [Compute capacity, nodes, and + /// processing units](https://cloud.google.com/spanner/docs/compute-capacity). /// [Newtonsoft.Json.JsonPropertyAttribute("nodeCount")] public virtual System.Nullable NodeCount { get; set; } @@ -10870,9 +10936,7 @@ public virtual System.DateTimeOffset? CreateTimeDateTimeOffset /// `node_count` should be present in the message. Users can set the `processing_units` field to specify the /// target number of processing units allocated to the instance. If autoscaling is enabled, `processing_units` /// is treated as an `OUTPUT_ONLY` field and reflects the current number of processing units allocated to the - /// instance. This might be zero in API responses for instances that are not yet in the `READY` state. If the - /// instance has varying processing units per replica (achieved by setting asymmetric_autoscaling_options in - /// autoscaling config), the processing_units here is the maximum processing units across all replicas. For more + /// instance. This might be zero in API responses for instances that are not yet in the `READY` state. For more /// information, see [Compute capacity, nodes and processing /// units](https://cloud.google.com/spanner/docs/compute-capacity). /// @@ -12108,6 +12172,14 @@ public class PartialResultSet : Google.Apis.Requests.IDirectResponseSchema [Newtonsoft.Json.JsonPropertyAttribute("metadata")] public virtual ResultSetMetadata Metadata { get; set; } + /// + /// Optional. A precommit token will be included if the read-write transaction is on a multiplexed session. The + /// precommit token with the highest sequence number from this transaction attempt should be passed to the + /// Commit request for this transaction. + /// + [Newtonsoft.Json.JsonPropertyAttribute("precommitToken")] + public virtual MultiplexedSessionPrecommitToken PrecommitToken { get; set; } + /// /// Streaming calls might be interrupted for a variety of reasons, such as TCP connection loss. If this occurs, /// the stream of results can be resumed by re-sending the original request and including `resume_token`. Note @@ -12834,6 +12906,13 @@ public class ReadRequest : Google.Apis.Requests.IDirectResponseSchema /// public class ReadWrite : Google.Apis.Requests.IDirectResponseSchema { + /// + /// Optional. Clients should pass the transaction ID of the previous transaction attempt that was aborted if + /// this transaction is being executed on a multiplexed session. + /// + [Newtonsoft.Json.JsonPropertyAttribute("multiplexedSessionPreviousTransactionId")] + public virtual string MultiplexedSessionPreviousTransactionId { get; set; } + /// Read lock mode for the transaction. [Newtonsoft.Json.JsonPropertyAttribute("readLockMode")] public virtual string ReadLockMode { get; set; } @@ -12967,15 +13046,14 @@ public class RestoreDatabaseEncryptionConfig : Google.Apis.Requests.IDirectRespo public virtual string KmsKeyName { get; set; } /// - /// Optional. Specifies the KMS configuration for the one or more keys used to encrypt the database. Values have - /// the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by kms_key_names must fully cover - /// all regions of the database instance configuration. Some examples: * For single region database instance - /// configurations, specify a single regional location KMS key. * For multi-regional database instance - /// configurations of type `GOOGLE_MANAGED`, either specify a multi-regional location KMS key or multiple - /// regional location KMS keys that cover all regions in the instance configuration. * For a database instance - /// configuration of type `USER_MANAGED`, please specify only regional location KMS keys to cover each region in - /// the instance configuration. Multi-regional location KMS keys are not supported for USER_MANAGED instance - /// configurations. + /// Optional. Specifies the KMS configuration for one or more keys used to encrypt the database. Values have the + /// form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover + /// all regions of the database's instance configuration. Some examples: * For regional (single-region) instance + /// configurations, specify a regional location KMS key. * For multi-region instance configurations of type + /// `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that + /// cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, + /// specify only regional location KMS keys to cover each region in the instance configuration. Multi-region + /// location KMS keys aren't supported for `USER_MANAGED` type instance configurations. /// [Newtonsoft.Json.JsonPropertyAttribute("kmsKeyNames")] public virtual System.Collections.Generic.IList KmsKeyNames { get; set; } @@ -13117,6 +13195,14 @@ public class ResultSet : Google.Apis.Requests.IDirectResponseSchema [Newtonsoft.Json.JsonPropertyAttribute("metadata")] public virtual ResultSetMetadata Metadata { get; set; } + /// + /// Optional. A precommit token will be included if the read-write transaction is on a multiplexed session. The + /// precommit token with the highest sequence number from this transaction attempt should be passed to the + /// Commit request for this transaction. + /// + [Newtonsoft.Json.JsonPropertyAttribute("precommitToken")] + public virtual MultiplexedSessionPrecommitToken PrecommitToken { get; set; } + /// /// Each element in `rows` is a row whose format is defined by metadata.row_type. The ith element in each row /// matches the ith field in metadata.row_type. Elements are encoded based on type as described here. @@ -14035,9 +14121,10 @@ public class UpdateDatabaseDdlRequest : Google.Apis.Requests.IDirectResponseSche /// `operation_id` is used to construct the name of the resulting Operation. Specifying an explicit operation ID /// simplifies determining whether the statements were executed in the event that the UpdateDatabaseDdl call is /// replayed, or the return value is otherwise lost: the database and `operation_id` fields can be combined to - /// form the name of the resulting longrunning.Operation: `/operations/`. `operation_id` should be unique within - /// the database, and must be a valid identifier: `a-z*`. Note that automatically-generated operation IDs always - /// begin with an underscore. If the named operation already exists, UpdateDatabaseDdl returns `ALREADY_EXISTS`. + /// form the `name` of the resulting longrunning.Operation: `/operations/`. `operation_id` should be unique + /// within the database, and must be a valid identifier: `a-z*`. Note that automatically-generated operation IDs + /// always begin with an underscore. If the named operation already exists, UpdateDatabaseDdl returns + /// `ALREADY_EXISTS`. /// [Newtonsoft.Json.JsonPropertyAttribute("operationId")] public virtual string OperationId { get; set; } diff --git a/Src/Generated/Google.Apis.Spanner.v1/Google.Apis.Spanner.v1.csproj b/Src/Generated/Google.Apis.Spanner.v1/Google.Apis.Spanner.v1.csproj index f8c9340675b..16ae2def8c7 100644 --- a/Src/Generated/Google.Apis.Spanner.v1/Google.Apis.Spanner.v1.csproj +++ b/Src/Generated/Google.Apis.Spanner.v1/Google.Apis.Spanner.v1.csproj @@ -3,7 +3,7 @@ Google.Apis.Spanner.v1 Client Library - 1.68.0.3570 + 1.68.0.3580 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.Texttospeech.v1/Google.Apis.Texttospeech.v1.cs b/Src/Generated/Google.Apis.Texttospeech.v1/Google.Apis.Texttospeech.v1.cs index bfc0da9c861..2bc8f08e46e 100644 --- a/Src/Generated/Google.Apis.Texttospeech.v1/Google.Apis.Texttospeech.v1.cs +++ b/Src/Generated/Google.Apis.Texttospeech.v1/Google.Apis.Texttospeech.v1.cs @@ -781,7 +781,7 @@ namespace Google.Apis.Texttospeech.v1.Data public class AdvancedVoiceOptions : Google.Apis.Requests.IDirectResponseSchema { /// - /// Only for Jounrney voices. If false, the synthesis will be context aware and have higher latency. + /// Only for Journey voices. If false, the synthesis will be context aware and have higher latency. /// [Newtonsoft.Json.JsonPropertyAttribute("lowLatencyJourneySynthesis")] public virtual System.Nullable LowLatencyJourneySynthesis { get; set; } @@ -1025,6 +1025,17 @@ public class ListVoicesResponse : Google.Apis.Requests.IDirectResponseSchema public virtual string ETag { get; set; } } + /// A collection of turns for multi-speaker synthesis. + public class MultiSpeakerMarkup : Google.Apis.Requests.IDirectResponseSchema + { + /// Required. Speaker turns. + [Newtonsoft.Json.JsonPropertyAttribute("turns")] + public virtual System.Collections.Generic.IList Turns { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// This resource represents a long-running operation that is the result of a network API call. public class Operation : Google.Apis.Requests.IDirectResponseSchema { @@ -1114,6 +1125,10 @@ public class SynthesisInput : Google.Apis.Requests.IDirectResponseSchema [Newtonsoft.Json.JsonPropertyAttribute("customPronunciations")] public virtual CustomPronunciations CustomPronunciations { get; set; } + /// The multi-speaker input to be synthesized. Only applicable for multi-speaker synthesis. + [Newtonsoft.Json.JsonPropertyAttribute("multiSpeakerMarkup")] + public virtual MultiSpeakerMarkup MultiSpeakerMarkup { get; set; } + /// /// The SSML document to be synthesized. The SSML document must be valid and well-formed. Otherwise the RPC will /// fail and return google.rpc.Code.INVALID_ARGUMENT. For more information, see @@ -1246,7 +1261,7 @@ public class SynthesizeLongAudioRequest : Google.Apis.Requests.IDirectResponseSc /// The top-level message sent by the client for the `SynthesizeSpeech` method. public class SynthesizeSpeechRequest : Google.Apis.Requests.IDirectResponseSchema { - /// Adnanced voice options. + /// Advanced voice options. [Newtonsoft.Json.JsonPropertyAttribute("advancedVoiceOptions")] public virtual AdvancedVoiceOptions AdvancedVoiceOptions { get; set; } @@ -1281,6 +1296,24 @@ public class SynthesizeSpeechResponse : Google.Apis.Requests.IDirectResponseSche public virtual string ETag { get; set; } } + /// A Multi-speaker turn. + public class Turn : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Required. The speaker of the turn, for example, 'O' or 'Q'. Please refer to documentation for available + /// speakers. + /// + [Newtonsoft.Json.JsonPropertyAttribute("speaker")] + public virtual string Speaker { get; set; } + + /// Required. The text to speak. + [Newtonsoft.Json.JsonPropertyAttribute("text")] + public virtual string Text { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Description of a voice supported by the TTS service. public class Voice : Google.Apis.Requests.IDirectResponseSchema { @@ -1307,6 +1340,17 @@ public class Voice : Google.Apis.Requests.IDirectResponseSchema public virtual string ETag { get; set; } } + /// The configuration of Voice Clone feature. + public class VoiceCloneParams : Google.Apis.Requests.IDirectResponseSchema + { + /// Required. Created by GenerateVoiceCloningKey. + [Newtonsoft.Json.JsonPropertyAttribute("voiceCloningKey")] + public virtual string VoiceCloningKey { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Description of which voice to use for a synthesis request. public class VoiceSelectionParams : Google.Apis.Requests.IDirectResponseSchema { @@ -1345,6 +1389,13 @@ public class VoiceSelectionParams : Google.Apis.Requests.IDirectResponseSchema [Newtonsoft.Json.JsonPropertyAttribute("ssmlGender")] public virtual string SsmlGender { get; set; } + /// + /// Optional. The configuration for a voice clone. If [VoiceCloneParams.voice_clone_key] is set, the service + /// will choose the voice clone matching the specified configuration. + /// + [Newtonsoft.Json.JsonPropertyAttribute("voiceClone")] + public virtual VoiceCloneParams VoiceClone { get; set; } + /// The ETag of the item. public virtual string ETag { get; set; } } diff --git a/Src/Generated/Google.Apis.Texttospeech.v1/Google.Apis.Texttospeech.v1.csproj b/Src/Generated/Google.Apis.Texttospeech.v1/Google.Apis.Texttospeech.v1.csproj index 4c4d5dc71a3..0f8c4563f71 100644 --- a/Src/Generated/Google.Apis.Texttospeech.v1/Google.Apis.Texttospeech.v1.csproj +++ b/Src/Generated/Google.Apis.Texttospeech.v1/Google.Apis.Texttospeech.v1.csproj @@ -3,7 +3,7 @@ Google.Apis.Texttospeech.v1 Client Library - 1.68.0.3568 + 1.68.0.3586 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.Texttospeech.v1beta1/Google.Apis.Texttospeech.v1beta1.cs b/Src/Generated/Google.Apis.Texttospeech.v1beta1/Google.Apis.Texttospeech.v1beta1.cs index 817f5d594c7..69d96686301 100644 --- a/Src/Generated/Google.Apis.Texttospeech.v1beta1/Google.Apis.Texttospeech.v1beta1.cs +++ b/Src/Generated/Google.Apis.Texttospeech.v1beta1/Google.Apis.Texttospeech.v1beta1.cs @@ -642,7 +642,7 @@ namespace Google.Apis.Texttospeech.v1beta1.Data public class AdvancedVoiceOptions : Google.Apis.Requests.IDirectResponseSchema { /// - /// Only for Jounrney voices. If false, the synthesis will be context aware and have higher latency. + /// Only for Journey voices. If false, the synthesis will be context aware and have higher latency. /// [Newtonsoft.Json.JsonPropertyAttribute("lowLatencyJourneySynthesis")] public virtual System.Nullable LowLatencyJourneySynthesis { get; set; } @@ -868,6 +868,17 @@ public class ListVoicesResponse : Google.Apis.Requests.IDirectResponseSchema public virtual string ETag { get; set; } } + /// A collection of turns for multi-speaker synthesis. + public class MultiSpeakerMarkup : Google.Apis.Requests.IDirectResponseSchema + { + /// Required. Speaker turns. + [Newtonsoft.Json.JsonPropertyAttribute("turns")] + public virtual System.Collections.Generic.IList Turns { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// This resource represents a long-running operation that is the result of a network API call. public class Operation : Google.Apis.Requests.IDirectResponseSchema { @@ -957,6 +968,10 @@ public class SynthesisInput : Google.Apis.Requests.IDirectResponseSchema [Newtonsoft.Json.JsonPropertyAttribute("customPronunciations")] public virtual CustomPronunciations CustomPronunciations { get; set; } + /// The multi-speaker input to be synthesized. Only applicable for multi-speaker synthesis. + [Newtonsoft.Json.JsonPropertyAttribute("multiSpeakerMarkup")] + public virtual MultiSpeakerMarkup MultiSpeakerMarkup { get; set; } + /// /// The SSML document to be synthesized. The SSML document must be valid and well-formed. Otherwise the RPC will /// fail and return google.rpc.Code.INVALID_ARGUMENT. For more information, see @@ -1089,7 +1104,7 @@ public class SynthesizeLongAudioRequest : Google.Apis.Requests.IDirectResponseSc /// The top-level message sent by the client for the `SynthesizeSpeech` method. public class SynthesizeSpeechRequest : Google.Apis.Requests.IDirectResponseSchema { - /// Adnanced voice options. + /// Advanced voice options. [Newtonsoft.Json.JsonPropertyAttribute("advancedVoiceOptions")] public virtual AdvancedVoiceOptions AdvancedVoiceOptions { get; set; } @@ -1156,6 +1171,24 @@ public class Timepoint : Google.Apis.Requests.IDirectResponseSchema public virtual string ETag { get; set; } } + /// A Multi-speaker turn. + public class Turn : Google.Apis.Requests.IDirectResponseSchema + { + /// + /// Required. The speaker of the turn, for example, 'O' or 'Q'. Please refer to documentation for available + /// speakers. + /// + [Newtonsoft.Json.JsonPropertyAttribute("speaker")] + public virtual string Speaker { get; set; } + + /// Required. The text to speak. + [Newtonsoft.Json.JsonPropertyAttribute("text")] + public virtual string Text { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Description of a voice supported by the TTS service. public class Voice : Google.Apis.Requests.IDirectResponseSchema { @@ -1182,6 +1215,17 @@ public class Voice : Google.Apis.Requests.IDirectResponseSchema public virtual string ETag { get; set; } } + /// The configuration of Voice Clone feature. + public class VoiceCloneParams : Google.Apis.Requests.IDirectResponseSchema + { + /// Required. Created by GenerateVoiceCloningKey. + [Newtonsoft.Json.JsonPropertyAttribute("voiceCloningKey")] + public virtual string VoiceCloningKey { get; set; } + + /// The ETag of the item. + public virtual string ETag { get; set; } + } + /// Description of which voice to use for a synthesis request. public class VoiceSelectionParams : Google.Apis.Requests.IDirectResponseSchema { @@ -1220,6 +1264,13 @@ public class VoiceSelectionParams : Google.Apis.Requests.IDirectResponseSchema [Newtonsoft.Json.JsonPropertyAttribute("ssmlGender")] public virtual string SsmlGender { get; set; } + /// + /// Optional. The configuration for a voice clone. If [VoiceCloneParams.voice_clone_key] is set, the service + /// will choose the voice clone matching the specified configuration. + /// + [Newtonsoft.Json.JsonPropertyAttribute("voiceClone")] + public virtual VoiceCloneParams VoiceClone { get; set; } + /// The ETag of the item. public virtual string ETag { get; set; } } diff --git a/Src/Generated/Google.Apis.Texttospeech.v1beta1/Google.Apis.Texttospeech.v1beta1.csproj b/Src/Generated/Google.Apis.Texttospeech.v1beta1/Google.Apis.Texttospeech.v1beta1.csproj index 62ddd5fc438..d2f8eaab0d1 100644 --- a/Src/Generated/Google.Apis.Texttospeech.v1beta1/Google.Apis.Texttospeech.v1beta1.csproj +++ b/Src/Generated/Google.Apis.Texttospeech.v1beta1/Google.Apis.Texttospeech.v1beta1.csproj @@ -3,7 +3,7 @@ Google.Apis.Texttospeech.v1beta1 Client Library - 1.68.0.3568 + 1.68.0.3586 Google LLC Copyright 2024 Google LLC Google diff --git a/Src/Generated/Google.Apis.TravelImpactModel.v1/Google.Apis.TravelImpactModel.v1.cs b/Src/Generated/Google.Apis.TravelImpactModel.v1/Google.Apis.TravelImpactModel.v1.cs index a72d0719e18..0f12f578ae3 100644 --- a/Src/Generated/Google.Apis.TravelImpactModel.v1/Google.Apis.TravelImpactModel.v1.cs +++ b/Src/Generated/Google.Apis.TravelImpactModel.v1/Google.Apis.TravelImpactModel.v1.cs @@ -443,9 +443,8 @@ public class FlightWithEmissions : Google.Apis.Requests.IDirectResponseSchema { /// /// Optional. Per-passenger emission estimate numbers. Will not be present if emissions could not be computed. - /// For the list of reasons why emissions could not be computed, see ComputeFlightEmissions. Note this field is - /// currently equivalent to ttw_emissions_grams_per_pax until TIM version 1.X.0 which will update this to be - /// total wtw emissions aka wtt_emissions_grams_per_pax + ttw_emissions_grams_per_pax. + /// For the list of reasons why emissions could not be computed, see ComputeFlightEmissions. This field uses wtw + /// emissions aka ttw_emissions_grams_per_pax + wtt_emissions_grams_per_pax. /// [Newtonsoft.Json.JsonPropertyAttribute("emissionsGramsPerPax")] public virtual EmissionsGramsPerPax EmissionsGramsPerPax { get; set; } diff --git a/Src/Generated/Google.Apis.TravelImpactModel.v1/Google.Apis.TravelImpactModel.v1.csproj b/Src/Generated/Google.Apis.TravelImpactModel.v1/Google.Apis.TravelImpactModel.v1.csproj index 4f3162fe5bb..607e563bdd3 100644 --- a/Src/Generated/Google.Apis.TravelImpactModel.v1/Google.Apis.TravelImpactModel.v1.csproj +++ b/Src/Generated/Google.Apis.TravelImpactModel.v1/Google.Apis.TravelImpactModel.v1.csproj @@ -3,7 +3,7 @@ Google.Apis.TravelImpactModel.v1 Client Library - 1.68.0.3206 + 1.68.0.3587 Google LLC Copyright 2024 Google LLC Google