diff --git a/.github/renovate.json b/.github/renovate.json index 9cd9aeb73c..9a8f0e6262 100644 --- a/.github/renovate.json +++ b/.github/renovate.json @@ -25,7 +25,7 @@ ], "force": { "constraints": { - "go": "1.24" + "go": "1.25" } } } diff --git a/CHANGES.md b/CHANGES.md index 46f7bf103c..1621fcd758 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -1,5 +1,18 @@ # Changes +## [0.268.0](https://github.com/googleapis/google-api-go-client/compare/v0.267.0...v0.268.0) (2026-02-23) + + +### Features + +* **all:** Auto-regenerate discovery clients ([#3502](https://github.com/googleapis/google-api-go-client/issues/3502)) ([5ccf9b9](https://github.com/googleapis/google-api-go-client/commit/5ccf9b931da20908e6fcfacacc2a5b187e3c2d18)) +* **all:** Auto-regenerate discovery clients ([#3505](https://github.com/googleapis/google-api-go-client/issues/3505)) ([f405df9](https://github.com/googleapis/google-api-go-client/commit/f405df9cfcfd63da04a8041398a1ac7e05b19be0)) +* **all:** Auto-regenerate discovery clients ([#3506](https://github.com/googleapis/google-api-go-client/issues/3506)) ([cda923a](https://github.com/googleapis/google-api-go-client/commit/cda923ae8e234c4b83585867e67163dfbf7228af)) +* **all:** Auto-regenerate discovery clients ([#3507](https://github.com/googleapis/google-api-go-client/issues/3507)) ([e9015cc](https://github.com/googleapis/google-api-go-client/commit/e9015cc2681ce9d6300f4fae2ae6b075c6d75ead)) +* **all:** Auto-regenerate discovery clients ([#3508](https://github.com/googleapis/google-api-go-client/issues/3508)) ([20fbcc1](https://github.com/googleapis/google-api-go-client/commit/20fbcc132145cd4a09a58494dcb0b11974d5a681)) +* **all:** Auto-regenerate discovery clients ([#3509](https://github.com/googleapis/google-api-go-client/issues/3509)) ([20c1e0f](https://github.com/googleapis/google-api-go-client/commit/20c1e0f7c75bfe94e9eb5a12a13003dcafa93342)) +* Update to go 1.26 ([#3504](https://github.com/googleapis/google-api-go-client/issues/3504)) ([cc5baec](https://github.com/googleapis/google-api-go-client/commit/cc5baec2a450cf4d15a4aa1e71f5cefea339f2ea)) + ## [0.267.0](https://github.com/googleapis/google-api-go-client/compare/v0.266.0...v0.267.0) (2026-02-17) diff --git a/alloydb/v1/alloydb-api.json b/alloydb/v1/alloydb-api.json index 4d55b5eeb1..ed19a733e8 100644 --- a/alloydb/v1/alloydb-api.json +++ b/alloydb/v1/alloydb-api.json @@ -1879,7 +1879,7 @@ } } }, - "revision": "20260205", + "revision": "20260213", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -3399,7 +3399,7 @@ "id": "InstanceNetworkConfig", "properties": { "allocatedIpRangeOverride": { - "description": "Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: \"google-managed-services-default\". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?.", + "description": "Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: \"google-managed-services-default\". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?.", "type": "string" }, "authorizedExternalNetworks": { diff --git a/alloydb/v1/alloydb-gen.go b/alloydb/v1/alloydb-gen.go index 6bea0cc0ca..22c97120cc 100644 --- a/alloydb/v1/alloydb-gen.go +++ b/alloydb/v1/alloydb-gen.go @@ -1879,7 +1879,7 @@ type InstanceNetworkConfig struct { // private IP AlloyDB instance, for example: "google-managed-services-default". // If set, the instance IPs will be created from this allocated range and will // override the IP range used by the parent cluster. The range name must comply - // with RFC 1035 (http://datatracker.ietf.org/doc/html/rfc1035). Specifically, + // with RFC 1035 (https://datatracker.ietf.org/doc/html/rfc1035). Specifically, // the name must be 1-63 characters long and match the regular expression a-z // ([-a-z0-9]*[a-z0-9])?. AllocatedIpRangeOverride string `json:"allocatedIpRangeOverride,omitempty"` diff --git a/alloydb/v1alpha/alloydb-api.json b/alloydb/v1alpha/alloydb-api.json index 2845e9bc3b..97528b86bf 100644 --- a/alloydb/v1alpha/alloydb-api.json +++ b/alloydb/v1alpha/alloydb-api.json @@ -1879,7 +1879,7 @@ } } }, - "revision": "20260205", + "revision": "20260213", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -3519,7 +3519,7 @@ "id": "InstanceNetworkConfig", "properties": { "allocatedIpRangeOverride": { - "description": "Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: \"google-managed-services-default\". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?.", + "description": "Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: \"google-managed-services-default\". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?.", "type": "string" }, "authorizedExternalNetworks": { diff --git a/alloydb/v1alpha/alloydb-gen.go b/alloydb/v1alpha/alloydb-gen.go index b763427633..d6d282bbcd 100644 --- a/alloydb/v1alpha/alloydb-gen.go +++ b/alloydb/v1alpha/alloydb-gen.go @@ -2009,7 +2009,7 @@ type InstanceNetworkConfig struct { // private IP AlloyDB instance, for example: "google-managed-services-default". // If set, the instance IPs will be created from this allocated range and will // override the IP range used by the parent cluster. The range name must comply - // with RFC 1035 (http://datatracker.ietf.org/doc/html/rfc1035). Specifically, + // with RFC 1035 (https://datatracker.ietf.org/doc/html/rfc1035). Specifically, // the name must be 1-63 characters long and match the regular expression a-z // ([-a-z0-9]*[a-z0-9])?. AllocatedIpRangeOverride string `json:"allocatedIpRangeOverride,omitempty"` diff --git a/alloydb/v1beta/alloydb-api.json b/alloydb/v1beta/alloydb-api.json index 3baa0512c8..ff18f0e310 100644 --- a/alloydb/v1beta/alloydb-api.json +++ b/alloydb/v1beta/alloydb-api.json @@ -1876,7 +1876,7 @@ } } }, - "revision": "20260205", + "revision": "20260213", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -3495,7 +3495,7 @@ "id": "InstanceNetworkConfig", "properties": { "allocatedIpRangeOverride": { - "description": "Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: \"google-managed-services-default\". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?.", + "description": "Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: \"google-managed-services-default\". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](https://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?.", "type": "string" }, "authorizedExternalNetworks": { diff --git a/alloydb/v1beta/alloydb-gen.go b/alloydb/v1beta/alloydb-gen.go index 4bbf752594..7e4910baad 100644 --- a/alloydb/v1beta/alloydb-gen.go +++ b/alloydb/v1beta/alloydb-gen.go @@ -1999,7 +1999,7 @@ type InstanceNetworkConfig struct { // private IP AlloyDB instance, for example: "google-managed-services-default". // If set, the instance IPs will be created from this allocated range and will // override the IP range used by the parent cluster. The range name must comply - // with RFC 1035 (http://datatracker.ietf.org/doc/html/rfc1035). Specifically, + // with RFC 1035 (https://datatracker.ietf.org/doc/html/rfc1035). Specifically, // the name must be 1-63 characters long and match the regular expression a-z // ([-a-z0-9]*[a-z0-9])?. AllocatedIpRangeOverride string `json:"allocatedIpRangeOverride,omitempty"` diff --git a/androidmanagement/v1/androidmanagement-api.json b/androidmanagement/v1/androidmanagement-api.json index e139366d78..39bf82f27c 100644 --- a/androidmanagement/v1/androidmanagement-api.json +++ b/androidmanagement/v1/androidmanagement-api.json @@ -1265,7 +1265,7 @@ } } }, - "revision": "20260212", + "revision": "20260219", "rootUrl": "https://androidmanagement.googleapis.com/", "schemas": { "AdbShellCommandEvent": { @@ -4276,7 +4276,7 @@ "id": "GoogleAuthenticationSettings", "properties": { "googleAuthenticationRequired": { - "description": "Output only. Whether users need to be authenticated by Google during the enrollment process. IT admin can specify if Google authentication is enabled for the enterprise for knowledge worker devices. This value can be set only via the Google Admin Console. Google authentication can be used with signin_url In the case where Google authentication is required and a signin_url is specified, Google authentication will be launched before signin_url.", + "description": "Output only. Whether users need to be authenticated by Google during the enrollment process. IT admin can specify if Google authentication is enabled for the enterprise for knowledge worker devices. This value can be set only via the Google Admin Console. Google authentication can be used with signin_url In the case where Google authentication is required and a signin_url is specified, Google authentication will be launched before signin_url. This value is overridden by EnrollmentToken.googleAuthenticationOptions and SigninDetail.googleAuthenticationOptions, if they are set.", "enum": [ "GOOGLE_AUTHENTICATION_REQUIRED_UNSPECIFIED", "NOT_REQUIRED", diff --git a/androidmanagement/v1/androidmanagement-gen.go b/androidmanagement/v1/androidmanagement-gen.go index aaaa0003a6..527cf40da3 100644 --- a/androidmanagement/v1/androidmanagement-gen.go +++ b/androidmanagement/v1/androidmanagement-gen.go @@ -3984,7 +3984,9 @@ type GoogleAuthenticationSettings struct { // devices. This value can be set only via the Google Admin Console. Google // authentication can be used with signin_url In the case where Google // authentication is required and a signin_url is specified, Google - // authentication will be launched before signin_url. + // authentication will be launched before signin_url. This value is overridden + // by EnrollmentToken.googleAuthenticationOptions and + // SigninDetail.googleAuthenticationOptions, if they are set. // // Possible values: // "GOOGLE_AUTHENTICATION_REQUIRED_UNSPECIFIED" - This value is not used. diff --git a/apigee/v1/apigee-api.json b/apigee/v1/apigee-api.json index c5e2bb8dd0..2a29e8bdbb 100644 --- a/apigee/v1/apigee-api.json +++ b/apigee/v1/apigee-api.json @@ -10384,6 +10384,21 @@ "pattern": "^organizations/[^/]+/securityMonitoringConditions/[^/]+$", "required": true, "type": "string" + }, + "riskAssessmentType": { + "description": "Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY.", + "enum": [ + "RISK_ASSESSMENT_TYPE_UNSPECIFIED", + "APIGEE", + "API_HUB" + ], + "enumDescriptions": [ + "Risk assessment type is not specified.", + "Risk assessment type is Apigee.", + "Risk assessment type is API Hub." + ], + "location": "query", + "type": "string" } }, "path": "v1/{+name}", @@ -10409,6 +10424,21 @@ "pattern": "^organizations/[^/]+/securityMonitoringConditions/[^/]+$", "required": true, "type": "string" + }, + "riskAssessmentType": { + "description": "Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY.", + "enum": [ + "RISK_ASSESSMENT_TYPE_UNSPECIFIED", + "APIGEE", + "API_HUB" + ], + "enumDescriptions": [ + "Risk assessment type is not specified.", + "Risk assessment type is Apigee.", + "Risk assessment type is API Hub." + ], + "location": "query", + "type": "string" } }, "path": "v1/{+name}", @@ -10429,7 +10459,7 @@ ], "parameters": { "filter": { - "description": "Optional. Filter for the monitoring conditions. For example: `profile=profile1 AND scope=env1`", + "description": "Optional. Filter for the monitoring conditions. When RiskAssessmentType is APIGEE, monitoring conditions can be filtered by profile and scope. For example: `profile=profile1 AND scope=env1` When RiskAssessmentType is API_HUB, monitoring conditions can be filtered by profile and api_hub_gateway. For example: `profile=profile1 AND api_hub_gateway=gateway1`", "location": "query", "type": "string" }, @@ -10450,6 +10480,21 @@ "pattern": "^organizations/[^/]+$", "required": true, "type": "string" + }, + "riskAssessmentType": { + "description": "Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY.", + "enum": [ + "RISK_ASSESSMENT_TYPE_UNSPECIFIED", + "APIGEE", + "API_HUB" + ], + "enumDescriptions": [ + "Risk assessment type is not specified.", + "Risk assessment type is Apigee.", + "Risk assessment type is API Hub." + ], + "location": "query", + "type": "string" } }, "path": "v1/{+parent}/securityMonitoringConditions", @@ -11914,7 +11959,7 @@ } } }, - "revision": "20260130", + "revision": "20260218", "rootUrl": "https://apigee.googleapis.com/", "schemas": { "ApiservingMcpMcpToolDataHandlingProfile": { @@ -19716,6 +19761,24 @@ "description": "Output only. Additional details for the API Hub deployment.", "readOnly": true }, + "apiHubGatewayType": { + "description": "Optional. ", + "enum": [ + "API_HUB_GATEWAY_TYPE_UNSPECIFIED", + "APIGEE_X", + "APIGEE_HYBRID", + "APIGEE_EDGE", + "APIGEE_OPDK" + ], + "enumDescriptions": [ + "Gateway type is not specified.", + "Gateway is Apigee X for API Hub.", + "Gateway is Apigee Hybrid for API Hub.", + "Gateway is Apigee Edge for API Hub.", + "Gateway is Apigee OPDK for API Hub." + ], + "type": "string" + }, "name": { "description": "Required. Name of this resource. For an Apigee API Proxy, this should be the id of the API proxy. For an API Hub Deployment, this should be the id of the deployment.", "type": "string" @@ -20096,6 +20159,10 @@ "description": "Security monitoring condition for risk assessment version 2.", "id": "GoogleCloudApigeeV1SecurityMonitoringCondition", "properties": { + "apiHubGateway": { + "description": "Optional. The API Hub gateway monitored by the security monitoring condition. This should only be set if risk_assessment_type is API_HUB. Format: `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}`", + "type": "string" + }, "createTime": { "description": "Output only. The time of the security monitoring condition creation.", "format": "google-datetime", @@ -20118,8 +20185,22 @@ "description": "Required. ID of security profile of the security monitoring condition.", "type": "string" }, + "riskAssessmentType": { + "description": "Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY.", + "enum": [ + "RISK_ASSESSMENT_TYPE_UNSPECIFIED", + "APIGEE", + "API_HUB" + ], + "enumDescriptions": [ + "Risk assessment type is not specified.", + "Risk assessment type is Apigee.", + "Risk assessment type is API Hub." + ], + "type": "string" + }, "scope": { - "description": "Optional. Scope of the security monitoring condition. For Apigee, the environment is the scope of the resources.", + "description": "Optional. Scope of the security monitoring condition. When RiskAssessmentType is APIGEE, the scope should be set to the environment of the resources. When RiskAssessmentType is API_HUB, the scope should not be set.", "type": "string" }, "totalDeployedResources": { diff --git a/apigee/v1/apigee-gen.go b/apigee/v1/apigee-gen.go index fd3f953be4..70fd2322a0 100644 --- a/apigee/v1/apigee-gen.go +++ b/apigee/v1/apigee-gen.go @@ -10891,6 +10891,15 @@ type GoogleCloudApigeeV1SecurityAssessmentResultResource struct { // ApiHubDeploymentDetails: Output only. Additional details for the API Hub // deployment. ApiHubDeploymentDetails *GoogleCloudApigeeV1SecurityAssessmentResultResourceApiHubDeploymentDetails `json:"apiHubDeploymentDetails,omitempty"` + // ApiHubGatewayType: Optional. + // + // Possible values: + // "API_HUB_GATEWAY_TYPE_UNSPECIFIED" - Gateway type is not specified. + // "APIGEE_X" - Gateway is Apigee X for API Hub. + // "APIGEE_HYBRID" - Gateway is Apigee Hybrid for API Hub. + // "APIGEE_EDGE" - Gateway is Apigee Edge for API Hub. + // "APIGEE_OPDK" - Gateway is Apigee OPDK for API Hub. + ApiHubGatewayType string `json:"apiHubGatewayType,omitempty"` // Name: Required. Name of this resource. For an Apigee API Proxy, this should // be the id of the API proxy. For an API Hub Deployment, this should be the id // of the deployment. @@ -11254,6 +11263,12 @@ func (s GoogleCloudApigeeV1SecurityIncident) MarshalJSON() ([]byte, error) { // GoogleCloudApigeeV1SecurityMonitoringCondition: Security monitoring // condition for risk assessment version 2. type GoogleCloudApigeeV1SecurityMonitoringCondition struct { + // ApiHubGateway: Optional. The API Hub gateway monitored by the security + // monitoring condition. This should only be set if risk_assessment_type is + // API_HUB. Format: + // `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance + // }` + ApiHubGateway string `json:"apiHubGateway,omitempty"` // CreateTime: Output only. The time of the security monitoring condition // creation. CreateTime string `json:"createTime,omitempty"` @@ -11269,8 +11284,19 @@ type GoogleCloudApigeeV1SecurityMonitoringCondition struct { // Profile: Required. ID of security profile of the security monitoring // condition. Profile string `json:"profile,omitempty"` - // Scope: Optional. Scope of the security monitoring condition. For Apigee, the - // environment is the scope of the resources. + // RiskAssessmentType: Optional. The risk assessment type of the security + // monitoring condition. Defaults to ADVANCED_API_SECURITY. + // + // Possible values: + // "RISK_ASSESSMENT_TYPE_UNSPECIFIED" - Risk assessment type is not + // specified. + // "APIGEE" - Risk assessment type is Apigee. + // "API_HUB" - Risk assessment type is API Hub. + RiskAssessmentType string `json:"riskAssessmentType,omitempty"` + // Scope: Optional. Scope of the security monitoring condition. When + // RiskAssessmentType is APIGEE, the scope should be set to the environment of + // the resources. When RiskAssessmentType is API_HUB, the scope should not be + // set. Scope string `json:"scope,omitempty"` // TotalDeployedResources: Output only. Total number of deployed resources // within scope. @@ -11284,13 +11310,13 @@ type GoogleCloudApigeeV1SecurityMonitoringCondition struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "CreateTime") to + // ForceSendFields is a list of field names (e.g. "ApiHubGateway") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CreateTime") to include in API + // NullFields is a list of field names (e.g. "ApiHubGateway") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. @@ -51780,6 +51806,23 @@ func (r *OrganizationsSecurityMonitoringConditionsService) Delete(name string) * return c } +// RiskAssessmentType sets the optional parameter "riskAssessmentType": The +// risk assessment type of the security monitoring condition. Defaults to +// ADVANCED_API_SECURITY. +// +// Possible values: +// +// "RISK_ASSESSMENT_TYPE_UNSPECIFIED" - Risk assessment type is not +// +// specified. +// +// "APIGEE" - Risk assessment type is Apigee. +// "API_HUB" - Risk assessment type is API Hub. +func (c *OrganizationsSecurityMonitoringConditionsDeleteCall) RiskAssessmentType(riskAssessmentType string) *OrganizationsSecurityMonitoringConditionsDeleteCall { + c.urlParams_.Set("riskAssessmentType", riskAssessmentType) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -51881,6 +51924,23 @@ func (r *OrganizationsSecurityMonitoringConditionsService) Get(name string) *Org return c } +// RiskAssessmentType sets the optional parameter "riskAssessmentType": The +// risk assessment type of the security monitoring condition. Defaults to +// ADVANCED_API_SECURITY. +// +// Possible values: +// +// "RISK_ASSESSMENT_TYPE_UNSPECIFIED" - Risk assessment type is not +// +// specified. +// +// "APIGEE" - Risk assessment type is Apigee. +// "API_HUB" - Risk assessment type is API Hub. +func (c *OrganizationsSecurityMonitoringConditionsGetCall) RiskAssessmentType(riskAssessmentType string) *OrganizationsSecurityMonitoringConditionsGetCall { + c.urlParams_.Set("riskAssessmentType", riskAssessmentType) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -51993,7 +52053,11 @@ func (r *OrganizationsSecurityMonitoringConditionsService) List(parent string) * } // Filter sets the optional parameter "filter": Filter for the monitoring -// conditions. For example: `profile=profile1 AND scope=env1` +// conditions. When RiskAssessmentType is APIGEE, monitoring conditions can be +// filtered by profile and scope. For example: `profile=profile1 AND +// scope=env1` When RiskAssessmentType is API_HUB, monitoring conditions can be +// filtered by profile and api_hub_gateway. For example: `profile=profile1 AND +// api_hub_gateway=gateway1` func (c *OrganizationsSecurityMonitoringConditionsListCall) Filter(filter string) *OrganizationsSecurityMonitoringConditionsListCall { c.urlParams_.Set("filter", filter) return c @@ -52014,6 +52078,23 @@ func (c *OrganizationsSecurityMonitoringConditionsListCall) PageToken(pageToken return c } +// RiskAssessmentType sets the optional parameter "riskAssessmentType": The +// risk assessment type of the security monitoring condition. Defaults to +// ADVANCED_API_SECURITY. +// +// Possible values: +// +// "RISK_ASSESSMENT_TYPE_UNSPECIFIED" - Risk assessment type is not +// +// specified. +// +// "APIGEE" - Risk assessment type is Apigee. +// "API_HUB" - Risk assessment type is API Hub. +func (c *OrganizationsSecurityMonitoringConditionsListCall) RiskAssessmentType(riskAssessmentType string) *OrganizationsSecurityMonitoringConditionsListCall { + c.urlParams_.Set("riskAssessmentType", riskAssessmentType) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. diff --git a/appengine/v1beta/appengine-api.json b/appengine/v1beta/appengine-api.json index 5e553b4800..54d96bc2f0 100644 --- a/appengine/v1beta/appengine-api.json +++ b/appengine/v1beta/appengine-api.json @@ -2868,7 +2868,7 @@ } } }, - "revision": "20260202", + "revision": "20260220", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "ApiConfigHandler": { @@ -5120,21 +5120,6 @@ }, "type": "object" }, - "SubnetworkKey": { - "description": "Subnetwork key message.", - "id": "SubnetworkKey", - "properties": { - "hostProjectId": { - "description": "Project id (name not number) of the project that hosts the network", - "type": "string" - }, - "subnet": { - "description": "Short name of the subnetwork. e.g. SUBNET instead of projects/{PROJECT_NAME}/regions/{REGION}/subnetworks/{SUBNET}", - "type": "string" - } - }, - "type": "object" - }, "TrafficSplit": { "description": "Traffic routing configuration for versions within a single service. Traffic splits define how traffic directed to the service is assigned to versions.", "id": "TrafficSplit", @@ -5554,11 +5539,6 @@ "$ref": "VpcAccessConnector", "description": "Enables VPC connectivity for standard apps." }, - "vpcEgress": { - "$ref": "VpcEgress", - "deprecated": true, - "description": "Deprecated: Use vpc_access instead. Enables VPC egress connectivity for standard apps." - }, "zones": { "description": "The Google Compute Engine zones that are supported by this version in the App Engine flexible environment. Deprecated.", "items": { @@ -5642,39 +5622,6 @@ }, "type": "object" }, - "VpcEgress": { - "deprecated": true, - "description": "Deprecated: Use VpcAccess instead. Vpc Egress configuration.", - "id": "VpcEgress", - "properties": { - "egressSetting": { - "description": "The egress setting for the subnetwork, controlling what traffic is diverted through it.", - "enum": [ - "EGRESS_SETTING_UNSPECIFIED", - "ALL_TRAFFIC", - "PRIVATE_IP_RANGES" - ], - "enumDescriptions": [ - "No value set; apply default behavior", - "Force all traffic to egress through the NetworkInterface (and configured VPC Network)", - "Force all Private IP Space traffic to egress through NetworkInterface (and configured VPC Network)" - ], - "type": "string" - }, - "networkTags": { - "description": "The network tags to apply to the instance.", - "items": { - "$ref": "VpcNetworkTag" - }, - "type": "array" - }, - "subnetworkKey": { - "$ref": "SubnetworkKey", - "description": "The subnetwork key." - } - }, - "type": "object" - }, "VpcNetworkInterface": { "description": "Network interface key message.", "id": "VpcNetworkInterface", @@ -5697,17 +5644,6 @@ }, "type": "object" }, - "VpcNetworkTag": { - "description": "Network tag message.", - "id": "VpcNetworkTag", - "properties": { - "value": { - "description": "value for the tag name", - "type": "string" - } - }, - "type": "object" - }, "ZipInfo": { "description": "The zip file information for a zip deployment.", "id": "ZipInfo", diff --git a/appengine/v1beta/appengine-gen.go b/appengine/v1beta/appengine-gen.go index 27df6e742c..d532ee8f4f 100644 --- a/appengine/v1beta/appengine-gen.go +++ b/appengine/v1beta/appengine-gen.go @@ -3306,32 +3306,6 @@ func (s Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// SubnetworkKey: Subnetwork key message. -type SubnetworkKey struct { - // HostProjectId: Project id (name not number) of the project that hosts the - // network - HostProjectId string `json:"hostProjectId,omitempty"` - // Subnet: Short name of the subnetwork. e.g. SUBNET instead of - // projects/{PROJECT_NAME}/regions/{REGION}/subnetworks/{SUBNET} - Subnet string `json:"subnet,omitempty"` - // ForceSendFields is a list of field names (e.g. "HostProjectId") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "HostProjectId") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SubnetworkKey) MarshalJSON() ([]byte, error) { - type NoMethod SubnetworkKey - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // TrafficSplit: Traffic routing configuration for versions within a single // service. Traffic splits define how traffic directed to the service is // assigned to versions. @@ -3683,9 +3657,6 @@ type Version struct { VpcAccess *VpcAccess `json:"vpcAccess,omitempty"` // VpcAccessConnector: Enables VPC connectivity for standard apps. VpcAccessConnector *VpcAccessConnector `json:"vpcAccessConnector,omitempty"` - // VpcEgress: Deprecated: Use vpc_access instead. Enables VPC egress - // connectivity for standard apps. - VpcEgress *VpcEgress `json:"vpcEgress,omitempty"` // Zones: The Google Compute Engine zones that are supported by this version in // the App Engine flexible environment. Deprecated. Zones []string `json:"zones,omitempty"` @@ -3817,40 +3788,6 @@ func (s VpcAccessConnector) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// VpcEgress: Deprecated: Use VpcAccess instead. Vpc Egress configuration. -type VpcEgress struct { - // EgressSetting: The egress setting for the subnetwork, controlling what - // traffic is diverted through it. - // - // Possible values: - // "EGRESS_SETTING_UNSPECIFIED" - No value set; apply default behavior - // "ALL_TRAFFIC" - Force all traffic to egress through the NetworkInterface - // (and configured VPC Network) - // "PRIVATE_IP_RANGES" - Force all Private IP Space traffic to egress through - // NetworkInterface (and configured VPC Network) - EgressSetting string `json:"egressSetting,omitempty"` - // NetworkTags: The network tags to apply to the instance. - NetworkTags []*VpcNetworkTag `json:"networkTags,omitempty"` - // SubnetworkKey: The subnetwork key. - SubnetworkKey *SubnetworkKey `json:"subnetworkKey,omitempty"` - // ForceSendFields is a list of field names (e.g. "EgressSetting") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "EgressSetting") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s VpcEgress) MarshalJSON() ([]byte, error) { - type NoMethod VpcEgress - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // VpcNetworkInterface: Network interface key message. type VpcNetworkInterface struct { // Network: Optional. The VPC network that the App Engine resource will be able @@ -3890,28 +3827,6 @@ func (s VpcNetworkInterface) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// VpcNetworkTag: Network tag message. -type VpcNetworkTag struct { - // Value: value for the tag name - Value string `json:"value,omitempty"` - // ForceSendFields is a list of field names (e.g. "Value") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Value") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s VpcNetworkTag) MarshalJSON() ([]byte, error) { - type NoMethod VpcNetworkTag - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ZipInfo: The zip file information for a zip deployment. type ZipInfo struct { // FilesCount: An estimate of the number of files in a zip for a zip diff --git a/apphub/v1/apphub-api.json b/apphub/v1/apphub-api.json index ea10b44c1d..69ab6891ef 100644 --- a/apphub/v1/apphub-api.json +++ b/apphub/v1/apphub-api.json @@ -188,7 +188,7 @@ ] }, "list": { - "description": "Lists information about the supported locations for this service.", + "description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "apphub.projects.locations.list", @@ -1486,7 +1486,7 @@ } } }, - "revision": "20260119", + "revision": "20260204", "rootUrl": "https://apphub.googleapis.com/", "schemas": { "Application": { diff --git a/apphub/v1/apphub-gen.go b/apphub/v1/apphub-gen.go index 3adb34ba7f..cda4bfd08e 100644 --- a/apphub/v1/apphub-gen.go +++ b/apphub/v1/apphub-gen.go @@ -2316,7 +2316,11 @@ type ProjectsLocationsListCall struct { header_ http.Header } -// List: Lists information about the supported locations for this service. +// List: Lists information about the supported locations for this service. This +// method can be called in two ways: * **List all public locations:** Use the +// path `GET /v1/locations`. * **List project-visible locations:** Use the path +// `GET /v1/projects/{project_id}/locations`. This may include public locations +// as well as private or other locations specifically visible to the project. // // - name: The resource that owns the locations collection, if applicable. func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { diff --git a/apphub/v1alpha/apphub-api.json b/apphub/v1alpha/apphub-api.json index 853456c24d..12a1c94cb8 100644 --- a/apphub/v1alpha/apphub-api.json +++ b/apphub/v1alpha/apphub-api.json @@ -188,7 +188,7 @@ ] }, "list": { - "description": "Lists information about the supported locations for this service.", + "description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1alpha/projects/{projectsId}/locations", "httpMethod": "GET", "id": "apphub.projects.locations.list", @@ -1578,7 +1578,7 @@ } } }, - "revision": "20260119", + "revision": "20260204", "rootUrl": "https://apphub.googleapis.com/", "schemas": { "Application": { diff --git a/apphub/v1alpha/apphub-gen.go b/apphub/v1alpha/apphub-gen.go index ffb0d187e6..a50981ee92 100644 --- a/apphub/v1alpha/apphub-gen.go +++ b/apphub/v1alpha/apphub-gen.go @@ -2381,7 +2381,11 @@ type ProjectsLocationsListCall struct { header_ http.Header } -// List: Lists information about the supported locations for this service. +// List: Lists information about the supported locations for this service. This +// method can be called in two ways: * **List all public locations:** Use the +// path `GET /v1/locations`. * **List project-visible locations:** Use the path +// `GET /v1/projects/{project_id}/locations`. This may include public locations +// as well as private or other locations specifically visible to the project. // // - name: The resource that owns the locations collection, if applicable. func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { diff --git a/calendar/v3/calendar-api.json b/calendar/v3/calendar-api.json index 09b40c2fbe..cf1a56235f 100644 --- a/calendar/v3/calendar-api.json +++ b/calendar/v3/calendar-api.json @@ -1890,7 +1890,7 @@ } } }, - "revision": "20251207", + "revision": "20260215", "rootUrl": "https://www.googleapis.com/", "schemas": { "Acl": { @@ -2511,7 +2511,7 @@ }, "conferenceData": { "$ref": "ConferenceData", - "description": "The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests." + "description": "The conference-related information, such as details of a Google Meet conference. To create new conference details use the createRequest field. To persist your changes, remember to set the conferenceDataVersion request parameter to 1 for all event modification requests. Warning: Reusing Google Meet conference data across different events can cause access issues and expose meeting details to unintended users. To help ensure meeting privacy, always generate a unique conference for each event by using the createRequest field." }, "created": { "description": "Creation time of the event (as a RFC3339 timestamp). Read-only.", diff --git a/calendar/v3/calendar-gen.go b/calendar/v3/calendar-gen.go index 0d77526d56..199271c491 100644 --- a/calendar/v3/calendar-gen.go +++ b/calendar/v3/calendar-gen.go @@ -1170,7 +1170,10 @@ type Event struct { // Google Meet conference. To create new conference details use the // createRequest field. To persist your changes, remember to set the // conferenceDataVersion request parameter to 1 for all event modification - // requests. + // requests. Warning: Reusing Google Meet conference data across different + // events can cause access issues and expose meeting details to unintended + // users. To help ensure meeting privacy, always generate a unique conference + // for each event by using the createRequest field. ConferenceData *ConferenceData `json:"conferenceData,omitempty"` // Created: Creation time of the event (as a RFC3339 timestamp). Read-only. Created string `json:"created,omitempty"` diff --git a/cloudfunctions/v2/cloudfunctions-api.json b/cloudfunctions/v2/cloudfunctions-api.json index d5d3072ac3..f7f2c0e76e 100644 --- a/cloudfunctions/v2/cloudfunctions-api.json +++ b/cloudfunctions/v2/cloudfunctions-api.json @@ -783,7 +783,7 @@ } } }, - "revision": "20260205", + "revision": "20260212", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AbortFunctionUpgradeRequest": { @@ -2275,6 +2275,22 @@ "COMMIT_FUNCTION_UPGRADE_AS_GEN2_SUCCESSFUL", "COMMIT_FUNCTION_UPGRADE_AS_GEN2_ERROR" ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + true, + false + ], "enumDescriptions": [ "Unspecified state. Most functions are in this upgrade state.", "Functions in this state are eligible for 1st Gen upgrade.", @@ -2288,7 +2304,7 @@ "RollbackFunctionUpgradeTraffic API was un-successful.", "CommitFunctionUpgrade API was un-successful and 1st gen function might have broken.", "CommitFunctionUpgrade API was un-successful but safe to rollback traffic or abort.", - "Indicates that the `CommitFunctionUpgradeAsGen2` API call succeeded and the function was successfully migrated to the 2nd Gen stack.", + "Deprecated: This state is no longer returned by the backend. Clients should not rely on polling for this specific state. A successful upgrade is now indicated by the long-running operation completing successfully with a Function resource in the response.", "CommitFunctionUpgradeAsGen2 API was un-successful and 1st gen function might have broken." ], "type": "string" diff --git a/cloudfunctions/v2/cloudfunctions-gen.go b/cloudfunctions/v2/cloudfunctions-gen.go index 7bb9c41f4d..945234cca1 100644 --- a/cloudfunctions/v2/cloudfunctions-gen.go +++ b/cloudfunctions/v2/cloudfunctions-gen.go @@ -2111,9 +2111,11 @@ type UpgradeInfo struct { // un-successful and 1st gen function might have broken. // "COMMIT_FUNCTION_UPGRADE_ERROR_ROLLBACK_SAFE" - CommitFunctionUpgrade API // was un-successful but safe to rollback traffic or abort. - // "COMMIT_FUNCTION_UPGRADE_AS_GEN2_SUCCESSFUL" - Indicates that the - // `CommitFunctionUpgradeAsGen2` API call succeeded and the function was - // successfully migrated to the 2nd Gen stack. + // "COMMIT_FUNCTION_UPGRADE_AS_GEN2_SUCCESSFUL" - Deprecated: This state is + // no longer returned by the backend. Clients should not rely on polling for + // this specific state. A successful upgrade is now indicated by the + // long-running operation completing successfully with a Function resource in + // the response. // "COMMIT_FUNCTION_UPGRADE_AS_GEN2_ERROR" - CommitFunctionUpgradeAsGen2 API // was un-successful and 1st gen function might have broken. UpgradeState string `json:"upgradeState,omitempty"` diff --git a/cloudfunctions/v2alpha/cloudfunctions-api.json b/cloudfunctions/v2alpha/cloudfunctions-api.json index 458e632daf..d9d4aaa19a 100644 --- a/cloudfunctions/v2alpha/cloudfunctions-api.json +++ b/cloudfunctions/v2alpha/cloudfunctions-api.json @@ -783,7 +783,7 @@ } } }, - "revision": "20260129", + "revision": "20260212", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AbortFunctionUpgradeRequest": { @@ -2275,6 +2275,22 @@ "COMMIT_FUNCTION_UPGRADE_AS_GEN2_SUCCESSFUL", "COMMIT_FUNCTION_UPGRADE_AS_GEN2_ERROR" ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + true, + false + ], "enumDescriptions": [ "Unspecified state. Most functions are in this upgrade state.", "Functions in this state are eligible for 1st Gen upgrade.", @@ -2288,7 +2304,7 @@ "RollbackFunctionUpgradeTraffic API was un-successful.", "CommitFunctionUpgrade API was un-successful and 1st gen function might have broken.", "CommitFunctionUpgrade API was un-successful but safe to rollback traffic or abort.", - "Indicates that the `CommitFunctionUpgradeAsGen2` API call succeeded and the function was successfully migrated to the 2nd Gen stack.", + "Deprecated: This state is no longer returned by the backend. Clients should not rely on polling for this specific state. A successful upgrade is now indicated by the long-running operation completing successfully with a Function resource in the response.", "CommitFunctionUpgradeAsGen2 API was un-successful and 1st gen function might have broken." ], "type": "string" diff --git a/cloudfunctions/v2alpha/cloudfunctions-gen.go b/cloudfunctions/v2alpha/cloudfunctions-gen.go index e06ca4b7bc..fe2f099201 100644 --- a/cloudfunctions/v2alpha/cloudfunctions-gen.go +++ b/cloudfunctions/v2alpha/cloudfunctions-gen.go @@ -2111,9 +2111,11 @@ type UpgradeInfo struct { // un-successful and 1st gen function might have broken. // "COMMIT_FUNCTION_UPGRADE_ERROR_ROLLBACK_SAFE" - CommitFunctionUpgrade API // was un-successful but safe to rollback traffic or abort. - // "COMMIT_FUNCTION_UPGRADE_AS_GEN2_SUCCESSFUL" - Indicates that the - // `CommitFunctionUpgradeAsGen2` API call succeeded and the function was - // successfully migrated to the 2nd Gen stack. + // "COMMIT_FUNCTION_UPGRADE_AS_GEN2_SUCCESSFUL" - Deprecated: This state is + // no longer returned by the backend. Clients should not rely on polling for + // this specific state. A successful upgrade is now indicated by the + // long-running operation completing successfully with a Function resource in + // the response. // "COMMIT_FUNCTION_UPGRADE_AS_GEN2_ERROR" - CommitFunctionUpgradeAsGen2 API // was un-successful and 1st gen function might have broken. UpgradeState string `json:"upgradeState,omitempty"` diff --git a/cloudfunctions/v2beta/cloudfunctions-api.json b/cloudfunctions/v2beta/cloudfunctions-api.json index 1cc42f547f..e530d33a8b 100644 --- a/cloudfunctions/v2beta/cloudfunctions-api.json +++ b/cloudfunctions/v2beta/cloudfunctions-api.json @@ -783,7 +783,7 @@ } } }, - "revision": "20260129", + "revision": "20260212", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AbortFunctionUpgradeRequest": { @@ -2275,6 +2275,22 @@ "COMMIT_FUNCTION_UPGRADE_AS_GEN2_SUCCESSFUL", "COMMIT_FUNCTION_UPGRADE_AS_GEN2_ERROR" ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + true, + false + ], "enumDescriptions": [ "Unspecified state. Most functions are in this upgrade state.", "Functions in this state are eligible for 1st Gen upgrade.", @@ -2288,7 +2304,7 @@ "RollbackFunctionUpgradeTraffic API was un-successful.", "CommitFunctionUpgrade API was un-successful and 1st gen function might have broken.", "CommitFunctionUpgrade API was un-successful but safe to rollback traffic or abort.", - "Indicates that the `CommitFunctionUpgradeAsGen2` API call succeeded and the function was successfully migrated to the 2nd Gen stack.", + "Deprecated: This state is no longer returned by the backend. Clients should not rely on polling for this specific state. A successful upgrade is now indicated by the long-running operation completing successfully with a Function resource in the response.", "CommitFunctionUpgradeAsGen2 API was un-successful and 1st gen function might have broken." ], "type": "string" diff --git a/cloudfunctions/v2beta/cloudfunctions-gen.go b/cloudfunctions/v2beta/cloudfunctions-gen.go index 7d41a80417..2b9b5e2e5c 100644 --- a/cloudfunctions/v2beta/cloudfunctions-gen.go +++ b/cloudfunctions/v2beta/cloudfunctions-gen.go @@ -2111,9 +2111,11 @@ type UpgradeInfo struct { // un-successful and 1st gen function might have broken. // "COMMIT_FUNCTION_UPGRADE_ERROR_ROLLBACK_SAFE" - CommitFunctionUpgrade API // was un-successful but safe to rollback traffic or abort. - // "COMMIT_FUNCTION_UPGRADE_AS_GEN2_SUCCESSFUL" - Indicates that the - // `CommitFunctionUpgradeAsGen2` API call succeeded and the function was - // successfully migrated to the 2nd Gen stack. + // "COMMIT_FUNCTION_UPGRADE_AS_GEN2_SUCCESSFUL" - Deprecated: This state is + // no longer returned by the backend. Clients should not rely on polling for + // this specific state. A successful upgrade is now indicated by the + // long-running operation completing successfully with a Function resource in + // the response. // "COMMIT_FUNCTION_UPGRADE_AS_GEN2_ERROR" - CommitFunctionUpgradeAsGen2 API // was un-successful and 1st gen function might have broken. UpgradeState string `json:"upgradeState,omitempty"` diff --git a/cloudkms/v1/cloudkms-api.json b/cloudkms/v1/cloudkms-api.json index 0f174f396f..6341e188c7 100644 --- a/cloudkms/v1/cloudkms-api.json +++ b/cloudkms/v1/cloudkms-api.json @@ -59,11 +59,6 @@ "endpointUrl": "https://cloudkms.us-west1.rep.googleapis.com/", "location": "us-west1" }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://cloudkms.us-east7.rep.googleapis.com/", - "location": "us-east7" - }, { "description": "Regional Endpoint", "endpointUrl": "https://cloudkms.us-central1.rep.googleapis.com/", @@ -99,6 +94,11 @@ "endpointUrl": "https://cloudkms.us-south1.rep.googleapis.com/", "location": "us-south1" }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://cloudkms.us-east7.rep.googleapis.com/", + "location": "us-east7" + }, { "description": "Regional Endpoint", "endpointUrl": "https://cloudkms.us.rep.googleapis.com/", @@ -2938,7 +2938,7 @@ } } }, - "revision": "20260206", + "revision": "20260213", "rootUrl": "https://cloudkms.googleapis.com/", "schemas": { "AddQuorumMember": { @@ -3952,6 +3952,11 @@ "description": "A Digest holds a cryptographic message digest.", "id": "Digest", "properties": { + "externalMu": { + "description": "A message digest produced with SHAKE-256, to be used with ML-DSA external-μ algorithms only. See \"message representative\" note in section 6.2, algorithm 7 of the FIPS-204 standard: https://doi.org/10.6028/nist.fips.204", + "format": "byte", + "type": "string" + }, "sha256": { "description": "A message digest produced with the SHA-256 algorithm.", "format": "byte", diff --git a/cloudkms/v1/cloudkms-gen.go b/cloudkms/v1/cloudkms-gen.go index 5f288783c7..4f572c8af8 100644 --- a/cloudkms/v1/cloudkms-gen.go +++ b/cloudkms/v1/cloudkms-gen.go @@ -1687,19 +1687,24 @@ type DestroyCryptoKeyVersionRequest struct { // Digest: A Digest holds a cryptographic message digest. type Digest struct { + // ExternalMu: A message digest produced with SHAKE-256, to be used with ML-DSA + // external-μ algorithms only. See "message representative" note in section + // 6.2, algorithm 7 of the FIPS-204 standard: + // https://doi.org/10.6028/nist.fips.204 + ExternalMu string `json:"externalMu,omitempty"` // Sha256: A message digest produced with the SHA-256 algorithm. Sha256 string `json:"sha256,omitempty"` // Sha384: A message digest produced with the SHA-384 algorithm. Sha384 string `json:"sha384,omitempty"` // Sha512: A message digest produced with the SHA-512 algorithm. Sha512 string `json:"sha512,omitempty"` - // ForceSendFields is a list of field names (e.g. "Sha256") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "ExternalMu") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Sha256") to include in API + // NullFields is a list of field names (e.g. "ExternalMu") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. diff --git a/cloudscheduler/v1/cloudscheduler-api.json b/cloudscheduler/v1/cloudscheduler-api.json index 17e71a2739..0f2b76ad33 100644 --- a/cloudscheduler/v1/cloudscheduler-api.json +++ b/cloudscheduler/v1/cloudscheduler-api.json @@ -160,7 +160,7 @@ ] }, "list": { - "description": "Lists information about the supported locations for this service.", + "description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "cloudscheduler.projects.locations.list", @@ -611,7 +611,7 @@ } } }, - "revision": "20251205", + "revision": "20260202", "rootUrl": "https://cloudscheduler.googleapis.com/", "schemas": { "AppEngineHttpTarget": { diff --git a/cloudscheduler/v1/cloudscheduler-gen.go b/cloudscheduler/v1/cloudscheduler-gen.go index 465adb86e2..4df58eec9b 100644 --- a/cloudscheduler/v1/cloudscheduler-gen.go +++ b/cloudscheduler/v1/cloudscheduler-gen.go @@ -1275,7 +1275,11 @@ type ProjectsLocationsListCall struct { header_ http.Header } -// List: Lists information about the supported locations for this service. +// List: Lists information about the supported locations for this service. This +// method can be called in two ways: * **List all public locations:** Use the +// path `GET /v1/locations`. * **List project-visible locations:** Use the path +// `GET /v1/projects/{project_id}/locations`. This may include public locations +// as well as private or other locations specifically visible to the project. // // - name: The resource that owns the locations collection, if applicable. func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { diff --git a/cloudscheduler/v1beta1/cloudscheduler-api.json b/cloudscheduler/v1beta1/cloudscheduler-api.json index 287f62792c..015da36ca3 100644 --- a/cloudscheduler/v1beta1/cloudscheduler-api.json +++ b/cloudscheduler/v1beta1/cloudscheduler-api.json @@ -135,7 +135,7 @@ ] }, "list": { - "description": "Lists information about the supported locations for this service.", + "description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1beta1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "cloudscheduler.projects.locations.list", @@ -567,7 +567,7 @@ } } }, - "revision": "20251205", + "revision": "20260202", "rootUrl": "https://cloudscheduler.googleapis.com/", "schemas": { "AppEngineHttpTarget": { diff --git a/cloudscheduler/v1beta1/cloudscheduler-gen.go b/cloudscheduler/v1beta1/cloudscheduler-gen.go index 9413579dbb..44af455dc9 100644 --- a/cloudscheduler/v1beta1/cloudscheduler-gen.go +++ b/cloudscheduler/v1beta1/cloudscheduler-gen.go @@ -1158,7 +1158,11 @@ type ProjectsLocationsListCall struct { header_ http.Header } -// List: Lists information about the supported locations for this service. +// List: Lists information about the supported locations for this service. This +// method can be called in two ways: * **List all public locations:** Use the +// path `GET /v1/locations`. * **List project-visible locations:** Use the path +// `GET /v1/projects/{project_id}/locations`. This may include public locations +// as well as private or other locations specifically visible to the project. // // - name: The resource that owns the locations collection, if applicable. func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { diff --git a/compute/v0.alpha/compute-api.json b/compute/v0.alpha/compute-api.json index e9e026fefe..9eadb0e45f 100644 --- a/compute/v0.alpha/compute-api.json +++ b/compute/v0.alpha/compute-api.json @@ -4010,7 +4010,7 @@ ] }, "update": { - "description": "Updates the specified disk with the data included in the request.\nThe update is performed only on selected fields included as part\nof update-mask. Only the following fields can be modified: user_license.", + "description": "Updates the specified disk with the data included in the request.\nThe update is performed only on selected fields included as part\nof update-mask.", "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", "httpMethod": "PATCH", "id": "compute.disks.update", @@ -30130,7 +30130,7 @@ ] }, "update": { - "description": "Update the specified disk with the data included in the request. Update is\nperformed only on selected fields included as part of update-mask. Only the\nfollowing fields can be modified: user_license.", + "description": "Update the specified disk with the data included in the request. Update is\nperformed only on selected fields included as part of update-mask.", "flatPath": "projects/{project}/regions/{region}/disks/{disk}", "httpMethod": "PATCH", "id": "compute.regionDisks.update", @@ -41530,7 +41530,7 @@ "methods": { "get": { "description": "Retrieves information about the specified reservation subBlock.", - "flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}", "httpMethod": "GET", "id": "compute.reservationSubBlocks.get", "parameterOrder": [ @@ -41543,6 +41543,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -41580,7 +41581,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}", + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}", "response": { "$ref": "ReservationSubBlocksGetResponse" }, @@ -41592,7 +41593,7 @@ }, "getVersion": { "description": "Allows customers to get SBOM versions of a reservation subBlock.", - "flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/getVersion", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/getVersion", "httpMethod": "POST", "id": "compute.reservationSubBlocks.getVersion", "parameterOrder": [ @@ -41605,6 +41606,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -41632,7 +41634,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/getVersion", + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/getVersion", "request": { "$ref": "ReservationSubBlocksGetVersionRequest" }, @@ -41646,7 +41648,7 @@ }, "list": { "description": "Retrieves a list of reservation subBlocks under a single reservation.", - "flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks", "httpMethod": "GET", "id": "compute.reservationSubBlocks.list", "parameterOrder": [ @@ -41681,6 +41683,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -41702,7 +41705,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks", + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks", "response": { "$ref": "ReservationSubBlocksListResponse" }, @@ -41714,7 +41717,7 @@ }, "performMaintenance": { "description": "Allows customers to perform maintenance on a reservation subBlock", - "flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", "httpMethod": "POST", "id": "compute.reservationSubBlocks.performMaintenance", "parameterOrder": [ @@ -41727,6 +41730,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -41754,7 +41758,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", "response": { "$ref": "Operation" }, @@ -41765,7 +41769,7 @@ }, "reportFaulty": { "description": "Allows customers to report a faulty subBlock.", - "flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", "httpMethod": "POST", "id": "compute.reservationSubBlocks.reportFaulty", "parameterOrder": [ @@ -41778,6 +41782,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -41805,7 +41810,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", "request": { "$ref": "ReservationSubBlocksReportFaultyRequest" }, @@ -54659,7 +54664,7 @@ } } }, - "revision": "20260206", + "revision": "20260213", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -56570,14 +56575,6 @@ "" ], "type": "string" - }, - "userLicenses": { - "description": "Output only. [Output Only] A list of user provided licenses. It represents a list of\nURLs to the license resource. Unlike regular licenses, user provided\nlicenses can be modified after the disk is created.", - "items": { - "type": "string" - }, - "readOnly": true, - "type": "array" } }, "type": "object" @@ -56704,7 +56701,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026 PATCH) when\nempty.", + "description": "Input only. Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026 PATCH) when\nempty.", "type": "object" }, "resourcePolicies": { @@ -63758,13 +63755,6 @@ "description": "URL of the disk type resource describing which disk type to use to create\nthe disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk\ntypes.", "type": "string" }, - "userLicenses": { - "description": "A list of publicly visible user-licenses. Unlike regular licenses, user\nprovided licenses can be modified after the disk is created. This includes\na list of URLs to the license resource. For example, to provide a debian\nlicense:\n\nhttps://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch", - "items": { - "type": "string" - }, - "type": "array" - }, "users": { "description": "Output only. [Output Only] Links to the users of the disk (attached instances)\nin form:projects/project/zones/zone/instances/instance", "items": { @@ -64263,7 +64253,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "description": "Input only. Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", "type": "object" } }, @@ -74849,13 +74839,6 @@ "type": "string" }, "type": "array" - }, - "userLicenses": { - "description": "A list of publicly visible user-licenses. Unlike regular licenses, user\nprovided licenses can be modified after the disk is created. This includes\na list of URLs to the license resource. For example, to provide a debian\nlicense:\n\nhttps://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch", - "items": { - "type": "string" - }, - "type": "array" } }, "type": "object" @@ -75035,7 +75018,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the image. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "description": "Input only. Resource manager tags to be bound to the image. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", "type": "object" } }, @@ -76971,7 +76954,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to bind to the managed instance group. The tags are\nkey-value pairs. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. For more information, seeManage tags\nfor resources.", + "description": "Input only. Resource manager tags to bind to the managed instance group. The tags are\nkey-value pairs. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. For more information, seeManage tags\nfor resources.", "type": "object" } }, @@ -79518,7 +79501,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "description": "Input only. Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", "type": "object" } }, @@ -79661,7 +79644,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and\nvalues are in the format `tagValues/456`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "description": "Input only. Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and\nvalues are in the format `tagValues/456`. The field is ignored (both PUT \u0026\nPATCH) when empty.", "type": "object" }, "resourcePolicies": { @@ -87366,7 +87349,7 @@ "additionalProperties": { "$ref": "LocationPolicyLocation" }, - "description": "Location configurations mapped by location name.\nCurrently only zone names are supported and must be represented as valid\ninternal URLs, such as zones/us-central1-a.", + "description": "Location configurations mapped by location name.\nCurrently only zone names are supported and must be represented as valid\ninternal URLs, such as zones/us-central1-a.\nThe bulkInsert operation doesn't create instances in an AI zone, even if\nan AI zone is available in the specified region. For example, if you set a\nDENY preference for us-central1-a, Compute Engine will consider\nus-central1-b and us-central1-c for instance creation, but not\nus-central1-ai1a. Also, you can't use the locations[] configuration to\nallow instance creation in an AI zone. To include an AI zone in bulkInsert\noperations, use the locationPolicy.zones[] field.", "type": "object" }, "targetShape": { @@ -87384,7 +87367,7 @@ "type": "string" }, "zones": { - "description": "List with zones where bulk will create instances.", + "description": "The bulkInsert operation applies any preferences set in the locations\nfield to the specific zones listed in the zones field if the same zones\nare specified in both fields.", "items": { "$ref": "LocationPolicyZoneConfiguration" }, @@ -87440,7 +87423,7 @@ "id": "LocationPolicyZoneConfiguration", "properties": { "zone": { - "description": "The URL of thezone.\nThe zone must exist in the region where the request is called.\nZones must be represented as valid internal URLs,\nsuch as zones/us-central1-a.", + "description": "The URL of the zone.\nThe zone must exist in the region where the request is called.\nZones must be represented as valid partial URLs,\nsuch as zones/us-central1-a.", "type": "string" } }, @@ -102348,13 +102331,6 @@ "type": "string" }, "type": "array" - }, - "userLicenses": { - "description": "[Output Only] A list of user provided licenses represented by a list of\nURLs to the license resource.", - "items": { - "type": "string" - }, - "type": "array" } }, "type": "object" @@ -115375,13 +115351,6 @@ "type": "string" }, "type": "array" - }, - "userLicenses": { - "description": "[Output Only] A list of user provided licenses represented by a list of\nURLs to the license resource.", - "items": { - "type": "string" - }, - "type": "array" } }, "type": "object" @@ -115848,7 +115817,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the snapshot. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "description": "Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", "type": "object" } }, @@ -126238,7 +126207,7 @@ "additionalProperties": { "$ref": "VmExtensionPolicyExtensionPolicy" }, - "description": "Required. A map of extension names (e.g., \"cloudops\") to their corresponding policy\nconfigurations.", + "description": "Required. A map of extension names (for example, \"ops-agent\") to their corresponding\npolicy configurations.", "type": "object" }, "globalResourceLink": { @@ -126281,7 +126250,7 @@ "type": "string" }, "priority": { - "description": "Optional. Priority of this policy. Used to resolve conflicts when multiple policies\napply to the same extension.\nThe policy priority is an integer from 0 to 65535, inclusive. Lower\nintegers indicate higher priorities. If you do not specify a priority when\ncreating a rule, it is assigned a priority of 1000. If priorities are\nequal, the policy with the more recent creation timestamp takes precedence.", + "description": "Optional. Priority of this policy. Used to resolve conflicts when multiple policies\napply to the same extension.\nThe policy priority is an integer from 0 to 65535, inclusive. Lower\nintegers indicate higher priorities. If you do not specify a priority when\ncreating a rule, it is assigned a priority of 1000. If priorities are\nequal, the policy with the most recent creation timestamp takes precedence.", "format": "int32", "type": "integer" }, @@ -126738,6 +126707,10 @@ ], "type": "string" }, + "healthMsg": { + "description": "The health status message of the extension.", + "type": "string" + }, "healthStatus": { "description": "The health status of the extension.", "enum": [ @@ -126766,10 +126739,6 @@ "description": "The id of the policy that is enforced on the extension.", "type": "string" }, - "unhealthyMsg": { - "description": "The status message of the extension if the extension is in unhealthy\nstate.", - "type": "string" - }, "version": { "description": "The version of the extension.", "type": "string" diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index a43ed1affc..bd354dd531 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -4238,12 +4238,6 @@ type AttachedDisk struct { // "PERSISTENT" // "SCRATCH" Type string `json:"type,omitempty"` - // UserLicenses: Output only. [Output Only] A list of user provided licenses. - // It represents a list of - // URLs to the license resource. Unlike regular licenses, user - // provided - // licenses can be modified after the disk is created. - UserLicenses []string `json:"userLicenses,omitempty"` // ForceSendFields is a list of field names (e.g. "Architecture") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -4395,8 +4389,8 @@ type AttachedDiskInitializeParams struct { // You must provide exactly two replica zones, and one zone must be the same // as the instance zone. ReplicaZones []string `json:"replicaZones,omitempty"` - // ResourceManagerTags: Resource manager tags to be bound to the disk. Tag keys - // and values + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // disk. Tag keys and values // have the same definition as resource // manager tags. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -15204,15 +15198,6 @@ type Disk struct { // disk // types. Type string `json:"type,omitempty"` - // UserLicenses: A list of publicly visible user-licenses. Unlike regular - // licenses, user - // provided licenses can be modified after the disk is created. This includes - // a list of URLs to the license resource. For example, to provide a - // debian - // license: - // - // https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - UserLicenses []string `json:"userLicenses,omitempty"` // Users: Output only. [Output Only] Links to the users of the disk (attached // instances) // in form:projects/project/zones/zone/instances/instance @@ -15908,8 +15893,8 @@ func (s DiskPairReplicationState) MarshalJSON() ([]byte, error) { // DiskParams: Additional disk params. type DiskParams struct { - // ResourceManagerTags: Resource manager tags to be bound to the disk. Tag keys - // and values + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // disk. Tag keys and values // have the same definition as resource // manager tags. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -30185,15 +30170,6 @@ type Image struct { // (regional or // multi-regional). StorageLocations []string `json:"storageLocations,omitempty"` - // UserLicenses: A list of publicly visible user-licenses. Unlike regular - // licenses, user - // provided licenses can be modified after the disk is created. This includes - // a list of URLs to the license resource. For example, to provide a - // debian - // license: - // - // https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - UserLicenses []string `json:"userLicenses,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -30474,8 +30450,8 @@ func (s ImageListWarningData) MarshalJSON() ([]byte, error) { // ImageParams: Additional image params. type ImageParams struct { - // ResourceManagerTags: Resource manager tags to be bound to the image. Tag - // keys and values have + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // image. Tag keys and values have // the same definition as resource // manager tags. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -32762,8 +32738,8 @@ func (s InstanceGroupManagerListWarningData) MarshalJSON() ([]byte, error) { // InstanceGroupManagerParams: Input only additional params for instance group // manager creation. type InstanceGroupManagerParams struct { - // ResourceManagerTags: Resource manager tags to bind to the managed instance - // group. The tags are + // ResourceManagerTags: Input only. Resource manager tags to bind to the + // managed instance group. The tags are // key-value pairs. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced // format such as `{org_id|project_id}/{tag_key_short_name}` @@ -36357,8 +36333,8 @@ type InstanceParams struct { // Relevant only for // Instances.Insert API. RequestValidForDuration *Duration `json:"requestValidForDuration,omitempty"` - // ResourceManagerTags: Resource manager tags to be bound to the instance. Tag - // keys and values + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // instance. Tag keys and values // have the same definition as resource // manager tags. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -36507,8 +36483,8 @@ type InstanceProperties struct { // from. // Note that for MachineImage, this is not supported yet. ReservationAffinity *ReservationAffinity `json:"reservationAffinity,omitempty"` - // ResourceManagerTags: Resource manager tags to be bound to the instance. Tag - // keys and values + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // instance. Tag keys and values // have the same definition as resource // manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and // values are in the format `tagValues/456`. The field is ignored (both PUT @@ -46141,6 +46117,17 @@ type LocationPolicy struct { // Currently only zone names are supported and must be represented as // valid // internal URLs, such as zones/us-central1-a. + // The bulkInsert operation doesn't create instances in an AI zone, even if + // an AI zone is available in the specified region. For example, if you set + // a + // DENY preference for us-central1-a, Compute Engine will + // consider + // us-central1-b and us-central1-c for instance creation, but + // not + // us-central1-ai1a. Also, you can't use the locations[] configuration to + // allow instance creation in an AI zone. To include an AI zone in + // bulkInsert + // operations, use the locationPolicy.zones[] field. Locations map[string]LocationPolicyLocation `json:"locations,omitempty"` // TargetShape: Strategy for distributing VMs across zones in a region. // @@ -46164,7 +46151,10 @@ type LocationPolicy struct { // failure. // Recommended for highly available serving workloads. TargetShape string `json:"targetShape,omitempty"` - // Zones: List with zones where bulk will create instances. + // Zones: The bulkInsert operation applies any preferences set in the + // locations + // field to the specific zones listed in the zones field if the same zones + // are specified in both fields. Zones []*LocationPolicyZoneConfiguration `json:"zones,omitempty"` // ForceSendFields is a list of field names (e.g. "Locations") to // unconditionally include in API requests. By default, fields with empty or @@ -46244,9 +46234,9 @@ func (s LocationPolicyLocationConstraints) MarshalJSON() ([]byte, error) { } type LocationPolicyZoneConfiguration struct { - // Zone: The URL of thezone. + // Zone: The URL of the zone. // The zone must exist in the region where the request is called. - // Zones must be represented as valid internal URLs, + // Zones must be represented as valid partial URLs, // such as zones/us-central1-a. Zone string `json:"zone,omitempty"` // ForceSendFields is a list of field names (e.g. "Zone") to unconditionally @@ -64012,10 +64002,6 @@ type RecoverableSnapshotOriginalSnapshot struct { // (regional or // multi-regional). StorageLocations []string `json:"storageLocations,omitempty"` - // UserLicenses: [Output Only] A list of user provided licenses represented by - // a list of - // URLs to the license resource. - UserLicenses []string `json:"userLicenses,omitempty"` // ForceSendFields is a list of field names (e.g. "Architecture") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -80245,10 +80231,6 @@ type Snapshot struct { // (regional or // multi-regional). StorageLocations []string `json:"storageLocations,omitempty"` - // UserLicenses: [Output Only] A list of user provided licenses represented by - // a list of - // URLs to the license resource. - UserLicenses []string `json:"userLicenses,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -80798,8 +80780,8 @@ func (s SnapshotListWarningData) MarshalJSON() ([]byte, error) { // SnapshotParams: Additional snapshot params. type SnapshotParams struct { - // ResourceManagerTags: Resource manager tags to be bound to the snapshot. Tag - // keys and values have + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // snapshot. Tag keys and values have // the same definition as resource // manager tags. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -93931,9 +93913,9 @@ type VmExtensionPolicy struct { CreationTimestamp string `json:"creationTimestamp,omitempty"` // Description: An optional description of this resource. Description string `json:"description,omitempty"` - // ExtensionPolicies: Required. A map of extension names (e.g., "cloudops") to - // their corresponding policy - // configurations. + // ExtensionPolicies: Required. A map of extension names (for example, + // "ops-agent") to their corresponding + // policy configurations. ExtensionPolicies map[string]VmExtensionPolicyExtensionPolicy `json:"extensionPolicies,omitempty"` // GlobalResourceLink: Optional. Output only. [Output Only] Link to the global // policy that manages this zone policy, if @@ -93973,7 +93955,7 @@ type VmExtensionPolicy struct { // integers indicate higher priorities. If you do not specify a priority // when // creating a rule, it is assigned a priority of 1000. If priorities are - // equal, the policy with the more recent creation timestamp takes precedence. + // equal, the policy with the most recent creation timestamp takes precedence. Priority int64 `json:"priority,omitempty"` // SelfLink: Output only. [Output Only] Server-defined fully-qualified URL for // this resource. @@ -94520,6 +94502,8 @@ type VmExtensionState struct { // recorded. // "SERVICE_DISABLED" - The service requiring this extension is disabled. EnforcementState string `json:"enforcementState,omitempty"` + // HealthMsg: The health status message of the extension. + HealthMsg string `json:"healthMsg,omitempty"` // HealthStatus: The health status of the extension. // // Possible values: @@ -94534,10 +94518,6 @@ type VmExtensionState struct { Name string `json:"name,omitempty"` // PolicyId: The id of the policy that is enforced on the extension. PolicyId string `json:"policyId,omitempty"` - // UnhealthyMsg: The status message of the extension if the extension is in - // unhealthy - // state. - UnhealthyMsg string `json:"unhealthyMsg,omitempty"` // Version: The version of the extension. Version string `json:"version,omitempty"` diff --git a/compute/v0.alpha/compute2-gen.go b/compute/v0.alpha/compute2-gen.go index 3a4c939425..85a109248b 100644 --- a/compute/v0.alpha/compute2-gen.go +++ b/compute/v0.alpha/compute2-gen.go @@ -12868,7 +12868,7 @@ type DisksUpdateCall struct { // Update: Updates the specified disk with the data included in the // request. // The update is performed only on selected fields included as part -// of update-mask. Only the following fields can be modified: user_license. +// of update-mask. // // - disk: The disk name for this request. // - project: Project ID for this request. diff --git a/compute/v0.alpha/compute3-gen.go b/compute/v0.alpha/compute3-gen.go index d81e64fbf9..be74e5f38c 100644 --- a/compute/v0.alpha/compute3-gen.go +++ b/compute/v0.alpha/compute3-gen.go @@ -2741,9 +2741,7 @@ type RegionDisksUpdateCall struct { // Update: Update the specified disk with the data included in the request. // Update is -// performed only on selected fields included as part of update-mask. Only -// the -// following fields can be modified: user_license. +// performed only on selected fields included as part of update-mask. // // - disk: The disk name for this request. // - project: Project ID for this request. @@ -37500,7 +37498,7 @@ func (c *ReservationSubBlocksGetCall) doRequest(alt string) (*http.Response, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -37643,7 +37641,7 @@ func (c *ReservationSubBlocksGetVersionCall) doRequest(alt string) (*http.Respon } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/getVersion") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/getVersion") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -37893,7 +37891,7 @@ func (c *ReservationSubBlocksListCall) doRequest(alt string) (*http.Response, er } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -38051,7 +38049,7 @@ func (c *ReservationSubBlocksPerformMaintenanceCall) doRequest(alt string) (*htt reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, nil) if err != nil { @@ -38193,7 +38191,7 @@ func (c *ReservationSubBlocksReportFaultyCall) doRequest(alt string) (*http.Resp } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { diff --git a/compute/v0.beta/compute-api.json b/compute/v0.beta/compute-api.json index 81595c7125..3ba887afe3 100644 --- a/compute/v0.beta/compute-api.json +++ b/compute/v0.beta/compute-api.json @@ -3882,7 +3882,7 @@ ] }, "update": { - "description": "Updates the specified disk with the data included in the request.\nThe update is performed only on selected fields included as part\nof update-mask. Only the following fields can be modified: user_license.", + "description": "Updates the specified disk with the data included in the request.\nThe update is performed only on selected fields included as part\nof update-mask.", "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", "httpMethod": "PATCH", "id": "compute.disks.update", @@ -9661,6 +9661,54 @@ "https://www.googleapis.com/auth/compute" ] }, + "configureAcceleratorTopologies": { + "description": "Updates the accelerator topologies configuration.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/configureAcceleratorTopologies", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.configureAcceleratorTopologies", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.\nIt should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of thezone\nwhere the managed instance group is located.\nIt should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/configureAcceleratorTopologies", + "request": { + "$ref": "InstanceGroupManagersConfigureAcceleratorTopologiesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, "createInstances": { "description": "Creates instances with per-instance configurations in this managed instance\ngroup. Instances are created using the current instance template. Thecreate instances operation is marked DONE if thecreateInstances request is successful. The underlying actions\ntake additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances\nmethod.", "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/createInstances", @@ -27943,7 +27991,7 @@ ] }, "update": { - "description": "Update the specified disk with the data included in the request. Update is\nperformed only on selected fields included as part of update-mask. Only the\nfollowing fields can be modified: user_license.", + "description": "Update the specified disk with the data included in the request. Update is\nperformed only on selected fields included as part of update-mask.", "flatPath": "projects/{project}/regions/{region}/disks/{disk}", "httpMethod": "PATCH", "id": "compute.regionDisks.update", @@ -38687,7 +38735,7 @@ "methods": { "get": { "description": "Retrieves information about the specified reservation subBlock.", - "flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}", "httpMethod": "GET", "id": "compute.reservationSubBlocks.get", "parameterOrder": [ @@ -38700,6 +38748,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -38737,7 +38786,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}", + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}", "response": { "$ref": "ReservationSubBlocksGetResponse" }, @@ -38749,7 +38798,7 @@ }, "getIamPolicy": { "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", - "flatPath": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/getIamPolicy", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/getIamPolicy", "httpMethod": "GET", "id": "compute.reservationSubBlocks.getIamPolicy", "parameterOrder": [ @@ -38794,7 +38843,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/getIamPolicy", + "path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/getIamPolicy", "response": { "$ref": "Policy" }, @@ -38806,7 +38855,7 @@ }, "list": { "description": "Retrieves a list of reservation subBlocks under a single reservation.", - "flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks", "httpMethod": "GET", "id": "compute.reservationSubBlocks.list", "parameterOrder": [ @@ -38841,6 +38890,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -38862,7 +38912,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks", + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks", "response": { "$ref": "ReservationSubBlocksListResponse" }, @@ -38874,7 +38924,7 @@ }, "performMaintenance": { "description": "Allows customers to perform maintenance on a reservation subBlock", - "flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", "httpMethod": "POST", "id": "compute.reservationSubBlocks.performMaintenance", "parameterOrder": [ @@ -38887,6 +38937,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -38914,7 +38965,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", "response": { "$ref": "Operation" }, @@ -38925,7 +38976,7 @@ }, "reportFaulty": { "description": "Allows customers to report a faulty subBlock.", - "flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", "httpMethod": "POST", "id": "compute.reservationSubBlocks.reportFaulty", "parameterOrder": [ @@ -38938,6 +38989,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -38965,7 +39017,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", "request": { "$ref": "ReservationSubBlocksReportFaultyRequest" }, @@ -38979,7 +39031,7 @@ }, "setIamPolicy": { "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", - "flatPath": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/setIamPolicy", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/setIamPolicy", "httpMethod": "POST", "id": "compute.reservationSubBlocks.setIamPolicy", "parameterOrder": [ @@ -39018,7 +39070,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/setIamPolicy", + "path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/setIamPolicy", "request": { "$ref": "ZoneSetNestedPolicyRequest" }, @@ -39032,7 +39084,7 @@ }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource.", - "flatPath": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/testIamPermissions", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/testIamPermissions", "httpMethod": "POST", "id": "compute.reservationSubBlocks.testIamPermissions", "parameterOrder": [ @@ -39071,7 +39123,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/testIamPermissions", + "path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/testIamPermissions", "request": { "$ref": "TestPermissionsRequest" }, @@ -40570,6 +40622,58 @@ "https://www.googleapis.com/auth/compute" ] }, + "deleteNamedSet": { + "description": "Deletes Named Set", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/deleteNamedSet", + "httpMethod": "POST", + "id": "compute.routers.deleteNamedSet", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "namedSet": { + "description": "The Named Set name for this request. Name must conform to RFC1035", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "router": { + "description": "Name of the Router resource where Named Set is defined.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/deleteNamedSet", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, "deleteRoutePolicy": { "description": "Deletes Route Policy", "flatPath": "projects/{project}/regions/{region}/routers/{router}/deleteRoutePolicy", @@ -40665,6 +40769,53 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, + "getNamedSet": { + "description": "Returns specified Named Set", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/getNamedSet", + "httpMethod": "GET", + "id": "compute.routers.getNamedSet", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "namedSet": { + "description": "The Named Set name for this request. Name must conform to RFC1035", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "router": { + "description": "Name of the Router resource to query for the named set. The name should\nconform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/getNamedSet", + "response": { + "$ref": "RoutersGetNamedSetResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, "getNatIpInfo": { "description": "Retrieves runtime NAT IP information.", "flatPath": "projects/{project}/regions/{region}/routers/{router}/getNatIpInfo", @@ -41102,11 +41253,11 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, - "listRoutePolicies": { - "description": "Retrieves a list of router route policy subresources available to the\nspecified project.", - "flatPath": "projects/{project}/regions/{region}/routers/{router}/listRoutePolicies", + "listNamedSets": { + "description": "Retrieves a list of router named set subresources available to the\nspecified project.", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/listNamedSets", "httpMethod": "GET", - "id": "compute.routers.listRoutePolicies", + "id": "compute.routers.listNamedSets", "parameterOrder": [ "project", "region", @@ -41163,9 +41314,9 @@ "type": "string" } }, - "path": "projects/{project}/regions/{region}/routers/{router}/listRoutePolicies", + "path": "projects/{project}/regions/{region}/routers/{router}/listNamedSets", "response": { - "$ref": "RoutersListRoutePolicies" + "$ref": "RoutersListNamedSets" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", @@ -41173,17 +41324,40 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, - "patch": { - "description": "Patches the specified Router resource with the data included in the\nrequest. This method supportsPATCH\nsemantics and usesJSON merge\npatch format and processing rules.", - "flatPath": "projects/{project}/regions/{region}/routers/{router}", - "httpMethod": "PATCH", - "id": "compute.routers.patch", + "listRoutePolicies": { + "description": "Retrieves a list of router route policy subresources available to the\nspecified project.", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/listRoutePolicies", + "httpMethod": "GET", + "id": "compute.routers.listRoutePolicies", "parameterOrder": [ "project", "region", "router" ], "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, "project": { "description": "Project ID for this request.", "location": "path", @@ -41198,36 +41372,34 @@ "required": true, "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", "location": "query", - "type": "string" + "type": "boolean" }, "router": { - "description": "Name of the Router resource to patch.", + "description": "Name or id of the resource for this request.\nName should conform to RFC1035.", "location": "path", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, - "path": "projects/{project}/regions/{region}/routers/{router}", - "request": { - "$ref": "Router" - }, + "path": "projects/{project}/regions/{region}/routers/{router}/listRoutePolicies", "response": { - "$ref": "Operation" + "$ref": "RoutersListRoutePolicies" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "patchRoutePolicy": { - "description": "Patches Route Policy", - "flatPath": "projects/{project}/regions/{region}/routers/{router}/patchRoutePolicy", - "httpMethod": "POST", - "id": "compute.routers.patchRoutePolicy", + "patch": { + "description": "Patches the specified Router resource with the data included in the\nrequest. This method supportsPATCH\nsemantics and usesJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/routers/{router}", + "httpMethod": "PATCH", + "id": "compute.routers.patch", "parameterOrder": [ "project", "region", @@ -41254,16 +41426,16 @@ "type": "string" }, "router": { - "description": "Name of the Router resource where Route Policy is defined.", + "description": "Name of the Router resource to patch.", "location": "path", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, - "path": "projects/{project}/regions/{region}/routers/{router}/patchRoutePolicy", + "path": "projects/{project}/regions/{region}/routers/{router}", "request": { - "$ref": "RoutePolicy" + "$ref": "Router" }, "response": { "$ref": "Operation" @@ -41273,11 +41445,11 @@ "https://www.googleapis.com/auth/compute" ] }, - "preview": { - "description": "Preview fields auto-generated during router create andupdate operations.\nCalling this method does NOT create or update the router.", - "flatPath": "projects/{project}/regions/{region}/routers/{router}/preview", + "patchNamedSet": { + "description": "Patches Named Set", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/patchNamedSet", "httpMethod": "POST", - "id": "compute.routers.preview", + "id": "compute.routers.patchNamedSet", "parameterOrder": [ "project", "region", @@ -41298,78 +41470,178 @@ "required": true, "type": "string" }, - "router": { - "description": "Name of the Router resource to query.", - "location": "path", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "required": true, - "type": "string" - } - }, - "path": "projects/{project}/regions/{region}/routers/{router}/preview", - "request": { - "$ref": "Router" - }, - "response": { - "$ref": "RoutersPreviewResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ] - }, - "testIamPermissions": { - "description": "Returns permissions that a caller has on the specified resource.", - "flatPath": "projects/{project}/regions/{region}/routers/{resource}/testIamPermissions", - "httpMethod": "POST", - "id": "compute.routers.testIamPermissions", - "parameterOrder": [ - "project", - "region", - "resource" - ], - "parameters": { - "project": { - "description": "Project ID for this request.", - "location": "path", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "location": "path", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "required": true, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", + "router": { + "description": "Name of the Router resource where Named Set is defined.", "location": "path", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, - "path": "projects/{project}/regions/{region}/routers/{resource}/testIamPermissions", + "path": "projects/{project}/regions/{region}/routers/{router}/patchNamedSet", "request": { - "$ref": "TestPermissionsRequest" + "$ref": "NamedSet" }, "response": { - "$ref": "TestPermissionsResponse" + "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "https://www.googleapis.com/auth/compute" ] }, - "update": { - "description": "Updates the specified Router resource with the data included in the\nrequest. This method conforms toPUT semantics, which requests that the state of the\ntarget resource be created or replaced with the state defined by the\nrepresentation enclosed in the request message payload.", - "flatPath": "projects/{project}/regions/{region}/routers/{router}", - "httpMethod": "PUT", - "id": "compute.routers.update", + "patchRoutePolicy": { + "description": "Patches Route Policy", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/patchRoutePolicy", + "httpMethod": "POST", + "id": "compute.routers.patchRoutePolicy", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "router": { + "description": "Name of the Router resource where Route Policy is defined.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/patchRoutePolicy", + "request": { + "$ref": "RoutePolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "preview": { + "description": "Preview fields auto-generated during router create andupdate operations.\nCalling this method does NOT create or update the router.", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/preview", + "httpMethod": "POST", + "id": "compute.routers.preview", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "router": { + "description": "Name of the Router resource to query.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/preview", + "request": { + "$ref": "Router" + }, + "response": { + "$ref": "RoutersPreviewResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/routers/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.routers.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{resource}/testIamPermissions", + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "update": { + "description": "Updates the specified Router resource with the data included in the\nrequest. This method conforms toPUT semantics, which requests that the state of the\ntarget resource be created or replaced with the state defined by the\nrepresentation enclosed in the request message payload.", + "flatPath": "projects/{project}/regions/{region}/routers/{router}", + "httpMethod": "PUT", + "id": "compute.routers.update", "parameterOrder": [ "project", "region", @@ -41415,6 +41687,56 @@ "https://www.googleapis.com/auth/compute" ] }, + "updateNamedSet": { + "description": "Updates or creates new Named Set", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/updateNamedSet", + "httpMethod": "POST", + "id": "compute.routers.updateNamedSet", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "router": { + "description": "Name of the Router resource where Named Set is defined.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/updateNamedSet", + "request": { + "$ref": "NamedSet" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, "updateRoutePolicy": { "description": "Updates or creates new Route Policy", "flatPath": "projects/{project}/regions/{region}/routers/{router}/updateRoutePolicy", @@ -42723,15 +43045,55 @@ } } }, - "snapshotSettings": { + "snapshotGroups": { "methods": { + "delete": { + "description": "Deletes the specified SnapshotGroup resource", + "flatPath": "projects/{project}/global/snapshotGroups/{snapshotGroup}", + "httpMethod": "DELETE", + "id": "compute.snapshotGroups.delete", + "parameterOrder": [ + "project", + "snapshotGroup" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "snapshotGroup": { + "description": "Name of the SnapshotGroup resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/snapshotGroups/{snapshotGroup}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, "get": { - "description": "Get snapshot settings.", - "flatPath": "projects/{project}/global/snapshotSettings", + "description": "returns the specified SnapshotGroup resource.", + "flatPath": "projects/{project}/global/snapshotGroups/{snapshotGroup}", "httpMethod": "GET", - "id": "compute.snapshotSettings.get", + "id": "compute.snapshotGroups.get", "parameterOrder": [ - "project" + "project", + "snapshotGroup" ], "parameters": { "project": { @@ -42740,11 +43102,18 @@ "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" + }, + "snapshotGroup": { + "description": "Name of the SnapshotGroup resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } }, - "path": "projects/{project}/global/snapshotSettings", + "path": "projects/{project}/global/snapshotGroups/{snapshotGroup}", "response": { - "$ref": "SnapshotSettings" + "$ref": "SnapshotGroup" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", @@ -42752,11 +43121,52 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, - "patch": { - "description": "Patch snapshot settings.", - "flatPath": "projects/{project}/global/snapshotSettings", - "httpMethod": "PATCH", - "id": "compute.snapshotSettings.patch", + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/global/snapshotGroups/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.snapshotGroups.getIamPolicy", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/snapshotGroups/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "insert": { + "description": "Creates a snapshot group in the specified project using the data included\nin the request.", + "flatPath": "projects/{project}/global/snapshotGroups", + "httpMethod": "POST", + "id": "compute.snapshotGroups.insert", "parameterOrder": [ "project" ], @@ -42772,17 +43182,11 @@ "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" - }, - "updateMask": { - "description": "update_mask indicates fields to be updated as part of this request.", - "format": "google-fieldmask", - "location": "query", - "type": "string" } }, - "path": "projects/{project}/global/snapshotSettings", + "path": "projects/{project}/global/snapshotGroups", "request": { - "$ref": "SnapshotSettings" + "$ref": "SnapshotGroup" }, "response": { "$ref": "Operation" @@ -42791,16 +43195,12 @@ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/compute" ] - } - } - }, - "snapshots": { - "methods": { - "aggregatedList": { - "description": "Retrieves an aggregated list of all of the snapshots in your project\nacross all regions and global scope.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", - "flatPath": "projects/{project}/aggregated/snapshots", + }, + "list": { + "description": "retrieves the list of SnapshotGroup resources contained within\nthe specified project.", + "flatPath": "projects/{project}/global/snapshotGroups", "httpMethod": "GET", - "id": "compute.snapshots.aggregatedList", + "id": "compute.snapshotGroups.list", "parameterOrder": [ "project" ], @@ -42810,11 +43210,216 @@ "location": "query", "type": "string" }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", - "location": "query", - "type": "boolean" - }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/snapshotGroups", + "response": { + "$ref": "ListSnapshotGroups" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/global/snapshotGroups/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.snapshotGroups.setIamPolicy", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/snapshotGroups/{resource}/setIamPolicy", + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/snapshotGroups/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.snapshotGroups.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/snapshotGroups/{resource}/testIamPermissions", + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + } + } + }, + "snapshotSettings": { + "methods": { + "get": { + "description": "Get snapshot settings.", + "flatPath": "projects/{project}/global/snapshotSettings", + "httpMethod": "GET", + "id": "compute.snapshotSettings.get", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/snapshotSettings", + "response": { + "$ref": "SnapshotSettings" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "patch": { + "description": "Patch snapshot settings.", + "flatPath": "projects/{project}/global/snapshotSettings", + "httpMethod": "PATCH", + "id": "compute.snapshotSettings.patch", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/snapshotSettings", + "request": { + "$ref": "SnapshotSettings" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + } + } + }, + "snapshots": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of all of the snapshots in your project\nacross all regions and global scope.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/snapshots", + "httpMethod": "GET", + "id": "compute.snapshots.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, "maxResults": { "default": "500", "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", @@ -50445,7 +51050,7 @@ } } }, - "revision": "20260206", + "revision": "20260213", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -52275,14 +52880,6 @@ "" ], "type": "string" - }, - "userLicenses": { - "description": "Output only. [Output Only] A list of user provided licenses. It represents a list of\nURLs to the license resource. Unlike regular licenses, user provided\nlicenses can be modified after the disk is created.", - "items": { - "type": "string" - }, - "readOnly": true, - "type": "array" } }, "type": "object" @@ -52386,7 +52983,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026 PATCH) when\nempty.", + "description": "Input only. Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026 PATCH) when\nempty.", "type": "object" }, "resourcePolicies": { @@ -53389,6 +53986,10 @@ "format": "float", "type": "number" }, + "orchestrationInfo": { + "$ref": "BackendBackendOrchestrationInfo", + "description": "Information about the resource or system that manages the backend." + }, "preference": { "description": "This field indicates whether this backend should be fully utilized before\nsending traffic to backends with default preference. The possible values\nare:\n \n - PREFERRED: Backends with this preference level will be\n filled up to their capacity limits first, based on RTT.\n - DEFAULT: If preferred backends don't have enough\n capacity, backends in this layer would be used and traffic would be\n assigned based on the load balancing algorithm you use. This is the\n default", "enum": [ @@ -53419,6 +54020,17 @@ }, "type": "object" }, + "BackendBackendOrchestrationInfo": { + "description": "A message containing information about the resource or system that manages\nthe backend.", + "id": "BackendBackendOrchestrationInfo", + "properties": { + "resourceUri": { + "description": "The URI of the resource or system that manages the backend.", + "type": "string" + } + }, + "type": "object" + }, "BackendBucket": { "description": "Represents a Cloud Storage Bucket resource.\n\nThis Cloud Storage bucket resource is referenced by a URL map of a load\nbalancer. For more information, readBackend Buckets.", "id": "BackendBucket", @@ -54542,6 +55154,10 @@ "$ref": "BackendServiceNetworkPassThroughLbTrafficPolicy", "description": "Configures traffic steering properties of internal passthrough Network\nLoad Balancers.\n\nnetworkPassThroughLbTrafficPolicy cannot be specified with haPolicy." }, + "orchestrationInfo": { + "$ref": "BackendServiceOrchestrationInfo", + "description": "Information about the resource or system that manages the backend service." + }, "outlierDetection": { "$ref": "OutlierDetection", "description": "Settings controlling the ejection of unhealthy backend endpoints from the\nload balancing pool of each individual proxy instance that processes the\ntraffic for the given backend service. If not set, this feature is\nconsidered disabled.\n\nResults of the outlier detection algorithm (ejection of endpoints from the\nload balancing pool and returning them back to the pool) are executed\nindependently by each proxy instance of the load balancer. In most cases,\nmore than one proxy instance handles the traffic received by a backend\nservice. Thus, it is possible that an unhealthy endpoint is detected and\nejected by only some of the proxies, and while this happens, other proxies\nmay continue to send requests to the same unhealthy endpoint until they\ndetect and eject the unhealthy endpoint.\n\nApplicable backend endpoints can be:\n \n - VM instances in an Instance Group\n - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)\n - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)\n - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud\n Functions Services \n - Private Service Connect NEGs, that resolve to\n Google-managed regional API endpoints or managed services published using\n Private Service Connect\n\n\n\nApplicable backend service types can be:\n \n - A global backend service with the loadBalancingScheme set to\n INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED. \n - A regional backend\n service with the serviceProtocol set to HTTP, HTTPS, HTTP2 or H2C, and\n loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not\n supported for Serverless NEGs.\n\n\n\nNot supported when the backend service is referenced by a URL map that is\nbound to target gRPC proxy that has validateForProxyless field set to true." @@ -55608,6 +56224,17 @@ }, "type": "object" }, + "BackendServiceOrchestrationInfo": { + "description": "A message containing information about the resource or system that manages\nthe backend service.", + "id": "BackendServiceOrchestrationInfo", + "properties": { + "resourceUri": { + "description": "The resource URI of the resource or system that manages the backend\nservice.", + "type": "string" + } + }, + "type": "object" + }, "BackendServiceParams": { "description": "Additional Backend Service parameters.", "id": "BackendServiceParams", @@ -56206,6 +56833,10 @@ "$ref": "InstantSnapshotGroupParameters", "description": "The parameters for the instant snapshot group." }, + "snapshotGroupParameters": { + "$ref": "SnapshotGroupParameters", + "description": "The parameters for the snapshot group." + }, "sourceConsistencyGroupPolicy": { "description": "The URL of the DiskConsistencyGroupPolicy for the group of disks to clone.\nThis may be a full or partial URL, such as:\n \n \n - \n https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy\n \n - \n projects/project/regions/region/resourcePolicies/resourcePolicy\n \n - \n regions/region/resourcePolicies/resourcePolicy", "type": "string" @@ -58672,13 +59303,6 @@ "description": "URL of the disk type resource describing which disk type to use to create\nthe disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk\ntypes.", "type": "string" }, - "userLicenses": { - "description": "A list of publicly visible user-licenses. Unlike regular licenses, user\nprovided licenses can be modified after the disk is created. This includes\na list of URLs to the license resource. For example, to provide a debian\nlicense:\n\nhttps://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch", - "items": { - "type": "string" - }, - "type": "array" - }, "users": { "description": "Output only. [Output Only] Links to the users of the disk (attached instances)\nin form:projects/project/zones/zone/instances/instance", "items": { @@ -59114,7 +59738,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "description": "Input only. Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", "type": "object" } }, @@ -67780,13 +68404,6 @@ "type": "string" }, "type": "array" - }, - "userLicenses": { - "description": "A list of publicly visible user-licenses. Unlike regular licenses, user\nprovided licenses can be modified after the disk is created. This includes\na list of URLs to the license resource. For example, to provide a debian\nlicense:\n\nhttps://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch", - "items": { - "type": "string" - }, - "type": "array" } }, "type": "object" @@ -67966,7 +68583,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the image. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "description": "Input only. Resource manager tags to be bound to the image. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", "type": "object" } }, @@ -69774,7 +70391,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to bind to the managed instance group. The tags are\nkey-value pairs. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. For more information, seeManage tags\nfor resources.", + "description": "Input only. Resource manager tags to bind to the managed instance group. The tags are\nkey-value pairs. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. For more information, seeManage tags\nfor resources.", "type": "object" } }, @@ -70657,6 +71274,30 @@ }, "type": "object" }, + "InstanceGroupManagersConfigureAcceleratorTopologiesRequest": { + "description": "InstanceGroupManagers.ConfigureAcceleratorTopologies", + "id": "InstanceGroupManagersConfigureAcceleratorTopologiesRequest", + "properties": { + "acceleratorTopologyActions": { + "additionalProperties": { + "enum": [ + "ACCELERATOR_TOPOLOGY_ACTION_UNSPECIFIED", + "ACTIVATE", + "DEACTIVATE" + ], + "enumDescriptions": [ + "Default value. Should not be used.", + "The accelerator topology is to be activated.", + "The accelerator topology is to be deactivated." + ], + "type": "string" + }, + "description": "Map of accelerator topologies that should have their state changed to\nthe specified value. The key is the hashed topology locus id. It can be\nobtained from the GetAvailableAcceleratorTopologies rpc.", + "type": "object" + } + }, + "type": "object" + }, "InstanceGroupManagersCreateInstancesRequest": { "description": "InstanceGroupManagers.createInstances", "id": "InstanceGroupManagersCreateInstancesRequest", @@ -70711,6 +71352,10 @@ }, "description": "The accelerator topology information returned per id of the topology\nlocation.", "type": "object" + }, + "multiMig": { + "description": "URL to MMIG this MIG belongs to.", + "type": "string" } }, "type": "object" @@ -70726,14 +71371,115 @@ "enum": [ "DEGRADED", "HEALTHY", - "UNHEALTHY" + "UNHEALTHY", + "UNKNOWN" ], "enumDescriptions": [ "All VM are in RUNNING state, but there is an issue with\nthe inter-chip connectivity that makes this part\nof the infrastructure ready to use as a working\ninter-chip connected group only in a degraded mode.\nThis is allowed only for Instances configured with ICI\nresiliency", "All VM are in RUNNING state, there are no issues with the\ninter-chip connectivity.", - "Some VMs may not be in RUNNING state, or there is an\nissue with the inter-chip connectivity that makes this\npart of the infrastructure unsuitable for forming a\nworking inter-chip connected group." + "Some VMs may not be in RUNNING state, or there is an\nissue with the inter-chip connectivity that makes this\npart of the infrastructure unsuitable for forming a\nworking inter-chip connected group.", + "No signal available" + ], + "type": "string" + }, + "acceleratorTopologyState": { + "$ref": "InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyState" + }, + "instancesHealth": { + "enum": [ + "ALL_HEALTHY", + "UNHEALTHY_OR_MISSING" + ], + "enumDescriptions": [ + "Infrastructure is healthy", + "Some VMs are in another state than RUNNING or they are missing." + ], + "type": "string" + }, + "parent": { + "description": "Identified by the topology Id in the accelerator_topology_info map. Empty\nfor the top-level topology", + "type": "string" + } + }, + "type": "object" + }, + "InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyState": { + "description": "Specifies the topology state", + "id": "InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyState", + "properties": { + "currentState": { + "enum": [ + "ACTIVATING", + "ACTIVE", + "ACTIVE_DEGRADED", + "DEACTIVATING", + "FAILED", + "INACTIVE", + "INCOMPLETE" + ], + "enumDescriptions": [ + "", + "", + "The topology is active but with potential performance degradation.", + "", + "Critical non-retriable error that the user has to act manually", + "", + "Not all VMs have been provisioned" ], "type": "string" + }, + "error": { + "description": "Reason why the topology state change failed", + "properties": { + "errors": { + "description": "[Output Only] The array of errors encountered while processing this\noperation.", + "items": { + "properties": { + "code": { + "description": "[Output Only] The error type identifier for this error.", + "type": "string" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error\ndetails. There is a set of defined message types to use for providing\ndetails.The syntax depends on the error code. For example,\nQuotaExceededInfo will have details when the error code is\nQUOTA_EXCEEDED.", + "items": { + "properties": { + "errorInfo": { + "$ref": "ErrorInfo" + }, + "help": { + "$ref": "Help" + }, + "localizedMessage": { + "$ref": "LocalizedMessage" + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo" + } + }, + "type": "object" + }, + "type": "array" + }, + "location": { + "description": "[Output Only] Indicates the field in the request that caused the error.\nThis property is optional.", + "type": "string" + }, + "message": { + "description": "[Output Only] An optional, human-readable error message.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + } + }, + "type": "object" + }, + "errorTimestamp": { + "description": "Timestamp when the last error happened", + "format": "google-datetime", + "type": "string" } }, "type": "object" @@ -72005,7 +72751,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "description": "Input only. Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", "type": "object" } }, @@ -72140,7 +72886,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and\nvalues are in the format `tagValues/456`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "description": "Input only. Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and\nvalues are in the format `tagValues/456`. The field is ignored (both PUT \u0026\nPATCH) when empty.", "type": "object" }, "resourcePolicies": { @@ -78479,6 +79225,174 @@ }, "type": "object" }, + "ListSnapshotGroups": { + "description": "Contains a list of SnapshotGroup resources.", + "id": "ListSnapshotGroups", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of SnapshotGroup resources.", + "items": { + "$ref": "SnapshotGroup" + }, + "type": "array" + }, + "kind": { + "default": "compute#snapshotGroupsList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + } + }, + "type": "object" + } + }, + "type": "object" + }, "LocalDisk": { "id": "LocalDisk", "properties": { @@ -78522,7 +79436,7 @@ "additionalProperties": { "$ref": "LocationPolicyLocation" }, - "description": "Location configurations mapped by location name.\nCurrently only zone names are supported and must be represented as valid\ninternal URLs, such as zones/us-central1-a.", + "description": "Location configurations mapped by location name.\nCurrently only zone names are supported and must be represented as valid\ninternal URLs, such as zones/us-central1-a.\nThe bulkInsert operation doesn't create instances in an AI zone, even if\nan AI zone is available in the specified region. For example, if you set a\nDENY preference for us-central1-a, Compute Engine will consider\nus-central1-b and us-central1-c for instance creation, but not\nus-central1-ai1a. Also, you can't use the locations[] configuration to\nallow instance creation in an AI zone. To include an AI zone in bulkInsert\noperations, use the locationPolicy.zones[] field.", "type": "object" }, "targetShape": { @@ -78538,6 +79452,13 @@ "GCE prioritizes acquisition of resources, scheduling VMs in zones\nwhere resources are available while distributing VMs as evenly as\npossible across allowed zones to minimize the impact of zonal failure.\nRecommended for highly available serving workloads." ], "type": "string" + }, + "zones": { + "description": "The bulkInsert operation applies any preferences set in the locations\nfield to the specific zones listed in the zones field if the same zones\nare specified in both fields.", + "items": { + "$ref": "LocationPolicyZoneConfiguration" + }, + "type": "array" } }, "type": "object" @@ -78578,6 +79499,16 @@ }, "type": "object" }, + "LocationPolicyZoneConfiguration": { + "id": "LocationPolicyZoneConfiguration", + "properties": { + "zone": { + "description": "The URL of the zone.\nThe zone must exist in the region where the request is called.\nZones must be represented as valid partial URLs,\nsuch as zones/us-central1-a.", + "type": "string" + } + }, + "type": "object" + }, "MachineImage": { "description": "Represents a machine image resource.\n\nA machine image is a Compute Engine resource that stores all the\nconfiguration, metadata, permissions, and data from one or more disks\nrequired to create a Virtual machine (VM) instance. For more information, seeMachine images.", "id": "MachineImage", @@ -80420,6 +81351,44 @@ }, "type": "object" }, + "NamedSet": { + "id": "NamedSet", + "properties": { + "description": { + "description": "An optional description of named set.", + "type": "string" + }, + "elements": { + "description": "CEL expressions that are comparable to constructs of this set's type\n(see Policy Language).", + "items": { + "$ref": "Expr" + }, + "type": "array" + }, + "fingerprint": { + "description": "A fingerprint for the Named Set being applied to this Router, which is\nessentially a hash of the Named Set used for optimistic locking.\nThe fingerprint is initially generated by Compute Engine and changes\nafter every request to modify or update the Named Set. You must always\nprovide an up-to-date fingerprint hash in order to update or change\nlabels.\n\nTo see the latest fingerprint, make a getNamedSet() request\nto retrieve a Named Set.", + "format": "byte", + "type": "string" + }, + "name": { + "description": "This set's name, which must be a resource ID segment and unique within all\nnamed sets owned by the Router. Name should conform to RFC1035.", + "type": "string" + }, + "type": { + "description": "This named set's type", + "enum": [ + "NAMED_SET_TYPE_COMMUNITY", + "NAMED_SET_TYPE_PREFIX" + ], + "enumDescriptions": [ + "The Named Set is a Community Named Set.", + "The Named Set is a Prefix Named Set." + ], + "type": "string" + } + }, + "type": "object" + }, "NatIpInfo": { "description": "Contains NAT IP information of a NAT config (i.e. usage status, mode).", "id": "NatIpInfo", @@ -93347,6 +94316,10 @@ "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" }, + "params": { + "$ref": "ReservationParams", + "description": "Input only. Additional params passed with the request, but not persisted\nas part of resource payload." + }, "protectionTier": { "description": "Protection tier for the workload which specifies the workload expectations\nin the event of infrastructure failures at data center (e.g. power\nand/or cooling failures).", "enum": [ @@ -94195,6 +95168,20 @@ }, "type": "object" }, + "ReservationParams": { + "description": "Additional reservation params.", + "id": "ReservationParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" + }, + "description": "Input only. Resource manager tags to be bound to the reservation. Tag keys and\nvalues have the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "type": "object" + } + }, + "type": "object" + }, "ReservationSlot": { "description": "Represents a reservation slot resource.", "id": "ReservationSlot", @@ -94247,13 +95234,15 @@ "ACTIVE", "CREATING", "DELETING", - "STATE_UNSPECIFIED" + "STATE_UNSPECIFIED", + "UNAVAILABLE" ], "enumDescriptions": [ "The reservation slot has allocated all its resources.", "The resources are being allocated for the reservation slot.", "The reservation slot is currently being deleted.", - "" + "", + "The reservation slot is currently unavailable." ], "readOnly": true, "type": "string" @@ -98981,6 +99970,19 @@ }, "type": "object" }, + "RoutersGetNamedSetResponse": { + "id": "RoutersGetNamedSetResponse", + "properties": { + "etag": { + "description": "end_interface: MixerGetResponseWithEtagBuilder", + "type": "string" + }, + "resource": { + "$ref": "NamedSet" + } + }, + "type": "object" + }, "RoutersGetRoutePolicyResponse": { "id": "RoutersGetRoutePolicyResponse", "properties": { @@ -99157,6 +100159,173 @@ }, "type": "object" }, + "RoutersListNamedSets": { + "id": "RoutersListNamedSets", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "type": "string" + }, + "kind": { + "default": "compute#routersListNamedSets", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#routersListNamedSets for lists of named sets.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "result": { + "description": "[Output Only] A list of named sets.", + "items": { + "$ref": "NamedSet" + }, + "type": "array" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + } + }, + "type": "object" + } + }, + "type": "object" + }, "RoutersListRoutePolicies": { "id": "RoutersListRoutePolicies", "properties": { @@ -102683,6 +103852,16 @@ "$ref": "CustomerEncryptionKey", "description": "Encrypts the snapshot using acustomer-supplied\nencryption key.\n\nAfter you encrypt a snapshot using a customer-supplied key, you must\nprovide the same key if you use the snapshot later. For example, you must\nprovide the encryption key when you create a disk from the encrypted\nsnapshot in a future request.\n\nCustomer-supplied encryption keys do not protect access to metadata\nof the snapshot.\n\nIf you do not provide an encryption key when creating the snapshot, then\nthe snapshot will be encrypted using an automatically generated key and you\ndo not need to provide a key to use the snapshot later." }, + "snapshotGroupId": { + "description": "Output only. [Output Only] The unique ID of the snapshot group that this snapshot\nbelongs to.", + "readOnly": true, + "type": "string" + }, + "snapshotGroupName": { + "description": "Output only. [Output only] The snapshot group that this snapshot belongs to.", + "readOnly": true, + "type": "string" + }, "snapshotType": { "description": "Indicates the type of the snapshot.", "enum": [ @@ -102779,13 +103958,6 @@ "type": "string" }, "type": "array" - }, - "userLicenses": { - "description": "[Output Only] A list of user provided licenses represented by a list of\nURLs to the license resource.", - "items": { - "type": "string" - }, - "type": "array" } }, "type": "object" @@ -102958,6 +104130,135 @@ }, "type": "object" }, + "SnapshotGroup": { + "description": "Represents a SnapshotGroup resource.\n\nA snapshot group is a set of snapshots that represents a point in time state\nof a consistency group.", + "id": "SnapshotGroup", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#snapshotGroup", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#snapshotGroup for SnapshotGroup\nresources.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Identifier. Name of the resource; provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource's resource id.", + "readOnly": true, + "type": "string" + }, + "sourceInfo": { + "$ref": "SnapshotGroupSourceInfo", + "description": "Output only. [Output Only]", + "readOnly": true + }, + "sourceInstantSnapshotGroup": { + "description": "Input field for the source instant snapshot group.", + "type": "string" + }, + "sourceInstantSnapshotGroupInfo": { + "$ref": "SnapshotGroupSourceInstantSnapshotGroupInfo", + "description": "Output only. [Output Only]", + "readOnly": true + }, + "status": { + "description": "Output only. [Output Only]", + "enum": [ + "CREATING", + "DELETING", + "FAILED", + "INVALID", + "READY", + "UNKNOWN", + "UPLOADING" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "" + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "SnapshotGroupParameters": { + "id": "SnapshotGroupParameters", + "properties": { + "replicaZones": { + "description": "URLs of the zones where disks should be replicated to. Only applicable\nfor regional resources.", + "items": { + "type": "string" + }, + "type": "array" + }, + "sourceSnapshotGroup": { + "description": "The source snapshot group used to create disks. You can provide this as a\npartial or full URL to the resource. For example, the following are valid\nvalues:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/snapshotGroups/snapshotGroup \n - projects/project/global/snapshotGroups/snapshotGroup\n - global/snapshotGroups/snapshotGroup", + "type": "string" + }, + "type": { + "description": "URL of the disk type resource describing which disk type to use to create\ndisks. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk\ntypes.", + "type": "string" + } + }, + "type": "object" + }, + "SnapshotGroupSourceInfo": { + "id": "SnapshotGroupSourceInfo", + "properties": { + "consistencyGroup": { + "readOnly": true, + "type": "string" + }, + "consistencyGroupId": { + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "SnapshotGroupSourceInstantSnapshotGroupInfo": { + "id": "SnapshotGroupSourceInstantSnapshotGroupInfo", + "properties": { + "instantSnapshotGroup": { + "readOnly": true, + "type": "string" + }, + "instantSnapshotGroupId": { + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "SnapshotList": { "description": "Contains a list of Snapshot resources.", "id": "SnapshotList", @@ -103123,7 +104424,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the snapshot. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "description": "Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", "type": "object" } }, @@ -113106,7 +114407,7 @@ "additionalProperties": { "$ref": "VmExtensionPolicyExtensionPolicy" }, - "description": "Required. A map of extension names (e.g., \"cloudops\") to their corresponding policy\nconfigurations.", + "description": "Required. A map of extension names (for example, \"ops-agent\") to their corresponding\npolicy configurations.", "type": "object" }, "globalResourceLink": { @@ -113149,7 +114450,7 @@ "type": "string" }, "priority": { - "description": "Optional. Priority of this policy. Used to resolve conflicts when multiple policies\napply to the same extension.\nThe policy priority is an integer from 0 to 65535, inclusive. Lower\nintegers indicate higher priorities. If you do not specify a priority when\ncreating a rule, it is assigned a priority of 1000. If priorities are\nequal, the policy with the more recent creation timestamp takes precedence.", + "description": "Optional. Priority of this policy. Used to resolve conflicts when multiple policies\napply to the same extension.\nThe policy priority is an integer from 0 to 65535, inclusive. Lower\nintegers indicate higher priorities. If you do not specify a priority when\ncreating a rule, it is assigned a priority of 1000. If priorities are\nequal, the policy with the most recent creation timestamp takes precedence.", "format": "int32", "type": "integer" }, diff --git a/compute/v0.beta/compute-gen.go b/compute/v0.beta/compute-gen.go index a93f803cc9..8a078878c4 100644 --- a/compute/v0.beta/compute-gen.go +++ b/compute/v0.beta/compute-gen.go @@ -254,6 +254,7 @@ func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, err s.Routes = NewRoutesService(s) s.SecurityPolicies = NewSecurityPoliciesService(s) s.ServiceAttachments = NewServiceAttachmentsService(s) + s.SnapshotGroups = NewSnapshotGroupsService(s) s.SnapshotSettings = NewSnapshotSettingsService(s) s.Snapshots = NewSnapshotsService(s) s.SslCertificates = NewSslCertificatesService(s) @@ -516,6 +517,8 @@ type Service struct { ServiceAttachments *ServiceAttachmentsService + SnapshotGroups *SnapshotGroupsService + SnapshotSettings *SnapshotSettingsService Snapshots *SnapshotsService @@ -1540,6 +1543,15 @@ type ServiceAttachmentsService struct { s *Service } +func NewSnapshotGroupsService(s *Service) *SnapshotGroupsService { + rs := &SnapshotGroupsService{s: s} + return rs +} + +type SnapshotGroupsService struct { + s *Service +} + func NewSnapshotSettingsService(s *Service) *SnapshotSettingsService { rs := &SnapshotSettingsService{s: s} return rs @@ -4016,12 +4028,6 @@ type AttachedDisk struct { // "PERSISTENT" // "SCRATCH" Type string `json:"type,omitempty"` - // UserLicenses: Output only. [Output Only] A list of user provided licenses. - // It represents a list of - // URLs to the license resource. Unlike regular licenses, user - // provided - // licenses can be modified after the disk is created. - UserLicenses []string `json:"userLicenses,omitempty"` // ForceSendFields is a list of field names (e.g. "Architecture") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -4160,8 +4166,8 @@ type AttachedDiskInitializeParams struct { // You must provide exactly two replica zones, and one zone must be the same // as the instance zone. ReplicaZones []string `json:"replicaZones,omitempty"` - // ResourceManagerTags: Resource manager tags to be bound to the disk. Tag keys - // and values + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // disk. Tag keys and values // have the same definition as resource // manager tags. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -5843,6 +5849,9 @@ type Backend struct { // For usage guidelines, seeUtilization // balancing mode. MaxUtilization float64 `json:"maxUtilization,omitempty"` + // OrchestrationInfo: Information about the resource or system that manages the + // backend. + OrchestrationInfo *BackendBackendOrchestrationInfo `json:"orchestrationInfo,omitempty"` // Preference: This field indicates whether this backend should be fully // utilized before // sending traffic to backends with default preference. The possible @@ -5907,6 +5916,30 @@ func (s *Backend) UnmarshalJSON(data []byte) error { return nil } +// BackendBackendOrchestrationInfo: A message containing information about the +// resource or system that manages +// the backend. +type BackendBackendOrchestrationInfo struct { + // ResourceUri: The URI of the resource or system that manages the backend. + ResourceUri string `json:"resourceUri,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResourceUri") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ResourceUri") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s BackendBackendOrchestrationInfo) MarshalJSON() ([]byte, error) { + type NoMethod BackendBackendOrchestrationInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // BackendBucket: Represents a Cloud Storage Bucket resource. // // This Cloud Storage bucket resource is referenced by a URL map of a @@ -7630,6 +7663,9 @@ type BackendService struct { // // networkPassThroughLbTrafficPolicy cannot be specified with haPolicy. NetworkPassThroughLbTrafficPolicy *BackendServiceNetworkPassThroughLbTrafficPolicy `json:"networkPassThroughLbTrafficPolicy,omitempty"` + // OrchestrationInfo: Information about the resource or system that manages the + // backend service. + OrchestrationInfo *BackendServiceOrchestrationInfo `json:"orchestrationInfo,omitempty"` // OutlierDetection: Settings controlling the ejection of unhealthy backend // endpoints from the // load balancing pool of each individual proxy instance that processes @@ -9543,6 +9579,32 @@ func (s *BackendServiceNetworkPassThroughLbTrafficPolicyZonalAffinity) Unmarshal return nil } +// BackendServiceOrchestrationInfo: A message containing information about the +// resource or system that manages +// the backend service. +type BackendServiceOrchestrationInfo struct { + // ResourceUri: The resource URI of the resource or system that manages the + // backend + // service. + ResourceUri string `json:"resourceUri,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResourceUri") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ResourceUri") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s BackendServiceOrchestrationInfo) MarshalJSON() ([]byte, error) { + type NoMethod BackendServiceOrchestrationInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // BackendServiceParams: Additional Backend Service parameters. type BackendServiceParams struct { // ResourceManagerTags: Tag keys/values directly bound to this resource. @@ -10407,6 +10469,8 @@ type BulkInsertDiskResource struct { // InstantSnapshotGroupParameters: The parameters for the instant snapshot // group. InstantSnapshotGroupParameters *InstantSnapshotGroupParameters `json:"instantSnapshotGroupParameters,omitempty"` + // SnapshotGroupParameters: The parameters for the snapshot group. + SnapshotGroupParameters *SnapshotGroupParameters `json:"snapshotGroupParameters,omitempty"` // SourceConsistencyGroupPolicy: The URL of the DiskConsistencyGroupPolicy for // the group of disks to clone. // This may be a full or partial URL, such as: @@ -13877,15 +13941,6 @@ type Disk struct { // disk // types. Type string `json:"type,omitempty"` - // UserLicenses: A list of publicly visible user-licenses. Unlike regular - // licenses, user - // provided licenses can be modified after the disk is created. This includes - // a list of URLs to the license resource. For example, to provide a - // debian - // license: - // - // https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - UserLicenses []string `json:"userLicenses,omitempty"` // Users: Output only. [Output Only] Links to the users of the disk (attached // instances) // in form:projects/project/zones/zone/instances/instance @@ -14476,8 +14531,8 @@ func (s DiskMoveRequest) MarshalJSON() ([]byte, error) { // DiskParams: Additional disk params. type DiskParams struct { - // ResourceManagerTags: Resource manager tags to be bound to the disk. Tag keys - // and values + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // disk. Tag keys and values // have the same definition as resource // manager tags. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -26344,15 +26399,6 @@ type Image struct { // (regional or // multi-regional). StorageLocations []string `json:"storageLocations,omitempty"` - // UserLicenses: A list of publicly visible user-licenses. Unlike regular - // licenses, user - // provided licenses can be modified after the disk is created. This includes - // a list of URLs to the license resource. For example, to provide a - // debian - // license: - // - // https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-9-stretch - UserLicenses []string `json:"userLicenses,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -26633,8 +26679,8 @@ func (s ImageListWarningData) MarshalJSON() ([]byte, error) { // ImageParams: Additional image params. type ImageParams struct { - // ResourceManagerTags: Resource manager tags to be bound to the image. Tag - // keys and values have + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // image. Tag keys and values have // the same definition as resource // manager tags. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -28765,8 +28811,8 @@ func (s InstanceGroupManagerListWarningData) MarshalJSON() ([]byte, error) { // InstanceGroupManagerParams: Input only additional params for instance group // manager creation. type InstanceGroupManagerParams struct { - // ResourceManagerTags: Resource manager tags to bind to the managed instance - // group. The tags are + // ResourceManagerTags: Input only. Resource manager tags to bind to the + // managed instance group. The tags are // key-value pairs. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced // format such as `{org_id|project_id}/{tag_key_short_name}` @@ -30122,6 +30168,33 @@ func (s InstanceGroupManagersApplyUpdatesRequest) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// InstanceGroupManagersConfigureAcceleratorTopologiesRequest: +// InstanceGroupManagers.ConfigureAcceleratorTopologies +type InstanceGroupManagersConfigureAcceleratorTopologiesRequest struct { + // AcceleratorTopologyActions: Map of accelerator topologies that should have + // their state changed to + // the specified value. The key is the hashed topology locus id. It can + // be + // obtained from the GetAvailableAcceleratorTopologies rpc. + AcceleratorTopologyActions map[string]string `json:"acceleratorTopologyActions,omitempty"` + // ForceSendFields is a list of field names (e.g. "AcceleratorTopologyActions") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AcceleratorTopologyActions") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InstanceGroupManagersConfigureAcceleratorTopologiesRequest) MarshalJSON() ([]byte, error) { + type NoMethod InstanceGroupManagersConfigureAcceleratorTopologiesRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // InstanceGroupManagersCreateInstancesRequest: // InstanceGroupManagers.createInstances type InstanceGroupManagersCreateInstancesRequest struct { @@ -30213,6 +30286,8 @@ type InstanceGroupManagersGetAvailableAcceleratorTopologiesResponse struct { // id of the topology // location. AcceleratorTopologiesInfo map[string]InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyInfo `json:"acceleratorTopologiesInfo,omitempty"` + // MultiMig: URL to MMIG this MIG belongs to. + MultiMig string `json:"multiMig,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -30251,7 +30326,18 @@ type InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTo // issue with the inter-chip connectivity that makes this // part of the infrastructure unsuitable for forming a // working inter-chip connected group. - AcceleratorTopologyHealth string `json:"acceleratorTopologyHealth,omitempty"` + // "UNKNOWN" - No signal available + AcceleratorTopologyHealth string `json:"acceleratorTopologyHealth,omitempty"` + AcceleratorTopologyState *InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyState `json:"acceleratorTopologyState,omitempty"` + // Possible values: + // "ALL_HEALTHY" - Infrastructure is healthy + // "UNHEALTHY_OR_MISSING" - Some VMs are in another state than RUNNING or + // they are missing. + InstancesHealth string `json:"instancesHealth,omitempty"` + // Parent: Identified by the topology Id in the accelerator_topology_info map. + // Empty + // for the top-level topology + Parent string `json:"parent,omitempty"` // ForceSendFields is a list of field names (e.g. "AcceleratorTopology") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -30270,6 +30356,124 @@ func (s InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAccelerato return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopo +// logyState: Specifies the topology state +type InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyState struct { + // Possible values: + // "ACTIVATING" + // "ACTIVE" + // "ACTIVE_DEGRADED" - The topology is active but with potential performance + // degradation. + // "DEACTIVATING" + // "FAILED" - Critical non-retriable error that the user has to act manually + // "INACTIVE" + // "INCOMPLETE" - Not all VMs have been provisioned + CurrentState string `json:"currentState,omitempty"` + // Error: Reason why the topology state change failed + Error *InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyStateError `json:"error,omitempty"` + // ErrorTimestamp: Timestamp when the last error happened + ErrorTimestamp string `json:"errorTimestamp,omitempty"` + // ForceSendFields is a list of field names (e.g. "CurrentState") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CurrentState") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyState) MarshalJSON() ([]byte, error) { + type NoMethod InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyState + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopo +// logyStateError: Reason why the topology state change failed +type InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyStateError struct { + // Errors: [Output Only] The array of errors encountered while processing + // this + // operation. + Errors []*InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyStateErrorErrors `json:"errors,omitempty"` + // ForceSendFields is a list of field names (e.g. "Errors") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Errors") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyStateError) MarshalJSON() ([]byte, error) { + type NoMethod InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyStateError + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyStateErrorErrors struct { + // Code: [Output Only] The error type identifier for this error. + Code string `json:"code,omitempty"` + // ErrorDetails: [Output Only] An optional list of messages that contain the + // error + // details. There is a set of defined message types to use for + // providing + // details.The syntax depends on the error code. For example, + // QuotaExceededInfo will have details when the error code is + // QUOTA_EXCEEDED. + ErrorDetails []*InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyStateErrorErrorsErrorDetails `json:"errorDetails,omitempty"` + // Location: [Output Only] Indicates the field in the request that caused the + // error. + // This property is optional. + Location string `json:"location,omitempty"` + // Message: [Output Only] An optional, human-readable error message. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Code") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyStateErrorErrors) MarshalJSON() ([]byte, error) { + type NoMethod InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyStateErrorErrors + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyStateErrorErrorsErrorDetails struct { + ErrorInfo *ErrorInfo `json:"errorInfo,omitempty"` + Help *Help `json:"help,omitempty"` + LocalizedMessage *LocalizedMessage `json:"localizedMessage,omitempty"` + QuotaInfo *QuotaExceededInfo `json:"quotaInfo,omitempty"` + // ForceSendFields is a list of field names (e.g. "ErrorInfo") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ErrorInfo") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyStateErrorErrorsErrorDetails) MarshalJSON() ([]byte, error) { + type NoMethod InstanceGroupManagersGetAvailableAcceleratorTopologiesResponseAcceleratorTopologyStateErrorErrorsErrorDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type InstanceGroupManagersListErrorsResponse struct { // Items: Output only. [Output Only] The list of errors of the managed instance // group. @@ -31979,8 +32183,8 @@ type InstanceParams struct { // Relevant only for // Instances.Insert API. RequestValidForDuration *Duration `json:"requestValidForDuration,omitempty"` - // ResourceManagerTags: Resource manager tags to be bound to the instance. Tag - // keys and values + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // instance. Tag keys and values // have the same definition as resource // manager tags. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -32127,8 +32331,8 @@ type InstanceProperties struct { // from. // Note that for MachineImage, this is not supported yet. ReservationAffinity *ReservationAffinity `json:"reservationAffinity,omitempty"` - // ResourceManagerTags: Resource manager tags to be bound to the instance. Tag - // keys and values + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // instance. Tag keys and values // have the same definition as resource // manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and // values are in the format `tagValues/456`. The field is ignored (both PUT @@ -40136,6 +40340,191 @@ func (s ListInstantSnapshotGroupsWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ListSnapshotGroups: Contains a list of SnapshotGroup resources. +type ListSnapshotGroups struct { + Etag string `json:"etag,omitempty"` + // Id: [Output Only] Unique identifier for the resource; defined by the server. + Id string `json:"id,omitempty"` + // Items: A list of SnapshotGroup resources. + Items []*SnapshotGroup `json:"items,omitempty"` + // Kind: Output only. Type of resource. + Kind string `json:"kind,omitempty"` + // NextPageToken: [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value for + // the query parameter pageToken in the next list request. + // Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + NextPageToken string `json:"nextPageToken,omitempty"` + // SelfLink: Output only. [Output Only] Server-defined URL for this resource. + SelfLink string `json:"selfLink,omitempty"` + // Unreachables: Output only. [Output Only] Unreachable + // resources. + // end_interface: MixerListResponseWithEtagBuilder + Unreachables []string `json:"unreachables,omitempty"` + // Warning: [Output Only] Informational warning message. + Warning *ListSnapshotGroupsWarning `json:"warning,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Etag") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Etag") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ListSnapshotGroups) MarshalJSON() ([]byte, error) { + type NoMethod ListSnapshotGroups + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListSnapshotGroupsWarning: [Output Only] Informational warning message. +type ListSnapshotGroupsWarning struct { + // Code: [Output Only] A warning code, if applicable. For example, + // Compute + // Engine returns NO_RESULTS_ON_PAGE if there + // are no results in the response. + // + // Possible values: + // "CLEANUP_FAILED" - Warning about failed cleanup of transient changes made + // by a failed + // operation. + // "DEPRECATED_RESOURCE_USED" - A link to a deprecated resource was created. + // "DEPRECATED_TYPE_USED" - When deploying and at least one of the resources + // has a type marked as + // deprecated + // "DISK_SIZE_LARGER_THAN_IMAGE_SIZE" - The user created a boot disk that is + // larger than image size. + // "EXPERIMENTAL_TYPE_USED" - When deploying and at least one of the + // resources has a type marked as + // experimental + // "EXTERNAL_API_WARNING" - Warning that is present in an external api call + // "FIELD_VALUE_OVERRIDEN" - Warning that value of a field has been + // overridden. + // Deprecated unused field. + // "INJECTED_KERNELS_DEPRECATED" - The operation involved use of an injected + // kernel, which is deprecated. + // "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB" - A WEIGHTED_MAGLEV backend + // service is associated with a health check that is + // not of type HTTP/HTTPS/HTTP2. + // "LARGE_DEPLOYMENT_WARNING" - When deploying a deployment with a + // exceedingly large number of resources + // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list + // overhead quota exceed + // which captures the amount of resources filtered out by + // user-defined list filter. + // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type + // "NEXT_HOP_ADDRESS_NOT_ASSIGNED" - The route's nextHopIp address is not + // assigned to an instance on the + // network. + // "NEXT_HOP_CANNOT_IP_FORWARD" - The route's next hop instance cannot ip + // forward. + // "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE" - The route's nextHopInstance + // URL refers to an instance that does not have an + // ipv6 interface on the same network as the route. + // "NEXT_HOP_INSTANCE_NOT_FOUND" - The route's nextHopInstance URL refers to + // an instance that does not exist. + // "NEXT_HOP_INSTANCE_NOT_ON_NETWORK" - The route's nextHopInstance URL + // refers to an instance that is not on the + // same network as the route. + // "NEXT_HOP_NOT_RUNNING" - The route's next hop instance does not have a + // status of RUNNING. + // "NOT_CRITICAL_ERROR" - Error which is not critical. We decided to continue + // the process despite + // the mentioned error. + // "NO_RESULTS_ON_PAGE" - No results are present on a particular list page. + // "PARTIAL_SUCCESS" - Success is reported, but some results may be missing + // due to errors + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: + // regions.list). + // "REQUIRED_TOS_AGREEMENT" - The user attempted to use a resource that + // requires a TOS they have not + // accepted. + // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is + // in use. + // "RESOURCE_NOT_DELETED" - One or more of the resources set to auto-delete + // could not be deleted + // because they were in use. + // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is + // ignored. + // "SINGLE_INSTANCE_PROPERTY_TEMPLATE" - Instance template used in instance + // group manager is valid as such, but + // its application does not make a lot of sense, because it allows only + // single instance in instance group. + // "UNDECLARED_PROPERTIES" - When undeclared properties in the schema are + // present + // "UNREACHABLE" - A given scope cannot be reached. + Code string `json:"code,omitempty"` + // Data: [Output Only] Metadata about this warning in key: + // value format. For example: + // + // "data": [ + // { + // "key": "scope", + // "value": "zones/us-east1-d" + // } + Data []*ListSnapshotGroupsWarningData `json:"data,omitempty"` + // Message: [Output Only] A human-readable description of the warning code. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Code") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ListSnapshotGroupsWarning) MarshalJSON() ([]byte, error) { + type NoMethod ListSnapshotGroupsWarning + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type ListSnapshotGroupsWarningData struct { + // Key: [Output Only] A key that provides more detail on the warning + // being + // returned. For example, for warnings where there are no results in a + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a + // key + // indicating a deprecated resource and a suggested replacement, or a + // warning about invalid network settings (for example, if an instance + // attempts to perform IP forwarding but is not enabled for IP forwarding). + Key string `json:"key,omitempty"` + // Value: [Output Only] A warning data value corresponding to the key. + Value string `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Key") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Key") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ListSnapshotGroupsWarningData) MarshalJSON() ([]byte, error) { + type NoMethod ListSnapshotGroupsWarningData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type LocalDisk struct { // DiskCount: Specifies the number of such disks. DiskCount int64 `json:"diskCount,omitempty"` @@ -40203,6 +40592,17 @@ type LocationPolicy struct { // Currently only zone names are supported and must be represented as // valid // internal URLs, such as zones/us-central1-a. + // The bulkInsert operation doesn't create instances in an AI zone, even if + // an AI zone is available in the specified region. For example, if you set + // a + // DENY preference for us-central1-a, Compute Engine will + // consider + // us-central1-b and us-central1-c for instance creation, but + // not + // us-central1-ai1a. Also, you can't use the locations[] configuration to + // allow instance creation in an AI zone. To include an AI zone in + // bulkInsert + // operations, use the locationPolicy.zones[] field. Locations map[string]LocationPolicyLocation `json:"locations,omitempty"` // TargetShape: Strategy for distributing VMs across zones in a region. // @@ -40226,6 +40626,11 @@ type LocationPolicy struct { // failure. // Recommended for highly available serving workloads. TargetShape string `json:"targetShape,omitempty"` + // Zones: The bulkInsert operation applies any preferences set in the + // locations + // field to the specific zones listed in the zones field if the same zones + // are specified in both fields. + Zones []*LocationPolicyZoneConfiguration `json:"zones,omitempty"` // ForceSendFields is a list of field names (e.g. "Locations") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -40299,6 +40704,30 @@ func (s LocationPolicyLocationConstraints) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type LocationPolicyZoneConfiguration struct { + // Zone: The URL of the zone. + // The zone must exist in the region where the request is called. + // Zones must be represented as valid partial URLs, + // such as zones/us-central1-a. + Zone string `json:"zone,omitempty"` + // ForceSendFields is a list of field names (e.g. "Zone") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Zone") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s LocationPolicyZoneConfiguration) MarshalJSON() ([]byte, error) { + type NoMethod LocationPolicyZoneConfiguration + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // MachineImage: Represents a machine image resource. // // A machine image is a Compute Engine resource that stores all @@ -42626,6 +43055,54 @@ func (s NamedPort) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type NamedSet struct { + // Description: An optional description of named set. + Description string `json:"description,omitempty"` + // Elements: CEL expressions that are comparable to constructs of this set's + // type + // (see Policy Language). + Elements []*Expr `json:"elements,omitempty"` + // Fingerprint: A fingerprint for the Named Set being applied to this Router, + // which is + // essentially a hash of the Named Set used for optimistic locking. + // The fingerprint is initially generated by Compute Engine and changes + // after every request to modify or update the Named Set. You must + // always + // provide an up-to-date fingerprint hash in order to update or + // change + // labels. + // + // To see the latest fingerprint, make a getNamedSet() request + // to retrieve a Named Set. + Fingerprint string `json:"fingerprint,omitempty"` + // Name: This set's name, which must be a resource ID segment and unique within + // all + // named sets owned by the Router. Name should conform to RFC1035. + Name string `json:"name,omitempty"` + // Type: This named set's type + // + // Possible values: + // "NAMED_SET_TYPE_COMMUNITY" - The Named Set is a Community Named Set. + // "NAMED_SET_TYPE_PREFIX" - The Named Set is a Prefix Named Set. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "Description") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Description") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s NamedSet) MarshalJSON() ([]byte, error) { + type NoMethod NamedSet + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // NatIpInfo: Contains NAT IP information of a NAT config (i.e. usage status, // mode). type NatIpInfo struct { @@ -58315,6 +58792,10 @@ type Reservation struct { // cannot // be a dash. Name string `json:"name,omitempty"` + // Params: Input only. Additional params passed with the request, but not + // persisted + // as part of resource payload. + Params *ReservationParams `json:"params,omitempty"` // ProtectionTier: Protection tier for the workload which specifies the // workload expectations // in the event of infrastructure failures at data center (e.g. power @@ -59294,6 +59775,37 @@ func (s ReservationListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ReservationParams: Additional reservation params. +type ReservationParams struct { + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // reservation. Tag keys and + // values have the same definition as resource + // manager tags. Keys and values can be either in numeric format, + // such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or + // in + // namespaced format such as `{org_id|project_id}/{tag_key_short_name}` + // and + // `{tag_value_short_name}`. The field is ignored (both PUT & + // PATCH) when empty. + ResourceManagerTags map[string]string `json:"resourceManagerTags,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResourceManagerTags") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ResourceManagerTags") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ReservationParams) MarshalJSON() ([]byte, error) { + type NoMethod ReservationParams + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ReservationSlot: Represents a reservation slot resource. type ReservationSlot struct { // CreationTimestamp: Output only. [Output Only] The creation timestamp, @@ -59328,6 +59840,7 @@ type ReservationSlot struct { // "CREATING" - The resources are being allocated for the reservation slot. // "DELETING" - The reservation slot is currently being deleted. // "STATE_UNSPECIFIED" + // "UNAVAILABLE" - The reservation slot is currently unavailable. State string `json:"state,omitempty"` // Status: Output only. [Output Only] The status of the reservation slot. Status *ReservationSlotStatus `json:"status,omitempty"` @@ -65070,6 +65583,31 @@ func (s RouterStatusResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type RoutersGetNamedSetResponse struct { + // Etag: end_interface: MixerGetResponseWithEtagBuilder + Etag string `json:"etag,omitempty"` + Resource *NamedSet `json:"resource,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Etag") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Etag") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RoutersGetNamedSetResponse) MarshalJSON() ([]byte, error) { + type NoMethod RoutersGetNamedSetResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type RoutersGetRoutePolicyResponse struct { Resource *RoutePolicy `json:"resource,omitempty"` @@ -65278,6 +65816,191 @@ func (s RoutersListBgpRoutesWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type RoutersListNamedSets struct { + Etag string `json:"etag,omitempty"` + // Id: [Output Only] The unique identifier for the resource. This identifier + // is + // defined by the server. + Id string `json:"id,omitempty"` + // Kind: Output only. [Output Only] Type of resource. + // Alwayscompute#routersListNamedSets for lists of named sets. + Kind string `json:"kind,omitempty"` + // NextPageToken: [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value for + // the query parameter pageToken in the next list request. + // Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + NextPageToken string `json:"nextPageToken,omitempty"` + // Result: [Output Only] A list of named sets. + Result []*NamedSet `json:"result,omitempty"` + // SelfLink: Output only. [Output Only] Server-defined URL for this resource. + SelfLink string `json:"selfLink,omitempty"` + // Unreachables: Output only. [Output Only] Unreachable resources. + Unreachables []string `json:"unreachables,omitempty"` + // Warning: [Output Only] Informational warning message. + Warning *RoutersListNamedSetsWarning `json:"warning,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Etag") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Etag") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RoutersListNamedSets) MarshalJSON() ([]byte, error) { + type NoMethod RoutersListNamedSets + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// RoutersListNamedSetsWarning: [Output Only] Informational warning message. +type RoutersListNamedSetsWarning struct { + // Code: [Output Only] A warning code, if applicable. For example, + // Compute + // Engine returns NO_RESULTS_ON_PAGE if there + // are no results in the response. + // + // Possible values: + // "CLEANUP_FAILED" - Warning about failed cleanup of transient changes made + // by a failed + // operation. + // "DEPRECATED_RESOURCE_USED" - A link to a deprecated resource was created. + // "DEPRECATED_TYPE_USED" - When deploying and at least one of the resources + // has a type marked as + // deprecated + // "DISK_SIZE_LARGER_THAN_IMAGE_SIZE" - The user created a boot disk that is + // larger than image size. + // "EXPERIMENTAL_TYPE_USED" - When deploying and at least one of the + // resources has a type marked as + // experimental + // "EXTERNAL_API_WARNING" - Warning that is present in an external api call + // "FIELD_VALUE_OVERRIDEN" - Warning that value of a field has been + // overridden. + // Deprecated unused field. + // "INJECTED_KERNELS_DEPRECATED" - The operation involved use of an injected + // kernel, which is deprecated. + // "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB" - A WEIGHTED_MAGLEV backend + // service is associated with a health check that is + // not of type HTTP/HTTPS/HTTP2. + // "LARGE_DEPLOYMENT_WARNING" - When deploying a deployment with a + // exceedingly large number of resources + // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list + // overhead quota exceed + // which captures the amount of resources filtered out by + // user-defined list filter. + // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type + // "NEXT_HOP_ADDRESS_NOT_ASSIGNED" - The route's nextHopIp address is not + // assigned to an instance on the + // network. + // "NEXT_HOP_CANNOT_IP_FORWARD" - The route's next hop instance cannot ip + // forward. + // "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE" - The route's nextHopInstance + // URL refers to an instance that does not have an + // ipv6 interface on the same network as the route. + // "NEXT_HOP_INSTANCE_NOT_FOUND" - The route's nextHopInstance URL refers to + // an instance that does not exist. + // "NEXT_HOP_INSTANCE_NOT_ON_NETWORK" - The route's nextHopInstance URL + // refers to an instance that is not on the + // same network as the route. + // "NEXT_HOP_NOT_RUNNING" - The route's next hop instance does not have a + // status of RUNNING. + // "NOT_CRITICAL_ERROR" - Error which is not critical. We decided to continue + // the process despite + // the mentioned error. + // "NO_RESULTS_ON_PAGE" - No results are present on a particular list page. + // "PARTIAL_SUCCESS" - Success is reported, but some results may be missing + // due to errors + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: + // regions.list). + // "REQUIRED_TOS_AGREEMENT" - The user attempted to use a resource that + // requires a TOS they have not + // accepted. + // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is + // in use. + // "RESOURCE_NOT_DELETED" - One or more of the resources set to auto-delete + // could not be deleted + // because they were in use. + // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is + // ignored. + // "SINGLE_INSTANCE_PROPERTY_TEMPLATE" - Instance template used in instance + // group manager is valid as such, but + // its application does not make a lot of sense, because it allows only + // single instance in instance group. + // "UNDECLARED_PROPERTIES" - When undeclared properties in the schema are + // present + // "UNREACHABLE" - A given scope cannot be reached. + Code string `json:"code,omitempty"` + // Data: [Output Only] Metadata about this warning in key: + // value format. For example: + // + // "data": [ + // { + // "key": "scope", + // "value": "zones/us-east1-d" + // } + Data []*RoutersListNamedSetsWarningData `json:"data,omitempty"` + // Message: [Output Only] A human-readable description of the warning code. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Code") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RoutersListNamedSetsWarning) MarshalJSON() ([]byte, error) { + type NoMethod RoutersListNamedSetsWarning + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type RoutersListNamedSetsWarningData struct { + // Key: [Output Only] A key that provides more detail on the warning + // being + // returned. For example, for warnings where there are no results in a + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a + // key + // indicating a deprecated resource and a suggested replacement, or a + // warning about invalid network settings (for example, if an instance + // attempts to perform IP forwarding but is not enabled for IP forwarding). + Key string `json:"key,omitempty"` + // Value: [Output Only] A warning data value corresponding to the key. + Value string `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Key") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Key") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RoutersListNamedSetsWarningData) MarshalJSON() ([]byte, error) { + type NoMethod RoutersListNamedSetsWarningData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type RoutersListRoutePolicies struct { Etag string `json:"etag,omitempty"` // Id: [Output Only] The unique identifier for the resource. This identifier @@ -69900,6 +70623,13 @@ type Snapshot struct { // you // do not need to provide a key to use the snapshot later. SnapshotEncryptionKey *CustomerEncryptionKey `json:"snapshotEncryptionKey,omitempty"` + // SnapshotGroupId: Output only. [Output Only] The unique ID of the snapshot + // group that this snapshot + // belongs to. + SnapshotGroupId string `json:"snapshotGroupId,omitempty"` + // SnapshotGroupName: Output only. [Output only] The snapshot group that this + // snapshot belongs to. + SnapshotGroupName string `json:"snapshotGroupName,omitempty"` // SnapshotType: Indicates the type of the snapshot. // // Possible values: @@ -69990,10 +70720,6 @@ type Snapshot struct { // (regional or // multi-regional). StorageLocations []string `json:"storageLocations,omitempty"` - // UserLicenses: [Output Only] A list of user provided licenses represented by - // a list of - // URLs to the license resource. - UserLicenses []string `json:"userLicenses,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -70199,6 +70925,168 @@ func (s SnapshotAggregatedListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// SnapshotGroup: Represents a SnapshotGroup resource. +// +// A snapshot group is a set of snapshots that represents a point in time +// state +// of a consistency group. +type SnapshotGroup struct { + // CreationTimestamp: Output only. [Output Only] Creation timestamp + // inRFC3339 + // text format. + CreationTimestamp string `json:"creationTimestamp,omitempty"` + // Description: Optional. An optional description of this resource. Provide + // this property when you + // create the resource. + Description string `json:"description,omitempty"` + // Id: Output only. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + Id uint64 `json:"id,omitempty,string"` + // Kind: Output only. [Output Only] Type of the resource. + // Alwayscompute#snapshotGroup for SnapshotGroup + // resources. + Kind string `json:"kind,omitempty"` + // Name: Identifier. Name of the resource; provided by the client when the + // resource is created. + // The name must be 1-63 characters long, and comply withRFC1035. + // Specifically, the name must be 1-63 characters long and match the + // regular + // expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + // character must be a lowercase letter, and all following characters must be + // a dash, lowercase letter, or digit, except the last character, which + // cannot + // be a dash. + Name string `json:"name,omitempty"` + // SelfLink: Output only. [Output Only] Server-defined URL for the resource. + SelfLink string `json:"selfLink,omitempty"` + // SelfLinkWithId: Output only. [Output Only] Server-defined URL for this + // resource's resource id. + SelfLinkWithId string `json:"selfLinkWithId,omitempty"` + // SourceInfo: Output only. [Output Only] + SourceInfo *SnapshotGroupSourceInfo `json:"sourceInfo,omitempty"` + // SourceInstantSnapshotGroup: Input field for the source instant snapshot + // group. + SourceInstantSnapshotGroup string `json:"sourceInstantSnapshotGroup,omitempty"` + // SourceInstantSnapshotGroupInfo: Output only. [Output Only] + SourceInstantSnapshotGroupInfo *SnapshotGroupSourceInstantSnapshotGroupInfo `json:"sourceInstantSnapshotGroupInfo,omitempty"` + // Status: Output only. [Output Only] + // + // Possible values: + // "CREATING" + // "DELETING" + // "FAILED" + // "INVALID" + // "READY" + // "UNKNOWN" + // "UPLOADING" + Status string `json:"status,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "CreationTimestamp") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CreationTimestamp") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s SnapshotGroup) MarshalJSON() ([]byte, error) { + type NoMethod SnapshotGroup + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type SnapshotGroupParameters struct { + // ReplicaZones: URLs of the zones where disks should be replicated to. Only + // applicable + // for regional resources. + ReplicaZones []string `json:"replicaZones,omitempty"` + // SourceSnapshotGroup: The source snapshot group used to create disks. You can + // provide this as a + // partial or full URL to the resource. For example, the following are + // valid + // values: + // + // + // - + // https://www.googleapis.com/compute/v1/projects/project/global/snapshotGroups/snapshotGroup + // + // - projects/project/global/snapshotGroups/snapshotGroup + // - global/snapshotGroups/snapshotGroup + SourceSnapshotGroup string `json:"sourceSnapshotGroup,omitempty"` + // Type: URL of the disk type resource describing which disk type to use to + // create + // disks. Provide this when creating the disk. For + // example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent + // disk + // types. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "ReplicaZones") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ReplicaZones") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s SnapshotGroupParameters) MarshalJSON() ([]byte, error) { + type NoMethod SnapshotGroupParameters + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type SnapshotGroupSourceInfo struct { + ConsistencyGroup string `json:"consistencyGroup,omitempty"` + ConsistencyGroupId string `json:"consistencyGroupId,omitempty"` + // ForceSendFields is a list of field names (e.g. "ConsistencyGroup") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ConsistencyGroup") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s SnapshotGroupSourceInfo) MarshalJSON() ([]byte, error) { + type NoMethod SnapshotGroupSourceInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type SnapshotGroupSourceInstantSnapshotGroupInfo struct { + InstantSnapshotGroup string `json:"instantSnapshotGroup,omitempty"` + InstantSnapshotGroupId string `json:"instantSnapshotGroupId,omitempty"` + // ForceSendFields is a list of field names (e.g. "InstantSnapshotGroup") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "InstantSnapshotGroup") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s SnapshotGroupSourceInstantSnapshotGroupInfo) MarshalJSON() ([]byte, error) { + type NoMethod SnapshotGroupSourceInstantSnapshotGroupInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // SnapshotList: Contains a list of Snapshot resources. type SnapshotList struct { // Id: [Output Only] Unique identifier for the resource; defined by the server. @@ -70381,8 +71269,8 @@ func (s SnapshotListWarningData) MarshalJSON() ([]byte, error) { // SnapshotParams: Additional snapshot params. type SnapshotParams struct { - // ResourceManagerTags: Resource manager tags to be bound to the snapshot. Tag - // keys and values have + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // snapshot. Tag keys and values have // the same definition as resource // manager tags. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -82949,9 +83837,9 @@ type VmExtensionPolicy struct { CreationTimestamp string `json:"creationTimestamp,omitempty"` // Description: An optional description of this resource. Description string `json:"description,omitempty"` - // ExtensionPolicies: Required. A map of extension names (e.g., "cloudops") to - // their corresponding policy - // configurations. + // ExtensionPolicies: Required. A map of extension names (for example, + // "ops-agent") to their corresponding + // policy configurations. ExtensionPolicies map[string]VmExtensionPolicyExtensionPolicy `json:"extensionPolicies,omitempty"` // GlobalResourceLink: Optional. Output only. [Output Only] Link to the global // policy that manages this zone policy, if @@ -82991,7 +83879,7 @@ type VmExtensionPolicy struct { // integers indicate higher priorities. If you do not specify a priority // when // creating a rule, it is assigned a priority of 1000. If priorities are - // equal, the policy with the more recent creation timestamp takes precedence. + // equal, the policy with the most recent creation timestamp takes precedence. Priority int64 `json:"priority,omitempty"` // SelfLink: Output only. [Output Only] Server-defined fully-qualified URL for // this resource. diff --git a/compute/v0.beta/compute2-gen.go b/compute/v0.beta/compute2-gen.go index 9919ade209..a3a6780aca 100644 --- a/compute/v0.beta/compute2-gen.go +++ b/compute/v0.beta/compute2-gen.go @@ -12501,7 +12501,7 @@ type DisksUpdateCall struct { // Update: Updates the specified disk with the data included in the // request. // The update is performed only on selected fields included as part -// of update-mask. Only the following fields can be modified: user_license. +// of update-mask. // // - disk: The disk name for this request. // - project: Project ID for this request. @@ -32615,6 +32615,142 @@ func (c *InstanceGroupManagersApplyUpdatesToInstancesCall) Do(opts ...googleapi. return ret, nil } +type InstanceGroupManagersConfigureAcceleratorTopologiesCall struct { + s *Service + project string + zone string + instanceGroupManager string + instancegroupmanagersconfigureacceleratortopologiesrequest *InstanceGroupManagersConfigureAcceleratorTopologiesRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// ConfigureAcceleratorTopologies: Updates the accelerator topologies +// configuration. +// +// - instanceGroupManager: The name of the managed instance group. +// It should conform to RFC1035. +// - project: Project ID for this request. +// - zone: The name of thezone +// where the managed instance group is located. +// +// It should conform to RFC1035. +func (r *InstanceGroupManagersService) ConfigureAcceleratorTopologies(project string, zone string, instanceGroupManager string, instancegroupmanagersconfigureacceleratortopologiesrequest *InstanceGroupManagersConfigureAcceleratorTopologiesRequest) *InstanceGroupManagersConfigureAcceleratorTopologiesCall { + c := &InstanceGroupManagersConfigureAcceleratorTopologiesCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.zone = zone + c.instanceGroupManager = instanceGroupManager + c.instancegroupmanagersconfigureacceleratortopologiesrequest = instancegroupmanagersconfigureacceleratortopologiesrequest + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so +// that if you must retry your request, the server will know to ignore +// the +// request if it has already been completed. +// +// For example, consider a situation where you make an initial request and +// the request times out. If you make the request again with the same +// request ID, the server can check if original operation with the same +// request ID was received, and if so, will ignore the second request. +// +// The request ID must be +// a valid UUID with the exception that zero UUID is not +// supported +// (00000000-0000-0000-0000-000000000000). +func (c *InstanceGroupManagersConfigureAcceleratorTopologiesCall) RequestId(requestId string) *InstanceGroupManagersConfigureAcceleratorTopologiesCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *InstanceGroupManagersConfigureAcceleratorTopologiesCall) Fields(s ...googleapi.Field) *InstanceGroupManagersConfigureAcceleratorTopologiesCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *InstanceGroupManagersConfigureAcceleratorTopologiesCall) Context(ctx context.Context) *InstanceGroupManagersConfigureAcceleratorTopologiesCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *InstanceGroupManagersConfigureAcceleratorTopologiesCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *InstanceGroupManagersConfigureAcceleratorTopologiesCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.instancegroupmanagersconfigureacceleratortopologiesrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/configureAcceleratorTopologies") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "zone": c.zone, + "instanceGroupManager": c.instanceGroupManager, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.instanceGroupManagers.configureAcceleratorTopologies", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.instanceGroupManagers.configureAcceleratorTopologies" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *InstanceGroupManagersConfigureAcceleratorTopologiesCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.instanceGroupManagers.configureAcceleratorTopologies", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type InstanceGroupManagersCreateInstancesCall struct { s *Service project string diff --git a/compute/v0.beta/compute3-gen.go b/compute/v0.beta/compute3-gen.go index a479d6b2f6..95cd32920e 100644 --- a/compute/v0.beta/compute3-gen.go +++ b/compute/v0.beta/compute3-gen.go @@ -2860,9 +2860,7 @@ type RegionDisksUpdateCall struct { // Update: Update the specified disk with the data included in the request. // Update is -// performed only on selected fields included as part of update-mask. Only -// the -// following fields can be modified: user_license. +// performed only on selected fields included as part of update-mask. // // - disk: The disk name for this request. // - project: Project ID for this request. @@ -35368,7 +35366,7 @@ func (c *ReservationSubBlocksGetCall) doRequest(alt string) (*http.Response, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -35500,7 +35498,7 @@ func (c *ReservationSubBlocksGetIamPolicyCall) doRequest(alt string) (*http.Resp } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/getIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/getIamPolicy") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -35750,7 +35748,7 @@ func (c *ReservationSubBlocksListCall) doRequest(alt string) (*http.Response, er } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -35908,7 +35906,7 @@ func (c *ReservationSubBlocksPerformMaintenanceCall) doRequest(alt string) (*htt reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, nil) if err != nil { @@ -36050,7 +36048,7 @@ func (c *ReservationSubBlocksReportFaultyCall) doRequest(alt string) (*http.Resp } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -36168,7 +36166,7 @@ func (c *ReservationSubBlocksSetIamPolicyCall) doRequest(alt string) (*http.Resp } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/setIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/setIamPolicy") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -36285,7 +36283,7 @@ func (c *ReservationSubBlocksTestIamPermissionsCall) doRequest(alt string) (*htt } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/testIamPermissions") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/testIamPermissions") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -41125,6 +41123,140 @@ func (c *RoutersDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error) return ret, nil } +type RoutersDeleteNamedSetCall struct { + s *Service + project string + region string + router string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// DeleteNamedSet: Deletes Named Set +// +// - project: Project ID for this request. +// - region: Name of the region for this request. +// - router: Name of the Router resource where Named Set is defined. +func (r *RoutersService) DeleteNamedSet(project string, region string, router string) *RoutersDeleteNamedSetCall { + c := &RoutersDeleteNamedSetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.router = router + return c +} + +// NamedSet sets the optional parameter "namedSet": The Named Set name for this +// request. Name must conform to RFC1035 +func (c *RoutersDeleteNamedSetCall) NamedSet(namedSet string) *RoutersDeleteNamedSetCall { + c.urlParams_.Set("namedSet", namedSet) + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so +// that if you must retry your request, the server will know to ignore +// the +// request if it has already been completed. +// +// For example, consider a situation where you make an initial request and +// the request times out. If you make the request again with the same +// request ID, the server can check if original operation with the same +// request ID was received, and if so, will ignore the second request. +// This +// prevents clients from accidentally creating duplicate commitments. +// +// The request ID must be +// a valid UUID with the exception that zero UUID is not +// supported +// (00000000-0000-0000-0000-000000000000). +func (c *RoutersDeleteNamedSetCall) RequestId(requestId string) *RoutersDeleteNamedSetCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *RoutersDeleteNamedSetCall) Fields(s ...googleapi.Field) *RoutersDeleteNamedSetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RoutersDeleteNamedSetCall) Context(ctx context.Context) *RoutersDeleteNamedSetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *RoutersDeleteNamedSetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RoutersDeleteNamedSetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/routers/{router}/deleteNamedSet") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "router": c.router, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.routers.deleteNamedSet", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.routers.deleteNamedSet" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *RoutersDeleteNamedSetCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.routers.deleteNamedSet", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type RoutersDeleteRoutePolicyCall struct { s *Service project string @@ -41376,6 +41508,134 @@ func (c *RoutersGetCall) Do(opts ...googleapi.CallOption) (*Router, error) { return ret, nil } +type RoutersGetNamedSetCall struct { + s *Service + project string + region string + router string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetNamedSet: Returns specified Named Set +// +// - project: Project ID for this request. +// - region: Name of the region for this request. +// - router: Name of the Router resource to query for the named set. The name +// should +// +// conform to RFC1035. +func (r *RoutersService) GetNamedSet(project string, region string, router string) *RoutersGetNamedSetCall { + c := &RoutersGetNamedSetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.router = router + return c +} + +// NamedSet sets the optional parameter "namedSet": The Named Set name for this +// request. Name must conform to RFC1035 +func (c *RoutersGetNamedSetCall) NamedSet(namedSet string) *RoutersGetNamedSetCall { + c.urlParams_.Set("namedSet", namedSet) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *RoutersGetNamedSetCall) Fields(s ...googleapi.Field) *RoutersGetNamedSetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *RoutersGetNamedSetCall) IfNoneMatch(entityTag string) *RoutersGetNamedSetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RoutersGetNamedSetCall) Context(ctx context.Context) *RoutersGetNamedSetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *RoutersGetNamedSetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RoutersGetNamedSetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/routers/{router}/getNamedSet") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "router": c.router, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.routers.getNamedSet", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.routers.getNamedSet" call. +// Any non-2xx status code is an error. Response headers are in either +// *RoutersGetNamedSetResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *RoutersGetNamedSetCall) Do(opts ...googleapi.CallOption) (*RoutersGetNamedSetResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &RoutersGetNamedSetResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.routers.getNamedSet", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type RoutersGetNatIpInfoCall struct { s *Service project string @@ -42745,6 +43005,276 @@ func (c *RoutersListBgpRoutesCall) Pages(ctx context.Context, f func(*RoutersLis } } +type RoutersListNamedSetsCall struct { + s *Service + project string + region string + router string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// ListNamedSets: Retrieves a list of router named set subresources available +// to the +// specified project. +// +// - project: Project ID for this request. +// - region: Name of the region for this request. +// - router: Name or id of the resource for this request. +// Name should conform to RFC1035. +func (r *RoutersService) ListNamedSets(project string, region string, router string) *RoutersListNamedSetsCall { + c := &RoutersListNamedSetsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.router = router + return c +} + +// Filter sets the optional parameter "filter": A filter expression that +// filters resources listed in the response. Most +// Compute resources support two types of filter expressions: +// expressions that support regular expressions and expressions that follow +// API improvement proposal AIP-160. +// These two types of filter expressions cannot be mixed in one request. +// +// If you want to use AIP-160, your expression must specify the field name, +// an +// operator, and the value that you want to use for filtering. The value +// must be a string, a number, or a boolean. The operator +// must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. +// +// For example, if you are filtering Compute Engine instances, you can +// exclude instances named `example-instance` by specifying +// `name != example-instance`. +// +// The `:*` comparison can be used to test whether a key has been defined. +// For example, to find all objects with `owner` label +// use: +// ``` +// labels.owner:* +// ``` +// +// You can also filter nested fields. For example, you could +// specify +// `scheduling.automaticRestart = false` to include instances only +// if they are not scheduled for automatic restarts. You can use filtering +// on nested fields to filter based onresource labels. +// +// To filter on multiple expressions, provide each separate expression +// within +// parentheses. For example: +// ``` +// (scheduling.automaticRestart = true) +// (cpuPlatform = "Intel Skylake") +// ``` +// By default, each expression is an `AND` expression. However, you +// can include `AND` and `OR` expressions explicitly. +// For example: +// ``` +// (cpuPlatform = "Intel Skylake") OR +// (cpuPlatform = "Intel Broadwell") AND +// (scheduling.automaticRestart = true) +// ``` +// +// If you want to use a regular expression, use the `eq` (equal) or `ne` +// (not equal) operator against a single un-parenthesized expression with +// or +// without quotes or against multiple parenthesized expressions. +// Examples: +// +// `fieldname eq unquoted literal` +// `fieldname eq 'single quoted literal'` +// `fieldname eq "double quoted literal" +// `(fieldname1 eq literal) (fieldname2 ne "literal")` +// +// The literal value is interpreted as a regular expression using GoogleRE2 +// library syntax. +// The literal value must match the entire field. +// +// For example, to filter for instances that do not end with name +// "instance", +// you would use `name ne .*instance`. +// +// You cannot combine constraints on multiple fields using regular +// expressions. +func (c *RoutersListNamedSetsCall) Filter(filter string) *RoutersListNamedSetsCall { + c.urlParams_.Set("filter", filter) + return c +} + +// MaxResults sets the optional parameter "maxResults": The maximum number of +// results per page that should be returned. +// If the number of available results is larger than `maxResults`, +// Compute Engine returns a `nextPageToken` that can be used to get +// the next page of results in subsequent list requests. Acceptable values +// are +// `0` to `500`, inclusive. (Default: `500`) +func (c *RoutersListNamedSetsCall) MaxResults(maxResults int64) *RoutersListNamedSetsCall { + c.urlParams_.Set("maxResults", fmt.Sprint(maxResults)) + return c +} + +// OrderBy sets the optional parameter "orderBy": Sorts list results by a +// certain order. By default, results +// are returned in alphanumerical order based on the resource name. +// +// You can also sort results in descending order based on the +// creation +// timestamp using `orderBy="creationTimestamp desc". This sorts +// results based on the `creationTimestamp` field in +// reverse chronological order (newest result first). Use this to +// sort +// resources like operations so that the newest operation is returned +// first. +// +// Currently, only sorting by `name` or +// `creationTimestamp desc` is supported. +func (c *RoutersListNamedSetsCall) OrderBy(orderBy string) *RoutersListNamedSetsCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageToken sets the optional parameter "pageToken": Specifies a page token to +// use. Set `pageToken` to the +// `nextPageToken` returned by a previous list request to get +// the next page of results. +func (c *RoutersListNamedSetsCall) PageToken(pageToken string) *RoutersListNamedSetsCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": +// Opt-in for partial success behavior which provides partial results in +// case +// of failure. The default value is false. +// +// For example, when partial success behavior is enabled, aggregatedList for +// a +// single zone scope either returns all resources in the zone or no +// resources, +// with an error code. +func (c *RoutersListNamedSetsCall) ReturnPartialSuccess(returnPartialSuccess bool) *RoutersListNamedSetsCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *RoutersListNamedSetsCall) Fields(s ...googleapi.Field) *RoutersListNamedSetsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *RoutersListNamedSetsCall) IfNoneMatch(entityTag string) *RoutersListNamedSetsCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RoutersListNamedSetsCall) Context(ctx context.Context) *RoutersListNamedSetsCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *RoutersListNamedSetsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RoutersListNamedSetsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/routers/{router}/listNamedSets") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "router": c.router, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.routers.listNamedSets", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.routers.listNamedSets" call. +// Any non-2xx status code is an error. Response headers are in either +// *RoutersListNamedSets.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *RoutersListNamedSetsCall) Do(opts ...googleapi.CallOption) (*RoutersListNamedSets, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &RoutersListNamedSets{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.routers.listNamedSets", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *RoutersListNamedSetsCall) Pages(ctx context.Context, f func(*RoutersListNamedSets) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + type RoutersListRoutePoliciesCall struct { s *Service project string @@ -43152,6 +43682,139 @@ func (c *RoutersPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error) return ret, nil } +type RoutersPatchNamedSetCall struct { + s *Service + project string + region string + router string + namedset *NamedSet + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// PatchNamedSet: Patches Named Set +// +// - project: Project ID for this request. +// - region: Name of the region for this request. +// - router: Name of the Router resource where Named Set is defined. +func (r *RoutersService) PatchNamedSet(project string, region string, router string, namedset *NamedSet) *RoutersPatchNamedSetCall { + c := &RoutersPatchNamedSetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.router = router + c.namedset = namedset + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so +// that if you must retry your request, the server will know to ignore +// the +// request if it has already been completed. +// +// For example, consider a situation where you make an initial request and +// the request times out. If you make the request again with the same +// request ID, the server can check if original operation with the same +// request ID was received, and if so, will ignore the second request. +// This +// prevents clients from accidentally creating duplicate commitments. +// +// The request ID must be +// a valid UUID with the exception that zero UUID is not +// supported +// (00000000-0000-0000-0000-000000000000). +func (c *RoutersPatchNamedSetCall) RequestId(requestId string) *RoutersPatchNamedSetCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *RoutersPatchNamedSetCall) Fields(s ...googleapi.Field) *RoutersPatchNamedSetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RoutersPatchNamedSetCall) Context(ctx context.Context) *RoutersPatchNamedSetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *RoutersPatchNamedSetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RoutersPatchNamedSetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.namedset) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/routers/{router}/patchNamedSet") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "router": c.router, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.routers.patchNamedSet", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.routers.patchNamedSet" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *RoutersPatchNamedSetCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.routers.patchNamedSet", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type RoutersPatchRoutePolicyCall struct { s *Service project string @@ -43651,28 +44314,28 @@ func (c *RoutersUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, error) return ret, nil } -type RoutersUpdateRoutePolicyCall struct { - s *Service - project string - region string - router string - routepolicy *RoutePolicy - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type RoutersUpdateNamedSetCall struct { + s *Service + project string + region string + router string + namedset *NamedSet + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// UpdateRoutePolicy: Updates or creates new Route Policy +// UpdateNamedSet: Updates or creates new Named Set // // - project: Project ID for this request. // - region: Name of the region for this request. -// - router: Name of the Router resource where Route Policy is defined. -func (r *RoutersService) UpdateRoutePolicy(project string, region string, router string, routepolicy *RoutePolicy) *RoutersUpdateRoutePolicyCall { - c := &RoutersUpdateRoutePolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - router: Name of the Router resource where Named Set is defined. +func (r *RoutersService) UpdateNamedSet(project string, region string, router string, namedset *NamedSet) *RoutersUpdateNamedSetCall { + c := &RoutersUpdateNamedSetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project c.region = region c.router = router - c.routepolicy = routepolicy + c.namedset = namedset return c } @@ -43693,7 +44356,7 @@ func (r *RoutersService) UpdateRoutePolicy(project string, region string, router // a valid UUID with the exception that zero UUID is not // supported // (00000000-0000-0000-0000-000000000000). -func (c *RoutersUpdateRoutePolicyCall) RequestId(requestId string) *RoutersUpdateRoutePolicyCall { +func (c *RoutersUpdateNamedSetCall) RequestId(requestId string) *RoutersUpdateNamedSetCall { c.urlParams_.Set("requestId", requestId) return c } @@ -43701,35 +44364,35 @@ func (c *RoutersUpdateRoutePolicyCall) RequestId(requestId string) *RoutersUpdat // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *RoutersUpdateRoutePolicyCall) Fields(s ...googleapi.Field) *RoutersUpdateRoutePolicyCall { +func (c *RoutersUpdateNamedSetCall) Fields(s ...googleapi.Field) *RoutersUpdateNamedSetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *RoutersUpdateRoutePolicyCall) Context(ctx context.Context) *RoutersUpdateRoutePolicyCall { +func (c *RoutersUpdateNamedSetCall) Context(ctx context.Context) *RoutersUpdateNamedSetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *RoutersUpdateRoutePolicyCall) Header() http.Header { +func (c *RoutersUpdateNamedSetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *RoutersUpdateRoutePolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *RoutersUpdateNamedSetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.routepolicy) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.namedset) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/routers/{router}/updateRoutePolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/routers/{router}/updateNamedSet") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -43741,16 +44404,16 @@ func (c *RoutersUpdateRoutePolicyCall) doRequest(alt string) (*http.Response, er "region": c.region, "router": c.router, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.routers.updateRoutePolicy", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.routers.updateNamedSet", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.routers.updateRoutePolicy" call. +// Do executes the "compute.routers.updateNamedSet" call. // Any non-2xx status code is an error. Response headers are in either // *Operation.ServerResponse.Header or (if a response was returned at all) in // error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check // whether the returned error was because http.StatusNotModified was returned. -func (c *RoutersUpdateRoutePolicyCall) Do(opts ...googleapi.CallOption) (*Operation, error) { +func (c *RoutersUpdateNamedSetCall) Do(opts ...googleapi.CallOption) (*Operation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -43780,27 +44443,32 @@ func (c *RoutersUpdateRoutePolicyCall) Do(opts ...googleapi.CallOption) (*Operat if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.routers.updateRoutePolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.routers.updateNamedSet", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type RoutesDeleteCall struct { - s *Service - project string - route string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type RoutersUpdateRoutePolicyCall struct { + s *Service + project string + region string + router string + routepolicy *RoutePolicy + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Delete: Deletes the specified Route resource. +// UpdateRoutePolicy: Updates or creates new Route Policy // // - project: Project ID for this request. -// - route: Name of the Route resource to delete. -func (r *RoutesService) Delete(project string, route string) *RoutesDeleteCall { - c := &RoutesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - region: Name of the region for this request. +// - router: Name of the Router resource where Route Policy is defined. +func (r *RoutersService) UpdateRoutePolicy(project string, region string, router string, routepolicy *RoutePolicy) *RoutersUpdateRoutePolicyCall { + c := &RoutersUpdateRoutePolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project - c.route = route + c.region = region + c.router = router + c.routepolicy = routepolicy return c } @@ -43821,7 +44489,7 @@ func (r *RoutesService) Delete(project string, route string) *RoutesDeleteCall { // a valid UUID with the exception that zero UUID is not // supported // (00000000-0000-0000-0000-000000000000). -func (c *RoutesDeleteCall) RequestId(requestId string) *RoutesDeleteCall { +func (c *RoutersUpdateRoutePolicyCall) RequestId(requestId string) *RoutersUpdateRoutePolicyCall { c.urlParams_.Set("requestId", requestId) return c } @@ -43829,164 +44497,56 @@ func (c *RoutesDeleteCall) RequestId(requestId string) *RoutesDeleteCall { // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *RoutesDeleteCall) Fields(s ...googleapi.Field) *RoutesDeleteCall { +func (c *RoutersUpdateRoutePolicyCall) Fields(s ...googleapi.Field) *RoutersUpdateRoutePolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *RoutesDeleteCall) Context(ctx context.Context) *RoutesDeleteCall { +func (c *RoutersUpdateRoutePolicyCall) Context(ctx context.Context) *RoutersUpdateRoutePolicyCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *RoutesDeleteCall) Header() http.Header { +func (c *RoutersUpdateRoutePolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *RoutesDeleteCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/global/routes/{route}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "project": c.project, - "route": c.route, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.routes.delete", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "compute.routes.delete" call. -// Any non-2xx status code is an error. Response headers are in either -// *Operation.ServerResponse.Header or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *RoutesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Operation{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) +func (c *RoutersUpdateRoutePolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.routepolicy) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.routes.delete", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type RoutesGetCall struct { - s *Service - project string - route string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// Get: Returns the specified Route resource. -// -// - project: Project ID for this request. -// - route: Name of the Route resource to return. -func (r *RoutesService) Get(project string, route string) *RoutesGetCall { - c := &RoutesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.project = project - c.route = route - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *RoutesGetCall) Fields(s ...googleapi.Field) *RoutesGetCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *RoutesGetCall) IfNoneMatch(entityTag string) *RoutesGetCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *RoutesGetCall) Context(ctx context.Context) *RoutesGetCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *RoutesGetCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *RoutesGetCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/global/routes/{route}") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/routers/{router}/updateRoutePolicy") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "project": c.project, - "route": c.route, + "region": c.region, + "router": c.router, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.routes.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.routers.updateRoutePolicy", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.routes.get" call. +// Do executes the "compute.routers.updateRoutePolicy" call. // Any non-2xx status code is an error. Response headers are in either -// *Route.ServerResponse.Header or (if a response was returned at all) in +// *Operation.ServerResponse.Header or (if a response was returned at all) in // error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check // whether the returned error was because http.StatusNotModified was returned. -func (c *RoutesGetCall) Do(opts ...googleapi.CallOption) (*Route, error) { +func (c *RoutersUpdateRoutePolicyCall) Do(opts ...googleapi.CallOption) (*Operation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -44005,7 +44565,7 @@ func (c *RoutesGetCall) Do(opts ...googleapi.CallOption) (*Route, error) { if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Route{ + ret := &Operation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -44016,26 +44576,262 @@ func (c *RoutesGetCall) Do(opts ...googleapi.CallOption) (*Route, error) { if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.routes.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.routers.updateRoutePolicy", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type RoutesInsertCall struct { +type RoutesDeleteCall struct { s *Service project string - route *Route + route string urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } -// Insert: Creates a Route resource in the specified project using the data -// included -// in the request. +// Delete: Deletes the specified Route resource. // // - project: Project ID for this request. -func (r *RoutesService) Insert(project string, route *Route) *RoutesInsertCall { - c := &RoutesInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - route: Name of the Route resource to delete. +func (r *RoutesService) Delete(project string, route string) *RoutesDeleteCall { + c := &RoutesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.route = route + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so +// that if you must retry your request, the server will know to ignore +// the +// request if it has already been completed. +// +// For example, consider a situation where you make an initial request and +// the request times out. If you make the request again with the same +// request ID, the server can check if original operation with the same +// request ID was received, and if so, will ignore the second request. +// This +// prevents clients from accidentally creating duplicate commitments. +// +// The request ID must be +// a valid UUID with the exception that zero UUID is not +// supported +// (00000000-0000-0000-0000-000000000000). +func (c *RoutesDeleteCall) RequestId(requestId string) *RoutesDeleteCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *RoutesDeleteCall) Fields(s ...googleapi.Field) *RoutesDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RoutesDeleteCall) Context(ctx context.Context) *RoutesDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *RoutesDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RoutesDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/global/routes/{route}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "route": c.route, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.routes.delete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.routes.delete" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *RoutesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.routes.delete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type RoutesGetCall struct { + s *Service + project string + route string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Returns the specified Route resource. +// +// - project: Project ID for this request. +// - route: Name of the Route resource to return. +func (r *RoutesService) Get(project string, route string) *RoutesGetCall { + c := &RoutesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.route = route + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *RoutesGetCall) Fields(s ...googleapi.Field) *RoutesGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *RoutesGetCall) IfNoneMatch(entityTag string) *RoutesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RoutesGetCall) Context(ctx context.Context) *RoutesGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *RoutesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RoutesGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/global/routes/{route}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "route": c.route, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.routes.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.routes.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *Route.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *RoutesGetCall) Do(opts ...googleapi.CallOption) (*Route, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Route{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.routes.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type RoutesInsertCall struct { + s *Service + project string + route *Route + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Insert: Creates a Route resource in the specified project using the data +// included +// in the request. +// +// - project: Project ID for this request. +func (r *RoutesService) Insert(project string, route *Route) *RoutesInsertCall { + c := &RoutesInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project c.route = route return c @@ -46926,45 +47722,1168 @@ func (c *ServiceAttachmentsDeleteCall) Do(opts ...googleapi.CallOption) (*Operat if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.serviceAttachments.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.serviceAttachments.delete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ServiceAttachmentsGetCall struct { + s *Service + project string + region string + serviceAttachment string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Returns the specified ServiceAttachment resource in the given scope. +// +// - project: Project ID for this request. +// - region: Name of the region of this request. +// - serviceAttachment: Name of the ServiceAttachment resource to return. +func (r *ServiceAttachmentsService) Get(project string, region string, serviceAttachment string) *ServiceAttachmentsGetCall { + c := &ServiceAttachmentsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.serviceAttachment = serviceAttachment + return c +} + +// ShowNatIps sets the optional parameter "showNatIps": Indicates whether NAT +// IPs should be included in the response. +func (c *ServiceAttachmentsGetCall) ShowNatIps(showNatIps bool) *ServiceAttachmentsGetCall { + c.urlParams_.Set("showNatIps", fmt.Sprint(showNatIps)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ServiceAttachmentsGetCall) Fields(s ...googleapi.Field) *ServiceAttachmentsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ServiceAttachmentsGetCall) IfNoneMatch(entityTag string) *ServiceAttachmentsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ServiceAttachmentsGetCall) Context(ctx context.Context) *ServiceAttachmentsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ServiceAttachmentsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ServiceAttachmentsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "serviceAttachment": c.serviceAttachment, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.serviceAttachments.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.serviceAttachments.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *ServiceAttachment.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ServiceAttachmentsGetCall) Do(opts ...googleapi.CallOption) (*ServiceAttachment, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ServiceAttachment{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.serviceAttachments.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ServiceAttachmentsGetIamPolicyCall struct { + s *Service + project string + region string + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. May be empty if +// no such +// policy or resource exists. +// +// - project: Project ID for this request. +// - region: The name of the region for this request. +// - resource: Name or id of the resource for this request. +func (r *ServiceAttachmentsService) GetIamPolicy(project string, region string, resource string) *ServiceAttachmentsGetIamPolicyCall { + c := &ServiceAttachmentsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "optionsRequestedPolicyVersion": Requested IAM Policy version. +func (c *ServiceAttachmentsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ServiceAttachmentsGetIamPolicyCall { + c.urlParams_.Set("optionsRequestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ServiceAttachmentsGetIamPolicyCall) Fields(s ...googleapi.Field) *ServiceAttachmentsGetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ServiceAttachmentsGetIamPolicyCall) IfNoneMatch(entityTag string) *ServiceAttachmentsGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ServiceAttachmentsGetIamPolicyCall) Context(ctx context.Context) *ServiceAttachmentsGetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ServiceAttachmentsGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ServiceAttachmentsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/serviceAttachments/{resource}/getIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "resource": c.resource, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.serviceAttachments.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.serviceAttachments.getIamPolicy" call. +// Any non-2xx status code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ServiceAttachmentsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Policy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.serviceAttachments.getIamPolicy", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ServiceAttachmentsInsertCall struct { + s *Service + project string + region string + serviceattachment *ServiceAttachment + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Insert: Creates a ServiceAttachment in the specified project in the given +// scope +// using the parameters that are included in the request. +// +// - project: Project ID for this request. +// - region: Name of the region of this request. +func (r *ServiceAttachmentsService) Insert(project string, region string, serviceattachment *ServiceAttachment) *ServiceAttachmentsInsertCall { + c := &ServiceAttachmentsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.serviceattachment = serviceattachment + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so +// that if you must retry your request, the server will know to ignore +// the +// request if it has already been completed. +// +// For example, consider a situation where you make an initial request and +// the request times out. If you make the request again with the same +// request ID, the server can check if original operation with the same +// request ID was received, and if so, will ignore the second request. +// This +// prevents clients from accidentally creating duplicate commitments. +// +// The request ID must be +// a valid UUID with the exception that zero UUID is not +// supported +// (00000000-0000-0000-0000-000000000000). +func (c *ServiceAttachmentsInsertCall) RequestId(requestId string) *ServiceAttachmentsInsertCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ServiceAttachmentsInsertCall) Fields(s ...googleapi.Field) *ServiceAttachmentsInsertCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ServiceAttachmentsInsertCall) Context(ctx context.Context) *ServiceAttachmentsInsertCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ServiceAttachmentsInsertCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ServiceAttachmentsInsertCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.serviceattachment) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/serviceAttachments") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.serviceAttachments.insert", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.serviceAttachments.insert" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ServiceAttachmentsInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.serviceAttachments.insert", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ServiceAttachmentsListCall struct { + s *Service + project string + region string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists the ServiceAttachments for a project in the given scope. +// +// - project: Project ID for this request. +// - region: Name of the region of this request. +func (r *ServiceAttachmentsService) List(project string, region string) *ServiceAttachmentsListCall { + c := &ServiceAttachmentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + return c +} + +// Filter sets the optional parameter "filter": A filter expression that +// filters resources listed in the response. Most +// Compute resources support two types of filter expressions: +// expressions that support regular expressions and expressions that follow +// API improvement proposal AIP-160. +// These two types of filter expressions cannot be mixed in one request. +// +// If you want to use AIP-160, your expression must specify the field name, +// an +// operator, and the value that you want to use for filtering. The value +// must be a string, a number, or a boolean. The operator +// must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. +// +// For example, if you are filtering Compute Engine instances, you can +// exclude instances named `example-instance` by specifying +// `name != example-instance`. +// +// The `:*` comparison can be used to test whether a key has been defined. +// For example, to find all objects with `owner` label +// use: +// ``` +// labels.owner:* +// ``` +// +// You can also filter nested fields. For example, you could +// specify +// `scheduling.automaticRestart = false` to include instances only +// if they are not scheduled for automatic restarts. You can use filtering +// on nested fields to filter based onresource labels. +// +// To filter on multiple expressions, provide each separate expression +// within +// parentheses. For example: +// ``` +// (scheduling.automaticRestart = true) +// (cpuPlatform = "Intel Skylake") +// ``` +// By default, each expression is an `AND` expression. However, you +// can include `AND` and `OR` expressions explicitly. +// For example: +// ``` +// (cpuPlatform = "Intel Skylake") OR +// (cpuPlatform = "Intel Broadwell") AND +// (scheduling.automaticRestart = true) +// ``` +// +// If you want to use a regular expression, use the `eq` (equal) or `ne` +// (not equal) operator against a single un-parenthesized expression with +// or +// without quotes or against multiple parenthesized expressions. +// Examples: +// +// `fieldname eq unquoted literal` +// `fieldname eq 'single quoted literal'` +// `fieldname eq "double quoted literal" +// `(fieldname1 eq literal) (fieldname2 ne "literal")` +// +// The literal value is interpreted as a regular expression using GoogleRE2 +// library syntax. +// The literal value must match the entire field. +// +// For example, to filter for instances that do not end with name +// "instance", +// you would use `name ne .*instance`. +// +// You cannot combine constraints on multiple fields using regular +// expressions. +func (c *ServiceAttachmentsListCall) Filter(filter string) *ServiceAttachmentsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// MaxResults sets the optional parameter "maxResults": The maximum number of +// results per page that should be returned. +// If the number of available results is larger than `maxResults`, +// Compute Engine returns a `nextPageToken` that can be used to get +// the next page of results in subsequent list requests. Acceptable values +// are +// `0` to `500`, inclusive. (Default: `500`) +func (c *ServiceAttachmentsListCall) MaxResults(maxResults int64) *ServiceAttachmentsListCall { + c.urlParams_.Set("maxResults", fmt.Sprint(maxResults)) + return c +} + +// OrderBy sets the optional parameter "orderBy": Sorts list results by a +// certain order. By default, results +// are returned in alphanumerical order based on the resource name. +// +// You can also sort results in descending order based on the +// creation +// timestamp using `orderBy="creationTimestamp desc". This sorts +// results based on the `creationTimestamp` field in +// reverse chronological order (newest result first). Use this to +// sort +// resources like operations so that the newest operation is returned +// first. +// +// Currently, only sorting by `name` or +// `creationTimestamp desc` is supported. +func (c *ServiceAttachmentsListCall) OrderBy(orderBy string) *ServiceAttachmentsListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageToken sets the optional parameter "pageToken": Specifies a page token to +// use. Set `pageToken` to the +// `nextPageToken` returned by a previous list request to get +// the next page of results. +func (c *ServiceAttachmentsListCall) PageToken(pageToken string) *ServiceAttachmentsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": +// Opt-in for partial success behavior which provides partial results in +// case +// of failure. The default value is false. +// +// For example, when partial success behavior is enabled, aggregatedList for +// a +// single zone scope either returns all resources in the zone or no +// resources, +// with an error code. +func (c *ServiceAttachmentsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ServiceAttachmentsListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ServiceAttachmentsListCall) Fields(s ...googleapi.Field) *ServiceAttachmentsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ServiceAttachmentsListCall) IfNoneMatch(entityTag string) *ServiceAttachmentsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ServiceAttachmentsListCall) Context(ctx context.Context) *ServiceAttachmentsListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ServiceAttachmentsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ServiceAttachmentsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/serviceAttachments") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.serviceAttachments.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.serviceAttachments.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ServiceAttachmentList.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ServiceAttachmentsListCall) Do(opts ...googleapi.CallOption) (*ServiceAttachmentList, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ServiceAttachmentList{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.serviceAttachments.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ServiceAttachmentsListCall) Pages(ctx context.Context, f func(*ServiceAttachmentList) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type ServiceAttachmentsPatchCall struct { + s *Service + project string + region string + serviceAttachment string + serviceattachment *ServiceAttachment + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Patches the specified ServiceAttachment resource with the data +// included in +// the request. This method supports PATCH +// semantics and usesJSON merge +// patch format and processing rules. +// +// - project: Project ID for this request. +// - region: The region scoping this request and should conform to RFC1035. +// - serviceAttachment: The resource id of the ServiceAttachment to patch. It +// should conform to +// RFC1035 resource name or be a string form on an unsigned long number. +func (r *ServiceAttachmentsService) Patch(project string, region string, serviceAttachment string, serviceattachment *ServiceAttachment) *ServiceAttachmentsPatchCall { + c := &ServiceAttachmentsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.serviceAttachment = serviceAttachment + c.serviceattachment = serviceattachment + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so +// that if you must retry your request, the server will know to ignore +// the +// request if it has already been completed. +// +// For example, consider a situation where you make an initial request and +// the request times out. If you make the request again with the same +// request ID, the server can check if original operation with the same +// request ID was received, and if so, will ignore the second request. +// This +// prevents clients from accidentally creating duplicate commitments. +// +// The request ID must be +// a valid UUID with the exception that zero UUID is not +// supported +// (00000000-0000-0000-0000-000000000000). +func (c *ServiceAttachmentsPatchCall) RequestId(requestId string) *ServiceAttachmentsPatchCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ServiceAttachmentsPatchCall) Fields(s ...googleapi.Field) *ServiceAttachmentsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ServiceAttachmentsPatchCall) Context(ctx context.Context) *ServiceAttachmentsPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ServiceAttachmentsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ServiceAttachmentsPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.serviceattachment) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "serviceAttachment": c.serviceAttachment, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.serviceAttachments.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.serviceAttachments.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ServiceAttachmentsPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.serviceAttachments.patch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ServiceAttachmentsSetIamPolicyCall struct { + s *Service + project string + region string + resource string + regionsetpolicyrequest *RegionSetPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. +// Replaces any existing policy. +// +// - project: Project ID for this request. +// - region: The name of the region for this request. +// - resource: Name or id of the resource for this request. +func (r *ServiceAttachmentsService) SetIamPolicy(project string, region string, resource string, regionsetpolicyrequest *RegionSetPolicyRequest) *ServiceAttachmentsSetIamPolicyCall { + c := &ServiceAttachmentsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.resource = resource + c.regionsetpolicyrequest = regionsetpolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ServiceAttachmentsSetIamPolicyCall) Fields(s ...googleapi.Field) *ServiceAttachmentsSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ServiceAttachmentsSetIamPolicyCall) Context(ctx context.Context) *ServiceAttachmentsSetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ServiceAttachmentsSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ServiceAttachmentsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.regionsetpolicyrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/serviceAttachments/{resource}/setIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "resource": c.resource, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.serviceAttachments.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.serviceAttachments.setIamPolicy" call. +// Any non-2xx status code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ServiceAttachmentsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Policy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.serviceAttachments.setIamPolicy", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ServiceAttachmentsTestIamPermissionsCall struct { + s *Service + project string + region string + resource string + testpermissionsrequest *TestPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the specified +// resource. +// +// - project: Project ID for this request. +// - region: The name of the region for this request. +// - resource: Name or id of the resource for this request. +func (r *ServiceAttachmentsService) TestIamPermissions(project string, region string, resource string, testpermissionsrequest *TestPermissionsRequest) *ServiceAttachmentsTestIamPermissionsCall { + c := &ServiceAttachmentsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.resource = resource + c.testpermissionsrequest = testpermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ServiceAttachmentsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ServiceAttachmentsTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ServiceAttachmentsTestIamPermissionsCall) Context(ctx context.Context) *ServiceAttachmentsTestIamPermissionsCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ServiceAttachmentsTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ServiceAttachmentsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.testpermissionsrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/serviceAttachments/{resource}/testIamPermissions") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "resource": c.resource, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.serviceAttachments.testIamPermissions", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.serviceAttachments.testIamPermissions" call. +// Any non-2xx status code is an error. Response headers are in either +// *TestPermissionsResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ServiceAttachmentsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestPermissionsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &TestPermissionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.serviceAttachments.testIamPermissions", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type SnapshotGroupsDeleteCall struct { + s *Service + project string + snapshotGroup string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes the specified SnapshotGroup resource +// +// - project: Project ID for this request. +// - snapshotGroup: Name of the SnapshotGroup resource to delete. +func (r *SnapshotGroupsService) Delete(project string, snapshotGroup string) *SnapshotGroupsDeleteCall { + c := &SnapshotGroupsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.snapshotGroup = snapshotGroup + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so +// that if you must retry your request, the server will know to ignore +// the +// request if it has already been completed. +// +// For example, consider a situation where you make an initial request and +// the request times out. If you make the request again with the same +// request ID, the server can check if original operation with the same +// request ID was received, and if so, will ignore the second request. +// This +// prevents clients from accidentally creating duplicate commitments. +// +// The request ID must be +// a valid UUID with the exception that zero UUID is not +// supported +// (00000000-0000-0000-0000-000000000000). +func (c *SnapshotGroupsDeleteCall) RequestId(requestId string) *SnapshotGroupsDeleteCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *SnapshotGroupsDeleteCall) Fields(s ...googleapi.Field) *SnapshotGroupsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *SnapshotGroupsDeleteCall) Context(ctx context.Context) *SnapshotGroupsDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *SnapshotGroupsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *SnapshotGroupsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/global/snapshotGroups/{snapshotGroup}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "snapshotGroup": c.snapshotGroup, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.snapshotGroups.delete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.snapshotGroups.delete" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *SnapshotGroupsDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.snapshotGroups.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ServiceAttachmentsGetCall struct { - s *Service - project string - region string - serviceAttachment string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type SnapshotGroupsGetCall struct { + s *Service + project string + snapshotGroup string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Get: Returns the specified ServiceAttachment resource in the given scope. +// Get: returns the specified SnapshotGroup resource. // // - project: Project ID for this request. -// - region: Name of the region of this request. -// - serviceAttachment: Name of the ServiceAttachment resource to return. -func (r *ServiceAttachmentsService) Get(project string, region string, serviceAttachment string) *ServiceAttachmentsGetCall { - c := &ServiceAttachmentsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - snapshotGroup: Name of the SnapshotGroup resource to return. +func (r *SnapshotGroupsService) Get(project string, snapshotGroup string) *SnapshotGroupsGetCall { + c := &SnapshotGroupsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project - c.region = region - c.serviceAttachment = serviceAttachment - return c -} - -// ShowNatIps sets the optional parameter "showNatIps": Indicates whether NAT -// IPs should be included in the response. -func (c *ServiceAttachmentsGetCall) ShowNatIps(showNatIps bool) *ServiceAttachmentsGetCall { - c.urlParams_.Set("showNatIps", fmt.Sprint(showNatIps)) + c.snapshotGroup = snapshotGroup return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ServiceAttachmentsGetCall) Fields(s ...googleapi.Field) *ServiceAttachmentsGetCall { +func (c *SnapshotGroupsGetCall) Fields(s ...googleapi.Field) *SnapshotGroupsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -46972,34 +48891,34 @@ func (c *ServiceAttachmentsGetCall) Fields(s ...googleapi.Field) *ServiceAttachm // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ServiceAttachmentsGetCall) IfNoneMatch(entityTag string) *ServiceAttachmentsGetCall { +func (c *SnapshotGroupsGetCall) IfNoneMatch(entityTag string) *SnapshotGroupsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ServiceAttachmentsGetCall) Context(ctx context.Context) *ServiceAttachmentsGetCall { +func (c *SnapshotGroupsGetCall) Context(ctx context.Context) *SnapshotGroupsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ServiceAttachmentsGetCall) Header() http.Header { +func (c *SnapshotGroupsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ServiceAttachmentsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *SnapshotGroupsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/global/snapshotGroups/{snapshotGroup}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -47007,21 +48926,19 @@ func (c *ServiceAttachmentsGetCall) doRequest(alt string) (*http.Response, error } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "project": c.project, - "region": c.region, - "serviceAttachment": c.serviceAttachment, + "project": c.project, + "snapshotGroup": c.snapshotGroup, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.serviceAttachments.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.snapshotGroups.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.serviceAttachments.get" call. +// Do executes the "compute.snapshotGroups.get" call. // Any non-2xx status code is an error. Response headers are in either -// *ServiceAttachment.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ServiceAttachmentsGetCall) Do(opts ...googleapi.CallOption) (*ServiceAttachment, error) { +// *SnapshotGroup.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *SnapshotGroupsGetCall) Do(opts ...googleapi.CallOption) (*SnapshotGroup, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -47040,7 +48957,7 @@ func (c *ServiceAttachmentsGetCall) Do(opts ...googleapi.CallOption) (*ServiceAt if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &ServiceAttachment{ + ret := &SnapshotGroup{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -47051,14 +48968,13 @@ func (c *ServiceAttachmentsGetCall) Do(opts ...googleapi.CallOption) (*ServiceAt if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.serviceAttachments.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.snapshotGroups.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ServiceAttachmentsGetIamPolicyCall struct { +type SnapshotGroupsGetIamPolicyCall struct { s *Service project string - region string resource string urlParams_ gensupport.URLParams ifNoneMatch_ string @@ -47071,19 +48987,17 @@ type ServiceAttachmentsGetIamPolicyCall struct { // policy or resource exists. // // - project: Project ID for this request. -// - region: The name of the region for this request. // - resource: Name or id of the resource for this request. -func (r *ServiceAttachmentsService) GetIamPolicy(project string, region string, resource string) *ServiceAttachmentsGetIamPolicyCall { - c := &ServiceAttachmentsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *SnapshotGroupsService) GetIamPolicy(project string, resource string) *SnapshotGroupsGetIamPolicyCall { + c := &SnapshotGroupsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project - c.region = region c.resource = resource return c } // OptionsRequestedPolicyVersion sets the optional parameter // "optionsRequestedPolicyVersion": Requested IAM Policy version. -func (c *ServiceAttachmentsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ServiceAttachmentsGetIamPolicyCall { +func (c *SnapshotGroupsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *SnapshotGroupsGetIamPolicyCall { c.urlParams_.Set("optionsRequestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c } @@ -47091,7 +49005,7 @@ func (c *ServiceAttachmentsGetIamPolicyCall) OptionsRequestedPolicyVersion(optio // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ServiceAttachmentsGetIamPolicyCall) Fields(s ...googleapi.Field) *ServiceAttachmentsGetIamPolicyCall { +func (c *SnapshotGroupsGetIamPolicyCall) Fields(s ...googleapi.Field) *SnapshotGroupsGetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -47099,34 +49013,34 @@ func (c *ServiceAttachmentsGetIamPolicyCall) Fields(s ...googleapi.Field) *Servi // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ServiceAttachmentsGetIamPolicyCall) IfNoneMatch(entityTag string) *ServiceAttachmentsGetIamPolicyCall { +func (c *SnapshotGroupsGetIamPolicyCall) IfNoneMatch(entityTag string) *SnapshotGroupsGetIamPolicyCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ServiceAttachmentsGetIamPolicyCall) Context(ctx context.Context) *ServiceAttachmentsGetIamPolicyCall { +func (c *SnapshotGroupsGetIamPolicyCall) Context(ctx context.Context) *SnapshotGroupsGetIamPolicyCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ServiceAttachmentsGetIamPolicyCall) Header() http.Header { +func (c *SnapshotGroupsGetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ServiceAttachmentsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *SnapshotGroupsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/serviceAttachments/{resource}/getIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/global/snapshotGroups/{resource}/getIamPolicy") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -47135,19 +49049,18 @@ func (c *ServiceAttachmentsGetIamPolicyCall) doRequest(alt string) (*http.Respon req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "project": c.project, - "region": c.region, "resource": c.resource, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.serviceAttachments.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.snapshotGroups.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.serviceAttachments.getIamPolicy" call. +// Do executes the "compute.snapshotGroups.getIamPolicy" call. // Any non-2xx status code is an error. Response headers are in either // *Policy.ServerResponse.Header or (if a response was returned at all) in // error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check // whether the returned error was because http.StatusNotModified was returned. -func (c *ServiceAttachmentsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { +func (c *SnapshotGroupsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -47177,31 +49090,28 @@ func (c *ServiceAttachmentsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (* if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.serviceAttachments.getIamPolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.snapshotGroups.getIamPolicy", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ServiceAttachmentsInsertCall struct { - s *Service - project string - region string - serviceattachment *ServiceAttachment - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type SnapshotGroupsInsertCall struct { + s *Service + project string + snapshotgroup *SnapshotGroup + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Insert: Creates a ServiceAttachment in the specified project in the given -// scope -// using the parameters that are included in the request. +// Insert: Creates a snapshot group in the specified project using the data +// included +// in the request. // // - project: Project ID for this request. -// - region: Name of the region of this request. -func (r *ServiceAttachmentsService) Insert(project string, region string, serviceattachment *ServiceAttachment) *ServiceAttachmentsInsertCall { - c := &ServiceAttachmentsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *SnapshotGroupsService) Insert(project string, snapshotgroup *SnapshotGroup) *SnapshotGroupsInsertCall { + c := &SnapshotGroupsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project - c.region = region - c.serviceattachment = serviceattachment + c.snapshotgroup = snapshotgroup return c } @@ -47222,7 +49132,7 @@ func (r *ServiceAttachmentsService) Insert(project string, region string, servic // a valid UUID with the exception that zero UUID is not // supported // (00000000-0000-0000-0000-000000000000). -func (c *ServiceAttachmentsInsertCall) RequestId(requestId string) *ServiceAttachmentsInsertCall { +func (c *SnapshotGroupsInsertCall) RequestId(requestId string) *SnapshotGroupsInsertCall { c.urlParams_.Set("requestId", requestId) return c } @@ -47230,35 +49140,35 @@ func (c *ServiceAttachmentsInsertCall) RequestId(requestId string) *ServiceAttac // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ServiceAttachmentsInsertCall) Fields(s ...googleapi.Field) *ServiceAttachmentsInsertCall { +func (c *SnapshotGroupsInsertCall) Fields(s ...googleapi.Field) *SnapshotGroupsInsertCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ServiceAttachmentsInsertCall) Context(ctx context.Context) *ServiceAttachmentsInsertCall { +func (c *SnapshotGroupsInsertCall) Context(ctx context.Context) *SnapshotGroupsInsertCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ServiceAttachmentsInsertCall) Header() http.Header { +func (c *SnapshotGroupsInsertCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ServiceAttachmentsInsertCall) doRequest(alt string) (*http.Response, error) { +func (c *SnapshotGroupsInsertCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.serviceattachment) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.snapshotgroup) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/serviceAttachments") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/global/snapshotGroups") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -47267,18 +49177,17 @@ func (c *ServiceAttachmentsInsertCall) doRequest(alt string) (*http.Response, er req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "project": c.project, - "region": c.region, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.serviceAttachments.insert", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.snapshotGroups.insert", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.serviceAttachments.insert" call. +// Do executes the "compute.snapshotGroups.insert" call. // Any non-2xx status code is an error. Response headers are in either // *Operation.ServerResponse.Header or (if a response was returned at all) in // error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check // whether the returned error was because http.StatusNotModified was returned. -func (c *ServiceAttachmentsInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error) { +func (c *SnapshotGroupsInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -47308,28 +49217,26 @@ func (c *ServiceAttachmentsInsertCall) Do(opts ...googleapi.CallOption) (*Operat if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.serviceAttachments.insert", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.snapshotGroups.insert", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ServiceAttachmentsListCall struct { +type SnapshotGroupsListCall struct { s *Service project string - region string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// List: Lists the ServiceAttachments for a project in the given scope. +// List: retrieves the list of SnapshotGroup resources contained within +// the specified project. // // - project: Project ID for this request. -// - region: Name of the region of this request. -func (r *ServiceAttachmentsService) List(project string, region string) *ServiceAttachmentsListCall { - c := &ServiceAttachmentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *SnapshotGroupsService) List(project string) *SnapshotGroupsListCall { + c := &SnapshotGroupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project - c.region = region return c } @@ -47400,7 +49307,7 @@ func (r *ServiceAttachmentsService) List(project string, region string) *Service // // You cannot combine constraints on multiple fields using regular // expressions. -func (c *ServiceAttachmentsListCall) Filter(filter string) *ServiceAttachmentsListCall { +func (c *SnapshotGroupsListCall) Filter(filter string) *SnapshotGroupsListCall { c.urlParams_.Set("filter", filter) return c } @@ -47412,7 +49319,7 @@ func (c *ServiceAttachmentsListCall) Filter(filter string) *ServiceAttachmentsLi // the next page of results in subsequent list requests. Acceptable values // are // `0` to `500`, inclusive. (Default: `500`) -func (c *ServiceAttachmentsListCall) MaxResults(maxResults int64) *ServiceAttachmentsListCall { +func (c *SnapshotGroupsListCall) MaxResults(maxResults int64) *SnapshotGroupsListCall { c.urlParams_.Set("maxResults", fmt.Sprint(maxResults)) return c } @@ -47432,7 +49339,7 @@ func (c *ServiceAttachmentsListCall) MaxResults(maxResults int64) *ServiceAttach // // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. -func (c *ServiceAttachmentsListCall) OrderBy(orderBy string) *ServiceAttachmentsListCall { +func (c *SnapshotGroupsListCall) OrderBy(orderBy string) *SnapshotGroupsListCall { c.urlParams_.Set("orderBy", orderBy) return c } @@ -47441,7 +49348,7 @@ func (c *ServiceAttachmentsListCall) OrderBy(orderBy string) *ServiceAttachments // use. Set `pageToken` to the // `nextPageToken` returned by a previous list request to get // the next page of results. -func (c *ServiceAttachmentsListCall) PageToken(pageToken string) *ServiceAttachmentsListCall { +func (c *SnapshotGroupsListCall) PageToken(pageToken string) *SnapshotGroupsListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -47456,7 +49363,7 @@ func (c *ServiceAttachmentsListCall) PageToken(pageToken string) *ServiceAttachm // single zone scope either returns all resources in the zone or no // resources, // with an error code. -func (c *ServiceAttachmentsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ServiceAttachmentsListCall { +func (c *SnapshotGroupsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *SnapshotGroupsListCall { c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) return c } @@ -47464,7 +49371,7 @@ func (c *ServiceAttachmentsListCall) ReturnPartialSuccess(returnPartialSuccess b // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ServiceAttachmentsListCall) Fields(s ...googleapi.Field) *ServiceAttachmentsListCall { +func (c *SnapshotGroupsListCall) Fields(s ...googleapi.Field) *SnapshotGroupsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -47472,34 +49379,34 @@ func (c *ServiceAttachmentsListCall) Fields(s ...googleapi.Field) *ServiceAttach // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ServiceAttachmentsListCall) IfNoneMatch(entityTag string) *ServiceAttachmentsListCall { +func (c *SnapshotGroupsListCall) IfNoneMatch(entityTag string) *SnapshotGroupsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ServiceAttachmentsListCall) Context(ctx context.Context) *ServiceAttachmentsListCall { +func (c *SnapshotGroupsListCall) Context(ctx context.Context) *SnapshotGroupsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ServiceAttachmentsListCall) Header() http.Header { +func (c *SnapshotGroupsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ServiceAttachmentsListCall) doRequest(alt string) (*http.Response, error) { +func (c *SnapshotGroupsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/serviceAttachments") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/global/snapshotGroups") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -47508,19 +49415,18 @@ func (c *ServiceAttachmentsListCall) doRequest(alt string) (*http.Response, erro req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "project": c.project, - "region": c.region, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.serviceAttachments.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.snapshotGroups.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.serviceAttachments.list" call. +// Do executes the "compute.snapshotGroups.list" call. // Any non-2xx status code is an error. Response headers are in either -// *ServiceAttachmentList.ServerResponse.Header or (if a response was returned -// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// *ListSnapshotGroups.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to // check whether the returned error was because http.StatusNotModified was // returned. -func (c *ServiceAttachmentsListCall) Do(opts ...googleapi.CallOption) (*ServiceAttachmentList, error) { +func (c *SnapshotGroupsListCall) Do(opts ...googleapi.CallOption) (*ListSnapshotGroups, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -47539,7 +49445,7 @@ func (c *ServiceAttachmentsListCall) Do(opts ...googleapi.CallOption) (*ServiceA if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &ServiceAttachmentList{ + ret := &ListSnapshotGroups{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -47550,14 +49456,14 @@ func (c *ServiceAttachmentsListCall) Do(opts ...googleapi.CallOption) (*ServiceA if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.serviceAttachments.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.snapshotGroups.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. -func (c *ServiceAttachmentsListCall) Pages(ctx context.Context, f func(*ServiceAttachmentList) error) error { +func (c *SnapshotGroupsListCall) Pages(ctx context.Context, f func(*ListSnapshotGroups) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -47575,151 +49481,11 @@ func (c *ServiceAttachmentsListCall) Pages(ctx context.Context, f func(*ServiceA } } -type ServiceAttachmentsPatchCall struct { - s *Service - project string - region string - serviceAttachment string - serviceattachment *ServiceAttachment - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Patch: Patches the specified ServiceAttachment resource with the data -// included in -// the request. This method supports PATCH -// semantics and usesJSON merge -// patch format and processing rules. -// -// - project: Project ID for this request. -// - region: The region scoping this request and should conform to RFC1035. -// - serviceAttachment: The resource id of the ServiceAttachment to patch. It -// should conform to -// RFC1035 resource name or be a string form on an unsigned long number. -func (r *ServiceAttachmentsService) Patch(project string, region string, serviceAttachment string, serviceattachment *ServiceAttachment) *ServiceAttachmentsPatchCall { - c := &ServiceAttachmentsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.project = project - c.region = region - c.serviceAttachment = serviceAttachment - c.serviceattachment = serviceattachment - return c -} - -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so -// that if you must retry your request, the server will know to ignore -// the -// request if it has already been completed. -// -// For example, consider a situation where you make an initial request and -// the request times out. If you make the request again with the same -// request ID, the server can check if original operation with the same -// request ID was received, and if so, will ignore the second request. -// This -// prevents clients from accidentally creating duplicate commitments. -// -// The request ID must be -// a valid UUID with the exception that zero UUID is not -// supported -// (00000000-0000-0000-0000-000000000000). -func (c *ServiceAttachmentsPatchCall) RequestId(requestId string) *ServiceAttachmentsPatchCall { - c.urlParams_.Set("requestId", requestId) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ServiceAttachmentsPatchCall) Fields(s ...googleapi.Field) *ServiceAttachmentsPatchCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ServiceAttachmentsPatchCall) Context(ctx context.Context) *ServiceAttachmentsPatchCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ServiceAttachmentsPatchCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ServiceAttachmentsPatchCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.serviceattachment) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "project": c.project, - "region": c.region, - "serviceAttachment": c.serviceAttachment, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.serviceAttachments.patch", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "compute.serviceAttachments.patch" call. -// Any non-2xx status code is an error. Response headers are in either -// *Operation.ServerResponse.Header or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *ServiceAttachmentsPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Operation{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.serviceAttachments.patch", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ServiceAttachmentsSetIamPolicyCall struct { +type SnapshotGroupsSetIamPolicyCall struct { s *Service project string - region string resource string - regionsetpolicyrequest *RegionSetPolicyRequest + globalsetpolicyrequest *GlobalSetPolicyRequest urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header @@ -47730,49 +49496,47 @@ type ServiceAttachmentsSetIamPolicyCall struct { // Replaces any existing policy. // // - project: Project ID for this request. -// - region: The name of the region for this request. // - resource: Name or id of the resource for this request. -func (r *ServiceAttachmentsService) SetIamPolicy(project string, region string, resource string, regionsetpolicyrequest *RegionSetPolicyRequest) *ServiceAttachmentsSetIamPolicyCall { - c := &ServiceAttachmentsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *SnapshotGroupsService) SetIamPolicy(project string, resource string, globalsetpolicyrequest *GlobalSetPolicyRequest) *SnapshotGroupsSetIamPolicyCall { + c := &SnapshotGroupsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project - c.region = region c.resource = resource - c.regionsetpolicyrequest = regionsetpolicyrequest + c.globalsetpolicyrequest = globalsetpolicyrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ServiceAttachmentsSetIamPolicyCall) Fields(s ...googleapi.Field) *ServiceAttachmentsSetIamPolicyCall { +func (c *SnapshotGroupsSetIamPolicyCall) Fields(s ...googleapi.Field) *SnapshotGroupsSetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ServiceAttachmentsSetIamPolicyCall) Context(ctx context.Context) *ServiceAttachmentsSetIamPolicyCall { +func (c *SnapshotGroupsSetIamPolicyCall) Context(ctx context.Context) *SnapshotGroupsSetIamPolicyCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ServiceAttachmentsSetIamPolicyCall) Header() http.Header { +func (c *SnapshotGroupsSetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ServiceAttachmentsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *SnapshotGroupsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.regionsetpolicyrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.globalsetpolicyrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/serviceAttachments/{resource}/setIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/global/snapshotGroups/{resource}/setIamPolicy") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -47781,19 +49545,18 @@ func (c *ServiceAttachmentsSetIamPolicyCall) doRequest(alt string) (*http.Respon req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "project": c.project, - "region": c.region, "resource": c.resource, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.serviceAttachments.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.snapshotGroups.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.serviceAttachments.setIamPolicy" call. +// Do executes the "compute.snapshotGroups.setIamPolicy" call. // Any non-2xx status code is an error. Response headers are in either // *Policy.ServerResponse.Header or (if a response was returned at all) in // error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check // whether the returned error was because http.StatusNotModified was returned. -func (c *ServiceAttachmentsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { +func (c *SnapshotGroupsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -47823,14 +49586,13 @@ func (c *ServiceAttachmentsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (* if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.serviceAttachments.setIamPolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.snapshotGroups.setIamPolicy", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ServiceAttachmentsTestIamPermissionsCall struct { +type SnapshotGroupsTestIamPermissionsCall struct { s *Service project string - region string resource string testpermissionsrequest *TestPermissionsRequest urlParams_ gensupport.URLParams @@ -47842,12 +49604,10 @@ type ServiceAttachmentsTestIamPermissionsCall struct { // resource. // // - project: Project ID for this request. -// - region: The name of the region for this request. // - resource: Name or id of the resource for this request. -func (r *ServiceAttachmentsService) TestIamPermissions(project string, region string, resource string, testpermissionsrequest *TestPermissionsRequest) *ServiceAttachmentsTestIamPermissionsCall { - c := &ServiceAttachmentsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *SnapshotGroupsService) TestIamPermissions(project string, resource string, testpermissionsrequest *TestPermissionsRequest) *SnapshotGroupsTestIamPermissionsCall { + c := &SnapshotGroupsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project - c.region = region c.resource = resource c.testpermissionsrequest = testpermissionsrequest return c @@ -47856,27 +49616,27 @@ func (r *ServiceAttachmentsService) TestIamPermissions(project string, region st // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ServiceAttachmentsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ServiceAttachmentsTestIamPermissionsCall { +func (c *SnapshotGroupsTestIamPermissionsCall) Fields(s ...googleapi.Field) *SnapshotGroupsTestIamPermissionsCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ServiceAttachmentsTestIamPermissionsCall) Context(ctx context.Context) *ServiceAttachmentsTestIamPermissionsCall { +func (c *SnapshotGroupsTestIamPermissionsCall) Context(ctx context.Context) *SnapshotGroupsTestIamPermissionsCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ServiceAttachmentsTestIamPermissionsCall) Header() http.Header { +func (c *SnapshotGroupsTestIamPermissionsCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ServiceAttachmentsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { +func (c *SnapshotGroupsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.testpermissionsrequest) if err != nil { @@ -47884,7 +49644,7 @@ func (c *ServiceAttachmentsTestIamPermissionsCall) doRequest(alt string) (*http. } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/serviceAttachments/{resource}/testIamPermissions") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/global/snapshotGroups/{resource}/testIamPermissions") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -47893,20 +49653,19 @@ func (c *ServiceAttachmentsTestIamPermissionsCall) doRequest(alt string) (*http. req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "project": c.project, - "region": c.region, "resource": c.resource, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.serviceAttachments.testIamPermissions", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.snapshotGroups.testIamPermissions", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.serviceAttachments.testIamPermissions" call. +// Do executes the "compute.snapshotGroups.testIamPermissions" call. // Any non-2xx status code is an error. Response headers are in either // *TestPermissionsResponse.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ServiceAttachmentsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestPermissionsResponse, error) { +func (c *SnapshotGroupsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestPermissionsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -47936,7 +49695,7 @@ func (c *ServiceAttachmentsTestIamPermissionsCall) Do(opts ...googleapi.CallOpti if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.serviceAttachments.testIamPermissions", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.snapshotGroups.testIamPermissions", "response", internallog.HTTPResponse(res, b)) return ret, nil } diff --git a/compute/v1/compute-api.json b/compute/v1/compute-api.json index 7b7c9ed244..3ea2821bf6 100644 --- a/compute/v1/compute-api.json +++ b/compute/v1/compute-api.json @@ -3671,7 +3671,7 @@ ] }, "update": { - "description": "Updates the specified disk with the data included in the request.\nThe update is performed only on selected fields included as part\nof update-mask. Only the following fields can be modified: user_license.", + "description": "Updates the specified disk with the data included in the request.\nThe update is performed only on selected fields included as part\nof update-mask.", "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", "httpMethod": "PATCH", "id": "compute.disks.update", @@ -25122,7 +25122,7 @@ ] }, "update": { - "description": "Update the specified disk with the data included in the request. Update is\nperformed only on selected fields included as part of update-mask. Only the\nfollowing fields can be modified: user_license.", + "description": "Update the specified disk with the data included in the request. Update is\nperformed only on selected fields included as part of update-mask.", "flatPath": "projects/{project}/regions/{region}/disks/{disk}", "httpMethod": "PATCH", "id": "compute.regionDisks.update", @@ -25184,22 +25184,89 @@ } } }, - "regionHealthCheckServices": { + "regionHealthAggregationPolicies": { "methods": { + "aggregatedList": { + "description": "Retrieves the list of all HealthAggregationPolicy resources,\nregional and global, available to the specified project.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/healthAggregationPolicies", + "httpMethod": "GET", + "id": "compute.regionHealthAggregationPolicies.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/healthAggregationPolicies", + "response": { + "$ref": "HealthAggregationPolicyAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, "delete": { - "description": "Deletes the specified regional HealthCheckService.", - "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "description": "Deletes the specified HealthAggregationPolicy in the given region.", + "flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", "httpMethod": "DELETE", - "id": "compute.regionHealthCheckServices.delete", + "id": "compute.regionHealthAggregationPolicies.delete", "parameterOrder": [ "project", "region", - "healthCheckService" + "healthAggregationPolicy" ], "parameters": { - "healthCheckService": { - "description": "Name of the HealthCheckService to delete. The name\nmust be 1-63 characters long, and comply with RFC1035.", + "healthAggregationPolicy": { + "description": "Name of the HealthAggregationPolicy resource to delete.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" }, @@ -25223,7 +25290,7 @@ "type": "string" } }, - "path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "path": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", "response": { "$ref": "Operation" }, @@ -25233,19 +25300,20 @@ ] }, "get": { - "description": "Returns the specified regional HealthCheckService resource.", - "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "description": "Returns the specified HealthAggregationPolicy resource in the given region.", + "flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", "httpMethod": "GET", - "id": "compute.regionHealthCheckServices.get", + "id": "compute.regionHealthAggregationPolicies.get", "parameterOrder": [ "project", "region", - "healthCheckService" + "healthAggregationPolicy" ], "parameters": { - "healthCheckService": { - "description": "Name of the HealthCheckService to update. The name\nmust be 1-63 characters long, and comply with RFC1035.", + "healthAggregationPolicy": { + "description": "Name of the HealthAggregationPolicy resource to return.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" }, @@ -25264,9 +25332,9 @@ "type": "string" } }, - "path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "path": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", "response": { - "$ref": "HealthCheckService" + "$ref": "HealthAggregationPolicy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", @@ -25275,10 +25343,10 @@ ] }, "insert": { - "description": "Creates a regional HealthCheckService resource in the\nspecified project and region using the data included in the request.", - "flatPath": "projects/{project}/regions/{region}/healthCheckServices", + "description": "Create a HealthAggregationPolicy in the specified project in the given\nregion using the parameters that are included in the request.", + "flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies", "httpMethod": "POST", - "id": "compute.regionHealthCheckServices.insert", + "id": "compute.regionHealthAggregationPolicies.insert", "parameterOrder": [ "project", "region" @@ -25304,9 +25372,9 @@ "type": "string" } }, - "path": "projects/{project}/regions/{region}/healthCheckServices", + "path": "projects/{project}/regions/{region}/healthAggregationPolicies", "request": { - "$ref": "HealthCheckService" + "$ref": "HealthAggregationPolicy" }, "response": { "$ref": "Operation" @@ -25317,10 +25385,10 @@ ] }, "list": { - "description": "Lists all the HealthCheckService resources that have been\nconfigured for the specified project in the given region.", - "flatPath": "projects/{project}/regions/{region}/healthCheckServices", + "description": "Lists the HealthAggregationPolicies for a project in the given region.", + "flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies", "httpMethod": "GET", - "id": "compute.regionHealthCheckServices.list", + "id": "compute.regionHealthAggregationPolicies.list", "parameterOrder": [ "project", "region" @@ -25369,9 +25437,9 @@ "type": "boolean" } }, - "path": "projects/{project}/regions/{region}/healthCheckServices", + "path": "projects/{project}/regions/{region}/healthAggregationPolicies", "response": { - "$ref": "HealthCheckServicesList" + "$ref": "HealthAggregationPolicyList" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", @@ -25380,18 +25448,18 @@ ] }, "patch": { - "description": "Updates the specified regional HealthCheckService resource\nwith the data included in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", - "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "description": "Updates the specified regional HealthAggregationPolicy\nresource with the data included in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", "httpMethod": "PATCH", - "id": "compute.regionHealthCheckServices.patch", + "id": "compute.regionHealthAggregationPolicies.patch", "parameterOrder": [ "project", "region", - "healthCheckService" + "healthAggregationPolicy" ], "parameters": { - "healthCheckService": { - "description": "Name of the HealthCheckService to update. The name\nmust be 1-63 characters long, and comply with RFC1035.", + "healthAggregationPolicy": { + "description": "Name of the HealthAggregationPolicy to update. The name\nmust be 1-63 characters long, and comply with RFC1035.", "location": "path", "required": true, "type": "string" @@ -25416,9 +25484,9 @@ "type": "string" } }, - "path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "path": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", "request": { - "$ref": "HealthCheckService" + "$ref": "HealthAggregationPolicy" }, "response": { "$ref": "Operation" @@ -25430,9 +25498,9 @@ }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource.", - "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{resource}/testIamPermissions", + "flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies/{resource}/testIamPermissions", "httpMethod": "POST", - "id": "compute.regionHealthCheckServices.testIamPermissions", + "id": "compute.regionHealthAggregationPolicies.testIamPermissions", "parameterOrder": [ "project", "region", @@ -25461,7 +25529,7 @@ "type": "string" } }, - "path": "projects/{project}/regions/{region}/healthCheckServices/{resource}/testIamPermissions", + "path": "projects/{project}/regions/{region}/healthAggregationPolicies/{resource}/testIamPermissions", "request": { "$ref": "TestPermissionsRequest" }, @@ -25476,23 +25544,22 @@ } } }, - "regionHealthChecks": { + "regionHealthCheckServices": { "methods": { "delete": { - "description": "Deletes the specified HealthCheck resource.", - "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "description": "Deletes the specified regional HealthCheckService.", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", "httpMethod": "DELETE", - "id": "compute.regionHealthChecks.delete", + "id": "compute.regionHealthCheckServices.delete", "parameterOrder": [ "project", "region", - "healthCheck" + "healthCheckService" ], "parameters": { - "healthCheck": { - "description": "Name of the HealthCheck resource to delete.", + "healthCheckService": { + "description": "Name of the HealthCheckService to delete. The name\nmust be 1-63 characters long, and comply with RFC1035.", "location": "path", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" }, @@ -25516,7 +25583,7 @@ "type": "string" } }, - "path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", "response": { "$ref": "Operation" }, @@ -25526,20 +25593,19 @@ ] }, "get": { - "description": "Returns the specified HealthCheck resource.", - "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "description": "Returns the specified regional HealthCheckService resource.", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", "httpMethod": "GET", - "id": "compute.regionHealthChecks.get", + "id": "compute.regionHealthCheckServices.get", "parameterOrder": [ "project", "region", - "healthCheck" + "healthCheckService" ], "parameters": { - "healthCheck": { - "description": "Name of the HealthCheck resource to return.", + "healthCheckService": { + "description": "Name of the HealthCheckService to update. The name\nmust be 1-63 characters long, and comply with RFC1035.", "location": "path", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" }, @@ -25558,9 +25624,9 @@ "type": "string" } }, - "path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", "response": { - "$ref": "HealthCheck" + "$ref": "HealthCheckService" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", @@ -25569,10 +25635,10 @@ ] }, "insert": { - "description": "Creates a HealthCheck resource in the specified project using the data\nincluded in the request.", - "flatPath": "projects/{project}/regions/{region}/healthChecks", + "description": "Creates a regional HealthCheckService resource in the\nspecified project and region using the data included in the request.", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices", "httpMethod": "POST", - "id": "compute.regionHealthChecks.insert", + "id": "compute.regionHealthCheckServices.insert", "parameterOrder": [ "project", "region" @@ -25598,9 +25664,9 @@ "type": "string" } }, - "path": "projects/{project}/regions/{region}/healthChecks", + "path": "projects/{project}/regions/{region}/healthCheckServices", "request": { - "$ref": "HealthCheck" + "$ref": "HealthCheckService" }, "response": { "$ref": "Operation" @@ -25611,10 +25677,10 @@ ] }, "list": { - "description": "Retrieves the list of HealthCheck resources available to the specified\nproject.", - "flatPath": "projects/{project}/regions/{region}/healthChecks", + "description": "Lists all the HealthCheckService resources that have been\nconfigured for the specified project in the given region.", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices", "httpMethod": "GET", - "id": "compute.regionHealthChecks.list", + "id": "compute.regionHealthCheckServices.list", "parameterOrder": [ "project", "region" @@ -25663,9 +25729,9 @@ "type": "boolean" } }, - "path": "projects/{project}/regions/{region}/healthChecks", + "path": "projects/{project}/regions/{region}/healthCheckServices", "response": { - "$ref": "HealthCheckList" + "$ref": "HealthCheckServicesList" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", @@ -25674,10 +25740,109 @@ ] }, "patch": { - "description": "Updates a HealthCheck resource in the specified project using the data\nincluded in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", - "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "description": "Updates the specified regional HealthCheckService resource\nwith the data included in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", "httpMethod": "PATCH", - "id": "compute.regionHealthChecks.patch", + "id": "compute.regionHealthCheckServices.patch", + "parameterOrder": [ + "project", + "region", + "healthCheckService" + ], + "parameters": { + "healthCheckService": { + "description": "Name of the HealthCheckService to update. The name\nmust be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "request": { + "$ref": "HealthCheckService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionHealthCheckServices.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthCheckServices/{resource}/testIamPermissions", + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + } + } + }, + "regionHealthChecks": { + "methods": { + "delete": { + "description": "Deletes the specified HealthCheck resource.", + "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "httpMethod": "DELETE", + "id": "compute.regionHealthChecks.delete", "parameterOrder": [ "project", "region", @@ -25685,7 +25850,202 @@ ], "parameters": { "healthCheck": { - "description": "Name of the HealthCheck resource to patch.", + "description": "Name of the HealthCheck resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "get": { + "description": "Returns the specified HealthCheck resource.", + "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "httpMethod": "GET", + "id": "compute.regionHealthChecks.get", + "parameterOrder": [ + "project", + "region", + "healthCheck" + ], + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "response": { + "$ref": "HealthCheck" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "insert": { + "description": "Creates a HealthCheck resource in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/regions/{region}/healthChecks", + "httpMethod": "POST", + "id": "compute.regionHealthChecks.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthChecks", + "request": { + "$ref": "HealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "list": { + "description": "Retrieves the list of HealthCheck resources available to the specified\nproject.", + "flatPath": "projects/{project}/regions/{region}/healthChecks", + "httpMethod": "GET", + "id": "compute.regionHealthChecks.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/healthChecks", + "response": { + "$ref": "HealthCheckList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "patch": { + "description": "Updates a HealthCheck resource in the specified project using the data\nincluded in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "httpMethod": "PATCH", + "id": "compute.regionHealthChecks.patch", + "parameterOrder": [ + "project", + "region", + "healthCheck" + ], + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to patch.", "location": "path", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, @@ -32407,7 +32767,7 @@ "methods": { "get": { "description": "Retrieves information about the specified reservation subBlock.", - "flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}", "httpMethod": "GET", "id": "compute.reservationSubBlocks.get", "parameterOrder": [ @@ -32420,6 +32780,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -32457,7 +32818,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}", + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}", "response": { "$ref": "ReservationSubBlocksGetResponse" }, @@ -32469,7 +32830,7 @@ }, "getIamPolicy": { "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", - "flatPath": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/getIamPolicy", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/getIamPolicy", "httpMethod": "GET", "id": "compute.reservationSubBlocks.getIamPolicy", "parameterOrder": [ @@ -32514,7 +32875,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/getIamPolicy", + "path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/getIamPolicy", "response": { "$ref": "Policy" }, @@ -32526,7 +32887,7 @@ }, "list": { "description": "Retrieves a list of reservation subBlocks under a single reservation.", - "flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks", "httpMethod": "GET", "id": "compute.reservationSubBlocks.list", "parameterOrder": [ @@ -32561,6 +32922,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -32582,7 +32944,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks", + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks", "response": { "$ref": "ReservationSubBlocksListResponse" }, @@ -32594,7 +32956,7 @@ }, "performMaintenance": { "description": "Allows customers to perform maintenance on a reservation subBlock", - "flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", "httpMethod": "POST", "id": "compute.reservationSubBlocks.performMaintenance", "parameterOrder": [ @@ -32607,6 +32969,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -32634,7 +32997,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", "response": { "$ref": "Operation" }, @@ -32645,7 +33008,7 @@ }, "reportFaulty": { "description": "Allows customers to report a faulty subBlock.", - "flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", "httpMethod": "POST", "id": "compute.reservationSubBlocks.reportFaulty", "parameterOrder": [ @@ -32658,6 +33021,7 @@ "parentName": { "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", "required": true, "type": "string" }, @@ -32685,7 +33049,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", "request": { "$ref": "ReservationSubBlocksReportFaultyRequest" }, @@ -32699,7 +33063,7 @@ }, "setIamPolicy": { "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", - "flatPath": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/setIamPolicy", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/setIamPolicy", "httpMethod": "POST", "id": "compute.reservationSubBlocks.setIamPolicy", "parameterOrder": [ @@ -32738,7 +33102,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/setIamPolicy", + "path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/setIamPolicy", "request": { "$ref": "ZoneSetNestedPolicyRequest" }, @@ -32752,7 +33116,7 @@ }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource.", - "flatPath": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/testIamPermissions", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/testIamPermissions", "httpMethod": "POST", "id": "compute.reservationSubBlocks.testIamPermissions", "parameterOrder": [ @@ -32791,7 +33155,7 @@ "type": "string" } }, - "path": "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/testIamPermissions", + "path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/testIamPermissions", "request": { "$ref": "TestPermissionsRequest" }, @@ -43142,7 +43506,7 @@ } } }, - "revision": "20260206", + "revision": "20260213", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -45023,7 +45387,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026 PATCH) when\nempty.", + "description": "Input only. Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026 PATCH) when\nempty.", "type": "object" }, "resourcePolicies": { @@ -45984,6 +46348,10 @@ "format": "float", "type": "number" }, + "orchestrationInfo": { + "$ref": "BackendBackendOrchestrationInfo", + "description": "Information about the resource or system that manages the backend." + }, "preference": { "description": "This field indicates whether this backend should be fully utilized before\nsending traffic to backends with default preference. The possible values\nare:\n \n - PREFERRED: Backends with this preference level will be\n filled up to their capacity limits first, based on RTT.\n - DEFAULT: If preferred backends don't have enough\n capacity, backends in this layer would be used and traffic would be\n assigned based on the load balancing algorithm you use. This is the\n default", "enum": [ @@ -46001,6 +46369,17 @@ }, "type": "object" }, + "BackendBackendOrchestrationInfo": { + "description": "A message containing information about the resource or system that manages\nthe backend.", + "id": "BackendBackendOrchestrationInfo", + "properties": { + "resourceUri": { + "description": "The URI of the resource or system that manages the backend.", + "type": "string" + } + }, + "type": "object" + }, "BackendBucket": { "description": "Represents a Cloud Storage Bucket resource.\n\nThis Cloud Storage bucket resource is referenced by a URL map of a load\nbalancer. For more information, readBackend Buckets.", "id": "BackendBucket", @@ -46663,6 +47042,10 @@ "$ref": "BackendServiceNetworkPassThroughLbTrafficPolicy", "description": "Configures traffic steering properties of internal passthrough Network\nLoad Balancers.\n\nnetworkPassThroughLbTrafficPolicy cannot be specified with haPolicy." }, + "orchestrationInfo": { + "$ref": "BackendServiceOrchestrationInfo", + "description": "Information about the resource or system that manages the backend service." + }, "outlierDetection": { "$ref": "OutlierDetection", "description": "Settings controlling the ejection of unhealthy backend endpoints from the\nload balancing pool of each individual proxy instance that processes the\ntraffic for the given backend service. If not set, this feature is\nconsidered disabled.\n\nResults of the outlier detection algorithm (ejection of endpoints from the\nload balancing pool and returning them back to the pool) are executed\nindependently by each proxy instance of the load balancer. In most cases,\nmore than one proxy instance handles the traffic received by a backend\nservice. Thus, it is possible that an unhealthy endpoint is detected and\nejected by only some of the proxies, and while this happens, other proxies\nmay continue to send requests to the same unhealthy endpoint until they\ndetect and eject the unhealthy endpoint.\n\nApplicable backend endpoints can be:\n \n - VM instances in an Instance Group\n - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)\n - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)\n - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud\n Functions Services \n - Private Service Connect NEGs, that resolve to\n Google-managed regional API endpoints or managed services published using\n Private Service Connect\n\n\n\nApplicable backend service types can be:\n \n - A global backend service with the loadBalancingScheme set to\n INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED. \n - A regional backend\n service with the serviceProtocol set to HTTP, HTTPS, HTTP2 or H2C, and\n loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not\n supported for Serverless NEGs.\n\n\n\nNot supported when the backend service is referenced by a URL map that is\nbound to target gRPC proxy that has validateForProxyless field set to true." @@ -47707,6 +48090,17 @@ }, "type": "object" }, + "BackendServiceOrchestrationInfo": { + "description": "A message containing information about the resource or system that manages\nthe backend service.", + "id": "BackendServiceOrchestrationInfo", + "properties": { + "resourceUri": { + "description": "The resource URI of the resource or system that manages the backend\nservice.", + "type": "string" + } + }, + "type": "object" + }, "BackendServiceParams": { "description": "Additional Backend Service parameters.", "id": "BackendServiceParams", @@ -50489,7 +50883,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "description": "Input only. Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", "type": "object" } }, @@ -51610,6 +52004,10 @@ "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" }, + "params": { + "$ref": "ExternalVpnGatewayParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, "redundancyType": { "description": "Indicates the user-supplied redundancy type of this external VPN gateway.", "enum": [ @@ -51812,6 +52210,19 @@ }, "type": "object" }, + "ExternalVpnGatewayParams": { + "id": "ExternalVpnGatewayParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" + }, + "description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID \u0026 namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.\n* Inconsistent format is not supported. For instance:\n {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", + "type": "object" + } + }, + "type": "object" + }, "FileContentBuffer": { "id": "FileContentBuffer", "properties": { @@ -55378,155 +55789,18 @@ }, "type": "object" }, - "HealthCheck": { - "description": "Represents a health check resource.\n\nGoogle Compute Engine has two health check resources:\n\n* [Regional](/compute/docs/reference/rest/v1/regionHealthChecks)\n* [Global](/compute/docs/reference/rest/v1/healthChecks)\n\nThese health check resources can be used for load balancing and for\nautohealing VMs in a managed instance group (MIG).\n\n**Load balancing**\n\nHealth check requirements vary depending on the type of load balancer. For\ndetails about the type of health check supported for\neach load balancer and corresponding backend type,\nsee Health\nchecks overview: Load balancer guide.\n\n**Autohealing in MIGs**\n\nThe health checks that you use for autohealing VMs in a MIG can be either\nregional or global. For more information, see Set up an\napplication health check and autohealing.\n\nFor more information, seeHealth checks\noverview.", - "id": "HealthCheck", + "HealthAggregationPoliciesScopedList": { + "id": "HealthAggregationPoliciesScopedList", "properties": { - "checkIntervalSec": { - "description": "How often (in seconds) to send a health check. The default value is 5\nseconds.", - "format": "int32", - "type": "integer" - }, - "creationTimestamp": { - "description": "Output only. [Output Only] Creation timestamp in3339\ntext format.", - "readOnly": true, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", - "type": "string" - }, - "grpcHealthCheck": { - "$ref": "GRPCHealthCheck" - }, - "grpcTlsHealthCheck": { - "$ref": "GRPCTLSHealthCheck" - }, - "healthyThreshold": { - "description": "A so-far unhealthy instance will be marked healthy after this\nmany consecutive successes. The default value is 2.", - "format": "int32", - "type": "integer" - }, - "http2HealthCheck": { - "$ref": "HTTP2HealthCheck" - }, - "httpHealthCheck": { - "$ref": "HTTPHealthCheck" - }, - "httpsHealthCheck": { - "$ref": "HTTPSHealthCheck" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", - "format": "uint64", - "type": "string" - }, - "kind": { - "default": "compute#healthCheck", - "description": "Output only. Type of the resource.", - "readOnly": true, - "type": "string" - }, - "logConfig": { - "$ref": "HealthCheckLogConfig", - "description": "Configure logging on this health check." - }, - "name": { - "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nFor example, a name that is 1-63 characters long, matches the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with\nRFC1035. This regular expression describes a name where the first\ncharacter is a lowercase letter, and all following characters are a dash,\nlowercase letter, or digit, except the last character, which isn't a dash.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "type": "string" - }, - "region": { - "description": "Output only. [Output Only] Region where the health check resides. Not applicable to\nglobal health checks.", - "readOnly": true, - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "sourceRegions": { - "description": "The list of cloud regions from which health checks are performed. If any\nregions are specified, then exactly 3 regions should be specified. The\nregion names must be valid names of Google Cloud regions.\nThis can only be set for global health check.\nIf this list is non-empty, then there are restrictions\non what other health check fields are supported and what other resources\ncan use this health check:\n \n - SSL, HTTP2, and GRPC protocols are not supported.\n - The TCP request field is not supported.\n - The proxyHeader field for HTTP, HTTPS, and TCP is not\n supported.\n - The checkIntervalSec field must be at least 30.\n - The health check cannot be used with BackendService nor with managed\n instance group auto-healing.", + "healthAggregationPolicies": { + "description": "A list of HealthAggregationPolicys contained in this scope.", "items": { - "type": "string" + "$ref": "HealthAggregationPolicy" }, "type": "array" }, - "sslHealthCheck": { - "$ref": "SSLHealthCheck" - }, - "tcpHealthCheck": { - "$ref": "TCPHealthCheck" - }, - "timeoutSec": { - "description": "How long (in seconds) to wait before claiming failure. The default value is\n5 seconds. It is invalid for timeoutSec to have greater\nvalue than checkIntervalSec.", - "format": "int32", - "type": "integer" - }, - "type": { - "description": "Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2 or GRPC. Exactly one of the\nprotocol-specific health check fields must be specified, which must matchtype field.", - "enum": [ - "GRPC", - "GRPC_WITH_TLS", - "HTTP", - "HTTP2", - "HTTPS", - "INVALID", - "SSL", - "TCP" - ], - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "" - ], - "type": "string" - }, - "unhealthyThreshold": { - "description": "A so-far healthy instance will be marked unhealthy after this many\nconsecutive failures. The default value is 2.", - "format": "int32", - "type": "integer" - } - }, - "type": "object" - }, - "HealthCheckList": { - "description": "Contains a list of HealthCheck resources.", - "id": "HealthCheckList", - "properties": { - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of HealthCheck resources.", - "items": { - "$ref": "HealthCheck" - }, - "type": "array" - }, - "kind": { - "default": "compute#healthCheckList", - "description": "Output only. Type of resource.", - "readOnly": true, - "type": "string" - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "Output only. [Output Only] Server-defined URL for this resource.", - "readOnly": true, - "type": "string" - }, "warning": { - "description": "[Output Only] Informational warning message.", + "description": "Informational warning which replaces the list of health aggregation\npolicies when the list is empty.", "properties": { "code": { "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", @@ -55652,30 +55926,9 @@ }, "type": "object" }, - "HealthCheckLogConfig": { - "description": "Configuration of logging on a health check. If logging is enabled, logs\nwill be exported to Stackdriver.", - "id": "HealthCheckLogConfig", - "properties": { - "enable": { - "description": "Indicates whether or not to export logs. This is false by default, which\nmeans no health check logging will be done.", - "type": "boolean" - } - }, - "type": "object" - }, - "HealthCheckReference": { - "description": "A full or valid partial URL to a health check. For example, the following are\nvalid URLs:\n \n - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check\n - projects/project-id/global/httpHealthChecks/health-check\n - global/httpHealthChecks/health-check", - "id": "HealthCheckReference", - "properties": { - "healthCheck": { - "type": "string" - } - }, - "type": "object" - }, - "HealthCheckService": { - "description": "Represents a Health-Check as a Service resource.", - "id": "HealthCheckService", + "HealthAggregationPolicy": { + "description": "Represents a health aggregation policy.\n\nA health aggregation policy resource defines a policy to aggregate health.\n\nFor more information, see\nHealth checks overview.", + "id": "HealthAggregationPolicy", "properties": { "creationTimestamp": { "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", @@ -55687,28 +55940,14 @@ "type": "string" }, "fingerprint": { - "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a HealthCheckService. An up-to-date fingerprint must\nbe provided in order to patch/update the HealthCheckService; Otherwise, the\nrequest will fail with error 412 conditionNotMet. To see the\nlatest fingerprint, make a get() request to retrieve the\nHealthCheckService.", + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a HealthAggregationPolicy. An up-to-date fingerprint\nmust be provided in order to patch the HealthAggregationPolicy; Otherwise,\nthe request will fail with error 412 conditionNotMet. To see\nthe latest fingerprint, make a get() request to retrieve the\nHealthAggregationPolicy.", "format": "byte", "type": "string" }, - "healthChecks": { - "description": "A list of URLs to the HealthCheck resources. Must have\nat least one HealthCheck, and not more than 10 for regionalHealthCheckService, and not more than 1 for globalHealthCheckService.HealthCheck resources must haveportSpecification=USE_SERVING_PORT orportSpecification=USE_FIXED_PORT. For\nregional HealthCheckService, theHealthCheck must be regional and in the same\nregion. For global HealthCheckService,HealthCheck must be global. Mix of regional and globalHealthChecks is not supported. Multiple regionalHealthChecks must belong to the same region. RegionalHealthChecks must belong to the same region as zones ofNetworkEndpointGroups. For globalHealthCheckService using globalINTERNET_IP_PORT NetworkEndpointGroups, the\nglobal HealthChecks must specify sourceRegions,\nand HealthChecks that specify sourceRegions can\nonly be used with global INTERNET_IP_PORTNetworkEndpointGroups.", - "items": { - "type": "string" - }, - "type": "array" - }, - "healthStatusAggregationPolicy": { - "description": "Optional. Policy for how the results from multiple health checks\nfor the same endpoint are aggregated. Defaults to NO_AGGREGATION\nif unspecified.\n \n - NO_AGGREGATION. An EndpointHealth message is\n returned for each pair in the health check\n service.\n - AND. If any health check of an endpoint reportsUNHEALTHY, then UNHEALTHY is theHealthState of the endpoint. If all health checks reportHEALTHY, the HealthState of the endpoint isHEALTHY.\n\n.\nThis is only allowed with regional HealthCheckService.", - "enum": [ - "AND", - "NO_AGGREGATION" - ], - "enumDescriptions": [ - "If any backend's health check reports UNHEALTHY,\nthen UNHEALTHY is the HealthState of\nthe entire health check service. If all backend's are healthy,\nthe HealthState of the health check service isHEALTHY.", - "An EndpointHealth message is returned for each\nbackend in the health check service." - ], - "type": "string" + "healthyPercentThreshold": { + "description": "Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies the threshold (as a\npercentage) of healthy endpoints required in order to consider the\naggregated health result HEALTHY. Defaults to 60. Must be in\nrange [0, 100]. Not applicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional,\nand will be set to the default if unspecified. Note that both this\nthreshold and minHealthyThreshold must be satisfied in order\nfor HEALTHY to be the aggregated result. \"Endpoints\" refers to network\nendpoints within a Network Endpoint Group or instances within an Instance\nGroup.", + "format": "uint32", + "type": "integer" }, "id": { "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", @@ -55717,32 +55956,35 @@ "type": "string" }, "kind": { - "default": "compute#healthCheckService", - "description": "Output only. [Output only] Type of the resource. Alwayscompute#healthCheckServicefor health check services.", + "default": "compute#healthAggregationPolicy", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#healthAggregationPolicy for health aggregation\npolicies.", "readOnly": true, "type": "string" }, + "minHealthyThreshold": { + "description": "Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies the minimum number of\nhealthy endpoints required in order to consider the aggregated health\nresult HEALTHY. Defaults to 1. Must be positive. Not\napplicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional,\nand will be set to the default if unspecified. Note that both this\nthreshold and healthyPercentThreshold must be satisfied in\norder for HEALTHY to be the aggregated result. \"Endpoints\" refers to\nnetwork endpoints within a Network Endpoint Group or instances within an\nInstance Group.", + "format": "uint32", + "type": "integer" + }, "name": { - "description": "Name of the resource. The name must be 1-63 characters long, and comply\nwith RFC1035. Specifically, the name must be 1-63 characters\nlong and match the regular expression\n`[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character\nmust be a lowercase letter, and all following characters must be a dash,\nlowercase letter, or digit, except the last character, which cannot be a\ndash.", + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" }, - "networkEndpointGroups": { - "description": "A list of URLs to the NetworkEndpointGroup\nresources. Must not have more than 100. For regionalHealthCheckService, NEGs must be in\nzones in the region of the HealthCheckService. For globalHealthCheckServices, the NetworkEndpointGroups\nmust be global INTERNET_IP_PORT.", - "items": { - "type": "string" - }, - "type": "array" - }, - "notificationEndpoints": { - "description": "A list of URLs to the NotificationEndpoint\nresources. Must not have more than 10. A list of endpoints for\nreceiving notifications of change in health status. For regionalHealthCheckService,NotificationEndpoint must be regional and in the\nsame region. For global HealthCheckService,NotificationEndpoint must be global.", - "items": { - "type": "string" - }, - "type": "array" + "policyType": { + "description": "Specifies the type of the healthAggregationPolicy. The only allowed value\nfor global resources is DNS_PUBLIC_IP_POLICY. The only allowed\nvalue for regional resources is BACKEND_SERVICE_POLICY. Must\nbe specified when the healthAggregationPolicy is created, and cannot be\nmutated.", + "enum": [ + "BACKEND_SERVICE_POLICY", + "DNS_PUBLIC_IP_POLICY" + ], + "enumDescriptions": [ + "", + "" + ], + "type": "string" }, "region": { - "description": "Output only. [Output Only] URL of the region where the health check service\nresides. This field is not applicable to global health check services.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "description": "Output only. [Output Only] URL of the region where the health aggregation policy\nresides. This field applies only to the regional resource. You must specify\nthis field as part of the HTTP request URL. It is not settable as a field\nin the request body.", "readOnly": true, "type": "string" }, @@ -55750,45 +55992,39 @@ "description": "Output only. [Output Only] Server-defined URL for the resource.", "readOnly": true, "type": "string" - } - }, - "type": "object" - }, - "HealthCheckServiceReference": { - "description": "A full or valid partial URL to a health check service. For example, the\nfollowing are valid URLs:\n \n - https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service\n - projects/project-id/regions/us-west1/healthCheckServices/health-check-service\n - regions/us-west1/healthCheckServices/health-check-service", - "id": "HealthCheckServiceReference", - "properties": { - "healthCheckService": { + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL with id for the resource.", + "readOnly": true, "type": "string" } }, "type": "object" }, - "HealthCheckServicesList": { - "id": "HealthCheckServicesList", + "HealthAggregationPolicyAggregatedList": { + "description": "Contains a list of HealthAggregationPoliciesScopedList.", + "id": "HealthAggregationPolicyAggregatedList", "properties": { "id": { - "description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", - "readOnly": true, + "description": "[Output Only] Unique identifier for the resource; defined by the server.", "type": "string" }, "items": { - "description": "Output only. A list of HealthCheckService resources.", - "items": { - "$ref": "HealthCheckService" + "additionalProperties": { + "$ref": "HealthAggregationPoliciesScopedList", + "description": "Name of the scope containing this set of HealthAggregationPolicies." }, - "readOnly": true, - "type": "array" + "description": "A list of HealthAggregationPoliciesScopedList resources.", + "type": "object" }, "kind": { - "default": "compute#healthCheckServicesList", - "description": "Output only. [Output Only] Type of the resource. Alwayscompute#healthCheckServicesList for lists of\nHealthCheckServices.", + "default": "compute#healthAggregationPolicyAggregatedList", + "description": "Output only. Type of resource.", "readOnly": true, "type": "string" }, "nextPageToken": { - "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", - "readOnly": true, + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", "type": "string" }, "selfLink": { @@ -55796,6 +56032,14 @@ "readOnly": true, "type": "string" }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "warning": { "description": "[Output Only] Informational warning message.", "properties": { @@ -55923,24 +56167,23 @@ }, "type": "object" }, - "HealthChecksAggregatedList": { - "id": "HealthChecksAggregatedList", + "HealthAggregationPolicyList": { + "id": "HealthAggregationPolicyList", "properties": { "id": { "description": "[Output Only] Unique identifier for the resource; defined by the server.", "type": "string" }, "items": { - "additionalProperties": { - "$ref": "HealthChecksScopedList", - "description": "Name of the scope containing this set of HealthChecks." + "description": "A list of HealthAggregationPolicy resources.", + "items": { + "$ref": "HealthAggregationPolicy" }, - "description": "A list of HealthChecksScopedList resources.", - "type": "object" + "type": "array" }, "kind": { - "default": "compute#healthChecksAggregatedList", - "description": "Output only. Type of resource.", + "default": "compute#healthAggregationPolicyList", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#healthAggregationPolicy for health aggregation\npolicies.", "readOnly": true, "type": "string" }, @@ -55949,18 +56192,9 @@ "type": "string" }, "selfLink": { - "description": "Output only. [Output Only] Server-defined URL for this resource.", - "readOnly": true, + "description": "[Output Only] Server-defined URL for this resource.", "type": "string" }, - "unreachables": { - "description": "Output only. [Output Only] Unreachable resources.", - "items": { - "type": "string" - }, - "readOnly": true, - "type": "array" - }, "warning": { "description": "[Output Only] Informational warning message.", "properties": { @@ -56088,18 +56322,728 @@ }, "type": "object" }, - "HealthChecksScopedList": { - "id": "HealthChecksScopedList", + "HealthCheck": { + "description": "Represents a health check resource.\n\nGoogle Compute Engine has two health check resources:\n\n* [Regional](/compute/docs/reference/rest/v1/regionHealthChecks)\n* [Global](/compute/docs/reference/rest/v1/healthChecks)\n\nThese health check resources can be used for load balancing and for\nautohealing VMs in a managed instance group (MIG).\n\n**Load balancing**\n\nHealth check requirements vary depending on the type of load balancer. For\ndetails about the type of health check supported for\neach load balancer and corresponding backend type,\nsee Health\nchecks overview: Load balancer guide.\n\n**Autohealing in MIGs**\n\nThe health checks that you use for autohealing VMs in a MIG can be either\nregional or global. For more information, see Set up an\napplication health check and autohealing.\n\nFor more information, seeHealth checks\noverview.", + "id": "HealthCheck", "properties": { - "healthChecks": { - "description": "A list of HealthChecks contained in this scope.", + "checkIntervalSec": { + "description": "How often (in seconds) to send a health check. The default value is 5\nseconds.", + "format": "int32", + "type": "integer" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp in3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "grpcHealthCheck": { + "$ref": "GRPCHealthCheck" + }, + "grpcTlsHealthCheck": { + "$ref": "GRPCTLSHealthCheck" + }, + "healthyThreshold": { + "description": "A so-far unhealthy instance will be marked healthy after this\nmany consecutive successes. The default value is 2.", + "format": "int32", + "type": "integer" + }, + "http2HealthCheck": { + "$ref": "HTTP2HealthCheck" + }, + "httpHealthCheck": { + "$ref": "HTTPHealthCheck" + }, + "httpsHealthCheck": { + "$ref": "HTTPSHealthCheck" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#healthCheck", + "description": "Output only. Type of the resource.", + "readOnly": true, + "type": "string" + }, + "logConfig": { + "$ref": "HealthCheckLogConfig", + "description": "Configure logging on this health check." + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nFor example, a name that is 1-63 characters long, matches the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with\nRFC1035. This regular expression describes a name where the first\ncharacter is a lowercase letter, and all following characters are a dash,\nlowercase letter, or digit, except the last character, which isn't a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "region": { + "description": "Output only. [Output Only] Region where the health check resides. Not applicable to\nglobal health checks.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "sourceRegions": { + "description": "The list of cloud regions from which health checks are performed. If any\nregions are specified, then exactly 3 regions should be specified. The\nregion names must be valid names of Google Cloud regions.\nThis can only be set for global health check.\nIf this list is non-empty, then there are restrictions\non what other health check fields are supported and what other resources\ncan use this health check:\n \n - SSL, HTTP2, and GRPC protocols are not supported.\n - The TCP request field is not supported.\n - The proxyHeader field for HTTP, HTTPS, and TCP is not\n supported.\n - The checkIntervalSec field must be at least 30.\n - The health check cannot be used with BackendService nor with managed\n instance group auto-healing.", + "items": { + "type": "string" + }, + "type": "array" + }, + "sslHealthCheck": { + "$ref": "SSLHealthCheck" + }, + "tcpHealthCheck": { + "$ref": "TCPHealthCheck" + }, + "timeoutSec": { + "description": "How long (in seconds) to wait before claiming failure. The default value is\n5 seconds. It is invalid for timeoutSec to have greater\nvalue than checkIntervalSec.", + "format": "int32", + "type": "integer" + }, + "type": { + "description": "Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2 or GRPC. Exactly one of the\nprotocol-specific health check fields must be specified, which must matchtype field.", + "enum": [ + "GRPC", + "GRPC_WITH_TLS", + "HTTP", + "HTTP2", + "HTTPS", + "INVALID", + "SSL", + "TCP" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "" + ], + "type": "string" + }, + "unhealthyThreshold": { + "description": "A so-far healthy instance will be marked unhealthy after this many\nconsecutive failures. The default value is 2.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "HealthCheckList": { + "description": "Contains a list of HealthCheck resources.", + "id": "HealthCheckList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of HealthCheck resources.", "items": { "$ref": "HealthCheck" }, "type": "array" }, + "kind": { + "default": "compute#healthCheckList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, "warning": { - "description": "Informational warning which replaces the list of\nbackend services when the list is empty.", + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + } + }, + "type": "object" + } + }, + "type": "object" + }, + "HealthCheckLogConfig": { + "description": "Configuration of logging on a health check. If logging is enabled, logs\nwill be exported to Stackdriver.", + "id": "HealthCheckLogConfig", + "properties": { + "enable": { + "description": "Indicates whether or not to export logs. This is false by default, which\nmeans no health check logging will be done.", + "type": "boolean" + } + }, + "type": "object" + }, + "HealthCheckReference": { + "description": "A full or valid partial URL to a health check. For example, the following are\nvalid URLs:\n \n - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check\n - projects/project-id/global/httpHealthChecks/health-check\n - global/httpHealthChecks/health-check", + "id": "HealthCheckReference", + "properties": { + "healthCheck": { + "type": "string" + } + }, + "type": "object" + }, + "HealthCheckService": { + "description": "Represents a Health-Check as a Service resource.", + "id": "HealthCheckService", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a HealthCheckService. An up-to-date fingerprint must\nbe provided in order to patch/update the HealthCheckService; Otherwise, the\nrequest will fail with error 412 conditionNotMet. To see the\nlatest fingerprint, make a get() request to retrieve the\nHealthCheckService.", + "format": "byte", + "type": "string" + }, + "healthChecks": { + "description": "A list of URLs to the HealthCheck resources. Must have\nat least one HealthCheck, and not more than 10 for regionalHealthCheckService, and not more than 1 for globalHealthCheckService.HealthCheck resources must haveportSpecification=USE_SERVING_PORT orportSpecification=USE_FIXED_PORT. For\nregional HealthCheckService, theHealthCheck must be regional and in the same\nregion. For global HealthCheckService,HealthCheck must be global. Mix of regional and globalHealthChecks is not supported. Multiple regionalHealthChecks must belong to the same region. RegionalHealthChecks must belong to the same region as zones ofNetworkEndpointGroups. For globalHealthCheckService using globalINTERNET_IP_PORT NetworkEndpointGroups, the\nglobal HealthChecks must specify sourceRegions,\nand HealthChecks that specify sourceRegions can\nonly be used with global INTERNET_IP_PORTNetworkEndpointGroups.", + "items": { + "type": "string" + }, + "type": "array" + }, + "healthStatusAggregationPolicy": { + "description": "Optional. Policy for how the results from multiple health checks\nfor the same endpoint are aggregated. Defaults to NO_AGGREGATION\nif unspecified.\n \n - NO_AGGREGATION. An EndpointHealth message is\n returned for each pair in the health check\n service.\n - AND. If any health check of an endpoint reportsUNHEALTHY, then UNHEALTHY is theHealthState of the endpoint. If all health checks reportHEALTHY, the HealthState of the endpoint isHEALTHY.\n\n.\nThis is only allowed with regional HealthCheckService.", + "enum": [ + "AND", + "NO_AGGREGATION" + ], + "enumDescriptions": [ + "If any backend's health check reports UNHEALTHY,\nthen UNHEALTHY is the HealthState of\nthe entire health check service. If all backend's are healthy,\nthe HealthState of the health check service isHEALTHY.", + "An EndpointHealth message is returned for each\nbackend in the health check service." + ], + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#healthCheckService", + "description": "Output only. [Output only] Type of the resource. Alwayscompute#healthCheckServicefor health check services.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. The name must be 1-63 characters long, and comply\nwith RFC1035. Specifically, the name must be 1-63 characters\nlong and match the regular expression\n`[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character\nmust be a lowercase letter, and all following characters must be a dash,\nlowercase letter, or digit, except the last character, which cannot be a\ndash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "networkEndpointGroups": { + "description": "A list of URLs to the NetworkEndpointGroup\nresources. Must not have more than 100. For regionalHealthCheckService, NEGs must be in\nzones in the region of the HealthCheckService. For globalHealthCheckServices, the NetworkEndpointGroups\nmust be global INTERNET_IP_PORT.", + "items": { + "type": "string" + }, + "type": "array" + }, + "notificationEndpoints": { + "description": "A list of URLs to the NotificationEndpoint\nresources. Must not have more than 10. A list of endpoints for\nreceiving notifications of change in health status. For regionalHealthCheckService,NotificationEndpoint must be regional and in the\nsame region. For global HealthCheckService,NotificationEndpoint must be global.", + "items": { + "type": "string" + }, + "type": "array" + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the health check service\nresides. This field is not applicable to global health check services.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "HealthCheckServiceReference": { + "description": "A full or valid partial URL to a health check service. For example, the\nfollowing are valid URLs:\n \n - https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service\n - projects/project-id/regions/us-west1/healthCheckServices/health-check-service\n - regions/us-west1/healthCheckServices/health-check-service", + "id": "HealthCheckServiceReference", + "properties": { + "healthCheckService": { + "type": "string" + } + }, + "type": "object" + }, + "HealthCheckServicesList": { + "id": "HealthCheckServicesList", + "properties": { + "id": { + "description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", + "readOnly": true, + "type": "string" + }, + "items": { + "description": "Output only. A list of HealthCheckService resources.", + "items": { + "$ref": "HealthCheckService" + }, + "readOnly": true, + "type": "array" + }, + "kind": { + "default": "compute#healthCheckServicesList", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#healthCheckServicesList for lists of\nHealthCheckServices.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + } + }, + "type": "object" + } + }, + "type": "object" + }, + "HealthChecksAggregatedList": { + "id": "HealthChecksAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "HealthChecksScopedList", + "description": "Name of the scope containing this set of HealthChecks." + }, + "description": "A list of HealthChecksScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#healthChecksAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + } + }, + "type": "object" + } + }, + "type": "object" + }, + "HealthChecksScopedList": { + "id": "HealthChecksScopedList", + "properties": { + "healthChecks": { + "description": "A list of HealthChecks contained in this scope.", + "items": { + "$ref": "HealthCheck" + }, + "type": "array" + }, + "warning": { + "description": "Informational warning which replaces the list of\nbackend services when the list is empty.", "properties": { "code": { "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", @@ -57635,7 +58579,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the image. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "description": "Input only. Resource manager tags to be bound to the image. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", "type": "object" } }, @@ -61236,7 +62180,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "description": "Input only. Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", "type": "object" } }, @@ -61346,7 +62290,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and\nvalues are in the format `tagValues/456`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "description": "Input only. Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and\nvalues are in the format `tagValues/456`. The field is ignored (both PUT \u0026\nPATCH) when empty.", "type": "object" }, "resourcePolicies": { @@ -67378,7 +68322,7 @@ "additionalProperties": { "$ref": "LocationPolicyLocation" }, - "description": "Location configurations mapped by location name.\nCurrently only zone names are supported and must be represented as valid\ninternal URLs, such as zones/us-central1-a.", + "description": "Location configurations mapped by location name.\nCurrently only zone names are supported and must be represented as valid\ninternal URLs, such as zones/us-central1-a.\nThe bulkInsert operation doesn't create instances in an AI zone, even if\nan AI zone is available in the specified region. For example, if you set a\nDENY preference for us-central1-a, Compute Engine will consider\nus-central1-b and us-central1-c for instance creation, but not\nus-central1-ai1a. Also, you can't use the locations[] configuration to\nallow instance creation in an AI zone. To include an AI zone in bulkInsert\noperations, use the locationPolicy.zones[] field.", "type": "object" }, "targetShape": { @@ -67394,6 +68338,13 @@ "GCE prioritizes acquisition of resources, scheduling VMs in zones\nwhere resources are available while distributing VMs as evenly as\npossible across allowed zones to minimize the impact of zonal failure.\nRecommended for highly available serving workloads." ], "type": "string" + }, + "zones": { + "description": "The bulkInsert operation applies any preferences set in the locations\nfield to the specific zones listed in the zones field if the same zones\nare specified in both fields.", + "items": { + "$ref": "LocationPolicyZoneConfiguration" + }, + "type": "array" } }, "type": "object" @@ -67434,6 +68385,16 @@ }, "type": "object" }, + "LocationPolicyZoneConfiguration": { + "id": "LocationPolicyZoneConfiguration", + "properties": { + "zone": { + "description": "The URL of the zone.\nThe zone must exist in the region where the request is called.\nZones must be represented as valid partial URLs,\nsuch as zones/us-central1-a.", + "type": "string" + } + }, + "type": "object" + }, "MachineImage": { "description": "Represents a machine image resource.\n\nA machine image is a Compute Engine resource that stores all the\nconfiguration, metadata, permissions, and data from one or more disks\nrequired to create a Virtual machine (VM) instance. For more information, seeMachine images.", "id": "MachineImage", @@ -80457,6 +81418,10 @@ "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" }, + "params": { + "$ref": "ReservationParams", + "description": "Input only. Additional params passed with the request, but not persisted\nas part of resource payload." + }, "protectionTier": { "description": "Protection tier for the workload which specifies the workload expectations\nin the event of infrastructure failures at data center (e.g. power\nand/or cooling failures).", "enum": [ @@ -81286,6 +82251,20 @@ }, "type": "object" }, + "ReservationParams": { + "description": "Additional reservation params.", + "id": "ReservationParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" + }, + "description": "Input only. Resource manager tags to be bound to the reservation. Tag keys and\nvalues have the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "type": "object" + } + }, + "type": "object" + }, "ReservationSlot": { "description": "Represents a reservation slot resource.", "id": "ReservationSlot", @@ -81338,13 +82317,15 @@ "ACTIVE", "CREATING", "DELETING", - "STATE_UNSPECIFIED" + "STATE_UNSPECIFIED", + "UNAVAILABLE" ], "enumDescriptions": [ "The reservation slot has allocated all its resources.", "The resources are being allocated for the reservation slot.", "The reservation slot is currently being deleted.", - "" + "", + "The reservation slot is currently unavailable." ], "readOnly": true, "type": "string" @@ -83153,6 +84134,10 @@ "description": "Effective enable-oslogin value at Instance level.", "type": "boolean" }, + "gceContainerDeclarationMetadataValue": { + "description": "Effective gce-container-declaration value at Instance level.", + "type": "boolean" + }, "serialPortEnableMetadataValue": { "description": "Effective serial-port-enable value at Instance level.", "type": "boolean" @@ -88791,7 +89776,7 @@ "additionalProperties": { "type": "string" }, - "description": "Resource manager tags to be bound to the snapshot. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", + "description": "Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced\nformat such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT \u0026\nPATCH) when empty.", "type": "object" } }, @@ -96302,6 +97287,10 @@ "description": "URL of the network to which this VPN gateway is attached. Provided by the\nclient when the VPN gateway is created.", "type": "string" }, + "params": { + "$ref": "TargetVpnGatewayParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, "region": { "description": "[Output Only] URL of the region where the target VPN gateway resides.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", "type": "string" @@ -96658,6 +97647,19 @@ }, "type": "object" }, + "TargetVpnGatewayParams": { + "id": "TargetVpnGatewayParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" + }, + "description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID \u0026 namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.\n* Inconsistent format is not supported. For instance:\n {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", + "type": "object" + } + }, + "type": "object" + }, "TargetVpnGatewaysScopedList": { "id": "TargetVpnGatewaysScopedList", "properties": { @@ -98311,6 +99313,10 @@ "description": "URL of the network to which this VPN gateway is attached. Provided by the\nclient when the VPN gateway is created.", "type": "string" }, + "params": { + "$ref": "VpnGatewayParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, "region": { "description": "Output only. [Output Only] URL of the region where the VPN gateway resides.", "readOnly": true, @@ -98667,6 +99673,19 @@ }, "type": "object" }, + "VpnGatewayParams": { + "id": "VpnGatewayParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" + }, + "description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID \u0026 namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.\n* Inconsistent format is not supported. For instance:\n {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", + "type": "object" + } + }, + "type": "object" + }, "VpnGatewayStatus": { "id": "VpnGatewayStatus", "properties": { @@ -99001,6 +100020,10 @@ "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" }, + "params": { + "$ref": "VpnTunnelParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, "peerExternalGateway": { "description": "URL of the peer side external VPN gateway to which this VPN tunnel is\nconnected.\nProvided by the client when the VPN tunnel is created.\nThis field is exclusive with the field peerGcpGateway.", "type": "string" @@ -99429,6 +100452,19 @@ }, "type": "object" }, + "VpnTunnelParams": { + "id": "VpnTunnelParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" + }, + "description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID \u0026 namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.\n* Inconsistent format is not supported. For instance:\n {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", + "type": "object" + } + }, + "type": "object" + }, "VpnTunnelPhase1Algorithms": { "id": "VpnTunnelPhase1Algorithms", "properties": { diff --git a/compute/v1/compute-gen.go b/compute/v1/compute-gen.go index ff703b62a3..50c2c84d14 100644 --- a/compute/v1/compute-gen.go +++ b/compute/v1/compute-gen.go @@ -208,6 +208,7 @@ func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, err s.RegionCommitments = NewRegionCommitmentsService(s) s.RegionDiskTypes = NewRegionDiskTypesService(s) s.RegionDisks = NewRegionDisksService(s) + s.RegionHealthAggregationPolicies = NewRegionHealthAggregationPoliciesService(s) s.RegionHealthCheckServices = NewRegionHealthCheckServicesService(s) s.RegionHealthChecks = NewRegionHealthChecksService(s) s.RegionInstanceGroupManagers = NewRegionInstanceGroupManagersService(s) @@ -406,6 +407,8 @@ type Service struct { RegionDisks *RegionDisksService + RegionHealthAggregationPolicies *RegionHealthAggregationPoliciesService + RegionHealthCheckServices *RegionHealthCheckServicesService RegionHealthChecks *RegionHealthChecksService @@ -1072,6 +1075,15 @@ type RegionDisksService struct { s *Service } +func NewRegionHealthAggregationPoliciesService(s *Service) *RegionHealthAggregationPoliciesService { + rs := &RegionHealthAggregationPoliciesService{s: s} + return rs +} + +type RegionHealthAggregationPoliciesService struct { + s *Service +} + func NewRegionHealthCheckServicesService(s *Service) *RegionHealthCheckServicesService { rs := &RegionHealthCheckServicesService{s: s} return rs @@ -3868,8 +3880,8 @@ type AttachedDiskInitializeParams struct { // You must provide exactly two replica zones, and one zone must be the same // as the instance zone. ReplicaZones []string `json:"replicaZones,omitempty"` - // ResourceManagerTags: Resource manager tags to be bound to the disk. Tag keys - // and values + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // disk. Tag keys and values // have the same definition as resource // manager tags. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -5481,6 +5493,9 @@ type Backend struct { // For usage guidelines, seeUtilization // balancing mode. MaxUtilization float64 `json:"maxUtilization,omitempty"` + // OrchestrationInfo: Information about the resource or system that manages the + // backend. + OrchestrationInfo *BackendBackendOrchestrationInfo `json:"orchestrationInfo,omitempty"` // Preference: This field indicates whether this backend should be fully // utilized before // sending traffic to backends with default preference. The possible @@ -5538,6 +5553,30 @@ func (s *Backend) UnmarshalJSON(data []byte) error { return nil } +// BackendBackendOrchestrationInfo: A message containing information about the +// resource or system that manages +// the backend. +type BackendBackendOrchestrationInfo struct { + // ResourceUri: The URI of the resource or system that manages the backend. + ResourceUri string `json:"resourceUri,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResourceUri") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ResourceUri") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s BackendBackendOrchestrationInfo) MarshalJSON() ([]byte, error) { + type NoMethod BackendBackendOrchestrationInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // BackendBucket: Represents a Cloud Storage Bucket resource. // // This Cloud Storage bucket resource is referenced by a URL map of a @@ -6720,6 +6759,9 @@ type BackendService struct { // // networkPassThroughLbTrafficPolicy cannot be specified with haPolicy. NetworkPassThroughLbTrafficPolicy *BackendServiceNetworkPassThroughLbTrafficPolicy `json:"networkPassThroughLbTrafficPolicy,omitempty"` + // OrchestrationInfo: Information about the resource or system that manages the + // backend service. + OrchestrationInfo *BackendServiceOrchestrationInfo `json:"orchestrationInfo,omitempty"` // OutlierDetection: Settings controlling the ejection of unhealthy backend // endpoints from the // load balancing pool of each individual proxy instance that processes @@ -8585,6 +8627,32 @@ func (s *BackendServiceNetworkPassThroughLbTrafficPolicyZonalAffinity) Unmarshal return nil } +// BackendServiceOrchestrationInfo: A message containing information about the +// resource or system that manages +// the backend service. +type BackendServiceOrchestrationInfo struct { + // ResourceUri: The resource URI of the resource or system that manages the + // backend + // service. + ResourceUri string `json:"resourceUri,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResourceUri") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ResourceUri") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s BackendServiceOrchestrationInfo) MarshalJSON() ([]byte, error) { + type NoMethod BackendServiceOrchestrationInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // BackendServiceParams: Additional Backend Service parameters. type BackendServiceParams struct { // ResourceManagerTags: Tag keys/values directly bound to this resource. @@ -12478,8 +12546,8 @@ func (s DiskMoveRequest) MarshalJSON() ([]byte, error) { // DiskParams: Additional disk params. type DiskParams struct { - // ResourceManagerTags: Resource manager tags to be bound to the disk. Tag keys - // and values + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // disk. Tag keys and values // have the same definition as resource // manager tags. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -14067,6 +14135,10 @@ type ExternalVpnGateway struct { // cannot // be a dash. Name string `json:"name,omitempty"` + // Params: Input only. [Input Only] Additional params passed with the request, + // but not persisted + // as part of resource payload. + Params *ExternalVpnGatewayParams `json:"params,omitempty"` // RedundancyType: Indicates the user-supplied redundancy type of this external // VPN gateway. // @@ -14355,6 +14427,40 @@ func (s ExternalVpnGatewayListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type ExternalVpnGatewayParams struct { + // ResourceManagerTags: Tag keys/values directly bound to this resource. + // Tag keys and values have the same definition as resource + // manager tags. The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + // * Inconsistent format is not supported. For instance: + // {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + ResourceManagerTags map[string]string `json:"resourceManagerTags,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResourceManagerTags") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ResourceManagerTags") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ExternalVpnGatewayParams) MarshalJSON() ([]byte, error) { + type NoMethod ExternalVpnGatewayParams + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type FileContentBuffer struct { // Content: The raw content in the secure keys file. Content string `json:"content,omitempty"` @@ -19185,153 +19291,300 @@ func (s HTTPSHealthCheck) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// HealthCheck: Represents a health check resource. -// -// Google Compute Engine has two health check resources: -// -// * Regional (/compute/docs/reference/rest/v1/regionHealthChecks) -// * Global (/compute/docs/reference/rest/v1/healthChecks) -// -// These health check resources can be used for load balancing and -// for -// autohealing VMs in a managed instance group (MIG). -// -// **Load balancing** -// -// Health check requirements vary depending on the type of load balancer. -// For -// details about the type of health check supported for -// each load balancer and corresponding backend type, -// see Health -// checks overview: Load balancer guide. -// -// **Autohealing in MIGs** +type HealthAggregationPoliciesScopedList struct { + // HealthAggregationPolicies: A list of HealthAggregationPolicys contained in + // this scope. + HealthAggregationPolicies []*HealthAggregationPolicy `json:"healthAggregationPolicies,omitempty"` + // Warning: Informational warning which replaces the list of health + // aggregation + // policies when the list is empty. + Warning *HealthAggregationPoliciesScopedListWarning `json:"warning,omitempty"` + // ForceSendFields is a list of field names (e.g. "HealthAggregationPolicies") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "HealthAggregationPolicies") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s HealthAggregationPoliciesScopedList) MarshalJSON() ([]byte, error) { + type NoMethod HealthAggregationPoliciesScopedList + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// HealthAggregationPoliciesScopedListWarning: Informational warning which +// replaces the list of health aggregation +// policies when the list is empty. +type HealthAggregationPoliciesScopedListWarning struct { + // Code: [Output Only] A warning code, if applicable. For example, + // Compute + // Engine returns NO_RESULTS_ON_PAGE if there + // are no results in the response. + // + // Possible values: + // "CLEANUP_FAILED" - Warning about failed cleanup of transient changes made + // by a failed + // operation. + // "DEPRECATED_RESOURCE_USED" - A link to a deprecated resource was created. + // "DEPRECATED_TYPE_USED" - When deploying and at least one of the resources + // has a type marked as + // deprecated + // "DISK_SIZE_LARGER_THAN_IMAGE_SIZE" - The user created a boot disk that is + // larger than image size. + // "EXPERIMENTAL_TYPE_USED" - When deploying and at least one of the + // resources has a type marked as + // experimental + // "EXTERNAL_API_WARNING" - Warning that is present in an external api call + // "FIELD_VALUE_OVERRIDEN" - Warning that value of a field has been + // overridden. + // Deprecated unused field. + // "INJECTED_KERNELS_DEPRECATED" - The operation involved use of an injected + // kernel, which is deprecated. + // "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB" - A WEIGHTED_MAGLEV backend + // service is associated with a health check that is + // not of type HTTP/HTTPS/HTTP2. + // "LARGE_DEPLOYMENT_WARNING" - When deploying a deployment with a + // exceedingly large number of resources + // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list + // overhead quota exceed + // which captures the amount of resources filtered out by + // user-defined list filter. + // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type + // "NEXT_HOP_ADDRESS_NOT_ASSIGNED" - The route's nextHopIp address is not + // assigned to an instance on the + // network. + // "NEXT_HOP_CANNOT_IP_FORWARD" - The route's next hop instance cannot ip + // forward. + // "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE" - The route's nextHopInstance + // URL refers to an instance that does not have an + // ipv6 interface on the same network as the route. + // "NEXT_HOP_INSTANCE_NOT_FOUND" - The route's nextHopInstance URL refers to + // an instance that does not exist. + // "NEXT_HOP_INSTANCE_NOT_ON_NETWORK" - The route's nextHopInstance URL + // refers to an instance that is not on the + // same network as the route. + // "NEXT_HOP_NOT_RUNNING" - The route's next hop instance does not have a + // status of RUNNING. + // "NOT_CRITICAL_ERROR" - Error which is not critical. We decided to continue + // the process despite + // the mentioned error. + // "NO_RESULTS_ON_PAGE" - No results are present on a particular list page. + // "PARTIAL_SUCCESS" - Success is reported, but some results may be missing + // due to errors + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: + // regions.list). + // "REQUIRED_TOS_AGREEMENT" - The user attempted to use a resource that + // requires a TOS they have not + // accepted. + // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is + // in use. + // "RESOURCE_NOT_DELETED" - One or more of the resources set to auto-delete + // could not be deleted + // because they were in use. + // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is + // ignored. + // "SINGLE_INSTANCE_PROPERTY_TEMPLATE" - Instance template used in instance + // group manager is valid as such, but + // its application does not make a lot of sense, because it allows only + // single instance in instance group. + // "UNDECLARED_PROPERTIES" - When undeclared properties in the schema are + // present + // "UNREACHABLE" - A given scope cannot be reached. + Code string `json:"code,omitempty"` + // Data: [Output Only] Metadata about this warning in key: + // value format. For example: + // + // "data": [ + // { + // "key": "scope", + // "value": "zones/us-east1-d" + // } + Data []*HealthAggregationPoliciesScopedListWarningData `json:"data,omitempty"` + // Message: [Output Only] A human-readable description of the warning code. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Code") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s HealthAggregationPoliciesScopedListWarning) MarshalJSON() ([]byte, error) { + type NoMethod HealthAggregationPoliciesScopedListWarning + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type HealthAggregationPoliciesScopedListWarningData struct { + // Key: [Output Only] A key that provides more detail on the warning + // being + // returned. For example, for warnings where there are no results in a + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a + // key + // indicating a deprecated resource and a suggested replacement, or a + // warning about invalid network settings (for example, if an instance + // attempts to perform IP forwarding but is not enabled for IP forwarding). + Key string `json:"key,omitempty"` + // Value: [Output Only] A warning data value corresponding to the key. + Value string `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Key") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Key") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s HealthAggregationPoliciesScopedListWarningData) MarshalJSON() ([]byte, error) { + type NoMethod HealthAggregationPoliciesScopedListWarningData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// HealthAggregationPolicy: Represents a health aggregation policy. // -// The health checks that you use for autohealing VMs in a MIG can be -// either -// regional or global. For more information, see Set up an -// application health check and autohealing. +// A health aggregation policy resource defines a policy to aggregate +// health. // -// For more information, seeHealth checks -// overview. -type HealthCheck struct { - // CheckIntervalSec: How often (in seconds) to send a health check. The default - // value is 5 - // seconds. - CheckIntervalSec int64 `json:"checkIntervalSec,omitempty"` - // CreationTimestamp: Output only. [Output Only] Creation timestamp in3339 +// For more information, see +// Health checks overview. +type HealthAggregationPolicy struct { + // CreationTimestamp: Output only. [Output Only] Creation timestamp + // inRFC3339 // text format. CreationTimestamp string `json:"creationTimestamp,omitempty"` // Description: An optional description of this resource. Provide this property // when you // create the resource. - Description string `json:"description,omitempty"` - GrpcHealthCheck *GRPCHealthCheck `json:"grpcHealthCheck,omitempty"` - GrpcTlsHealthCheck *GRPCTLSHealthCheck `json:"grpcTlsHealthCheck,omitempty"` - // HealthyThreshold: A so-far unhealthy instance will be marked healthy after - // this - // many consecutive successes. The default value is 2. - HealthyThreshold int64 `json:"healthyThreshold,omitempty"` - Http2HealthCheck *HTTP2HealthCheck `json:"http2HealthCheck,omitempty"` - HttpHealthCheck *HTTPHealthCheck `json:"httpHealthCheck,omitempty"` - HttpsHealthCheck *HTTPSHealthCheck `json:"httpsHealthCheck,omitempty"` - // Id: [Output Only] The unique identifier for the resource. This identifier - // is + Description string `json:"description,omitempty"` + // Fingerprint: Fingerprint of this resource. A hash of the contents stored in + // this object. + // This field is used in optimistic locking. This field will be ignored + // when + // inserting a HealthAggregationPolicy. An up-to-date fingerprint + // must be provided in order to patch the HealthAggregationPolicy; + // Otherwise, + // the request will fail with error 412 conditionNotMet. To see + // the latest fingerprint, make a get() request to retrieve + // the + // HealthAggregationPolicy. + Fingerprint string `json:"fingerprint,omitempty"` + // HealthyPercentThreshold: Can only be set if the policyType field + // isBACKEND_SERVICE_POLICY. Specifies the threshold (as a + // percentage) of healthy endpoints required in order to consider + // the + // aggregated health result HEALTHY. Defaults to 60. Must be in + // range [0, 100]. Not applicable if the policyType field + // isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional, + // and will be set to the default if unspecified. Note that both this + // threshold and minHealthyThreshold must be satisfied in order + // for HEALTHY to be the aggregated result. "Endpoints" refers to + // network + // endpoints within a Network Endpoint Group or instances within an + // Instance + // Group. + HealthyPercentThreshold int64 `json:"healthyPercentThreshold,omitempty"` + // Id: Output only. [Output Only] The unique identifier for the resource. This + // identifier is // defined by the server. Id uint64 `json:"id,omitempty,string"` - // Kind: Output only. Type of the resource. + // Kind: Output only. [Output Only] Type of the resource. + // Alwayscompute#healthAggregationPolicy for health aggregation + // policies. Kind string `json:"kind,omitempty"` - // LogConfig: Configure logging on this health check. - LogConfig *HealthCheckLogConfig `json:"logConfig,omitempty"` + // MinHealthyThreshold: Can only be set if the policyType field + // isBACKEND_SERVICE_POLICY. Specifies the minimum number of + // healthy endpoints required in order to consider the aggregated health + // result HEALTHY. Defaults to 1. Must be positive. Not + // applicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. + // This field is optional, + // and will be set to the default if unspecified. Note that both this + // threshold and healthyPercentThreshold must be satisfied in + // order for HEALTHY to be the aggregated result. "Endpoints" refers to + // network endpoints within a Network Endpoint Group or instances within + // an + // Instance Group. + MinHealthyThreshold int64 `json:"minHealthyThreshold,omitempty"` // Name: Name of the resource. Provided by the client when the resource is // created. // The name must be 1-63 characters long, and comply withRFC1035. - // For example, a name that is 1-63 characters long, matches the + // Specifically, the name must be 1-63 characters long and match the // regular - // expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies - // with - // RFC1035. This regular expression describes a name where the first - // character is a lowercase letter, and all following characters are a - // dash, - // lowercase letter, or digit, except the last character, which isn't a dash. + // expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + // character must be a lowercase letter, and all following characters must + // be a dash, lowercase letter, or digit, except the last character, + // which + // cannot be a dash. Name string `json:"name,omitempty"` - // Region: Output only. [Output Only] Region where the health check resides. - // Not applicable to - // global health checks. - Region string `json:"region,omitempty"` - // SelfLink: [Output Only] Server-defined URL for the resource. - SelfLink string `json:"selfLink,omitempty"` - // SourceRegions: The list of cloud regions from which health checks are - // performed. If any - // regions are specified, then exactly 3 regions should be specified. - // The - // region names must be valid names of Google Cloud regions. - // This can only be set for global health check. - // If this list is non-empty, then there are restrictions - // on what other health check fields are supported and what other resources - // can use this health check: - // - // - SSL, HTTP2, and GRPC protocols are not supported. - // - The TCP request field is not supported. - // - The proxyHeader field for HTTP, HTTPS, and TCP is not - // supported. - // - The checkIntervalSec field must be at least 30. - // - The health check cannot be used with BackendService nor with managed - // instance group auto-healing. - SourceRegions []string `json:"sourceRegions,omitempty"` - SslHealthCheck *SSLHealthCheck `json:"sslHealthCheck,omitempty"` - TcpHealthCheck *TCPHealthCheck `json:"tcpHealthCheck,omitempty"` - // TimeoutSec: How long (in seconds) to wait before claiming failure. The - // default value is - // 5 seconds. It is invalid for timeoutSec to have greater - // value than checkIntervalSec. - TimeoutSec int64 `json:"timeoutSec,omitempty"` - // Type: Specifies the type of the healthCheck, either TCP,SSL, HTTP, - // HTTPS,HTTP2 or GRPC. Exactly one of the - // protocol-specific health check fields must be specified, which must - // matchtype field. + // PolicyType: Specifies the type of the healthAggregationPolicy. The only + // allowed value + // for global resources is DNS_PUBLIC_IP_POLICY. The only allowed + // value for regional resources is BACKEND_SERVICE_POLICY. Must + // be specified when the healthAggregationPolicy is created, and cannot + // be + // mutated. // // Possible values: - // "GRPC" - // "GRPC_WITH_TLS" - // "HTTP" - // "HTTP2" - // "HTTPS" - // "INVALID" - // "SSL" - // "TCP" - Type string `json:"type,omitempty"` - // UnhealthyThreshold: A so-far healthy instance will be marked unhealthy after - // this many - // consecutive failures. The default value is 2. - UnhealthyThreshold int64 `json:"unhealthyThreshold,omitempty"` + // "BACKEND_SERVICE_POLICY" + // "DNS_PUBLIC_IP_POLICY" + PolicyType string `json:"policyType,omitempty"` + // Region: Output only. [Output Only] URL of the region where the health + // aggregation policy + // resides. This field applies only to the regional resource. You must + // specify + // this field as part of the HTTP request URL. It is not settable as a field + // in the request body. + Region string `json:"region,omitempty"` + // SelfLink: Output only. [Output Only] Server-defined URL for the resource. + SelfLink string `json:"selfLink,omitempty"` + // SelfLinkWithId: Output only. [Output Only] Server-defined URL with id for + // the resource. + SelfLinkWithId string `json:"selfLinkWithId,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "CheckIntervalSec") to + // ForceSendFields is a list of field names (e.g. "CreationTimestamp") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CheckIntervalSec") to include in + // NullFields is a list of field names (e.g. "CreationTimestamp") to include in // API requests with the JSON null value. By default, fields with empty values // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s HealthCheck) MarshalJSON() ([]byte, error) { - type NoMethod HealthCheck +func (s HealthAggregationPolicy) MarshalJSON() ([]byte, error) { + type NoMethod HealthAggregationPolicy return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// HealthCheckList: Contains a list of HealthCheck resources. -type HealthCheckList struct { +// HealthAggregationPolicyAggregatedList: Contains a list of +// HealthAggregationPoliciesScopedList. +type HealthAggregationPolicyAggregatedList struct { // Id: [Output Only] Unique identifier for the resource; defined by the server. Id string `json:"id,omitempty"` - // Items: A list of HealthCheck resources. - Items []*HealthCheck `json:"items,omitempty"` + // Items: A list of HealthAggregationPoliciesScopedList resources. + Items map[string]HealthAggregationPoliciesScopedList `json:"items,omitempty"` // Kind: Output only. Type of resource. Kind string `json:"kind,omitempty"` // NextPageToken: [Output Only] This token allows you to get the next page of @@ -19344,8 +19597,10 @@ type HealthCheckList struct { NextPageToken string `json:"nextPageToken,omitempty"` // SelfLink: Output only. [Output Only] Server-defined URL for this resource. SelfLink string `json:"selfLink,omitempty"` + // Unreachables: Output only. [Output Only] Unreachable resources. + Unreachables []string `json:"unreachables,omitempty"` // Warning: [Output Only] Informational warning message. - Warning *HealthCheckListWarning `json:"warning,omitempty"` + Warning *HealthAggregationPolicyAggregatedListWarning `json:"warning,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -19362,13 +19617,517 @@ type HealthCheckList struct { NullFields []string `json:"-"` } -func (s HealthCheckList) MarshalJSON() ([]byte, error) { - type NoMethod HealthCheckList +func (s HealthAggregationPolicyAggregatedList) MarshalJSON() ([]byte, error) { + type NoMethod HealthAggregationPolicyAggregatedList return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// HealthCheckListWarning: [Output Only] Informational warning message. -type HealthCheckListWarning struct { +// HealthAggregationPolicyAggregatedListWarning: [Output Only] Informational +// warning message. +type HealthAggregationPolicyAggregatedListWarning struct { + // Code: [Output Only] A warning code, if applicable. For example, + // Compute + // Engine returns NO_RESULTS_ON_PAGE if there + // are no results in the response. + // + // Possible values: + // "CLEANUP_FAILED" - Warning about failed cleanup of transient changes made + // by a failed + // operation. + // "DEPRECATED_RESOURCE_USED" - A link to a deprecated resource was created. + // "DEPRECATED_TYPE_USED" - When deploying and at least one of the resources + // has a type marked as + // deprecated + // "DISK_SIZE_LARGER_THAN_IMAGE_SIZE" - The user created a boot disk that is + // larger than image size. + // "EXPERIMENTAL_TYPE_USED" - When deploying and at least one of the + // resources has a type marked as + // experimental + // "EXTERNAL_API_WARNING" - Warning that is present in an external api call + // "FIELD_VALUE_OVERRIDEN" - Warning that value of a field has been + // overridden. + // Deprecated unused field. + // "INJECTED_KERNELS_DEPRECATED" - The operation involved use of an injected + // kernel, which is deprecated. + // "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB" - A WEIGHTED_MAGLEV backend + // service is associated with a health check that is + // not of type HTTP/HTTPS/HTTP2. + // "LARGE_DEPLOYMENT_WARNING" - When deploying a deployment with a + // exceedingly large number of resources + // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list + // overhead quota exceed + // which captures the amount of resources filtered out by + // user-defined list filter. + // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type + // "NEXT_HOP_ADDRESS_NOT_ASSIGNED" - The route's nextHopIp address is not + // assigned to an instance on the + // network. + // "NEXT_HOP_CANNOT_IP_FORWARD" - The route's next hop instance cannot ip + // forward. + // "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE" - The route's nextHopInstance + // URL refers to an instance that does not have an + // ipv6 interface on the same network as the route. + // "NEXT_HOP_INSTANCE_NOT_FOUND" - The route's nextHopInstance URL refers to + // an instance that does not exist. + // "NEXT_HOP_INSTANCE_NOT_ON_NETWORK" - The route's nextHopInstance URL + // refers to an instance that is not on the + // same network as the route. + // "NEXT_HOP_NOT_RUNNING" - The route's next hop instance does not have a + // status of RUNNING. + // "NOT_CRITICAL_ERROR" - Error which is not critical. We decided to continue + // the process despite + // the mentioned error. + // "NO_RESULTS_ON_PAGE" - No results are present on a particular list page. + // "PARTIAL_SUCCESS" - Success is reported, but some results may be missing + // due to errors + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: + // regions.list). + // "REQUIRED_TOS_AGREEMENT" - The user attempted to use a resource that + // requires a TOS they have not + // accepted. + // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is + // in use. + // "RESOURCE_NOT_DELETED" - One or more of the resources set to auto-delete + // could not be deleted + // because they were in use. + // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is + // ignored. + // "SINGLE_INSTANCE_PROPERTY_TEMPLATE" - Instance template used in instance + // group manager is valid as such, but + // its application does not make a lot of sense, because it allows only + // single instance in instance group. + // "UNDECLARED_PROPERTIES" - When undeclared properties in the schema are + // present + // "UNREACHABLE" - A given scope cannot be reached. + Code string `json:"code,omitempty"` + // Data: [Output Only] Metadata about this warning in key: + // value format. For example: + // + // "data": [ + // { + // "key": "scope", + // "value": "zones/us-east1-d" + // } + Data []*HealthAggregationPolicyAggregatedListWarningData `json:"data,omitempty"` + // Message: [Output Only] A human-readable description of the warning code. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Code") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s HealthAggregationPolicyAggregatedListWarning) MarshalJSON() ([]byte, error) { + type NoMethod HealthAggregationPolicyAggregatedListWarning + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type HealthAggregationPolicyAggregatedListWarningData struct { + // Key: [Output Only] A key that provides more detail on the warning + // being + // returned. For example, for warnings where there are no results in a + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a + // key + // indicating a deprecated resource and a suggested replacement, or a + // warning about invalid network settings (for example, if an instance + // attempts to perform IP forwarding but is not enabled for IP forwarding). + Key string `json:"key,omitempty"` + // Value: [Output Only] A warning data value corresponding to the key. + Value string `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Key") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Key") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s HealthAggregationPolicyAggregatedListWarningData) MarshalJSON() ([]byte, error) { + type NoMethod HealthAggregationPolicyAggregatedListWarningData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type HealthAggregationPolicyList struct { + // Id: [Output Only] Unique identifier for the resource; defined by the server. + Id string `json:"id,omitempty"` + // Items: A list of HealthAggregationPolicy resources. + Items []*HealthAggregationPolicy `json:"items,omitempty"` + // Kind: Output only. [Output Only] Type of the resource. + // Alwayscompute#healthAggregationPolicy for health aggregation + // policies. + Kind string `json:"kind,omitempty"` + // NextPageToken: [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value for + // the query parameter pageToken in the next list request. + // Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + NextPageToken string `json:"nextPageToken,omitempty"` + // SelfLink: [Output Only] Server-defined URL for this resource. + SelfLink string `json:"selfLink,omitempty"` + // Warning: [Output Only] Informational warning message. + Warning *HealthAggregationPolicyListWarning `json:"warning,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Id") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s HealthAggregationPolicyList) MarshalJSON() ([]byte, error) { + type NoMethod HealthAggregationPolicyList + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// HealthAggregationPolicyListWarning: [Output Only] Informational warning +// message. +type HealthAggregationPolicyListWarning struct { + // Code: [Output Only] A warning code, if applicable. For example, + // Compute + // Engine returns NO_RESULTS_ON_PAGE if there + // are no results in the response. + // + // Possible values: + // "CLEANUP_FAILED" - Warning about failed cleanup of transient changes made + // by a failed + // operation. + // "DEPRECATED_RESOURCE_USED" - A link to a deprecated resource was created. + // "DEPRECATED_TYPE_USED" - When deploying and at least one of the resources + // has a type marked as + // deprecated + // "DISK_SIZE_LARGER_THAN_IMAGE_SIZE" - The user created a boot disk that is + // larger than image size. + // "EXPERIMENTAL_TYPE_USED" - When deploying and at least one of the + // resources has a type marked as + // experimental + // "EXTERNAL_API_WARNING" - Warning that is present in an external api call + // "FIELD_VALUE_OVERRIDEN" - Warning that value of a field has been + // overridden. + // Deprecated unused field. + // "INJECTED_KERNELS_DEPRECATED" - The operation involved use of an injected + // kernel, which is deprecated. + // "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB" - A WEIGHTED_MAGLEV backend + // service is associated with a health check that is + // not of type HTTP/HTTPS/HTTP2. + // "LARGE_DEPLOYMENT_WARNING" - When deploying a deployment with a + // exceedingly large number of resources + // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list + // overhead quota exceed + // which captures the amount of resources filtered out by + // user-defined list filter. + // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type + // "NEXT_HOP_ADDRESS_NOT_ASSIGNED" - The route's nextHopIp address is not + // assigned to an instance on the + // network. + // "NEXT_HOP_CANNOT_IP_FORWARD" - The route's next hop instance cannot ip + // forward. + // "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE" - The route's nextHopInstance + // URL refers to an instance that does not have an + // ipv6 interface on the same network as the route. + // "NEXT_HOP_INSTANCE_NOT_FOUND" - The route's nextHopInstance URL refers to + // an instance that does not exist. + // "NEXT_HOP_INSTANCE_NOT_ON_NETWORK" - The route's nextHopInstance URL + // refers to an instance that is not on the + // same network as the route. + // "NEXT_HOP_NOT_RUNNING" - The route's next hop instance does not have a + // status of RUNNING. + // "NOT_CRITICAL_ERROR" - Error which is not critical. We decided to continue + // the process despite + // the mentioned error. + // "NO_RESULTS_ON_PAGE" - No results are present on a particular list page. + // "PARTIAL_SUCCESS" - Success is reported, but some results may be missing + // due to errors + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: + // regions.list). + // "REQUIRED_TOS_AGREEMENT" - The user attempted to use a resource that + // requires a TOS they have not + // accepted. + // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is + // in use. + // "RESOURCE_NOT_DELETED" - One or more of the resources set to auto-delete + // could not be deleted + // because they were in use. + // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is + // ignored. + // "SINGLE_INSTANCE_PROPERTY_TEMPLATE" - Instance template used in instance + // group manager is valid as such, but + // its application does not make a lot of sense, because it allows only + // single instance in instance group. + // "UNDECLARED_PROPERTIES" - When undeclared properties in the schema are + // present + // "UNREACHABLE" - A given scope cannot be reached. + Code string `json:"code,omitempty"` + // Data: [Output Only] Metadata about this warning in key: + // value format. For example: + // + // "data": [ + // { + // "key": "scope", + // "value": "zones/us-east1-d" + // } + Data []*HealthAggregationPolicyListWarningData `json:"data,omitempty"` + // Message: [Output Only] A human-readable description of the warning code. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Code") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s HealthAggregationPolicyListWarning) MarshalJSON() ([]byte, error) { + type NoMethod HealthAggregationPolicyListWarning + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type HealthAggregationPolicyListWarningData struct { + // Key: [Output Only] A key that provides more detail on the warning + // being + // returned. For example, for warnings where there are no results in a + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a + // key + // indicating a deprecated resource and a suggested replacement, or a + // warning about invalid network settings (for example, if an instance + // attempts to perform IP forwarding but is not enabled for IP forwarding). + Key string `json:"key,omitempty"` + // Value: [Output Only] A warning data value corresponding to the key. + Value string `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Key") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Key") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s HealthAggregationPolicyListWarningData) MarshalJSON() ([]byte, error) { + type NoMethod HealthAggregationPolicyListWarningData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// HealthCheck: Represents a health check resource. +// +// Google Compute Engine has two health check resources: +// +// * Regional (/compute/docs/reference/rest/v1/regionHealthChecks) +// * Global (/compute/docs/reference/rest/v1/healthChecks) +// +// These health check resources can be used for load balancing and +// for +// autohealing VMs in a managed instance group (MIG). +// +// **Load balancing** +// +// Health check requirements vary depending on the type of load balancer. +// For +// details about the type of health check supported for +// each load balancer and corresponding backend type, +// see Health +// checks overview: Load balancer guide. +// +// **Autohealing in MIGs** +// +// The health checks that you use for autohealing VMs in a MIG can be +// either +// regional or global. For more information, see Set up an +// application health check and autohealing. +// +// For more information, seeHealth checks +// overview. +type HealthCheck struct { + // CheckIntervalSec: How often (in seconds) to send a health check. The default + // value is 5 + // seconds. + CheckIntervalSec int64 `json:"checkIntervalSec,omitempty"` + // CreationTimestamp: Output only. [Output Only] Creation timestamp in3339 + // text format. + CreationTimestamp string `json:"creationTimestamp,omitempty"` + // Description: An optional description of this resource. Provide this property + // when you + // create the resource. + Description string `json:"description,omitempty"` + GrpcHealthCheck *GRPCHealthCheck `json:"grpcHealthCheck,omitempty"` + GrpcTlsHealthCheck *GRPCTLSHealthCheck `json:"grpcTlsHealthCheck,omitempty"` + // HealthyThreshold: A so-far unhealthy instance will be marked healthy after + // this + // many consecutive successes. The default value is 2. + HealthyThreshold int64 `json:"healthyThreshold,omitempty"` + Http2HealthCheck *HTTP2HealthCheck `json:"http2HealthCheck,omitempty"` + HttpHealthCheck *HTTPHealthCheck `json:"httpHealthCheck,omitempty"` + HttpsHealthCheck *HTTPSHealthCheck `json:"httpsHealthCheck,omitempty"` + // Id: [Output Only] The unique identifier for the resource. This identifier + // is + // defined by the server. + Id uint64 `json:"id,omitempty,string"` + // Kind: Output only. Type of the resource. + Kind string `json:"kind,omitempty"` + // LogConfig: Configure logging on this health check. + LogConfig *HealthCheckLogConfig `json:"logConfig,omitempty"` + // Name: Name of the resource. Provided by the client when the resource is + // created. + // The name must be 1-63 characters long, and comply withRFC1035. + // For example, a name that is 1-63 characters long, matches the + // regular + // expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies + // with + // RFC1035. This regular expression describes a name where the first + // character is a lowercase letter, and all following characters are a + // dash, + // lowercase letter, or digit, except the last character, which isn't a dash. + Name string `json:"name,omitempty"` + // Region: Output only. [Output Only] Region where the health check resides. + // Not applicable to + // global health checks. + Region string `json:"region,omitempty"` + // SelfLink: [Output Only] Server-defined URL for the resource. + SelfLink string `json:"selfLink,omitempty"` + // SourceRegions: The list of cloud regions from which health checks are + // performed. If any + // regions are specified, then exactly 3 regions should be specified. + // The + // region names must be valid names of Google Cloud regions. + // This can only be set for global health check. + // If this list is non-empty, then there are restrictions + // on what other health check fields are supported and what other resources + // can use this health check: + // + // - SSL, HTTP2, and GRPC protocols are not supported. + // - The TCP request field is not supported. + // - The proxyHeader field for HTTP, HTTPS, and TCP is not + // supported. + // - The checkIntervalSec field must be at least 30. + // - The health check cannot be used with BackendService nor with managed + // instance group auto-healing. + SourceRegions []string `json:"sourceRegions,omitempty"` + SslHealthCheck *SSLHealthCheck `json:"sslHealthCheck,omitempty"` + TcpHealthCheck *TCPHealthCheck `json:"tcpHealthCheck,omitempty"` + // TimeoutSec: How long (in seconds) to wait before claiming failure. The + // default value is + // 5 seconds. It is invalid for timeoutSec to have greater + // value than checkIntervalSec. + TimeoutSec int64 `json:"timeoutSec,omitempty"` + // Type: Specifies the type of the healthCheck, either TCP,SSL, HTTP, + // HTTPS,HTTP2 or GRPC. Exactly one of the + // protocol-specific health check fields must be specified, which must + // matchtype field. + // + // Possible values: + // "GRPC" + // "GRPC_WITH_TLS" + // "HTTP" + // "HTTP2" + // "HTTPS" + // "INVALID" + // "SSL" + // "TCP" + Type string `json:"type,omitempty"` + // UnhealthyThreshold: A so-far healthy instance will be marked unhealthy after + // this many + // consecutive failures. The default value is 2. + UnhealthyThreshold int64 `json:"unhealthyThreshold,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "CheckIntervalSec") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CheckIntervalSec") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s HealthCheck) MarshalJSON() ([]byte, error) { + type NoMethod HealthCheck + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// HealthCheckList: Contains a list of HealthCheck resources. +type HealthCheckList struct { + // Id: [Output Only] Unique identifier for the resource; defined by the server. + Id string `json:"id,omitempty"` + // Items: A list of HealthCheck resources. + Items []*HealthCheck `json:"items,omitempty"` + // Kind: Output only. Type of resource. + Kind string `json:"kind,omitempty"` + // NextPageToken: [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value for + // the query parameter pageToken in the next list request. + // Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + NextPageToken string `json:"nextPageToken,omitempty"` + // SelfLink: Output only. [Output Only] Server-defined URL for this resource. + SelfLink string `json:"selfLink,omitempty"` + // Warning: [Output Only] Informational warning message. + Warning *HealthCheckListWarning `json:"warning,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Id") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s HealthCheckList) MarshalJSON() ([]byte, error) { + type NoMethod HealthCheckList + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// HealthCheckListWarning: [Output Only] Informational warning message. +type HealthCheckListWarning struct { // Code: [Output Only] A warning code, if applicable. For example, // Compute // Engine returns NO_RESULTS_ON_PAGE if there @@ -22454,8 +23213,8 @@ func (s ImageListWarningData) MarshalJSON() ([]byte, error) { // ImageParams: Additional image params. type ImageParams struct { - // ResourceManagerTags: Resource manager tags to be bound to the image. Tag - // keys and values have + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // image. Tag keys and values have // the same definition as resource // manager tags. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -27196,8 +27955,8 @@ type InstanceParams struct { // Relevant only for // Instances.Insert API. RequestValidForDuration *Duration `json:"requestValidForDuration,omitempty"` - // ResourceManagerTags: Resource manager tags to be bound to the instance. Tag - // keys and values + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // instance. Tag keys and values // have the same definition as resource // manager tags. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -27326,8 +28085,8 @@ type InstanceProperties struct { // from. // Note that for MachineImage, this is not supported yet. ReservationAffinity *ReservationAffinity `json:"reservationAffinity,omitempty"` - // ResourceManagerTags: Resource manager tags to be bound to the instance. Tag - // keys and values + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // instance. Tag keys and values // have the same definition as resource // manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and // values are in the format `tagValues/456`. The field is ignored (both PUT @@ -34969,6 +35728,17 @@ type LocationPolicy struct { // Currently only zone names are supported and must be represented as // valid // internal URLs, such as zones/us-central1-a. + // The bulkInsert operation doesn't create instances in an AI zone, even if + // an AI zone is available in the specified region. For example, if you set + // a + // DENY preference for us-central1-a, Compute Engine will + // consider + // us-central1-b and us-central1-c for instance creation, but + // not + // us-central1-ai1a. Also, you can't use the locations[] configuration to + // allow instance creation in an AI zone. To include an AI zone in + // bulkInsert + // operations, use the locationPolicy.zones[] field. Locations map[string]LocationPolicyLocation `json:"locations,omitempty"` // TargetShape: Strategy for distributing VMs across zones in a region. // @@ -34992,6 +35762,11 @@ type LocationPolicy struct { // failure. // Recommended for highly available serving workloads. TargetShape string `json:"targetShape,omitempty"` + // Zones: The bulkInsert operation applies any preferences set in the + // locations + // field to the specific zones listed in the zones field if the same zones + // are specified in both fields. + Zones []*LocationPolicyZoneConfiguration `json:"zones,omitempty"` // ForceSendFields is a list of field names (e.g. "Locations") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -35065,6 +35840,30 @@ func (s LocationPolicyLocationConstraints) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type LocationPolicyZoneConfiguration struct { + // Zone: The URL of the zone. + // The zone must exist in the region where the request is called. + // Zones must be represented as valid partial URLs, + // such as zones/us-central1-a. + Zone string `json:"zone,omitempty"` + // ForceSendFields is a list of field names (e.g. "Zone") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Zone") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s LocationPolicyZoneConfiguration) MarshalJSON() ([]byte, error) { + type NoMethod LocationPolicyZoneConfiguration + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // MachineImage: Represents a machine image resource. // // A machine image is a Compute Engine resource that stores all @@ -50864,6 +51663,10 @@ type Reservation struct { // cannot // be a dash. Name string `json:"name,omitempty"` + // Params: Input only. Additional params passed with the request, but not + // persisted + // as part of resource payload. + Params *ReservationParams `json:"params,omitempty"` // ProtectionTier: Protection tier for the workload which specifies the // workload expectations // in the event of infrastructure failures at data center (e.g. power @@ -51819,6 +52622,37 @@ func (s ReservationListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ReservationParams: Additional reservation params. +type ReservationParams struct { + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // reservation. Tag keys and + // values have the same definition as resource + // manager tags. Keys and values can be either in numeric format, + // such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or + // in + // namespaced format such as `{org_id|project_id}/{tag_key_short_name}` + // and + // `{tag_value_short_name}`. The field is ignored (both PUT & + // PATCH) when empty. + ResourceManagerTags map[string]string `json:"resourceManagerTags,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResourceManagerTags") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ResourceManagerTags") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ReservationParams) MarshalJSON() ([]byte, error) { + type NoMethod ReservationParams + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ReservationSlot: Represents a reservation slot resource. type ReservationSlot struct { // CreationTimestamp: Output only. [Output Only] The creation timestamp, @@ -51853,6 +52687,7 @@ type ReservationSlot struct { // "CREATING" - The resources are being allocated for the reservation slot. // "DELETING" - The reservation slot is currently being deleted. // "STATE_UNSPECIFIED" + // "UNAVAILABLE" - The reservation slot is currently unavailable. State string `json:"state,omitempty"` // Status: Output only. [Output Only] The status of the reservation slot. Status *ReservationSlotStatus `json:"status,omitempty"` @@ -54038,6 +54873,9 @@ type ResourceStatusEffectiveInstanceMetadata struct { // EnableOsloginMetadataValue: Effective enable-oslogin value at Instance // level. EnableOsloginMetadataValue bool `json:"enableOsloginMetadataValue,omitempty"` + // GceContainerDeclarationMetadataValue: Effective gce-container-declaration + // value at Instance level. + GceContainerDeclarationMetadataValue bool `json:"gceContainerDeclarationMetadataValue,omitempty"` // SerialPortEnableMetadataValue: Effective serial-port-enable value at // Instance level. SerialPortEnableMetadataValue bool `json:"serialPortEnableMetadataValue,omitempty"` @@ -61200,8 +62038,8 @@ func (s SnapshotListWarningData) MarshalJSON() ([]byte, error) { // SnapshotParams: Additional snapshot params. type SnapshotParams struct { - // ResourceManagerTags: Resource manager tags to be bound to the snapshot. Tag - // keys and values have + // ResourceManagerTags: Input only. Resource manager tags to be bound to the + // snapshot. Tag keys and values have // the same definition as resource // manager tags. Keys and values can be either in numeric format, // such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced @@ -70621,6 +71459,10 @@ type TargetVpnGateway struct { // by the // client when the VPN gateway is created. Network string `json:"network,omitempty"` + // Params: Input only. [Input Only] Additional params passed with the request, + // but not persisted + // as part of resource payload. + Params *TargetVpnGatewayParams `json:"params,omitempty"` // Region: [Output Only] URL of the region where the target VPN gateway // resides. // You must specify this field as part of the HTTP request URL. It is @@ -70793,7 +71635,188 @@ type TargetVpnGatewayAggregatedListWarning struct { // "key": "scope", // "value": "zones/us-east1-d" // } - Data []*TargetVpnGatewayAggregatedListWarningData `json:"data,omitempty"` + Data []*TargetVpnGatewayAggregatedListWarningData `json:"data,omitempty"` + // Message: [Output Only] A human-readable description of the warning code. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Code") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s TargetVpnGatewayAggregatedListWarning) MarshalJSON() ([]byte, error) { + type NoMethod TargetVpnGatewayAggregatedListWarning + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type TargetVpnGatewayAggregatedListWarningData struct { + // Key: [Output Only] A key that provides more detail on the warning + // being + // returned. For example, for warnings where there are no results in a + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a + // key + // indicating a deprecated resource and a suggested replacement, or a + // warning about invalid network settings (for example, if an instance + // attempts to perform IP forwarding but is not enabled for IP forwarding). + Key string `json:"key,omitempty"` + // Value: [Output Only] A warning data value corresponding to the key. + Value string `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Key") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Key") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s TargetVpnGatewayAggregatedListWarningData) MarshalJSON() ([]byte, error) { + type NoMethod TargetVpnGatewayAggregatedListWarningData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// TargetVpnGatewayList: Contains a list of TargetVpnGateway resources. +type TargetVpnGatewayList struct { + // Id: [Output Only] Unique identifier for the resource; defined by the server. + Id string `json:"id,omitempty"` + // Items: A list of TargetVpnGateway resources. + Items []*TargetVpnGateway `json:"items,omitempty"` + // Kind: Output only. [Output Only] Type of resource. + // Alwayscompute#targetVpnGateway for target VPN gateways. + Kind string `json:"kind,omitempty"` + // NextPageToken: [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value for + // the query parameter pageToken in the next list request. + // Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + NextPageToken string `json:"nextPageToken,omitempty"` + // SelfLink: Output only. [Output Only] Server-defined URL for this resource. + SelfLink string `json:"selfLink,omitempty"` + // Warning: [Output Only] Informational warning message. + Warning *TargetVpnGatewayListWarning `json:"warning,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Id") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s TargetVpnGatewayList) MarshalJSON() ([]byte, error) { + type NoMethod TargetVpnGatewayList + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// TargetVpnGatewayListWarning: [Output Only] Informational warning message. +type TargetVpnGatewayListWarning struct { + // Code: [Output Only] A warning code, if applicable. For example, + // Compute + // Engine returns NO_RESULTS_ON_PAGE if there + // are no results in the response. + // + // Possible values: + // "CLEANUP_FAILED" - Warning about failed cleanup of transient changes made + // by a failed + // operation. + // "DEPRECATED_RESOURCE_USED" - A link to a deprecated resource was created. + // "DEPRECATED_TYPE_USED" - When deploying and at least one of the resources + // has a type marked as + // deprecated + // "DISK_SIZE_LARGER_THAN_IMAGE_SIZE" - The user created a boot disk that is + // larger than image size. + // "EXPERIMENTAL_TYPE_USED" - When deploying and at least one of the + // resources has a type marked as + // experimental + // "EXTERNAL_API_WARNING" - Warning that is present in an external api call + // "FIELD_VALUE_OVERRIDEN" - Warning that value of a field has been + // overridden. + // Deprecated unused field. + // "INJECTED_KERNELS_DEPRECATED" - The operation involved use of an injected + // kernel, which is deprecated. + // "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB" - A WEIGHTED_MAGLEV backend + // service is associated with a health check that is + // not of type HTTP/HTTPS/HTTP2. + // "LARGE_DEPLOYMENT_WARNING" - When deploying a deployment with a + // exceedingly large number of resources + // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list + // overhead quota exceed + // which captures the amount of resources filtered out by + // user-defined list filter. + // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type + // "NEXT_HOP_ADDRESS_NOT_ASSIGNED" - The route's nextHopIp address is not + // assigned to an instance on the + // network. + // "NEXT_HOP_CANNOT_IP_FORWARD" - The route's next hop instance cannot ip + // forward. + // "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE" - The route's nextHopInstance + // URL refers to an instance that does not have an + // ipv6 interface on the same network as the route. + // "NEXT_HOP_INSTANCE_NOT_FOUND" - The route's nextHopInstance URL refers to + // an instance that does not exist. + // "NEXT_HOP_INSTANCE_NOT_ON_NETWORK" - The route's nextHopInstance URL + // refers to an instance that is not on the + // same network as the route. + // "NEXT_HOP_NOT_RUNNING" - The route's next hop instance does not have a + // status of RUNNING. + // "NOT_CRITICAL_ERROR" - Error which is not critical. We decided to continue + // the process despite + // the mentioned error. + // "NO_RESULTS_ON_PAGE" - No results are present on a particular list page. + // "PARTIAL_SUCCESS" - Success is reported, but some results may be missing + // due to errors + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: + // regions.list). + // "REQUIRED_TOS_AGREEMENT" - The user attempted to use a resource that + // requires a TOS they have not + // accepted. + // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is + // in use. + // "RESOURCE_NOT_DELETED" - One or more of the resources set to auto-delete + // could not be deleted + // because they were in use. + // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is + // ignored. + // "SINGLE_INSTANCE_PROPERTY_TEMPLATE" - Instance template used in instance + // group manager is valid as such, but + // its application does not make a lot of sense, because it allows only + // single instance in instance group. + // "UNDECLARED_PROPERTIES" - When undeclared properties in the schema are + // present + // "UNREACHABLE" - A given scope cannot be reached. + Code string `json:"code,omitempty"` + // Data: [Output Only] Metadata about this warning in key: + // value format. For example: + // + // "data": [ + // { + // "key": "scope", + // "value": "zones/us-east1-d" + // } + Data []*TargetVpnGatewayListWarningData `json:"data,omitempty"` // Message: [Output Only] A human-readable description of the warning code. Message string `json:"message,omitempty"` // ForceSendFields is a list of field names (e.g. "Code") to unconditionally @@ -70809,12 +71832,12 @@ type TargetVpnGatewayAggregatedListWarning struct { NullFields []string `json:"-"` } -func (s TargetVpnGatewayAggregatedListWarning) MarshalJSON() ([]byte, error) { - type NoMethod TargetVpnGatewayAggregatedListWarning +func (s TargetVpnGatewayListWarning) MarshalJSON() ([]byte, error) { + type NoMethod TargetVpnGatewayListWarning return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type TargetVpnGatewayAggregatedListWarningData struct { +type TargetVpnGatewayListWarningData struct { // Key: [Output Only] A key that provides more detail on the warning // being // returned. For example, for warnings where there are no results in a @@ -70841,189 +71864,42 @@ type TargetVpnGatewayAggregatedListWarningData struct { NullFields []string `json:"-"` } -func (s TargetVpnGatewayAggregatedListWarningData) MarshalJSON() ([]byte, error) { - type NoMethod TargetVpnGatewayAggregatedListWarningData - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// TargetVpnGatewayList: Contains a list of TargetVpnGateway resources. -type TargetVpnGatewayList struct { - // Id: [Output Only] Unique identifier for the resource; defined by the server. - Id string `json:"id,omitempty"` - // Items: A list of TargetVpnGateway resources. - Items []*TargetVpnGateway `json:"items,omitempty"` - // Kind: Output only. [Output Only] Type of resource. - // Alwayscompute#targetVpnGateway for target VPN gateways. - Kind string `json:"kind,omitempty"` - // NextPageToken: [Output Only] This token allows you to get the next page of - // results for - // list requests. If the number of results is larger thanmaxResults, use the - // nextPageToken as a value for - // the query parameter pageToken in the next list request. - // Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - NextPageToken string `json:"nextPageToken,omitempty"` - // SelfLink: Output only. [Output Only] Server-defined URL for this resource. - SelfLink string `json:"selfLink,omitempty"` - // Warning: [Output Only] Informational warning message. - Warning *TargetVpnGatewayListWarning `json:"warning,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "Id") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Id") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s TargetVpnGatewayList) MarshalJSON() ([]byte, error) { - type NoMethod TargetVpnGatewayList - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// TargetVpnGatewayListWarning: [Output Only] Informational warning message. -type TargetVpnGatewayListWarning struct { - // Code: [Output Only] A warning code, if applicable. For example, - // Compute - // Engine returns NO_RESULTS_ON_PAGE if there - // are no results in the response. - // - // Possible values: - // "CLEANUP_FAILED" - Warning about failed cleanup of transient changes made - // by a failed - // operation. - // "DEPRECATED_RESOURCE_USED" - A link to a deprecated resource was created. - // "DEPRECATED_TYPE_USED" - When deploying and at least one of the resources - // has a type marked as - // deprecated - // "DISK_SIZE_LARGER_THAN_IMAGE_SIZE" - The user created a boot disk that is - // larger than image size. - // "EXPERIMENTAL_TYPE_USED" - When deploying and at least one of the - // resources has a type marked as - // experimental - // "EXTERNAL_API_WARNING" - Warning that is present in an external api call - // "FIELD_VALUE_OVERRIDEN" - Warning that value of a field has been - // overridden. - // Deprecated unused field. - // "INJECTED_KERNELS_DEPRECATED" - The operation involved use of an injected - // kernel, which is deprecated. - // "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB" - A WEIGHTED_MAGLEV backend - // service is associated with a health check that is - // not of type HTTP/HTTPS/HTTP2. - // "LARGE_DEPLOYMENT_WARNING" - When deploying a deployment with a - // exceedingly large number of resources - // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list - // overhead quota exceed - // which captures the amount of resources filtered out by - // user-defined list filter. - // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type - // "NEXT_HOP_ADDRESS_NOT_ASSIGNED" - The route's nextHopIp address is not - // assigned to an instance on the - // network. - // "NEXT_HOP_CANNOT_IP_FORWARD" - The route's next hop instance cannot ip - // forward. - // "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE" - The route's nextHopInstance - // URL refers to an instance that does not have an - // ipv6 interface on the same network as the route. - // "NEXT_HOP_INSTANCE_NOT_FOUND" - The route's nextHopInstance URL refers to - // an instance that does not exist. - // "NEXT_HOP_INSTANCE_NOT_ON_NETWORK" - The route's nextHopInstance URL - // refers to an instance that is not on the - // same network as the route. - // "NEXT_HOP_NOT_RUNNING" - The route's next hop instance does not have a - // status of RUNNING. - // "NOT_CRITICAL_ERROR" - Error which is not critical. We decided to continue - // the process despite - // the mentioned error. - // "NO_RESULTS_ON_PAGE" - No results are present on a particular list page. - // "PARTIAL_SUCCESS" - Success is reported, but some results may be missing - // due to errors - // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client - // requests (e.g: - // regions.list). - // "REQUIRED_TOS_AGREEMENT" - The user attempted to use a resource that - // requires a TOS they have not - // accepted. - // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is - // in use. - // "RESOURCE_NOT_DELETED" - One or more of the resources set to auto-delete - // could not be deleted - // because they were in use. - // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is - // ignored. - // "SINGLE_INSTANCE_PROPERTY_TEMPLATE" - Instance template used in instance - // group manager is valid as such, but - // its application does not make a lot of sense, because it allows only - // single instance in instance group. - // "UNDECLARED_PROPERTIES" - When undeclared properties in the schema are - // present - // "UNREACHABLE" - A given scope cannot be reached. - Code string `json:"code,omitempty"` - // Data: [Output Only] Metadata about this warning in key: - // value format. For example: - // - // "data": [ - // { - // "key": "scope", - // "value": "zones/us-east1-d" - // } - Data []*TargetVpnGatewayListWarningData `json:"data,omitempty"` - // Message: [Output Only] A human-readable description of the warning code. - Message string `json:"message,omitempty"` - // ForceSendFields is a list of field names (e.g. "Code") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Code") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s TargetVpnGatewayListWarning) MarshalJSON() ([]byte, error) { - type NoMethod TargetVpnGatewayListWarning +func (s TargetVpnGatewayListWarningData) MarshalJSON() ([]byte, error) { + type NoMethod TargetVpnGatewayListWarningData return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type TargetVpnGatewayListWarningData struct { - // Key: [Output Only] A key that provides more detail on the warning - // being - // returned. For example, for warnings where there are no results in a - // list - // request for a particular zone, this key might be scope and - // the key value might be the zone name. Other examples might be a - // key - // indicating a deprecated resource and a suggested replacement, or a - // warning about invalid network settings (for example, if an instance - // attempts to perform IP forwarding but is not enabled for IP forwarding). - Key string `json:"key,omitempty"` - // Value: [Output Only] A warning data value corresponding to the key. - Value string `json:"value,omitempty"` - // ForceSendFields is a list of field names (e.g. "Key") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See +type TargetVpnGatewayParams struct { + // ResourceManagerTags: Tag keys/values directly bound to this resource. + // Tag keys and values have the same definition as resource + // manager tags. The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + // * Inconsistent format is not supported. For instance: + // {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + ResourceManagerTags map[string]string `json:"resourceManagerTags,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResourceManagerTags") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Key") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See + // NullFields is a list of field names (e.g. "ResourceManagerTags") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s TargetVpnGatewayListWarningData) MarshalJSON() ([]byte, error) { - type NoMethod TargetVpnGatewayListWarningData +func (s TargetVpnGatewayParams) MarshalJSON() ([]byte, error) { + type NoMethod TargetVpnGatewayParams return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } @@ -73162,6 +74038,10 @@ type VpnGateway struct { // by the // client when the VPN gateway is created. Network string `json:"network,omitempty"` + // Params: Input only. [Input Only] Additional params passed with the request, + // but not persisted + // as part of resource payload. + Params *VpnGatewayParams `json:"params,omitempty"` // Region: Output only. [Output Only] URL of the region where the VPN gateway // resides. Region string `json:"region,omitempty"` @@ -73567,6 +74447,40 @@ func (s VpnGatewayListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type VpnGatewayParams struct { + // ResourceManagerTags: Tag keys/values directly bound to this resource. + // Tag keys and values have the same definition as resource + // manager tags. The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + // * Inconsistent format is not supported. For instance: + // {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + ResourceManagerTags map[string]string `json:"resourceManagerTags,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResourceManagerTags") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ResourceManagerTags") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s VpnGatewayParams) MarshalJSON() ([]byte, error) { + type NoMethod VpnGatewayParams + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type VpnGatewayStatus struct { // VpnConnections: Output only. List of VPN connection for this VpnGateway. VpnConnections []*VpnGatewayStatusVpnConnection `json:"vpnConnections,omitempty"` @@ -74016,6 +74930,10 @@ type VpnTunnel struct { // which // cannot be a dash. Name string `json:"name,omitempty"` + // Params: Input only. [Input Only] Additional params passed with the request, + // but not persisted + // as part of resource payload. + Params *VpnTunnelParams `json:"params,omitempty"` // PeerExternalGateway: URL of the peer side external VPN gateway to which this // VPN tunnel is // connected. @@ -74547,6 +75465,40 @@ func (s VpnTunnelListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type VpnTunnelParams struct { + // ResourceManagerTags: Tag keys/values directly bound to this resource. + // Tag keys and values have the same definition as resource + // manager tags. The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + // * Inconsistent format is not supported. For instance: + // {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + ResourceManagerTags map[string]string `json:"resourceManagerTags,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResourceManagerTags") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ResourceManagerTags") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s VpnTunnelParams) MarshalJSON() ([]byte, error) { + type NoMethod VpnTunnelParams + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type VpnTunnelPhase1Algorithms struct { Dh []string `json:"dh,omitempty"` Encryption []string `json:"encryption,omitempty"` diff --git a/compute/v1/compute2-gen.go b/compute/v1/compute2-gen.go index 63fb62758e..30a3d6167c 100644 --- a/compute/v1/compute2-gen.go +++ b/compute/v1/compute2-gen.go @@ -11676,7 +11676,7 @@ type DisksUpdateCall struct { // Update: Updates the specified disk with the data included in the // request. // The update is performed only on selected fields included as part -// of update-mask. Only the following fields can be modified: user_license. +// of update-mask. // // - disk: The disk name for this request. // - project: Project ID for this request. diff --git a/compute/v1/compute3-gen.go b/compute/v1/compute3-gen.go index ab018c0f18..b0246c1420 100644 --- a/compute/v1/compute3-gen.go +++ b/compute/v1/compute3-gen.go @@ -7703,9 +7703,7 @@ type RegionDisksUpdateCall struct { // Update: Update the specified disk with the data included in the request. // Update is -// performed only on selected fields included as part of update-mask. Only -// the -// following fields can be modified: user_license. +// performed only on selected fields included as part of update-mask. // // - disk: The disk name for this request. // - project: Project ID for this request. @@ -7840,6 +7838,1192 @@ func (c *RegionDisksUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, er return ret, nil } +type RegionHealthAggregationPoliciesAggregatedListCall struct { + s *Service + project string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// AggregatedList: Retrieves the list of all HealthAggregationPolicy +// resources, +// regional and global, available to the specified project. +// +// To prevent failure, it is recommended that you set +// the +// `returnPartialSuccess` parameter to `true`. +// +// - project: Name of the project scoping this request. +func (r *RegionHealthAggregationPoliciesService) AggregatedList(project string) *RegionHealthAggregationPoliciesAggregatedListCall { + c := &RegionHealthAggregationPoliciesAggregatedListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + return c +} + +// Filter sets the optional parameter "filter": A filter expression that +// filters resources listed in the response. Most +// Compute resources support two types of filter expressions: +// expressions that support regular expressions and expressions that follow +// API improvement proposal AIP-160. +// These two types of filter expressions cannot be mixed in one request. +// +// If you want to use AIP-160, your expression must specify the field name, +// an +// operator, and the value that you want to use for filtering. The value +// must be a string, a number, or a boolean. The operator +// must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. +// +// For example, if you are filtering Compute Engine instances, you can +// exclude instances named `example-instance` by specifying +// `name != example-instance`. +// +// The `:*` comparison can be used to test whether a key has been defined. +// For example, to find all objects with `owner` label +// use: +// ``` +// labels.owner:* +// ``` +// +// You can also filter nested fields. For example, you could +// specify +// `scheduling.automaticRestart = false` to include instances only +// if they are not scheduled for automatic restarts. You can use filtering +// on nested fields to filter based onresource labels. +// +// To filter on multiple expressions, provide each separate expression +// within +// parentheses. For example: +// ``` +// (scheduling.automaticRestart = true) +// (cpuPlatform = "Intel Skylake") +// ``` +// By default, each expression is an `AND` expression. However, you +// can include `AND` and `OR` expressions explicitly. +// For example: +// ``` +// (cpuPlatform = "Intel Skylake") OR +// (cpuPlatform = "Intel Broadwell") AND +// (scheduling.automaticRestart = true) +// ``` +// +// If you want to use a regular expression, use the `eq` (equal) or `ne` +// (not equal) operator against a single un-parenthesized expression with +// or +// without quotes or against multiple parenthesized expressions. +// Examples: +// +// `fieldname eq unquoted literal` +// `fieldname eq 'single quoted literal'` +// `fieldname eq "double quoted literal" +// `(fieldname1 eq literal) (fieldname2 ne "literal")` +// +// The literal value is interpreted as a regular expression using GoogleRE2 +// library syntax. +// The literal value must match the entire field. +// +// For example, to filter for instances that do not end with name +// "instance", +// you would use `name ne .*instance`. +// +// You cannot combine constraints on multiple fields using regular +// expressions. +func (c *RegionHealthAggregationPoliciesAggregatedListCall) Filter(filter string) *RegionHealthAggregationPoliciesAggregatedListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// IncludeAllScopes sets the optional parameter "includeAllScopes": Indicates +// whether every visible scope for each scope type (zone, region, +// global) should be included in the response. For new resource types +// added +// after this field, the flag has no effect as new resource types will +// always +// include every visible scope for each scope type in response. For +// resource +// types which predate this field, if this flag is omitted or false, +// only +// scopes of the scope types where the resource type is expected to be +// found +// will be included. +func (c *RegionHealthAggregationPoliciesAggregatedListCall) IncludeAllScopes(includeAllScopes bool) *RegionHealthAggregationPoliciesAggregatedListCall { + c.urlParams_.Set("includeAllScopes", fmt.Sprint(includeAllScopes)) + return c +} + +// MaxResults sets the optional parameter "maxResults": The maximum number of +// results per page that should be returned. +// If the number of available results is larger than `maxResults`, +// Compute Engine returns a `nextPageToken` that can be used to get +// the next page of results in subsequent list requests. Acceptable values +// are +// `0` to `500`, inclusive. (Default: `500`) +func (c *RegionHealthAggregationPoliciesAggregatedListCall) MaxResults(maxResults int64) *RegionHealthAggregationPoliciesAggregatedListCall { + c.urlParams_.Set("maxResults", fmt.Sprint(maxResults)) + return c +} + +// OrderBy sets the optional parameter "orderBy": Sorts list results by a +// certain order. By default, results +// are returned in alphanumerical order based on the resource name. +// +// You can also sort results in descending order based on the +// creation +// timestamp using `orderBy="creationTimestamp desc". This sorts +// results based on the `creationTimestamp` field in +// reverse chronological order (newest result first). Use this to +// sort +// resources like operations so that the newest operation is returned +// first. +// +// Currently, only sorting by `name` or +// `creationTimestamp desc` is supported. +func (c *RegionHealthAggregationPoliciesAggregatedListCall) OrderBy(orderBy string) *RegionHealthAggregationPoliciesAggregatedListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageToken sets the optional parameter "pageToken": Specifies a page token to +// use. Set `pageToken` to the +// `nextPageToken` returned by a previous list request to get +// the next page of results. +func (c *RegionHealthAggregationPoliciesAggregatedListCall) PageToken(pageToken string) *RegionHealthAggregationPoliciesAggregatedListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": +// Opt-in for partial success behavior which provides partial results in +// case +// of failure. The default value is false. +// +// For example, when partial success behavior is enabled, aggregatedList for +// a +// single zone scope either returns all resources in the zone or no +// resources, +// with an error code. +func (c *RegionHealthAggregationPoliciesAggregatedListCall) ReturnPartialSuccess(returnPartialSuccess bool) *RegionHealthAggregationPoliciesAggregatedListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + +// ServiceProjectNumber sets the optional parameter "serviceProjectNumber": The +// Shared VPC service project id or service project number for which +// aggregated list request is invoked for subnetworks list-usable api. +func (c *RegionHealthAggregationPoliciesAggregatedListCall) ServiceProjectNumber(serviceProjectNumber int64) *RegionHealthAggregationPoliciesAggregatedListCall { + c.urlParams_.Set("serviceProjectNumber", fmt.Sprint(serviceProjectNumber)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *RegionHealthAggregationPoliciesAggregatedListCall) Fields(s ...googleapi.Field) *RegionHealthAggregationPoliciesAggregatedListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *RegionHealthAggregationPoliciesAggregatedListCall) IfNoneMatch(entityTag string) *RegionHealthAggregationPoliciesAggregatedListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionHealthAggregationPoliciesAggregatedListCall) Context(ctx context.Context) *RegionHealthAggregationPoliciesAggregatedListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *RegionHealthAggregationPoliciesAggregatedListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionHealthAggregationPoliciesAggregatedListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/aggregated/healthAggregationPolicies") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.regionHealthAggregationPolicies.aggregatedList", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionHealthAggregationPolicies.aggregatedList" call. +// Any non-2xx status code is an error. Response headers are in either +// *HealthAggregationPolicyAggregatedList.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *RegionHealthAggregationPoliciesAggregatedListCall) Do(opts ...googleapi.CallOption) (*HealthAggregationPolicyAggregatedList, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &HealthAggregationPolicyAggregatedList{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.regionHealthAggregationPolicies.aggregatedList", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *RegionHealthAggregationPoliciesAggregatedListCall) Pages(ctx context.Context, f func(*HealthAggregationPolicyAggregatedList) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type RegionHealthAggregationPoliciesDeleteCall struct { + s *Service + project string + region string + healthAggregationPolicy string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes the specified HealthAggregationPolicy in the given region. +// +// - healthAggregationPolicy: Name of the HealthAggregationPolicy resource to +// delete. +// - project: Project ID for this request. +// - region: Name of the region scoping this request. +func (r *RegionHealthAggregationPoliciesService) Delete(project string, region string, healthAggregationPolicy string) *RegionHealthAggregationPoliciesDeleteCall { + c := &RegionHealthAggregationPoliciesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.healthAggregationPolicy = healthAggregationPolicy + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so +// that if you must retry your request, the server will know to ignore +// the +// request if it has already been completed. +// +// For example, consider a situation where you make an initial request and +// the request times out. If you make the request again with the same +// request ID, the server can check if original operation with the same +// request ID was received, and if so, will ignore the second request. +// This +// prevents clients from accidentally creating duplicate commitments. +// +// The request ID must be +// a valid UUID with the exception that zero UUID is not +// supported +// (00000000-0000-0000-0000-000000000000). +func (c *RegionHealthAggregationPoliciesDeleteCall) RequestId(requestId string) *RegionHealthAggregationPoliciesDeleteCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *RegionHealthAggregationPoliciesDeleteCall) Fields(s ...googleapi.Field) *RegionHealthAggregationPoliciesDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionHealthAggregationPoliciesDeleteCall) Context(ctx context.Context) *RegionHealthAggregationPoliciesDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *RegionHealthAggregationPoliciesDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionHealthAggregationPoliciesDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "healthAggregationPolicy": c.healthAggregationPolicy, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.regionHealthAggregationPolicies.delete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionHealthAggregationPolicies.delete" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *RegionHealthAggregationPoliciesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.regionHealthAggregationPolicies.delete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type RegionHealthAggregationPoliciesGetCall struct { + s *Service + project string + region string + healthAggregationPolicy string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Returns the specified HealthAggregationPolicy resource in the given +// region. +// +// - healthAggregationPolicy: Name of the HealthAggregationPolicy resource to +// return. +// - project: Project ID for this request. +// - region: Name of the region scoping this request. +func (r *RegionHealthAggregationPoliciesService) Get(project string, region string, healthAggregationPolicy string) *RegionHealthAggregationPoliciesGetCall { + c := &RegionHealthAggregationPoliciesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.healthAggregationPolicy = healthAggregationPolicy + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *RegionHealthAggregationPoliciesGetCall) Fields(s ...googleapi.Field) *RegionHealthAggregationPoliciesGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *RegionHealthAggregationPoliciesGetCall) IfNoneMatch(entityTag string) *RegionHealthAggregationPoliciesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionHealthAggregationPoliciesGetCall) Context(ctx context.Context) *RegionHealthAggregationPoliciesGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *RegionHealthAggregationPoliciesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionHealthAggregationPoliciesGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "healthAggregationPolicy": c.healthAggregationPolicy, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.regionHealthAggregationPolicies.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionHealthAggregationPolicies.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *HealthAggregationPolicy.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *RegionHealthAggregationPoliciesGetCall) Do(opts ...googleapi.CallOption) (*HealthAggregationPolicy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &HealthAggregationPolicy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.regionHealthAggregationPolicies.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type RegionHealthAggregationPoliciesInsertCall struct { + s *Service + project string + region string + healthaggregationpolicy *HealthAggregationPolicy + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Insert: Create a HealthAggregationPolicy in the specified project in the +// given +// region using the parameters that are included in the request. +// +// - project: Project ID for this request. +// - region: Name of the region scoping this request. +func (r *RegionHealthAggregationPoliciesService) Insert(project string, region string, healthaggregationpolicy *HealthAggregationPolicy) *RegionHealthAggregationPoliciesInsertCall { + c := &RegionHealthAggregationPoliciesInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.healthaggregationpolicy = healthaggregationpolicy + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so +// that if you must retry your request, the server will know to ignore +// the +// request if it has already been completed. +// +// For example, consider a situation where you make an initial request and +// the request times out. If you make the request again with the same +// request ID, the server can check if original operation with the same +// request ID was received, and if so, will ignore the second request. +// This +// prevents clients from accidentally creating duplicate commitments. +// +// The request ID must be +// a valid UUID with the exception that zero UUID is not +// supported +// (00000000-0000-0000-0000-000000000000). +func (c *RegionHealthAggregationPoliciesInsertCall) RequestId(requestId string) *RegionHealthAggregationPoliciesInsertCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *RegionHealthAggregationPoliciesInsertCall) Fields(s ...googleapi.Field) *RegionHealthAggregationPoliciesInsertCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionHealthAggregationPoliciesInsertCall) Context(ctx context.Context) *RegionHealthAggregationPoliciesInsertCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *RegionHealthAggregationPoliciesInsertCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionHealthAggregationPoliciesInsertCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.healthaggregationpolicy) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/healthAggregationPolicies") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.regionHealthAggregationPolicies.insert", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionHealthAggregationPolicies.insert" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *RegionHealthAggregationPoliciesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.regionHealthAggregationPolicies.insert", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type RegionHealthAggregationPoliciesListCall struct { + s *Service + project string + region string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists the HealthAggregationPolicies for a project in the given region. +// +// - project: Project ID for this request. +// - region: Name of the region scoping this request. +func (r *RegionHealthAggregationPoliciesService) List(project string, region string) *RegionHealthAggregationPoliciesListCall { + c := &RegionHealthAggregationPoliciesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + return c +} + +// Filter sets the optional parameter "filter": A filter expression that +// filters resources listed in the response. Most +// Compute resources support two types of filter expressions: +// expressions that support regular expressions and expressions that follow +// API improvement proposal AIP-160. +// These two types of filter expressions cannot be mixed in one request. +// +// If you want to use AIP-160, your expression must specify the field name, +// an +// operator, and the value that you want to use for filtering. The value +// must be a string, a number, or a boolean. The operator +// must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. +// +// For example, if you are filtering Compute Engine instances, you can +// exclude instances named `example-instance` by specifying +// `name != example-instance`. +// +// The `:*` comparison can be used to test whether a key has been defined. +// For example, to find all objects with `owner` label +// use: +// ``` +// labels.owner:* +// ``` +// +// You can also filter nested fields. For example, you could +// specify +// `scheduling.automaticRestart = false` to include instances only +// if they are not scheduled for automatic restarts. You can use filtering +// on nested fields to filter based onresource labels. +// +// To filter on multiple expressions, provide each separate expression +// within +// parentheses. For example: +// ``` +// (scheduling.automaticRestart = true) +// (cpuPlatform = "Intel Skylake") +// ``` +// By default, each expression is an `AND` expression. However, you +// can include `AND` and `OR` expressions explicitly. +// For example: +// ``` +// (cpuPlatform = "Intel Skylake") OR +// (cpuPlatform = "Intel Broadwell") AND +// (scheduling.automaticRestart = true) +// ``` +// +// If you want to use a regular expression, use the `eq` (equal) or `ne` +// (not equal) operator against a single un-parenthesized expression with +// or +// without quotes or against multiple parenthesized expressions. +// Examples: +// +// `fieldname eq unquoted literal` +// `fieldname eq 'single quoted literal'` +// `fieldname eq "double quoted literal" +// `(fieldname1 eq literal) (fieldname2 ne "literal")` +// +// The literal value is interpreted as a regular expression using GoogleRE2 +// library syntax. +// The literal value must match the entire field. +// +// For example, to filter for instances that do not end with name +// "instance", +// you would use `name ne .*instance`. +// +// You cannot combine constraints on multiple fields using regular +// expressions. +func (c *RegionHealthAggregationPoliciesListCall) Filter(filter string) *RegionHealthAggregationPoliciesListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// MaxResults sets the optional parameter "maxResults": The maximum number of +// results per page that should be returned. +// If the number of available results is larger than `maxResults`, +// Compute Engine returns a `nextPageToken` that can be used to get +// the next page of results in subsequent list requests. Acceptable values +// are +// `0` to `500`, inclusive. (Default: `500`) +func (c *RegionHealthAggregationPoliciesListCall) MaxResults(maxResults int64) *RegionHealthAggregationPoliciesListCall { + c.urlParams_.Set("maxResults", fmt.Sprint(maxResults)) + return c +} + +// OrderBy sets the optional parameter "orderBy": Sorts list results by a +// certain order. By default, results +// are returned in alphanumerical order based on the resource name. +// +// You can also sort results in descending order based on the +// creation +// timestamp using `orderBy="creationTimestamp desc". This sorts +// results based on the `creationTimestamp` field in +// reverse chronological order (newest result first). Use this to +// sort +// resources like operations so that the newest operation is returned +// first. +// +// Currently, only sorting by `name` or +// `creationTimestamp desc` is supported. +func (c *RegionHealthAggregationPoliciesListCall) OrderBy(orderBy string) *RegionHealthAggregationPoliciesListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageToken sets the optional parameter "pageToken": Specifies a page token to +// use. Set `pageToken` to the +// `nextPageToken` returned by a previous list request to get +// the next page of results. +func (c *RegionHealthAggregationPoliciesListCall) PageToken(pageToken string) *RegionHealthAggregationPoliciesListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": +// Opt-in for partial success behavior which provides partial results in +// case +// of failure. The default value is false. +// +// For example, when partial success behavior is enabled, aggregatedList for +// a +// single zone scope either returns all resources in the zone or no +// resources, +// with an error code. +func (c *RegionHealthAggregationPoliciesListCall) ReturnPartialSuccess(returnPartialSuccess bool) *RegionHealthAggregationPoliciesListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *RegionHealthAggregationPoliciesListCall) Fields(s ...googleapi.Field) *RegionHealthAggregationPoliciesListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *RegionHealthAggregationPoliciesListCall) IfNoneMatch(entityTag string) *RegionHealthAggregationPoliciesListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionHealthAggregationPoliciesListCall) Context(ctx context.Context) *RegionHealthAggregationPoliciesListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *RegionHealthAggregationPoliciesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionHealthAggregationPoliciesListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/healthAggregationPolicies") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.regionHealthAggregationPolicies.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionHealthAggregationPolicies.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *HealthAggregationPolicyList.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *RegionHealthAggregationPoliciesListCall) Do(opts ...googleapi.CallOption) (*HealthAggregationPolicyList, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &HealthAggregationPolicyList{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.regionHealthAggregationPolicies.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *RegionHealthAggregationPoliciesListCall) Pages(ctx context.Context, f func(*HealthAggregationPolicyList) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type RegionHealthAggregationPoliciesPatchCall struct { + s *Service + project string + region string + healthAggregationPolicy string + healthaggregationpolicy *HealthAggregationPolicy + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the specified regional HealthAggregationPolicy +// resource with the data included in the request. This method +// supportsPATCH +// semantics and uses theJSON merge +// patch format and processing rules. +// +// - healthAggregationPolicy: Name of the HealthAggregationPolicy to update. +// The name +// +// must be 1-63 characters long, and comply with RFC1035. +// - project: Project ID for this request. +// - region: Name of the region scoping this request. +func (r *RegionHealthAggregationPoliciesService) Patch(project string, region string, healthAggregationPolicy string, healthaggregationpolicy *HealthAggregationPolicy) *RegionHealthAggregationPoliciesPatchCall { + c := &RegionHealthAggregationPoliciesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.healthAggregationPolicy = healthAggregationPolicy + c.healthaggregationpolicy = healthaggregationpolicy + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so +// that if you must retry your request, the server will know to ignore +// the +// request if it has already been completed. +// +// For example, consider a situation where you make an initial request and +// the request times out. If you make the request again with the same +// request ID, the server can check if original operation with the same +// request ID was received, and if so, will ignore the second request. +// This +// prevents clients from accidentally creating duplicate commitments. +// +// The request ID must be +// a valid UUID with the exception that zero UUID is not +// supported +// (00000000-0000-0000-0000-000000000000). +func (c *RegionHealthAggregationPoliciesPatchCall) RequestId(requestId string) *RegionHealthAggregationPoliciesPatchCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *RegionHealthAggregationPoliciesPatchCall) Fields(s ...googleapi.Field) *RegionHealthAggregationPoliciesPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionHealthAggregationPoliciesPatchCall) Context(ctx context.Context) *RegionHealthAggregationPoliciesPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *RegionHealthAggregationPoliciesPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionHealthAggregationPoliciesPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.healthaggregationpolicy) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "healthAggregationPolicy": c.healthAggregationPolicy, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.regionHealthAggregationPolicies.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionHealthAggregationPolicies.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *RegionHealthAggregationPoliciesPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.regionHealthAggregationPolicies.patch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type RegionHealthAggregationPoliciesTestIamPermissionsCall struct { + s *Service + project string + region string + resource string + testpermissionsrequest *TestPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the specified +// resource. +// +// - project: Project ID for this request. +// - region: The name of the region for this request. +// - resource: Name or id of the resource for this request. +func (r *RegionHealthAggregationPoliciesService) TestIamPermissions(project string, region string, resource string, testpermissionsrequest *TestPermissionsRequest) *RegionHealthAggregationPoliciesTestIamPermissionsCall { + c := &RegionHealthAggregationPoliciesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.resource = resource + c.testpermissionsrequest = testpermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *RegionHealthAggregationPoliciesTestIamPermissionsCall) Fields(s ...googleapi.Field) *RegionHealthAggregationPoliciesTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionHealthAggregationPoliciesTestIamPermissionsCall) Context(ctx context.Context) *RegionHealthAggregationPoliciesTestIamPermissionsCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *RegionHealthAggregationPoliciesTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionHealthAggregationPoliciesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.testpermissionsrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/healthAggregationPolicies/{resource}/testIamPermissions") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "resource": c.resource, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.regionHealthAggregationPolicies.testIamPermissions", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionHealthAggregationPolicies.testIamPermissions" call. +// Any non-2xx status code is an error. Response headers are in either +// *TestPermissionsResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *RegionHealthAggregationPoliciesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestPermissionsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &TestPermissionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.regionHealthAggregationPolicies.testIamPermissions", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type RegionHealthCheckServicesDeleteCall struct { s *Service project string @@ -29955,7 +31139,7 @@ func (c *ReservationSubBlocksGetCall) doRequest(alt string) (*http.Response, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -30087,7 +31271,7 @@ func (c *ReservationSubBlocksGetIamPolicyCall) doRequest(alt string) (*http.Resp } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/getIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/getIamPolicy") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -30337,7 +31521,7 @@ func (c *ReservationSubBlocksListCall) doRequest(alt string) (*http.Response, er } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -30495,7 +31679,7 @@ func (c *ReservationSubBlocksPerformMaintenanceCall) doRequest(alt string) (*htt reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, nil) if err != nil { @@ -30637,7 +31821,7 @@ func (c *ReservationSubBlocksReportFaultyCall) doRequest(alt string) (*http.Resp } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -30755,7 +31939,7 @@ func (c *ReservationSubBlocksSetIamPolicyCall) doRequest(alt string) (*http.Resp } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/setIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/setIamPolicy") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -30872,7 +32056,7 @@ func (c *ReservationSubBlocksTestIamPermissionsCall) doRequest(alt string) (*htt } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{parentResource}/reservationSubBlocks/{resource}/testIamPermissions") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/testIamPermissions") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { diff --git a/contactcenterinsights/v1/contactcenterinsights-api.json b/contactcenterinsights/v1/contactcenterinsights-api.json index 268bba403c..75f98a230b 100644 --- a/contactcenterinsights/v1/contactcenterinsights-api.json +++ b/contactcenterinsights/v1/contactcenterinsights-api.json @@ -3555,7 +3555,7 @@ "type": "string" }, "updateMask": { - "description": "Optional. List of fields to be updated. All possible fields can be updated by passing `*`, or a subset of the following updateable fields can be provided: * `display_name` * `root_container`", + "description": "Optional. List of fields to be updated. All possible fields can be updated by passing `*`, or a subset of the following updateable fields can be provided: * `display_name` * `root_container` * `description`", "format": "google-fieldmask", "location": "query", "type": "string" @@ -6101,7 +6101,7 @@ } } }, - "revision": "20260202", + "revision": "20260219", "rootUrl": "https://contactcenterinsights.googleapis.com/", "schemas": { "GoogleCloudContactcenterinsightsV1Analysis": { diff --git a/contactcenterinsights/v1/contactcenterinsights-gen.go b/contactcenterinsights/v1/contactcenterinsights-gen.go index dfe8511708..2ef634b74b 100644 --- a/contactcenterinsights/v1/contactcenterinsights-gen.go +++ b/contactcenterinsights/v1/contactcenterinsights-gen.go @@ -33648,7 +33648,7 @@ func (r *ProjectsLocationsDashboardsService) Patch(name string, googlecloudconta // UpdateMask sets the optional parameter "updateMask": List of fields to be // updated. All possible fields can be updated by passing `*`, or a subset of // the following updateable fields can be provided: * `display_name` * -// `root_container` +// `root_container` * `description` func (c *ProjectsLocationsDashboardsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsDashboardsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c diff --git a/containeranalysis/v1/containeranalysis-api.json b/containeranalysis/v1/containeranalysis-api.json index 4a72348210..7e7e84c24a 100644 --- a/containeranalysis/v1/containeranalysis-api.json +++ b/containeranalysis/v1/containeranalysis-api.json @@ -1715,7 +1715,7 @@ } } }, - "revision": "20260130", + "revision": "20260213", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AliasContext": { @@ -1897,6 +1897,10 @@ "description": "The name of the base image.", "type": "string" }, + "registry": { + "description": "The registry in which the base image is from.", + "type": "string" + }, "repository": { "description": "The repository name in which the base image is from.", "type": "string" diff --git a/containeranalysis/v1/containeranalysis-gen.go b/containeranalysis/v1/containeranalysis-gen.go index 4b84ddae15..342b06e01f 100644 --- a/containeranalysis/v1/containeranalysis-gen.go +++ b/containeranalysis/v1/containeranalysis-gen.go @@ -493,6 +493,8 @@ type BaseImage struct { LayerCount int64 `json:"layerCount,omitempty"` // Name: The name of the base image. Name string `json:"name,omitempty"` + // Registry: The registry in which the base image is from. + Registry string `json:"registry,omitempty"` // Repository: The repository name in which the base image is from. Repository string `json:"repository,omitempty"` // ForceSendFields is a list of field names (e.g. "LayerCount") to diff --git a/containeranalysis/v1alpha1/containeranalysis-api.json b/containeranalysis/v1alpha1/containeranalysis-api.json index e2a82a7043..b925cc6028 100644 --- a/containeranalysis/v1alpha1/containeranalysis-api.json +++ b/containeranalysis/v1alpha1/containeranalysis-api.json @@ -1452,7 +1452,7 @@ } } }, - "revision": "20260123", + "revision": "20260213", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AnalysisCompleted": { @@ -1606,6 +1606,10 @@ "description": "The name of the base image.", "type": "string" }, + "registry": { + "description": "The registry of the base image.", + "type": "string" + }, "repository": { "description": "The repository name in which the base image is from.", "type": "string" diff --git a/containeranalysis/v1alpha1/containeranalysis-gen.go b/containeranalysis/v1alpha1/containeranalysis-gen.go index 3e5ac5f320..70438b448a 100644 --- a/containeranalysis/v1alpha1/containeranalysis-gen.go +++ b/containeranalysis/v1alpha1/containeranalysis-gen.go @@ -470,6 +470,8 @@ type BaseImage struct { LayerCount int64 `json:"layerCount,omitempty"` // Name: The name of the base image. Name string `json:"name,omitempty"` + // Registry: The registry of the base image. + Registry string `json:"registry,omitempty"` // Repository: The repository name in which the base image is from. Repository string `json:"repository,omitempty"` // ForceSendFields is a list of field names (e.g. "LayerCount") to diff --git a/dataflow/v1b3/dataflow-api.json b/dataflow/v1b3/dataflow-api.json index 6ed2a5fb20..948cb27809 100644 --- a/dataflow/v1b3/dataflow-api.json +++ b/dataflow/v1b3/dataflow-api.json @@ -94,6 +94,11 @@ "endpointUrl": "https://dataflow.europe-north1.rep.googleapis.com/", "location": "europe-north1" }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataflow.europe-north2.rep.googleapis.com/", + "location": "europe-north2" + }, { "description": "Regional Endpoint", "endpointUrl": "https://dataflow.europe-southwest1.rep.googleapis.com/", @@ -2395,7 +2400,7 @@ } } }, - "revision": "20260208", + "revision": "20260213", "rootUrl": "https://dataflow.googleapis.com/", "schemas": { "ApproximateProgress": { @@ -8189,6 +8194,16 @@ ], "type": "string" }, + "diskProvisionedIops": { + "description": "Optional. IOPS provisioned for the root disk for VMs.", + "format": "int64", + "type": "string" + }, + "diskProvisionedThroughputMibps": { + "description": "Optional. Throughput provisioned for the root disk for VMs.", + "format": "int64", + "type": "string" + }, "diskSizeGb": { "description": "Size of root disk for VMs, in GB. If zero or unspecified, the service will attempt to choose a reasonable default.", "format": "int32", diff --git a/dataflow/v1b3/dataflow-gen.go b/dataflow/v1b3/dataflow-gen.go index c990e870d0..2ce0022fe3 100644 --- a/dataflow/v1b3/dataflow-gen.go +++ b/dataflow/v1b3/dataflow-gen.go @@ -7345,6 +7345,11 @@ type WorkerPool struct { // "DEFAULT_PACKAGE_SET_PYTHON" - Stage packages typically useful to workers // written in Python. DefaultPackageSet string `json:"defaultPackageSet,omitempty"` + // DiskProvisionedIops: Optional. IOPS provisioned for the root disk for VMs. + DiskProvisionedIops int64 `json:"diskProvisionedIops,omitempty,string"` + // DiskProvisionedThroughputMibps: Optional. Throughput provisioned for the + // root disk for VMs. + DiskProvisionedThroughputMibps int64 `json:"diskProvisionedThroughputMibps,omitempty,string"` // DiskSizeGb: Size of root disk for VMs, in GB. If zero or unspecified, the // service will attempt to choose a reasonable default. DiskSizeGb int64 `json:"diskSizeGb,omitempty"` diff --git a/dataform/v1/dataform-api.json b/dataform/v1/dataform-api.json index 4857bda62a..78c9a5b876 100644 --- a/dataform/v1/dataform-api.json +++ b/dataform/v1/dataform-api.json @@ -164,7 +164,7 @@ ] }, "list": { - "description": "Lists information about the supported locations for this service.", + "description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "dataform.projects.locations.list", @@ -2467,7 +2467,7 @@ } } }, - "revision": "20251202", + "revision": "20260217", "rootUrl": "https://dataform.googleapis.com/", "schemas": { "ActionErrorTable": { @@ -4156,7 +4156,7 @@ "type": "array" }, "connection": { - "description": "Optional. The connection specifying the credentials to be used to read and write to external storage, such as Cloud Storage. The connection can have the form `{project}.{location}.{connection_id}` or `projects/{project}/locations/{location}/connections/{connection_id}\", or be set to DEFAULT.", + "description": "Optional. The connection specifying the credentials to be used to read and write to external storage, such as Cloud Storage. The connection can have the form `{project}.{location}.{connection_id}` or `projects/{project}/locations/{location}/connections/{connection_id}`, or be set to DEFAULT.", "type": "string" }, "dependencyTargets": { diff --git a/dataform/v1/dataform-gen.go b/dataform/v1/dataform-gen.go index f319ebcefc..224ef56634 100644 --- a/dataform/v1/dataform-gen.go +++ b/dataform/v1/dataform-gen.go @@ -2681,7 +2681,7 @@ type Relation struct { // Connection: Optional. The connection specifying the credentials to be used // to read and write to external storage, such as Cloud Storage. The connection // can have the form `{project}.{location}.{connection_id}` or - // `projects/{project}/locations/{location}/connections/{connection_id}", or be + // `projects/{project}/locations/{location}/connections/{connection_id}`, or be // set to DEFAULT. Connection string `json:"connection,omitempty"` // DependencyTargets: A list of actions that this action depends on. @@ -3866,7 +3866,11 @@ type ProjectsLocationsListCall struct { header_ http.Header } -// List: Lists information about the supported locations for this service. +// List: Lists information about the supported locations for this service. This +// method can be called in two ways: * **List all public locations:** Use the +// path `GET /v1/locations`. * **List project-visible locations:** Use the path +// `GET /v1/projects/{project_id}/locations`. This may include public locations +// as well as private or other locations specifically visible to the project. // // - name: The resource that owns the locations collection, if applicable. func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { diff --git a/dataform/v1beta1/dataform-api.json b/dataform/v1beta1/dataform-api.json index 910ede394f..6f77fcbe8b 100644 --- a/dataform/v1beta1/dataform-api.json +++ b/dataform/v1beta1/dataform-api.json @@ -164,7 +164,7 @@ ] }, "list": { - "description": "Lists information about the supported locations for this service.", + "description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1beta1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "dataform.projects.locations.list", @@ -2955,7 +2955,7 @@ } } }, - "revision": "20260106", + "revision": "20260217", "rootUrl": "https://dataform.googleapis.com/", "schemas": { "ActionErrorTable": { @@ -4322,7 +4322,7 @@ "id": "MoveFolderRequest", "properties": { "destinationContainingFolder": { - "description": "Required. The name of the Folder, TeamFolder, or root location to move the Folder to. Can be in the format of: - \"\" to move into the root User folder - `projects/*/locations/*/folders/*` - `projects/*/locations/*/teamFolders/*`", + "description": "Optional. The name of the Folder, TeamFolder, or root location to move the Folder to. Can be in the format of: \"\" to move into the root User folder, `projects/*/locations/*/folders/*`, `projects/*/locations/*/teamFolders/*`", "type": "string" } }, @@ -4333,7 +4333,7 @@ "id": "MoveRepositoryRequest", "properties": { "destinationContainingFolder": { - "description": "Required. The name of the Folder, TeamFolder, or root location to move the repository to. Can be in the format of: - \"\" to move into the root User folder - `projects/*/locations/*/folders/*` - `projects/*/locations/*/teamFolders/*`", + "description": "Optional. The name of the Folder, TeamFolder, or root location to move the repository to. Can be in the format of: \"\" to move into the root User folder, `projects/*/locations/*/folders/*`, `projects/*/locations/*/teamFolders/*`", "type": "string" } }, @@ -4781,7 +4781,7 @@ "type": "array" }, "connection": { - "description": "Optional. The connection specifying the credentials to be used to read and write to external storage, such as Cloud Storage. The connection can have the form `{project}.{location}.{connection_id}` or `projects/{project}/locations/{location}/connections/{connection_id}\", or be set to DEFAULT.", + "description": "Optional. The connection specifying the credentials to be used to read and write to external storage, such as Cloud Storage. The connection can have the form `{project}.{location}.{connection_id}` or `projects/{project}/locations/{location}/connections/{connection_id}`, or be set to DEFAULT.", "type": "string" }, "dependencyTargets": { diff --git a/dataform/v1beta1/dataform-gen.go b/dataform/v1beta1/dataform-gen.go index 2deb1f393b..4603dbd27e 100644 --- a/dataform/v1beta1/dataform-gen.go +++ b/dataform/v1beta1/dataform-gen.go @@ -2161,9 +2161,9 @@ type MoveFileResponse struct { // MoveFolderRequest: `MoveFolder` request message. type MoveFolderRequest struct { - // DestinationContainingFolder: Required. The name of the Folder, TeamFolder, - // or root location to move the Folder to. Can be in the format of: - "" to - // move into the root User folder - `projects/*/locations/*/folders/*` - + // DestinationContainingFolder: Optional. The name of the Folder, TeamFolder, + // or root location to move the Folder to. Can be in the format of: "" to move + // into the root User folder, `projects/*/locations/*/folders/*`, // `projects/*/locations/*/teamFolders/*` DestinationContainingFolder string `json:"destinationContainingFolder,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -2186,9 +2186,9 @@ func (s MoveFolderRequest) MarshalJSON() ([]byte, error) { // MoveRepositoryRequest: `MoveRepository` request message. type MoveRepositoryRequest struct { - // DestinationContainingFolder: Required. The name of the Folder, TeamFolder, - // or root location to move the repository to. Can be in the format of: - "" to - // move into the root User folder - `projects/*/locations/*/folders/*` - + // DestinationContainingFolder: Optional. The name of the Folder, TeamFolder, + // or root location to move the repository to. Can be in the format of: "" to + // move into the root User folder, `projects/*/locations/*/folders/*`, // `projects/*/locations/*/teamFolders/*` DestinationContainingFolder string `json:"destinationContainingFolder,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -2890,7 +2890,7 @@ type Relation struct { // Connection: Optional. The connection specifying the credentials to be used // to read and write to external storage, such as Cloud Storage. The connection // can have the form `{project}.{location}.{connection_id}` or - // `projects/{project}/locations/{location}/connections/{connection_id}", or be + // `projects/{project}/locations/{location}/connections/{connection_id}`, or be // set to DEFAULT. Connection string `json:"connection,omitempty"` // DependencyTargets: A list of actions that this action depends on. @@ -4237,7 +4237,11 @@ type ProjectsLocationsListCall struct { header_ http.Header } -// List: Lists information about the supported locations for this service. +// List: Lists information about the supported locations for this service. This +// method can be called in two ways: * **List all public locations:** Use the +// path `GET /v1/locations`. * **List project-visible locations:** Use the path +// `GET /v1/projects/{project_id}/locations`. This may include public locations +// as well as private or other locations specifically visible to the project. // // - name: The resource that owns the locations collection, if applicable. func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { diff --git a/datamanager/v1/datamanager-api.json b/datamanager/v1/datamanager-api.json index 83fa2aecc2..859408765e 100644 --- a/datamanager/v1/datamanager-api.json +++ b/datamanager/v1/datamanager-api.json @@ -105,6 +105,627 @@ }, "protocol": "rest", "resources": { + "accountTypes": { + "resources": { + "accounts": { + "resources": { + "insights": { + "methods": { + "retrieve": { + "description": "Retrieves marketing data insights for a given user list. This feature is only available to data partners. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/insights:retrieve", + "httpMethod": "POST", + "id": "datamanager.accountTypes.accounts.insights.retrieve", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent account that owns the user list. Format: `accountTypes/{account_type}/accounts/{account}`", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/insights:retrieve", + "request": { + "$ref": "RetrieveInsightsRequest" + }, + "response": { + "$ref": "RetrieveInsightsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + } + } + }, + "partnerLinks": { + "methods": { + "create": { + "description": "Creates a partner link for the given account. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/partnerLinks", + "httpMethod": "POST", + "id": "datamanager.accountTypes.accounts.partnerLinks.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent, which owns this collection of partner links. Format: accountTypes/{account_type}/accounts/{account}", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/partnerLinks", + "request": { + "$ref": "PartnerLink" + }, + "response": { + "$ref": "PartnerLink" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + }, + "delete": { + "description": "Deletes a partner link for the given account. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/partnerLinks/{partnerLinksId}", + "httpMethod": "DELETE", + "id": "datamanager.accountTypes.accounts.partnerLinks.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the partner link to delete. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+/partnerLinks/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + }, + "search": { + "description": "Searches for all partner links to and from a given account. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/partnerLinks:search", + "httpMethod": "GET", + "id": "datamanager.accountTypes.accounts.partnerLinks.search", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. A [filter string](//google.aip.dev/160). All fields need to be on the left hand side of each condition (for example: `partner_link_id = 123456789`). Supported operations: - `AND` - `=` - `!=` Supported fields: - `partner_link_id` - `owning_account.account_type` - `owning_account.account_id` - `partner_account.account_type` - `partner_account.account_id` Example: `owning_account.account_type = \"GOOGLE_ADS\" OR partner_account.account_id = 987654321`", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "The maximum number of partner links to return. The service may return fewer than this value. If unspecified, at most 10 partner links will be returned. The maximum value is 100; values above 100 will be coerced to 100.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A page token, received from a previous `SearchPartnerLinks` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `SearchPartnerLinks` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Account to search for partner links. If no `filter` is specified, all partner links where this account is either the `owning_account` or `partner_account` are returned. Format: `accountTypes/{account_type}/accounts/{account}`", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/partnerLinks:search", + "response": { + "$ref": "SearchPartnerLinksResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + } + } + }, + "userListDirectLicenses": { + "methods": { + "create": { + "description": "Creates a user list direct license. This feature is only available to data partners.", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListDirectLicenses", + "httpMethod": "POST", + "id": "datamanager.accountTypes.accounts.userListDirectLicenses.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The account that owns the user list being licensed. Should be in the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/userListDirectLicenses", + "request": { + "$ref": "UserListDirectLicense" + }, + "response": { + "$ref": "UserListDirectLicense" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + }, + "get": { + "description": "Retrieves a user list direct license. This feature is only available to data partners.", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListDirectLicenses/{userListDirectLicensesId}", + "httpMethod": "GET", + "id": "datamanager.accountTypes.accounts.userListDirectLicenses.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the user list direct license.", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+/userListDirectLicenses/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "UserListDirectLicense" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + }, + "list": { + "description": "Lists all user list direct licenses owned by the parent account. This feature is only available to data partners.", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListDirectLicenses", + "httpMethod": "GET", + "id": "datamanager.accountTypes.accounts.userListDirectLicenses.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Filters to apply to the list request. All fields need to be on the left hand side of each condition (for example: user_list_id = 123). **Supported Operations:** - `AND` - `=` - `!=` - `\u003e` - `\u003e=` - `\u003c` - `\u003c=` **Unsupported Fields:** - `name` (use get method instead) - `historical_pricings` and all its subfields - `pricing.start_time` - `pricing.end_time`", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of licenses to return per page. The service may return fewer than this value. If unspecified, at most 50 licenses will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token, received from a previous `ListUserListDirectLicense` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserListDirectLicense` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The account whose licenses are being queried. Should be in the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/userListDirectLicenses", + "response": { + "$ref": "ListUserListDirectLicensesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + }, + "patch": { + "description": "Updates a user list direct license. This feature is only available to data partners.", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListDirectLicenses/{userListDirectLicensesId}", + "httpMethod": "PATCH", + "id": "datamanager.accountTypes.accounts.userListDirectLicenses.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. The resource name of the user list direct license.", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+/userListDirectLicenses/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. The list of fields to update. The special character `*` is not supported and an `INVALID_UPDATE_MASK` error will be thrown if used.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "UserListDirectLicense" + }, + "response": { + "$ref": "UserListDirectLicense" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + } + } + }, + "userListGlobalLicenses": { + "methods": { + "create": { + "description": "Creates a user list global license. This feature is only available to data partners.", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListGlobalLicenses", + "httpMethod": "POST", + "id": "datamanager.accountTypes.accounts.userListGlobalLicenses.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The account that owns the user list being licensed. Should be in the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/userListGlobalLicenses", + "request": { + "$ref": "UserListGlobalLicense" + }, + "response": { + "$ref": "UserListGlobalLicense" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + }, + "get": { + "description": "Retrieves a user list global license. This feature is only available to data partners.", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListGlobalLicenses/{userListGlobalLicensesId}", + "httpMethod": "GET", + "id": "datamanager.accountTypes.accounts.userListGlobalLicenses.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the user list global license.", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+/userListGlobalLicenses/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "UserListGlobalLicense" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + }, + "list": { + "description": "Lists all user list global licenses owned by the parent account. This feature is only available to data partners.", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListGlobalLicenses", + "httpMethod": "GET", + "id": "datamanager.accountTypes.accounts.userListGlobalLicenses.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Filters to apply to the list request. All fields need to be on the left hand side of each condition (for example: user_list_id = 123). **Supported Operations:** - `AND` - `=` - `!=` - `\u003e` - `\u003e=` - `\u003c` - `\u003c=` **Unsupported Fields:** - `name` (use get method instead) - `historical_pricings` and all its subfields - `pricing.start_time` - `pricing.end_time`", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of licenses to return. The service may return fewer than this value. If unspecified, at most 50 licenses will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token, received from a previous `ListUserListGlobalLicense` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserListDirectLicense` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The account whose licenses are being queried. Should be in the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/userListGlobalLicenses", + "response": { + "$ref": "ListUserListGlobalLicensesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + }, + "patch": { + "description": "Updates a user list global license. This feature is only available to data partners.", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListGlobalLicenses/{userListGlobalLicensesId}", + "httpMethod": "PATCH", + "id": "datamanager.accountTypes.accounts.userListGlobalLicenses.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. The resource name of the user list global license.", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+/userListGlobalLicenses/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. The list of fields to update. The special character `*` is not supported and an `INVALID_UPDATE_MASK` error will be thrown if used.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "UserListGlobalLicense" + }, + "response": { + "$ref": "UserListGlobalLicense" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + } + }, + "resources": { + "userListGlobalLicenseCustomerInfos": { + "methods": { + "list": { + "description": "Lists all customer info for a user list global license. This feature is only available to data partners.", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userListGlobalLicenses/{userListGlobalLicensesId}/userListGlobalLicenseCustomerInfos", + "httpMethod": "GET", + "id": "datamanager.accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Filters to apply to the list request. All fields need to be on the left hand side of each condition (for example: user_list_id = 123). **Supported Operations:** - `AND` - `=` - `!=` - `\u003e` - `\u003e=` - `\u003c` - `\u003c=` **Unsupported Fields:** - `name` (use get method instead) - `historical_pricings` and all its subfields - `pricing.start_time` - `pricing.end_time`", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of licenses to return. The service may return fewer than this value. If unspecified, at most 50 licenses will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token, received from a previous `ListUserListDirectLicense` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserListDirectLicense` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The global license whose customer info are being queried. Should be in the format `accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}`. To list all global license customer info under an account, replace the user list global license id with a '-' (for example, `accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-`)", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+/userListGlobalLicenses/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/userListGlobalLicenseCustomerInfos", + "response": { + "$ref": "ListUserListGlobalLicenseCustomerInfosResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + } + } + } + } + }, + "userLists": { + "methods": { + "create": { + "description": "Creates a UserList. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userLists", + "httpMethod": "POST", + "id": "datamanager.accountTypes.accounts.userLists.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent account where this user list will be created. Format: accountTypes/{account_type}/accounts/{account}", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Optional. If true, the request is validated but not executed.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+parent}/userLists", + "request": { + "$ref": "UserList" + }, + "response": { + "$ref": "UserList" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + }, + "delete": { + "description": "Deletes a UserList. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userLists/{userListsId}", + "httpMethod": "DELETE", + "id": "datamanager.accountTypes.accounts.userLists.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the user list to delete. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+/userLists/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Optional. If true, the request is validated but not executed.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + }, + "get": { + "description": "Gets a UserList. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userLists/{userListsId}", + "httpMethod": "GET", + "id": "datamanager.accountTypes.accounts.userLists.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the UserList to retrieve. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+/userLists/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "UserList" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + }, + "list": { + "description": "Lists UserLists. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userLists", + "httpMethod": "GET", + "id": "datamanager.accountTypes.accounts.userLists.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. A [filter string](//google.aip.dev/160). All fields need to be on the left hand side of each condition (for example: `display_name = \"list 1\"`). Supported operations: - `AND` - `=` - `!=` - `\u003e` - `\u003e=` - `\u003c` - `\u003c=` - `:` (has) Supported fields: - `id` - `display_name` - `description` - `membership_status` - `integration_code` - `access_reason` - `ingested_user_list_info.upload_key_types`", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of user lists to return. The service may return fewer than this value. If unspecified, at most 50 user lists will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token, received from a previous `ListUserLists` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserLists` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent account which owns this collection of user lists. Format: accountTypes/{account_type}/accounts/{account}", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/userLists", + "response": { + "$ref": "ListUserListsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + }, + "patch": { + "description": "Updates a UserList. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`", + "flatPath": "v1/accountTypes/{accountTypesId}/accounts/{accountsId}/userLists/{userListsId}", + "httpMethod": "PATCH", + "id": "datamanager.accountTypes.accounts.userLists.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. The resource name of the user list. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}", + "location": "path", + "pattern": "^accountTypes/[^/]+/accounts/[^/]+/userLists/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. The list of fields to update.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "Optional. If true, the request is validated but not executed.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "UserList" + }, + "response": { + "$ref": "UserList" + }, + "scopes": [ + "https://www.googleapis.com/auth/datamanager" + ] + } + } + } + } + } + } + }, "audienceMembers": { "methods": { "ingest": { @@ -193,7 +814,7 @@ } } }, - "revision": "20260102", + "revision": "20260217", "rootUrl": "https://datamanager.googleapis.com/", "schemas": { "AdIdentifiers": { @@ -267,11 +888,19 @@ }, "pairData": { "$ref": "PairData", - "description": "[Publisher Advertiser Identity Reconciliation (PAIR) IDs](//support.google.com/admanager/answer/15067908)." + "description": "[Publisher Advertiser Identity Reconciliation (PAIR) IDs](//support.google.com/admanager/answer/15067908). This feature is only available to data partners." + }, + "ppidData": { + "$ref": "PpidData", + "description": "Data related to publisher provided identifiers. This feature is only available to data partners." }, "userData": { "$ref": "UserData", "description": "User-provided data that identifies the user." + }, + "userIdData": { + "$ref": "UserIdData", + "description": "Data related to unique identifiers for a user, as defined by the advertiser." } }, "type": "object" @@ -307,6 +936,21 @@ }, "type": "object" }, + "Baseline": { + "description": "Baseline criteria against which insights are compared.", + "id": "Baseline", + "properties": { + "baselineLocation": { + "$ref": "Location", + "description": "The baseline location of the request. Baseline location is an OR-list of the requested regions." + }, + "locationAutoDetectionEnabled": { + "description": "If set to true, the service will try to automatically detect the baseline location for insights.", + "type": "boolean" + } + }, + "type": "object" + }, "CartData": { "description": "The cart data associated with the event.", "id": "CartData", @@ -373,6 +1017,37 @@ }, "type": "object" }, + "ContactIdInfo": { + "description": "Additional information when `CONTACT_ID` is one of the `upload_key_types`.", + "id": "ContactIdInfo", + "properties": { + "dataSourceType": { + "description": "Optional. Immutable. Source of the upload data", + "enum": [ + "DATA_SOURCE_TYPE_UNSPECIFIED", + "DATA_SOURCE_TYPE_FIRST_PARTY", + "DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU", + "DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE", + "DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA" + ], + "enumDescriptions": [ + "Not specified.", + "The uploaded data is first-party data.", + "The uploaded data is from a third-party credit bureau.", + "The uploaded data is from a third-party voter file.", + "The uploaded data is third party partner data." + ], + "type": "string" + }, + "matchRatePercentage": { + "description": "Output only. Match rate for customer match user lists.", + "format": "int32", + "readOnly": true, + "type": "integer" + } + }, + "type": "object" + }, "CustomVariable": { "description": "Custom variable for ads conversions.", "id": "CustomVariable", @@ -437,6 +1112,12 @@ }, "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" + }, "EncryptionInfo": { "description": "Encryption information for the data being ingested.", "id": "EncryptionInfo", @@ -791,9 +1472,17 @@ "$ref": "IngestPairDataStatus", "description": "The status of the pair data ingestion to the destination." }, + "ppidDataIngestionStatus": { + "$ref": "IngestPpidDataStatus", + "description": "The status of the ppid data ingestion to the destination." + }, "userDataIngestionStatus": { "$ref": "IngestUserDataStatus", "description": "The status of the user data ingestion to the destination." + }, + "userIdDataIngestionStatus": { + "$ref": "IngestUserIdDataStatus", + "description": "The status of the user id data ingestion to the destination." } }, "type": "object" @@ -902,6 +1591,23 @@ }, "type": "object" }, + "IngestPpidDataStatus": { + "description": "The status of the ppid data ingestion to the destination containing stats related to the ingestion.", + "id": "IngestPpidDataStatus", + "properties": { + "ppidCount": { + "description": "The total count of ppids sent in the upload request for the destination. Includes all ppids in the request, regardless of whether they were successfully ingested or not.", + "format": "int64", + "type": "string" + }, + "recordCount": { + "description": "The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "IngestUserDataStatus": { "description": "The status of the user data ingestion to the destination containing stats related to the ingestion.", "id": "IngestUserDataStatus", @@ -949,6 +1655,77 @@ }, "type": "object" }, + "IngestUserIdDataStatus": { + "description": "The status of the user id data ingestion to the destination containing stats related to the ingestion.", + "id": "IngestUserIdDataStatus", + "properties": { + "recordCount": { + "description": "The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not.", + "format": "int64", + "type": "string" + }, + "userIdCount": { + "description": "The total count of user ids sent in the upload request for the destination. Includes all user ids in the request, regardless of whether they were successfully ingested or not.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "IngestedUserListInfo": { + "description": "Represents a user list that is populated by user provided data.", + "id": "IngestedUserListInfo", + "properties": { + "contactIdInfo": { + "$ref": "ContactIdInfo", + "description": "Optional. Additional information when `CONTACT_ID` is one of the `upload_key_types`." + }, + "mobileIdInfo": { + "$ref": "MobileIdInfo", + "description": "Optional. Additional information when `MOBILE_ID` is one of the `upload_key_types`." + }, + "pairIdInfo": { + "$ref": "PairIdInfo", + "description": "Optional. Additional information when `PAIR_ID` is one of the `upload_key_types`. This feature is only available to data partners." + }, + "partnerAudienceInfo": { + "$ref": "PartnerAudienceInfo", + "description": "Optional. Additional information for partner audiences. This feature is only available to data partners." + }, + "pseudonymousIdInfo": { + "$ref": "PseudonymousIdInfo", + "description": "Optional. Additional information for `PSEUDONYMOUS_ID` is one of the `upload_key_types`." + }, + "uploadKeyTypes": { + "description": "Required. Immutable. Upload key types of this user list.", + "items": { + "enum": [ + "UPLOAD_KEY_TYPE_UNSPECIFIED", + "CONTACT_ID", + "MOBILE_ID", + "USER_ID", + "PAIR_ID", + "PSEUDONYMOUS_ID" + ], + "enumDescriptions": [ + "Not specified.", + "Customer info such as email address, phone number or physical address.", + "Mobile advertising ids.", + "Third party provided user ids.", + "Publisher advertiser identity reconciliation ids.", + "Data Management Platform IDs: - Google User ID - Partner Provided ID - Publisher Provided ID - iOS IDFA - Android advertising ID - Roku ID - Amazon Fire TV ID - Xbox or Microsoft ID" + ], + "type": "string" + }, + "type": "array" + }, + "userIdInfo": { + "$ref": "UserIdInfo", + "description": "Optional. Additional information when `USER_ID` is one of the `upload_key_types`." + } + }, + "type": "object" + }, "Item": { "description": "Represents an item in the cart associated with the event.", "id": "Item", @@ -996,6 +1773,183 @@ }, "type": "object" }, + "ListUserListDirectLicensesResponse": { + "description": "Response from the ListUserListDirectLicensesRequest.", + "id": "ListUserListDirectLicensesResponse", + "properties": { + "nextPageToken": { + "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", + "type": "string" + }, + "userListDirectLicenses": { + "description": "The licenses for the given user list in the request.", + "items": { + "$ref": "UserListDirectLicense" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListUserListGlobalLicenseCustomerInfosResponse": { + "description": "Response from the ListUserListGlobalLicensesCustomerInfoRequest.", + "id": "ListUserListGlobalLicenseCustomerInfosResponse", + "properties": { + "nextPageToken": { + "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", + "type": "string" + }, + "userListGlobalLicenseCustomerInfos": { + "description": "The customer information for the given license in the request.", + "items": { + "$ref": "UserListGlobalLicenseCustomerInfo" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListUserListGlobalLicensesResponse": { + "description": "Response from the ListUserListGlobalLicensesRequest.", + "id": "ListUserListGlobalLicensesResponse", + "properties": { + "nextPageToken": { + "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", + "type": "string" + }, + "userListGlobalLicenses": { + "description": "The licenses for the given user list in the request.", + "items": { + "$ref": "UserListGlobalLicense" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListUserListsResponse": { + "description": "Response message for ListUserLists.", + "id": "ListUserListsResponse", + "properties": { + "nextPageToken": { + "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", + "type": "string" + }, + "userLists": { + "description": "The user lists from the specified account.", + "items": { + "$ref": "UserList" + }, + "type": "array" + } + }, + "type": "object" + }, + "Location": { + "description": "The baseline location of the request. Baseline location is on OR-list of ISO 3166-1 alpha-2 region codes of the requested regions.", + "id": "Location", + "properties": { + "regionCodes": { + "description": "List of ISO 3166-1 alpha-2 region codes.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "MarketingDataInsight": { + "description": "Insights for marketing data. This feature is only available to data partners.", + "id": "MarketingDataInsight", + "properties": { + "attributes": { + "description": "Insights for values of a given dimension.", + "items": { + "$ref": "MarketingDataInsightsAttribute" + }, + "type": "array" + }, + "dimension": { + "description": "The dimension to which the insight belongs.", + "enum": [ + "AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED", + "AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN", + "AFFINITY_USER_INTEREST", + "IN_MARKET_USER_INTEREST", + "AGE_RANGE", + "GENDER" + ], + "enumDescriptions": [ + "Not specified.", + "The value is unknown in this version.", + "An Affinity UserInterest.", + "An In-Market UserInterest.", + "An age range.", + "A gender." + ], + "type": "string" + } + }, + "type": "object" + }, + "MarketingDataInsightsAttribute": { + "description": "Insights for a collection of related attributes of the same dimension.", + "id": "MarketingDataInsightsAttribute", + "properties": { + "ageRange": { + "description": "Age range of the audience for which the lift is provided.", + "enum": [ + "AGE_RANGE_UNSPECIFIED", + "AGE_RANGE_UNKNOWN", + "AGE_RANGE_18_24", + "AGE_RANGE_25_34", + "AGE_RANGE_35_44", + "AGE_RANGE_45_54", + "AGE_RANGE_55_64", + "AGE_RANGE_65_UP" + ], + "enumDescriptions": [ + "Not specified.", + "Unknown.", + "Between 18 and 24 years old.", + "Between 25 and 34 years old.", + "Between 35 and 44 years old.", + "Between 45 and 54 years old.", + "Between 55 and 64 years old.", + "65 years old and beyond." + ], + "type": "string" + }, + "gender": { + "description": "Gender of the audience for which the lift is provided.", + "enum": [ + "GENDER_UNSPECIFIED", + "GENDER_UNKNOWN", + "GENDER_MALE", + "GENDER_FEMALE" + ], + "enumDescriptions": [ + "Not specified.", + "Unknown.", + "Male.", + "Female." + ], + "type": "string" + }, + "lift": { + "description": "Measure of lift that the audience has for the attribute value as compared to the baseline. Range [0-1].", + "format": "float", + "type": "number" + }, + "userInterestId": { + "description": "The user interest ID.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "MobileData": { "description": "Mobile IDs for the audience. At least one mobile ID is required.", "id": "MobileData", @@ -1010,8 +1964,51 @@ }, "type": "object" }, + "MobileIdInfo": { + "description": "Additional information when `MOBILE_ID` is one of the `upload_key_types`.", + "id": "MobileIdInfo", + "properties": { + "appId": { + "description": "Required. Immutable. A string that uniquely identifies a mobile application from which the data was collected.", + "type": "string" + }, + "dataSourceType": { + "description": "Optional. Immutable. Source of the upload data.", + "enum": [ + "DATA_SOURCE_TYPE_UNSPECIFIED", + "DATA_SOURCE_TYPE_FIRST_PARTY", + "DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU", + "DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE", + "DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA" + ], + "enumDescriptions": [ + "Not specified.", + "The uploaded data is first-party data.", + "The uploaded data is from a third-party credit bureau.", + "The uploaded data is from a third-party voter file.", + "The uploaded data is third party partner data." + ], + "type": "string" + }, + "keySpace": { + "description": "Required. Immutable. The key space of mobile IDs.", + "enum": [ + "KEY_SPACE_UNSPECIFIED", + "IOS", + "ANDROID" + ], + "enumDescriptions": [ + "Not specified.", + "The iOS keyspace.", + "The Android keyspace." + ], + "type": "string" + } + }, + "type": "object" + }, "PairData": { - "description": "[PAIR](//support.google.com/admanager/answer/15067908) IDs for the audience. At least one PAIR ID is required.", + "description": "[PAIR](//support.google.com/admanager/answer/15067908) IDs for the audience. At least one PAIR ID is required. This feature is only available to data partners.", "id": "PairData", "properties": { "pairIds": { @@ -1024,6 +2021,103 @@ }, "type": "object" }, + "PairIdInfo": { + "description": "Additional information when `PAIR_ID` is one of the `upload_key_types`. This feature is only available to data partners.", + "id": "PairIdInfo", + "properties": { + "advertiserIdentifierCount": { + "description": "Output only. The count of the advertiser's first party data records that have been uploaded to a clean room provider. This does not signify the size of a PAIR user list.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "cleanRoomIdentifier": { + "description": "Required. Immutable. Identifies a unique advertiser to publisher relationship with one clean room provider or across multiple clean room providers.", + "type": "string" + }, + "matchRatePercentage": { + "description": "Output only. This field denotes the percentage of membership match of this user list with the corresponding publisher's first party data. Must be between 0 and 100 inclusive.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "publisherId": { + "description": "Required. Immutable. Identifies the publisher that the Publisher Advertiser Identity Reconciliation user list is reconciled with. This field is provided by the cleanroom provider and is only unique in the scope of that cleanroom. This cannot be used as a global identifier across multiple cleanrooms.", + "format": "int64", + "type": "string" + }, + "publisherName": { + "description": "Optional. Descriptive name of the publisher to be displayed in the UI for a better targeting experience.", + "type": "string" + } + }, + "type": "object" + }, + "PartnerAudienceInfo": { + "description": "Additional information for partner audiences. This feature is only available to data partners.", + "id": "PartnerAudienceInfo", + "properties": { + "commercePartner": { + "description": "Optional. The commerce partner name. Only allowed if `partner_audience_source` is `COMMERCE_AUDIENCE`.", + "type": "string" + }, + "partnerAudienceSource": { + "description": "Required. Immutable. The source of the partner audience.", + "enum": [ + "PARTNER_AUDIENCE_SOURCE_UNSPECIFIED", + "COMMERCE_AUDIENCE", + "LINEAR_TV_AUDIENCE", + "AGENCY_PROVIDER_AUDIENCE" + ], + "enumDescriptions": [ + "Not specified.", + "Partner Audience source is commerce audience.", + "Partner Audience source is linear TV audience.", + "Partner Audience source is agency/provider audience." + ], + "type": "string" + } + }, + "type": "object" + }, + "PartnerLink": { + "description": "A partner link between an owning account and a partner account.", + "id": "PartnerLink", + "properties": { + "name": { + "description": "Identifier. The name of the partner link. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}", + "type": "string" + }, + "owningAccount": { + "$ref": "ProductAccount", + "description": "Required. The owning account granting access to the partner account." + }, + "partnerAccount": { + "$ref": "ProductAccount", + "description": "Required. The partner account granted access by the owning account." + }, + "partnerLinkId": { + "description": "Output only. The partner link ID.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "PpidData": { + "description": "Publisher provided identifiers data holding the ppids. At least one ppid is required. This feature is only available to data partners.", + "id": "PpidData", + "properties": { + "ppids": { + "description": "Required. The list of publisher provided identifiers for a user.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "ProductAccount": { "description": "Represents a specific account.", "id": "ProductAccount", @@ -1040,7 +2134,8 @@ "DISPLAY_VIDEO_PARTNER", "DISPLAY_VIDEO_ADVERTISER", "DATA_PARTNER", - "GOOGLE_ANALYTICS_PROPERTY" + "GOOGLE_ANALYTICS_PROPERTY", + "GOOGLE_AD_MANAGER_AUDIENCE_LINK" ], "enumDescriptions": [ "Unspecified product. Should never be used.", @@ -1048,7 +2143,8 @@ "Display \u0026 Video 360 partner.", "Display \u0026 Video 360 advertiser.", "Data Partner.", - "Google Analytics." + "Google Analytics.", + "Google Ad Manager audience link." ], "type": "string" }, @@ -1074,6 +2170,35 @@ }, "type": "object" }, + "PseudonymousIdInfo": { + "description": "Additional information when `PSEUDONYMOUS_ID` is one of the `upload_key_types`.", + "id": "PseudonymousIdInfo", + "properties": { + "billableRecordCount": { + "description": "Optional. Immutable. The number of billable records (e.g. uploaded or matched).", + "format": "int64", + "type": "string" + }, + "syncStatus": { + "description": "Output only. Sync status of the user list.", + "enum": [ + "SYNC_STATUS_UNSPECIFIED", + "CREATED", + "READY_FOR_USE", + "FAILED" + ], + "enumDescriptions": [ + "Not specified.", + "The user list has been created as a placeholder. List contents and/or metadata are still being synced. The user list is not ready for use.", + "The user list is ready for use. Contents and cookies have been synced correctly.", + "An error has occurred syncing user list contents and/or metadata. The user list cannot be used." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "RemoveAudienceMembersRequest": { "description": "Request to remove users from an audience in the provided destinations. Returns a RemoveAudienceMembersResponse.", "id": "RemoveAudienceMembersRequest", @@ -1140,9 +2265,17 @@ "$ref": "RemovePairDataStatus", "description": "The status of the pair data removal from the destination." }, + "ppidDataRemovalStatus": { + "$ref": "RemovePpidDataStatus", + "description": "The status of the ppid data removal from the destination." + }, "userDataRemovalStatus": { "$ref": "RemoveUserDataStatus", "description": "The status of the user data removal from the destination." + }, + "userIdDataRemovalStatus": { + "$ref": "RemoveUserIdDataStatus", + "description": "The status of the user id data removal from the destination." } }, "type": "object" @@ -1181,16 +2314,33 @@ }, "type": "object" }, - "RemoveUserDataStatus": { - "description": "The status of the user data removal from the destination.", - "id": "RemoveUserDataStatus", + "RemovePpidDataStatus": { + "description": "The status of the ppid data removal from the destination.", + "id": "RemovePpidDataStatus", "properties": { + "ppidCount": { + "description": "The total count of ppids sent in the removal request. Includes all ppids in the request, regardless of whether they were successfully removed or not.", + "format": "int64", + "type": "string" + }, "recordCount": { "description": "The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.", "format": "int64", "type": "string" - }, - "userIdentifierCount": { + } + }, + "type": "object" + }, + "RemoveUserDataStatus": { + "description": "The status of the user data removal from the destination.", + "id": "RemoveUserDataStatus", + "properties": { + "recordCount": { + "description": "The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.", + "format": "int64", + "type": "string" + }, + "userIdentifierCount": { "description": "The total count of user identifiers sent in the removal request. Includes all user identifiers in the request, regardless of whether they were successfully removed or not.", "format": "int64", "type": "string" @@ -1198,6 +2348,23 @@ }, "type": "object" }, + "RemoveUserIdDataStatus": { + "description": "The status of the user id data removal from the destination.", + "id": "RemoveUserIdDataStatus", + "properties": { + "recordCount": { + "description": "The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not.", + "format": "int64", + "type": "string" + }, + "userIdCount": { + "description": "The total count of user ids sent in the removal request. Includes all user ids in the request, regardless of whether they were successfully removed or not.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "RequestStatusPerDestination": { "description": "A request status per destination.", "id": "RequestStatusPerDestination", @@ -1247,6 +2414,35 @@ }, "type": "object" }, + "RetrieveInsightsRequest": { + "description": "Request message for DM API MarketingDataInsightsService.RetrieveInsights", + "id": "RetrieveInsightsRequest", + "properties": { + "baseline": { + "$ref": "Baseline", + "description": "Required. Baseline for the insights requested." + }, + "userListId": { + "description": "Required. The user list ID for which insights are requested.", + "type": "string" + } + }, + "type": "object" + }, + "RetrieveInsightsResponse": { + "description": "Response message for DM API MarketingDataInsightsService.RetrieveInsights", + "id": "RetrieveInsightsResponse", + "properties": { + "marketingDataInsights": { + "description": "Contains the insights for the marketing data.", + "items": { + "$ref": "MarketingDataInsight" + }, + "type": "array" + } + }, + "type": "object" + }, "RetrieveRequestStatusResponse": { "description": "Response from the RetrieveRequestStatusRequest.", "id": "RetrieveRequestStatusResponse", @@ -1261,6 +2457,43 @@ }, "type": "object" }, + "SearchPartnerLinksResponse": { + "description": "Response from the SearchPartnerLinksRequest.", + "id": "SearchPartnerLinksResponse", + "properties": { + "nextPageToken": { + "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", + "type": "string" + }, + "partnerLinks": { + "description": "The partner links for the given account.", + "items": { + "$ref": "PartnerLink" + }, + "type": "array" + } + }, + "type": "object" + }, + "SizeInfo": { + "description": "Estimated number of members in this user list in different target networks.", + "id": "SizeInfo", + "properties": { + "displayNetworkMembersCount": { + "description": "Output only. Estimated number of members in this user list, on the Google Display Network.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "searchNetworkMembersCount": { + "description": "Output only. Estimated number of members in this user list in the google.com domain. These are the members available for targeting in Search campaigns.", + "format": "int64", + "readOnly": true, + "type": "string" + } + }, + "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", @@ -1288,6 +2521,22 @@ }, "type": "object" }, + "TargetNetworkInfo": { + "description": "Eligibility information for different target networks.", + "id": "TargetNetworkInfo", + "properties": { + "eligibleForDisplay": { + "description": "Output only. Indicates this user list is eligible for Google Display Network.", + "readOnly": true, + "type": "boolean" + }, + "eligibleForSearch": { + "description": "Optional. Indicates if this user list is eligible for Google Search Network.", + "type": "boolean" + } + }, + "type": "object" + }, "TermsOfService": { "description": "The terms of service that the user has accepted/rejected.", "id": "TermsOfService", @@ -1323,6 +2572,42 @@ }, "type": "object" }, + "UserIdData": { + "description": "User id data holding the user id.", + "id": "UserIdData", + "properties": { + "userId": { + "description": "Required. A unique identifier for a user, as defined by the advertiser.", + "type": "string" + } + }, + "type": "object" + }, + "UserIdInfo": { + "description": "Additional information when `USER_ID` is one of the `upload_key_types`.", + "id": "UserIdInfo", + "properties": { + "dataSourceType": { + "description": "Optional. Immutable. Source of the upload data.", + "enum": [ + "DATA_SOURCE_TYPE_UNSPECIFIED", + "DATA_SOURCE_TYPE_FIRST_PARTY", + "DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU", + "DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE", + "DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA" + ], + "enumDescriptions": [ + "Not specified.", + "The uploaded data is first-party data.", + "The uploaded data is from a third-party credit bureau.", + "The uploaded data is from a third-party voter file.", + "The uploaded data is third party partner data." + ], + "type": "string" + } + }, + "type": "object" + }, "UserIdentifier": { "description": "A single identifier for the user.", "id": "UserIdentifier", @@ -1342,6 +2627,483 @@ }, "type": "object" }, + "UserList": { + "description": "A user list resource.", + "id": "UserList", + "properties": { + "accessReason": { + "description": "Output only. The reason this account has been granted access to the list.", + "enum": [ + "ACCESS_REASON_UNSPECIFIED", + "OWNED", + "SHARED", + "LICENSED", + "SUBSCRIBED", + "AFFILIATED" + ], + "enumDescriptions": [ + "Not specified.", + "The resource is owned by the user.", + "The resource is shared to the user.", + "The resource is licensed to the user.", + "The user subscribed to the resource.", + "The resource is accessible to the user." + ], + "readOnly": true, + "type": "string" + }, + "accountAccessStatus": { + "description": "Optional. Indicates if this share is still enabled. When a user list is shared with the account this field is set to `ENABLED`. Later the user list owner can decide to revoke the share and make it `DISABLED`.", + "enum": [ + "ACCESS_STATUS_UNSPECIFIED", + "ENABLED", + "DISABLED" + ], + "enumDescriptions": [ + "Not specified.", + "The access is enabled.", + "The access is disabled." + ], + "type": "string" + }, + "closingReason": { + "description": "Output only. The reason why this user list membership status is closed.", + "enum": [ + "CLOSING_REASON_UNSPECIFIED", + "UNUSED" + ], + "enumDescriptions": [ + "Not specified.", + "The user list was closed because it has not been used in targeting recently. See https://support.google.com/google-ads/answer/2472738 for details." + ], + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. A description of the user list.", + "type": "string" + }, + "displayName": { + "description": "Required. The display name of the user list.", + "type": "string" + }, + "id": { + "description": "Output only. The unique ID of the user list.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "ingestedUserListInfo": { + "$ref": "IngestedUserListInfo", + "description": "Optional. Represents a user list that is populated by user ingested data." + }, + "integrationCode": { + "description": "Optional. An ID from external system. It is used by user list sellers to correlate IDs on their systems.", + "type": "string" + }, + "membershipDuration": { + "description": "Optional. The duration a user remains in the user list. Valid durations are exact multiples of 24 hours (86400 seconds). Providing a value that is not an exact multiple of 24 hours will result in an INVALID_ARGUMENT error.", + "format": "google-duration", + "type": "string" + }, + "membershipStatus": { + "description": "Optional. Membership status of this user list.", + "enum": [ + "MEMBERSHIP_STATUS_UNSPECIFIED", + "OPEN", + "CLOSED" + ], + "enumDescriptions": [ + "Not specified.", + "Open status - User list is accruing members and can be targeted to.", + "Closed status - No new members being added." + ], + "type": "string" + }, + "name": { + "description": "Identifier. The resource name of the user list. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}", + "type": "string" + }, + "readOnly": { + "description": "Output only. An option that indicates if a user may edit a list.", + "readOnly": true, + "type": "boolean" + }, + "sizeInfo": { + "$ref": "SizeInfo", + "description": "Output only. Estimated number of members in this user list in different target networks.", + "readOnly": true + }, + "targetNetworkInfo": { + "$ref": "TargetNetworkInfo", + "description": "Optional. Eligibility information for different target networks." + } + }, + "type": "object" + }, + "UserListDirectLicense": { + "description": "A user list direct license. This feature is only available to data partners.", + "id": "UserListDirectLicense", + "properties": { + "clientAccountDisplayName": { + "description": "Output only. Name of client customer which the user list is being licensed to. This field is read-only.", + "readOnly": true, + "type": "string" + }, + "clientAccountId": { + "description": "Immutable. ID of client customer which the user list is being licensed to.", + "format": "int64", + "type": "string" + }, + "clientAccountType": { + "description": "Immutable. Account type of client customer which the user list is being licensed to.", + "enum": [ + "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN", + "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS", + "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER", + "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER", + "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_AD_MANAGER_AUDIENCE_LINK" + ], + "enumDescriptions": [ + "Unknown.", + "Google Ads customer.", + "Display \u0026 Video 360 partner.", + "Display \u0026 Video 360 advertiser.", + "Google Ad Manager audience link." + ], + "type": "string" + }, + "historicalPricings": { + "description": "Output only. Pricing history of this user list license. This field is read-only.", + "items": { + "$ref": "UserListLicensePricing" + }, + "readOnly": true, + "type": "array" + }, + "metrics": { + "$ref": "UserListLicenseMetrics", + "description": "Output only. Metrics related to this license This field is read-only and only populated if the start and end dates are set in the ListUserListDirectLicenses call", + "readOnly": true + }, + "name": { + "description": "Identifier. The resource name of the user list direct license.", + "type": "string" + }, + "pricing": { + "$ref": "UserListLicensePricing", + "description": "Optional. UserListDirectLicense pricing." + }, + "status": { + "description": "Optional. Status of UserListDirectLicense - ENABLED or DISABLED.", + "enum": [ + "USER_LIST_LICENSE_STATUS_UNSPECIFIED", + "USER_LIST_LICENSE_STATUS_ENABLED", + "USER_LIST_LICENSE_STATUS_DISABLED" + ], + "enumDescriptions": [ + "Unknown.", + "Active status - user list is still being licensed.", + "Inactive status - user list is no longer being licensed." + ], + "type": "string" + }, + "userListDisplayName": { + "description": "Output only. Name of the user list being licensed. This field is read-only.", + "readOnly": true, + "type": "string" + }, + "userListId": { + "description": "Immutable. ID of the user list being licensed.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "UserListGlobalLicense": { + "description": "A user list global license. This feature is only available to data partners.", + "id": "UserListGlobalLicense", + "properties": { + "historicalPricings": { + "description": "Output only. Pricing history of this user list license. This field is read-only.", + "items": { + "$ref": "UserListLicensePricing" + }, + "readOnly": true, + "type": "array" + }, + "licenseType": { + "description": "Immutable. Product type of client customer which the user list is being licensed to.", + "enum": [ + "USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED", + "USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER", + "USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE", + "USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE" + ], + "enumDescriptions": [ + "UNSPECIFIED.", + "Reseller license.", + "DataMart Sell Side license.", + "DataMart Buy Side license." + ], + "type": "string" + }, + "metrics": { + "$ref": "UserListLicenseMetrics", + "description": "Output only. Metrics related to this license This field is read-only and only populated if the start and end dates are set in the ListUserListGlobalLicenses call", + "readOnly": true + }, + "name": { + "description": "Identifier. The resource name of the user list global license.", + "type": "string" + }, + "pricing": { + "$ref": "UserListLicensePricing", + "description": "Optional. UserListGlobalLicense pricing." + }, + "status": { + "description": "Optional. Status of UserListGlobalLicense - ENABLED or DISABLED.", + "enum": [ + "USER_LIST_LICENSE_STATUS_UNSPECIFIED", + "USER_LIST_LICENSE_STATUS_ENABLED", + "USER_LIST_LICENSE_STATUS_DISABLED" + ], + "enumDescriptions": [ + "Unknown.", + "Active status - user list is still being licensed.", + "Inactive status - user list is no longer being licensed." + ], + "type": "string" + }, + "userListDisplayName": { + "description": "Output only. Name of the user list being licensed. This field is read-only.", + "readOnly": true, + "type": "string" + }, + "userListId": { + "description": "Immutable. ID of the user list being licensed.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "UserListGlobalLicenseCustomerInfo": { + "description": "Information about a customer of a user list global license. This will automatically be created by the system when a customer purchases a global license.", + "id": "UserListGlobalLicenseCustomerInfo", + "properties": { + "clientAccountDisplayName": { + "description": "Output only. Name of client customer which the user list is being licensed to.", + "readOnly": true, + "type": "string" + }, + "clientAccountId": { + "description": "Output only. ID of client customer which the user list is being licensed to.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "clientAccountType": { + "description": "Output only. Product type of client customer which the user list is being licensed to.", + "enum": [ + "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN", + "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS", + "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER", + "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER", + "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_AD_MANAGER_AUDIENCE_LINK" + ], + "enumDescriptions": [ + "Unknown.", + "Google Ads customer.", + "Display \u0026 Video 360 partner.", + "Display \u0026 Video 360 advertiser.", + "Google Ad Manager audience link." + ], + "readOnly": true, + "type": "string" + }, + "historicalPricings": { + "description": "Output only. Pricing history of this user list license.", + "items": { + "$ref": "UserListLicensePricing" + }, + "readOnly": true, + "type": "array" + }, + "licenseType": { + "description": "Output only. Product type of client customer which the user list is being licensed to.", + "enum": [ + "USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED", + "USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER", + "USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE", + "USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE" + ], + "enumDescriptions": [ + "UNSPECIFIED.", + "Reseller license.", + "DataMart Sell Side license.", + "DataMart Buy Side license." + ], + "readOnly": true, + "type": "string" + }, + "metrics": { + "$ref": "UserListLicenseMetrics", + "description": "Output only. Metrics related to this license This field is only populated if the start and end dates are set in the ListUserListGlobalLicenseCustomerInfos call.", + "readOnly": true + }, + "name": { + "description": "Identifier. The resource name of the user list global license customer.", + "type": "string" + }, + "pricing": { + "$ref": "UserListLicensePricing", + "description": "Output only. UserListDirectLicense pricing.", + "readOnly": true + }, + "status": { + "description": "Output only. Status of UserListDirectLicense - ENABLED or DISABLED.", + "enum": [ + "USER_LIST_LICENSE_STATUS_UNSPECIFIED", + "USER_LIST_LICENSE_STATUS_ENABLED", + "USER_LIST_LICENSE_STATUS_DISABLED" + ], + "enumDescriptions": [ + "Unknown.", + "Active status - user list is still being licensed.", + "Inactive status - user list is no longer being licensed." + ], + "readOnly": true, + "type": "string" + }, + "userListDisplayName": { + "description": "Output only. Name of the user list being licensed.", + "readOnly": true, + "type": "string" + }, + "userListId": { + "description": "Output only. ID of the user list being licensed.", + "format": "int64", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "UserListLicenseMetrics": { + "description": "Metrics related to a user list license.", + "id": "UserListLicenseMetrics", + "properties": { + "clickCount": { + "description": "Output only. The number of clicks for the user list license.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "endDate": { + "description": "Output only. The end date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `start_date` is used in the filter, `end_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "impressionCount": { + "description": "Output only. The number of impressions for the user list license.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "revenueUsdMicros": { + "description": "Output only. The revenue for the user list license in USD micros.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "startDate": { + "description": "Output only. The start date (inclusive) of the metrics in the format YYYYMMDD. For example, 20260102 represents January 2, 2026. If `end_date` is used in the filter, `start_date` is also required. If neither `start_date` nor `end_date` are included in the filter, the UserListLicenseMetrics fields will not be populated in the response.", + "format": "int64", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "UserListLicensePricing": { + "description": "A user list license pricing.", + "id": "UserListLicensePricing", + "properties": { + "buyerApprovalState": { + "description": "Output only. The buyer approval state of this pricing. This field is read-only.", + "enum": [ + "USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED", + "PENDING", + "APPROVED", + "REJECTED" + ], + "enumDescriptions": [ + "UNSPECIFIED.", + "User list client has not yet accepted the pricing terms set by the user list owner.", + "User list client has accepted the pricing terms set by the user list owner.", + "User list client has rejected the pricing terms set by the user list owner." + ], + "readOnly": true, + "type": "string" + }, + "costMicros": { + "description": "Optional. The cost associated with the model, in micro units (10^-6), in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`.", + "format": "int64", + "type": "string" + }, + "costType": { + "description": "Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license.", + "enum": [ + "USER_LIST_PRICING_COST_TYPE_UNSPECIFIED", + "CPC", + "CPM", + "MEDIA_SHARE" + ], + "enumDescriptions": [ + "Unspecified.", + "Cost per click.", + "Cost per mille (thousand impressions).", + "Media share." + ], + "type": "string" + }, + "currencyCode": { + "description": "Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217.", + "type": "string" + }, + "endTime": { + "description": "Optional. End time of the pricing.", + "format": "google-datetime", + "type": "string" + }, + "maxCostMicros": { + "description": "Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) and in the currency specified by the currency_code field. For example, 2000000 means $2 if `currency_code` is `USD`. This is only relevant when cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap.", + "format": "int64", + "type": "string" + }, + "pricingActive": { + "description": "Output only. Whether this pricing is active.", + "readOnly": true, + "type": "boolean" + }, + "pricingId": { + "description": "Output only. The ID of this pricing.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "startTime": { + "description": "Output only. Start time of the pricing.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "UserProperties": { "description": "Advertiser-assessed information about the user at the time that the event happened. See https://support.google.com/google-ads/answer/14007601 for more details.", "id": "UserProperties", diff --git a/datamanager/v1/datamanager-gen.go b/datamanager/v1/datamanager-gen.go index 79eb415746..a87960ccae 100644 --- a/datamanager/v1/datamanager-gen.go +++ b/datamanager/v1/datamanager-gen.go @@ -120,6 +120,7 @@ func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, err return nil, err } s := &Service{client: client, BasePath: basePath, logger: internaloption.GetLogger(opts)} + s.AccountTypes = NewAccountTypesService(s) s.AudienceMembers = NewAudienceMembersService(s) s.Events = NewEventsService(s) s.RequestStatus = NewRequestStatusService(s) @@ -147,6 +148,8 @@ type Service struct { BasePath string // API endpoint base URL UserAgent string // optional additional User-Agent fragment + AccountTypes *AccountTypesService + AudienceMembers *AudienceMembersService Events *EventsService @@ -161,6 +164,99 @@ func (s *Service) userAgent() string { return googleapi.UserAgent + " " + s.UserAgent } +func NewAccountTypesService(s *Service) *AccountTypesService { + rs := &AccountTypesService{s: s} + rs.Accounts = NewAccountTypesAccountsService(s) + return rs +} + +type AccountTypesService struct { + s *Service + + Accounts *AccountTypesAccountsService +} + +func NewAccountTypesAccountsService(s *Service) *AccountTypesAccountsService { + rs := &AccountTypesAccountsService{s: s} + rs.Insights = NewAccountTypesAccountsInsightsService(s) + rs.PartnerLinks = NewAccountTypesAccountsPartnerLinksService(s) + rs.UserListDirectLicenses = NewAccountTypesAccountsUserListDirectLicensesService(s) + rs.UserListGlobalLicenses = NewAccountTypesAccountsUserListGlobalLicensesService(s) + rs.UserLists = NewAccountTypesAccountsUserListsService(s) + return rs +} + +type AccountTypesAccountsService struct { + s *Service + + Insights *AccountTypesAccountsInsightsService + + PartnerLinks *AccountTypesAccountsPartnerLinksService + + UserListDirectLicenses *AccountTypesAccountsUserListDirectLicensesService + + UserListGlobalLicenses *AccountTypesAccountsUserListGlobalLicensesService + + UserLists *AccountTypesAccountsUserListsService +} + +func NewAccountTypesAccountsInsightsService(s *Service) *AccountTypesAccountsInsightsService { + rs := &AccountTypesAccountsInsightsService{s: s} + return rs +} + +type AccountTypesAccountsInsightsService struct { + s *Service +} + +func NewAccountTypesAccountsPartnerLinksService(s *Service) *AccountTypesAccountsPartnerLinksService { + rs := &AccountTypesAccountsPartnerLinksService{s: s} + return rs +} + +type AccountTypesAccountsPartnerLinksService struct { + s *Service +} + +func NewAccountTypesAccountsUserListDirectLicensesService(s *Service) *AccountTypesAccountsUserListDirectLicensesService { + rs := &AccountTypesAccountsUserListDirectLicensesService{s: s} + return rs +} + +type AccountTypesAccountsUserListDirectLicensesService struct { + s *Service +} + +func NewAccountTypesAccountsUserListGlobalLicensesService(s *Service) *AccountTypesAccountsUserListGlobalLicensesService { + rs := &AccountTypesAccountsUserListGlobalLicensesService{s: s} + rs.UserListGlobalLicenseCustomerInfos = NewAccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosService(s) + return rs +} + +type AccountTypesAccountsUserListGlobalLicensesService struct { + s *Service + + UserListGlobalLicenseCustomerInfos *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosService +} + +func NewAccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosService(s *Service) *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosService { + rs := &AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosService{s: s} + return rs +} + +type AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosService struct { + s *Service +} + +func NewAccountTypesAccountsUserListsService(s *Service) *AccountTypesAccountsUserListsService { + rs := &AccountTypesAccountsUserListsService{s: s} + return rs +} + +type AccountTypesAccountsUserListsService struct { + s *Service +} + func NewAudienceMembersService(s *Service) *AudienceMembersService { rs := &AudienceMembersService{s: s} return rs @@ -265,10 +361,17 @@ type AudienceMember struct { // MobileData: Data identifying the user's mobile devices. MobileData *MobileData `json:"mobileData,omitempty"` // PairData: Publisher Advertiser Identity Reconciliation (PAIR) IDs - // (//support.google.com/admanager/answer/15067908). + // (//support.google.com/admanager/answer/15067908). This feature is only + // available to data partners. PairData *PairData `json:"pairData,omitempty"` + // PpidData: Data related to publisher provided identifiers. This feature is + // only available to data partners. + PpidData *PpidData `json:"ppidData,omitempty"` // UserData: User-provided data that identifies the user. UserData *UserData `json:"userData,omitempty"` + // UserIdData: Data related to unique identifiers for a user, as defined by the + // advertiser. + UserIdData *UserIdData `json:"userIdData,omitempty"` // ForceSendFields is a list of field names (e.g. "Consent") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -323,6 +426,32 @@ func (s AwsWrappedKeyInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Baseline: Baseline criteria against which insights are compared. +type Baseline struct { + // BaselineLocation: The baseline location of the request. Baseline location is + // an OR-list of the requested regions. + BaselineLocation *Location `json:"baselineLocation,omitempty"` + // LocationAutoDetectionEnabled: If set to true, the service will try to + // automatically detect the baseline location for insights. + LocationAutoDetectionEnabled bool `json:"locationAutoDetectionEnabled,omitempty"` + // ForceSendFields is a list of field names (e.g. "BaselineLocation") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BaselineLocation") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s Baseline) MarshalJSON() ([]byte, error) { + type NoMethod Baseline + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // CartData: The cart data associated with the event. type CartData struct { // Items: Optional. The list of items associated with the event. @@ -407,6 +536,41 @@ func (s Consent) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ContactIdInfo: Additional information when `CONTACT_ID` is one of the +// `upload_key_types`. +type ContactIdInfo struct { + // DataSourceType: Optional. Immutable. Source of the upload data + // + // Possible values: + // "DATA_SOURCE_TYPE_UNSPECIFIED" - Not specified. + // "DATA_SOURCE_TYPE_FIRST_PARTY" - The uploaded data is first-party data. + // "DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU" - The uploaded data is from a + // third-party credit bureau. + // "DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE" - The uploaded data is from a + // third-party voter file. + // "DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA" - The uploaded data is third + // party partner data. + DataSourceType string `json:"dataSourceType,omitempty"` + // MatchRatePercentage: Output only. Match rate for customer match user lists. + MatchRatePercentage int64 `json:"matchRatePercentage,omitempty"` + // ForceSendFields is a list of field names (e.g. "DataSourceType") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DataSourceType") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ContactIdInfo) MarshalJSON() ([]byte, error) { + type NoMethod ContactIdInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // CustomVariable: Custom variable for ads conversions. type CustomVariable struct { // DestinationReferences: Optional. Reference string used to determine which of @@ -515,6 +679,15 @@ func (s DeviceInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Empty: 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); } +type Empty struct { + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` +} + // EncryptionInfo: Encryption information for the data being ingested. type EncryptionInfo struct { // AwsWrappedKeyInfo: Amazon Web Services wrapped key information. @@ -925,9 +1098,15 @@ type IngestAudienceMembersStatus struct { // PairDataIngestionStatus: The status of the pair data ingestion to the // destination. PairDataIngestionStatus *IngestPairDataStatus `json:"pairDataIngestionStatus,omitempty"` + // PpidDataIngestionStatus: The status of the ppid data ingestion to the + // destination. + PpidDataIngestionStatus *IngestPpidDataStatus `json:"ppidDataIngestionStatus,omitempty"` // UserDataIngestionStatus: The status of the user data ingestion to the // destination. UserDataIngestionStatus *IngestUserDataStatus `json:"userDataIngestionStatus,omitempty"` + // UserIdDataIngestionStatus: The status of the user id data ingestion to the + // destination. + UserIdDataIngestionStatus *IngestUserIdDataStatus `json:"userIdDataIngestionStatus,omitempty"` // ForceSendFields is a list of field names (e.g. "MobileDataIngestionStatus") // to unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1103,6 +1282,35 @@ func (s IngestPairDataStatus) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// IngestPpidDataStatus: The status of the ppid data ingestion to the +// destination containing stats related to the ingestion. +type IngestPpidDataStatus struct { + // PpidCount: The total count of ppids sent in the upload request for the + // destination. Includes all ppids in the request, regardless of whether they + // were successfully ingested or not. + PpidCount int64 `json:"ppidCount,omitempty,string"` + // RecordCount: The total count of audience members sent in the upload request + // for the destination. Includes all audience members in the request, + // regardless of whether they were successfully ingested or not. + RecordCount int64 `json:"recordCount,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "PpidCount") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PpidCount") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s IngestPpidDataStatus) MarshalJSON() ([]byte, error) { + type NoMethod IngestPpidDataStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // IngestUserDataStatus: The status of the user data ingestion to the // destination containing stats related to the ingestion. type IngestUserDataStatus struct { @@ -1156,6 +1364,87 @@ func (s IngestUserDataStatus) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// IngestUserIdDataStatus: The status of the user id data ingestion to the +// destination containing stats related to the ingestion. +type IngestUserIdDataStatus struct { + // RecordCount: The total count of audience members sent in the upload request + // for the destination. Includes all audience members in the request, + // regardless of whether they were successfully ingested or not. + RecordCount int64 `json:"recordCount,omitempty,string"` + // UserIdCount: The total count of user ids sent in the upload request for the + // destination. Includes all user ids in the request, regardless of whether + // they were successfully ingested or not. + UserIdCount int64 `json:"userIdCount,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "RecordCount") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "RecordCount") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s IngestUserIdDataStatus) MarshalJSON() ([]byte, error) { + type NoMethod IngestUserIdDataStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// IngestedUserListInfo: Represents a user list that is populated by user +// provided data. +type IngestedUserListInfo struct { + // ContactIdInfo: Optional. Additional information when `CONTACT_ID` is one of + // the `upload_key_types`. + ContactIdInfo *ContactIdInfo `json:"contactIdInfo,omitempty"` + // MobileIdInfo: Optional. Additional information when `MOBILE_ID` is one of + // the `upload_key_types`. + MobileIdInfo *MobileIdInfo `json:"mobileIdInfo,omitempty"` + // PairIdInfo: Optional. Additional information when `PAIR_ID` is one of the + // `upload_key_types`. This feature is only available to data partners. + PairIdInfo *PairIdInfo `json:"pairIdInfo,omitempty"` + // PartnerAudienceInfo: Optional. Additional information for partner audiences. + // This feature is only available to data partners. + PartnerAudienceInfo *PartnerAudienceInfo `json:"partnerAudienceInfo,omitempty"` + // PseudonymousIdInfo: Optional. Additional information for `PSEUDONYMOUS_ID` + // is one of the `upload_key_types`. + PseudonymousIdInfo *PseudonymousIdInfo `json:"pseudonymousIdInfo,omitempty"` + // UploadKeyTypes: Required. Immutable. Upload key types of this user list. + // + // Possible values: + // "UPLOAD_KEY_TYPE_UNSPECIFIED" - Not specified. + // "CONTACT_ID" - Customer info such as email address, phone number or + // physical address. + // "MOBILE_ID" - Mobile advertising ids. + // "USER_ID" - Third party provided user ids. + // "PAIR_ID" - Publisher advertiser identity reconciliation ids. + // "PSEUDONYMOUS_ID" - Data Management Platform IDs: - Google User ID - + // Partner Provided ID - Publisher Provided ID - iOS IDFA - Android advertising + // ID - Roku ID - Amazon Fire TV ID - Xbox or Microsoft ID + UploadKeyTypes []string `json:"uploadKeyTypes,omitempty"` + // UserIdInfo: Optional. Additional information when `USER_ID` is one of the + // `upload_key_types`. + UserIdInfo *UserIdInfo `json:"userIdInfo,omitempty"` + // ForceSendFields is a list of field names (e.g. "ContactIdInfo") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ContactIdInfo") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s IngestedUserListInfo) MarshalJSON() ([]byte, error) { + type NoMethod IngestedUserListInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Item: Represents an item in the cart associated with the event. type Item struct { // AdditionalItemParameters: Optional. A bucket of any event parameters related @@ -1234,621 +1523,4022 @@ func (s ItemParameter) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// MobileData: Mobile IDs for the audience. At least one mobile ID is required. -type MobileData struct { - // MobileIds: Required. The list of mobile device IDs (advertising ID/IDFA). At - // most 10 `mobileIds` can be provided in a single AudienceMember. - MobileIds []string `json:"mobileIds,omitempty"` - // ForceSendFields is a list of field names (e.g. "MobileIds") to +// ListUserListDirectLicensesResponse: Response from the +// ListUserListDirectLicensesRequest. +type ListUserListDirectLicensesResponse struct { + // NextPageToken: A token, which can be sent as `page_token` to retrieve the + // next page. If this field is omitted, there are no subsequent pages. + NextPageToken string `json:"nextPageToken,omitempty"` + // UserListDirectLicenses: The licenses for the given user list in the request. + UserListDirectLicenses []*UserListDirectLicense `json:"userListDirectLicenses,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "MobileIds") to include in API + // NullFields is a list of field names (e.g. "NextPageToken") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s MobileData) MarshalJSON() ([]byte, error) { - type NoMethod MobileData +func (s ListUserListDirectLicensesResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListUserListDirectLicensesResponse return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// PairData: PAIR (//support.google.com/admanager/answer/15067908) IDs for the -// audience. At least one PAIR ID is required. -type PairData struct { - // PairIds: Required. Cleanroom-provided PII data, hashed with SHA256, and - // encrypted with an EC commutative cipher using publisher key for the PAIR - // ((//support.google.com/admanager/answer/15067908)) user list. At most 10 - // `pairIds` can be provided in a single AudienceMember. - PairIds []string `json:"pairIds,omitempty"` - // ForceSendFields is a list of field names (e.g. "PairIds") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See +// ListUserListGlobalLicenseCustomerInfosResponse: Response from the +// ListUserListGlobalLicensesCustomerInfoRequest. +type ListUserListGlobalLicenseCustomerInfosResponse struct { + // NextPageToken: A token, which can be sent as `page_token` to retrieve the + // next page. If this field is omitted, there are no subsequent pages. + NextPageToken string `json:"nextPageToken,omitempty"` + // UserListGlobalLicenseCustomerInfos: The customer information for the given + // license in the request. + UserListGlobalLicenseCustomerInfos []*UserListGlobalLicenseCustomerInfo `json:"userListGlobalLicenseCustomerInfos,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PairIds") to include in API + // NullFields is a list of field names (e.g. "NextPageToken") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s PairData) MarshalJSON() ([]byte, error) { - type NoMethod PairData +func (s ListUserListGlobalLicenseCustomerInfosResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListUserListGlobalLicenseCustomerInfosResponse return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ProductAccount: Represents a specific account. -type ProductAccount struct { - // AccountId: Required. The ID of the account. For example, your Google Ads - // account ID. - AccountId string `json:"accountId,omitempty"` - // AccountType: Optional. The type of the account. For example, `GOOGLE_ADS`. - // Either `account_type` or the deprecated `product` is required. If both are - // set, the values must match. - // - // Possible values: - // "ACCOUNT_TYPE_UNSPECIFIED" - Unspecified product. Should never be used. - // "GOOGLE_ADS" - Google Ads. - // "DISPLAY_VIDEO_PARTNER" - Display & Video 360 partner. - // "DISPLAY_VIDEO_ADVERTISER" - Display & Video 360 advertiser. - // "DATA_PARTNER" - Data Partner. - // "GOOGLE_ANALYTICS_PROPERTY" - Google Analytics. - AccountType string `json:"accountType,omitempty"` - // Product: Deprecated. Use `account_type` instead. - // - // Possible values: - // "PRODUCT_UNSPECIFIED" - Unspecified product. Should never be used. - // "GOOGLE_ADS" - Google Ads. - // "DISPLAY_VIDEO_PARTNER" - Display & Video 360 partner. - // "DISPLAY_VIDEO_ADVERTISER" - Display & Video 360 advertiser. - // "DATA_PARTNER" - Data Partner. - Product string `json:"product,omitempty"` - // ForceSendFields is a list of field names (e.g. "AccountId") to +// ListUserListGlobalLicensesResponse: Response from the +// ListUserListGlobalLicensesRequest. +type ListUserListGlobalLicensesResponse struct { + // NextPageToken: A token, which can be sent as `page_token` to retrieve the + // next page. If this field is omitted, there are no subsequent pages. + NextPageToken string `json:"nextPageToken,omitempty"` + // UserListGlobalLicenses: The licenses for the given user list in the request. + UserListGlobalLicenses []*UserListGlobalLicense `json:"userListGlobalLicenses,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AccountId") to include in API + // NullFields is a list of field names (e.g. "NextPageToken") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s ProductAccount) MarshalJSON() ([]byte, error) { - type NoMethod ProductAccount +func (s ListUserListGlobalLicensesResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListUserListGlobalLicensesResponse return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// RemoveAudienceMembersRequest: Request to remove users from an audience in -// the provided destinations. Returns a RemoveAudienceMembersResponse. -type RemoveAudienceMembersRequest struct { - // AudienceMembers: Required. The list of users to remove. - AudienceMembers []*AudienceMember `json:"audienceMembers,omitempty"` - // Destinations: Required. The list of destinations to remove the users from. - Destinations []*Destination `json:"destinations,omitempty"` - // Encoding: Optional. Required for UserData uploads. The encoding type of the - // user identifiers. Applies to only the outer encoding for encrypted user - // identifiers. For non `UserData` uploads, this field is ignored. - // - // Possible values: - // "ENCODING_UNSPECIFIED" - Unspecified Encoding type. Should never be used. - // "HEX" - Hex encoding. - // "BASE64" - Base 64 encoding. - Encoding string `json:"encoding,omitempty"` - // EncryptionInfo: Optional. Encryption information for UserData uploads. If - // not set, it's assumed that uploaded identifying information is hashed but - // not encrypted. For non `UserData` uploads, this field is ignored. - EncryptionInfo *EncryptionInfo `json:"encryptionInfo,omitempty"` - // ValidateOnly: Optional. For testing purposes. If `true`, the request is - // validated but not executed. Only errors are returned, not results. - ValidateOnly bool `json:"validateOnly,omitempty"` - // ForceSendFields is a list of field names (e.g. "AudienceMembers") to +// ListUserListsResponse: Response message for ListUserLists. +type ListUserListsResponse struct { + // NextPageToken: A token, which can be sent as `page_token` to retrieve the + // next page. If this field is omitted, there are no subsequent pages. + NextPageToken string `json:"nextPageToken,omitempty"` + // UserLists: The user lists from the specified account. + UserLists []*UserList `json:"userLists,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AudienceMembers") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See + // NullFields is a list of field names (e.g. "NextPageToken") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s RemoveAudienceMembersRequest) MarshalJSON() ([]byte, error) { - type NoMethod RemoveAudienceMembersRequest +func (s ListUserListsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListUserListsResponse return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// RemoveAudienceMembersResponse: Response from the -// RemoveAudienceMembersRequest. -type RemoveAudienceMembersResponse struct { - // RequestId: The auto-generated ID of the request. - RequestId string `json:"requestId,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "RequestId") to +// Location: The baseline location of the request. Baseline location is on +// OR-list of ISO 3166-1 alpha-2 region codes of the requested regions. +type Location struct { + // RegionCodes: List of ISO 3166-1 alpha-2 region codes. + RegionCodes []string `json:"regionCodes,omitempty"` + // ForceSendFields is a list of field names (e.g. "RegionCodes") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RequestId") to include in API + // NullFields is a list of field names (e.g. "RegionCodes") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s RemoveAudienceMembersResponse) MarshalJSON() ([]byte, error) { - type NoMethod RemoveAudienceMembersResponse +func (s Location) MarshalJSON() ([]byte, error) { + type NoMethod Location return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// RemoveAudienceMembersStatus: The status of the remove audience members -// request. -type RemoveAudienceMembersStatus struct { - // MobileDataRemovalStatus: The status of the mobile data removal from the - // destination. - MobileDataRemovalStatus *RemoveMobileDataStatus `json:"mobileDataRemovalStatus,omitempty"` - // PairDataRemovalStatus: The status of the pair data removal from the - // destination. - PairDataRemovalStatus *RemovePairDataStatus `json:"pairDataRemovalStatus,omitempty"` - // UserDataRemovalStatus: The status of the user data removal from the - // destination. - UserDataRemovalStatus *RemoveUserDataStatus `json:"userDataRemovalStatus,omitempty"` - // ForceSendFields is a list of field names (e.g. "MobileDataRemovalStatus") to +// MarketingDataInsight: Insights for marketing data. This feature is only +// available to data partners. +type MarketingDataInsight struct { + // Attributes: Insights for values of a given dimension. + Attributes []*MarketingDataInsightsAttribute `json:"attributes,omitempty"` + // Dimension: The dimension to which the insight belongs. + // + // Possible values: + // "AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED" - Not specified. + // "AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN" - The value is unknown in this + // version. + // "AFFINITY_USER_INTEREST" - An Affinity UserInterest. + // "IN_MARKET_USER_INTEREST" - An In-Market UserInterest. + // "AGE_RANGE" - An age range. + // "GENDER" - A gender. + Dimension string `json:"dimension,omitempty"` + // ForceSendFields is a list of field names (e.g. "Attributes") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "MobileDataRemovalStatus") to - // include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See + // NullFields is a list of field names (e.g. "Attributes") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s RemoveAudienceMembersStatus) MarshalJSON() ([]byte, error) { - type NoMethod RemoveAudienceMembersStatus +func (s MarketingDataInsight) MarshalJSON() ([]byte, error) { + type NoMethod MarketingDataInsight return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// RemoveMobileDataStatus: The status of the mobile data removal from the -// destination. -type RemoveMobileDataStatus struct { - // MobileIdCount: The total count of mobile Ids sent in the removal request. - // Includes all mobile ids in the request, regardless of whether they were - // successfully removed or not. - MobileIdCount int64 `json:"mobileIdCount,omitempty,string"` - // RecordCount: The total count of audience members sent in the removal - // request. Includes all audience members in the request, regardless of whether - // they were successfully removed or not. - RecordCount int64 `json:"recordCount,omitempty,string"` - // ForceSendFields is a list of field names (e.g. "MobileIdCount") to +// MarketingDataInsightsAttribute: Insights for a collection of related +// attributes of the same dimension. +type MarketingDataInsightsAttribute struct { + // AgeRange: Age range of the audience for which the lift is provided. + // + // Possible values: + // "AGE_RANGE_UNSPECIFIED" - Not specified. + // "AGE_RANGE_UNKNOWN" - Unknown. + // "AGE_RANGE_18_24" - Between 18 and 24 years old. + // "AGE_RANGE_25_34" - Between 25 and 34 years old. + // "AGE_RANGE_35_44" - Between 35 and 44 years old. + // "AGE_RANGE_45_54" - Between 45 and 54 years old. + // "AGE_RANGE_55_64" - Between 55 and 64 years old. + // "AGE_RANGE_65_UP" - 65 years old and beyond. + AgeRange string `json:"ageRange,omitempty"` + // Gender: Gender of the audience for which the lift is provided. + // + // Possible values: + // "GENDER_UNSPECIFIED" - Not specified. + // "GENDER_UNKNOWN" - Unknown. + // "GENDER_MALE" - Male. + // "GENDER_FEMALE" - Female. + Gender string `json:"gender,omitempty"` + // Lift: Measure of lift that the audience has for the attribute value as + // compared to the baseline. Range [0-1]. + Lift float64 `json:"lift,omitempty"` + // UserInterestId: The user interest ID. + UserInterestId int64 `json:"userInterestId,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "AgeRange") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "MobileIdCount") to include in API + // NullFields is a list of field names (e.g. "AgeRange") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s RemoveMobileDataStatus) MarshalJSON() ([]byte, error) { - type NoMethod RemoveMobileDataStatus +func (s MarketingDataInsightsAttribute) MarshalJSON() ([]byte, error) { + type NoMethod MarketingDataInsightsAttribute return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// RemovePairDataStatus: The status of the pair data removal from the -// destination. -type RemovePairDataStatus struct { - // PairIdCount: The total count of pair ids sent in the removal request. - // Includes all pair ids in the request, regardless of whether they were - // successfully removed or not. - PairIdCount int64 `json:"pairIdCount,omitempty,string"` - // RecordCount: The total count of audience members sent in the removal - // request. Includes all audience members in the request, regardless of whether - // they were successfully removed or not. - RecordCount int64 `json:"recordCount,omitempty,string"` - // ForceSendFields is a list of field names (e.g. "PairIdCount") to +func (s *MarketingDataInsightsAttribute) UnmarshalJSON(data []byte) error { + type NoMethod MarketingDataInsightsAttribute + var s1 struct { + Lift gensupport.JSONFloat64 `json:"lift"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Lift = float64(s1.Lift) + return nil +} + +// MobileData: Mobile IDs for the audience. At least one mobile ID is required. +type MobileData struct { + // MobileIds: Required. The list of mobile device IDs (advertising ID/IDFA). At + // most 10 `mobileIds` can be provided in a single AudienceMember. + MobileIds []string `json:"mobileIds,omitempty"` + // ForceSendFields is a list of field names (e.g. "MobileIds") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PairIdCount") to include in API + // NullFields is a list of field names (e.g. "MobileIds") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s RemovePairDataStatus) MarshalJSON() ([]byte, error) { - type NoMethod RemovePairDataStatus +func (s MobileData) MarshalJSON() ([]byte, error) { + type NoMethod MobileData return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// RemoveUserDataStatus: The status of the user data removal from the -// destination. -type RemoveUserDataStatus struct { - // RecordCount: The total count of audience members sent in the removal - // request. Includes all audience members in the request, regardless of whether - // they were successfully removed or not. - RecordCount int64 `json:"recordCount,omitempty,string"` - // UserIdentifierCount: The total count of user identifiers sent in the removal - // request. Includes all user identifiers in the request, regardless of whether - // they were successfully removed or not. - UserIdentifierCount int64 `json:"userIdentifierCount,omitempty,string"` - // ForceSendFields is a list of field names (e.g. "RecordCount") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See +// MobileIdInfo: Additional information when `MOBILE_ID` is one of the +// `upload_key_types`. +type MobileIdInfo struct { + // AppId: Required. Immutable. A string that uniquely identifies a mobile + // application from which the data was collected. + AppId string `json:"appId,omitempty"` + // DataSourceType: Optional. Immutable. Source of the upload data. + // + // Possible values: + // "DATA_SOURCE_TYPE_UNSPECIFIED" - Not specified. + // "DATA_SOURCE_TYPE_FIRST_PARTY" - The uploaded data is first-party data. + // "DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU" - The uploaded data is from a + // third-party credit bureau. + // "DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE" - The uploaded data is from a + // third-party voter file. + // "DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA" - The uploaded data is third + // party partner data. + DataSourceType string `json:"dataSourceType,omitempty"` + // KeySpace: Required. Immutable. The key space of mobile IDs. + // + // Possible values: + // "KEY_SPACE_UNSPECIFIED" - Not specified. + // "IOS" - The iOS keyspace. + // "ANDROID" - The Android keyspace. + KeySpace string `json:"keySpace,omitempty"` + // ForceSendFields is a list of field names (e.g. "AppId") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RecordCount") to include in API + // NullFields is a list of field names (e.g. "AppId") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s RemoveUserDataStatus) MarshalJSON() ([]byte, error) { - type NoMethod RemoveUserDataStatus +func (s MobileIdInfo) MarshalJSON() ([]byte, error) { + type NoMethod MobileIdInfo return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// RequestStatusPerDestination: A request status per destination. -type RequestStatusPerDestination struct { - // AudienceMembersIngestionStatus: The status of the ingest audience members - // request. - AudienceMembersIngestionStatus *IngestAudienceMembersStatus `json:"audienceMembersIngestionStatus,omitempty"` - // AudienceMembersRemovalStatus: The status of the remove audience members - // request. - AudienceMembersRemovalStatus *RemoveAudienceMembersStatus `json:"audienceMembersRemovalStatus,omitempty"` - // Destination: A destination within a DM API request. - Destination *Destination `json:"destination,omitempty"` - // ErrorInfo: An error info error containing the error reason and error counts - // related to the upload. - ErrorInfo *ErrorInfo `json:"errorInfo,omitempty"` - // EventsIngestionStatus: The status of the ingest events request. - EventsIngestionStatus *IngestEventsStatus `json:"eventsIngestionStatus,omitempty"` - // RequestStatus: The request status of the destination. - // - // Possible values: - // "REQUEST_STATUS_UNKNOWN" - The request status is unknown. - // "SUCCESS" - The request succeeded. - // "PROCESSING" - The request is processing. - // "FAILED" - The request failed. - // "PARTIAL_SUCCESS" - The request partially succeeded. - RequestStatus string `json:"requestStatus,omitempty"` - // WarningInfo: A warning info containing the warning reason and warning counts - // related to the upload. - WarningInfo *WarningInfo `json:"warningInfo,omitempty"` - // ForceSendFields is a list of field names (e.g. - // "AudienceMembersIngestionStatus") to unconditionally include in API - // requests. By default, fields with empty or default values are omitted from - // API requests. See +// PairData: PAIR (//support.google.com/admanager/answer/15067908) IDs for the +// audience. At least one PAIR ID is required. This feature is only available +// to data partners. +type PairData struct { + // PairIds: Required. Cleanroom-provided PII data, hashed with SHA256, and + // encrypted with an EC commutative cipher using publisher key for the PAIR + // ((//support.google.com/admanager/answer/15067908)) user list. At most 10 + // `pairIds` can be provided in a single AudienceMember. + PairIds []string `json:"pairIds,omitempty"` + // ForceSendFields is a list of field names (e.g. "PairIds") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AudienceMembersIngestionStatus") - // to include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See + // NullFields is a list of field names (e.g. "PairIds") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s RequestStatusPerDestination) MarshalJSON() ([]byte, error) { - type NoMethod RequestStatusPerDestination +func (s PairData) MarshalJSON() ([]byte, error) { + type NoMethod PairData return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// RetrieveRequestStatusResponse: Response from the -// RetrieveRequestStatusRequest. -type RetrieveRequestStatusResponse struct { - // RequestStatusPerDestination: A list of request statuses per destination. The - // order of the statuses matches the order of the destinations in the original - // request. - RequestStatusPerDestination []*RequestStatusPerDestination `json:"requestStatusPerDestination,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. - // "RequestStatusPerDestination") to unconditionally include in API requests. - // By default, fields with empty or default values are omitted from API - // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields - // for more details. +// PairIdInfo: Additional information when `PAIR_ID` is one of the +// `upload_key_types`. This feature is only available to data partners. +type PairIdInfo struct { + // AdvertiserIdentifierCount: Output only. The count of the advertiser's first + // party data records that have been uploaded to a clean room provider. This + // does not signify the size of a PAIR user list. + AdvertiserIdentifierCount int64 `json:"advertiserIdentifierCount,omitempty,string"` + // CleanRoomIdentifier: Required. Immutable. Identifies a unique advertiser to + // publisher relationship with one clean room provider or across multiple clean + // room providers. + CleanRoomIdentifier string `json:"cleanRoomIdentifier,omitempty"` + // MatchRatePercentage: Output only. This field denotes the percentage of + // membership match of this user list with the corresponding publisher's first + // party data. Must be between 0 and 100 inclusive. + MatchRatePercentage int64 `json:"matchRatePercentage,omitempty"` + // PublisherId: Required. Immutable. Identifies the publisher that the + // Publisher Advertiser Identity Reconciliation user list is reconciled with. + // This field is provided by the cleanroom provider and is only unique in the + // scope of that cleanroom. This cannot be used as a global identifier across + // multiple cleanrooms. + PublisherId int64 `json:"publisherId,omitempty,string"` + // PublisherName: Optional. Descriptive name of the publisher to be displayed + // in the UI for a better targeting experience. + PublisherName string `json:"publisherName,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdvertiserIdentifierCount") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RequestStatusPerDestination") to + // NullFields is a list of field names (e.g. "AdvertiserIdentifierCount") to // include in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s RetrieveRequestStatusResponse) MarshalJSON() ([]byte, error) { - type NoMethod RetrieveRequestStatusResponse +func (s PairIdInfo) MarshalJSON() ([]byte, error) { + type NoMethod PairIdInfo return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Status: 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). -type Status struct { - // Code: The status code, which should be an enum value of google.rpc.Code. - Code int64 `json:"code,omitempty"` - // Details: A list of messages that carry the error details. There is a common - // set of message types for APIs to use. - Details []googleapi.RawMessage `json:"details,omitempty"` - // Message: 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. - Message string `json:"message,omitempty"` - // ForceSendFields is a list of field names (e.g. "Code") to unconditionally +// PartnerAudienceInfo: Additional information for partner audiences. This +// feature is only available to data partners. +type PartnerAudienceInfo struct { + // CommercePartner: Optional. The commerce partner name. Only allowed if + // `partner_audience_source` is `COMMERCE_AUDIENCE`. + CommercePartner string `json:"commercePartner,omitempty"` + // PartnerAudienceSource: Required. Immutable. The source of the partner + // audience. + // + // Possible values: + // "PARTNER_AUDIENCE_SOURCE_UNSPECIFIED" - Not specified. + // "COMMERCE_AUDIENCE" - Partner Audience source is commerce audience. + // "LINEAR_TV_AUDIENCE" - Partner Audience source is linear TV audience. + // "AGENCY_PROVIDER_AUDIENCE" - Partner Audience source is agency/provider + // audience. + PartnerAudienceSource string `json:"partnerAudienceSource,omitempty"` + // ForceSendFields is a list of field names (e.g. "CommercePartner") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CommercePartner") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s PartnerAudienceInfo) MarshalJSON() ([]byte, error) { + type NoMethod PartnerAudienceInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// PartnerLink: A partner link between an owning account and a partner account. +type PartnerLink struct { + // Name: Identifier. The name of the partner link. Format: + // accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link} + Name string `json:"name,omitempty"` + // OwningAccount: Required. The owning account granting access to the partner + // account. + OwningAccount *ProductAccount `json:"owningAccount,omitempty"` + // PartnerAccount: Required. The partner account granted access by the owning + // account. + PartnerAccount *ProductAccount `json:"partnerAccount,omitempty"` + // PartnerLinkId: Output only. The partner link ID. + PartnerLinkId string `json:"partnerLinkId,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Name") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Code") to include in API requests + // NullFields is a list of field names (e.g. "Name") to include in API requests // with the JSON null value. By default, fields with empty values are omitted // from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s Status) MarshalJSON() ([]byte, error) { - type NoMethod Status +func (s PartnerLink) MarshalJSON() ([]byte, error) { + type NoMethod PartnerLink return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// TermsOfService: The terms of service that the user has accepted/rejected. -type TermsOfService struct { - // CustomerMatchTermsOfServiceStatus: Optional. The Customer Match terms of - // service: https://support.google.com/adspolicy/answer/6299717. This must be - // accepted when ingesting UserData or MobileData. This field is not required - // for Partner Match User list. - // - // Possible values: - // "TERMS_OF_SERVICE_STATUS_UNSPECIFIED" - Not specified. - // "ACCEPTED" - Status indicating the caller has chosen to accept the terms - // of service. - // "REJECTED" - Status indicating the caller has chosen to reject the terms - // of service. - CustomerMatchTermsOfServiceStatus string `json:"customerMatchTermsOfServiceStatus,omitempty"` - // ForceSendFields is a list of field names (e.g. - // "CustomerMatchTermsOfServiceStatus") to unconditionally include in API - // requests. By default, fields with empty or default values are omitted from - // API requests. See +// PpidData: Publisher provided identifiers data holding the ppids. At least +// one ppid is required. This feature is only available to data partners. +type PpidData struct { + // Ppids: Required. The list of publisher provided identifiers for a user. + Ppids []string `json:"ppids,omitempty"` + // ForceSendFields is a list of field names (e.g. "Ppids") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. - // "CustomerMatchTermsOfServiceStatus") to include in API requests with the - // JSON null value. By default, fields with empty values are omitted from API - // requests. See https://pkg.go.dev/google.golang.org/api#hdr-NullFields for - // more details. + // NullFields is a list of field names (e.g. "Ppids") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s TermsOfService) MarshalJSON() ([]byte, error) { - type NoMethod TermsOfService +func (s PpidData) MarshalJSON() ([]byte, error) { + type NoMethod PpidData return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// UserData: Data that identifies the user. At least one identifier is -// required. -type UserData struct { - // UserIdentifiers: Required. The identifiers for the user. It's possible to - // provide multiple instances of the same type of data (for example, multiple - // email addresses). To increase the likelihood of a match, provide as many - // identifiers as possible. At most 10 `userIdentifiers` can be provided in a - // single AudienceMember or Event. - UserIdentifiers []*UserIdentifier `json:"userIdentifiers,omitempty"` - // ForceSendFields is a list of field names (e.g. "UserIdentifiers") to - // unconditionally include in API requests. By default, fields with empty or +// ProductAccount: Represents a specific account. +type ProductAccount struct { + // AccountId: Required. The ID of the account. For example, your Google Ads + // account ID. + AccountId string `json:"accountId,omitempty"` + // AccountType: Optional. The type of the account. For example, `GOOGLE_ADS`. + // Either `account_type` or the deprecated `product` is required. If both are + // set, the values must match. + // + // Possible values: + // "ACCOUNT_TYPE_UNSPECIFIED" - Unspecified product. Should never be used. + // "GOOGLE_ADS" - Google Ads. + // "DISPLAY_VIDEO_PARTNER" - Display & Video 360 partner. + // "DISPLAY_VIDEO_ADVERTISER" - Display & Video 360 advertiser. + // "DATA_PARTNER" - Data Partner. + // "GOOGLE_ANALYTICS_PROPERTY" - Google Analytics. + // "GOOGLE_AD_MANAGER_AUDIENCE_LINK" - Google Ad Manager audience link. + AccountType string `json:"accountType,omitempty"` + // Product: Deprecated. Use `account_type` instead. + // + // Possible values: + // "PRODUCT_UNSPECIFIED" - Unspecified product. Should never be used. + // "GOOGLE_ADS" - Google Ads. + // "DISPLAY_VIDEO_PARTNER" - Display & Video 360 partner. + // "DISPLAY_VIDEO_ADVERTISER" - Display & Video 360 advertiser. + // "DATA_PARTNER" - Data Partner. + Product string `json:"product,omitempty"` + // ForceSendFields is a list of field names (e.g. "AccountId") to + // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "UserIdentifiers") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See + // NullFields is a list of field names (e.g. "AccountId") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s UserData) MarshalJSON() ([]byte, error) { - type NoMethod UserData +func (s ProductAccount) MarshalJSON() ([]byte, error) { + type NoMethod ProductAccount return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// UserIdentifier: A single identifier for the user. -type UserIdentifier struct { - // Address: The known components of a user's address. Holds a grouping of - // identifiers that are matched all at once. - Address *AddressInfo `json:"address,omitempty"` - // EmailAddress: Hashed email address using SHA-256 hash function after - // normalization. - EmailAddress string `json:"emailAddress,omitempty"` - // PhoneNumber: Hashed phone number using SHA-256 hash function after - // normalization (E164 standard). - PhoneNumber string `json:"phoneNumber,omitempty"` - // ForceSendFields is a list of field names (e.g. "Address") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See +// PseudonymousIdInfo: Additional information when `PSEUDONYMOUS_ID` is one of +// the `upload_key_types`. +type PseudonymousIdInfo struct { + // BillableRecordCount: Optional. Immutable. The number of billable records + // (e.g. uploaded or matched). + BillableRecordCount int64 `json:"billableRecordCount,omitempty,string"` + // SyncStatus: Output only. Sync status of the user list. + // + // Possible values: + // "SYNC_STATUS_UNSPECIFIED" - Not specified. + // "CREATED" - The user list has been created as a placeholder. List contents + // and/or metadata are still being synced. The user list is not ready for use. + // "READY_FOR_USE" - The user list is ready for use. Contents and cookies + // have been synced correctly. + // "FAILED" - An error has occurred syncing user list contents and/or + // metadata. The user list cannot be used. + SyncStatus string `json:"syncStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. "BillableRecordCount") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Address") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See + // NullFields is a list of field names (e.g. "BillableRecordCount") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s UserIdentifier) MarshalJSON() ([]byte, error) { - type NoMethod UserIdentifier +func (s PseudonymousIdInfo) MarshalJSON() ([]byte, error) { + type NoMethod PseudonymousIdInfo return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// UserProperties: Advertiser-assessed information about the user at the time -// that the event happened. See -// https://support.google.com/google-ads/answer/14007601 for more details. -type UserProperties struct { - // AdditionalUserProperties: Optional. A bucket of any additional user - // properties - // (https://developers.google.com/analytics/devguides/collection/protocol/ga4/user-properties) - // for the user associated with this event. - AdditionalUserProperties []*UserProperty `json:"additionalUserProperties,omitempty"` - // CustomerType: Optional. Type of the customer associated with the event. - // - // Possible values: - // "CUSTOMER_TYPE_UNSPECIFIED" - Unspecified CustomerType. Should never be - // used. - // "NEW" - The customer is new to the advertiser. - // "RETURNING" - The customer is returning to the advertiser. - // "REENGAGED" - The customer has re-engaged with the advertiser. - CustomerType string `json:"customerType,omitempty"` - // CustomerValueBucket: Optional. The advertiser-assessed value of the - // customer. +// RemoveAudienceMembersRequest: Request to remove users from an audience in +// the provided destinations. Returns a RemoveAudienceMembersResponse. +type RemoveAudienceMembersRequest struct { + // AudienceMembers: Required. The list of users to remove. + AudienceMembers []*AudienceMember `json:"audienceMembers,omitempty"` + // Destinations: Required. The list of destinations to remove the users from. + Destinations []*Destination `json:"destinations,omitempty"` + // Encoding: Optional. Required for UserData uploads. The encoding type of the + // user identifiers. Applies to only the outer encoding for encrypted user + // identifiers. For non `UserData` uploads, this field is ignored. // // Possible values: - // "CUSTOMER_VALUE_BUCKET_UNSPECIFIED" - Unspecified CustomerValueBucket. - // Should never be used. - // "LOW" - The customer is low value. - // "MEDIUM" - The customer is medium value. - // "HIGH" - The customer is high value. - CustomerValueBucket string `json:"customerValueBucket,omitempty"` - // ForceSendFields is a list of field names (e.g. "AdditionalUserProperties") - // to unconditionally include in API requests. By default, fields with empty or + // "ENCODING_UNSPECIFIED" - Unspecified Encoding type. Should never be used. + // "HEX" - Hex encoding. + // "BASE64" - Base 64 encoding. + Encoding string `json:"encoding,omitempty"` + // EncryptionInfo: Optional. Encryption information for UserData uploads. If + // not set, it's assumed that uploaded identifying information is hashed but + // not encrypted. For non `UserData` uploads, this field is ignored. + EncryptionInfo *EncryptionInfo `json:"encryptionInfo,omitempty"` + // ValidateOnly: Optional. For testing purposes. If `true`, the request is + // validated but not executed. Only errors are returned, not results. + ValidateOnly bool `json:"validateOnly,omitempty"` + // ForceSendFields is a list of field names (e.g. "AudienceMembers") to + // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AdditionalUserProperties") to - // include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See + // NullFields is a list of field names (e.g. "AudienceMembers") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s UserProperties) MarshalJSON() ([]byte, error) { - type NoMethod UserProperties +func (s RemoveAudienceMembersRequest) MarshalJSON() ([]byte, error) { + type NoMethod RemoveAudienceMembersRequest return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// UserProperty: A bucket of any additional user properties -// (https://developers.google.com/analytics/devguides/collection/protocol/ga4/user-properties) -// for the user associated with this event. -type UserProperty struct { - // PropertyName: Required. The name of the user property to use. - PropertyName string `json:"propertyName,omitempty"` - // Value: Required. The string representation of the value of the user property - // to use. - Value string `json:"value,omitempty"` - // ForceSendFields is a list of field names (e.g. "PropertyName") to +// RemoveAudienceMembersResponse: Response from the +// RemoveAudienceMembersRequest. +type RemoveAudienceMembersResponse struct { + // RequestId: The auto-generated ID of the request. + RequestId string `json:"requestId,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "RequestId") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PropertyName") to include in API + // NullFields is a list of field names (e.g. "RequestId") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s UserProperty) MarshalJSON() ([]byte, error) { - type NoMethod UserProperty +func (s RemoveAudienceMembersResponse) MarshalJSON() ([]byte, error) { + type NoMethod RemoveAudienceMembersResponse return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// WarningCount: The warning count for a given warning reason. -type WarningCount struct { - // Reason: The warning reason. - // - // Possible values: - // "PROCESSING_WARNING_REASON_UNSPECIFIED" - The processing warning reason is - // unknown. - // "PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED" - The system did not - // have the permissions needed to access the KEK. - // "PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR" - The DEK failed to be - // decrypted. - // "PROCESSING_WARNING_REASON_DECRYPTION_ERROR" - The event has a decryption - // error. - // "PROCESSING_WARNING_REASON_WIP_AUTH_FAILED" - The WIP could not be used - // because it was rejected by its attestation condition. - // "PROCESSING_WARNING_REASON_INVALID_WIP" - The WIP is formatted incorrectly - // or the WIP does not exist. - // "PROCESSING_WARNING_REASON_INVALID_KEK" - The KEK cannot decrypt data - // because it is the wrong KEK, or it does not exist. - // "PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR" - Failed to - // decrypt th UserIdentifier data using the DEK. - // "PROCESSING_WARNING_REASON_INTERNAL_ERROR" - Internal error. - // "PROCESSING_WARNING_REASON_AWS_AUTH_FAILED" - The system failed to - // authenticate with AWS. - Reason string `json:"reason,omitempty"` - // RecordCount: The count of records that have a warning. +// RemoveAudienceMembersStatus: The status of the remove audience members +// request. +type RemoveAudienceMembersStatus struct { + // MobileDataRemovalStatus: The status of the mobile data removal from the + // destination. + MobileDataRemovalStatus *RemoveMobileDataStatus `json:"mobileDataRemovalStatus,omitempty"` + // PairDataRemovalStatus: The status of the pair data removal from the + // destination. + PairDataRemovalStatus *RemovePairDataStatus `json:"pairDataRemovalStatus,omitempty"` + // PpidDataRemovalStatus: The status of the ppid data removal from the + // destination. + PpidDataRemovalStatus *RemovePpidDataStatus `json:"ppidDataRemovalStatus,omitempty"` + // UserDataRemovalStatus: The status of the user data removal from the + // destination. + UserDataRemovalStatus *RemoveUserDataStatus `json:"userDataRemovalStatus,omitempty"` + // UserIdDataRemovalStatus: The status of the user id data removal from the + // destination. + UserIdDataRemovalStatus *RemoveUserIdDataStatus `json:"userIdDataRemovalStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. "MobileDataRemovalStatus") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "MobileDataRemovalStatus") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RemoveAudienceMembersStatus) MarshalJSON() ([]byte, error) { + type NoMethod RemoveAudienceMembersStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// RemoveMobileDataStatus: The status of the mobile data removal from the +// destination. +type RemoveMobileDataStatus struct { + // MobileIdCount: The total count of mobile Ids sent in the removal request. + // Includes all mobile ids in the request, regardless of whether they were + // successfully removed or not. + MobileIdCount int64 `json:"mobileIdCount,omitempty,string"` + // RecordCount: The total count of audience members sent in the removal + // request. Includes all audience members in the request, regardless of whether + // they were successfully removed or not. RecordCount int64 `json:"recordCount,omitempty,string"` - // ForceSendFields is a list of field names (e.g. "Reason") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "MobileIdCount") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Reason") to include in API + // NullFields is a list of field names (e.g. "MobileIdCount") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s WarningCount) MarshalJSON() ([]byte, error) { - type NoMethod WarningCount +func (s RemoveMobileDataStatus) MarshalJSON() ([]byte, error) { + type NoMethod RemoveMobileDataStatus return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// WarningInfo: Warning counts for each type of warning. -type WarningInfo struct { - // WarningCounts: A list of warnings and counts per warning reason. - WarningCounts []*WarningCount `json:"warningCounts,omitempty"` - // ForceSendFields is a list of field names (e.g. "WarningCounts") to +// RemovePairDataStatus: The status of the pair data removal from the +// destination. +type RemovePairDataStatus struct { + // PairIdCount: The total count of pair ids sent in the removal request. + // Includes all pair ids in the request, regardless of whether they were + // successfully removed or not. + PairIdCount int64 `json:"pairIdCount,omitempty,string"` + // RecordCount: The total count of audience members sent in the removal + // request. Includes all audience members in the request, regardless of whether + // they were successfully removed or not. + RecordCount int64 `json:"recordCount,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "PairIdCount") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "WarningCounts") to include in API + // NullFields is a list of field names (e.g. "PairIdCount") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s WarningInfo) MarshalJSON() ([]byte, error) { - type NoMethod WarningInfo +func (s RemovePairDataStatus) MarshalJSON() ([]byte, error) { + type NoMethod RemovePairDataStatus return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// RemovePpidDataStatus: The status of the ppid data removal from the +// destination. +type RemovePpidDataStatus struct { + // PpidCount: The total count of ppids sent in the removal request. Includes + // all ppids in the request, regardless of whether they were successfully + // removed or not. + PpidCount int64 `json:"ppidCount,omitempty,string"` + // RecordCount: The total count of audience members sent in the removal + // request. Includes all audience members in the request, regardless of whether + // they were successfully removed or not. + RecordCount int64 `json:"recordCount,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "PpidCount") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PpidCount") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RemovePpidDataStatus) MarshalJSON() ([]byte, error) { + type NoMethod RemovePpidDataStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// RemoveUserDataStatus: The status of the user data removal from the +// destination. +type RemoveUserDataStatus struct { + // RecordCount: The total count of audience members sent in the removal + // request. Includes all audience members in the request, regardless of whether + // they were successfully removed or not. + RecordCount int64 `json:"recordCount,omitempty,string"` + // UserIdentifierCount: The total count of user identifiers sent in the removal + // request. Includes all user identifiers in the request, regardless of whether + // they were successfully removed or not. + UserIdentifierCount int64 `json:"userIdentifierCount,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "RecordCount") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "RecordCount") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RemoveUserDataStatus) MarshalJSON() ([]byte, error) { + type NoMethod RemoveUserDataStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// RemoveUserIdDataStatus: The status of the user id data removal from the +// destination. +type RemoveUserIdDataStatus struct { + // RecordCount: The total count of audience members sent in the removal + // request. Includes all audience members in the request, regardless of whether + // they were successfully removed or not. + RecordCount int64 `json:"recordCount,omitempty,string"` + // UserIdCount: The total count of user ids sent in the removal request. + // Includes all user ids in the request, regardless of whether they were + // successfully removed or not. + UserIdCount int64 `json:"userIdCount,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "RecordCount") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "RecordCount") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RemoveUserIdDataStatus) MarshalJSON() ([]byte, error) { + type NoMethod RemoveUserIdDataStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// RequestStatusPerDestination: A request status per destination. +type RequestStatusPerDestination struct { + // AudienceMembersIngestionStatus: The status of the ingest audience members + // request. + AudienceMembersIngestionStatus *IngestAudienceMembersStatus `json:"audienceMembersIngestionStatus,omitempty"` + // AudienceMembersRemovalStatus: The status of the remove audience members + // request. + AudienceMembersRemovalStatus *RemoveAudienceMembersStatus `json:"audienceMembersRemovalStatus,omitempty"` + // Destination: A destination within a DM API request. + Destination *Destination `json:"destination,omitempty"` + // ErrorInfo: An error info error containing the error reason and error counts + // related to the upload. + ErrorInfo *ErrorInfo `json:"errorInfo,omitempty"` + // EventsIngestionStatus: The status of the ingest events request. + EventsIngestionStatus *IngestEventsStatus `json:"eventsIngestionStatus,omitempty"` + // RequestStatus: The request status of the destination. + // + // Possible values: + // "REQUEST_STATUS_UNKNOWN" - The request status is unknown. + // "SUCCESS" - The request succeeded. + // "PROCESSING" - The request is processing. + // "FAILED" - The request failed. + // "PARTIAL_SUCCESS" - The request partially succeeded. + RequestStatus string `json:"requestStatus,omitempty"` + // WarningInfo: A warning info containing the warning reason and warning counts + // related to the upload. + WarningInfo *WarningInfo `json:"warningInfo,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "AudienceMembersIngestionStatus") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted from + // API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AudienceMembersIngestionStatus") + // to include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RequestStatusPerDestination) MarshalJSON() ([]byte, error) { + type NoMethod RequestStatusPerDestination + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// RetrieveInsightsRequest: Request message for DM API +// MarketingDataInsightsService.RetrieveInsights +type RetrieveInsightsRequest struct { + // Baseline: Required. Baseline for the insights requested. + Baseline *Baseline `json:"baseline,omitempty"` + // UserListId: Required. The user list ID for which insights are requested. + UserListId string `json:"userListId,omitempty"` + // ForceSendFields is a list of field names (e.g. "Baseline") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Baseline") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RetrieveInsightsRequest) MarshalJSON() ([]byte, error) { + type NoMethod RetrieveInsightsRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// RetrieveInsightsResponse: Response message for DM API +// MarketingDataInsightsService.RetrieveInsights +type RetrieveInsightsResponse struct { + // MarketingDataInsights: Contains the insights for the marketing data. + MarketingDataInsights []*MarketingDataInsight `json:"marketingDataInsights,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "MarketingDataInsights") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "MarketingDataInsights") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RetrieveInsightsResponse) MarshalJSON() ([]byte, error) { + type NoMethod RetrieveInsightsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// RetrieveRequestStatusResponse: Response from the +// RetrieveRequestStatusRequest. +type RetrieveRequestStatusResponse struct { + // RequestStatusPerDestination: A list of request statuses per destination. The + // order of the statuses matches the order of the destinations in the original + // request. + RequestStatusPerDestination []*RequestStatusPerDestination `json:"requestStatusPerDestination,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. + // "RequestStatusPerDestination") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields + // for more details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "RequestStatusPerDestination") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RetrieveRequestStatusResponse) MarshalJSON() ([]byte, error) { + type NoMethod RetrieveRequestStatusResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// SearchPartnerLinksResponse: Response from the SearchPartnerLinksRequest. +type SearchPartnerLinksResponse struct { + // NextPageToken: A token, which can be sent as `page_token` to retrieve the + // next page. If this field is omitted, there are no subsequent pages. + NextPageToken string `json:"nextPageToken,omitempty"` + // PartnerLinks: The partner links for the given account. + PartnerLinks []*PartnerLink `json:"partnerLinks,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "NextPageToken") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s SearchPartnerLinksResponse) MarshalJSON() ([]byte, error) { + type NoMethod SearchPartnerLinksResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// SizeInfo: Estimated number of members in this user list in different target +// networks. +type SizeInfo struct { + // DisplayNetworkMembersCount: Output only. Estimated number of members in this + // user list, on the Google Display Network. + DisplayNetworkMembersCount int64 `json:"displayNetworkMembersCount,omitempty,string"` + // SearchNetworkMembersCount: Output only. Estimated number of members in this + // user list in the google.com domain. These are the members available for + // targeting in Search campaigns. + SearchNetworkMembersCount int64 `json:"searchNetworkMembersCount,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "DisplayNetworkMembersCount") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DisplayNetworkMembersCount") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s SizeInfo) MarshalJSON() ([]byte, error) { + type NoMethod SizeInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// Status: 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). +type Status struct { + // Code: The status code, which should be an enum value of google.rpc.Code. + Code int64 `json:"code,omitempty"` + // Details: A list of messages that carry the error details. There is a common + // set of message types for APIs to use. + Details []googleapi.RawMessage `json:"details,omitempty"` + // Message: 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. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Code") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s Status) MarshalJSON() ([]byte, error) { + type NoMethod Status + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// TargetNetworkInfo: Eligibility information for different target networks. +type TargetNetworkInfo struct { + // EligibleForDisplay: Output only. Indicates this user list is eligible for + // Google Display Network. + EligibleForDisplay bool `json:"eligibleForDisplay,omitempty"` + // EligibleForSearch: Optional. Indicates if this user list is eligible for + // Google Search Network. + EligibleForSearch bool `json:"eligibleForSearch,omitempty"` + // ForceSendFields is a list of field names (e.g. "EligibleForDisplay") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "EligibleForDisplay") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s TargetNetworkInfo) MarshalJSON() ([]byte, error) { + type NoMethod TargetNetworkInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// TermsOfService: The terms of service that the user has accepted/rejected. +type TermsOfService struct { + // CustomerMatchTermsOfServiceStatus: Optional. The Customer Match terms of + // service: https://support.google.com/adspolicy/answer/6299717. This must be + // accepted when ingesting UserData or MobileData. This field is not required + // for Partner Match User list. + // + // Possible values: + // "TERMS_OF_SERVICE_STATUS_UNSPECIFIED" - Not specified. + // "ACCEPTED" - Status indicating the caller has chosen to accept the terms + // of service. + // "REJECTED" - Status indicating the caller has chosen to reject the terms + // of service. + CustomerMatchTermsOfServiceStatus string `json:"customerMatchTermsOfServiceStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "CustomerMatchTermsOfServiceStatus") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted from + // API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. + // "CustomerMatchTermsOfServiceStatus") to include in API requests with the + // JSON null value. By default, fields with empty values are omitted from API + // requests. See https://pkg.go.dev/google.golang.org/api#hdr-NullFields for + // more details. + NullFields []string `json:"-"` +} + +func (s TermsOfService) MarshalJSON() ([]byte, error) { + type NoMethod TermsOfService + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// UserData: Data that identifies the user. At least one identifier is +// required. +type UserData struct { + // UserIdentifiers: Required. The identifiers for the user. It's possible to + // provide multiple instances of the same type of data (for example, multiple + // email addresses). To increase the likelihood of a match, provide as many + // identifiers as possible. At most 10 `userIdentifiers` can be provided in a + // single AudienceMember or Event. + UserIdentifiers []*UserIdentifier `json:"userIdentifiers,omitempty"` + // ForceSendFields is a list of field names (e.g. "UserIdentifiers") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "UserIdentifiers") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s UserData) MarshalJSON() ([]byte, error) { + type NoMethod UserData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// UserIdData: User id data holding the user id. +type UserIdData struct { + // UserId: Required. A unique identifier for a user, as defined by the + // advertiser. + UserId string `json:"userId,omitempty"` + // ForceSendFields is a list of field names (e.g. "UserId") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "UserId") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s UserIdData) MarshalJSON() ([]byte, error) { + type NoMethod UserIdData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// UserIdInfo: Additional information when `USER_ID` is one of the +// `upload_key_types`. +type UserIdInfo struct { + // DataSourceType: Optional. Immutable. Source of the upload data. + // + // Possible values: + // "DATA_SOURCE_TYPE_UNSPECIFIED" - Not specified. + // "DATA_SOURCE_TYPE_FIRST_PARTY" - The uploaded data is first-party data. + // "DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU" - The uploaded data is from a + // third-party credit bureau. + // "DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE" - The uploaded data is from a + // third-party voter file. + // "DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA" - The uploaded data is third + // party partner data. + DataSourceType string `json:"dataSourceType,omitempty"` + // ForceSendFields is a list of field names (e.g. "DataSourceType") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DataSourceType") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s UserIdInfo) MarshalJSON() ([]byte, error) { + type NoMethod UserIdInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// UserIdentifier: A single identifier for the user. +type UserIdentifier struct { + // Address: The known components of a user's address. Holds a grouping of + // identifiers that are matched all at once. + Address *AddressInfo `json:"address,omitempty"` + // EmailAddress: Hashed email address using SHA-256 hash function after + // normalization. + EmailAddress string `json:"emailAddress,omitempty"` + // PhoneNumber: Hashed phone number using SHA-256 hash function after + // normalization (E164 standard). + PhoneNumber string `json:"phoneNumber,omitempty"` + // ForceSendFields is a list of field names (e.g. "Address") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Address") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s UserIdentifier) MarshalJSON() ([]byte, error) { + type NoMethod UserIdentifier + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// UserList: A user list resource. +type UserList struct { + // AccessReason: Output only. The reason this account has been granted access + // to the list. + // + // Possible values: + // "ACCESS_REASON_UNSPECIFIED" - Not specified. + // "OWNED" - The resource is owned by the user. + // "SHARED" - The resource is shared to the user. + // "LICENSED" - The resource is licensed to the user. + // "SUBSCRIBED" - The user subscribed to the resource. + // "AFFILIATED" - The resource is accessible to the user. + AccessReason string `json:"accessReason,omitempty"` + // AccountAccessStatus: Optional. Indicates if this share is still enabled. + // When a user list is shared with the account this field is set to `ENABLED`. + // Later the user list owner can decide to revoke the share and make it + // `DISABLED`. + // + // Possible values: + // "ACCESS_STATUS_UNSPECIFIED" - Not specified. + // "ENABLED" - The access is enabled. + // "DISABLED" - The access is disabled. + AccountAccessStatus string `json:"accountAccessStatus,omitempty"` + // ClosingReason: Output only. The reason why this user list membership status + // is closed. + // + // Possible values: + // "CLOSING_REASON_UNSPECIFIED" - Not specified. + // "UNUSED" - The user list was closed because it has not been used in + // targeting recently. See https://support.google.com/google-ads/answer/2472738 + // for details. + ClosingReason string `json:"closingReason,omitempty"` + // Description: Optional. A description of the user list. + Description string `json:"description,omitempty"` + // DisplayName: Required. The display name of the user list. + DisplayName string `json:"displayName,omitempty"` + // Id: Output only. The unique ID of the user list. + Id int64 `json:"id,omitempty,string"` + // IngestedUserListInfo: Optional. Represents a user list that is populated by + // user ingested data. + IngestedUserListInfo *IngestedUserListInfo `json:"ingestedUserListInfo,omitempty"` + // IntegrationCode: Optional. An ID from external system. It is used by user + // list sellers to correlate IDs on their systems. + IntegrationCode string `json:"integrationCode,omitempty"` + // MembershipDuration: Optional. The duration a user remains in the user list. + // Valid durations are exact multiples of 24 hours (86400 seconds). Providing a + // value that is not an exact multiple of 24 hours will result in an + // INVALID_ARGUMENT error. + MembershipDuration string `json:"membershipDuration,omitempty"` + // MembershipStatus: Optional. Membership status of this user list. + // + // Possible values: + // "MEMBERSHIP_STATUS_UNSPECIFIED" - Not specified. + // "OPEN" - Open status - User list is accruing members and can be targeted + // to. + // "CLOSED" - Closed status - No new members being added. + MembershipStatus string `json:"membershipStatus,omitempty"` + // Name: Identifier. The resource name of the user list. Format: + // accountTypes/{account_type}/accounts/{account}/userLists/{user_list} + Name string `json:"name,omitempty"` + // ReadOnly: Output only. An option that indicates if a user may edit a list. + ReadOnly bool `json:"readOnly,omitempty"` + // SizeInfo: Output only. Estimated number of members in this user list in + // different target networks. + SizeInfo *SizeInfo `json:"sizeInfo,omitempty"` + // TargetNetworkInfo: Optional. Eligibility information for different target + // networks. + TargetNetworkInfo *TargetNetworkInfo `json:"targetNetworkInfo,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "AccessReason") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AccessReason") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s UserList) MarshalJSON() ([]byte, error) { + type NoMethod UserList + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// UserListDirectLicense: A user list direct license. This feature is only +// available to data partners. +type UserListDirectLicense struct { + // ClientAccountDisplayName: Output only. Name of client customer which the + // user list is being licensed to. This field is read-only. + ClientAccountDisplayName string `json:"clientAccountDisplayName,omitempty"` + // ClientAccountId: Immutable. ID of client customer which the user list is + // being licensed to. + ClientAccountId int64 `json:"clientAccountId,omitempty,string"` + // ClientAccountType: Immutable. Account type of client customer which the user + // list is being licensed to. + // + // Possible values: + // "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN" - Unknown. + // "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS" - Google Ads customer. + // "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER" - Display & + // Video 360 partner. + // "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER" - Display + // & Video 360 advertiser. + // "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_AD_MANAGER_AUDIENCE_LINK" - + // Google Ad Manager audience link. + ClientAccountType string `json:"clientAccountType,omitempty"` + // HistoricalPricings: Output only. Pricing history of this user list license. + // This field is read-only. + HistoricalPricings []*UserListLicensePricing `json:"historicalPricings,omitempty"` + // Metrics: Output only. Metrics related to this license This field is + // read-only and only populated if the start and end dates are set in the + // ListUserListDirectLicenses call + Metrics *UserListLicenseMetrics `json:"metrics,omitempty"` + // Name: Identifier. The resource name of the user list direct license. + Name string `json:"name,omitempty"` + // Pricing: Optional. UserListDirectLicense pricing. + Pricing *UserListLicensePricing `json:"pricing,omitempty"` + // Status: Optional. Status of UserListDirectLicense - ENABLED or DISABLED. + // + // Possible values: + // "USER_LIST_LICENSE_STATUS_UNSPECIFIED" - Unknown. + // "USER_LIST_LICENSE_STATUS_ENABLED" - Active status - user list is still + // being licensed. + // "USER_LIST_LICENSE_STATUS_DISABLED" - Inactive status - user list is no + // longer being licensed. + Status string `json:"status,omitempty"` + // UserListDisplayName: Output only. Name of the user list being licensed. This + // field is read-only. + UserListDisplayName string `json:"userListDisplayName,omitempty"` + // UserListId: Immutable. ID of the user list being licensed. + UserListId int64 `json:"userListId,omitempty,string"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "ClientAccountDisplayName") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ClientAccountDisplayName") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s UserListDirectLicense) MarshalJSON() ([]byte, error) { + type NoMethod UserListDirectLicense + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// UserListGlobalLicense: A user list global license. This feature is only +// available to data partners. +type UserListGlobalLicense struct { + // HistoricalPricings: Output only. Pricing history of this user list license. + // This field is read-only. + HistoricalPricings []*UserListLicensePricing `json:"historicalPricings,omitempty"` + // LicenseType: Immutable. Product type of client customer which the user list + // is being licensed to. + // + // Possible values: + // "USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED" - UNSPECIFIED. + // "USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER" - Reseller license. + // "USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE" - DataMart Sell Side + // license. + // "USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE" - DataMart Buy Side + // license. + LicenseType string `json:"licenseType,omitempty"` + // Metrics: Output only. Metrics related to this license This field is + // read-only and only populated if the start and end dates are set in the + // ListUserListGlobalLicenses call + Metrics *UserListLicenseMetrics `json:"metrics,omitempty"` + // Name: Identifier. The resource name of the user list global license. + Name string `json:"name,omitempty"` + // Pricing: Optional. UserListGlobalLicense pricing. + Pricing *UserListLicensePricing `json:"pricing,omitempty"` + // Status: Optional. Status of UserListGlobalLicense - ENABLED or DISABLED. + // + // Possible values: + // "USER_LIST_LICENSE_STATUS_UNSPECIFIED" - Unknown. + // "USER_LIST_LICENSE_STATUS_ENABLED" - Active status - user list is still + // being licensed. + // "USER_LIST_LICENSE_STATUS_DISABLED" - Inactive status - user list is no + // longer being licensed. + Status string `json:"status,omitempty"` + // UserListDisplayName: Output only. Name of the user list being licensed. This + // field is read-only. + UserListDisplayName string `json:"userListDisplayName,omitempty"` + // UserListId: Immutable. ID of the user list being licensed. + UserListId int64 `json:"userListId,omitempty,string"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "HistoricalPricings") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "HistoricalPricings") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s UserListGlobalLicense) MarshalJSON() ([]byte, error) { + type NoMethod UserListGlobalLicense + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// UserListGlobalLicenseCustomerInfo: Information about a customer of a user +// list global license. This will automatically be created by the system when a +// customer purchases a global license. +type UserListGlobalLicenseCustomerInfo struct { + // ClientAccountDisplayName: Output only. Name of client customer which the + // user list is being licensed to. + ClientAccountDisplayName string `json:"clientAccountDisplayName,omitempty"` + // ClientAccountId: Output only. ID of client customer which the user list is + // being licensed to. + ClientAccountId int64 `json:"clientAccountId,omitempty,string"` + // ClientAccountType: Output only. Product type of client customer which the + // user list is being licensed to. + // + // Possible values: + // "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN" - Unknown. + // "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS" - Google Ads customer. + // "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER" - Display & + // Video 360 partner. + // "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER" - Display + // & Video 360 advertiser. + // "USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_AD_MANAGER_AUDIENCE_LINK" - + // Google Ad Manager audience link. + ClientAccountType string `json:"clientAccountType,omitempty"` + // HistoricalPricings: Output only. Pricing history of this user list license. + HistoricalPricings []*UserListLicensePricing `json:"historicalPricings,omitempty"` + // LicenseType: Output only. Product type of client customer which the user + // list is being licensed to. + // + // Possible values: + // "USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED" - UNSPECIFIED. + // "USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER" - Reseller license. + // "USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE" - DataMart Sell Side + // license. + // "USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE" - DataMart Buy Side + // license. + LicenseType string `json:"licenseType,omitempty"` + // Metrics: Output only. Metrics related to this license This field is only + // populated if the start and end dates are set in the + // ListUserListGlobalLicenseCustomerInfos call. + Metrics *UserListLicenseMetrics `json:"metrics,omitempty"` + // Name: Identifier. The resource name of the user list global license + // customer. + Name string `json:"name,omitempty"` + // Pricing: Output only. UserListDirectLicense pricing. + Pricing *UserListLicensePricing `json:"pricing,omitempty"` + // Status: Output only. Status of UserListDirectLicense - ENABLED or DISABLED. + // + // Possible values: + // "USER_LIST_LICENSE_STATUS_UNSPECIFIED" - Unknown. + // "USER_LIST_LICENSE_STATUS_ENABLED" - Active status - user list is still + // being licensed. + // "USER_LIST_LICENSE_STATUS_DISABLED" - Inactive status - user list is no + // longer being licensed. + Status string `json:"status,omitempty"` + // UserListDisplayName: Output only. Name of the user list being licensed. + UserListDisplayName string `json:"userListDisplayName,omitempty"` + // UserListId: Output only. ID of the user list being licensed. + UserListId int64 `json:"userListId,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "ClientAccountDisplayName") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ClientAccountDisplayName") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s UserListGlobalLicenseCustomerInfo) MarshalJSON() ([]byte, error) { + type NoMethod UserListGlobalLicenseCustomerInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// UserListLicenseMetrics: Metrics related to a user list license. +type UserListLicenseMetrics struct { + // ClickCount: Output only. The number of clicks for the user list license. + ClickCount int64 `json:"clickCount,omitempty,string"` + // EndDate: Output only. The end date (inclusive) of the metrics in the format + // YYYYMMDD. For example, 20260102 represents January 2, 2026. If `start_date` + // is used in the filter, `end_date` is also required. If neither `start_date` + // nor `end_date` are included in the filter, the UserListLicenseMetrics fields + // will not be populated in the response. + EndDate int64 `json:"endDate,omitempty,string"` + // ImpressionCount: Output only. The number of impressions for the user list + // license. + ImpressionCount int64 `json:"impressionCount,omitempty,string"` + // RevenueUsdMicros: Output only. The revenue for the user list license in USD + // micros. + RevenueUsdMicros int64 `json:"revenueUsdMicros,omitempty,string"` + // StartDate: Output only. The start date (inclusive) of the metrics in the + // format YYYYMMDD. For example, 20260102 represents January 2, 2026. If + // `end_date` is used in the filter, `start_date` is also required. If neither + // `start_date` nor `end_date` are included in the filter, the + // UserListLicenseMetrics fields will not be populated in the response. + StartDate int64 `json:"startDate,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "ClickCount") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ClickCount") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s UserListLicenseMetrics) MarshalJSON() ([]byte, error) { + type NoMethod UserListLicenseMetrics + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// UserListLicensePricing: A user list license pricing. +type UserListLicensePricing struct { + // BuyerApprovalState: Output only. The buyer approval state of this pricing. + // This field is read-only. + // + // Possible values: + // "USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED" - UNSPECIFIED. + // "PENDING" - User list client has not yet accepted the pricing terms set by + // the user list owner. + // "APPROVED" - User list client has accepted the pricing terms set by the + // user list owner. + // "REJECTED" - User list client has rejected the pricing terms set by the + // user list owner. + BuyerApprovalState string `json:"buyerApprovalState,omitempty"` + // CostMicros: Optional. The cost associated with the model, in micro units + // (10^-6), in the currency specified by the currency_code field. For example, + // 2000000 means $2 if `currency_code` is `USD`. + CostMicros int64 `json:"costMicros,omitempty,string"` + // CostType: Immutable. The cost type of this pricing. Can be set only in the + // `create` operation. Can't be updated for an existing license. + // + // Possible values: + // "USER_LIST_PRICING_COST_TYPE_UNSPECIFIED" - Unspecified. + // "CPC" - Cost per click. + // "CPM" - Cost per mille (thousand impressions). + // "MEDIA_SHARE" - Media share. + CostType string `json:"costType,omitempty"` + // CurrencyCode: Optional. The currency in which cost and max_cost is + // specified. Must be a three-letter currency code defined in ISO 4217. + CurrencyCode string `json:"currencyCode,omitempty"` + // EndTime: Optional. End time of the pricing. + EndTime string `json:"endTime,omitempty"` + // MaxCostMicros: Optional. The maximum CPM a commerce audience can be charged + // when the MEDIA_SHARE cost type is used. The value is in micro units (10^-6) + // and in the currency specified by the currency_code field. For example, + // 2000000 means $2 if `currency_code` is `USD`. This is only relevant when + // cost_type is MEDIA_SHARE. When cost_type is not MEDIA_SHARE, and this field + // is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set + // to`0`, there is no cap. + MaxCostMicros int64 `json:"maxCostMicros,omitempty,string"` + // PricingActive: Output only. Whether this pricing is active. + PricingActive bool `json:"pricingActive,omitempty"` + // PricingId: Output only. The ID of this pricing. + PricingId int64 `json:"pricingId,omitempty,string"` + // StartTime: Output only. Start time of the pricing. + StartTime string `json:"startTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "BuyerApprovalState") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BuyerApprovalState") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s UserListLicensePricing) MarshalJSON() ([]byte, error) { + type NoMethod UserListLicensePricing + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// UserProperties: Advertiser-assessed information about the user at the time +// that the event happened. See +// https://support.google.com/google-ads/answer/14007601 for more details. +type UserProperties struct { + // AdditionalUserProperties: Optional. A bucket of any additional user + // properties + // (https://developers.google.com/analytics/devguides/collection/protocol/ga4/user-properties) + // for the user associated with this event. + AdditionalUserProperties []*UserProperty `json:"additionalUserProperties,omitempty"` + // CustomerType: Optional. Type of the customer associated with the event. + // + // Possible values: + // "CUSTOMER_TYPE_UNSPECIFIED" - Unspecified CustomerType. Should never be + // used. + // "NEW" - The customer is new to the advertiser. + // "RETURNING" - The customer is returning to the advertiser. + // "REENGAGED" - The customer has re-engaged with the advertiser. + CustomerType string `json:"customerType,omitempty"` + // CustomerValueBucket: Optional. The advertiser-assessed value of the + // customer. + // + // Possible values: + // "CUSTOMER_VALUE_BUCKET_UNSPECIFIED" - Unspecified CustomerValueBucket. + // Should never be used. + // "LOW" - The customer is low value. + // "MEDIUM" - The customer is medium value. + // "HIGH" - The customer is high value. + CustomerValueBucket string `json:"customerValueBucket,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdditionalUserProperties") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AdditionalUserProperties") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s UserProperties) MarshalJSON() ([]byte, error) { + type NoMethod UserProperties + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// UserProperty: A bucket of any additional user properties +// (https://developers.google.com/analytics/devguides/collection/protocol/ga4/user-properties) +// for the user associated with this event. +type UserProperty struct { + // PropertyName: Required. The name of the user property to use. + PropertyName string `json:"propertyName,omitempty"` + // Value: Required. The string representation of the value of the user property + // to use. + Value string `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "PropertyName") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PropertyName") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s UserProperty) MarshalJSON() ([]byte, error) { + type NoMethod UserProperty + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// WarningCount: The warning count for a given warning reason. +type WarningCount struct { + // Reason: The warning reason. + // + // Possible values: + // "PROCESSING_WARNING_REASON_UNSPECIFIED" - The processing warning reason is + // unknown. + // "PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED" - The system did not + // have the permissions needed to access the KEK. + // "PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR" - The DEK failed to be + // decrypted. + // "PROCESSING_WARNING_REASON_DECRYPTION_ERROR" - The event has a decryption + // error. + // "PROCESSING_WARNING_REASON_WIP_AUTH_FAILED" - The WIP could not be used + // because it was rejected by its attestation condition. + // "PROCESSING_WARNING_REASON_INVALID_WIP" - The WIP is formatted incorrectly + // or the WIP does not exist. + // "PROCESSING_WARNING_REASON_INVALID_KEK" - The KEK cannot decrypt data + // because it is the wrong KEK, or it does not exist. + // "PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR" - Failed to + // decrypt th UserIdentifier data using the DEK. + // "PROCESSING_WARNING_REASON_INTERNAL_ERROR" - Internal error. + // "PROCESSING_WARNING_REASON_AWS_AUTH_FAILED" - The system failed to + // authenticate with AWS. + Reason string `json:"reason,omitempty"` + // RecordCount: The count of records that have a warning. + RecordCount int64 `json:"recordCount,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "Reason") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Reason") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s WarningCount) MarshalJSON() ([]byte, error) { + type NoMethod WarningCount + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// WarningInfo: Warning counts for each type of warning. +type WarningInfo struct { + // WarningCounts: A list of warnings and counts per warning reason. + WarningCounts []*WarningCount `json:"warningCounts,omitempty"` + // ForceSendFields is a list of field names (e.g. "WarningCounts") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "WarningCounts") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s WarningInfo) MarshalJSON() ([]byte, error) { + type NoMethod WarningInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type AccountTypesAccountsInsightsRetrieveCall struct { + s *Service + parent string + retrieveinsightsrequest *RetrieveInsightsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Retrieve: Retrieves marketing data insights for a given user list. This +// feature is only available to data partners. Authorization Headers: This +// method supports the following optional headers to define how the API +// authorizes access for the request: * `login-account`: (Optional) The +// resource name of the account where the Google Account of the credentials is +// a user. If not set, defaults to the account of the request. Format: +// `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * +// `linked-account`: (Optional) The resource name of the account with an +// established product link to the `login-account`. Format: +// `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}` +// +// - parent: The parent account that owns the user list. Format: +// `accountTypes/{account_type}/accounts/{account}`. +func (r *AccountTypesAccountsInsightsService) Retrieve(parent string, retrieveinsightsrequest *RetrieveInsightsRequest) *AccountTypesAccountsInsightsRetrieveCall { + c := &AccountTypesAccountsInsightsRetrieveCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.retrieveinsightsrequest = retrieveinsightsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsInsightsRetrieveCall) Fields(s ...googleapi.Field) *AccountTypesAccountsInsightsRetrieveCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsInsightsRetrieveCall) Context(ctx context.Context) *AccountTypesAccountsInsightsRetrieveCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsInsightsRetrieveCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsInsightsRetrieveCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.retrieveinsightsrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/insights:retrieve") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.insights.retrieve", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.insights.retrieve" call. +// Any non-2xx status code is an error. Response headers are in either +// *RetrieveInsightsResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *AccountTypesAccountsInsightsRetrieveCall) Do(opts ...googleapi.CallOption) (*RetrieveInsightsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &RetrieveInsightsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.insights.retrieve", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type AccountTypesAccountsPartnerLinksCreateCall struct { + s *Service + parent string + partnerlink *PartnerLink + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a partner link for the given account. Authorization Headers: +// This method supports the following optional headers to define how the API +// authorizes access for the request: * `login-account`: (Optional) The +// resource name of the account where the Google Account of the credentials is +// a user. If not set, defaults to the account of the request. Format: +// `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * +// `linked-account`: (Optional) The resource name of the account with an +// established product link to the `login-account`. Format: +// `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}` +// +// - parent: The parent, which owns this collection of partner links. Format: +// accountTypes/{account_type}/accounts/{account}. +func (r *AccountTypesAccountsPartnerLinksService) Create(parent string, partnerlink *PartnerLink) *AccountTypesAccountsPartnerLinksCreateCall { + c := &AccountTypesAccountsPartnerLinksCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.partnerlink = partnerlink + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsPartnerLinksCreateCall) Fields(s ...googleapi.Field) *AccountTypesAccountsPartnerLinksCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsPartnerLinksCreateCall) Context(ctx context.Context) *AccountTypesAccountsPartnerLinksCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsPartnerLinksCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsPartnerLinksCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.partnerlink) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/partnerLinks") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.partnerLinks.create", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.partnerLinks.create" call. +// Any non-2xx status code is an error. Response headers are in either +// *PartnerLink.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *AccountTypesAccountsPartnerLinksCreateCall) Do(opts ...googleapi.CallOption) (*PartnerLink, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &PartnerLink{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.partnerLinks.create", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type AccountTypesAccountsPartnerLinksDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a partner link for the given account. Authorization Headers: +// This method supports the following optional headers to define how the API +// authorizes access for the request: * `login-account`: (Optional) The +// resource name of the account where the Google Account of the credentials is +// a user. If not set, defaults to the account of the request. Format: +// `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * +// `linked-account`: (Optional) The resource name of the account with an +// established product link to the `login-account`. Format: +// `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}` +// +// - name: The resource name of the partner link to delete. Format: +// accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}. +func (r *AccountTypesAccountsPartnerLinksService) Delete(name string) *AccountTypesAccountsPartnerLinksDeleteCall { + c := &AccountTypesAccountsPartnerLinksDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsPartnerLinksDeleteCall) Fields(s ...googleapi.Field) *AccountTypesAccountsPartnerLinksDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsPartnerLinksDeleteCall) Context(ctx context.Context) *AccountTypesAccountsPartnerLinksDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsPartnerLinksDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsPartnerLinksDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.partnerLinks.delete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.partnerLinks.delete" call. +// Any non-2xx status code is an error. Response headers are in either +// *Empty.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *AccountTypesAccountsPartnerLinksDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Empty{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.partnerLinks.delete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type AccountTypesAccountsPartnerLinksSearchCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Search: Searches for all partner links to and from a given account. +// Authorization Headers: This method supports the following optional headers +// to define how the API authorizes access for the request: * `login-account`: +// (Optional) The resource name of the account where the Google Account of the +// credentials is a user. If not set, defaults to the account of the request. +// Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * +// `linked-account`: (Optional) The resource name of the account with an +// established product link to the `login-account`. Format: +// `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}` +// +// - parent: Account to search for partner links. If no `filter` is specified, +// all partner links where this account is either the `owning_account` or +// `partner_account` are returned. Format: +// `accountTypes/{account_type}/accounts/{account}`. +func (r *AccountTypesAccountsPartnerLinksService) Search(parent string) *AccountTypesAccountsPartnerLinksSearchCall { + c := &AccountTypesAccountsPartnerLinksSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": A filter string +// (//google.aip.dev/160). All fields need to be on the left hand side of each +// condition (for example: `partner_link_id = 123456789`). Supported +// operations: - `AND` - `=` - `!=` Supported fields: - `partner_link_id` - +// `owning_account.account_type` - `owning_account.account_id` - +// `partner_account.account_type` - `partner_account.account_id` Example: +// `owning_account.account_type = "GOOGLE_ADS" OR partner_account.account_id = +// 987654321` +func (c *AccountTypesAccountsPartnerLinksSearchCall) Filter(filter string) *AccountTypesAccountsPartnerLinksSearchCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// partner links to return. The service may return fewer than this value. If +// unspecified, at most 10 partner links will be returned. The maximum value is +// 100; values above 100 will be coerced to 100. +func (c *AccountTypesAccountsPartnerLinksSearchCall) PageSize(pageSize int64) *AccountTypesAccountsPartnerLinksSearchCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `SearchPartnerLinks` call. Provide this to retrieve the +// subsequent page. When paginating, all other parameters provided to +// `SearchPartnerLinks` must match the call that provided the page token. +func (c *AccountTypesAccountsPartnerLinksSearchCall) PageToken(pageToken string) *AccountTypesAccountsPartnerLinksSearchCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsPartnerLinksSearchCall) Fields(s ...googleapi.Field) *AccountTypesAccountsPartnerLinksSearchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *AccountTypesAccountsPartnerLinksSearchCall) IfNoneMatch(entityTag string) *AccountTypesAccountsPartnerLinksSearchCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsPartnerLinksSearchCall) Context(ctx context.Context) *AccountTypesAccountsPartnerLinksSearchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsPartnerLinksSearchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsPartnerLinksSearchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/partnerLinks:search") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.partnerLinks.search", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.partnerLinks.search" call. +// Any non-2xx status code is an error. Response headers are in either +// *SearchPartnerLinksResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *AccountTypesAccountsPartnerLinksSearchCall) Do(opts ...googleapi.CallOption) (*SearchPartnerLinksResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &SearchPartnerLinksResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.partnerLinks.search", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *AccountTypesAccountsPartnerLinksSearchCall) Pages(ctx context.Context, f func(*SearchPartnerLinksResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type AccountTypesAccountsUserListDirectLicensesCreateCall struct { + s *Service + parent string + userlistdirectlicense *UserListDirectLicense + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a user list direct license. This feature is only available +// to data partners. +// +// - parent: The account that owns the user list being licensed. Should be in +// the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}. +func (r *AccountTypesAccountsUserListDirectLicensesService) Create(parent string, userlistdirectlicense *UserListDirectLicense) *AccountTypesAccountsUserListDirectLicensesCreateCall { + c := &AccountTypesAccountsUserListDirectLicensesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.userlistdirectlicense = userlistdirectlicense + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsUserListDirectLicensesCreateCall) Fields(s ...googleapi.Field) *AccountTypesAccountsUserListDirectLicensesCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsUserListDirectLicensesCreateCall) Context(ctx context.Context) *AccountTypesAccountsUserListDirectLicensesCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsUserListDirectLicensesCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsUserListDirectLicensesCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.userlistdirectlicense) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/userListDirectLicenses") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListDirectLicenses.create", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.userListDirectLicenses.create" call. +// Any non-2xx status code is an error. Response headers are in either +// *UserListDirectLicense.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *AccountTypesAccountsUserListDirectLicensesCreateCall) Do(opts ...googleapi.CallOption) (*UserListDirectLicense, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &UserListDirectLicense{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListDirectLicenses.create", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type AccountTypesAccountsUserListDirectLicensesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Retrieves a user list direct license. This feature is only available to +// data partners. +// +// - name: The resource name of the user list direct license. +func (r *AccountTypesAccountsUserListDirectLicensesService) Get(name string) *AccountTypesAccountsUserListDirectLicensesGetCall { + c := &AccountTypesAccountsUserListDirectLicensesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsUserListDirectLicensesGetCall) Fields(s ...googleapi.Field) *AccountTypesAccountsUserListDirectLicensesGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *AccountTypesAccountsUserListDirectLicensesGetCall) IfNoneMatch(entityTag string) *AccountTypesAccountsUserListDirectLicensesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsUserListDirectLicensesGetCall) Context(ctx context.Context) *AccountTypesAccountsUserListDirectLicensesGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsUserListDirectLicensesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsUserListDirectLicensesGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListDirectLicenses.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.userListDirectLicenses.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *UserListDirectLicense.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *AccountTypesAccountsUserListDirectLicensesGetCall) Do(opts ...googleapi.CallOption) (*UserListDirectLicense, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &UserListDirectLicense{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListDirectLicenses.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type AccountTypesAccountsUserListDirectLicensesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists all user list direct licenses owned by the parent account. This +// feature is only available to data partners. +// +// - parent: The account whose licenses are being queried. Should be in the +// format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}. +func (r *AccountTypesAccountsUserListDirectLicensesService) List(parent string) *AccountTypesAccountsUserListDirectLicensesListCall { + c := &AccountTypesAccountsUserListDirectLicensesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Filters to apply to the list +// request. All fields need to be on the left hand side of each condition (for +// example: user_list_id = 123). **Supported Operations:** - `AND` - `=` - `!=` +// - `>` - `>=` - `<` - `<=` **Unsupported Fields:** - `name` (use get method +// instead) - `historical_pricings` and all its subfields - +// `pricing.start_time` - `pricing.end_time` +func (c *AccountTypesAccountsUserListDirectLicensesListCall) Filter(filter string) *AccountTypesAccountsUserListDirectLicensesListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// licenses to return per page. The service may return fewer than this value. +// If unspecified, at most 50 licenses will be returned. The maximum value is +// 1000; values above 1000 will be coerced to 1000. +func (c *AccountTypesAccountsUserListDirectLicensesListCall) PageSize(pageSize int64) *AccountTypesAccountsUserListDirectLicensesListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListUserListDirectLicense` call. Provide this to retrieve +// the subsequent page. When paginating, all other parameters provided to +// `ListUserListDirectLicense` must match the call that provided the page +// token. +func (c *AccountTypesAccountsUserListDirectLicensesListCall) PageToken(pageToken string) *AccountTypesAccountsUserListDirectLicensesListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsUserListDirectLicensesListCall) Fields(s ...googleapi.Field) *AccountTypesAccountsUserListDirectLicensesListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *AccountTypesAccountsUserListDirectLicensesListCall) IfNoneMatch(entityTag string) *AccountTypesAccountsUserListDirectLicensesListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsUserListDirectLicensesListCall) Context(ctx context.Context) *AccountTypesAccountsUserListDirectLicensesListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsUserListDirectLicensesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsUserListDirectLicensesListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/userListDirectLicenses") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListDirectLicenses.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.userListDirectLicenses.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListUserListDirectLicensesResponse.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *AccountTypesAccountsUserListDirectLicensesListCall) Do(opts ...googleapi.CallOption) (*ListUserListDirectLicensesResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ListUserListDirectLicensesResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListDirectLicenses.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *AccountTypesAccountsUserListDirectLicensesListCall) Pages(ctx context.Context, f func(*ListUserListDirectLicensesResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type AccountTypesAccountsUserListDirectLicensesPatchCall struct { + s *Service + name string + userlistdirectlicense *UserListDirectLicense + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates a user list direct license. This feature is only available to +// data partners. +// +// - name: Identifier. The resource name of the user list direct license. +func (r *AccountTypesAccountsUserListDirectLicensesService) Patch(name string, userlistdirectlicense *UserListDirectLicense) *AccountTypesAccountsUserListDirectLicensesPatchCall { + c := &AccountTypesAccountsUserListDirectLicensesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.userlistdirectlicense = userlistdirectlicense + return c +} + +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. The special character `*` is not supported and an +// `INVALID_UPDATE_MASK` error will be thrown if used. +func (c *AccountTypesAccountsUserListDirectLicensesPatchCall) UpdateMask(updateMask string) *AccountTypesAccountsUserListDirectLicensesPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsUserListDirectLicensesPatchCall) Fields(s ...googleapi.Field) *AccountTypesAccountsUserListDirectLicensesPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsUserListDirectLicensesPatchCall) Context(ctx context.Context) *AccountTypesAccountsUserListDirectLicensesPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsUserListDirectLicensesPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsUserListDirectLicensesPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.userlistdirectlicense) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListDirectLicenses.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.userListDirectLicenses.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *UserListDirectLicense.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *AccountTypesAccountsUserListDirectLicensesPatchCall) Do(opts ...googleapi.CallOption) (*UserListDirectLicense, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &UserListDirectLicense{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListDirectLicenses.patch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type AccountTypesAccountsUserListGlobalLicensesCreateCall struct { + s *Service + parent string + userlistgloballicense *UserListGlobalLicense + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a user list global license. This feature is only available +// to data partners. +// +// - parent: The account that owns the user list being licensed. Should be in +// the format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}. +func (r *AccountTypesAccountsUserListGlobalLicensesService) Create(parent string, userlistgloballicense *UserListGlobalLicense) *AccountTypesAccountsUserListGlobalLicensesCreateCall { + c := &AccountTypesAccountsUserListGlobalLicensesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.userlistgloballicense = userlistgloballicense + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsUserListGlobalLicensesCreateCall) Fields(s ...googleapi.Field) *AccountTypesAccountsUserListGlobalLicensesCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsUserListGlobalLicensesCreateCall) Context(ctx context.Context) *AccountTypesAccountsUserListGlobalLicensesCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsUserListGlobalLicensesCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsUserListGlobalLicensesCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.userlistgloballicense) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/userListGlobalLicenses") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListGlobalLicenses.create", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.userListGlobalLicenses.create" call. +// Any non-2xx status code is an error. Response headers are in either +// *UserListGlobalLicense.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *AccountTypesAccountsUserListGlobalLicensesCreateCall) Do(opts ...googleapi.CallOption) (*UserListGlobalLicense, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &UserListGlobalLicense{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListGlobalLicenses.create", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type AccountTypesAccountsUserListGlobalLicensesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Retrieves a user list global license. This feature is only available to +// data partners. +// +// - name: The resource name of the user list global license. +func (r *AccountTypesAccountsUserListGlobalLicensesService) Get(name string) *AccountTypesAccountsUserListGlobalLicensesGetCall { + c := &AccountTypesAccountsUserListGlobalLicensesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsUserListGlobalLicensesGetCall) Fields(s ...googleapi.Field) *AccountTypesAccountsUserListGlobalLicensesGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *AccountTypesAccountsUserListGlobalLicensesGetCall) IfNoneMatch(entityTag string) *AccountTypesAccountsUserListGlobalLicensesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsUserListGlobalLicensesGetCall) Context(ctx context.Context) *AccountTypesAccountsUserListGlobalLicensesGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsUserListGlobalLicensesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsUserListGlobalLicensesGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListGlobalLicenses.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.userListGlobalLicenses.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *UserListGlobalLicense.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *AccountTypesAccountsUserListGlobalLicensesGetCall) Do(opts ...googleapi.CallOption) (*UserListGlobalLicense, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &UserListGlobalLicense{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListGlobalLicenses.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type AccountTypesAccountsUserListGlobalLicensesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists all user list global licenses owned by the parent account. This +// feature is only available to data partners. +// +// - parent: The account whose licenses are being queried. Should be in the +// format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}. +func (r *AccountTypesAccountsUserListGlobalLicensesService) List(parent string) *AccountTypesAccountsUserListGlobalLicensesListCall { + c := &AccountTypesAccountsUserListGlobalLicensesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Filters to apply to the list +// request. All fields need to be on the left hand side of each condition (for +// example: user_list_id = 123). **Supported Operations:** - `AND` - `=` - `!=` +// - `>` - `>=` - `<` - `<=` **Unsupported Fields:** - `name` (use get method +// instead) - `historical_pricings` and all its subfields - +// `pricing.start_time` - `pricing.end_time` +func (c *AccountTypesAccountsUserListGlobalLicensesListCall) Filter(filter string) *AccountTypesAccountsUserListGlobalLicensesListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// licenses to return. The service may return fewer than this value. If +// unspecified, at most 50 licenses will be returned. The maximum value is +// 1000; values above 1000 will be coerced to 1000. +func (c *AccountTypesAccountsUserListGlobalLicensesListCall) PageSize(pageSize int64) *AccountTypesAccountsUserListGlobalLicensesListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListUserListGlobalLicense` call. Provide this to retrieve +// the subsequent page. When paginating, all other parameters provided to +// `ListUserListDirectLicense` must match the call that provided the page +// token. +func (c *AccountTypesAccountsUserListGlobalLicensesListCall) PageToken(pageToken string) *AccountTypesAccountsUserListGlobalLicensesListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsUserListGlobalLicensesListCall) Fields(s ...googleapi.Field) *AccountTypesAccountsUserListGlobalLicensesListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *AccountTypesAccountsUserListGlobalLicensesListCall) IfNoneMatch(entityTag string) *AccountTypesAccountsUserListGlobalLicensesListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsUserListGlobalLicensesListCall) Context(ctx context.Context) *AccountTypesAccountsUserListGlobalLicensesListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsUserListGlobalLicensesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsUserListGlobalLicensesListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/userListGlobalLicenses") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListGlobalLicenses.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.userListGlobalLicenses.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListUserListGlobalLicensesResponse.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *AccountTypesAccountsUserListGlobalLicensesListCall) Do(opts ...googleapi.CallOption) (*ListUserListGlobalLicensesResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ListUserListGlobalLicensesResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListGlobalLicenses.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *AccountTypesAccountsUserListGlobalLicensesListCall) Pages(ctx context.Context, f func(*ListUserListGlobalLicensesResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type AccountTypesAccountsUserListGlobalLicensesPatchCall struct { + s *Service + name string + userlistgloballicense *UserListGlobalLicense + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates a user list global license. This feature is only available to +// data partners. +// +// - name: Identifier. The resource name of the user list global license. +func (r *AccountTypesAccountsUserListGlobalLicensesService) Patch(name string, userlistgloballicense *UserListGlobalLicense) *AccountTypesAccountsUserListGlobalLicensesPatchCall { + c := &AccountTypesAccountsUserListGlobalLicensesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.userlistgloballicense = userlistgloballicense + return c +} + +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. The special character `*` is not supported and an +// `INVALID_UPDATE_MASK` error will be thrown if used. +func (c *AccountTypesAccountsUserListGlobalLicensesPatchCall) UpdateMask(updateMask string) *AccountTypesAccountsUserListGlobalLicensesPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsUserListGlobalLicensesPatchCall) Fields(s ...googleapi.Field) *AccountTypesAccountsUserListGlobalLicensesPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsUserListGlobalLicensesPatchCall) Context(ctx context.Context) *AccountTypesAccountsUserListGlobalLicensesPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsUserListGlobalLicensesPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsUserListGlobalLicensesPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.userlistgloballicense) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListGlobalLicenses.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.userListGlobalLicenses.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *UserListGlobalLicense.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *AccountTypesAccountsUserListGlobalLicensesPatchCall) Do(opts ...googleapi.CallOption) (*UserListGlobalLicense, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &UserListGlobalLicense{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListGlobalLicenses.patch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists all customer info for a user list global license. This feature +// is only available to data partners. +// +// - parent: The global license whose customer info are being queried. Should +// be in the format +// `accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{ +// USER_LIST_GLOBAL_LICENSE_ID}`. To list all global license customer info +// under an account, replace the user list global license id with a '-' (for +// example, +// `accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-`). +func (r *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosService) List(parent string) *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall { + c := &AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Filters to apply to the list +// request. All fields need to be on the left hand side of each condition (for +// example: user_list_id = 123). **Supported Operations:** - `AND` - `=` - `!=` +// - `>` - `>=` - `<` - `<=` **Unsupported Fields:** - `name` (use get method +// instead) - `historical_pricings` and all its subfields - +// `pricing.start_time` - `pricing.end_time` +func (c *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall) Filter(filter string) *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// licenses to return. The service may return fewer than this value. If +// unspecified, at most 50 licenses will be returned. The maximum value is +// 1000; values above 1000 will be coerced to 1000. +func (c *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall) PageSize(pageSize int64) *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListUserListDirectLicense` call. Provide this to retrieve +// the subsequent page. When paginating, all other parameters provided to +// `ListUserListDirectLicense` must match the call that provided the page +// token. +func (c *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall) PageToken(pageToken string) *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall) Fields(s ...googleapi.Field) *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall) IfNoneMatch(entityTag string) *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall) Context(ctx context.Context) *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/userListGlobalLicenseCustomerInfos") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListUserListGlobalLicenseCustomerInfosResponse.ServerResponse.Header or (if +// a response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall) Do(opts ...googleapi.CallOption) (*ListUserListGlobalLicenseCustomerInfosResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ListUserListGlobalLicenseCustomerInfosResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *AccountTypesAccountsUserListGlobalLicensesUserListGlobalLicenseCustomerInfosListCall) Pages(ctx context.Context, f func(*ListUserListGlobalLicenseCustomerInfosResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type AccountTypesAccountsUserListsCreateCall struct { + s *Service + parent string + userlist *UserList + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a UserList. Authorization Headers: This method supports the +// following optional headers to define how the API authorizes access for the +// request: * `login-account`: (Optional) The resource name of the account +// where the Google Account of the credentials is a user. If not set, defaults +// to the account of the request. Format: +// `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * +// `linked-account`: (Optional) The resource name of the account with an +// established product link to the `login-account`. Format: +// `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}` +// +// - parent: The parent account where this user list will be created. Format: +// accountTypes/{account_type}/accounts/{account}. +func (r *AccountTypesAccountsUserListsService) Create(parent string, userlist *UserList) *AccountTypesAccountsUserListsCreateCall { + c := &AccountTypesAccountsUserListsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.userlist = userlist + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If true, the +// request is validated but not executed. +func (c *AccountTypesAccountsUserListsCreateCall) ValidateOnly(validateOnly bool) *AccountTypesAccountsUserListsCreateCall { + c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsUserListsCreateCall) Fields(s ...googleapi.Field) *AccountTypesAccountsUserListsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsUserListsCreateCall) Context(ctx context.Context) *AccountTypesAccountsUserListsCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsUserListsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsUserListsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.userlist) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/userLists") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userLists.create", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.userLists.create" call. +// Any non-2xx status code is an error. Response headers are in either +// *UserList.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *AccountTypesAccountsUserListsCreateCall) Do(opts ...googleapi.CallOption) (*UserList, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &UserList{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userLists.create", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type AccountTypesAccountsUserListsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a UserList. Authorization Headers: This method supports the +// following optional headers to define how the API authorizes access for the +// request: * `login-account`: (Optional) The resource name of the account +// where the Google Account of the credentials is a user. If not set, defaults +// to the account of the request. Format: +// `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * +// `linked-account`: (Optional) The resource name of the account with an +// established product link to the `login-account`. Format: +// `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}` +// +// - name: The name of the user list to delete. Format: +// accountTypes/{account_type}/accounts/{account}/userLists/{user_list}. +func (r *AccountTypesAccountsUserListsService) Delete(name string) *AccountTypesAccountsUserListsDeleteCall { + c := &AccountTypesAccountsUserListsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If true, the +// request is validated but not executed. +func (c *AccountTypesAccountsUserListsDeleteCall) ValidateOnly(validateOnly bool) *AccountTypesAccountsUserListsDeleteCall { + c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsUserListsDeleteCall) Fields(s ...googleapi.Field) *AccountTypesAccountsUserListsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsUserListsDeleteCall) Context(ctx context.Context) *AccountTypesAccountsUserListsDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsUserListsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsUserListsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userLists.delete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.userLists.delete" call. +// Any non-2xx status code is an error. Response headers are in either +// *Empty.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *AccountTypesAccountsUserListsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Empty{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userLists.delete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type AccountTypesAccountsUserListsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets a UserList. Authorization Headers: This method supports the +// following optional headers to define how the API authorizes access for the +// request: * `login-account`: (Optional) The resource name of the account +// where the Google Account of the credentials is a user. If not set, defaults +// to the account of the request. Format: +// `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * +// `linked-account`: (Optional) The resource name of the account with an +// established product link to the `login-account`. Format: +// `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}` +// +// - name: The resource name of the UserList to retrieve. Format: +// accountTypes/{account_type}/accounts/{account}/userLists/{user_list}. +func (r *AccountTypesAccountsUserListsService) Get(name string) *AccountTypesAccountsUserListsGetCall { + c := &AccountTypesAccountsUserListsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsUserListsGetCall) Fields(s ...googleapi.Field) *AccountTypesAccountsUserListsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *AccountTypesAccountsUserListsGetCall) IfNoneMatch(entityTag string) *AccountTypesAccountsUserListsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsUserListsGetCall) Context(ctx context.Context) *AccountTypesAccountsUserListsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsUserListsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsUserListsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userLists.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.userLists.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *UserList.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *AccountTypesAccountsUserListsGetCall) Do(opts ...googleapi.CallOption) (*UserList, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &UserList{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userLists.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type AccountTypesAccountsUserListsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists UserLists. Authorization Headers: This method supports the +// following optional headers to define how the API authorizes access for the +// request: * `login-account`: (Optional) The resource name of the account +// where the Google Account of the credentials is a user. If not set, defaults +// to the account of the request. Format: +// `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * +// `linked-account`: (Optional) The resource name of the account with an +// established product link to the `login-account`. Format: +// `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}` +// +// - parent: The parent account which owns this collection of user lists. +// Format: accountTypes/{account_type}/accounts/{account}. +func (r *AccountTypesAccountsUserListsService) List(parent string) *AccountTypesAccountsUserListsListCall { + c := &AccountTypesAccountsUserListsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": A filter string +// (//google.aip.dev/160). All fields need to be on the left hand side of each +// condition (for example: `display_name = "list 1"). Supported operations: - +// `AND` - `=` - `!=` - `>` - `>=` - `<` - `<=` - `:` (has) Supported fields: - +// `id` - `display_name` - `description` - `membership_status` - +// `integration_code` - `access_reason` - +// `ingested_user_list_info.upload_key_types` +func (c *AccountTypesAccountsUserListsListCall) Filter(filter string) *AccountTypesAccountsUserListsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of user +// lists to return. The service may return fewer than this value. If +// unspecified, at most 50 user lists will be returned. The maximum value is +// 1000; values above 1000 will be coerced to 1000. +func (c *AccountTypesAccountsUserListsListCall) PageSize(pageSize int64) *AccountTypesAccountsUserListsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListUserLists` call. Provide this to retrieve the +// subsequent page. When paginating, all other parameters provided to +// `ListUserLists` must match the call that provided the page token. +func (c *AccountTypesAccountsUserListsListCall) PageToken(pageToken string) *AccountTypesAccountsUserListsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsUserListsListCall) Fields(s ...googleapi.Field) *AccountTypesAccountsUserListsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *AccountTypesAccountsUserListsListCall) IfNoneMatch(entityTag string) *AccountTypesAccountsUserListsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsUserListsListCall) Context(ctx context.Context) *AccountTypesAccountsUserListsListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsUserListsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsUserListsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/userLists") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userLists.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.userLists.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListUserListsResponse.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *AccountTypesAccountsUserListsListCall) Do(opts ...googleapi.CallOption) (*ListUserListsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ListUserListsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userLists.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *AccountTypesAccountsUserListsListCall) Pages(ctx context.Context, f func(*ListUserListsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type AccountTypesAccountsUserListsPatchCall struct { + s *Service + name string + userlist *UserList + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates a UserList. Authorization Headers: This method supports the +// following optional headers to define how the API authorizes access for the +// request: * `login-account`: (Optional) The resource name of the account +// where the Google Account of the credentials is a user. If not set, defaults +// to the account of the request. Format: +// `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * +// `linked-account`: (Optional) The resource name of the account with an +// established product link to the `login-account`. Format: +// `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}` +// +// - name: Identifier. The resource name of the user list. Format: +// accountTypes/{account_type}/accounts/{account}/userLists/{user_list}. +func (r *AccountTypesAccountsUserListsService) Patch(name string, userlist *UserList) *AccountTypesAccountsUserListsPatchCall { + c := &AccountTypesAccountsUserListsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.userlist = userlist + return c +} + +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. +func (c *AccountTypesAccountsUserListsPatchCall) UpdateMask(updateMask string) *AccountTypesAccountsUserListsPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If true, the +// request is validated but not executed. +func (c *AccountTypesAccountsUserListsPatchCall) ValidateOnly(validateOnly bool) *AccountTypesAccountsUserListsPatchCall { + c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountTypesAccountsUserListsPatchCall) Fields(s ...googleapi.Field) *AccountTypesAccountsUserListsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountTypesAccountsUserListsPatchCall) Context(ctx context.Context) *AccountTypesAccountsUserListsPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountTypesAccountsUserListsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountTypesAccountsUserListsPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.userlist) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userLists.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamanager.accountTypes.accounts.userLists.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *UserList.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *AccountTypesAccountsUserListsPatchCall) Do(opts ...googleapi.CallOption) (*UserList, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &UserList{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "datamanager.accountTypes.accounts.userLists.patch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type AudienceMembersIngestCall struct { s *Service ingestaudiencemembersrequest *IngestAudienceMembersRequest diff --git a/dataplex/v1/dataplex-api.json b/dataplex/v1/dataplex-api.json index 5aedf7f80e..72f67479f2 100644 --- a/dataplex/v1/dataplex-api.json +++ b/dataplex/v1/dataplex-api.json @@ -884,6 +884,68 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "lookupEntryLinks": { + "description": "Looks up Entry Links referencing the specified Entry.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:lookupEntryLinks", + "httpMethod": "GET", + "id": "dataplex.projects.locations.lookupEntryLinks", + "parameterOrder": [ + "name" + ], + "parameters": { + "entry": { + "description": "Required. The resource name of the referred Entry. Format: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}. Entry Links which references this entry will be returned in the response.", + "location": "query", + "type": "string" + }, + "entryLinkTypes": { + "description": "Entry link types to filter the response by. If empty, all entry link types will be returned. At most 10 entry link types can be specified.", + "location": "query", + "repeated": true, + "type": "string" + }, + "entryMode": { + "description": "Mode of entry reference.", + "enum": [ + "ENTRY_MODE_UNSPECIFIED", + "SOURCE", + "TARGET" + ], + "enumDescriptions": [ + "Unspecified entry mode. Returns both directional and non-directional entry links which references the entry.", + "Returns all directed entry links which references the entry as source.", + "Return all directed entry links which references the entry as target." + ], + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The project to which the request should be attributed to Format: projects/{project_id_or_number}/locations/{location_id}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "Maximum number of EntryLinks to return. The service may return fewer than this value. If unspecified, at most 10 EntryLinks will be returned. The maximum value is 10; values above 10 will be coerced to 10.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Page token received from a previous LookupEntryLinks call. Provide this to retrieve the subsequent page. When paginating, all other parameters that are provided to the LookupEntryLinks request must match the call that provided the page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}:lookupEntryLinks", + "response": { + "$ref": "GoogleCloudDataplexV1LookupEntryLinksResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "searchEntries": { "description": "Searches for Entries matching the given query and scope.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:searchEntries", @@ -7869,7 +7931,7 @@ } } }, - "revision": "20260203", + "revision": "20260213", "rootUrl": "https://dataplex.googleapis.com/", "schemas": { "Empty": { @@ -10114,6 +10176,13 @@ "description": "Optional. The unnested column which this rule is evaluated against.", "type": "string" }, + "debugQueries": { + "description": "Optional. Specifies the debug queries for this rule. Currently, only one query is supported, but this may be expanded in the future.", + "items": { + "$ref": "GoogleCloudDataplexV1DataQualityRuleDebugQuery" + }, + "type": "array" + }, "description": { "description": "Optional. Description of the rule. The maximum length is 1,024 characters.", "type": "string" @@ -10178,6 +10247,21 @@ }, "type": "object" }, + "GoogleCloudDataplexV1DataQualityRuleDebugQuery": { + "description": "Specifies a SQL statement that is evaluated to return up to 10 scalar values that are used to debug rules. If the rule fails, the values can help diagnose the cause of the failure.The SQL statement must use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), and must not contain any semicolons.You can use the data reference parameter ${data()} to reference the source table with all of its precondition filters applied. Examples of precondition filters include row filters, incremental data filters, and sampling. For more information, see Data reference parameter (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You can also name results with an explicit alias using [AS] alias. For more information, see BigQuery explicit aliases (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()}", + "id": "GoogleCloudDataplexV1DataQualityRuleDebugQuery", + "properties": { + "description": { + "description": "Optional. Specifies the description of the debug query. The maximum length is 1,024 characters.", + "type": "string" + }, + "sqlStatement": { + "description": "Required. Specifies the SQL statement to be executed.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDataplexV1DataQualityRuleNonNullExpectation": { "description": "Evaluates whether each column value is null.", "id": "GoogleCloudDataplexV1DataQualityRuleNonNullExpectation", @@ -10228,6 +10312,14 @@ "readOnly": true, "type": "string" }, + "debugQueriesResultSets": { + "description": "Output only. Contains the results of all debug queries for this rule. The number of result sets will correspond to the number of debug_queries.", + "items": { + "$ref": "GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResultSet" + }, + "readOnly": true, + "type": "array" + }, "evaluatedCount": { "description": "Output only. The number of rows a rule was evaluated against.This field is only valid for row-level type rules.Evaluated count can be configured to either include all rows (default) - with null rows automatically failing rule evaluation, or exclude null rows from the evaluated_count, by setting ignore_nulls = true.This field is not set for rule SqlAssertion.", "format": "int64", @@ -10270,6 +10362,40 @@ }, "type": "object" }, + "GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResult": { + "description": "Contains a single result from the debug query.", + "id": "GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResult", + "properties": { + "name": { + "description": "Specifies the name of the result. Available if provided with an explicit alias using [AS] alias.", + "type": "string" + }, + "type": { + "description": "Indicates the data type of the result. For more information, see BigQuery data types (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types).", + "type": "string" + }, + "value": { + "description": "Represents the value of the result as a string.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResultSet": { + "description": "Contains all results from a debug query.", + "id": "GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResultSet", + "properties": { + "results": { + "description": "Output only. Contains all results. Up to 10 results can be returned.", + "items": { + "$ref": "GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResult" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudDataplexV1DataQualityRuleRowConditionExpectation": { "description": "Evaluates whether each row passes the specified condition.The SQL expression needs to use GoogleSQL syntax (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax) and should produce a boolean value per row as the result.Example: col1 \u003e= 0 AND col2 \u003c 10", "id": "GoogleCloudDataplexV1DataQualityRuleRowConditionExpectation", @@ -13458,6 +13584,24 @@ }, "type": "object" }, + "GoogleCloudDataplexV1LookupEntryLinksResponse": { + "description": "Response message for LookupEntryLinks.", + "id": "GoogleCloudDataplexV1LookupEntryLinksResponse", + "properties": { + "entryLinks": { + "description": "List of entry links that reference the specified entry.", + "items": { + "$ref": "GoogleCloudDataplexV1EntryLink" + }, + "type": "array" + }, + "nextPageToken": { + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDataplexV1MetadataFeed": { "description": "MetadataFeed contains information related to the metadata feed.", "id": "GoogleCloudDataplexV1MetadataFeed", diff --git a/dataplex/v1/dataplex-gen.go b/dataplex/v1/dataplex-gen.go index b73bdfafe2..226833d238 100644 --- a/dataplex/v1/dataplex-gen.go +++ b/dataplex/v1/dataplex-gen.go @@ -3421,6 +3421,10 @@ func (s GoogleCloudDataplexV1DataQualityResultPostScanActionsResultBigQueryExpor type GoogleCloudDataplexV1DataQualityRule struct { // Column: Optional. The unnested column which this rule is evaluated against. Column string `json:"column,omitempty"` + // DebugQueries: Optional. Specifies the debug queries for this rule. + // Currently, only one query is supported, but this may be expanded in the + // future. + DebugQueries []*GoogleCloudDataplexV1DataQualityRuleDebugQuery `json:"debugQueries,omitempty"` // Description: Optional. Description of the rule. The maximum length is 1,024 // characters. Description string `json:"description,omitempty"` @@ -3503,6 +3507,45 @@ func (s *GoogleCloudDataplexV1DataQualityRule) UnmarshalJSON(data []byte) error return nil } +// GoogleCloudDataplexV1DataQualityRuleDebugQuery: Specifies a SQL statement +// that is evaluated to return up to 10 scalar values that are used to debug +// rules. If the rule fails, the values can help diagnose the cause of the +// failure.The SQL statement must use GoogleSQL syntax +// (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax), +// and must not contain any semicolons.You can use the data reference parameter +// ${data()} to reference the source table with all of its precondition filters +// applied. Examples of precondition filters include row filters, incremental +// data filters, and sampling. For more information, see Data reference +// parameter +// (https://cloud.google.com/dataplex/docs/auto-data-quality-overview#data-reference-parameter).You +// can also name results with an explicit alias using [AS] alias. For more +// information, see BigQuery explicit aliases +// (https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#explicit_alias_syntax).Example: +// SELECT MIN(col1) AS min_col1, MAX(col1) AS max_col1 FROM ${data()} +type GoogleCloudDataplexV1DataQualityRuleDebugQuery struct { + // Description: Optional. Specifies the description of the debug query. The + // maximum length is 1,024 characters. + Description string `json:"description,omitempty"` + // SqlStatement: Required. Specifies the SQL statement to be executed. + SqlStatement string `json:"sqlStatement,omitempty"` + // ForceSendFields is a list of field names (e.g. "Description") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Description") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDataplexV1DataQualityRuleDebugQuery) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDataplexV1DataQualityRuleDebugQuery + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDataplexV1DataQualityRuleNonNullExpectation: Evaluates whether // each column value is null. type GoogleCloudDataplexV1DataQualityRuleNonNullExpectation struct { @@ -3573,6 +3616,10 @@ type GoogleCloudDataplexV1DataQualityRuleResult struct { // statement in a SQL assertion rule.This field is only valid for SQL assertion // rules. AssertionRowCount int64 `json:"assertionRowCount,omitempty,string"` + // DebugQueriesResultSets: Output only. Contains the results of all debug + // queries for this rule. The number of result sets will correspond to the + // number of debug_queries. + DebugQueriesResultSets []*GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResultSet `json:"debugQueriesResultSets,omitempty"` // EvaluatedCount: Output only. The number of rows a rule was evaluated // against.This field is only valid for row-level type rules.Evaluated count // can be configured to either include all rows (default) - with null rows @@ -3629,6 +3676,60 @@ func (s *GoogleCloudDataplexV1DataQualityRuleResult) UnmarshalJSON(data []byte) return nil } +// GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResult: Contains a +// single result from the debug query. +type GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResult struct { + // Name: Specifies the name of the result. Available if provided with an + // explicit alias using [AS] alias. + Name string `json:"name,omitempty"` + // Type: Indicates the data type of the result. For more information, see + // BigQuery data types + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types). + Type string `json:"type,omitempty"` + // Value: Represents the value of the result as a string. + Value string `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Name") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Name") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResultSet: Contains all +// results from a debug query. +type GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResultSet struct { + // Results: Output only. Contains all results. Up to 10 results can be + // returned. + Results []*GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResult `json:"results,omitempty"` + // ForceSendFields is a list of field names (e.g. "Results") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Results") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResultSet) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDataplexV1DataQualityRuleResultDebugQueryResultSet + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDataplexV1DataQualityRuleRowConditionExpectation: Evaluates // whether each row passes the specified condition.The SQL expression needs to // use GoogleSQL syntax @@ -7267,6 +7368,35 @@ func (s GoogleCloudDataplexV1ListZonesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDataplexV1LookupEntryLinksResponse: Response message for +// LookupEntryLinks. +type GoogleCloudDataplexV1LookupEntryLinksResponse struct { + // EntryLinks: List of entry links that reference the specified entry. + EntryLinks []*GoogleCloudDataplexV1EntryLink `json:"entryLinks,omitempty"` + // NextPageToken: Token to retrieve the next page of results, or empty if there + // are no more results in the list. + NextPageToken string `json:"nextPageToken,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "EntryLinks") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "EntryLinks") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDataplexV1LookupEntryLinksResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDataplexV1LookupEntryLinksResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDataplexV1MetadataFeed: MetadataFeed contains information related // to the metadata feed. type GoogleCloudDataplexV1MetadataFeed struct { @@ -11751,6 +11881,194 @@ func (c *ProjectsLocationsLookupEntryCall) Do(opts ...googleapi.CallOption) (*Go return ret, nil } +type ProjectsLocationsLookupEntryLinksCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// LookupEntryLinks: Looks up Entry Links referencing the specified Entry. +// +// - name: The project to which the request should be attributed to Format: +// projects/{project_id_or_number}/locations/{location_id}. +func (r *ProjectsLocationsService) LookupEntryLinks(name string) *ProjectsLocationsLookupEntryLinksCall { + c := &ProjectsLocationsLookupEntryLinksCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Entry sets the optional parameter "entry": Required. The resource name of +// the referred Entry. Format: +// projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_gr +// oup_id}/entries/{entry_id}. Entry Links which references this entry will be +// returned in the response. +func (c *ProjectsLocationsLookupEntryLinksCall) Entry(entry string) *ProjectsLocationsLookupEntryLinksCall { + c.urlParams_.Set("entry", entry) + return c +} + +// EntryLinkTypes sets the optional parameter "entryLinkTypes": Entry link +// types to filter the response by. If empty, all entry link types will be +// returned. At most 10 entry link types can be specified. +func (c *ProjectsLocationsLookupEntryLinksCall) EntryLinkTypes(entryLinkTypes ...string) *ProjectsLocationsLookupEntryLinksCall { + c.urlParams_.SetMulti("entryLinkTypes", append([]string{}, entryLinkTypes...)) + return c +} + +// EntryMode sets the optional parameter "entryMode": Mode of entry reference. +// +// Possible values: +// +// "ENTRY_MODE_UNSPECIFIED" - Unspecified entry mode. Returns both +// +// directional and non-directional entry links which references the entry. +// +// "SOURCE" - Returns all directed entry links which references the entry as +// +// source. +// +// "TARGET" - Return all directed entry links which references the entry as +// +// target. +func (c *ProjectsLocationsLookupEntryLinksCall) EntryMode(entryMode string) *ProjectsLocationsLookupEntryLinksCall { + c.urlParams_.Set("entryMode", entryMode) + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// EntryLinks to return. The service may return fewer than this value. If +// unspecified, at most 10 EntryLinks will be returned. The maximum value is +// 10; values above 10 will be coerced to 10. +func (c *ProjectsLocationsLookupEntryLinksCall) PageSize(pageSize int64) *ProjectsLocationsLookupEntryLinksCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Page token received from +// a previous LookupEntryLinks call. Provide this to retrieve the subsequent +// page. When paginating, all other parameters that are provided to the +// LookupEntryLinks request must match the call that provided the page token. +func (c *ProjectsLocationsLookupEntryLinksCall) PageToken(pageToken string) *ProjectsLocationsLookupEntryLinksCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsLookupEntryLinksCall) Fields(s ...googleapi.Field) *ProjectsLocationsLookupEntryLinksCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsLookupEntryLinksCall) IfNoneMatch(entityTag string) *ProjectsLocationsLookupEntryLinksCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsLookupEntryLinksCall) Context(ctx context.Context) *ProjectsLocationsLookupEntryLinksCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsLookupEntryLinksCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsLookupEntryLinksCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:lookupEntryLinks") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataplex.projects.locations.lookupEntryLinks", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataplex.projects.locations.lookupEntryLinks" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDataplexV1LookupEntryLinksResponse.ServerResponse.Header or (if +// a response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsLookupEntryLinksCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1LookupEntryLinksResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudDataplexV1LookupEntryLinksResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataplex.projects.locations.lookupEntryLinks", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsLookupEntryLinksCall) Pages(ctx context.Context, f func(*GoogleCloudDataplexV1LookupEntryLinksResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + type ProjectsLocationsSearchEntriesCall struct { s *Service name string diff --git a/dialogflow/v2beta1/dialogflow-api.json b/dialogflow/v2beta1/dialogflow-api.json index 5c1f737589..d614495030 100644 --- a/dialogflow/v2beta1/dialogflow-api.json +++ b/dialogflow/v2beta1/dialogflow-api.json @@ -8431,7 +8431,7 @@ } } }, - "revision": "20260119", + "revision": "20260216", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -16463,6 +16463,9 @@ "format": "google-datetime", "readOnly": true, "type": "string" + }, + "useBidiStreaming": { + "type": "boolean" } }, "type": "object" diff --git a/dialogflow/v2beta1/dialogflow-gen.go b/dialogflow/v2beta1/dialogflow-gen.go index f27fa26dc1..cfb6972f8f 100644 --- a/dialogflow/v2beta1/dialogflow-gen.go +++ b/dialogflow/v2beta1/dialogflow-gen.go @@ -9866,6 +9866,7 @@ type GoogleCloudDialogflowV2beta1ConversationProfile struct { TimeZone string `json:"timeZone,omitempty"` TtsConfig *GoogleCloudDialogflowV2beta1SynthesizeSpeechConfig `json:"ttsConfig,omitempty"` UpdateTime string `json:"updateTime,omitempty"` + UseBidiStreaming bool `json:"useBidiStreaming,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` diff --git a/discoveryengine/v1/discoveryengine-api.json b/discoveryengine/v1/discoveryengine-api.json index 3450318271..aea3e5beea 100644 --- a/discoveryengine/v1/discoveryengine-api.json +++ b/discoveryengine/v1/discoveryengine-api.json @@ -4022,7 +4022,94 @@ }, "resources": { "agents": { + "methods": { + "getCard": { + "description": "GetAgentCard returns the agent card for the agent.", + "flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/card", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.engines.assistants.agents.getCard", + "parameterOrder": [ + "tenant" + ], + "parameters": { + "tenant": { + "description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "{+tenant}/card", + "response": { + "$ref": "A2aV1AgentCard" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, "resources": { + "message": { + "methods": { + "send": { + "description": "Send a message to the agent. This is a blocking call that will return the task once it is completed, or a LRO if requested.", + "flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/message:send", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.assistants.agents.message.send", + "parameterOrder": [ + "tenant" + ], + "parameters": { + "tenant": { + "description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "{+tenant}/message:send", + "request": { + "$ref": "A2aV1SendMessageRequest" + }, + "response": { + "$ref": "A2aV1SendMessageResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "stream": { + "description": "SendStreamingMessage is a streaming call that will return a stream of task update events until the Task is in an interrupted or terminal state.", + "flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/message:stream", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.assistants.agents.message.stream", + "parameterOrder": [ + "tenant" + ], + "parameters": { + "tenant": { + "description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "{+tenant}/message:stream", + "request": { + "$ref": "A2aV1SendMessageRequest" + }, + "response": { + "$ref": "A2aV1StreamResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "operations": { "methods": { "get": { @@ -4052,6 +4139,275 @@ ] } } + }, + "tasks": { + "methods": { + "cancel": { + "description": "Cancel a task from the agent. If supported one should expect no more task updates for the task.", + "flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/tasks/{tasksId}:cancel", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.cancel", + "parameterOrder": [ + "tenant", + "name" + ], + "parameters": { + "name": { + "description": "The resource name of the task to cancel. Format: tasks/{task_id}", + "location": "path", + "pattern": "^tasks/[^/]+$", + "required": true, + "type": "string" + }, + "tenant": { + "description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "{+tenant}/{+name}:cancel", + "request": { + "$ref": "A2aV1CancelTaskRequest" + }, + "response": { + "$ref": "A2aV1Task" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Get the current state of a task from the agent.", + "flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/tasks/{tasksId}", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.get", + "parameterOrder": [ + "tenant", + "name" + ], + "parameters": { + "historyLength": { + "description": "The number of most recent messages from the task's history to retrieve.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "name": { + "description": "Required. The resource name of the task. Format: tasks/{task_id}", + "location": "path", + "pattern": "^tasks/[^/]+$", + "required": true, + "type": "string" + }, + "tenant": { + "description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "{+tenant}/{+name}", + "response": { + "$ref": "A2aV1Task" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "subscribe": { + "description": "TaskSubscription is a streaming call that will return a stream of task update events. This attaches the stream to an existing in process task. If the task is complete the stream will return the completed task (like GetTask) and close the stream.", + "flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/tasks/{tasksId}:subscribe", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.subscribe", + "parameterOrder": [ + "tenant", + "name" + ], + "parameters": { + "name": { + "description": "The resource name of the task to subscribe to. Format: tasks/{task_id}", + "location": "path", + "pattern": "^tasks/[^/]+$", + "required": true, + "type": "string" + }, + "tenant": { + "description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "{+tenant}/{+name}:subscribe", + "response": { + "$ref": "A2aV1StreamResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "pushNotificationConfigs": { + "methods": { + "create": { + "description": "Set a push notification config for a task.", + "flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/tasks/{tasksId}/pushNotificationConfigs", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.create", + "parameterOrder": [ + "tenant", + "parent" + ], + "parameters": { + "configId": { + "description": "Required. The ID for the new config.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent task resource for this config. Format: tasks/{task_id}", + "location": "path", + "pattern": "^tasks/[^/]+/pushNotificationConfigs$", + "required": true, + "type": "string" + }, + "tenant": { + "description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "{+tenant}/{+parent}", + "request": { + "$ref": "A2aV1TaskPushNotificationConfig" + }, + "response": { + "$ref": "A2aV1TaskPushNotificationConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Delete a push notification config for a task.", + "flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/tasks/{tasksId}/pushNotificationConfigs/{pushNotificationConfigsId}", + "httpMethod": "DELETE", + "id": "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.delete", + "parameterOrder": [ + "tenant", + "name" + ], + "parameters": { + "name": { + "description": "The resource name of the config to delete. Format: tasks/{task_id}/pushNotificationConfigs/{config_id}", + "location": "path", + "pattern": "^tasks/[^/]+/pushNotificationConfigs/[^/]+$", + "required": true, + "type": "string" + }, + "tenant": { + "description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "{+tenant}/{+name}", + "response": { + "$ref": "GoogleProtobufEmpty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Get a push notification config for a task.", + "flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/tasks/{tasksId}/pushNotificationConfigs/{pushNotificationConfigsId}", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.get", + "parameterOrder": [ + "tenant", + "name" + ], + "parameters": { + "name": { + "description": "The resource name of the config to retrieve. Format: tasks/{task_id}/pushNotificationConfigs/{config_id}", + "location": "path", + "pattern": "^tasks/[^/]+/pushNotificationConfigs/[^/]+$", + "required": true, + "type": "string" + }, + "tenant": { + "description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "{+tenant}/{+name}", + "response": { + "$ref": "A2aV1TaskPushNotificationConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Get a list of push notifications configured for a task.", + "flatPath": "projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/tasks/{tasksId}/pushNotificationConfigs", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.list", + "parameterOrder": [ + "tenant", + "parent" + ], + "parameters": { + "pageSize": { + "description": "For AIP-158 these fields are present. Usually not used/needed. The maximum number of configurations to return. If unspecified, all configs will be returned.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A page token received from a previous ListTaskPushNotificationConfigRequest call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListTaskPushNotificationConfigRequest` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "The parent task resource. Format: tasks/{task_id}", + "location": "path", + "pattern": "^tasks/[^/]+$", + "required": true, + "type": "string" + }, + "tenant": { + "description": "Optional tenant, provided as a path parameter. Experimental, might still change for 1.0 release.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "{+tenant}/{+parent}/pushNotificationConfigs", + "response": { + "$ref": "A2aV1ListTaskPushNotificationConfigResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } } } } @@ -8753,118 +9109,1070 @@ } } }, - "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": "v1/projects/{projectsId}/operations/{operationsId}:cancel", - "httpMethod": "POST", - "id": "discoveryengine.projects.operations.cancel", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "The name of the operation resource to be cancelled.", - "location": "path", - "pattern": "^projects/[^/]+/operations/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+name}:cancel", - "request": { - "$ref": "GoogleLongrunningCancelOperationRequest" - }, - "response": { - "$ref": "GoogleProtobufEmpty" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/discoveryengine.readwrite" - ] - }, - "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": "v1/projects/{projectsId}/operations/{operationsId}", - "httpMethod": "GET", - "id": "discoveryengine.projects.operations.get", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "The name of the operation resource.", - "location": "path", - "pattern": "^projects/[^/]+/operations/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+name}", - "response": { - "$ref": "GoogleLongrunningOperation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/discoveryengine.readwrite" - ] - }, - "list": { - "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", - "flatPath": "v1/projects/{projectsId}/operations", - "httpMethod": "GET", - "id": "discoveryengine.projects.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/[^/]+$", - "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" - }, - "returnPartialSuccess": { - "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", - "location": "query", - "type": "boolean" - } - }, - "path": "v1/{+name}/operations", - "response": { - "$ref": "GoogleLongrunningListOperationsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/discoveryengine.readwrite" - ] - } - } + "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": "v1/projects/{projectsId}/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "discoveryengine.projects.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^projects/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:cancel", + "request": { + "$ref": "GoogleLongrunningCancelOperationRequest" + }, + "response": { + "$ref": "GoogleProtobufEmpty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/discoveryengine.readwrite" + ] + }, + "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": "v1/projects/{projectsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "discoveryengine.projects.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/discoveryengine.readwrite" + ] + }, + "list": { + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", + "flatPath": "v1/projects/{projectsId}/operations", + "httpMethod": "GET", + "id": "discoveryengine.projects.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/[^/]+$", + "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" + }, + "returnPartialSuccess": { + "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}/operations", + "response": { + "$ref": "GoogleLongrunningListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/discoveryengine.readwrite" + ] + } + } + } + } + } + }, + "revision": "20260215", + "rootUrl": "https://discoveryengine.googleapis.com/", + "schemas": { + "A2aV1APIKeySecurityScheme": { + "id": "A2aV1APIKeySecurityScheme", + "properties": { + "description": { + "description": "Description of this security scheme.", + "type": "string" + }, + "location": { + "description": "Location of the API key, valid values are \"query\", \"header\", or \"cookie\"", + "type": "string" + }, + "name": { + "description": "Name of the header, query or cookie parameter to be used.", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1AgentCapabilities": { + "description": "Defines the A2A feature set supported by the agent", + "id": "A2aV1AgentCapabilities", + "properties": { + "extensions": { + "description": "Extensions supported by this agent.", + "items": { + "$ref": "A2aV1AgentExtension" + }, + "type": "array" + }, + "pushNotifications": { + "description": "If the agent can send push notifications to the clients webhook", + "type": "boolean" + }, + "streaming": { + "description": "If the agent will support streaming responses", + "type": "boolean" + } + }, + "type": "object" + }, + "A2aV1AgentCard": { + "description": "AgentCard conveys key information: - Overall details (version, name, description, uses) - Skills; a set of actions/solutions the agent can perform - Default modalities/content types supported by the agent. - Authentication requirements Next ID: 19", + "id": "A2aV1AgentCard", + "properties": { + "additionalInterfaces": { + "description": "Announcement of additional supported transports. Client can use any of the supported transports.", + "items": { + "$ref": "A2aV1AgentInterface" + }, + "type": "array" + }, + "capabilities": { + "$ref": "A2aV1AgentCapabilities", + "description": "A2A Capability set supported by the agent." + }, + "defaultInputModes": { + "description": "protolint:enable REPEATED_FIELD_NAMES_PLURALIZED The set of interaction modes that the agent supports across all skills. This can be overridden per skill. Defined as mime types.", + "items": { + "type": "string" + }, + "type": "array" + }, + "defaultOutputModes": { + "description": "The mime types supported as outputs from this agent.", + "items": { + "type": "string" + }, + "type": "array" + }, + "description": { + "description": "A description of the agent's domain of action/solution space. Example: \"Agent that helps users with recipes and cooking.\"", + "type": "string" + }, + "documentationUrl": { + "description": "A url to provide additional documentation about the agent.", + "type": "string" + }, + "iconUrl": { + "description": "An optional URL to an icon for the agent.", + "type": "string" + }, + "name": { + "description": "A human readable name for the agent. Example: \"Recipe Agent\"", + "type": "string" + }, + "preferredTransport": { + "description": "The transport of the preferred endpoint. If empty, defaults to JSONRPC.", + "type": "string" + }, + "protocolVersion": { + "description": "The version of the A2A protocol this agent supports.", + "type": "string" + }, + "provider": { + "$ref": "A2aV1AgentProvider", + "description": "The service provider of the agent." + }, + "security": { + "description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Security requirements for contacting the agent. This list can be seen as an OR of ANDs. Each object in the list describes one possible set of security requirements that must be present on a request. This allows specifying, for example, \"callers must either use OAuth OR an API Key AND mTLS.\" Example: security { schemes { key: \"oauth\" value { list: [\"read\"] } } } security { schemes { key: \"api-key\" } schemes { key: \"mtls\" } }", + "items": { + "$ref": "A2aV1Security" + }, + "type": "array" + }, + "securitySchemes": { + "additionalProperties": { + "$ref": "A2aV1SecurityScheme" + }, + "description": "The security scheme details used for authenticating with this agent.", + "type": "object" + }, + "signatures": { + "description": "JSON Web Signatures computed for this AgentCard.", + "items": { + "$ref": "A2aV1AgentCardSignature" + }, + "type": "array" + }, + "skills": { + "description": "Skills represent a unit of ability an agent can perform. This may somewhat abstract but represents a more focused set of actions that the agent is highly likely to succeed at.", + "items": { + "$ref": "A2aV1AgentSkill" + }, + "type": "array" + }, + "supportsAuthenticatedExtendedCard": { + "description": "Whether the agent supports providing an extended agent card when the user is authenticated, i.e. is the card from .well-known different than the card from GetAgentCard.", + "type": "boolean" + }, + "url": { + "description": "A URL to the address the agent is hosted at. This represents the preferred endpoint as declared by the agent.", + "type": "string" + }, + "version": { + "description": "The version of the agent. Example: \"1.0.0\"", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1AgentCardSignature": { + "description": "AgentCardSignature represents a JWS signature of an AgentCard. This follows the JSON format of an RFC 7515 JSON Web Signature (JWS).", + "id": "A2aV1AgentCardSignature", + "properties": { + "header": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "The unprotected JWS header values.", + "type": "object" + }, + "protected": { + "description": "Required. The protected JWS header for the signature. This is always a base64url-encoded JSON object. Required.", + "type": "string" + }, + "signature": { + "description": "Required. The computed signature, base64url-encoded. Required.", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1AgentExtension": { + "description": "A declaration of an extension supported by an Agent.", + "id": "A2aV1AgentExtension", + "properties": { + "description": { + "description": "A description of how this agent uses this extension. Example: \"Google OAuth 2.0 authentication\"", + "type": "string" + }, + "params": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional configuration for the extension.", + "type": "object" + }, + "required": { + "description": "Whether the client must follow specific requirements of the extension. Example: false", + "type": "boolean" + }, + "uri": { + "description": "The URI of the extension. Example: \"https://developers.google.com/identity/protocols/oauth2\"", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1AgentInterface": { + "description": "Defines additional transport information for the agent.", + "id": "A2aV1AgentInterface", + "properties": { + "tenant": { + "description": "Tenant to be set in the request when calling the agent. Experimental, might still change for 1.0 release.", + "type": "string" + }, + "transport": { + "description": "The transport supported this url. This is an open form string, to be easily extended for many transport protocols. The core ones officially supported are JSONRPC, GRPC and HTTP+JSON.", + "type": "string" + }, + "url": { + "description": "The url this interface is found at.", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1AgentProvider": { + "description": "Represents information about the service provider of an agent.", + "id": "A2aV1AgentProvider", + "properties": { + "organization": { + "description": "The providers organization name Example: \"Google\"", + "type": "string" + }, + "url": { + "description": "The providers reference url Example: \"https://ai.google.dev\"", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1AgentSkill": { + "description": "AgentSkill represents a unit of action/solution that the agent can perform. One can think of this as a type of highly reliable solution that an agent can be tasked to provide. Agents have the autonomy to choose how and when to use specific skills, but clients should have confidence that if the skill is defined that unit of action can be reliably performed.", + "id": "A2aV1AgentSkill", + "properties": { + "description": { + "description": "A human (or llm) readable description of the skill details and behaviors.", + "type": "string" + }, + "examples": { + "description": "A set of example queries that this skill is designed to address. These examples should help the caller to understand how to craft requests to the agent to achieve specific goals. Example: [\"I need a recipe for bread\"]", + "items": { + "type": "string" + }, + "type": "array" + }, + "id": { + "description": "Unique identifier of the skill within this agent.", + "type": "string" + }, + "inputModes": { + "description": "Possible input modalities supported.", + "items": { + "type": "string" + }, + "type": "array" + }, + "name": { + "description": "A human readable name for the skill.", + "type": "string" + }, + "outputModes": { + "description": "Possible output modalities produced", + "items": { + "type": "string" + }, + "type": "array" + }, + "security": { + "description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Security schemes necessary for the agent to leverage this skill. As in the overall AgentCard.security, this list represents a logical OR of security requirement objects. Each object is a set of security schemes that must be used together (a logical AND). protolint:enable REPEATED_FIELD_NAMES_PLURALIZED", + "items": { + "$ref": "A2aV1Security" + }, + "type": "array" + }, + "tags": { + "description": "A set of tags for the skill to enhance categorization/utilization. Example: [\"cooking\", \"customer support\", \"billing\"]", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "A2aV1Artifact": { + "description": "Artifacts are the container for task completed results. These are similar to Messages but are intended to be the product of a task, as opposed to point-to-point communication.", + "id": "A2aV1Artifact", + "properties": { + "artifactId": { + "description": "Unique identifier (e.g. UUID) for the artifact. It must be at least unique within a task.", + "type": "string" + }, + "description": { + "description": "A human readable description of the artifact, optional.", + "type": "string" + }, + "extensions": { + "description": "The URIs of extensions that are present or contributed to this Artifact.", + "items": { + "type": "string" + }, + "type": "array" + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional metadata included with the artifact.", + "type": "object" + }, + "name": { + "description": "A human readable name for the artifact.", + "type": "string" + }, + "parts": { + "description": "The content of the artifact.", + "items": { + "$ref": "A2aV1Part" + }, + "type": "array" + } + }, + "type": "object" + }, + "A2aV1AuthenticationInfo": { + "description": "Defines authentication details, used for push notifications.", + "id": "A2aV1AuthenticationInfo", + "properties": { + "credentials": { + "description": "Optional credentials", + "type": "string" + }, + "schemes": { + "description": "Supported authentication schemes - e.g. Basic, Bearer, etc", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "A2aV1AuthorizationCodeOAuthFlow": { + "id": "A2aV1AuthorizationCodeOAuthFlow", + "properties": { + "authorizationUrl": { + "description": "The authorization URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS", + "type": "string" + }, + "refreshUrl": { + "description": "The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.", + "type": "string" + }, + "scopes": { + "additionalProperties": { + "type": "string" + }, + "description": "The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.", + "type": "object" + }, + "tokenUrl": { + "description": "The token URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1CancelTaskRequest": { + "id": "A2aV1CancelTaskRequest", + "properties": {}, + "type": "object" + }, + "A2aV1ClientCredentialsOAuthFlow": { + "id": "A2aV1ClientCredentialsOAuthFlow", + "properties": { + "refreshUrl": { + "description": "The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.", + "type": "string" + }, + "scopes": { + "additionalProperties": { + "type": "string" + }, + "description": "The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.", + "type": "object" + }, + "tokenUrl": { + "description": "The token URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1DataPart": { + "description": "DataPart represents a structured blob. This is most commonly a JSON payload.", + "id": "A2aV1DataPart", + "properties": { + "data": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "type": "object" + } + }, + "type": "object" + }, + "A2aV1FilePart": { + "description": "FilePart represents the different ways files can be provided. If files are small, directly feeding the bytes is supported via file_with_bytes. If the file is large, the agent should read the content as appropriate directly from the file_with_uri source.", + "id": "A2aV1FilePart", + "properties": { + "fileWithBytes": { + "format": "byte", + "type": "string" + }, + "fileWithUri": { + "type": "string" + }, + "mimeType": { + "type": "string" + }, + "name": { + "type": "string" + } + }, + "type": "object" + }, + "A2aV1HTTPAuthSecurityScheme": { + "id": "A2aV1HTTPAuthSecurityScheme", + "properties": { + "bearerFormat": { + "description": "A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation purposes.", + "type": "string" + }, + "description": { + "description": "Description of this security scheme.", + "type": "string" + }, + "scheme": { + "description": "The name of the HTTP Authentication scheme to be used in the Authorization header as defined in RFC7235. The values used SHOULD be registered in the IANA Authentication Scheme registry. The value is case-insensitive, as defined in RFC7235.", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1ImplicitOAuthFlow": { + "id": "A2aV1ImplicitOAuthFlow", + "properties": { + "authorizationUrl": { + "description": "The authorization URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS", + "type": "string" + }, + "refreshUrl": { + "description": "The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.", + "type": "string" + }, + "scopes": { + "additionalProperties": { + "type": "string" + }, + "description": "The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.", + "type": "object" + } + }, + "type": "object" + }, + "A2aV1ListTaskPushNotificationConfigResponse": { + "id": "A2aV1ListTaskPushNotificationConfigResponse", + "properties": { + "configs": { + "description": "The list of push notification configurations.", + "items": { + "$ref": "A2aV1TaskPushNotificationConfig" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1Message": { + "description": "Message is one unit of communication between client and server. It is associated with a context and optionally a task. Since the server is responsible for the context definition, it must always provide a context_id in its messages. The client can optionally provide the context_id if it knows the context to associate the message to. Similarly for task_id, except the server decides if a task is created and whether to include the task_id.", + "id": "A2aV1Message", + "properties": { + "content": { + "description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the container of the message content.", + "items": { + "$ref": "A2aV1Part" + }, + "type": "array" + }, + "contextId": { + "description": "The context id of the message. This is optional and if set, the message will be associated with the given context.", + "type": "string" + }, + "extensions": { + "description": "The URIs of extensions that are present or contributed to this Message.", + "items": { + "type": "string" + }, + "type": "array" + }, + "messageId": { + "description": "The unique identifier (e.g. UUID)of the message. This is required and created by the message creator.", + "type": "string" + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional metadata to provide along with the message.", + "type": "object" + }, + "role": { + "description": "A role for the message.", + "enum": [ + "ROLE_UNSPECIFIED", + "ROLE_USER", + "ROLE_AGENT" + ], + "enumDescriptions": [ + "", + "USER role refers to communication from the client to the server.", + "AGENT role refers to communication from the server to the client." + ], + "type": "string" + }, + "taskId": { + "description": "The task id of the message. This is optional and if set, the message will be associated with the given task.", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1MutualTlsSecurityScheme": { + "id": "A2aV1MutualTlsSecurityScheme", + "properties": { + "description": { + "description": "Description of this security scheme.", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1OAuth2SecurityScheme": { + "id": "A2aV1OAuth2SecurityScheme", + "properties": { + "description": { + "description": "Description of this security scheme.", + "type": "string" + }, + "flows": { + "$ref": "A2aV1OAuthFlows", + "description": "An object containing configuration information for the flow types supported" + }, + "oauth2MetadataUrl": { + "description": "URL to the oauth2 authorization server metadata [RFC8414](https://datatracker.ietf.org/doc/html/rfc8414). TLS is required.", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1OAuthFlows": { + "id": "A2aV1OAuthFlows", + "properties": { + "authorizationCode": { + "$ref": "A2aV1AuthorizationCodeOAuthFlow" + }, + "clientCredentials": { + "$ref": "A2aV1ClientCredentialsOAuthFlow" + }, + "implicit": { + "$ref": "A2aV1ImplicitOAuthFlow" + }, + "password": { + "$ref": "A2aV1PasswordOAuthFlow" + } + }, + "type": "object" + }, + "A2aV1OpenIdConnectSecurityScheme": { + "id": "A2aV1OpenIdConnectSecurityScheme", + "properties": { + "description": { + "description": "Description of this security scheme.", + "type": "string" + }, + "openIdConnectUrl": { + "description": "Well-known URL to discover the [[OpenID-Connect-Discovery]] provider metadata.", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1Part": { + "description": "Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).", + "id": "A2aV1Part", + "properties": { + "data": { + "$ref": "A2aV1DataPart" + }, + "file": { + "$ref": "A2aV1FilePart" + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional metadata associated with this part.", + "type": "object" + }, + "text": { + "type": "string" + } + }, + "type": "object" + }, + "A2aV1PasswordOAuthFlow": { + "id": "A2aV1PasswordOAuthFlow", + "properties": { + "refreshUrl": { + "description": "The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.", + "type": "string" + }, + "scopes": { + "additionalProperties": { + "type": "string" + }, + "description": "The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.", + "type": "object" + }, + "tokenUrl": { + "description": "The token URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1PushNotificationConfig": { + "description": "Configuration for setting up push notifications for task updates.", + "id": "A2aV1PushNotificationConfig", + "properties": { + "authentication": { + "$ref": "A2aV1AuthenticationInfo", + "description": "Information about the authentication to sent with the notification" + }, + "id": { + "description": "A unique identifier (e.g. UUID) for this push notification.", + "type": "string" + }, + "token": { + "description": "Token unique for this task/session", + "type": "string" + }, + "url": { + "description": "Url to send the notification too", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1Security": { + "id": "A2aV1Security", + "properties": { + "schemes": { + "additionalProperties": { + "$ref": "A2aV1StringList" + }, + "type": "object" + } + }, + "type": "object" + }, + "A2aV1SecurityScheme": { + "id": "A2aV1SecurityScheme", + "properties": { + "apiKeySecurityScheme": { + "$ref": "A2aV1APIKeySecurityScheme" + }, + "httpAuthSecurityScheme": { + "$ref": "A2aV1HTTPAuthSecurityScheme" + }, + "mtlsSecurityScheme": { + "$ref": "A2aV1MutualTlsSecurityScheme" + }, + "oauth2SecurityScheme": { + "$ref": "A2aV1OAuth2SecurityScheme" + }, + "openIdConnectSecurityScheme": { + "$ref": "A2aV1OpenIdConnectSecurityScheme" + } + }, + "type": "object" + }, + "A2aV1SendMessageConfiguration": { + "description": "Configuration of a send message request.", + "id": "A2aV1SendMessageConfiguration", + "properties": { + "acceptedOutputModes": { + "description": "The output modes that the agent is expected to respond with.", + "items": { + "type": "string" + }, + "type": "array" + }, + "blocking": { + "description": "If true, the message will be blocking until the task is completed. If false, the message will be non-blocking and the task will be returned immediately. It is the caller's responsibility to check for any task updates.", + "type": "boolean" + }, + "historyLength": { + "description": "The maximum number of messages to include in the history. if 0, the history will be unlimited.", + "format": "int32", + "type": "integer" + }, + "pushNotification": { + "$ref": "A2aV1PushNotificationConfig", + "description": "A configuration of a webhook that can be used to receive updates" + } + }, + "type": "object" + }, + "A2aV1SendMessageRequest": { + "description": "/////////// Request Messages ///////////", + "id": "A2aV1SendMessageRequest", + "properties": { + "configuration": { + "$ref": "A2aV1SendMessageConfiguration", + "description": "Configuration for the send request." + }, + "message": { + "$ref": "A2aV1Message", + "description": "Required. The message to send to the agent." + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional metadata for the request.", + "type": "object" } - } - } - }, - "revision": "20260209", - "rootUrl": "https://discoveryengine.googleapis.com/", - "schemas": { + }, + "type": "object" + }, + "A2aV1SendMessageResponse": { + "description": "////// Response Messages ///////////", + "id": "A2aV1SendMessageResponse", + "properties": { + "message": { + "$ref": "A2aV1Message" + }, + "task": { + "$ref": "A2aV1Task" + } + }, + "type": "object" + }, + "A2aV1StreamResponse": { + "description": "The stream response for a message. The stream should be one of the following sequences: If the response is a message, the stream should contain one, and only one, message and then close If the response is a task lifecycle, the first response should be a Task object followed by zero or more TaskStatusUpdateEvents and TaskArtifactUpdateEvents. The stream should complete when the Task if in an interrupted or terminal state. A stream that ends before these conditions are met are", + "id": "A2aV1StreamResponse", + "properties": { + "artifactUpdate": { + "$ref": "A2aV1TaskArtifactUpdateEvent" + }, + "message": { + "$ref": "A2aV1Message" + }, + "statusUpdate": { + "$ref": "A2aV1TaskStatusUpdateEvent" + }, + "task": { + "$ref": "A2aV1Task" + } + }, + "type": "object" + }, + "A2aV1StringList": { + "description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED", + "id": "A2aV1StringList", + "properties": { + "list": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "A2aV1Task": { + "description": "Task is the core unit of action for A2A. It has a current status and when results are created for the task they are stored in the artifact. If there are multiple turns for a task, these are stored in history.", + "id": "A2aV1Task", + "properties": { + "artifacts": { + "description": "A set of output artifacts for a Task.", + "items": { + "$ref": "A2aV1Artifact" + }, + "type": "array" + }, + "contextId": { + "description": "Unique identifier (e.g. UUID) for the contextual collection of interactions (tasks and messages). Created by the A2A server.", + "type": "string" + }, + "history": { + "description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED The history of interactions from a task.", + "items": { + "$ref": "A2aV1Message" + }, + "type": "array" + }, + "id": { + "description": "Unique identifier (e.g. UUID) for the task, generated by the server for a new task.", + "type": "string" + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "protolint:enable REPEATED_FIELD_NAMES_PLURALIZED A key/value object to store custom metadata about a task.", + "type": "object" + }, + "status": { + "$ref": "A2aV1TaskStatus", + "description": "The current status of a Task, including state and a message." + } + }, + "type": "object" + }, + "A2aV1TaskArtifactUpdateEvent": { + "description": "TaskArtifactUpdateEvent represents a task delta where an artifact has been generated.", + "id": "A2aV1TaskArtifactUpdateEvent", + "properties": { + "append": { + "description": "Whether this should be appended to a prior one produced", + "type": "boolean" + }, + "artifact": { + "$ref": "A2aV1Artifact", + "description": "The artifact itself" + }, + "contextId": { + "description": "The id of the context that this task belongs too", + "type": "string" + }, + "lastChunk": { + "description": "Whether this represents the last part of an artifact", + "type": "boolean" + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional metadata associated with the artifact update.", + "type": "object" + }, + "taskId": { + "description": "The id of the task for this artifact", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1TaskPushNotificationConfig": { + "id": "A2aV1TaskPushNotificationConfig", + "properties": { + "name": { + "description": "The resource name of the config. Format: tasks/{task_id}/pushNotificationConfigs/{config_id}", + "type": "string" + }, + "pushNotificationConfig": { + "$ref": "A2aV1PushNotificationConfig", + "description": "The push notification configuration details." + } + }, + "type": "object" + }, + "A2aV1TaskStatus": { + "description": "A container for the status of a task", + "id": "A2aV1TaskStatus", + "properties": { + "message": { + "$ref": "A2aV1Message", + "description": "A message associated with the status." + }, + "state": { + "description": "The current state of this task", + "enum": [ + "TASK_STATE_UNSPECIFIED", + "TASK_STATE_SUBMITTED", + "TASK_STATE_WORKING", + "TASK_STATE_COMPLETED", + "TASK_STATE_FAILED", + "TASK_STATE_CANCELLED", + "TASK_STATE_INPUT_REQUIRED", + "TASK_STATE_REJECTED", + "TASK_STATE_AUTH_REQUIRED" + ], + "enumDescriptions": [ + "", + "Represents the status that acknowledges a task is created", + "Represents the status that a task is actively being processed", + "Represents the status a task is finished. This is a terminal state", + "Represents the status a task is done but failed. This is a terminal state", + "Represents the status a task was cancelled before it finished. This is a terminal state.", + "Represents the status that the task requires information to complete. This is an interrupted state.", + "Represents the status that the agent has decided to not perform the task. This may be done during initial task creation or later once an agent has determined it can't or won't proceed. This is a terminal state.", + "Represents the state that some authentication is needed from the upstream client. Authentication is expected to come out-of-band thus this is not an interrupted or terminal state." + ], + "type": "string" + }, + "timestamp": { + "description": "Timestamp when the status was recorded. Example: \"2023-10-27T10:00:00Z\"", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "A2aV1TaskStatusUpdateEvent": { + "description": "TaskStatusUpdateEvent is a delta even on a task indicating that a task has changed.", + "id": "A2aV1TaskStatusUpdateEvent", + "properties": { + "contextId": { + "description": "The id of the context that the task belongs to", + "type": "string" + }, + "final": { + "description": "Whether this is the last status update expected for this task.", + "type": "boolean" + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional metadata to associate with the task update.", + "type": "object" + }, + "status": { + "$ref": "A2aV1TaskStatus", + "description": "The new status of the task." + }, + "taskId": { + "description": "The id of the task that is changed", + "type": "string" + } + }, + "type": "object" + }, "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", @@ -13244,7 +14552,8 @@ "THIRD_PARTY_EUA", "GCNV", "GOOGLE_CHAT", - "GOOGLE_SITES" + "GOOGLE_SITES", + "REMOTE_MCP" ], "enumDescriptions": [ "Default value.", @@ -13260,7 +14569,8 @@ "Connector utilized for End User Authentication features.", "Google Cloud NetApp Volumes connector.", "Google Chat connector.", - "Google Sites connector." + "Google Sites connector.", + "Remote MCP based connector." ], "readOnly": true, "type": "string" @@ -14455,6 +15765,13 @@ ], "type": "string" }, + "connectorTenantInfo": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", + "type": "object" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -15703,13 +17020,15 @@ "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", - "SUBSCRIPTION_TERM_THREE_YEARS" + "SUBSCRIPTION_TERM_THREE_YEARS", + "SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", - "3 years." + "3 years.", + "Custom term. Must set the end_date." ], "type": "string" }, @@ -22541,7 +23860,8 @@ "THIRD_PARTY_EUA", "GCNV", "GOOGLE_CHAT", - "GOOGLE_SITES" + "GOOGLE_SITES", + "REMOTE_MCP" ], "enumDescriptions": [ "Default value.", @@ -22557,7 +23877,8 @@ "Connector utilized for End User Authentication features.", "Google Cloud NetApp Volumes connector.", "Google Chat connector.", - "Google Sites connector." + "Google Sites connector.", + "Remote MCP based connector." ], "readOnly": true, "type": "string" @@ -23660,6 +24981,13 @@ ], "type": "string" }, + "connectorTenantInfo": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", + "type": "object" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -24956,13 +26284,15 @@ "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", - "SUBSCRIPTION_TERM_THREE_YEARS" + "SUBSCRIPTION_TERM_THREE_YEARS", + "SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", - "3 years." + "3 years.", + "Custom term. Must set the end_date." ], "type": "string" }, @@ -26162,7 +27492,7 @@ "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "numResultsPerDataStore": { - "description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit.", + "description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit.", "format": "int32", "type": "integer" }, @@ -28832,6 +30162,13 @@ ], "type": "string" }, + "connectorTenantInfo": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", + "type": "object" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -29795,13 +31132,15 @@ "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", - "SUBSCRIPTION_TERM_THREE_YEARS" + "SUBSCRIPTION_TERM_THREE_YEARS", + "SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", - "3 years." + "3 years.", + "Custom term. Must set the end_date." ], "type": "string" }, @@ -30432,7 +31771,7 @@ "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "numResultsPerDataStore": { - "description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit.", + "description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit.", "format": "int32", "type": "integer" }, diff --git a/discoveryengine/v1/discoveryengine-gen.go b/discoveryengine/v1/discoveryengine-gen.go index e4fdbef980..fc4d9a61e2 100644 --- a/discoveryengine/v1/discoveryengine-gen.go +++ b/discoveryengine/v1/discoveryengine-gen.go @@ -628,14 +628,29 @@ type ProjectsLocationsCollectionsEnginesAssistantsService struct { func NewProjectsLocationsCollectionsEnginesAssistantsAgentsService(s *Service) *ProjectsLocationsCollectionsEnginesAssistantsAgentsService { rs := &ProjectsLocationsCollectionsEnginesAssistantsAgentsService{s: s} + rs.Message = NewProjectsLocationsCollectionsEnginesAssistantsAgentsMessageService(s) rs.Operations = NewProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsService(s) + rs.Tasks = NewProjectsLocationsCollectionsEnginesAssistantsAgentsTasksService(s) return rs } type ProjectsLocationsCollectionsEnginesAssistantsAgentsService struct { s *Service + Message *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageService + Operations *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsService + + Tasks *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksService +} + +func NewProjectsLocationsCollectionsEnginesAssistantsAgentsMessageService(s *Service) *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageService { + rs := &ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageService{s: s} + return rs +} + +type ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageService struct { + s *Service } func NewProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsService(s *Service) *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsService { @@ -647,6 +662,27 @@ type ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsService struct s *Service } +func NewProjectsLocationsCollectionsEnginesAssistantsAgentsTasksService(s *Service) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksService { + rs := &ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksService{s: s} + rs.PushNotificationConfigs = NewProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsService(s) + return rs +} + +type ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksService struct { + s *Service + + PushNotificationConfigs *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsService +} + +func NewProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsService(s *Service) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsService { + rs := &ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsService{s: s} + return rs +} + +type ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsService struct { + s *Service +} + func NewProjectsLocationsCollectionsEnginesCompletionConfigService(s *Service) *ProjectsLocationsCollectionsEnginesCompletionConfigService { rs := &ProjectsLocationsCollectionsEnginesCompletionConfigService{s: s} return rs @@ -1109,586 +1145,1736 @@ type ProjectsOperationsService struct { s *Service } -// GoogleApiDistribution: `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. -type GoogleApiDistribution struct { - // BucketCounts: 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). - BucketCounts googleapi.Int64s `json:"bucketCounts,omitempty"` - // BucketOptions: Defines the histogram bucket boundaries. If the distribution - // does not contain a histogram, then omit this field. - BucketOptions *GoogleApiDistributionBucketOptions `json:"bucketOptions,omitempty"` - // Count: 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. - Count int64 `json:"count,omitempty,string"` - // Exemplars: Must be in increasing order of `value` field. - Exemplars []*GoogleApiDistributionExemplar `json:"exemplars,omitempty"` - // Mean: The arithmetic mean of the values in the population. If `count` is - // zero then this field must be zero. - Mean float64 `json:"mean,omitempty"` - // Range: If specified, contains the range of the population values. The field - // must not be present if the `count` is zero. - Range *GoogleApiDistributionRange `json:"range,omitempty"` - // SumOfSquaredDeviation: The sum of squared deviations from the mean of the - // values in the population. For values x_i this is: Sumi=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. - SumOfSquaredDeviation float64 `json:"sumOfSquaredDeviation,omitempty"` - // ForceSendFields is a list of field names (e.g. "BucketCounts") to +type A2aV1APIKeySecurityScheme struct { + // Description: Description of this security scheme. + Description string `json:"description,omitempty"` + // Location: Location of the API key, valid values are "query", "header", or + // "cookie" + Location string `json:"location,omitempty"` + // Name: Name of the header, query or cookie parameter to be used. + Name string `json:"name,omitempty"` + // ForceSendFields is a list of field names (e.g. "Description") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BucketCounts") to include in API + // NullFields is a list of field names (e.g. "Description") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s GoogleApiDistribution) MarshalJSON() ([]byte, error) { - type NoMethod GoogleApiDistribution +func (s A2aV1APIKeySecurityScheme) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1APIKeySecurityScheme return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -func (s *GoogleApiDistribution) UnmarshalJSON(data []byte) error { - type NoMethod GoogleApiDistribution - var s1 struct { - Mean gensupport.JSONFloat64 `json:"mean"` - SumOfSquaredDeviation gensupport.JSONFloat64 `json:"sumOfSquaredDeviation"` - *NoMethod - } - s1.NoMethod = (*NoMethod)(s) - if err := json.Unmarshal(data, &s1); err != nil { - return err - } - s.Mean = float64(s1.Mean) - s.SumOfSquaredDeviation = float64(s1.SumOfSquaredDeviation) - return nil +// A2aV1AgentCapabilities: Defines the A2A feature set supported by the agent +type A2aV1AgentCapabilities struct { + // Extensions: Extensions supported by this agent. + Extensions []*A2aV1AgentExtension `json:"extensions,omitempty"` + // PushNotifications: If the agent can send push notifications to the clients + // webhook + PushNotifications bool `json:"pushNotifications,omitempty"` + // Streaming: If the agent will support streaming responses + Streaming bool `json:"streaming,omitempty"` + // ForceSendFields is a list of field names (e.g. "Extensions") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Extensions") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` } -// GoogleApiDistributionBucketOptions: `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. -type GoogleApiDistributionBucketOptions struct { - // ExplicitBuckets: The explicit buckets. - ExplicitBuckets *GoogleApiDistributionBucketOptionsExplicit `json:"explicitBuckets,omitempty"` - // ExponentialBuckets: The exponential buckets. - ExponentialBuckets *GoogleApiDistributionBucketOptionsExponential `json:"exponentialBuckets,omitempty"` - // LinearBuckets: The linear bucket. - LinearBuckets *GoogleApiDistributionBucketOptionsLinear `json:"linearBuckets,omitempty"` - // ForceSendFields is a list of field names (e.g. "ExplicitBuckets") to +func (s A2aV1AgentCapabilities) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1AgentCapabilities + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// A2aV1AgentCard: AgentCard conveys key information: - Overall details +// (version, name, description, uses) - Skills; a set of actions/solutions the +// agent can perform - Default modalities/content types supported by the agent. +// - Authentication requirements Next ID: 19 +type A2aV1AgentCard struct { + // AdditionalInterfaces: Announcement of additional supported transports. + // Client can use any of the supported transports. + AdditionalInterfaces []*A2aV1AgentInterface `json:"additionalInterfaces,omitempty"` + // Capabilities: A2A Capability set supported by the agent. + Capabilities *A2aV1AgentCapabilities `json:"capabilities,omitempty"` + // DefaultInputModes: protolint:enable REPEATED_FIELD_NAMES_PLURALIZED The set + // of interaction modes that the agent supports across all skills. This can be + // overridden per skill. Defined as mime types. + DefaultInputModes []string `json:"defaultInputModes,omitempty"` + // DefaultOutputModes: The mime types supported as outputs from this agent. + DefaultOutputModes []string `json:"defaultOutputModes,omitempty"` + // Description: A description of the agent's domain of action/solution space. + // Example: "Agent that helps users with recipes and cooking." + Description string `json:"description,omitempty"` + // DocumentationUrl: A url to provide additional documentation about the agent. + DocumentationUrl string `json:"documentationUrl,omitempty"` + // IconUrl: An optional URL to an icon for the agent. + IconUrl string `json:"iconUrl,omitempty"` + // Name: A human readable name for the agent. Example: "Recipe Agent" + Name string `json:"name,omitempty"` + // PreferredTransport: The transport of the preferred endpoint. If empty, + // defaults to JSONRPC. + PreferredTransport string `json:"preferredTransport,omitempty"` + // ProtocolVersion: The version of the A2A protocol this agent supports. + ProtocolVersion string `json:"protocolVersion,omitempty"` + // Provider: The service provider of the agent. + Provider *A2aV1AgentProvider `json:"provider,omitempty"` + // Security: protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Security + // requirements for contacting the agent. This list can be seen as an OR of + // ANDs. Each object in the list describes one possible set of security + // requirements that must be present on a request. This allows specifying, for + // example, "callers must either use OAuth OR an API Key AND mTLS." Example: + // security { schemes { key: "oauth" value { list: ["read"] } } } security { + // schemes { key: "api-key" } schemes { key: "mtls" } } + Security []*A2aV1Security `json:"security,omitempty"` + // SecuritySchemes: The security scheme details used for authenticating with + // this agent. + SecuritySchemes map[string]A2aV1SecurityScheme `json:"securitySchemes,omitempty"` + // Signatures: JSON Web Signatures computed for this AgentCard. + Signatures []*A2aV1AgentCardSignature `json:"signatures,omitempty"` + // Skills: Skills represent a unit of ability an agent can perform. This may + // somewhat abstract but represents a more focused set of actions that the + // agent is highly likely to succeed at. + Skills []*A2aV1AgentSkill `json:"skills,omitempty"` + // SupportsAuthenticatedExtendedCard: Whether the agent supports providing an + // extended agent card when the user is authenticated, i.e. is the card from + // .well-known different than the card from GetAgentCard. + SupportsAuthenticatedExtendedCard bool `json:"supportsAuthenticatedExtendedCard,omitempty"` + // Url: A URL to the address the agent is hosted at. This represents the + // preferred endpoint as declared by the agent. + Url string `json:"url,omitempty"` + // Version: The version of the agent. Example: "1.0.0" + Version string `json:"version,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "AdditionalInterfaces") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ExplicitBuckets") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See + // NullFields is a list of field names (e.g. "AdditionalInterfaces") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s GoogleApiDistributionBucketOptions) MarshalJSON() ([]byte, error) { - type NoMethod GoogleApiDistributionBucketOptions +func (s A2aV1AgentCard) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1AgentCard return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleApiDistributionBucketOptionsExplicit: 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. -type GoogleApiDistributionBucketOptionsExplicit struct { - // Bounds: The values must be monotonically increasing. - Bounds []float64 `json:"bounds,omitempty"` - // ForceSendFields is a list of field names (e.g. "Bounds") to unconditionally +// A2aV1AgentCardSignature: AgentCardSignature represents a JWS signature of an +// AgentCard. This follows the JSON format of an RFC 7515 JSON Web Signature +// (JWS). +type A2aV1AgentCardSignature struct { + // Header: The unprotected JWS header values. + Header googleapi.RawMessage `json:"header,omitempty"` + // Protected: Required. The protected JWS header for the signature. This is + // always a base64url-encoded JSON object. Required. + Protected string `json:"protected,omitempty"` + // Signature: Required. The computed signature, base64url-encoded. Required. + Signature string `json:"signature,omitempty"` + // ForceSendFields is a list of field names (e.g. "Header") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Bounds") to include in API + // NullFields is a list of field names (e.g. "Header") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s GoogleApiDistributionBucketOptionsExplicit) MarshalJSON() ([]byte, error) { - type NoMethod GoogleApiDistributionBucketOptionsExplicit +func (s A2aV1AgentCardSignature) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1AgentCardSignature return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -func (s *GoogleApiDistributionBucketOptionsExplicit) UnmarshalJSON(data []byte) error { - type NoMethod GoogleApiDistributionBucketOptionsExplicit - var s1 struct { - Bounds []gensupport.JSONFloat64 `json:"bounds"` - *NoMethod - } - s1.NoMethod = (*NoMethod)(s) - if err := json.Unmarshal(data, &s1); err != nil { - return err - } - s.Bounds = make([]float64, len(s1.Bounds)) - for i := range s1.Bounds { - s.Bounds[i] = float64(s1.Bounds[i]) - } - return nil -} - -// GoogleApiDistributionBucketOptionsExponential: 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)). -type GoogleApiDistributionBucketOptionsExponential struct { - // GrowthFactor: Must be greater than 1. - GrowthFactor float64 `json:"growthFactor,omitempty"` - // NumFiniteBuckets: Must be greater than 0. - NumFiniteBuckets int64 `json:"numFiniteBuckets,omitempty"` - // Scale: Must be greater than 0. - Scale float64 `json:"scale,omitempty"` - // ForceSendFields is a list of field names (e.g. "GrowthFactor") to +// A2aV1AgentExtension: A declaration of an extension supported by an Agent. +type A2aV1AgentExtension struct { + // Description: A description of how this agent uses this extension. Example: + // "Google OAuth 2.0 authentication" + Description string `json:"description,omitempty"` + // Params: Optional configuration for the extension. + Params googleapi.RawMessage `json:"params,omitempty"` + // Required: Whether the client must follow specific requirements of the + // extension. Example: false + Required bool `json:"required,omitempty"` + // Uri: The URI of the extension. Example: + // "https://developers.google.com/identity/protocols/oauth2" + Uri string `json:"uri,omitempty"` + // ForceSendFields is a list of field names (e.g. "Description") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "GrowthFactor") to include in API + // NullFields is a list of field names (e.g. "Description") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s GoogleApiDistributionBucketOptionsExponential) MarshalJSON() ([]byte, error) { - type NoMethod GoogleApiDistributionBucketOptionsExponential +func (s A2aV1AgentExtension) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1AgentExtension return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -func (s *GoogleApiDistributionBucketOptionsExponential) UnmarshalJSON(data []byte) error { - type NoMethod GoogleApiDistributionBucketOptionsExponential - var s1 struct { - GrowthFactor gensupport.JSONFloat64 `json:"growthFactor"` - Scale gensupport.JSONFloat64 `json:"scale"` - *NoMethod - } - s1.NoMethod = (*NoMethod)(s) - if err := json.Unmarshal(data, &s1); err != nil { - return err - } - s.GrowthFactor = float64(s1.GrowthFactor) - s.Scale = float64(s1.Scale) - return nil +// A2aV1AgentInterface: Defines additional transport information for the agent. +type A2aV1AgentInterface struct { + // Tenant: Tenant to be set in the request when calling the agent. + // Experimental, might still change for 1.0 release. + Tenant string `json:"tenant,omitempty"` + // Transport: The transport supported this url. This is an open form string, to + // be easily extended for many transport protocols. The core ones officially + // supported are JSONRPC, GRPC and HTTP+JSON. + Transport string `json:"transport,omitempty"` + // Url: The url this interface is found at. + Url string `json:"url,omitempty"` + // ForceSendFields is a list of field names (e.g. "Tenant") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Tenant") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` } -// GoogleApiDistributionBucketOptionsLinear: 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)). -type GoogleApiDistributionBucketOptionsLinear struct { - // NumFiniteBuckets: Must be greater than 0. - NumFiniteBuckets int64 `json:"numFiniteBuckets,omitempty"` - // Offset: Lower bound of the first bucket. - Offset float64 `json:"offset,omitempty"` - // Width: Must be greater than 0. - Width float64 `json:"width,omitempty"` - // ForceSendFields is a list of field names (e.g. "NumFiniteBuckets") to +func (s A2aV1AgentInterface) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1AgentInterface + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// A2aV1AgentProvider: Represents information about the service provider of an +// agent. +type A2aV1AgentProvider struct { + // Organization: The providers organization name Example: "Google" + Organization string `json:"organization,omitempty"` + // Url: The providers reference url Example: "https://ai.google.dev" + Url string `json:"url,omitempty"` + // ForceSendFields is a list of field names (e.g. "Organization") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "NumFiniteBuckets") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See + // NullFields is a list of field names (e.g. "Organization") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s GoogleApiDistributionBucketOptionsLinear) MarshalJSON() ([]byte, error) { - type NoMethod GoogleApiDistributionBucketOptionsLinear +func (s A2aV1AgentProvider) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1AgentProvider return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -func (s *GoogleApiDistributionBucketOptionsLinear) UnmarshalJSON(data []byte) error { - type NoMethod GoogleApiDistributionBucketOptionsLinear - var s1 struct { - Offset gensupport.JSONFloat64 `json:"offset"` - Width gensupport.JSONFloat64 `json:"width"` - *NoMethod - } - s1.NoMethod = (*NoMethod)(s) - if err := json.Unmarshal(data, &s1); err != nil { - return err - } - s.Offset = float64(s1.Offset) - s.Width = float64(s1.Width) - return nil -} - -// GoogleApiDistributionExemplar: 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. -type GoogleApiDistributionExemplar struct { - // Attachments: 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. - Attachments []googleapi.RawMessage `json:"attachments,omitempty"` - // Timestamp: The observation (sampling) time of the above value. - Timestamp string `json:"timestamp,omitempty"` - // Value: Value of the exemplar point. This value determines to which bucket - // the exemplar belongs. - Value float64 `json:"value,omitempty"` - // ForceSendFields is a list of field names (e.g. "Attachments") to +// A2aV1AgentSkill: AgentSkill represents a unit of action/solution that the +// agent can perform. One can think of this as a type of highly reliable +// solution that an agent can be tasked to provide. Agents have the autonomy to +// choose how and when to use specific skills, but clients should have +// confidence that if the skill is defined that unit of action can be reliably +// performed. +type A2aV1AgentSkill struct { + // Description: A human (or llm) readable description of the skill details and + // behaviors. + Description string `json:"description,omitempty"` + // Examples: A set of example queries that this skill is designed to address. + // These examples should help the caller to understand how to craft requests to + // the agent to achieve specific goals. Example: ["I need a recipe for bread"] + Examples []string `json:"examples,omitempty"` + // Id: Unique identifier of the skill within this agent. + Id string `json:"id,omitempty"` + // InputModes: Possible input modalities supported. + InputModes []string `json:"inputModes,omitempty"` + // Name: A human readable name for the skill. + Name string `json:"name,omitempty"` + // OutputModes: Possible output modalities produced + OutputModes []string `json:"outputModes,omitempty"` + // Security: protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Security schemes + // necessary for the agent to leverage this skill. As in the overall + // AgentCard.security, this list represents a logical OR of security + // requirement objects. Each object is a set of security schemes that must be + // used together (a logical AND). protolint:enable + // REPEATED_FIELD_NAMES_PLURALIZED + Security []*A2aV1Security `json:"security,omitempty"` + // Tags: A set of tags for the skill to enhance categorization/utilization. + // Example: ["cooking", "customer support", "billing"] + Tags []string `json:"tags,omitempty"` + // ForceSendFields is a list of field names (e.g. "Description") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Attachments") to include in API + // NullFields is a list of field names (e.g. "Description") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s GoogleApiDistributionExemplar) MarshalJSON() ([]byte, error) { - type NoMethod GoogleApiDistributionExemplar +func (s A2aV1AgentSkill) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1AgentSkill return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -func (s *GoogleApiDistributionExemplar) UnmarshalJSON(data []byte) error { - type NoMethod GoogleApiDistributionExemplar - var s1 struct { - Value gensupport.JSONFloat64 `json:"value"` - *NoMethod - } - s1.NoMethod = (*NoMethod)(s) - if err := json.Unmarshal(data, &s1); err != nil { - return err - } - s.Value = float64(s1.Value) - return nil -} - -// GoogleApiDistributionRange: The range of the population values. -type GoogleApiDistributionRange struct { - // Max: The maximum of the population values. - Max float64 `json:"max,omitempty"` - // Min: The minimum of the population values. - Min float64 `json:"min,omitempty"` - // ForceSendFields is a list of field names (e.g. "Max") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See +// A2aV1Artifact: Artifacts are the container for task completed results. These +// are similar to Messages but are intended to be the product of a task, as +// opposed to point-to-point communication. +type A2aV1Artifact struct { + // ArtifactId: Unique identifier (e.g. UUID) for the artifact. It must be at + // least unique within a task. + ArtifactId string `json:"artifactId,omitempty"` + // Description: A human readable description of the artifact, optional. + Description string `json:"description,omitempty"` + // Extensions: The URIs of extensions that are present or contributed to this + // Artifact. + Extensions []string `json:"extensions,omitempty"` + // Metadata: Optional metadata included with the artifact. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + // Name: A human readable name for the artifact. + Name string `json:"name,omitempty"` + // Parts: The content of the artifact. + Parts []*A2aV1Part `json:"parts,omitempty"` + // ForceSendFields is a list of field names (e.g. "ArtifactId") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Max") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See + // NullFields is a list of field names (e.g. "ArtifactId") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s GoogleApiDistributionRange) MarshalJSON() ([]byte, error) { - type NoMethod GoogleApiDistributionRange +func (s A2aV1Artifact) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1Artifact return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -func (s *GoogleApiDistributionRange) UnmarshalJSON(data []byte) error { - type NoMethod GoogleApiDistributionRange - var s1 struct { - Max gensupport.JSONFloat64 `json:"max"` - Min gensupport.JSONFloat64 `json:"min"` - *NoMethod - } - s1.NoMethod = (*NoMethod)(s) - if err := json.Unmarshal(data, &s1); err != nil { - return err - } - s.Max = float64(s1.Max) - s.Min = float64(s1.Min) - return nil +// A2aV1AuthenticationInfo: Defines authentication details, used for push +// notifications. +type A2aV1AuthenticationInfo struct { + // Credentials: Optional credentials + Credentials string `json:"credentials,omitempty"` + // Schemes: Supported authentication schemes - e.g. Basic, Bearer, etc + Schemes []string `json:"schemes,omitempty"` + // ForceSendFields is a list of field names (e.g. "Credentials") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Credentials") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` } -// GoogleApiHttpBody: 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. -type GoogleApiHttpBody struct { - // ContentType: The HTTP Content-Type header value specifying the content type - // of the body. - ContentType string `json:"contentType,omitempty"` - // Data: The HTTP request/response body as raw binary. - Data string `json:"data,omitempty"` - // Extensions: Application specific response metadata. Must be set in the first - // response for streaming APIs. - Extensions []googleapi.RawMessage `json:"extensions,omitempty"` +func (s A2aV1AuthenticationInfo) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1AuthenticationInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "ContentType") to +type A2aV1AuthorizationCodeOAuthFlow struct { + // AuthorizationUrl: The authorization URL to be used for this flow. This MUST + // be in the form of a URL. The OAuth2 standard requires the use of TLS + AuthorizationUrl string `json:"authorizationUrl,omitempty"` + // RefreshUrl: The URL to be used for obtaining refresh tokens. This MUST be in + // the form of a URL. The OAuth2 standard requires the use of TLS. + RefreshUrl string `json:"refreshUrl,omitempty"` + // Scopes: The available scopes for the OAuth2 security scheme. A map between + // the scope name and a short description for it. The map MAY be empty. + Scopes map[string]string `json:"scopes,omitempty"` + // TokenUrl: The token URL to be used for this flow. This MUST be in the form + // of a URL. The OAuth2 standard requires the use of TLS. + TokenUrl string `json:"tokenUrl,omitempty"` + // ForceSendFields is a list of field names (e.g. "AuthorizationUrl") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ContentType") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See + // NullFields is a list of field names (e.g. "AuthorizationUrl") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s GoogleApiHttpBody) MarshalJSON() ([]byte, error) { - type NoMethod GoogleApiHttpBody +func (s A2aV1AuthorizationCodeOAuthFlow) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1AuthorizationCodeOAuthFlow return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleApiMetric: A specific metric, identified by specifying values for all -// of the labels of a `MetricDescriptor`. -type GoogleApiMetric struct { - // Labels: The set of label values that uniquely identify this metric. All - // labels listed in the `MetricDescriptor` must be assigned values. - Labels map[string]string `json:"labels,omitempty"` - // Type: An existing metric type, see google.api.MetricDescriptor. For example, - // `custom.googleapis.com/invoice/paid/amount`. - Type string `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Labels") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See +type A2aV1CancelTaskRequest struct { +} + +type A2aV1ClientCredentialsOAuthFlow struct { + // RefreshUrl: The URL to be used for obtaining refresh tokens. This MUST be in + // the form of a URL. The OAuth2 standard requires the use of TLS. + RefreshUrl string `json:"refreshUrl,omitempty"` + // Scopes: The available scopes for the OAuth2 security scheme. A map between + // the scope name and a short description for it. The map MAY be empty. + Scopes map[string]string `json:"scopes,omitempty"` + // TokenUrl: The token URL to be used for this flow. This MUST be in the form + // of a URL. The OAuth2 standard requires the use of TLS. + TokenUrl string `json:"tokenUrl,omitempty"` + // ForceSendFields is a list of field names (e.g. "RefreshUrl") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Labels") to include in API + // NullFields is a list of field names (e.g. "RefreshUrl") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s GoogleApiMetric) MarshalJSON() ([]byte, error) { - type NoMethod GoogleApiMetric +func (s A2aV1ClientCredentialsOAuthFlow) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1ClientCredentialsOAuthFlow return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleApiMonitoredResource: 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" }} -type GoogleApiMonitoredResource struct { - // Labels: 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". - Labels map[string]string `json:"labels,omitempty"` - // Type: 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 `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Labels") to unconditionally +// A2aV1DataPart: DataPart represents a structured blob. This is most commonly +// a JSON payload. +type A2aV1DataPart struct { + Data googleapi.RawMessage `json:"data,omitempty"` + // ForceSendFields is a list of field names (e.g. "Data") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Labels") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See + // NullFields is a list of field names (e.g. "Data") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s GoogleApiMonitoredResource) MarshalJSON() ([]byte, error) { - type NoMethod GoogleApiMonitoredResource +func (s A2aV1DataPart) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1DataPart return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleApiMonitoredResourceMetadata: 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. -type GoogleApiMonitoredResourceMetadata struct { - // SystemLabels: 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 } - SystemLabels googleapi.RawMessage `json:"systemLabels,omitempty"` - // UserLabels: Output only. A map of user-defined metadata labels. - UserLabels map[string]string `json:"userLabels,omitempty"` - // ForceSendFields is a list of field names (e.g. "SystemLabels") to +// A2aV1FilePart: FilePart represents the different ways files can be provided. +// If files are small, directly feeding the bytes is supported via +// file_with_bytes. If the file is large, the agent should read the content as +// appropriate directly from the file_with_uri source. +type A2aV1FilePart struct { + FileWithBytes string `json:"fileWithBytes,omitempty"` + FileWithUri string `json:"fileWithUri,omitempty"` + MimeType string `json:"mimeType,omitempty"` + Name string `json:"name,omitempty"` + // ForceSendFields is a list of field names (e.g. "FileWithBytes") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "SystemLabels") to include in API + // NullFields is a list of field names (e.g. "FileWithBytes") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s GoogleApiMonitoredResourceMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleApiMonitoredResourceMetadata +func (s A2aV1FilePart) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1FilePart return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineLoggingConnectorRunErrorContext: The error payload -// that is populated on LRO sync APIs, including the following: * -// `google.cloud.discoveryengine.v1main.DataConnectorService.SetUpDataConnector` -// -// * -// -// `google.cloud.discoveryengine.v1main.DataConnectorService.StartConnectorRun` -type GoogleCloudDiscoveryengineLoggingConnectorRunErrorContext struct { - // ConnectorRun: The full resource name of the Connector Run. Format: - // `projects/*/locations/*/collections/*/dataConnector/connectorRuns/*`. The - // `connector_run_id` is system-generated. - ConnectorRun string `json:"connectorRun,omitempty"` - // DataConnector: The full resource name of the DataConnector. Format: - // `projects/*/locations/*/collections/*/dataConnector`. - DataConnector string `json:"dataConnector,omitempty"` - // EndTime: The time when the connector run ended. - EndTime string `json:"endTime,omitempty"` - // Entity: The entity to sync for the connector run. - Entity string `json:"entity,omitempty"` - // Operation: The operation resource name of the LRO to sync the connector. - Operation string `json:"operation,omitempty"` - // StartTime: The time when the connector run started. - StartTime string `json:"startTime,omitempty"` - // SyncType: The type of sync run. Can be one of the following: * `FULL` * - // `INCREMENTAL` - SyncType string `json:"syncType,omitempty"` - // ForceSendFields is a list of field names (e.g. "ConnectorRun") to +type A2aV1HTTPAuthSecurityScheme struct { + // BearerFormat: A hint to the client to identify how the bearer token is + // formatted. Bearer tokens are usually generated by an authorization server, + // so this information is primarily for documentation purposes. + BearerFormat string `json:"bearerFormat,omitempty"` + // Description: Description of this security scheme. + Description string `json:"description,omitempty"` + // Scheme: The name of the HTTP Authentication scheme to be used in the + // Authorization header as defined in RFC7235. The values used SHOULD be + // registered in the IANA Authentication Scheme registry. The value is + // case-insensitive, as defined in RFC7235. + Scheme string `json:"scheme,omitempty"` + // ForceSendFields is a list of field names (e.g. "BearerFormat") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ConnectorRun") to include in API + // NullFields is a list of field names (e.g. "BearerFormat") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s GoogleCloudDiscoveryengineLoggingConnectorRunErrorContext) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDiscoveryengineLoggingConnectorRunErrorContext +func (s A2aV1HTTPAuthSecurityScheme) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1HTTPAuthSecurityScheme return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineLoggingErrorContext: A description of the context -// in which an error occurred. -type GoogleCloudDiscoveryengineLoggingErrorContext struct { - // HttpRequest: The HTTP request which was processed when the error was - // triggered. - HttpRequest *GoogleCloudDiscoveryengineLoggingHttpRequestContext `json:"httpRequest,omitempty"` - // ReportLocation: The location in the source code where the decision was made - // to report the error, usually the place where it was logged. - ReportLocation *GoogleCloudDiscoveryengineLoggingSourceLocation `json:"reportLocation,omitempty"` - // ForceSendFields is a list of field names (e.g. "HttpRequest") to +type A2aV1ImplicitOAuthFlow struct { + // AuthorizationUrl: The authorization URL to be used for this flow. This MUST + // be in the form of a URL. The OAuth2 standard requires the use of TLS + AuthorizationUrl string `json:"authorizationUrl,omitempty"` + // RefreshUrl: The URL to be used for obtaining refresh tokens. This MUST be in + // the form of a URL. The OAuth2 standard requires the use of TLS. + RefreshUrl string `json:"refreshUrl,omitempty"` + // Scopes: The available scopes for the OAuth2 security scheme. A map between + // the scope name and a short description for it. The map MAY be empty. + Scopes map[string]string `json:"scopes,omitempty"` + // ForceSendFields is a list of field names (e.g. "AuthorizationUrl") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "HttpRequest") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See + // NullFields is a list of field names (e.g. "AuthorizationUrl") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s GoogleCloudDiscoveryengineLoggingErrorContext) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDiscoveryengineLoggingErrorContext +func (s A2aV1ImplicitOAuthFlow) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1ImplicitOAuthFlow return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineLoggingErrorLog: An error log which is reported to -// the Error Reporting system. -type GoogleCloudDiscoveryengineLoggingErrorLog struct { - // ConnectorRunPayload: The error payload that is populated on LRO connector - // sync APIs. - ConnectorRunPayload *GoogleCloudDiscoveryengineLoggingConnectorRunErrorContext `json:"connectorRunPayload,omitempty"` - // Context: A description of the context in which the error occurred. - Context *GoogleCloudDiscoveryengineLoggingErrorContext `json:"context,omitempty"` - // ImportPayload: The error payload that is populated on LRO import APIs. - ImportPayload *GoogleCloudDiscoveryengineLoggingImportErrorContext `json:"importPayload,omitempty"` - // Message: A message describing the error. - Message string `json:"message,omitempty"` +type A2aV1ListTaskPushNotificationConfigResponse struct { + // Configs: The list of push notification configurations. + Configs []*A2aV1TaskPushNotificationConfig `json:"configs,omitempty"` + // NextPageToken: A token, which can be sent as `page_token` to retrieve the + // next page. If this field is omitted, there are no subsequent pages. + NextPageToken string `json:"nextPageToken,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Configs") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Configs") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1ListTaskPushNotificationConfigResponse) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1ListTaskPushNotificationConfigResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// A2aV1Message: Message is one unit of communication between client and +// server. It is associated with a context and optionally a task. Since the +// server is responsible for the context definition, it must always provide a +// context_id in its messages. The client can optionally provide the context_id +// if it knows the context to associate the message to. Similarly for task_id, +// except the server decides if a task is created and whether to include the +// task_id. +type A2aV1Message struct { + // Content: protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content is the + // container of the message content. + Content []*A2aV1Part `json:"content,omitempty"` + // ContextId: The context id of the message. This is optional and if set, the + // message will be associated with the given context. + ContextId string `json:"contextId,omitempty"` + // Extensions: The URIs of extensions that are present or contributed to this + // Message. + Extensions []string `json:"extensions,omitempty"` + // MessageId: The unique identifier (e.g. UUID)of the message. This is required + // and created by the message creator. + MessageId string `json:"messageId,omitempty"` + // Metadata: protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Any optional + // metadata to provide along with the message. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + // Role: A role for the message. + // + // Possible values: + // "ROLE_UNSPECIFIED" + // "ROLE_USER" - USER role refers to communication from the client to the + // server. + // "ROLE_AGENT" - AGENT role refers to communication from the server to the + // client. + Role string `json:"role,omitempty"` + // TaskId: The task id of the message. This is optional and if set, the message + // will be associated with the given task. + TaskId string `json:"taskId,omitempty"` + // ForceSendFields is a list of field names (e.g. "Content") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Content") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1Message) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1Message + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type A2aV1MutualTlsSecurityScheme struct { + // Description: Description of this security scheme. + Description string `json:"description,omitempty"` + // ForceSendFields is a list of field names (e.g. "Description") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Description") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1MutualTlsSecurityScheme) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1MutualTlsSecurityScheme + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type A2aV1OAuth2SecurityScheme struct { + // Description: Description of this security scheme. + Description string `json:"description,omitempty"` + // Flows: An object containing configuration information for the flow types + // supported + Flows *A2aV1OAuthFlows `json:"flows,omitempty"` + // Oauth2MetadataUrl: URL to the oauth2 authorization server metadata RFC8414 + // (https://datatracker.ietf.org/doc/html/rfc8414). TLS is required. + Oauth2MetadataUrl string `json:"oauth2MetadataUrl,omitempty"` + // ForceSendFields is a list of field names (e.g. "Description") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Description") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1OAuth2SecurityScheme) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1OAuth2SecurityScheme + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type A2aV1OAuthFlows struct { + AuthorizationCode *A2aV1AuthorizationCodeOAuthFlow `json:"authorizationCode,omitempty"` + ClientCredentials *A2aV1ClientCredentialsOAuthFlow `json:"clientCredentials,omitempty"` + Implicit *A2aV1ImplicitOAuthFlow `json:"implicit,omitempty"` + Password *A2aV1PasswordOAuthFlow `json:"password,omitempty"` + // ForceSendFields is a list of field names (e.g. "AuthorizationCode") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AuthorizationCode") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1OAuthFlows) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1OAuthFlows + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type A2aV1OpenIdConnectSecurityScheme struct { + // Description: Description of this security scheme. + Description string `json:"description,omitempty"` + // OpenIdConnectUrl: Well-known URL to discover the + // [[OpenID-Connect-Discovery]] provider metadata. + OpenIdConnectUrl string `json:"openIdConnectUrl,omitempty"` + // ForceSendFields is a list of field names (e.g. "Description") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Description") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1OpenIdConnectSecurityScheme) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1OpenIdConnectSecurityScheme + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// A2aV1Part: Part represents a container for a section of communication +// content. Parts can be purely textual, some sort of file (image, video, etc) +// or a structured data blob (i.e. JSON). +type A2aV1Part struct { + Data *A2aV1DataPart `json:"data,omitempty"` + File *A2aV1FilePart `json:"file,omitempty"` + // Metadata: Optional metadata associated with this part. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + Text string `json:"text,omitempty"` + // ForceSendFields is a list of field names (e.g. "Data") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Data") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1Part) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1Part + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type A2aV1PasswordOAuthFlow struct { + // RefreshUrl: The URL to be used for obtaining refresh tokens. This MUST be in + // the form of a URL. The OAuth2 standard requires the use of TLS. + RefreshUrl string `json:"refreshUrl,omitempty"` + // Scopes: The available scopes for the OAuth2 security scheme. A map between + // the scope name and a short description for it. The map MAY be empty. + Scopes map[string]string `json:"scopes,omitempty"` + // TokenUrl: The token URL to be used for this flow. This MUST be in the form + // of a URL. The OAuth2 standard requires the use of TLS. + TokenUrl string `json:"tokenUrl,omitempty"` + // ForceSendFields is a list of field names (e.g. "RefreshUrl") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "RefreshUrl") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1PasswordOAuthFlow) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1PasswordOAuthFlow + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// A2aV1PushNotificationConfig: Configuration for setting up push notifications +// for task updates. +type A2aV1PushNotificationConfig struct { + // Authentication: Information about the authentication to sent with the + // notification + Authentication *A2aV1AuthenticationInfo `json:"authentication,omitempty"` + // Id: A unique identifier (e.g. UUID) for this push notification. + Id string `json:"id,omitempty"` + // Token: Token unique for this task/session + Token string `json:"token,omitempty"` + // Url: Url to send the notification too + Url string `json:"url,omitempty"` + // ForceSendFields is a list of field names (e.g. "Authentication") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Authentication") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1PushNotificationConfig) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1PushNotificationConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type A2aV1Security struct { + Schemes map[string]A2aV1StringList `json:"schemes,omitempty"` + // ForceSendFields is a list of field names (e.g. "Schemes") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Schemes") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1Security) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1Security + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type A2aV1SecurityScheme struct { + ApiKeySecurityScheme *A2aV1APIKeySecurityScheme `json:"apiKeySecurityScheme,omitempty"` + HttpAuthSecurityScheme *A2aV1HTTPAuthSecurityScheme `json:"httpAuthSecurityScheme,omitempty"` + MtlsSecurityScheme *A2aV1MutualTlsSecurityScheme `json:"mtlsSecurityScheme,omitempty"` + Oauth2SecurityScheme *A2aV1OAuth2SecurityScheme `json:"oauth2SecurityScheme,omitempty"` + OpenIdConnectSecurityScheme *A2aV1OpenIdConnectSecurityScheme `json:"openIdConnectSecurityScheme,omitempty"` + // ForceSendFields is a list of field names (e.g. "ApiKeySecurityScheme") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ApiKeySecurityScheme") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1SecurityScheme) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1SecurityScheme + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// A2aV1SendMessageConfiguration: Configuration of a send message request. +type A2aV1SendMessageConfiguration struct { + // AcceptedOutputModes: The output modes that the agent is expected to respond + // with. + AcceptedOutputModes []string `json:"acceptedOutputModes,omitempty"` + // Blocking: If true, the message will be blocking until the task is completed. + // If false, the message will be non-blocking and the task will be returned + // immediately. It is the caller's responsibility to check for any task + // updates. + Blocking bool `json:"blocking,omitempty"` + // HistoryLength: The maximum number of messages to include in the history. if + // 0, the history will be unlimited. + HistoryLength int64 `json:"historyLength,omitempty"` + // PushNotification: A configuration of a webhook that can be used to receive + // updates + PushNotification *A2aV1PushNotificationConfig `json:"pushNotification,omitempty"` + // ForceSendFields is a list of field names (e.g. "AcceptedOutputModes") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AcceptedOutputModes") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1SendMessageConfiguration) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1SendMessageConfiguration + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// A2aV1SendMessageRequest: /////////// Request Messages /////////// +type A2aV1SendMessageRequest struct { + // Configuration: Configuration for the send request. + Configuration *A2aV1SendMessageConfiguration `json:"configuration,omitempty"` + // Message: Required. The message to send to the agent. + Message *A2aV1Message `json:"message,omitempty"` + // Metadata: Optional metadata for the request. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + // ForceSendFields is a list of field names (e.g. "Configuration") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Configuration") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1SendMessageRequest) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1SendMessageRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// A2aV1SendMessageResponse: ////// Response Messages /////////// +type A2aV1SendMessageResponse struct { + Message *A2aV1Message `json:"message,omitempty"` + Task *A2aV1Task `json:"task,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Message") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Message") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1SendMessageResponse) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1SendMessageResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// A2aV1StreamResponse: The stream response for a message. The stream should be +// one of the following sequences: If the response is a message, the stream +// should contain one, and only one, message and then close If the response is +// a task lifecycle, the first response should be a Task object followed by +// zero or more TaskStatusUpdateEvents and TaskArtifactUpdateEvents. The stream +// should complete when the Task if in an interrupted or terminal state. A +// stream that ends before these conditions are met are +type A2aV1StreamResponse struct { + ArtifactUpdate *A2aV1TaskArtifactUpdateEvent `json:"artifactUpdate,omitempty"` + Message *A2aV1Message `json:"message,omitempty"` + StatusUpdate *A2aV1TaskStatusUpdateEvent `json:"statusUpdate,omitempty"` + Task *A2aV1Task `json:"task,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "ArtifactUpdate") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ArtifactUpdate") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1StreamResponse) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1StreamResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// A2aV1StringList: protolint:disable REPEATED_FIELD_NAMES_PLURALIZED +type A2aV1StringList struct { + List []string `json:"list,omitempty"` + // ForceSendFields is a list of field names (e.g. "List") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "List") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1StringList) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1StringList + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// A2aV1Task: Task is the core unit of action for A2A. It has a current status +// and when results are created for the task they are stored in the artifact. +// If there are multiple turns for a task, these are stored in history. +type A2aV1Task struct { + // Artifacts: A set of output artifacts for a Task. + Artifacts []*A2aV1Artifact `json:"artifacts,omitempty"` + // ContextId: Unique identifier (e.g. UUID) for the contextual collection of + // interactions (tasks and messages). Created by the A2A server. + ContextId string `json:"contextId,omitempty"` + // History: protolint:disable REPEATED_FIELD_NAMES_PLURALIZED The history of + // interactions from a task. + History []*A2aV1Message `json:"history,omitempty"` + // Id: Unique identifier (e.g. UUID) for the task, generated by the server for + // a new task. + Id string `json:"id,omitempty"` + // Metadata: protolint:enable REPEATED_FIELD_NAMES_PLURALIZED A key/value + // object to store custom metadata about a task. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + // Status: The current status of a Task, including state and a message. + Status *A2aV1TaskStatus `json:"status,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Artifacts") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Artifacts") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1Task) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1Task + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// A2aV1TaskArtifactUpdateEvent: TaskArtifactUpdateEvent represents a task +// delta where an artifact has been generated. +type A2aV1TaskArtifactUpdateEvent struct { + // Append: Whether this should be appended to a prior one produced + Append bool `json:"append,omitempty"` + // Artifact: The artifact itself + Artifact *A2aV1Artifact `json:"artifact,omitempty"` + // ContextId: The id of the context that this task belongs too + ContextId string `json:"contextId,omitempty"` + // LastChunk: Whether this represents the last part of an artifact + LastChunk bool `json:"lastChunk,omitempty"` + // Metadata: Optional metadata associated with the artifact update. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + // TaskId: The id of the task for this artifact + TaskId string `json:"taskId,omitempty"` + // ForceSendFields is a list of field names (e.g. "Append") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Append") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1TaskArtifactUpdateEvent) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1TaskArtifactUpdateEvent + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type A2aV1TaskPushNotificationConfig struct { + // Name: The resource name of the config. Format: + // tasks/{task_id}/pushNotificationConfigs/{config_id} + Name string `json:"name,omitempty"` + // PushNotificationConfig: The push notification configuration details. + PushNotificationConfig *A2aV1PushNotificationConfig `json:"pushNotificationConfig,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Name") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Name") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1TaskPushNotificationConfig) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1TaskPushNotificationConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// A2aV1TaskStatus: A container for the status of a task +type A2aV1TaskStatus struct { + // Message: A message associated with the status. + Message *A2aV1Message `json:"message,omitempty"` + // State: The current state of this task + // + // Possible values: + // "TASK_STATE_UNSPECIFIED" + // "TASK_STATE_SUBMITTED" - Represents the status that acknowledges a task is + // created + // "TASK_STATE_WORKING" - Represents the status that a task is actively being + // processed + // "TASK_STATE_COMPLETED" - Represents the status a task is finished. This is + // a terminal state + // "TASK_STATE_FAILED" - Represents the status a task is done but failed. + // This is a terminal state + // "TASK_STATE_CANCELLED" - Represents the status a task was cancelled before + // it finished. This is a terminal state. + // "TASK_STATE_INPUT_REQUIRED" - Represents the status that the task requires + // information to complete. This is an interrupted state. + // "TASK_STATE_REJECTED" - Represents the status that the agent has decided + // to not perform the task. This may be done during initial task creation or + // later once an agent has determined it can't or won't proceed. This is a + // terminal state. + // "TASK_STATE_AUTH_REQUIRED" - Represents the state that some authentication + // is needed from the upstream client. Authentication is expected to come + // out-of-band thus this is not an interrupted or terminal state. + State string `json:"state,omitempty"` + // Timestamp: Timestamp when the status was recorded. Example: + // "2023-10-27T10:00:00Z" + Timestamp string `json:"timestamp,omitempty"` + // ForceSendFields is a list of field names (e.g. "Message") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Message") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1TaskStatus) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1TaskStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// A2aV1TaskStatusUpdateEvent: TaskStatusUpdateEvent is a delta even on a task +// indicating that a task has changed. +type A2aV1TaskStatusUpdateEvent struct { + // ContextId: The id of the context that the task belongs to + ContextId string `json:"contextId,omitempty"` + // Final: Whether this is the last status update expected for this task. + Final bool `json:"final,omitempty"` + // Metadata: Optional metadata to associate with the task update. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + // Status: The new status of the task. + Status *A2aV1TaskStatus `json:"status,omitempty"` + // TaskId: The id of the task that is changed + TaskId string `json:"taskId,omitempty"` + // ForceSendFields is a list of field names (e.g. "ContextId") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ContextId") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s A2aV1TaskStatusUpdateEvent) MarshalJSON() ([]byte, error) { + type NoMethod A2aV1TaskStatusUpdateEvent + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleApiDistribution: `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. +type GoogleApiDistribution struct { + // BucketCounts: 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). + BucketCounts googleapi.Int64s `json:"bucketCounts,omitempty"` + // BucketOptions: Defines the histogram bucket boundaries. If the distribution + // does not contain a histogram, then omit this field. + BucketOptions *GoogleApiDistributionBucketOptions `json:"bucketOptions,omitempty"` + // Count: 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. + Count int64 `json:"count,omitempty,string"` + // Exemplars: Must be in increasing order of `value` field. + Exemplars []*GoogleApiDistributionExemplar `json:"exemplars,omitempty"` + // Mean: The arithmetic mean of the values in the population. If `count` is + // zero then this field must be zero. + Mean float64 `json:"mean,omitempty"` + // Range: If specified, contains the range of the population values. The field + // must not be present if the `count` is zero. + Range *GoogleApiDistributionRange `json:"range,omitempty"` + // SumOfSquaredDeviation: The sum of squared deviations from the mean of the + // values in the population. For values x_i this is: Sumi=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. + SumOfSquaredDeviation float64 `json:"sumOfSquaredDeviation,omitempty"` + // ForceSendFields is a list of field names (e.g. "BucketCounts") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BucketCounts") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistribution) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistribution + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistribution) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistribution + var s1 struct { + Mean gensupport.JSONFloat64 `json:"mean"` + SumOfSquaredDeviation gensupport.JSONFloat64 `json:"sumOfSquaredDeviation"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Mean = float64(s1.Mean) + s.SumOfSquaredDeviation = float64(s1.SumOfSquaredDeviation) + return nil +} + +// GoogleApiDistributionBucketOptions: `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. +type GoogleApiDistributionBucketOptions struct { + // ExplicitBuckets: The explicit buckets. + ExplicitBuckets *GoogleApiDistributionBucketOptionsExplicit `json:"explicitBuckets,omitempty"` + // ExponentialBuckets: The exponential buckets. + ExponentialBuckets *GoogleApiDistributionBucketOptionsExponential `json:"exponentialBuckets,omitempty"` + // LinearBuckets: The linear bucket. + LinearBuckets *GoogleApiDistributionBucketOptionsLinear `json:"linearBuckets,omitempty"` + // ForceSendFields is a list of field names (e.g. "ExplicitBuckets") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ExplicitBuckets") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionBucketOptions) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionBucketOptions + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleApiDistributionBucketOptionsExplicit: 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. +type GoogleApiDistributionBucketOptionsExplicit struct { + // Bounds: The values must be monotonically increasing. + Bounds []float64 `json:"bounds,omitempty"` + // ForceSendFields is a list of field names (e.g. "Bounds") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Bounds") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionBucketOptionsExplicit) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionBucketOptionsExplicit + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistributionBucketOptionsExplicit) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistributionBucketOptionsExplicit + var s1 struct { + Bounds []gensupport.JSONFloat64 `json:"bounds"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Bounds = make([]float64, len(s1.Bounds)) + for i := range s1.Bounds { + s.Bounds[i] = float64(s1.Bounds[i]) + } + return nil +} + +// GoogleApiDistributionBucketOptionsExponential: 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)). +type GoogleApiDistributionBucketOptionsExponential struct { + // GrowthFactor: Must be greater than 1. + GrowthFactor float64 `json:"growthFactor,omitempty"` + // NumFiniteBuckets: Must be greater than 0. + NumFiniteBuckets int64 `json:"numFiniteBuckets,omitempty"` + // Scale: Must be greater than 0. + Scale float64 `json:"scale,omitempty"` + // ForceSendFields is a list of field names (e.g. "GrowthFactor") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "GrowthFactor") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionBucketOptionsExponential) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionBucketOptionsExponential + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistributionBucketOptionsExponential) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistributionBucketOptionsExponential + var s1 struct { + GrowthFactor gensupport.JSONFloat64 `json:"growthFactor"` + Scale gensupport.JSONFloat64 `json:"scale"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.GrowthFactor = float64(s1.GrowthFactor) + s.Scale = float64(s1.Scale) + return nil +} + +// GoogleApiDistributionBucketOptionsLinear: 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)). +type GoogleApiDistributionBucketOptionsLinear struct { + // NumFiniteBuckets: Must be greater than 0. + NumFiniteBuckets int64 `json:"numFiniteBuckets,omitempty"` + // Offset: Lower bound of the first bucket. + Offset float64 `json:"offset,omitempty"` + // Width: Must be greater than 0. + Width float64 `json:"width,omitempty"` + // ForceSendFields is a list of field names (e.g. "NumFiniteBuckets") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "NumFiniteBuckets") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionBucketOptionsLinear) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionBucketOptionsLinear + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistributionBucketOptionsLinear) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistributionBucketOptionsLinear + var s1 struct { + Offset gensupport.JSONFloat64 `json:"offset"` + Width gensupport.JSONFloat64 `json:"width"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Offset = float64(s1.Offset) + s.Width = float64(s1.Width) + return nil +} + +// GoogleApiDistributionExemplar: 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. +type GoogleApiDistributionExemplar struct { + // Attachments: 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. + Attachments []googleapi.RawMessage `json:"attachments,omitempty"` + // Timestamp: The observation (sampling) time of the above value. + Timestamp string `json:"timestamp,omitempty"` + // Value: Value of the exemplar point. This value determines to which bucket + // the exemplar belongs. + Value float64 `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Attachments") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Attachments") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionExemplar) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionExemplar + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistributionExemplar) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistributionExemplar + var s1 struct { + Value gensupport.JSONFloat64 `json:"value"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Value = float64(s1.Value) + return nil +} + +// GoogleApiDistributionRange: The range of the population values. +type GoogleApiDistributionRange struct { + // Max: The maximum of the population values. + Max float64 `json:"max,omitempty"` + // Min: The minimum of the population values. + Min float64 `json:"min,omitempty"` + // ForceSendFields is a list of field names (e.g. "Max") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Max") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionRange) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionRange + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistributionRange) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistributionRange + var s1 struct { + Max gensupport.JSONFloat64 `json:"max"` + Min gensupport.JSONFloat64 `json:"min"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Max = float64(s1.Max) + s.Min = float64(s1.Min) + return nil +} + +// GoogleApiHttpBody: 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. +type GoogleApiHttpBody struct { + // ContentType: The HTTP Content-Type header value specifying the content type + // of the body. + ContentType string `json:"contentType,omitempty"` + // Data: The HTTP request/response body as raw binary. + Data string `json:"data,omitempty"` + // Extensions: Application specific response metadata. Must be set in the first + // response for streaming APIs. + Extensions []googleapi.RawMessage `json:"extensions,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "ContentType") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ContentType") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiHttpBody) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiHttpBody + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleApiMetric: A specific metric, identified by specifying values for all +// of the labels of a `MetricDescriptor`. +type GoogleApiMetric struct { + // Labels: The set of label values that uniquely identify this metric. All + // labels listed in the `MetricDescriptor` must be assigned values. + Labels map[string]string `json:"labels,omitempty"` + // Type: An existing metric type, see google.api.MetricDescriptor. For example, + // `custom.googleapis.com/invoice/paid/amount`. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "Labels") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Labels") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiMetric) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiMetric + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleApiMonitoredResource: 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" }} +type GoogleApiMonitoredResource struct { + // Labels: 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". + Labels map[string]string `json:"labels,omitempty"` + // Type: 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 `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "Labels") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Labels") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiMonitoredResource) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiMonitoredResource + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleApiMonitoredResourceMetadata: 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. +type GoogleApiMonitoredResourceMetadata struct { + // SystemLabels: 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 } + SystemLabels googleapi.RawMessage `json:"systemLabels,omitempty"` + // UserLabels: Output only. A map of user-defined metadata labels. + UserLabels map[string]string `json:"userLabels,omitempty"` + // ForceSendFields is a list of field names (e.g. "SystemLabels") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "SystemLabels") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiMonitoredResourceMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiMonitoredResourceMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineLoggingConnectorRunErrorContext: The error payload +// that is populated on LRO sync APIs, including the following: * +// `google.cloud.discoveryengine.v1main.DataConnectorService.SetUpDataConnector` +// +// * +// +// `google.cloud.discoveryengine.v1main.DataConnectorService.StartConnectorRun` +type GoogleCloudDiscoveryengineLoggingConnectorRunErrorContext struct { + // ConnectorRun: The full resource name of the Connector Run. Format: + // `projects/*/locations/*/collections/*/dataConnector/connectorRuns/*`. The + // `connector_run_id` is system-generated. + ConnectorRun string `json:"connectorRun,omitempty"` + // DataConnector: The full resource name of the DataConnector. Format: + // `projects/*/locations/*/collections/*/dataConnector`. + DataConnector string `json:"dataConnector,omitempty"` + // EndTime: The time when the connector run ended. + EndTime string `json:"endTime,omitempty"` + // Entity: The entity to sync for the connector run. + Entity string `json:"entity,omitempty"` + // Operation: The operation resource name of the LRO to sync the connector. + Operation string `json:"operation,omitempty"` + // StartTime: The time when the connector run started. + StartTime string `json:"startTime,omitempty"` + // SyncType: The type of sync run. Can be one of the following: * `FULL` * + // `INCREMENTAL` + SyncType string `json:"syncType,omitempty"` + // ForceSendFields is a list of field names (e.g. "ConnectorRun") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ConnectorRun") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineLoggingConnectorRunErrorContext) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineLoggingConnectorRunErrorContext + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineLoggingErrorContext: A description of the context +// in which an error occurred. +type GoogleCloudDiscoveryengineLoggingErrorContext struct { + // HttpRequest: The HTTP request which was processed when the error was + // triggered. + HttpRequest *GoogleCloudDiscoveryengineLoggingHttpRequestContext `json:"httpRequest,omitempty"` + // ReportLocation: The location in the source code where the decision was made + // to report the error, usually the place where it was logged. + ReportLocation *GoogleCloudDiscoveryengineLoggingSourceLocation `json:"reportLocation,omitempty"` + // ForceSendFields is a list of field names (e.g. "HttpRequest") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "HttpRequest") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineLoggingErrorContext) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineLoggingErrorContext + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineLoggingErrorLog: An error log which is reported to +// the Error Reporting system. +type GoogleCloudDiscoveryengineLoggingErrorLog struct { + // ConnectorRunPayload: The error payload that is populated on LRO connector + // sync APIs. + ConnectorRunPayload *GoogleCloudDiscoveryengineLoggingConnectorRunErrorContext `json:"connectorRunPayload,omitempty"` + // Context: A description of the context in which the error occurred. + Context *GoogleCloudDiscoveryengineLoggingErrorContext `json:"context,omitempty"` + // ImportPayload: The error payload that is populated on LRO import APIs. + ImportPayload *GoogleCloudDiscoveryengineLoggingImportErrorContext `json:"importPayload,omitempty"` + // Message: A message describing the error. + Message string `json:"message,omitempty"` // RequestPayload: The API request payload, represented as a protocol buffer. // Most API request types are supported—for example: * // `type.googleapis.com/google.cloud.discoveryengine.v1alpha.DocumentService.Cre @@ -7185,6 +8371,7 @@ type GoogleCloudDiscoveryengineV1DataConnector struct { // "GCNV" - Google Cloud NetApp Volumes connector. // "GOOGLE_CHAT" - Google Chat connector. // "GOOGLE_SITES" - Google Sites connector. + // "REMOTE_MCP" - Remote MCP based connector. ConnectorType string `json:"connectorType,omitempty"` // CreateEuaSaas: Optional. Whether the END USER AUTHENTICATION connector is // created in SaaS. @@ -8620,6 +9807,10 @@ type GoogleCloudDiscoveryengineV1Engine struct { // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows // configurations specified by customer. ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` + // ConnectorTenantInfo: Optional. Maps a connector ID (e.g., "hybrid-github", + // "shopify") to tenant-specific information required for that connector. The + // structure of the tenant information string is connector-dependent. + ConnectorTenantInfo map[string]string `json:"connectorTenantInfo,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -10365,6 +11556,7 @@ type GoogleCloudDiscoveryengineV1LicenseConfig struct { // "SUBSCRIPTION_TERM_ONE_MONTH" - 1 month. // "SUBSCRIPTION_TERM_ONE_YEAR" - 1 year. // "SUBSCRIPTION_TERM_THREE_YEARS" - 3 years. + // "SUBSCRIPTION_TERM_CUSTOM" - Custom term. Must set the end_date. SubscriptionTerm string `json:"subscriptionTerm,omitempty"` // SubscriptionTier: Required. Subscription tier information for the license // config. @@ -19549,6 +20741,7 @@ type GoogleCloudDiscoveryengineV1alphaDataConnector struct { // "GCNV" - Google Cloud NetApp Volumes connector. // "GOOGLE_CHAT" - Google Chat connector. // "GOOGLE_SITES" - Google Sites connector. + // "REMOTE_MCP" - Remote MCP based connector. ConnectorType string `json:"connectorType,omitempty"` // CreateEuaSaas: Optional. Whether the END USER AUTHENTICATION connector is // created in SaaS. @@ -20880,6 +22073,10 @@ type GoogleCloudDiscoveryengineV1alphaEngine struct { // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows // configurations specified by customer. ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` + // ConnectorTenantInfo: Optional. Maps a connector ID (e.g., "hybrid-github", + // "shopify") to tenant-specific information required for that connector. The + // structure of the tenant information string is connector-dependent. + ConnectorTenantInfo map[string]string `json:"connectorTenantInfo,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -22544,6 +23741,7 @@ type GoogleCloudDiscoveryengineV1alphaLicenseConfig struct { // "SUBSCRIPTION_TERM_ONE_MONTH" - 1 month. // "SUBSCRIPTION_TERM_ONE_YEAR" - 1 year. // "SUBSCRIPTION_TERM_THREE_YEARS" - 3 years. + // "SUBSCRIPTION_TERM_CUSTOM" - Custom term. Must set the end_date. SubscriptionTerm string `json:"subscriptionTerm,omitempty"` // SubscriptionTier: Required. Subscription tier information for the license // config. @@ -24115,8 +25313,8 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequest struct { NaturalLanguageQueryUnderstandingSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec `json:"naturalLanguageQueryUnderstandingSpec,omitempty"` // NumResultsPerDataStore: Optional. The maximum number of results to retrieve // from each data store. If not specified, it will use the - // SearchRequest.data_store_specs.num_results if provided, otherwise there is - // no limit. + // SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no + // limit. NumResultsPerDataStore int64 `json:"numResultsPerDataStore,omitempty"` // Offset: A 0-indexed integer that specifies the current offset (that is, // starting result location, amongst the Documents deemed by the API as @@ -27904,6 +29102,10 @@ type GoogleCloudDiscoveryengineV1betaEngine struct { // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows // configurations specified by customer. ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` + // ConnectorTenantInfo: Optional. Maps a connector ID (e.g., "hybrid-github", + // "shopify") to tenant-specific information required for that connector. The + // structure of the tenant information string is connector-dependent. + ConnectorTenantInfo map[string]string `json:"connectorTenantInfo,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -29152,6 +30354,7 @@ type GoogleCloudDiscoveryengineV1betaLicenseConfig struct { // "SUBSCRIPTION_TERM_ONE_MONTH" - 1 month. // "SUBSCRIPTION_TERM_ONE_YEAR" - 1 year. // "SUBSCRIPTION_TERM_THREE_YEARS" - 3 years. + // "SUBSCRIPTION_TERM_CUSTOM" - Custom term. Must set the end_date. SubscriptionTerm string `json:"subscriptionTerm,omitempty"` // SubscriptionTier: Required. Subscription tier information for the license // config. @@ -30037,8 +31240,8 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { NaturalLanguageQueryUnderstandingSpec *GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec `json:"naturalLanguageQueryUnderstandingSpec,omitempty"` // NumResultsPerDataStore: Optional. The maximum number of results to retrieve // from each data store. If not specified, it will use the - // SearchRequest.data_store_specs.num_results if provided, otherwise there is - // no limit. + // SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no + // limit. NumResultsPerDataStore int64 `json:"numResultsPerDataStore,omitempty"` // Offset: A 0-indexed integer that specifies the current offset (that is, // starting result location, amongst the Documents deemed by the API as @@ -32744,140 +33947,602 @@ type GoogleTypeDateTime struct { NullFields []string `json:"-"` } -func (s GoogleTypeDateTime) MarshalJSON() ([]byte, error) { - type NoMethod GoogleTypeDateTime - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +func (s GoogleTypeDateTime) MarshalJSON() ([]byte, error) { + type NoMethod GoogleTypeDateTime + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleTypeExpr: Represents a textual expression in the Common Expression +// Language (CEL) syntax. CEL is a C-like expression language. The syntax and +// semantics of CEL are documented at https://github.com/google/cel-spec. +// Example (Comparison): title: "Summary size limit" description: "Determines +// if a summary is less than 100 chars" expression: "document.summary.size() < +// 100" Example (Equality): title: "Requestor is owner" description: +// "Determines if requestor is the document owner" expression: "document.owner +// == request.auth.claims.email" Example (Logic): title: "Public documents" +// description: "Determine whether the document should be publicly visible" +// expression: "document.type != 'private' && document.type != 'internal'" +// Example (Data Manipulation): title: "Notification string" description: +// "Create a notification string with a timestamp." expression: "'New message +// received at ' + string(document.create_time)" The exact variables and +// functions that may be referenced within an expression are determined by the +// service that evaluates it. See the service documentation for additional +// information. +type GoogleTypeExpr struct { + // Description: Optional. Description of the expression. This is a longer text + // which describes the expression, e.g. when hovered over it in a UI. + Description string `json:"description,omitempty"` + // Expression: Textual representation of an expression in Common Expression + // Language syntax. + Expression string `json:"expression,omitempty"` + // Location: Optional. String indicating the location of the expression for + // error reporting, e.g. a file name and a position in the file. + Location string `json:"location,omitempty"` + // Title: Optional. Title for the expression, i.e. a short string describing + // its purpose. This can be used e.g. in UIs which allow to enter the + // expression. + Title string `json:"title,omitempty"` + // ForceSendFields is a list of field names (e.g. "Description") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Description") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleTypeExpr) MarshalJSON() ([]byte, error) { + type NoMethod GoogleTypeExpr + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleTypeTimeZone: Represents a time zone from the IANA Time Zone Database +// (https://www.iana.org/time-zones). +type GoogleTypeTimeZone struct { + // Id: IANA Time Zone Database time zone. For example "America/New_York". + Id string `json:"id,omitempty"` + // Version: Optional. IANA Time Zone Database version number. For example + // "2019a". + Version string `json:"version,omitempty"` + // ForceSendFields is a list of field names (e.g. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Id") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleTypeTimeZone) MarshalJSON() ([]byte, error) { + type NoMethod GoogleTypeTimeZone + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type ProjectsProvisionCall struct { + s *Service + name string + googleclouddiscoveryenginev1provisionprojectrequest *GoogleCloudDiscoveryengineV1ProvisionProjectRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Provision: Provisions the project resource. During the process, related +// systems will get prepared and initialized. Caller must read the Terms for +// data use (https://cloud.google.com/retail/data-use-terms), and optionally +// specify in request to provide consent to that service terms. +// +// - name: Full resource name of a Project, such as +// `projects/{project_id_or_number}`. +func (r *ProjectsService) Provision(name string, googleclouddiscoveryenginev1provisionprojectrequest *GoogleCloudDiscoveryengineV1ProvisionProjectRequest) *ProjectsProvisionCall { + c := &ProjectsProvisionCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleclouddiscoveryenginev1provisionprojectrequest = googleclouddiscoveryenginev1provisionprojectrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsProvisionCall) Fields(s ...googleapi.Field) *ProjectsProvisionCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsProvisionCall) Context(ctx context.Context) *ProjectsProvisionCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsProvisionCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsProvisionCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1provisionprojectrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:provision") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.provision", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.provision" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsProvisionCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.provision", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsGetAclConfigCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetAclConfig: Gets the AclConfig. +// +// - name: Resource name of AclConfig, such as +// `projects/*/locations/*/aclConfig`. If the caller does not have permission +// to access the AclConfig, regardless of whether or not it exists, a +// PERMISSION_DENIED error is returned. +func (r *ProjectsLocationsService) GetAclConfig(name string) *ProjectsLocationsGetAclConfigCall { + c := &ProjectsLocationsGetAclConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsGetAclConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetAclConfigCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsGetAclConfigCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetAclConfigCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGetAclConfigCall) Context(ctx context.Context) *ProjectsLocationsGetAclConfigCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsGetAclConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGetAclConfigCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.getAclConfig", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.getAclConfig" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1AclConfig.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsGetAclConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1AclConfig, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudDiscoveryengineV1AclConfig{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.getAclConfig", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsGetCmekConfigCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetCmekConfig: Gets the CmekConfig. +// +// - name: Resource name of CmekConfig, such as +// `projects/*/locations/*/cmekConfig` or +// `projects/*/locations/*/cmekConfigs/*`. If the caller does not have +// permission to access the CmekConfig, regardless of whether or not it +// exists, a PERMISSION_DENIED error is returned. +func (r *ProjectsLocationsService) GetCmekConfig(name string) *ProjectsLocationsGetCmekConfigCall { + c := &ProjectsLocationsGetCmekConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsGetCmekConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetCmekConfigCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsGetCmekConfigCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetCmekConfigCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGetCmekConfigCall) Context(ctx context.Context) *ProjectsLocationsGetCmekConfigCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsGetCmekConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGetCmekConfigCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.getCmekConfig", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.getCmekConfig" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1CmekConfig.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsGetCmekConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1CmekConfig, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudDiscoveryengineV1CmekConfig{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.getCmekConfig", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsSetUpDataConnectorCall struct { + s *Service + parent string + googleclouddiscoveryenginev1setupdataconnectorrequest *GoogleCloudDiscoveryengineV1SetUpDataConnectorRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetUpDataConnector: Creates a Collection and sets up the DataConnector for +// it. To stop a DataConnector after setup, use the +// CollectionService.DeleteCollection method. +// +// - parent: The parent of Collection, in the format of +// `projects/{project}/locations/{location}`. +func (r *ProjectsLocationsService) SetUpDataConnector(parent string, googleclouddiscoveryenginev1setupdataconnectorrequest *GoogleCloudDiscoveryengineV1SetUpDataConnectorRequest) *ProjectsLocationsSetUpDataConnectorCall { + c := &ProjectsLocationsSetUpDataConnectorCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1setupdataconnectorrequest = googleclouddiscoveryenginev1setupdataconnectorrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsSetUpDataConnectorCall) Fields(s ...googleapi.Field) *ProjectsLocationsSetUpDataConnectorCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c } -// GoogleTypeExpr: Represents a textual expression in the Common Expression -// Language (CEL) syntax. CEL is a C-like expression language. The syntax and -// semantics of CEL are documented at https://github.com/google/cel-spec. -// Example (Comparison): title: "Summary size limit" description: "Determines -// if a summary is less than 100 chars" expression: "document.summary.size() < -// 100" Example (Equality): title: "Requestor is owner" description: -// "Determines if requestor is the document owner" expression: "document.owner -// == request.auth.claims.email" Example (Logic): title: "Public documents" -// description: "Determine whether the document should be publicly visible" -// expression: "document.type != 'private' && document.type != 'internal'" -// Example (Data Manipulation): title: "Notification string" description: -// "Create a notification string with a timestamp." expression: "'New message -// received at ' + string(document.create_time)" The exact variables and -// functions that may be referenced within an expression are determined by the -// service that evaluates it. See the service documentation for additional -// information. -type GoogleTypeExpr struct { - // Description: Optional. Description of the expression. This is a longer text - // which describes the expression, e.g. when hovered over it in a UI. - Description string `json:"description,omitempty"` - // Expression: Textual representation of an expression in Common Expression - // Language syntax. - Expression string `json:"expression,omitempty"` - // Location: Optional. String indicating the location of the expression for - // error reporting, e.g. a file name and a position in the file. - Location string `json:"location,omitempty"` - // Title: Optional. Title for the expression, i.e. a short string describing - // its purpose. This can be used e.g. in UIs which allow to enter the - // expression. - Title string `json:"title,omitempty"` - // ForceSendFields is a list of field names (e.g. "Description") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Description") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsSetUpDataConnectorCall) Context(ctx context.Context) *ProjectsLocationsSetUpDataConnectorCall { + c.ctx_ = ctx + return c } -func (s GoogleTypeExpr) MarshalJSON() ([]byte, error) { - type NoMethod GoogleTypeExpr - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsSetUpDataConnectorCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ } -// GoogleTypeTimeZone: Represents a time zone from the IANA Time Zone Database -// (https://www.iana.org/time-zones). -type GoogleTypeTimeZone struct { - // Id: IANA Time Zone Database time zone. For example "America/New_York". - Id string `json:"id,omitempty"` - // Version: Optional. IANA Time Zone Database version number. For example - // "2019a". - Version string `json:"version,omitempty"` - // ForceSendFields is a list of field names (e.g. "Id") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Id") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` +func (c *ProjectsLocationsSetUpDataConnectorCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1setupdataconnectorrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}:setUpDataConnector") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.setUpDataConnector", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) } -func (s GoogleTypeTimeZone) MarshalJSON() ([]byte, error) { - type NoMethod GoogleTypeTimeZone - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +// Do executes the "discoveryengine.projects.locations.setUpDataConnector" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsSetUpDataConnectorCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.setUpDataConnector", "response", internallog.HTTPResponse(res, b)) + return ret, nil } -type ProjectsProvisionCall struct { - s *Service - name string - googleclouddiscoveryenginev1provisionprojectrequest *GoogleCloudDiscoveryengineV1ProvisionProjectRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsSetUpDataConnectorV2Call struct { + s *Service + parent string + googleclouddiscoveryenginev1dataconnector *GoogleCloudDiscoveryengineV1DataConnector + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Provision: Provisions the project resource. During the process, related -// systems will get prepared and initialized. Caller must read the Terms for -// data use (https://cloud.google.com/retail/data-use-terms), and optionally -// specify in request to provide consent to that service terms. +// SetUpDataConnectorV2: Creates a Collection and sets up the DataConnector for +// it. To stop a DataConnector after setup, use the +// CollectionService.DeleteCollection method. // -// - name: Full resource name of a Project, such as -// `projects/{project_id_or_number}`. -func (r *ProjectsService) Provision(name string, googleclouddiscoveryenginev1provisionprojectrequest *GoogleCloudDiscoveryengineV1ProvisionProjectRequest) *ProjectsProvisionCall { - c := &ProjectsProvisionCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.googleclouddiscoveryenginev1provisionprojectrequest = googleclouddiscoveryenginev1provisionprojectrequest +// - parent: The parent of Collection, in the format of +// `projects/{project}/locations/{location}`. +func (r *ProjectsLocationsService) SetUpDataConnectorV2(parent string, googleclouddiscoveryenginev1dataconnector *GoogleCloudDiscoveryengineV1DataConnector) *ProjectsLocationsSetUpDataConnectorV2Call { + c := &ProjectsLocationsSetUpDataConnectorV2Call{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1dataconnector = googleclouddiscoveryenginev1dataconnector + return c +} + +// CollectionDisplayName sets the optional parameter "collectionDisplayName": +// Required. The display name of the Collection. Should be human readable, used +// to display collections in the Console Dashboard. UTF-8 encoded string with +// limit of 1024 characters. +func (c *ProjectsLocationsSetUpDataConnectorV2Call) CollectionDisplayName(collectionDisplayName string) *ProjectsLocationsSetUpDataConnectorV2Call { + c.urlParams_.Set("collectionDisplayName", collectionDisplayName) + return c +} + +// CollectionId sets the optional parameter "collectionId": Required. The ID to +// use for the Collection, which will become the final component of the +// Collection's resource name. A new Collection is created as part of the +// DataConnector setup. DataConnector is a singleton resource under Collection, +// managing all DataStores of the Collection. This field must conform to +// RFC-1034 (https://tools.ietf.org/html/rfc1034) standard with a length limit +// of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned. +func (c *ProjectsLocationsSetUpDataConnectorV2Call) CollectionId(collectionId string) *ProjectsLocationsSetUpDataConnectorV2Call { + c.urlParams_.Set("collectionId", collectionId) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsProvisionCall) Fields(s ...googleapi.Field) *ProjectsProvisionCall { +func (c *ProjectsLocationsSetUpDataConnectorV2Call) Fields(s ...googleapi.Field) *ProjectsLocationsSetUpDataConnectorV2Call { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsProvisionCall) Context(ctx context.Context) *ProjectsProvisionCall { +func (c *ProjectsLocationsSetUpDataConnectorV2Call) Context(ctx context.Context) *ProjectsLocationsSetUpDataConnectorV2Call { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsProvisionCall) Header() http.Header { +func (c *ProjectsLocationsSetUpDataConnectorV2Call) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsProvisionCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsSetUpDataConnectorV2Call) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1provisionprojectrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1dataconnector) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:provision") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}:setUpDataConnectorV2") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -32885,19 +34550,19 @@ func (c *ProjectsProvisionCall) doRequest(alt string) (*http.Response, error) { } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.provision", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.setUpDataConnectorV2", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.provision" call. +// Do executes the "discoveryengine.projects.locations.setUpDataConnectorV2" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsProvisionCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsSetUpDataConnectorV2Call) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -32927,72 +34592,67 @@ func (c *ProjectsProvisionCall) Do(opts ...googleapi.CallOption) (*GoogleLongrun if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.provision", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.setUpDataConnectorV2", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsGetAclConfigCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsUpdateAclConfigCall struct { + s *Service + name string + googleclouddiscoveryenginev1aclconfig *GoogleCloudDiscoveryengineV1AclConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// GetAclConfig: Gets the AclConfig. +// UpdateAclConfig: Default ACL configuration for use in a location of a +// customer's project. Updates will only reflect to new data stores. Existing +// data stores will still use the old value. // -// - name: Resource name of AclConfig, such as -// `projects/*/locations/*/aclConfig`. If the caller does not have permission -// to access the AclConfig, regardless of whether or not it exists, a -// PERMISSION_DENIED error is returned. -func (r *ProjectsLocationsService) GetAclConfig(name string) *ProjectsLocationsGetAclConfigCall { - c := &ProjectsLocationsGetAclConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Immutable. The full resource name of the acl configuration. Format: +// `projects/{project}/locations/{location}/aclConfig`. This field must be a +// UTF-8 encoded string with a length limit of 1024 characters. +func (r *ProjectsLocationsService) UpdateAclConfig(name string, googleclouddiscoveryenginev1aclconfig *GoogleCloudDiscoveryengineV1AclConfig) *ProjectsLocationsUpdateAclConfigCall { + c := &ProjectsLocationsUpdateAclConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name + c.googleclouddiscoveryenginev1aclconfig = googleclouddiscoveryenginev1aclconfig return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsGetAclConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetAclConfigCall { +func (c *ProjectsLocationsUpdateAclConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsUpdateAclConfigCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsGetAclConfigCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetAclConfigCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsGetAclConfigCall) Context(ctx context.Context) *ProjectsLocationsGetAclConfigCall { +func (c *ProjectsLocationsUpdateAclConfigCall) Context(ctx context.Context) *ProjectsLocationsUpdateAclConfigCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsGetAclConfigCall) Header() http.Header { +func (c *ProjectsLocationsUpdateAclConfigCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsGetAclConfigCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) +func (c *ProjectsLocationsUpdateAclConfigCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1aclconfig) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } @@ -33000,17 +34660,17 @@ func (c *ProjectsLocationsGetAclConfigCall) doRequest(alt string) (*http.Respons googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.getAclConfig", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.updateAclConfig", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.getAclConfig" call. +// Do executes the "discoveryengine.projects.locations.updateAclConfig" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleCloudDiscoveryengineV1AclConfig.ServerResponse.Header or (if a // response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsGetAclConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1AclConfig, error) { +func (c *ProjectsLocationsUpdateAclConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1AclConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -33040,73 +34700,175 @@ func (c *ProjectsLocationsGetAclConfigCall) Do(opts ...googleapi.CallOption) (*G if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.getAclConfig", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.updateAclConfig", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsGetCmekConfigCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsUpdateCmekConfigCall struct { + s *Service + name string + googleclouddiscoveryenginev1cmekconfig *GoogleCloudDiscoveryengineV1CmekConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// GetCmekConfig: Gets the CmekConfig. +// UpdateCmekConfig: Provisions a CMEK key for use in a location of a +// customer's project. This method will also conduct location validation on the +// provided cmekConfig to make sure the key is valid and can be used in the +// selected location. // -// - name: Resource name of CmekConfig, such as -// `projects/*/locations/*/cmekConfig` or -// `projects/*/locations/*/cmekConfigs/*`. If the caller does not have -// permission to access the CmekConfig, regardless of whether or not it -// exists, a PERMISSION_DENIED error is returned. -func (r *ProjectsLocationsService) GetCmekConfig(name string) *ProjectsLocationsGetCmekConfigCall { - c := &ProjectsLocationsGetCmekConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The name of the CmekConfig of the form +// `projects/{project}/locations/{location}/cmekConfig` or +// `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`. +func (r *ProjectsLocationsService) UpdateCmekConfig(name string, googleclouddiscoveryenginev1cmekconfig *GoogleCloudDiscoveryengineV1CmekConfig) *ProjectsLocationsUpdateCmekConfigCall { + c := &ProjectsLocationsUpdateCmekConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name + c.googleclouddiscoveryenginev1cmekconfig = googleclouddiscoveryenginev1cmekconfig + return c +} + +// SetDefault sets the optional parameter "setDefault": Set the following +// CmekConfig as the default to be used for child resources if one is not +// specified. +func (c *ProjectsLocationsUpdateCmekConfigCall) SetDefault(setDefault bool) *ProjectsLocationsUpdateCmekConfigCall { + c.urlParams_.Set("setDefault", fmt.Sprint(setDefault)) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsGetCmekConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetCmekConfigCall { +func (c *ProjectsLocationsUpdateCmekConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsUpdateCmekConfigCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsGetCmekConfigCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetCmekConfigCall { - c.ifNoneMatch_ = entityTag +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsUpdateCmekConfigCall) Context(ctx context.Context) *ProjectsLocationsUpdateCmekConfigCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsUpdateCmekConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsUpdateCmekConfigCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1cmekconfig) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.updateCmekConfig", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.updateCmekConfig" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsUpdateCmekConfigCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.updateCmekConfig", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsCmekConfigsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: De-provisions a CmekConfig. +// +// - name: The resource name of the CmekConfig to delete, such as +// `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`. +func (r *ProjectsLocationsCmekConfigsService) Delete(name string) *ProjectsLocationsCmekConfigsDeleteCall { + c := &ProjectsLocationsCmekConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsCmekConfigsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCmekConfigsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsGetCmekConfigCall) Context(ctx context.Context) *ProjectsLocationsGetCmekConfigCall { +func (c *ProjectsLocationsCmekConfigsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCmekConfigsDeleteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsGetCmekConfigCall) Header() http.Header { +func (c *ProjectsLocationsCmekConfigsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsGetCmekConfigCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCmekConfigsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } @@ -33114,17 +34876,17 @@ func (c *ProjectsLocationsGetCmekConfigCall) doRequest(alt string) (*http.Respon googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.getCmekConfig", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.getCmekConfig" call. +// Do executes the "discoveryengine.projects.locations.cmekConfigs.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1CmekConfig.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsGetCmekConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1CmekConfig, error) { +func (c *ProjectsLocationsCmekConfigsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -33143,7 +34905,7 @@ func (c *ProjectsLocationsGetCmekConfigCall) Do(opts ...googleapi.CallOption) (* if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1CmekConfig{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -33154,84 +34916,91 @@ func (c *ProjectsLocationsGetCmekConfigCall) Do(opts ...googleapi.CallOption) (* if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.getCmekConfig", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsSetUpDataConnectorCall struct { - s *Service - parent string - googleclouddiscoveryenginev1setupdataconnectorrequest *GoogleCloudDiscoveryengineV1SetUpDataConnectorRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCmekConfigsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// SetUpDataConnector: Creates a Collection and sets up the DataConnector for -// it. To stop a DataConnector after setup, use the -// CollectionService.DeleteCollection method. +// Get: Gets the CmekConfig. // -// - parent: The parent of Collection, in the format of -// `projects/{project}/locations/{location}`. -func (r *ProjectsLocationsService) SetUpDataConnector(parent string, googleclouddiscoveryenginev1setupdataconnectorrequest *GoogleCloudDiscoveryengineV1SetUpDataConnectorRequest) *ProjectsLocationsSetUpDataConnectorCall { - c := &ProjectsLocationsSetUpDataConnectorCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.googleclouddiscoveryenginev1setupdataconnectorrequest = googleclouddiscoveryenginev1setupdataconnectorrequest +// - name: Resource name of CmekConfig, such as +// `projects/*/locations/*/cmekConfig` or +// `projects/*/locations/*/cmekConfigs/*`. If the caller does not have +// permission to access the CmekConfig, regardless of whether or not it +// exists, a PERMISSION_DENIED error is returned. +func (r *ProjectsLocationsCmekConfigsService) Get(name string) *ProjectsLocationsCmekConfigsGetCall { + c := &ProjectsLocationsCmekConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsSetUpDataConnectorCall) Fields(s ...googleapi.Field) *ProjectsLocationsSetUpDataConnectorCall { +func (c *ProjectsLocationsCmekConfigsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCmekConfigsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCmekConfigsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCmekConfigsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSetUpDataConnectorCall) Context(ctx context.Context) *ProjectsLocationsSetUpDataConnectorCall { +func (c *ProjectsLocationsCmekConfigsGetCall) Context(ctx context.Context) *ProjectsLocationsCmekConfigsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsSetUpDataConnectorCall) Header() http.Header { +func (c *ProjectsLocationsCmekConfigsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsSetUpDataConnectorCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1setupdataconnectorrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsCmekConfigsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}:setUpDataConnector") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.setUpDataConnector", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.setUpDataConnector" call. +// Do executes the "discoveryengine.projects.locations.cmekConfigs.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1CmekConfig.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsSetUpDataConnectorCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCmekConfigsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1CmekConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -33250,7 +35019,7 @@ func (c *ProjectsLocationsSetUpDataConnectorCall) Do(opts ...googleapi.CallOptio if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1CmekConfig{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -33261,87 +35030,72 @@ func (c *ProjectsLocationsSetUpDataConnectorCall) Do(opts ...googleapi.CallOptio if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.setUpDataConnector", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsSetUpDataConnectorV2Call struct { - s *Service - parent string - googleclouddiscoveryenginev1dataconnector *GoogleCloudDiscoveryengineV1DataConnector - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCmekConfigsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// SetUpDataConnectorV2: Creates a Collection and sets up the DataConnector for -// it. To stop a DataConnector after setup, use the -// CollectionService.DeleteCollection method. +// List: Lists all the CmekConfigs with the project. // -// - parent: The parent of Collection, in the format of -// `projects/{project}/locations/{location}`. -func (r *ProjectsLocationsService) SetUpDataConnectorV2(parent string, googleclouddiscoveryenginev1dataconnector *GoogleCloudDiscoveryengineV1DataConnector) *ProjectsLocationsSetUpDataConnectorV2Call { - c := &ProjectsLocationsSetUpDataConnectorV2Call{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: The parent location resource name, such as +// `projects/{project}/locations/{location}`. If the caller does not have +// permission to list CmekConfigs under this location, regardless of whether +// or not a CmekConfig exists, a PERMISSION_DENIED error is returned. +func (r *ProjectsLocationsCmekConfigsService) List(parent string) *ProjectsLocationsCmekConfigsListCall { + c := &ProjectsLocationsCmekConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent - c.googleclouddiscoveryenginev1dataconnector = googleclouddiscoveryenginev1dataconnector - return c -} - -// CollectionDisplayName sets the optional parameter "collectionDisplayName": -// Required. The display name of the Collection. Should be human readable, used -// to display collections in the Console Dashboard. UTF-8 encoded string with -// limit of 1024 characters. -func (c *ProjectsLocationsSetUpDataConnectorV2Call) CollectionDisplayName(collectionDisplayName string) *ProjectsLocationsSetUpDataConnectorV2Call { - c.urlParams_.Set("collectionDisplayName", collectionDisplayName) - return c -} - -// CollectionId sets the optional parameter "collectionId": Required. The ID to -// use for the Collection, which will become the final component of the -// Collection's resource name. A new Collection is created as part of the -// DataConnector setup. DataConnector is a singleton resource under Collection, -// managing all DataStores of the Collection. This field must conform to -// RFC-1034 (https://tools.ietf.org/html/rfc1034) standard with a length limit -// of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned. -func (c *ProjectsLocationsSetUpDataConnectorV2Call) CollectionId(collectionId string) *ProjectsLocationsSetUpDataConnectorV2Call { - c.urlParams_.Set("collectionId", collectionId) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsSetUpDataConnectorV2Call) Fields(s ...googleapi.Field) *ProjectsLocationsSetUpDataConnectorV2Call { +func (c *ProjectsLocationsCmekConfigsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCmekConfigsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCmekConfigsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCmekConfigsListCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSetUpDataConnectorV2Call) Context(ctx context.Context) *ProjectsLocationsSetUpDataConnectorV2Call { +func (c *ProjectsLocationsCmekConfigsListCall) Context(ctx context.Context) *ProjectsLocationsCmekConfigsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsSetUpDataConnectorV2Call) Header() http.Header { +func (c *ProjectsLocationsCmekConfigsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsSetUpDataConnectorV2Call) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1dataconnector) - if err != nil { - return nil, err +func (c *ProjectsLocationsCmekConfigsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}:setUpDataConnectorV2") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/cmekConfigs") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -33349,17 +35103,17 @@ func (c *ProjectsLocationsSetUpDataConnectorV2Call) doRequest(alt string) (*http googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.setUpDataConnectorV2", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.setUpDataConnectorV2" call. +// Do executes the "discoveryengine.projects.locations.cmekConfigs.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because +// *GoogleCloudDiscoveryengineV1ListCmekConfigsResponse.ServerResponse.Header +// or (if a response was returned at all) in error.(*googleapi.Error).Header. +// Use googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsSetUpDataConnectorV2Call) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCmekConfigsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListCmekConfigsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -33378,7 +35132,7 @@ func (c *ProjectsLocationsSetUpDataConnectorV2Call) Do(opts ...googleapi.CallOpt if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1ListCmekConfigsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -33389,59 +35143,67 @@ func (c *ProjectsLocationsSetUpDataConnectorV2Call) Do(opts ...googleapi.CallOpt if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.setUpDataConnectorV2", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsUpdateAclConfigCall struct { - s *Service - name string - googleclouddiscoveryenginev1aclconfig *GoogleCloudDiscoveryengineV1AclConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCmekConfigsPatchCall struct { + s *Service + name string + googleclouddiscoveryenginev1cmekconfig *GoogleCloudDiscoveryengineV1CmekConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// UpdateAclConfig: Default ACL configuration for use in a location of a -// customer's project. Updates will only reflect to new data stores. Existing -// data stores will still use the old value. +// Patch: Provisions a CMEK key for use in a location of a customer's project. +// This method will also conduct location validation on the provided cmekConfig +// to make sure the key is valid and can be used in the selected location. // -// - name: Immutable. The full resource name of the acl configuration. Format: -// `projects/{project}/locations/{location}/aclConfig`. This field must be a -// UTF-8 encoded string with a length limit of 1024 characters. -func (r *ProjectsLocationsService) UpdateAclConfig(name string, googleclouddiscoveryenginev1aclconfig *GoogleCloudDiscoveryengineV1AclConfig) *ProjectsLocationsUpdateAclConfigCall { - c := &ProjectsLocationsUpdateAclConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The name of the CmekConfig of the form +// `projects/{project}/locations/{location}/cmekConfig` or +// `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`. +func (r *ProjectsLocationsCmekConfigsService) Patch(name string, googleclouddiscoveryenginev1cmekconfig *GoogleCloudDiscoveryengineV1CmekConfig) *ProjectsLocationsCmekConfigsPatchCall { + c := &ProjectsLocationsCmekConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googleclouddiscoveryenginev1aclconfig = googleclouddiscoveryenginev1aclconfig + c.googleclouddiscoveryenginev1cmekconfig = googleclouddiscoveryenginev1cmekconfig + return c +} + +// SetDefault sets the optional parameter "setDefault": Set the following +// CmekConfig as the default to be used for child resources if one is not +// specified. +func (c *ProjectsLocationsCmekConfigsPatchCall) SetDefault(setDefault bool) *ProjectsLocationsCmekConfigsPatchCall { + c.urlParams_.Set("setDefault", fmt.Sprint(setDefault)) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsUpdateAclConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsUpdateAclConfigCall { +func (c *ProjectsLocationsCmekConfigsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCmekConfigsPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsUpdateAclConfigCall) Context(ctx context.Context) *ProjectsLocationsUpdateAclConfigCall { +func (c *ProjectsLocationsCmekConfigsPatchCall) Context(ctx context.Context) *ProjectsLocationsCmekConfigsPatchCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsUpdateAclConfigCall) Header() http.Header { +func (c *ProjectsLocationsCmekConfigsPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsUpdateAclConfigCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCmekConfigsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1aclconfig) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1cmekconfig) if err != nil { return nil, err } @@ -33457,17 +35219,17 @@ func (c *ProjectsLocationsUpdateAclConfigCall) doRequest(alt string) (*http.Resp googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.updateAclConfig", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.patch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.updateAclConfig" call. +// Do executes the "discoveryengine.projects.locations.cmekConfigs.patch" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1AclConfig.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsUpdateAclConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1AclConfig, error) { +func (c *ProjectsLocationsCmekConfigsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -33486,7 +35248,7 @@ func (c *ProjectsLocationsUpdateAclConfigCall) Do(opts ...googleapi.CallOption) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1AclConfig{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -33497,76 +35259,58 @@ func (c *ProjectsLocationsUpdateAclConfigCall) Do(opts ...googleapi.CallOption) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.updateAclConfig", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.patch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsUpdateCmekConfigCall struct { - s *Service - name string - googleclouddiscoveryenginev1cmekconfig *GoogleCloudDiscoveryengineV1CmekConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// UpdateCmekConfig: Provisions a CMEK key for use in a location of a -// customer's project. This method will also conduct location validation on the -// provided cmekConfig to make sure the key is valid and can be used in the -// selected location. +// Delete: Deletes a Collection. // -// - name: The name of the CmekConfig of the form -// `projects/{project}/locations/{location}/cmekConfig` or -// `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`. -func (r *ProjectsLocationsService) UpdateCmekConfig(name string, googleclouddiscoveryenginev1cmekconfig *GoogleCloudDiscoveryengineV1CmekConfig) *ProjectsLocationsUpdateCmekConfigCall { - c := &ProjectsLocationsUpdateCmekConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The full resource name of the Collection, in the format of +// `projects/{project}/locations/{location}/collections/{collection}`. +func (r *ProjectsLocationsCollectionsService) Delete(name string) *ProjectsLocationsCollectionsDeleteCall { + c := &ProjectsLocationsCollectionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googleclouddiscoveryenginev1cmekconfig = googleclouddiscoveryenginev1cmekconfig - return c -} - -// SetDefault sets the optional parameter "setDefault": Set the following -// CmekConfig as the default to be used for child resources if one is not -// specified. -func (c *ProjectsLocationsUpdateCmekConfigCall) SetDefault(setDefault bool) *ProjectsLocationsUpdateCmekConfigCall { - c.urlParams_.Set("setDefault", fmt.Sprint(setDefault)) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsUpdateCmekConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsUpdateCmekConfigCall { +func (c *ProjectsLocationsCollectionsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsUpdateCmekConfigCall) Context(ctx context.Context) *ProjectsLocationsUpdateCmekConfigCall { +func (c *ProjectsLocationsCollectionsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDeleteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsUpdateCmekConfigCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsUpdateCmekConfigCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1cmekconfig) - if err != nil { - return nil, err - } +func (c *ProjectsLocationsCollectionsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } @@ -33574,17 +35318,17 @@ func (c *ProjectsLocationsUpdateCmekConfigCall) doRequest(alt string) (*http.Res googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.updateCmekConfig", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.updateCmekConfig" call. +// Do executes the "discoveryengine.projects.locations.collections.delete" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsUpdateCmekConfigCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -33614,24 +35358,30 @@ func (c *ProjectsLocationsUpdateCmekConfigCall) Do(opts ...googleapi.CallOption) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.updateCmekConfig", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCmekConfigsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsGetDataConnectorCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Delete: De-provisions a CmekConfig. +// GetDataConnector: Gets the DataConnector. DataConnector is a singleton +// resource for each Collection. // -// - name: The resource name of the CmekConfig to delete, such as -// `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`. -func (r *ProjectsLocationsCmekConfigsService) Delete(name string) *ProjectsLocationsCmekConfigsDeleteCall { - c := &ProjectsLocationsCmekConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Full resource name of DataConnector, such as +// `projects/{project}/locations/{location}/collections/{collection_id}/dataCo +// nnector`. If the caller does not have permission to access the +// DataConnector, regardless of whether or not it exists, a PERMISSION_DENIED +// error is returned. If the requested DataConnector does not exist, a +// NOT_FOUND error is returned. +func (r *ProjectsLocationsCollectionsService) GetDataConnector(name string) *ProjectsLocationsCollectionsGetDataConnectorCall { + c := &ProjectsLocationsCollectionsGetDataConnectorCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -33639,33 +35389,44 @@ func (r *ProjectsLocationsCmekConfigsService) Delete(name string) *ProjectsLocat // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCmekConfigsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCmekConfigsDeleteCall { +func (c *ProjectsLocationsCollectionsGetDataConnectorCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsGetDataConnectorCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsGetDataConnectorCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsGetDataConnectorCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCmekConfigsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCmekConfigsDeleteCall { +func (c *ProjectsLocationsCollectionsGetDataConnectorCall) Context(ctx context.Context) *ProjectsLocationsCollectionsGetDataConnectorCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCmekConfigsDeleteCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsGetDataConnectorCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCmekConfigsDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsGetDataConnectorCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -33673,17 +35434,17 @@ func (c *ProjectsLocationsCmekConfigsDeleteCall) doRequest(alt string) (*http.Re googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.getDataConnector", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.cmekConfigs.delete" call. +// Do executes the "discoveryengine.projects.locations.collections.getDataConnector" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1DataConnector.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCmekConfigsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsGetDataConnectorCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1DataConnector, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -33702,7 +35463,7 @@ func (c *ProjectsLocationsCmekConfigsDeleteCall) Do(opts ...googleapi.CallOption if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1DataConnector{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -33713,73 +35474,79 @@ func (c *ProjectsLocationsCmekConfigsDeleteCall) Do(opts ...googleapi.CallOption if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.getDataConnector", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCmekConfigsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsUpdateDataConnectorCall struct { + s *Service + name string + googleclouddiscoveryenginev1dataconnector *GoogleCloudDiscoveryengineV1DataConnector + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Get: Gets the CmekConfig. +// UpdateDataConnector: Updates a DataConnector. // -// - name: Resource name of CmekConfig, such as -// `projects/*/locations/*/cmekConfig` or -// `projects/*/locations/*/cmekConfigs/*`. If the caller does not have -// permission to access the CmekConfig, regardless of whether or not it -// exists, a PERMISSION_DENIED error is returned. -func (r *ProjectsLocationsCmekConfigsService) Get(name string) *ProjectsLocationsCmekConfigsGetCall { - c := &ProjectsLocationsCmekConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Output only. The full resource name of the Data Connector. Format: +// `projects/*/locations/*/collections/*/dataConnector`. +func (r *ProjectsLocationsCollectionsService) UpdateDataConnector(name string, googleclouddiscoveryenginev1dataconnector *GoogleCloudDiscoveryengineV1DataConnector) *ProjectsLocationsCollectionsUpdateDataConnectorCall { + c := &ProjectsLocationsCollectionsUpdateDataConnectorCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name + c.googleclouddiscoveryenginev1dataconnector = googleclouddiscoveryenginev1dataconnector + return c +} + +// UpdateMask sets the optional parameter "updateMask": Indicates which fields +// in the provided DataConnector to update. Supported field paths include: - +// `refresh_interval` - `params` - `auto_run_disabled` - `action_config` - +// `action_config.action_params` - `action_config.service_name` - +// `destination_configs` - `blocking_reasons` - `sync_mode` - +// `incremental_sync_disabled` - `incremental_refresh_interval` - +// `data_protection_policy` Note: Support for these fields may vary depending +// on the connector type. For example, not all connectors support +// `destination_configs`. If an unsupported or unknown field path is provided, +// the request will return an INVALID_ARGUMENT error. +func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsUpdateDataConnectorCall { + c.urlParams_.Set("updateMask", updateMask) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCmekConfigsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCmekConfigsGetCall { +func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsUpdateDataConnectorCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCmekConfigsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCmekConfigsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCmekConfigsGetCall) Context(ctx context.Context) *ProjectsLocationsCmekConfigsGetCall { +func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) Context(ctx context.Context) *ProjectsLocationsCollectionsUpdateDataConnectorCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCmekConfigsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCmekConfigsGetCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) +func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1dataconnector) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } @@ -33787,17 +35554,17 @@ func (c *ProjectsLocationsCmekConfigsGetCall) doRequest(alt string) (*http.Respo googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.updateDataConnector", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.cmekConfigs.get" call. +// Do executes the "discoveryengine.projects.locations.collections.updateDataConnector" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1CmekConfig.ServerResponse.Header or (if a +// *GoogleCloudDiscoveryengineV1DataConnector.ServerResponse.Header or (if a // response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCmekConfigsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1CmekConfig, error) { +func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1DataConnector, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -33816,7 +35583,7 @@ func (c *ProjectsLocationsCmekConfigsGetCall) Do(opts ...googleapi.CallOption) ( if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1CmekConfig{ + ret := &GoogleCloudDiscoveryengineV1DataConnector{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -33827,35 +35594,34 @@ func (c *ProjectsLocationsCmekConfigsGetCall) Do(opts ...googleapi.CallOption) ( if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.updateDataConnector", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCmekConfigsListCall struct { +type ProjectsLocationsCollectionsDataConnectorOperationsGetCall struct { s *Service - parent string + name string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// List: Lists all the CmekConfigs with the project. +// Get: 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. // -// - parent: The parent location resource name, such as -// `projects/{project}/locations/{location}`. If the caller does not have -// permission to list CmekConfigs under this location, regardless of whether -// or not a CmekConfig exists, a PERMISSION_DENIED error is returned. -func (r *ProjectsLocationsCmekConfigsService) List(parent string) *ProjectsLocationsCmekConfigsListCall { - c := &ProjectsLocationsCmekConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent +// - name: The name of the operation resource. +func (r *ProjectsLocationsCollectionsDataConnectorOperationsService) Get(name string) *ProjectsLocationsCollectionsDataConnectorOperationsGetCall { + c := &ProjectsLocationsCollectionsDataConnectorOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCmekConfigsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCmekConfigsListCall { +func (c *ProjectsLocationsCollectionsDataConnectorOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataConnectorOperationsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -33863,34 +35629,34 @@ func (c *ProjectsLocationsCmekConfigsListCall) Fields(s ...googleapi.Field) *Pro // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCmekConfigsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCmekConfigsListCall { +func (c *ProjectsLocationsCollectionsDataConnectorOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataConnectorOperationsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCmekConfigsListCall) Context(ctx context.Context) *ProjectsLocationsCmekConfigsListCall { +func (c *ProjectsLocationsCollectionsDataConnectorOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataConnectorOperationsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCmekConfigsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataConnectorOperationsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCmekConfigsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataConnectorOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/cmekConfigs") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -33898,19 +35664,19 @@ func (c *ProjectsLocationsCmekConfigsListCall) doRequest(alt string) (*http.Resp } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataConnector.operations.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.cmekConfigs.list" call. +// Do executes the "discoveryengine.projects.locations.collections.dataConnector.operations.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ListCmekConfigsResponse.ServerResponse.Header -// or (if a response was returned at all) in error.(*googleapi.Error).Header. -// Use googleapi.IsNotModified to check whether the returned error was because +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCmekConfigsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListCmekConfigsResponse, error) { +func (c *ProjectsLocationsCollectionsDataConnectorOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -33929,7 +35695,7 @@ func (c *ProjectsLocationsCmekConfigsListCall) Do(opts ...googleapi.CallOption) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ListCmekConfigsResponse{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -33940,75 +35706,103 @@ func (c *ProjectsLocationsCmekConfigsListCall) Do(opts ...googleapi.CallOption) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataConnector.operations.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCmekConfigsPatchCall struct { - s *Service - name string - googleclouddiscoveryenginev1cmekconfig *GoogleCloudDiscoveryengineV1CmekConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataConnectorOperationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Patch: Provisions a CMEK key for use in a location of a customer's project. -// This method will also conduct location validation on the provided cmekConfig -// to make sure the key is valid and can be used in the selected location. +// List: Lists operations that match the specified filter in the request. If +// the server doesn't support this method, it returns `UNIMPLEMENTED`. // -// - name: The name of the CmekConfig of the form -// `projects/{project}/locations/{location}/cmekConfig` or -// `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`. -func (r *ProjectsLocationsCmekConfigsService) Patch(name string, googleclouddiscoveryenginev1cmekconfig *GoogleCloudDiscoveryengineV1CmekConfig) *ProjectsLocationsCmekConfigsPatchCall { - c := &ProjectsLocationsCmekConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The name of the operation's parent resource. +func (r *ProjectsLocationsCollectionsDataConnectorOperationsService) List(name string) *ProjectsLocationsCollectionsDataConnectorOperationsListCall { + c := &ProjectsLocationsCollectionsDataConnectorOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googleclouddiscoveryenginev1cmekconfig = googleclouddiscoveryenginev1cmekconfig return c } -// SetDefault sets the optional parameter "setDefault": Set the following -// CmekConfig as the default to be used for child resources if one is not -// specified. -func (c *ProjectsLocationsCmekConfigsPatchCall) SetDefault(setDefault bool) *ProjectsLocationsCmekConfigsPatchCall { - c.urlParams_.Set("setDefault", fmt.Sprint(setDefault)) +// Filter sets the optional parameter "filter": The standard list filter. +func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataConnectorOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list page +// size. +func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataConnectorOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list page +// token. +func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataConnectorOperationsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": +// When set to `true`, operations that are reachable are returned as normal, +// and those that are unreachable are returned in the +// ListOperationsResponse.unreachable field. This can only be `true` when +// reading across collections. For example, when `parent` is set to +// "projects/example/locations/-". This field is not supported by default and +// will result in an `UNIMPLEMENTED` error if set unless explicitly documented +// otherwise in service or product specific documentation. +func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsCollectionsDataConnectorOperationsListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCmekConfigsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCmekConfigsPatchCall { +func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataConnectorOperationsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataConnectorOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCmekConfigsPatchCall) Context(ctx context.Context) *ProjectsLocationsCmekConfigsPatchCall { +func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataConnectorOperationsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCmekConfigsPatchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCmekConfigsPatchCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1cmekconfig) - if err != nil { - return nil, err +func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/operations") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -34016,17 +35810,17 @@ func (c *ProjectsLocationsCmekConfigsPatchCall) doRequest(alt string) (*http.Res googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataConnector.operations.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.cmekConfigs.patch" call. +// Do executes the "discoveryengine.projects.locations.collections.dataConnector.operations.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningListOperationsResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCmekConfigsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -34045,7 +35839,7 @@ func (c *ProjectsLocationsCmekConfigsPatchCall) Do(opts ...googleapi.CallOption) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleLongrunningListOperationsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -34056,76 +35850,159 @@ func (c *ProjectsLocationsCmekConfigsPatchCall) Do(opts ...googleapi.CallOption) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.patch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataConnector.operations.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } } -// Delete: Deletes a Collection. +type ProjectsLocationsCollectionsDataStoresCompleteQueryCall struct { + s *Service + dataStore string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// CompleteQuery: Completes the specified user input with keyword suggestions. // -// - name: The full resource name of the Collection, in the format of -// `projects/{project}/locations/{location}/collections/{collection}`. -func (r *ProjectsLocationsCollectionsService) Delete(name string) *ProjectsLocationsCollectionsDeleteCall { - c := &ProjectsLocationsCollectionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - dataStore: The parent data store resource name for which the completion is +// performed, such as +// `projects/*/locations/global/collections/default_collection/dataStores/defa +// ult_data_store`. +func (r *ProjectsLocationsCollectionsDataStoresService) CompleteQuery(dataStore string) *ProjectsLocationsCollectionsDataStoresCompleteQueryCall { + c := &ProjectsLocationsCollectionsDataStoresCompleteQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.dataStore = dataStore + return c +} + +// IncludeTailSuggestions sets the optional parameter "includeTailSuggestions": +// 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. +func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) IncludeTailSuggestions(includeTailSuggestions bool) *ProjectsLocationsCollectionsDataStoresCompleteQueryCall { + c.urlParams_.Set("includeTailSuggestions", fmt.Sprint(includeTailSuggestions)) + return c +} + +// Query sets the optional parameter "query": Required. The typeahead input +// used to fetch suggestions. Maximum length is 128 characters. +func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) Query(query string) *ProjectsLocationsCollectionsDataStoresCompleteQueryCall { + c.urlParams_.Set("query", query) + return c +} + +// QueryModel sets the optional parameter "queryModel": 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. +func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) QueryModel(queryModel string) *ProjectsLocationsCollectionsDataStoresCompleteQueryCall { + c.urlParams_.Set("queryModel", queryModel) + return c +} + +// UserPseudoId sets the optional parameter "userPseudoId": 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 characters. Otherwise, an +// `INVALID_ARGUMENT` error is returned. +func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) UserPseudoId(userPseudoId string) *ProjectsLocationsCollectionsDataStoresCompleteQueryCall { + c.urlParams_.Set("userPseudoId", userPseudoId) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresCompleteQueryCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresCompleteQueryCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresCompleteQueryCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDeleteCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+dataStore}:completeQuery") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "dataStore": c.dataStore, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.completeQuery", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.delete" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.completeQuery" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1CompleteQueryResponse.ServerResponse.Header or +// (if a response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1CompleteQueryResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -34144,7 +36021,7 @@ func (c *ProjectsLocationsCollectionsDeleteCall) Do(opts ...googleapi.CallOption if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1CompleteQueryResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -34155,93 +36032,131 @@ func (c *ProjectsLocationsCollectionsDeleteCall) Do(opts ...googleapi.CallOption if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.completeQuery", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsGetDataConnectorCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresCreateCall struct { + s *Service + parent string + googleclouddiscoveryenginev1datastore *GoogleCloudDiscoveryengineV1DataStore + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// GetDataConnector: Gets the DataConnector. DataConnector is a singleton -// resource for each Collection. +// Create: Creates a DataStore. DataStore is for storing Documents. To serve +// these documents for Search, or Recommendation use case, an Engine needs to +// be created separately. // -// - name: Full resource name of DataConnector, such as -// `projects/{project}/locations/{location}/collections/{collection_id}/dataCo -// nnector`. If the caller does not have permission to access the -// DataConnector, regardless of whether or not it exists, a PERMISSION_DENIED -// error is returned. If the requested DataConnector does not exist, a -// NOT_FOUND error is returned. -func (r *ProjectsLocationsCollectionsService) GetDataConnector(name string) *ProjectsLocationsCollectionsGetDataConnectorCall { - c := &ProjectsLocationsCollectionsGetDataConnectorCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: The parent resource name, such as +// `projects/{project}/locations/{location}/collections/{collection}`. +func (r *ProjectsLocationsCollectionsDataStoresService) Create(parent string, googleclouddiscoveryenginev1datastore *GoogleCloudDiscoveryengineV1DataStore) *ProjectsLocationsCollectionsDataStoresCreateCall { + c := &ProjectsLocationsCollectionsDataStoresCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1datastore = googleclouddiscoveryenginev1datastore + return c +} + +// CmekConfigName sets the optional parameter "cmekConfigName": Resource name +// of the CmekConfig to use for protecting this DataStore. +func (c *ProjectsLocationsCollectionsDataStoresCreateCall) CmekConfigName(cmekConfigName string) *ProjectsLocationsCollectionsDataStoresCreateCall { + c.urlParams_.Set("cmekConfigName", cmekConfigName) + return c +} + +// CreateAdvancedSiteSearch sets the optional parameter +// "createAdvancedSiteSearch": A boolean flag indicating whether user want to +// directly create an advanced data store for site search. If the data store is +// not configured as site search (GENERIC vertical and PUBLIC_WEBSITE +// content_config), this flag will be ignored. +func (c *ProjectsLocationsCollectionsDataStoresCreateCall) CreateAdvancedSiteSearch(createAdvancedSiteSearch bool) *ProjectsLocationsCollectionsDataStoresCreateCall { + c.urlParams_.Set("createAdvancedSiteSearch", fmt.Sprint(createAdvancedSiteSearch)) + return c +} + +// DataStoreId sets the optional parameter "dataStoreId": Required. The ID to +// use for the DataStore, which will become the final component of the +// DataStore's resource name. This field must conform to RFC-1034 +// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 +// characters. Otherwise, an INVALID_ARGUMENT error is returned. +func (c *ProjectsLocationsCollectionsDataStoresCreateCall) DataStoreId(dataStoreId string) *ProjectsLocationsCollectionsDataStoresCreateCall { + c.urlParams_.Set("dataStoreId", dataStoreId) + return c +} + +// DisableCmek sets the optional parameter "disableCmek": DataStore without +// CMEK protections. If a default CmekConfig is set for the project, setting +// this field will override the default CmekConfig as well. +func (c *ProjectsLocationsCollectionsDataStoresCreateCall) DisableCmek(disableCmek bool) *ProjectsLocationsCollectionsDataStoresCreateCall { + c.urlParams_.Set("disableCmek", fmt.Sprint(disableCmek)) + return c +} + +// SkipDefaultSchemaCreation sets the optional parameter +// "skipDefaultSchemaCreation": A boolean flag indicating whether to skip the +// default schema creation for the data store. Only enable this flag if you are +// certain that the default schema is incompatible with your use case. If set +// to true, you must manually create a schema for the data store before any +// documents can be ingested. This flag cannot be specified if +// `data_store.starting_schema` is specified. +func (c *ProjectsLocationsCollectionsDataStoresCreateCall) SkipDefaultSchemaCreation(skipDefaultSchemaCreation bool) *ProjectsLocationsCollectionsDataStoresCreateCall { + c.urlParams_.Set("skipDefaultSchemaCreation", fmt.Sprint(skipDefaultSchemaCreation)) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsGetDataConnectorCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsGetDataConnectorCall { +func (c *ProjectsLocationsCollectionsDataStoresCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsGetDataConnectorCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsGetDataConnectorCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsGetDataConnectorCall) Context(ctx context.Context) *ProjectsLocationsCollectionsGetDataConnectorCall { +func (c *ProjectsLocationsCollectionsDataStoresCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresCreateCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsGetDataConnectorCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsGetDataConnectorCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) +func (c *ProjectsLocationsCollectionsDataStoresCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1datastore) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dataStores") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.getDataConnector", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.getDataConnector" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.create" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1DataConnector.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsGetDataConnectorCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1DataConnector, error) { +func (c *ProjectsLocationsCollectionsDataStoresCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -34260,7 +36175,7 @@ func (c *ProjectsLocationsCollectionsGetDataConnectorCall) Do(opts ...googleapi. if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1DataConnector{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -34271,79 +36186,62 @@ func (c *ProjectsLocationsCollectionsGetDataConnectorCall) Do(opts ...googleapi. if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.getDataConnector", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsUpdateDataConnectorCall struct { - s *Service - name string - googleclouddiscoveryenginev1dataconnector *GoogleCloudDiscoveryengineV1DataConnector - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// UpdateDataConnector: Updates a DataConnector. +// Delete: Deletes a DataStore. // -// - name: Output only. The full resource name of the Data Connector. Format: -// `projects/*/locations/*/collections/*/dataConnector`. -func (r *ProjectsLocationsCollectionsService) UpdateDataConnector(name string, googleclouddiscoveryenginev1dataconnector *GoogleCloudDiscoveryengineV1DataConnector) *ProjectsLocationsCollectionsUpdateDataConnectorCall { - c := &ProjectsLocationsCollectionsUpdateDataConnectorCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Full resource name of DataStore, such as +// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt +// ores/{data_store_id}`. If the caller does not have permission to delete +// the DataStore, regardless of whether or not it exists, a PERMISSION_DENIED +// error is returned. If the DataStore to delete does not exist, a NOT_FOUND +// error is returned. +func (r *ProjectsLocationsCollectionsDataStoresService) Delete(name string) *ProjectsLocationsCollectionsDataStoresDeleteCall { + c := &ProjectsLocationsCollectionsDataStoresDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googleclouddiscoveryenginev1dataconnector = googleclouddiscoveryenginev1dataconnector - return c -} - -// UpdateMask sets the optional parameter "updateMask": Indicates which fields -// in the provided DataConnector to update. Supported field paths include: - -// `refresh_interval` - `params` - `auto_run_disabled` - `action_config` - -// `action_config.action_params` - `action_config.service_name` - -// `destination_configs` - `blocking_reasons` - `sync_mode` - -// `incremental_sync_disabled` - `incremental_refresh_interval` - -// `data_protection_policy` Note: Support for these fields may vary depending -// on the connector type. For example, not all connectors support -// `destination_configs`. If an unsupported or unknown field path is provided, -// the request will return an INVALID_ARGUMENT error. -func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsUpdateDataConnectorCall { - c.urlParams_.Set("updateMask", updateMask) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsUpdateDataConnectorCall { +func (c *ProjectsLocationsCollectionsDataStoresDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) Context(ctx context.Context) *ProjectsLocationsCollectionsUpdateDataConnectorCall { +func (c *ProjectsLocationsCollectionsDataStoresDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresDeleteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1dataconnector) - if err != nil { - return nil, err - } +func (c *ProjectsLocationsCollectionsDataStoresDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } @@ -34351,17 +36249,17 @@ func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) doRequest(alt stri googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.updateDataConnector", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.updateDataConnector" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1DataConnector.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1DataConnector, error) { +func (c *ProjectsLocationsCollectionsDataStoresDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -34380,7 +36278,7 @@ func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) Do(opts ...googlea if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1DataConnector{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -34391,11 +36289,11 @@ func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) Do(opts ...googlea if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.updateDataConnector", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataConnectorOperationsGetCall struct { +type ProjectsLocationsCollectionsDataStoresGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -34404,13 +36302,16 @@ type ProjectsLocationsCollectionsDataConnectorOperationsGetCall struct { header_ http.Header } -// Get: 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. +// Get: Gets a DataStore. // -// - name: The name of the operation resource. -func (r *ProjectsLocationsCollectionsDataConnectorOperationsService) Get(name string) *ProjectsLocationsCollectionsDataConnectorOperationsGetCall { - c := &ProjectsLocationsCollectionsDataConnectorOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Full resource name of DataStore, such as +// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt +// ores/{data_store_id}`. If the caller does not have permission to access +// the DataStore, regardless of whether or not it exists, a PERMISSION_DENIED +// error is returned. If the requested DataStore does not exist, a NOT_FOUND +// error is returned. +func (r *ProjectsLocationsCollectionsDataStoresService) Get(name string) *ProjectsLocationsCollectionsDataStoresGetCall { + c := &ProjectsLocationsCollectionsDataStoresGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -34418,7 +36319,7 @@ func (r *ProjectsLocationsCollectionsDataConnectorOperationsService) Get(name st // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataConnectorOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataConnectorOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -34426,27 +36327,27 @@ func (c *ProjectsLocationsCollectionsDataConnectorOperationsGetCall) Fields(s .. // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataConnectorOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataConnectorOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataConnectorOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataConnectorOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataConnectorOperationsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataConnectorOperationsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -34463,17 +36364,17 @@ func (c *ProjectsLocationsCollectionsDataConnectorOperationsGetCall) doRequest(a googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataConnector.operations.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataConnector.operations.get" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1DataStore.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataConnectorOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1DataStore, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -34492,7 +36393,7 @@ func (c *ProjectsLocationsCollectionsDataConnectorOperationsGetCall) Do(opts ... if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1DataStore{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -34503,11 +36404,11 @@ func (c *ProjectsLocationsCollectionsDataConnectorOperationsGetCall) Do(opts ... if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataConnector.operations.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataConnectorOperationsListCall struct { +type ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -34516,53 +36417,23 @@ type ProjectsLocationsCollectionsDataConnectorOperationsListCall struct { header_ http.Header } -// List: Lists operations that match the specified filter in the request. If -// the server doesn't support this method, it returns `UNIMPLEMENTED`. +// GetSiteSearchEngine: Gets the SiteSearchEngine. // -// - name: The name of the operation's parent resource. -func (r *ProjectsLocationsCollectionsDataConnectorOperationsService) List(name string) *ProjectsLocationsCollectionsDataConnectorOperationsListCall { - c := &ProjectsLocationsCollectionsDataConnectorOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Resource name of SiteSearchEngine, such as +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/siteSearchEngine`. If the caller does not have permission +// to access the [SiteSearchEngine], regardless of whether or not it exists, +// a PERMISSION_DENIED error is returned. +func (r *ProjectsLocationsCollectionsDataStoresService) GetSiteSearchEngine(name string) *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall { + c := &ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } -// Filter sets the optional parameter "filter": The standard list filter. -func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataConnectorOperationsListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// PageSize sets the optional parameter "pageSize": The standard list page -// size. -func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataConnectorOperationsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": The standard list page -// token. -func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataConnectorOperationsListCall { - c.urlParams_.Set("pageToken", pageToken) - return c -} - -// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": -// When set to `true`, operations that are reachable are returned as normal, -// and those that are unreachable are returned in the -// ListOperationsResponse.unreachable field. This can only be `true` when -// reading across collections. For example, when `parent` is set to -// "projects/example/locations/-". This field is not supported by default and -// will result in an `UNIMPLEMENTED` error if set unless explicitly documented -// otherwise in service or product specific documentation. -func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsCollectionsDataConnectorOperationsListCall { - c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) - return c -} - // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataConnectorOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -34570,34 +36441,34 @@ func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) Fields(s . // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataConnectorOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataConnectorOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/operations") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -34607,17 +36478,17 @@ func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) doRequest( googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataConnector.operations.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.getSiteSearchEngine", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataConnector.operations.list" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.getSiteSearchEngine" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningListOperationsResponse.ServerResponse.Header or (if a +// *GoogleCloudDiscoveryengineV1SiteSearchEngine.ServerResponse.Header or (if a // response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1SiteSearchEngine, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -34636,7 +36507,7 @@ func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) Do(opts .. if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningListOperationsResponse{ + ret := &GoogleCloudDiscoveryengineV1SiteSearchEngine{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -34647,104 +36518,63 @@ func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) Do(opts .. if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataConnector.operations.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.getSiteSearchEngine", "response", internallog.HTTPResponse(res, b)) return ret, nil } -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataConnectorOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.PageToken(x.NextPageToken) - } -} - -type ProjectsLocationsCollectionsDataStoresCompleteQueryCall struct { +type ProjectsLocationsCollectionsDataStoresListCall struct { s *Service - dataStore string + parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// CompleteQuery: Completes the specified user input with keyword suggestions. +// List: Lists all the DataStores associated with the project. // -// - dataStore: The parent data store resource name for which the completion is -// performed, such as -// `projects/*/locations/global/collections/default_collection/dataStores/defa -// ult_data_store`. -func (r *ProjectsLocationsCollectionsDataStoresService) CompleteQuery(dataStore string) *ProjectsLocationsCollectionsDataStoresCompleteQueryCall { - c := &ProjectsLocationsCollectionsDataStoresCompleteQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.dataStore = dataStore - return c -} - -// IncludeTailSuggestions sets the optional parameter "includeTailSuggestions": -// 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. -func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) IncludeTailSuggestions(includeTailSuggestions bool) *ProjectsLocationsCollectionsDataStoresCompleteQueryCall { - c.urlParams_.Set("includeTailSuggestions", fmt.Sprint(includeTailSuggestions)) +// - parent: The parent branch resource name, such as +// `projects/{project}/locations/{location}/collections/{collection_id}`. If +// the caller does not have permission to list DataStores under this +// location, regardless of whether or not this data store exists, a +// PERMISSION_DENIED error is returned. +func (r *ProjectsLocationsCollectionsDataStoresService) List(parent string) *ProjectsLocationsCollectionsDataStoresListCall { + c := &ProjectsLocationsCollectionsDataStoresListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent return c } -// Query sets the optional parameter "query": Required. The typeahead input -// used to fetch suggestions. Maximum length is 128 characters. -func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) Query(query string) *ProjectsLocationsCollectionsDataStoresCompleteQueryCall { - c.urlParams_.Set("query", query) +// Filter sets the optional parameter "filter": Filter by solution type . For +// example: `filter = 'solution_type:SOLUTION_TYPE_SEARCH'` +func (c *ProjectsLocationsCollectionsDataStoresListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresListCall { + c.urlParams_.Set("filter", filter) return c } -// QueryModel sets the optional parameter "queryModel": 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. -func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) QueryModel(queryModel string) *ProjectsLocationsCollectionsDataStoresCompleteQueryCall { - c.urlParams_.Set("queryModel", queryModel) +// PageSize sets the optional parameter "pageSize": Maximum number of +// DataStores to return. If unspecified, defaults to 10. The maximum allowed +// value is 50. Values above 50 will be coerced to 50. If this field is +// negative, an INVALID_ARGUMENT is returned. +func (c *ProjectsLocationsCollectionsDataStoresListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } -// UserPseudoId sets the optional parameter "userPseudoId": 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 characters. Otherwise, an -// `INVALID_ARGUMENT` error is returned. -func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) UserPseudoId(userPseudoId string) *ProjectsLocationsCollectionsDataStoresCompleteQueryCall { - c.urlParams_.Set("userPseudoId", userPseudoId) +// PageToken sets the optional parameter "pageToken": A page token +// ListDataStoresResponse.next_page_token, received from a previous +// DataStoreService.ListDataStores call. Provide this to retrieve the +// subsequent page. When paginating, all other parameters provided to +// DataStoreService.ListDataStores must match the call that provided the page +// token. Otherwise, an INVALID_ARGUMENT error is returned. +func (c *ProjectsLocationsCollectionsDataStoresListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresListCall { + c.urlParams_.Set("pageToken", pageToken) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresCompleteQueryCall { +func (c *ProjectsLocationsCollectionsDataStoresListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -34752,34 +36582,34 @@ func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) Fields(s ...go // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresCompleteQueryCall { +func (c *ProjectsLocationsCollectionsDataStoresListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresCompleteQueryCall { +func (c *ProjectsLocationsCollectionsDataStoresListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+dataStore}:completeQuery") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dataStores") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -34787,19 +36617,19 @@ func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) doRequest(alt } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "dataStore": c.dataStore, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.completeQuery", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.completeQuery" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1CompleteQueryResponse.ServerResponse.Header or +// *GoogleCloudDiscoveryengineV1ListDataStoresResponse.ServerResponse.Header or // (if a response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1CompleteQueryResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListDataStoresResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -34818,7 +36648,7 @@ func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) Do(opts ...goo if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1CompleteQueryResponse{ + ret := &GoogleCloudDiscoveryengineV1ListDataStoresResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -34829,103 +36659,86 @@ func (c *ProjectsLocationsCollectionsDataStoresCompleteQueryCall) Do(opts ...goo if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.completeQuery", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresCreateCall struct { +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsCollectionsDataStoresListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListDataStoresResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type ProjectsLocationsCollectionsDataStoresPatchCall struct { s *Service - parent string + name string googleclouddiscoveryenginev1datastore *GoogleCloudDiscoveryengineV1DataStore urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } -// Create: Creates a DataStore. DataStore is for storing Documents. To serve -// these documents for Search, or Recommendation use case, an Engine needs to -// be created separately. +// Patch: Updates a DataStore // -// - parent: The parent resource name, such as -// `projects/{project}/locations/{location}/collections/{collection}`. -func (r *ProjectsLocationsCollectionsDataStoresService) Create(parent string, googleclouddiscoveryenginev1datastore *GoogleCloudDiscoveryengineV1DataStore) *ProjectsLocationsCollectionsDataStoresCreateCall { - c := &ProjectsLocationsCollectionsDataStoresCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent +// - name: Immutable. Identifier. The full resource name of the data store. +// Format: +// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt +// ores/{data_store_id}`. This field must be a UTF-8 encoded string with a +// length limit of 1024 characters. +func (r *ProjectsLocationsCollectionsDataStoresService) Patch(name string, googleclouddiscoveryenginev1datastore *GoogleCloudDiscoveryengineV1DataStore) *ProjectsLocationsCollectionsDataStoresPatchCall { + c := &ProjectsLocationsCollectionsDataStoresPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name c.googleclouddiscoveryenginev1datastore = googleclouddiscoveryenginev1datastore return c } -// CmekConfigName sets the optional parameter "cmekConfigName": Resource name -// of the CmekConfig to use for protecting this DataStore. -func (c *ProjectsLocationsCollectionsDataStoresCreateCall) CmekConfigName(cmekConfigName string) *ProjectsLocationsCollectionsDataStoresCreateCall { - c.urlParams_.Set("cmekConfigName", cmekConfigName) - return c -} - -// CreateAdvancedSiteSearch sets the optional parameter -// "createAdvancedSiteSearch": A boolean flag indicating whether user want to -// directly create an advanced data store for site search. If the data store is -// not configured as site search (GENERIC vertical and PUBLIC_WEBSITE -// content_config), this flag will be ignored. -func (c *ProjectsLocationsCollectionsDataStoresCreateCall) CreateAdvancedSiteSearch(createAdvancedSiteSearch bool) *ProjectsLocationsCollectionsDataStoresCreateCall { - c.urlParams_.Set("createAdvancedSiteSearch", fmt.Sprint(createAdvancedSiteSearch)) - return c -} - -// DataStoreId sets the optional parameter "dataStoreId": Required. The ID to -// use for the DataStore, which will become the final component of the -// DataStore's resource name. This field must conform to RFC-1034 -// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 -// characters. Otherwise, an INVALID_ARGUMENT error is returned. -func (c *ProjectsLocationsCollectionsDataStoresCreateCall) DataStoreId(dataStoreId string) *ProjectsLocationsCollectionsDataStoresCreateCall { - c.urlParams_.Set("dataStoreId", dataStoreId) - return c -} - -// DisableCmek sets the optional parameter "disableCmek": DataStore without -// CMEK protections. If a default CmekConfig is set for the project, setting -// this field will override the default CmekConfig as well. -func (c *ProjectsLocationsCollectionsDataStoresCreateCall) DisableCmek(disableCmek bool) *ProjectsLocationsCollectionsDataStoresCreateCall { - c.urlParams_.Set("disableCmek", fmt.Sprint(disableCmek)) - return c -} - -// SkipDefaultSchemaCreation sets the optional parameter -// "skipDefaultSchemaCreation": A boolean flag indicating whether to skip the -// default schema creation for the data store. Only enable this flag if you are -// certain that the default schema is incompatible with your use case. If set -// to true, you must manually create a schema for the data store before any -// documents can be ingested. This flag cannot be specified if -// `data_store.starting_schema` is specified. -func (c *ProjectsLocationsCollectionsDataStoresCreateCall) SkipDefaultSchemaCreation(skipDefaultSchemaCreation bool) *ProjectsLocationsCollectionsDataStoresCreateCall { - c.urlParams_.Set("skipDefaultSchemaCreation", fmt.Sprint(skipDefaultSchemaCreation)) +// UpdateMask sets the optional parameter "updateMask": Indicates which fields +// in the provided DataStore to update. If an unsupported or unknown field is +// provided, an INVALID_ARGUMENT error is returned. +func (c *ProjectsLocationsCollectionsDataStoresPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsDataStoresPatchCall { + c.urlParams_.Set("updateMask", updateMask) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresPatchCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresCreateCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1datastore) if err != nil { @@ -34933,27 +36746,27 @@ func (c *ProjectsLocationsCollectionsDataStoresCreateCall) doRequest(alt string) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dataStores") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.patch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.create" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.patch" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1DataStore.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1DataStore, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -34972,7 +36785,7 @@ func (c *ProjectsLocationsCollectionsDataStoresCreateCall) Do(opts ...googleapi. if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1DataStore{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -34983,80 +36796,84 @@ func (c *ProjectsLocationsCollectionsDataStoresCreateCall) Do(opts ...googleapi. if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.patch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresTrainCustomModelCall struct { + s *Service + dataStore string + googleclouddiscoveryenginev1traincustommodelrequest *GoogleCloudDiscoveryengineV1TrainCustomModelRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Delete: Deletes a DataStore. +// TrainCustomModel: Trains a custom model. // -// - name: Full resource name of DataStore, such as -// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt -// ores/{data_store_id}`. If the caller does not have permission to delete -// the DataStore, regardless of whether or not it exists, a PERMISSION_DENIED -// error is returned. If the DataStore to delete does not exist, a NOT_FOUND -// error is returned. -func (r *ProjectsLocationsCollectionsDataStoresService) Delete(name string) *ProjectsLocationsCollectionsDataStoresDeleteCall { - c := &ProjectsLocationsCollectionsDataStoresDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - dataStore: The resource name of the Data Store, such as +// `projects/*/locations/global/collections/default_collection/dataStores/defa +// ult_data_store`. This field is used to identify the data store where to +// train the models. +func (r *ProjectsLocationsCollectionsDataStoresService) TrainCustomModel(dataStore string, googleclouddiscoveryenginev1traincustommodelrequest *GoogleCloudDiscoveryengineV1TrainCustomModelRequest) *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall { + c := &ProjectsLocationsCollectionsDataStoresTrainCustomModelCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.dataStore = dataStore + c.googleclouddiscoveryenginev1traincustommodelrequest = googleclouddiscoveryenginev1traincustommodelrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresDeleteCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresDeleteCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) +func (c *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1traincustommodelrequest) + if err != nil { + return nil, err + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+dataStore}:trainCustomModel") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "dataStore": c.dataStore, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.trainCustomModel", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.delete" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.trainCustomModel" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -35086,37 +36903,52 @@ func (c *ProjectsLocationsCollectionsDataStoresDeleteCall) Do(opts ...googleapi. if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.trainCustomModel", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresGetCall struct { +type ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall struct { s *Service - name string + parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// Get: Gets a DataStore. +// BatchGetDocumentsMetadata: Gets index freshness metadata for Documents. +// Supported for website search only. // -// - name: Full resource name of DataStore, such as -// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt -// ores/{data_store_id}`. If the caller does not have permission to access -// the DataStore, regardless of whether or not it exists, a PERMISSION_DENIED -// error is returned. If the requested DataStore does not exist, a NOT_FOUND -// error is returned. -func (r *ProjectsLocationsCollectionsDataStoresService) Get(name string) *ProjectsLocationsCollectionsDataStoresGetCall { - c := &ProjectsLocationsCollectionsDataStoresGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: The parent branch resource name, such as +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/branches/{branch}`. +func (r *ProjectsLocationsCollectionsDataStoresBranchesService) BatchGetDocumentsMetadata(parent string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// MatcherFhirMatcherFhirResources sets the optional parameter +// "matcher.fhirMatcher.fhirResources": Required. The FHIR resources to match +// by. Format: +// projects/{project}/locations/{location}/datasets/{dataset}/fhirStores/{fhir_s +// tore}/fhir/{resource_type}/{fhir_resource_id} +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) MatcherFhirMatcherFhirResources(matcherFhirMatcherFhirResources ...string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + c.urlParams_.SetMulti("matcher.fhirMatcher.fhirResources", append([]string{}, matcherFhirMatcherFhirResources...)) + return c +} + +// MatcherUrisMatcherUris sets the optional parameter +// "matcher.urisMatcher.uris": The exact URIs to match by. +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) MatcherUrisMatcherUris(matcherUrisMatcherUris ...string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + c.urlParams_.SetMulti("matcher.urisMatcher.uris", append([]string{}, matcherUrisMatcherUris...)) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresGetCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -35124,34 +36956,34 @@ func (c *ProjectsLocationsCollectionsDataStoresGetCall) Fields(s ...googleapi.Fi // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresGetCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresGetCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/batchGetDocumentsMetadata") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -35159,19 +36991,19 @@ func (c *ProjectsLocationsCollectionsDataStoresGetCall) doRequest(alt string) (* } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.batchGetDocumentsMetadata", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.get" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.batchGetDocumentsMetadata" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1DataStore.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1DataStore, error) { +// *GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse.ServerResponse +// .Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -35190,7 +37022,7 @@ func (c *ProjectsLocationsCollectionsDataStoresGetCall) Do(opts ...googleapi.Cal if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1DataStore{ + ret := &GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -35201,91 +37033,96 @@ func (c *ProjectsLocationsCollectionsDataStoresGetCall) Do(opts ...googleapi.Cal if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.batchGetDocumentsMetadata", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall struct { + s *Service + parent string + googleclouddiscoveryenginev1document *GoogleCloudDiscoveryengineV1Document + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// GetSiteSearchEngine: Gets the SiteSearchEngine. +// Create: Creates a Document. // -// - name: Resource name of SiteSearchEngine, such as +// - parent: The parent resource name, such as // `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/siteSearchEngine`. If the caller does not have permission -// to access the [SiteSearchEngine], regardless of whether or not it exists, -// a PERMISSION_DENIED error is returned. -func (r *ProjectsLocationsCollectionsDataStoresService) GetSiteSearchEngine(name string) *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall { - c := &ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// s/{data_store}/branches/{branch}`. +func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Create(parent string, googleclouddiscoveryenginev1document *GoogleCloudDiscoveryengineV1Document) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1document = googleclouddiscoveryenginev1document + return c +} + +// DocumentId sets the optional parameter "documentId": Required. The ID to use +// for the Document, which becomes the final component of the Document.name. If +// the caller does not have permission to create the Document, regardless of +// whether or not it exists, a `PERMISSION_DENIED` error is returned. This +// field must be unique among all Documents with the same parent. Otherwise, an +// `ALREADY_EXISTS` error is returned. This field must conform to RFC-1034 +// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 +// characters. Otherwise, an `INVALID_ARGUMENT` error is returned. +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) DocumentId(documentId string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall { + c.urlParams_.Set("documentId", documentId) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1document) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/documents") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.getSiteSearchEngine", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.getSiteSearchEngine" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.documents.create" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1SiteSearchEngine.ServerResponse.Header or (if a +// *GoogleCloudDiscoveryengineV1Document.ServerResponse.Header or (if a // response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1SiteSearchEngine, error) { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Document, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -35304,7 +37141,7 @@ func (c *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall) Do(opts if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1SiteSearchEngine{ + ret := &GoogleCloudDiscoveryengineV1Document{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -35315,118 +37152,80 @@ func (c *ProjectsLocationsCollectionsDataStoresGetSiteSearchEngineCall) Do(opts if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.getSiteSearchEngine", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// List: Lists all the DataStores associated with the project. +// Delete: Deletes a Document. // -// - parent: The parent branch resource name, such as -// `projects/{project}/locations/{location}/collections/{collection_id}`. If -// the caller does not have permission to list DataStores under this -// location, regardless of whether or not this data store exists, a -// PERMISSION_DENIED error is returned. -func (r *ProjectsLocationsCollectionsDataStoresService) List(parent string) *ProjectsLocationsCollectionsDataStoresListCall { - c := &ProjectsLocationsCollectionsDataStoresListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// Filter sets the optional parameter "filter": Filter by solution type . For -// example: `filter = 'solution_type:SOLUTION_TYPE_SEARCH'` -func (c *ProjectsLocationsCollectionsDataStoresListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// PageSize sets the optional parameter "pageSize": Maximum number of -// DataStores to return. If unspecified, defaults to 10. The maximum allowed -// value is 50. Values above 50 will be coerced to 50. If this field is -// negative, an INVALID_ARGUMENT is returned. -func (c *ProjectsLocationsCollectionsDataStoresListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": A page token -// ListDataStoresResponse.next_page_token, received from a previous -// DataStoreService.ListDataStores call. Provide this to retrieve the -// subsequent page. When paginating, all other parameters provided to -// DataStoreService.ListDataStores must match the call that provided the page -// token. Otherwise, an INVALID_ARGUMENT error is returned. -func (c *ProjectsLocationsCollectionsDataStoresListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresListCall { - c.urlParams_.Set("pageToken", pageToken) +// - name: Full resource name of Document, such as +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/branches/{branch}/documents/{document}`. If the caller does +// not have permission to delete the Document, regardless of whether or not +// it exists, a `PERMISSION_DENIED` error is returned. If the Document to +// delete does not exist, a `NOT_FOUND` error is returned. +func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Delete(name string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresListCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresListCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresListCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dataStores") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.list" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.documents.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ListDataStoresResponse.ServerResponse.Header or -// (if a response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListDataStoresResponse, error) { +// *GoogleProtobufEmpty.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -35445,7 +37244,7 @@ func (c *ProjectsLocationsCollectionsDataStoresListCall) Do(opts ...googleapi.Ca if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ListDataStoresResponse{ + ret := &GoogleProtobufEmpty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -35456,96 +37255,74 @@ func (c *ProjectsLocationsCollectionsDataStoresListCall) Do(opts ...googleapi.Ca if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListDataStoresResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.PageToken(x.NextPageToken) - } -} - -type ProjectsLocationsCollectionsDataStoresPatchCall struct { - s *Service - name string - googleclouddiscoveryenginev1datastore *GoogleCloudDiscoveryengineV1DataStore - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Patch: Updates a DataStore +// Get: Gets a Document. // -// - name: Immutable. Identifier. The full resource name of the data store. -// Format: -// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt -// ores/{data_store_id}`. This field must be a UTF-8 encoded string with a -// length limit of 1024 characters. -func (r *ProjectsLocationsCollectionsDataStoresService) Patch(name string, googleclouddiscoveryenginev1datastore *GoogleCloudDiscoveryengineV1DataStore) *ProjectsLocationsCollectionsDataStoresPatchCall { - c := &ProjectsLocationsCollectionsDataStoresPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Full resource name of Document, such as +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/branches/{branch}/documents/{document}`. If the caller does +// not have permission to access the Document, regardless of whether or not +// it exists, a `PERMISSION_DENIED` error is returned. If the requested +// Document does not exist, a `NOT_FOUND` error is returned. +func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Get(name string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googleclouddiscoveryenginev1datastore = googleclouddiscoveryenginev1datastore - return c -} - -// UpdateMask sets the optional parameter "updateMask": Indicates which fields -// in the provided DataStore to update. If an unsupported or unknown field is -// provided, an INVALID_ARGUMENT error is returned. -func (c *ProjectsLocationsCollectionsDataStoresPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsDataStoresPatchCall { - c.urlParams_.Set("updateMask", updateMask) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresPatchCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresPatchCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresPatchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresPatchCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1datastore) - if err != nil { - return nil, err +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -35553,17 +37330,17 @@ func (c *ProjectsLocationsCollectionsDataStoresPatchCall) doRequest(alt string) googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.patch" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.documents.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1DataStore.ServerResponse.Header or (if a +// *GoogleCloudDiscoveryengineV1Document.ServerResponse.Header or (if a // response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1DataStore, error) { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Document, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -35582,7 +37359,7 @@ func (c *ProjectsLocationsCollectionsDataStoresPatchCall) Do(opts ...googleapi.C if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1DataStore{ + ret := &GoogleCloudDiscoveryengineV1Document{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -35593,64 +37370,65 @@ func (c *ProjectsLocationsCollectionsDataStoresPatchCall) Do(opts ...googleapi.C if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.patch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresTrainCustomModelCall struct { - s *Service - dataStore string - googleclouddiscoveryenginev1traincustommodelrequest *GoogleCloudDiscoveryengineV1TrainCustomModelRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall struct { + s *Service + parent string + googleclouddiscoveryenginev1importdocumentsrequest *GoogleCloudDiscoveryengineV1ImportDocumentsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// TrainCustomModel: Trains a custom model. +// Import: Bulk import of multiple Documents. Request processing may be +// synchronous. Non-existing items are created. Note: It is possible for a +// subset of the Documents to be successfully updated. // -// - dataStore: The resource name of the Data Store, such as -// `projects/*/locations/global/collections/default_collection/dataStores/defa -// ult_data_store`. This field is used to identify the data store where to -// train the models. -func (r *ProjectsLocationsCollectionsDataStoresService) TrainCustomModel(dataStore string, googleclouddiscoveryenginev1traincustommodelrequest *GoogleCloudDiscoveryengineV1TrainCustomModelRequest) *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall { - c := &ProjectsLocationsCollectionsDataStoresTrainCustomModelCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.dataStore = dataStore - c.googleclouddiscoveryenginev1traincustommodelrequest = googleclouddiscoveryenginev1traincustommodelrequest +// - parent: The parent branch resource name, such as +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/branches/{branch}`. Requires create/update permission. +func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Import(parent string, googleclouddiscoveryenginev1importdocumentsrequest *GoogleCloudDiscoveryengineV1ImportDocumentsRequest) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1importdocumentsrequest = googleclouddiscoveryenginev1importdocumentsrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1traincustommodelrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1importdocumentsrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+dataStore}:trainCustomModel") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/documents:import") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -35658,19 +37436,19 @@ func (c *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) doRequest(a } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "dataStore": c.dataStore, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.trainCustomModel", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.import", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.trainCustomModel" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.documents.import" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -35700,11 +37478,11 @@ func (c *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) Do(opts ... if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.trainCustomModel", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.import", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall struct { +type ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall struct { s *Service parent string urlParams_ gensupport.URLParams @@ -35713,39 +37491,44 @@ type ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall header_ http.Header } -// BatchGetDocumentsMetadata: Gets index freshness metadata for Documents. -// Supported for website search only. +// List: Gets a list of Documents. // // - parent: The parent branch resource name, such as // `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/branches/{branch}`. -func (r *ProjectsLocationsCollectionsDataStoresBranchesService) BatchGetDocumentsMetadata(parent string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { - c := &ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// s/{data_store}/branches/{branch}`. Use `default_branch` as the branch ID, +// to list documents under the default branch. If the caller does not have +// permission to list Documents under this branch, regardless of whether or +// not this branch exists, a `PERMISSION_DENIED` error is returned. +func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) List(parent string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// MatcherFhirMatcherFhirResources sets the optional parameter -// "matcher.fhirMatcher.fhirResources": Required. The FHIR resources to match -// by. Format: -// projects/{project}/locations/{location}/datasets/{dataset}/fhirStores/{fhir_s -// tore}/fhir/{resource_type}/{fhir_resource_id} -func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) MatcherFhirMatcherFhirResources(matcherFhirMatcherFhirResources ...string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { - c.urlParams_.SetMulti("matcher.fhirMatcher.fhirResources", append([]string{}, matcherFhirMatcherFhirResources...)) +// PageSize sets the optional parameter "pageSize": Maximum number of Documents +// to return. If unspecified, defaults to 100. The maximum allowed value is +// 1000. Values above 1000 are set to 1000. If this field is negative, an +// `INVALID_ARGUMENT` error is returned. +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } -// MatcherUrisMatcherUris sets the optional parameter -// "matcher.urisMatcher.uris": The exact URIs to match by. -func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) MatcherUrisMatcherUris(matcherUrisMatcherUris ...string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { - c.urlParams_.SetMulti("matcher.urisMatcher.uris", append([]string{}, matcherUrisMatcherUris...)) +// PageToken sets the optional parameter "pageToken": A page token +// ListDocumentsResponse.next_page_token, received from a previous +// DocumentService.ListDocuments call. Provide this to retrieve the subsequent +// page. When paginating, all other parameters provided to +// DocumentService.ListDocuments must match the call that provided the page +// token. Otherwise, an `INVALID_ARGUMENT` error is returned. +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall { + c.urlParams_.Set("pageToken", pageToken) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -35753,34 +37536,34 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadata // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/batchGetDocumentsMetadata") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/documents") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -35790,17 +37573,17 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadata googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.batchGetDocumentsMetadata", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.batchGetDocumentsMetadata" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.documents.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse.ServerResponse -// .Header or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse, error) { +// *GoogleCloudDiscoveryengineV1ListDocumentsResponse.ServerResponse.Header or +// (if a response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListDocumentsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -35819,7 +37602,7 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadata if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse{ + ret := &GoogleCloudDiscoveryengineV1ListDocumentsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -35830,68 +37613,92 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadata if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.batchGetDocumentsMetadata", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall struct { +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListDocumentsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall struct { s *Service - parent string + name string googleclouddiscoveryenginev1document *GoogleCloudDiscoveryengineV1Document urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } -// Create: Creates a Document. +// Patch: Updates a Document. // -// - parent: The parent resource name, such as +// - name: Immutable. The full resource name of the document. Format: // `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/branches/{branch}`. -func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Create(parent string, googleclouddiscoveryenginev1document *GoogleCloudDiscoveryengineV1Document) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall { - c := &ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent +// s/{data_store}/branches/{branch}/documents/{document_id}`. This field must +// be a UTF-8 encoded string with a length limit of 1024 characters. +func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Patch(name string, googleclouddiscoveryenginev1document *GoogleCloudDiscoveryengineV1Document) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name c.googleclouddiscoveryenginev1document = googleclouddiscoveryenginev1document return c } -// DocumentId sets the optional parameter "documentId": Required. The ID to use -// for the Document, which becomes the final component of the Document.name. If -// the caller does not have permission to create the Document, regardless of -// whether or not it exists, a `PERMISSION_DENIED` error is returned. This -// field must be unique among all Documents with the same parent. Otherwise, an -// `ALREADY_EXISTS` error is returned. This field must conform to RFC-1034 -// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 -// characters. Otherwise, an `INVALID_ARGUMENT` error is returned. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) DocumentId(documentId string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall { - c.urlParams_.Set("documentId", documentId) +// AllowMissing sets the optional parameter "allowMissing": If set to `true` +// and the Document is not found, a new Document is be created. +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) AllowMissing(allowMissing bool) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// UpdateMask sets the optional parameter "updateMask": Indicates which fields +// in the provided imported 'document' to update. If not set, by default +// updates all fields. +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall { + c.urlParams_.Set("updateMask", updateMask) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1document) if err != nil { @@ -35899,27 +37706,27 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) doRe } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/documents") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.patch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.documents.create" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.documents.patch" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleCloudDiscoveryengineV1Document.ServerResponse.Header or (if a // response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Document, error) { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Document, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -35949,80 +37756,88 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) Do(o if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.patch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall struct { + s *Service + parent string + googleclouddiscoveryenginev1purgedocumentsrequest *GoogleCloudDiscoveryengineV1PurgeDocumentsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Delete: Deletes a Document. +// Purge: Permanently deletes all selected Documents in a branch. This process +// is asynchronous. Depending on the number of Documents to be deleted, this +// operation can take hours to complete. Before the delete operation completes, +// some Documents might still be returned by DocumentService.GetDocument or +// DocumentService.ListDocuments. To get a list of the Documents to be deleted, +// set PurgeDocumentsRequest.force to false. // -// - name: Full resource name of Document, such as +// - parent: The parent resource name, such as // `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/branches/{branch}/documents/{document}`. If the caller does -// not have permission to delete the Document, regardless of whether or not -// it exists, a `PERMISSION_DENIED` error is returned. If the Document to -// delete does not exist, a `NOT_FOUND` error is returned. -func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Delete(name string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall { - c := &ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// s/{data_store}/branches/{branch}`. +func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Purge(parent string, googleclouddiscoveryenginev1purgedocumentsrequest *GoogleCloudDiscoveryengineV1PurgeDocumentsRequest) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1purgedocumentsrequest = googleclouddiscoveryenginev1purgedocumentsrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1purgedocumentsrequest) + if err != nil { + return nil, err + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/documents:purge") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.purge", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.documents.delete" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.documents.purge" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleProtobufEmpty.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -36041,7 +37856,7 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall) Do(o if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleProtobufEmpty{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -36052,74 +37867,71 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsDeleteCall) Do(o if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.purge", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall struct { + s *Service + name string + googlelongrunningcanceloperationrequest *GoogleLongrunningCancelOperationRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Get: Gets a Document. +// Cancel: 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`. // -// - name: Full resource name of Document, such as -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/branches/{branch}/documents/{document}`. If the caller does -// not have permission to access the Document, regardless of whether or not -// it exists, a `PERMISSION_DENIED` error is returned. If the requested -// Document does not exist, a `NOT_FOUND` error is returned. -func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Get(name string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall { - c := &ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The name of the operation resource to be cancelled. +func (r *ProjectsLocationsCollectionsDataStoresBranchesOperationsService) Cancel(name string, googlelongrunningcanceloperationrequest *GoogleLongrunningCancelOperationRequest) *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name + c.googlelongrunningcanceloperationrequest = googlelongrunningcanceloperationrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlelongrunningcanceloperationrequest) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:cancel") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } @@ -36127,17 +37939,17 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall) doReque googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.operations.cancel", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.documents.get" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.operations.cancel" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Document.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Document, error) { +// *GoogleProtobufEmpty.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -36156,7 +37968,7 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall) Do(opts if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Document{ + ret := &GoogleProtobufEmpty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -36167,85 +37979,89 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsGetCall) Do(opts if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.operations.cancel", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall struct { - s *Service - parent string - googleclouddiscoveryenginev1importdocumentsrequest *GoogleCloudDiscoveryengineV1ImportDocumentsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Import: Bulk import of multiple Documents. Request processing may be -// synchronous. Non-existing items are created. Note: It is possible for a -// subset of the Documents to be successfully updated. +// Get: 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. // -// - parent: The parent branch resource name, such as -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/branches/{branch}`. Requires create/update permission. -func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Import(parent string, googleclouddiscoveryenginev1importdocumentsrequest *GoogleCloudDiscoveryengineV1ImportDocumentsRequest) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall { - c := &ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.googleclouddiscoveryenginev1importdocumentsrequest = googleclouddiscoveryenginev1importdocumentsrequest +// - name: The name of the operation resource. +func (r *ProjectsLocationsCollectionsDataStoresBranchesOperationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } - return c.header_ -} - -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1importdocumentsrequest) - if err != nil { - return nil, err + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/documents:import") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.import", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.operations.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.documents.import" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.operations.get" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -36275,57 +38091,66 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsImportCall) Do(o if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.import", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.operations.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall struct { +type ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall struct { s *Service - parent string + name string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// List: Gets a list of Documents. +// List: Lists operations that match the specified filter in the request. If +// the server doesn't support this method, it returns `UNIMPLEMENTED`. // -// - parent: The parent branch resource name, such as -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/branches/{branch}`. Use `default_branch` as the branch ID, -// to list documents under the default branch. If the caller does not have -// permission to list Documents under this branch, regardless of whether or -// not this branch exists, a `PERMISSION_DENIED` error is returned. -func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) List(parent string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall { - c := &ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent +// - name: The name of the operation's parent resource. +func (r *ProjectsLocationsCollectionsDataStoresBranchesOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name return c } -// PageSize sets the optional parameter "pageSize": Maximum number of Documents -// to return. If unspecified, defaults to 100. The maximum allowed value is -// 1000. Values above 1000 are set to 1000. If this field is negative, an -// `INVALID_ARGUMENT` error is returned. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall { +// Filter sets the optional parameter "filter": The standard list filter. +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list page +// size. +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } -// PageToken sets the optional parameter "pageToken": A page token -// ListDocumentsResponse.next_page_token, received from a previous -// DocumentService.ListDocuments call. Provide this to retrieve the subsequent -// page. When paginating, all other parameters provided to -// DocumentService.ListDocuments must match the call that provided the page -// token. Otherwise, an `INVALID_ARGUMENT` error is returned. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall { +// PageToken sets the optional parameter "pageToken": The standard list page +// token. +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { c.urlParams_.Set("pageToken", pageToken) return c } +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": +// When set to `true`, operations that are reachable are returned as normal, +// and those that are unreachable are returned in the +// ListOperationsResponse.unreachable field. This can only be `true` when +// reading across collections. For example, when `parent` is set to +// "projects/example/locations/-". This field is not supported by default and +// will result in an `UNIMPLEMENTED` error if set unless explicitly documented +// otherwise in service or product specific documentation. +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -36333,34 +38158,34 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) Fields // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/documents") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/operations") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -36368,19 +38193,19 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) doRequ } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.operations.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.documents.list" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.operations.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ListDocumentsResponse.ServerResponse.Header or -// (if a response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningListOperationsResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListDocumentsResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -36399,7 +38224,7 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) Do(opt if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ListDocumentsResponse{ + ret := &GoogleLongrunningListOperationsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -36410,14 +38235,14 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) Do(opt if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.operations.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListDocumentsResponse) error) error { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -36435,95 +38260,188 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsListCall) Pages( } } -type ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall struct { - s *Service - name string - googleclouddiscoveryenginev1document *GoogleCloudDiscoveryengineV1Document - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall struct { + s *Service + completionConfig string + googleclouddiscoveryenginev1advancedcompletequeryrequest *GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Patch: Updates a Document. +// CompleteQuery: Completes the user input with advanced keyword suggestions. // -// - name: Immutable. The full resource name of the document. Format: -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/branches/{branch}/documents/{document_id}`. This field must -// be a UTF-8 encoded string with a length limit of 1024 characters. -func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Patch(name string, googleclouddiscoveryenginev1document *GoogleCloudDiscoveryengineV1Document) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall { - c := &ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.googleclouddiscoveryenginev1document = googleclouddiscoveryenginev1document +// - completionConfig: 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/*/co +// mpletionConfig` +// `projects/*/locations/global/collections/default_collection/engines/*/compl +// etionConfig`. +func (r *ProjectsLocationsCollectionsDataStoresCompletionConfigService) CompleteQuery(completionConfig string, googleclouddiscoveryenginev1advancedcompletequeryrequest *GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequest) *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall { + c := &ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.completionConfig = completionConfig + c.googleclouddiscoveryenginev1advancedcompletequeryrequest = googleclouddiscoveryenginev1advancedcompletequeryrequest return c } -// AllowMissing sets the optional parameter "allowMissing": If set to `true` -// and the Document is not found, a new Document is be created. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) AllowMissing(allowMissing bool) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall { - c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// UpdateMask sets the optional parameter "updateMask": Indicates which fields -// in the provided imported 'document' to update. If not set, by default -// updates all fields. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall { - c.urlParams_.Set("updateMask", updateMask) +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1advancedcompletequeryrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+completionConfig}:completeQuery") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "completionConfig": c.completionConfig, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.completionConfig.completeQuery", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.completionConfig.completeQuery" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponse.ServerResponse.Hea +// der or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.completionConfig.completeQuery", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall struct { + s *Service + parent string + googleclouddiscoveryenginev1importcompletionsuggestionsrequest *GoogleCloudDiscoveryengineV1ImportCompletionSuggestionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Import: Imports CompletionSuggestions for a DataStore. +// +// - parent: The parent data store resource name for which to import customer +// autocomplete suggestions. Follows pattern +// `projects/*/locations/*/collections/*/dataStores/*`. +func (r *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsService) Import(parent string, googleclouddiscoveryenginev1importcompletionsuggestionsrequest *GoogleCloudDiscoveryengineV1ImportCompletionSuggestionsRequest) *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall { + c := &ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1importcompletionsuggestionsrequest = googleclouddiscoveryenginev1importcompletionsuggestionsrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall { +func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall { +func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1document) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1importcompletionsuggestionsrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/completionSuggestions:import") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.completionSuggestions.import", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.documents.patch" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.completionSuggestions.import" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Document.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Document, error) { +func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -36542,7 +38460,7 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) Do(op if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Document{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -36553,68 +38471,63 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) Do(op if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.patch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.completionSuggestions.import", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall struct { - s *Service - parent string - googleclouddiscoveryenginev1purgedocumentsrequest *GoogleCloudDiscoveryengineV1PurgeDocumentsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall struct { + s *Service + parent string + googleclouddiscoveryenginev1purgecompletionsuggestionsrequest *GoogleCloudDiscoveryengineV1PurgeCompletionSuggestionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Purge: Permanently deletes all selected Documents in a branch. This process -// is asynchronous. Depending on the number of Documents to be deleted, this -// operation can take hours to complete. Before the delete operation completes, -// some Documents might still be returned by DocumentService.GetDocument or -// DocumentService.ListDocuments. To get a list of the Documents to be deleted, -// set PurgeDocumentsRequest.force to false. +// Purge: Permanently deletes all CompletionSuggestions for a DataStore. // -// - parent: The parent resource name, such as -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/branches/{branch}`. -func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Purge(parent string, googleclouddiscoveryenginev1purgedocumentsrequest *GoogleCloudDiscoveryengineV1PurgeDocumentsRequest) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall { - c := &ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: The parent data store resource name for which to purge completion +// suggestions. Follows pattern +// projects/*/locations/*/collections/*/dataStores/*. +func (r *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsService) Purge(parent string, googleclouddiscoveryenginev1purgecompletionsuggestionsrequest *GoogleCloudDiscoveryengineV1PurgeCompletionSuggestionsRequest) *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall { + c := &ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent - c.googleclouddiscoveryenginev1purgedocumentsrequest = googleclouddiscoveryenginev1purgedocumentsrequest + c.googleclouddiscoveryenginev1purgecompletionsuggestionsrequest = googleclouddiscoveryenginev1purgecompletionsuggestionsrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall { +func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall { +func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1purgedocumentsrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1purgecompletionsuggestionsrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/documents:purge") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/completionSuggestions:purge") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -36624,17 +38537,17 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) doReq googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.purge", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.completionSuggestions.purge", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.documents.purge" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.completionSuggestions.purge" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -36664,69 +38577,76 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) Do(op if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.documents.purge", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.completionSuggestions.purge", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall struct { - s *Service - name string - googlelongrunningcanceloperationrequest *GoogleLongrunningCancelOperationRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresControlsCreateCall struct { + s *Service + parent string + googleclouddiscoveryenginev1control *GoogleCloudDiscoveryengineV1Control + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Cancel: 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`. +// Create: Creates a Control. By default 1000 controls are allowed for a data +// store. A request can be submitted to adjust this limit. If the Control to +// create already exists, an ALREADY_EXISTS error is returned. // -// - name: The name of the operation resource to be cancelled. -func (r *ProjectsLocationsCollectionsDataStoresBranchesOperationsService) Cancel(name string, googlelongrunningcanceloperationrequest *GoogleLongrunningCancelOperationRequest) *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall { - c := &ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.googlelongrunningcanceloperationrequest = googlelongrunningcanceloperationrequest +// - parent: Full resource name of parent data store. Format: +// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt +// ores/{data_store_id}` or +// `projects/{project}/locations/{location}/collections/{collection_id}/engine +// s/{engine_id}`. +func (r *ProjectsLocationsCollectionsDataStoresControlsService) Create(parent string, googleclouddiscoveryenginev1control *GoogleCloudDiscoveryengineV1Control) *ProjectsLocationsCollectionsDataStoresControlsCreateCall { + c := &ProjectsLocationsCollectionsDataStoresControlsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1control = googleclouddiscoveryenginev1control + return c +} + +// ControlId sets the optional parameter "controlId": Required. The ID to use +// for the Control, which will become the final component of the Control's +// resource name. This value must be within 1-63 characters. Valid characters +// are /a-z-_/. +func (c *ProjectsLocationsCollectionsDataStoresControlsCreateCall) ControlId(controlId string) *ProjectsLocationsCollectionsDataStoresControlsCreateCall { + c.urlParams_.Set("controlId", controlId) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall { +func (c *ProjectsLocationsCollectionsDataStoresControlsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresControlsCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall { +func (c *ProjectsLocationsCollectionsDataStoresControlsCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresControlsCreateCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresControlsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresControlsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlelongrunningcanceloperationrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1control) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:cancel") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/controls") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -36734,19 +38654,19 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall) doR } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.operations.cancel", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.operations.cancel" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.controls.create" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleProtobufEmpty.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { +// *GoogleCloudDiscoveryengineV1Control.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresControlsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Control, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -36765,7 +38685,7 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall) Do( if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleProtobufEmpty{ + ret := &GoogleCloudDiscoveryengineV1Control{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -36776,26 +38696,26 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsCancelCall) Do( if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.operations.cancel", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresControlsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Get: 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. +// Delete: Deletes a Control. If the Control to delete does not exist, a +// NOT_FOUND error is returned. // -// - name: The name of the operation resource. -func (r *ProjectsLocationsCollectionsDataStoresBranchesOperationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { - c := &ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The resource name of the Control to delete. Format: +// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt +// ores/{data_store_id}/controls/{control_id}`. +func (r *ProjectsLocationsCollectionsDataStoresControlsService) Delete(name string) *ProjectsLocationsCollectionsDataStoresControlsDeleteCall { + c := &ProjectsLocationsCollectionsDataStoresControlsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -36803,44 +38723,33 @@ func (r *ProjectsLocationsCollectionsDataStoresBranchesOperationsService) Get(na // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresControlsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresControlsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresControlsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresControlsDeleteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresControlsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresControlsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } @@ -36848,17 +38757,17 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) doRequ googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.operations.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.operations.get" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.controls.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +// *GoogleProtobufEmpty.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsCollectionsDataStoresControlsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -36877,7 +38786,7 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Do(opt if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleProtobufEmpty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -36888,11 +38797,11 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Do(opt if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.operations.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall struct { +type ProjectsLocationsCollectionsDataStoresControlsGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -36901,53 +38810,21 @@ type ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall struct { header_ http.Header } -// List: Lists operations that match the specified filter in the request. If -// the server doesn't support this method, it returns `UNIMPLEMENTED`. -// -// - name: The name of the operation's parent resource. -func (r *ProjectsLocationsCollectionsDataStoresBranchesOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { - c := &ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Filter sets the optional parameter "filter": The standard list filter. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// PageSize sets the optional parameter "pageSize": The standard list page -// size. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": The standard list page -// token. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { - c.urlParams_.Set("pageToken", pageToken) - return c -} - -// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": -// When set to `true`, operations that are reachable are returned as normal, -// and those that are unreachable are returned in the -// ListOperationsResponse.unreachable field. This can only be `true` when -// reading across collections. For example, when `parent` is set to -// "projects/example/locations/-". This field is not supported by default and -// will result in an `UNIMPLEMENTED` error if set unless explicitly documented -// otherwise in service or product specific documentation. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { - c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) +// Get: Gets a Control. +// +// - name: The resource name of the Control to get. Format: +// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt +// ores/{data_store_id}/controls/{control_id}`. +func (r *ProjectsLocationsCollectionsDataStoresControlsService) Get(name string) *ProjectsLocationsCollectionsDataStoresControlsGetCall { + c := &ProjectsLocationsCollectionsDataStoresControlsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresControlsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresControlsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -36955,34 +38832,34 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Field // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresControlsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresControlsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresControlsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresControlsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresControlsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresControlsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/operations") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -36992,17 +38869,17 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) doReq googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.operations.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.operations.list" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.controls.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningListOperationsResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1Control.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresControlsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Control, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -37021,7 +38898,7 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Do(op if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningListOperationsResponse{ + ret := &GoogleCloudDiscoveryengineV1Control{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -37032,107 +38909,114 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Do(op if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.branches.operations.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.PageToken(x.NextPageToken) - } +type ProjectsLocationsCollectionsDataStoresControlsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -type ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall struct { - s *Service - completionConfig string - googleclouddiscoveryenginev1advancedcompletequeryrequest *GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +// List: Lists all Controls by their parent DataStore. +// +// - parent: The data store resource name. Format: +// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt +// ores/{data_store_id}` or +// `projects/{project}/locations/{location}/collections/{collection_id}/engine +// s/{engine_id}`. +func (r *ProjectsLocationsCollectionsDataStoresControlsService) List(parent string) *ProjectsLocationsCollectionsDataStoresControlsListCall { + c := &ProjectsLocationsCollectionsDataStoresControlsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c } -// CompleteQuery: Completes the user input with advanced keyword suggestions. -// -// - completionConfig: 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/*/co -// mpletionConfig` -// `projects/*/locations/global/collections/default_collection/engines/*/compl -// etionConfig`. -func (r *ProjectsLocationsCollectionsDataStoresCompletionConfigService) CompleteQuery(completionConfig string, googleclouddiscoveryenginev1advancedcompletequeryrequest *GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequest) *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall { - c := &ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.completionConfig = completionConfig - c.googleclouddiscoveryenginev1advancedcompletequeryrequest = googleclouddiscoveryenginev1advancedcompletequeryrequest +// Filter sets the optional parameter "filter": A filter to apply on the list +// results. Supported features: * List all the products under the parent branch +// if filter is unset. Currently this field is unsupported. +func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresControlsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of results +// to return. If unspecified, defaults to 50. Max allowed value is 1000. +func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresControlsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListControls` call. Provide this to retrieve the subsequent +// page. +func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresControlsListCall { + c.urlParams_.Set("pageToken", pageToken) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall { +func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresControlsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresControlsListCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall { +func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresControlsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1advancedcompletequeryrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+completionConfig}:completeQuery") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/controls") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "completionConfig": c.completionConfig, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.completionConfig.completeQuery", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.completionConfig.completeQuery" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.controls.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponse.ServerResponse.Hea -// der or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponse, error) { +// *GoogleCloudDiscoveryengineV1ListControlsResponse.ServerResponse.Header or +// (if a response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListControlsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -37151,7 +39035,7 @@ func (c *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponse{ + ret := &GoogleCloudDiscoveryengineV1ListControlsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -37162,83 +39046,113 @@ func (c *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.completionConfig.completeQuery", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall struct { - s *Service - parent string - googleclouddiscoveryenginev1importcompletionsuggestionsrequest *GoogleCloudDiscoveryengineV1ImportCompletionSuggestionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListControlsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } } -// Import: Imports CompletionSuggestions for a DataStore. +type ProjectsLocationsCollectionsDataStoresControlsPatchCall struct { + s *Service + name string + googleclouddiscoveryenginev1control *GoogleCloudDiscoveryengineV1Control + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates a Control. Control action type cannot be changed. If the +// Control to update does not exist, a NOT_FOUND error is returned. // -// - parent: The parent data store resource name for which to import customer -// autocomplete suggestions. Follows pattern -// `projects/*/locations/*/collections/*/dataStores/*`. -func (r *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsService) Import(parent string, googleclouddiscoveryenginev1importcompletionsuggestionsrequest *GoogleCloudDiscoveryengineV1ImportCompletionSuggestionsRequest) *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall { - c := &ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.googleclouddiscoveryenginev1importcompletionsuggestionsrequest = googleclouddiscoveryenginev1importcompletionsuggestionsrequest +// - name: Immutable. Fully qualified name +// `projects/*/locations/global/dataStore/*/controls/*`. +func (r *ProjectsLocationsCollectionsDataStoresControlsService) Patch(name string, googleclouddiscoveryenginev1control *GoogleCloudDiscoveryengineV1Control) *ProjectsLocationsCollectionsDataStoresControlsPatchCall { + c := &ProjectsLocationsCollectionsDataStoresControlsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleclouddiscoveryenginev1control = googleclouddiscoveryenginev1control + return c +} + +// UpdateMask sets the optional parameter "updateMask": Indicates which fields +// in the provided Control to update. The following are NOT supported: * +// Control.name * Control.solution_type If not set or empty, all supported +// fields are updated. +func (c *ProjectsLocationsCollectionsDataStoresControlsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsDataStoresControlsPatchCall { + c.urlParams_.Set("updateMask", updateMask) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall { +func (c *ProjectsLocationsCollectionsDataStoresControlsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresControlsPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall { +func (c *ProjectsLocationsCollectionsDataStoresControlsPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresControlsPatchCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresControlsPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresControlsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1importcompletionsuggestionsrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1control) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/completionSuggestions:import") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.completionSuggestions.import", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.patch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.completionSuggestions.import" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.controls.patch" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1Control.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresControlsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Control, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -37257,7 +39171,7 @@ func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1Control{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -37268,63 +39182,67 @@ func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.completionSuggestions.import", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.patch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall struct { - s *Service - parent string - googleclouddiscoveryenginev1purgecompletionsuggestionsrequest *GoogleCloudDiscoveryengineV1PurgeCompletionSuggestionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresConversationsConverseCall struct { + s *Service + name string + googleclouddiscoveryenginev1converseconversationrequest *GoogleCloudDiscoveryengineV1ConverseConversationRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Purge: Permanently deletes all CompletionSuggestions for a DataStore. +// Converse: Converses a conversation. // -// - parent: The parent data store resource name for which to purge completion -// suggestions. Follows pattern -// projects/*/locations/*/collections/*/dataStores/*. -func (r *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsService) Purge(parent string, googleclouddiscoveryenginev1purgecompletionsuggestionsrequest *GoogleCloudDiscoveryengineV1PurgeCompletionSuggestionsRequest) *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall { - c := &ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.googleclouddiscoveryenginev1purgecompletionsuggestionsrequest = googleclouddiscoveryenginev1purgecompletionsuggestionsrequest +// - name: The resource name of the Conversation to get. Format: +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store_id}/conversations/{conversation_id}`. Use +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store_id}/conversations/-` to activate auto session mode, which +// automatically creates a new conversation inside a ConverseConversation +// session. +func (r *ProjectsLocationsCollectionsDataStoresConversationsService) Converse(name string, googleclouddiscoveryenginev1converseconversationrequest *GoogleCloudDiscoveryengineV1ConverseConversationRequest) *ProjectsLocationsCollectionsDataStoresConversationsConverseCall { + c := &ProjectsLocationsCollectionsDataStoresConversationsConverseCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleclouddiscoveryenginev1converseconversationrequest = googleclouddiscoveryenginev1converseconversationrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall { +func (c *ProjectsLocationsCollectionsDataStoresConversationsConverseCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresConversationsConverseCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall { +func (c *ProjectsLocationsCollectionsDataStoresConversationsConverseCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresConversationsConverseCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresConversationsConverseCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresConversationsConverseCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1purgecompletionsuggestionsrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1converseconversationrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/completionSuggestions:purge") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:converse") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -37332,19 +39250,19 @@ func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall) d } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.completionSuggestions.purge", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.converse", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.completionSuggestions.purge" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.conversations.converse" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +// *GoogleCloudDiscoveryengineV1ConverseConversationResponse.ServerResponse.Head +// er or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresConversationsConverseCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ConverseConversationResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -37363,7 +39281,7 @@ func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall) D if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1ConverseConversationResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -37374,76 +39292,64 @@ func (c *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsPurgeCall) D if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.completionSuggestions.purge", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.converse", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresControlsCreateCall struct { - s *Service - parent string - googleclouddiscoveryenginev1control *GoogleCloudDiscoveryengineV1Control - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresConversationsCreateCall struct { + s *Service + parent string + googleclouddiscoveryenginev1conversation *GoogleCloudDiscoveryengineV1Conversation + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Create: Creates a Control. By default 1000 controls are allowed for a data -// store. A request can be submitted to adjust this limit. If the Control to -// create already exists, an ALREADY_EXISTS error is returned. +// Create: Creates a Conversation. If the Conversation to create already +// exists, an ALREADY_EXISTS error is returned. // // - parent: Full resource name of parent data store. Format: -// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt -// ores/{data_store_id}` or -// `projects/{project}/locations/{location}/collections/{collection_id}/engine -// s/{engine_id}`. -func (r *ProjectsLocationsCollectionsDataStoresControlsService) Create(parent string, googleclouddiscoveryenginev1control *GoogleCloudDiscoveryengineV1Control) *ProjectsLocationsCollectionsDataStoresControlsCreateCall { - c := &ProjectsLocationsCollectionsDataStoresControlsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store_id}`. +func (r *ProjectsLocationsCollectionsDataStoresConversationsService) Create(parent string, googleclouddiscoveryenginev1conversation *GoogleCloudDiscoveryengineV1Conversation) *ProjectsLocationsCollectionsDataStoresConversationsCreateCall { + c := &ProjectsLocationsCollectionsDataStoresConversationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent - c.googleclouddiscoveryenginev1control = googleclouddiscoveryenginev1control - return c -} - -// ControlId sets the optional parameter "controlId": Required. The ID to use -// for the Control, which will become the final component of the Control's -// resource name. This value must be within 1-63 characters. Valid characters -// are /a-z-_/. -func (c *ProjectsLocationsCollectionsDataStoresControlsCreateCall) ControlId(controlId string) *ProjectsLocationsCollectionsDataStoresControlsCreateCall { - c.urlParams_.Set("controlId", controlId) + c.googleclouddiscoveryenginev1conversation = googleclouddiscoveryenginev1conversation return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresControlsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresControlsCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresConversationsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresConversationsCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresControlsCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresControlsCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresConversationsCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresConversationsCreateCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresControlsCreateCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresConversationsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresControlsCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresConversationsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1control) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1conversation) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/controls") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/conversations") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -37453,17 +39359,17 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsCreateCall) doRequest(alt googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.controls.create" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.conversations.create" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Control.ServerResponse.Header or (if a response -// was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1Conversation.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresControlsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Control, error) { +func (c *ProjectsLocationsCollectionsDataStoresConversationsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Conversation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -37482,7 +39388,7 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsCreateCall) Do(opts ...go if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Control{ + ret := &GoogleCloudDiscoveryengineV1Conversation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -37493,11 +39399,11 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsCreateCall) Do(opts ...go if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresControlsDeleteCall struct { +type ProjectsLocationsCollectionsDataStoresConversationsDeleteCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -37505,14 +39411,14 @@ type ProjectsLocationsCollectionsDataStoresControlsDeleteCall struct { header_ http.Header } -// Delete: Deletes a Control. If the Control to delete does not exist, a -// NOT_FOUND error is returned. +// Delete: Deletes a Conversation. If the Conversation to delete does not +// exist, a NOT_FOUND error is returned. // -// - name: The resource name of the Control to delete. Format: -// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt -// ores/{data_store_id}/controls/{control_id}`. -func (r *ProjectsLocationsCollectionsDataStoresControlsService) Delete(name string) *ProjectsLocationsCollectionsDataStoresControlsDeleteCall { - c := &ProjectsLocationsCollectionsDataStoresControlsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The resource name of the Conversation to delete. Format: +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store_id}/conversations/{conversation_id}`. +func (r *ProjectsLocationsCollectionsDataStoresConversationsService) Delete(name string) *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall { + c := &ProjectsLocationsCollectionsDataStoresConversationsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -37520,27 +39426,27 @@ func (r *ProjectsLocationsCollectionsDataStoresControlsService) Delete(name stri // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresControlsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresControlsDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresControlsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresControlsDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresControlsDeleteCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresControlsDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") @@ -37554,17 +39460,17 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsDeleteCall) doRequest(alt googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.controls.delete" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.conversations.delete" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleProtobufEmpty.ServerResponse.Header or (if a response was returned at // all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to // check whether the returned error was because http.StatusNotModified was // returned. -func (c *ProjectsLocationsCollectionsDataStoresControlsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { +func (c *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -37594,11 +39500,11 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsDeleteCall) Do(opts ...go if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresControlsGetCall struct { +type ProjectsLocationsCollectionsDataStoresConversationsGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -37607,13 +39513,13 @@ type ProjectsLocationsCollectionsDataStoresControlsGetCall struct { header_ http.Header } -// Get: Gets a Control. +// Get: Gets a Conversation. // -// - name: The resource name of the Control to get. Format: -// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt -// ores/{data_store_id}/controls/{control_id}`. -func (r *ProjectsLocationsCollectionsDataStoresControlsService) Get(name string) *ProjectsLocationsCollectionsDataStoresControlsGetCall { - c := &ProjectsLocationsCollectionsDataStoresControlsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The resource name of the Conversation to get. Format: +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store_id}/conversations/{conversation_id}`. +func (r *ProjectsLocationsCollectionsDataStoresConversationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresConversationsGetCall { + c := &ProjectsLocationsCollectionsDataStoresConversationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -37621,7 +39527,7 @@ func (r *ProjectsLocationsCollectionsDataStoresControlsService) Get(name string) // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresControlsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresControlsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresConversationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresConversationsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -37629,27 +39535,27 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsGetCall) Fields(s ...goog // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresControlsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresControlsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresConversationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresConversationsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresControlsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresControlsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresConversationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresConversationsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresControlsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresConversationsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresControlsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresConversationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -37666,17 +39572,17 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsGetCall) doRequest(alt st googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.controls.get" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.conversations.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Control.ServerResponse.Header or (if a response -// was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1Conversation.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresControlsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Control, error) { +func (c *ProjectsLocationsCollectionsDataStoresConversationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Conversation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -37695,7 +39601,7 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsGetCall) Do(opts ...googl if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Control{ + ret := &GoogleCloudDiscoveryengineV1Conversation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -37706,11 +39612,11 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsGetCall) Do(opts ...googl if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresControlsListCall struct { +type ProjectsLocationsCollectionsDataStoresConversationsListCall struct { s *Service parent string urlParams_ gensupport.URLParams @@ -37719,38 +39625,45 @@ type ProjectsLocationsCollectionsDataStoresControlsListCall struct { header_ http.Header } -// List: Lists all Controls by their parent DataStore. +// List: Lists all Conversations by their parent DataStore. // // - parent: The data store resource name. Format: -// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt -// ores/{data_store_id}` or -// `projects/{project}/locations/{location}/collections/{collection_id}/engine -// s/{engine_id}`. -func (r *ProjectsLocationsCollectionsDataStoresControlsService) List(parent string) *ProjectsLocationsCollectionsDataStoresControlsListCall { - c := &ProjectsLocationsCollectionsDataStoresControlsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store_id}`. +func (r *ProjectsLocationsCollectionsDataStoresConversationsService) List(parent string) *ProjectsLocationsCollectionsDataStoresConversationsListCall { + c := &ProjectsLocationsCollectionsDataStoresConversationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } // Filter sets the optional parameter "filter": A filter to apply on the list -// results. Supported features: * List all the products under the parent branch -// if filter is unset. Currently this field is unsupported. -func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresControlsListCall { +// results. The supported features are: user_pseudo_id, state. Example: +// "user_pseudo_id = some_id" +func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresConversationsListCall { c.urlParams_.Set("filter", filter) return c } +// OrderBy sets the optional parameter "orderBy": A comma-separated list of +// fields to order by, sorted in ascending order. Use "desc" after a field name +// for descending. Supported fields: * `update_time` * `create_time` * +// `conversation_name` Example: "update_time desc" "create_time" +func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) OrderBy(orderBy string) *ProjectsLocationsCollectionsDataStoresConversationsListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + // PageSize sets the optional parameter "pageSize": Maximum number of results // to return. If unspecified, defaults to 50. Max allowed value is 1000. -func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresControlsListCall { +func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresConversationsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": A page token, received -// from a previous `ListControls` call. Provide this to retrieve the subsequent -// page. -func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresControlsListCall { +// from a previous `ListConversations` call. Provide this to retrieve the +// subsequent page. +func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresConversationsListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -37758,7 +39671,7 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) PageToken(pageT // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresControlsListCall { +func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresConversationsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -37766,34 +39679,34 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) Fields(s ...goo // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresControlsListCall { +func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresConversationsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresControlsListCall { +func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresConversationsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/controls") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/conversations") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -37803,17 +39716,17 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) doRequest(alt s googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.controls.list" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.conversations.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ListControlsResponse.ServerResponse.Header or -// (if a response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because +// *GoogleCloudDiscoveryengineV1ListConversationsResponse.ServerResponse.Header +// or (if a response was returned at all) in error.(*googleapi.Error).Header. +// Use googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListControlsResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListConversationsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -37832,7 +39745,7 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) Do(opts ...goog if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ListControlsResponse{ + ret := &GoogleCloudDiscoveryengineV1ListConversationsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -37843,14 +39756,14 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) Do(opts ...goog if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListControlsResponse) error) error { +func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListConversationsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -37868,32 +39781,34 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsListCall) Pages(ctx conte } } -type ProjectsLocationsCollectionsDataStoresControlsPatchCall struct { - s *Service - name string - googleclouddiscoveryenginev1control *GoogleCloudDiscoveryengineV1Control - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresConversationsPatchCall struct { + s *Service + name string + googleclouddiscoveryenginev1conversation *GoogleCloudDiscoveryengineV1Conversation + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Patch: Updates a Control. Control action type cannot be changed. If the -// Control to update does not exist, a NOT_FOUND error is returned. +// Patch: Updates a Conversation. Conversation action type cannot be changed. +// If the Conversation to update does not exist, a NOT_FOUND error is returned. // // - name: Immutable. Fully qualified name -// `projects/*/locations/global/dataStore/*/controls/*`. -func (r *ProjectsLocationsCollectionsDataStoresControlsService) Patch(name string, googleclouddiscoveryenginev1control *GoogleCloudDiscoveryengineV1Control) *ProjectsLocationsCollectionsDataStoresControlsPatchCall { - c := &ProjectsLocationsCollectionsDataStoresControlsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// `projects/{project}/locations/global/collections/{collection}/dataStore/*/c +// onversations/*` or +// `projects/{project}/locations/global/collections/{collection}/engines/*/con +// versations/*`. +func (r *ProjectsLocationsCollectionsDataStoresConversationsService) Patch(name string, googleclouddiscoveryenginev1conversation *GoogleCloudDiscoveryengineV1Conversation) *ProjectsLocationsCollectionsDataStoresConversationsPatchCall { + c := &ProjectsLocationsCollectionsDataStoresConversationsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googleclouddiscoveryenginev1control = googleclouddiscoveryenginev1control + c.googleclouddiscoveryenginev1conversation = googleclouddiscoveryenginev1conversation return c } // UpdateMask sets the optional parameter "updateMask": Indicates which fields -// in the provided Control to update. The following are NOT supported: * -// Control.name * Control.solution_type If not set or empty, all supported -// fields are updated. -func (c *ProjectsLocationsCollectionsDataStoresControlsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsDataStoresControlsPatchCall { +// in the provided Conversation to update. The following are NOT supported: * +// Conversation.name If not set or empty, all supported fields are updated. +func (c *ProjectsLocationsCollectionsDataStoresConversationsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsDataStoresConversationsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c } @@ -37901,29 +39816,29 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsPatchCall) UpdateMask(upd // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresControlsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresControlsPatchCall { +func (c *ProjectsLocationsCollectionsDataStoresConversationsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresConversationsPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresControlsPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresControlsPatchCall { +func (c *ProjectsLocationsCollectionsDataStoresConversationsPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresConversationsPatchCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresControlsPatchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresConversationsPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresControlsPatchCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresConversationsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1control) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1conversation) if err != nil { return nil, err } @@ -37939,17 +39854,17 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsPatchCall) doRequest(alt googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.patch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.controls.patch" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.conversations.patch" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Control.ServerResponse.Header or (if a response -// was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1Conversation.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresControlsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Control, error) { +func (c *ProjectsLocationsCollectionsDataStoresConversationsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Conversation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -37968,7 +39883,7 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsPatchCall) Do(opts ...goo if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Control{ + ret := &GoogleCloudDiscoveryengineV1Conversation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -37979,87 +39894,90 @@ func (c *ProjectsLocationsCollectionsDataStoresControlsPatchCall) Do(opts ...goo if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.controls.patch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.patch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresConversationsConverseCall struct { - s *Service - name string - googleclouddiscoveryenginev1converseconversationrequest *GoogleCloudDiscoveryengineV1ConverseConversationRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresCustomModelsListCall struct { + s *Service + dataStore string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Converse: Converses a conversation. +// List: Gets a list of all the custom models. // -// - name: The resource name of the Conversation to get. Format: -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store_id}/conversations/{conversation_id}`. Use -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store_id}/conversations/-` to activate auto session mode, which -// automatically creates a new conversation inside a ConverseConversation -// session. -func (r *ProjectsLocationsCollectionsDataStoresConversationsService) Converse(name string, googleclouddiscoveryenginev1converseconversationrequest *GoogleCloudDiscoveryengineV1ConverseConversationRequest) *ProjectsLocationsCollectionsDataStoresConversationsConverseCall { - c := &ProjectsLocationsCollectionsDataStoresConversationsConverseCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.googleclouddiscoveryenginev1converseconversationrequest = googleclouddiscoveryenginev1converseconversationrequest +// - dataStore: The resource name of the parent Data Store, such as +// `projects/*/locations/global/collections/default_collection/dataStores/defa +// ult_data_store`. This field is used to identify the data store where to +// fetch the models from. +func (r *ProjectsLocationsCollectionsDataStoresCustomModelsService) List(dataStore string) *ProjectsLocationsCollectionsDataStoresCustomModelsListCall { + c := &ProjectsLocationsCollectionsDataStoresCustomModelsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.dataStore = dataStore return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresConversationsConverseCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresConversationsConverseCall { +func (c *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresCustomModelsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresCustomModelsListCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresConversationsConverseCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresConversationsConverseCall { +func (c *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresCustomModelsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresConversationsConverseCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresConversationsConverseCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1converseconversationrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:converse") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+dataStore}/customModels") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "dataStore": c.dataStore, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.converse", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.customModels.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.conversations.converse" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.customModels.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ConverseConversationResponse.ServerResponse.Head -// er or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresConversationsConverseCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ConverseConversationResponse, error) { +// *GoogleCloudDiscoveryengineV1ListCustomModelsResponse.ServerResponse.Header +// or (if a response was returned at all) in error.(*googleapi.Error).Header. +// Use googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListCustomModelsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -38078,7 +39996,7 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsConverseCall) Do(opt if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ConverseConversationResponse{ + ret := &GoogleCloudDiscoveryengineV1ListCustomModelsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -38089,84 +40007,89 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsConverseCall) Do(opt if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.converse", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.customModels.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresConversationsCreateCall struct { - s *Service - parent string - googleclouddiscoveryenginev1conversation *GoogleCloudDiscoveryengineV1Conversation - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Create: Creates a Conversation. If the Conversation to create already -// exists, an ALREADY_EXISTS error is returned. +// Get: 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. // -// - parent: Full resource name of parent data store. Format: -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store_id}`. -func (r *ProjectsLocationsCollectionsDataStoresConversationsService) Create(parent string, googleclouddiscoveryenginev1conversation *GoogleCloudDiscoveryengineV1Conversation) *ProjectsLocationsCollectionsDataStoresConversationsCreateCall { - c := &ProjectsLocationsCollectionsDataStoresConversationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.googleclouddiscoveryenginev1conversation = googleclouddiscoveryenginev1conversation +// - name: The name of the operation resource. +func (r *ProjectsLocationsCollectionsDataStoresModelsOperationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall { + c := &ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresConversationsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresConversationsCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresConversationsCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresConversationsCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresConversationsCreateCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresConversationsCreateCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1conversation) - if err != nil { - return nil, err +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/conversations") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.models.operations.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.conversations.create" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.models.operations.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Conversation.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresConversationsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Conversation, error) { +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -38185,7 +40108,7 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsCreateCall) Do(opts if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Conversation{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -38196,60 +40119,103 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsCreateCall) Do(opts if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.models.operations.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresConversationsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresModelsOperationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Delete: Deletes a Conversation. If the Conversation to delete does not -// exist, a NOT_FOUND error is returned. +// List: Lists operations that match the specified filter in the request. If +// the server doesn't support this method, it returns `UNIMPLEMENTED`. // -// - name: The resource name of the Conversation to delete. Format: -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store_id}/conversations/{conversation_id}`. -func (r *ProjectsLocationsCollectionsDataStoresConversationsService) Delete(name string) *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall { - c := &ProjectsLocationsCollectionsDataStoresConversationsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The name of the operation's parent resource. +func (r *ProjectsLocationsCollectionsDataStoresModelsOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall { + c := &ProjectsLocationsCollectionsDataStoresModelsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } +// Filter sets the optional parameter "filter": The standard list filter. +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list page +// size. +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list page +// token. +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": +// When set to `true`, operations that are reachable are returned as normal, +// and those that are unreachable are returned in the +// ListOperationsResponse.unreachable field. This can only be `true` when +// reading across collections. For example, when `parent` is set to +// "projects/example/locations/-". This field is not supported by default and +// will result in an `UNIMPLEMENTED` error if set unless explicitly documented +// otherwise in service or product specific documentation. +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/operations") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -38257,17 +40223,17 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall) doReques googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.models.operations.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.conversations.delete" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.models.operations.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleProtobufEmpty.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { +// *GoogleLongrunningListOperationsResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -38286,7 +40252,7 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall) Do(opts if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleProtobufEmpty{ + ret := &GoogleLongrunningListOperationsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -38297,11 +40263,32 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsDeleteCall) Do(opts if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.models.operations.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresConversationsGetCall struct { +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type ProjectsLocationsCollectionsDataStoresOperationsGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -38310,13 +40297,13 @@ type ProjectsLocationsCollectionsDataStoresConversationsGetCall struct { header_ http.Header } -// Get: Gets a Conversation. +// Get: 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. // -// - name: The resource name of the Conversation to get. Format: -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store_id}/conversations/{conversation_id}`. -func (r *ProjectsLocationsCollectionsDataStoresConversationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresConversationsGetCall { - c := &ProjectsLocationsCollectionsDataStoresConversationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The name of the operation resource. +func (r *ProjectsLocationsCollectionsDataStoresOperationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresOperationsGetCall { + c := &ProjectsLocationsCollectionsDataStoresOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -38324,7 +40311,7 @@ func (r *ProjectsLocationsCollectionsDataStoresConversationsService) Get(name st // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresConversationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresConversationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresOperationsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -38332,27 +40319,27 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsGetCall) Fields(s .. // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresConversationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresConversationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresOperationsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresConversationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresConversationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresOperationsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresConversationsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresOperationsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresConversationsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -38369,17 +40356,17 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsGetCall) doRequest(a googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.operations.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.conversations.get" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.operations.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Conversation.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresConversationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Conversation, error) { +func (c *ProjectsLocationsCollectionsDataStoresOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -38398,7 +40385,7 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsGetCall) Do(opts ... if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Conversation{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -38409,66 +40396,66 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsGetCall) Do(opts ... if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.operations.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresConversationsListCall struct { +type ProjectsLocationsCollectionsDataStoresOperationsListCall struct { s *Service - parent string + name string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// List: Lists all Conversations by their parent DataStore. +// List: Lists operations that match the specified filter in the request. If +// the server doesn't support this method, it returns `UNIMPLEMENTED`. // -// - parent: The data store resource name. Format: -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store_id}`. -func (r *ProjectsLocationsCollectionsDataStoresConversationsService) List(parent string) *ProjectsLocationsCollectionsDataStoresConversationsListCall { - c := &ProjectsLocationsCollectionsDataStoresConversationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent +// - name: The name of the operation's parent resource. +func (r *ProjectsLocationsCollectionsDataStoresOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresOperationsListCall { + c := &ProjectsLocationsCollectionsDataStoresOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name return c } -// Filter sets the optional parameter "filter": A filter to apply on the list -// results. The supported features are: user_pseudo_id, state. Example: -// "user_pseudo_id = some_id" -func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresConversationsListCall { +// Filter sets the optional parameter "filter": The standard list filter. +func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresOperationsListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": A comma-separated list of -// fields to order by, sorted in ascending order. Use "desc" after a field name -// for descending. Supported fields: * `update_time` * `create_time` * -// `conversation_name` Example: "update_time desc" "create_time" -func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) OrderBy(orderBy string) *ProjectsLocationsCollectionsDataStoresConversationsListCall { - c.urlParams_.Set("orderBy", orderBy) +// PageSize sets the optional parameter "pageSize": The standard list page +// size. +func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } -// PageSize sets the optional parameter "pageSize": Maximum number of results -// to return. If unspecified, defaults to 50. Max allowed value is 1000. -func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresConversationsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) +// PageToken sets the optional parameter "pageToken": The standard list page +// token. +func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresOperationsListCall { + c.urlParams_.Set("pageToken", pageToken) return c } -// PageToken sets the optional parameter "pageToken": A page token, received -// from a previous `ListConversations` call. Provide this to retrieve the -// subsequent page. -func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresConversationsListCall { - c.urlParams_.Set("pageToken", pageToken) +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": +// When set to `true`, operations that are reachable are returned as normal, +// and those that are unreachable are returned in the +// ListOperationsResponse.unreachable field. This can only be `true` when +// reading across collections. For example, when `parent` is set to +// "projects/example/locations/-". This field is not supported by default and +// will result in an `UNIMPLEMENTED` error if set unless explicitly documented +// otherwise in service or product specific documentation. +func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsCollectionsDataStoresOperationsListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresConversationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresOperationsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -38476,34 +40463,34 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) Fields(s . // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresConversationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresOperationsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresConversationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresOperationsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/conversations") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/operations") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -38511,19 +40498,19 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) doRequest( } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.operations.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.conversations.list" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.operations.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ListConversationsResponse.ServerResponse.Header -// or (if a response was returned at all) in error.(*googleapi.Error).Header. -// Use googleapi.IsNotModified to check whether the returned error was because +// *GoogleLongrunningListOperationsResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListConversationsResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -38542,7 +40529,7 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) Do(opts .. if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ListConversationsResponse{ + ret := &GoogleLongrunningListOperationsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -38553,14 +40540,14 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) Do(opts .. if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.operations.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListConversationsResponse) error) error { +func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -38578,90 +40565,88 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsListCall) Pages(ctx } } -type ProjectsLocationsCollectionsDataStoresConversationsPatchCall struct { - s *Service - name string - googleclouddiscoveryenginev1conversation *GoogleCloudDiscoveryengineV1Conversation - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresSchemasCreateCall struct { + s *Service + parent string + googleclouddiscoveryenginev1schema *GoogleCloudDiscoveryengineV1Schema + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Patch: Updates a Conversation. Conversation action type cannot be changed. -// If the Conversation to update does not exist, a NOT_FOUND error is returned. +// Create: Creates a Schema. // -// - name: Immutable. Fully qualified name -// `projects/{project}/locations/global/collections/{collection}/dataStore/*/c -// onversations/*` or -// `projects/{project}/locations/global/collections/{collection}/engines/*/con -// versations/*`. -func (r *ProjectsLocationsCollectionsDataStoresConversationsService) Patch(name string, googleclouddiscoveryenginev1conversation *GoogleCloudDiscoveryengineV1Conversation) *ProjectsLocationsCollectionsDataStoresConversationsPatchCall { - c := &ProjectsLocationsCollectionsDataStoresConversationsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.googleclouddiscoveryenginev1conversation = googleclouddiscoveryenginev1conversation +// - parent: The parent data store resource name, in the format of +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}`. +func (r *ProjectsLocationsCollectionsDataStoresSchemasService) Create(parent string, googleclouddiscoveryenginev1schema *GoogleCloudDiscoveryengineV1Schema) *ProjectsLocationsCollectionsDataStoresSchemasCreateCall { + c := &ProjectsLocationsCollectionsDataStoresSchemasCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1schema = googleclouddiscoveryenginev1schema return c } -// UpdateMask sets the optional parameter "updateMask": Indicates which fields -// in the provided Conversation to update. The following are NOT supported: * -// Conversation.name If not set or empty, all supported fields are updated. -func (c *ProjectsLocationsCollectionsDataStoresConversationsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsDataStoresConversationsPatchCall { - c.urlParams_.Set("updateMask", updateMask) +// SchemaId sets the optional parameter "schemaId": Required. The ID to use for +// the Schema, which becomes the final component of the Schema.name. This field +// should conform to RFC-1034 (https://tools.ietf.org/html/rfc1034) standard +// with a length limit of 63 characters. +func (c *ProjectsLocationsCollectionsDataStoresSchemasCreateCall) SchemaId(schemaId string) *ProjectsLocationsCollectionsDataStoresSchemasCreateCall { + c.urlParams_.Set("schemaId", schemaId) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresConversationsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresConversationsPatchCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSchemasCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresConversationsPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresConversationsPatchCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSchemasCreateCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresConversationsPatchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSchemasCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresConversationsPatchCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSchemasCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1conversation) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1schema) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/schemas") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.conversations.patch" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.schemas.create" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Conversation.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresConversationsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Conversation, error) { +func (c *ProjectsLocationsCollectionsDataStoresSchemasCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -38680,7 +40665,7 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsPatchCall) Do(opts . if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Conversation{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -38691,90 +40676,77 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsPatchCall) Do(opts . if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.conversations.patch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresCustomModelsListCall struct { - s *Service - dataStore string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresSchemasDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// List: Gets a list of all the custom models. +// Delete: Deletes a Schema. // -// - dataStore: The resource name of the parent Data Store, such as -// `projects/*/locations/global/collections/default_collection/dataStores/defa -// ult_data_store`. This field is used to identify the data store where to -// fetch the models from. -func (r *ProjectsLocationsCollectionsDataStoresCustomModelsService) List(dataStore string) *ProjectsLocationsCollectionsDataStoresCustomModelsListCall { - c := &ProjectsLocationsCollectionsDataStoresCustomModelsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.dataStore = dataStore +// - name: The full resource name of the schema, in the format of +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/schemas/{schema}`. +func (r *ProjectsLocationsCollectionsDataStoresSchemasService) Delete(name string) *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall { + c := &ProjectsLocationsCollectionsDataStoresSchemasDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresCustomModelsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresCustomModelsListCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresCustomModelsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+dataStore}/customModels") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "dataStore": c.dataStore, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.customModels.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.customModels.list" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.schemas.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ListCustomModelsResponse.ServerResponse.Header -// or (if a response was returned at all) in error.(*googleapi.Error).Header. -// Use googleapi.IsNotModified to check whether the returned error was because +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListCustomModelsResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -38793,7 +40765,7 @@ func (c *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) Do(opts ... if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ListCustomModelsResponse{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -38804,11 +40776,11 @@ func (c *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) Do(opts ... if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.customModels.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall struct { +type ProjectsLocationsCollectionsDataStoresSchemasGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -38817,13 +40789,13 @@ type ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall struct { header_ http.Header } -// Get: 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. +// Get: Gets a Schema. // -// - name: The name of the operation resource. -func (r *ProjectsLocationsCollectionsDataStoresModelsOperationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall { - c := &ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The full resource name of the schema, in the format of +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/schemas/{schema}`. +func (r *ProjectsLocationsCollectionsDataStoresSchemasService) Get(name string) *ProjectsLocationsCollectionsDataStoresSchemasGetCall { + c := &ProjectsLocationsCollectionsDataStoresSchemasGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -38831,7 +40803,7 @@ func (r *ProjectsLocationsCollectionsDataStoresModelsOperationsService) Get(name // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSchemasGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -38839,27 +40811,27 @@ func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall) Fields(s // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSchemasGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSchemasGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSchemasGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSchemasGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -38876,17 +40848,17 @@ func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall) doReques googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.models.operations.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.models.operations.get" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.schemas.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1Schema.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresSchemasGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Schema, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -38905,7 +40877,7 @@ func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall) Do(opts if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1Schema{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -38916,66 +40888,52 @@ func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall) Do(opts if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.models.operations.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresModelsOperationsListCall struct { +type ProjectsLocationsCollectionsDataStoresSchemasListCall struct { s *Service - name string + parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// List: Lists operations that match the specified filter in the request. If -// the server doesn't support this method, it returns `UNIMPLEMENTED`. +// List: Gets a list of Schemas. // -// - name: The name of the operation's parent resource. -func (r *ProjectsLocationsCollectionsDataStoresModelsOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall { - c := &ProjectsLocationsCollectionsDataStoresModelsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Filter sets the optional parameter "filter": The standard list filter. -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall { - c.urlParams_.Set("filter", filter) +// - parent: The parent data store resource name, in the format of +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}`. +func (r *ProjectsLocationsCollectionsDataStoresSchemasService) List(parent string) *ProjectsLocationsCollectionsDataStoresSchemasListCall { + c := &ProjectsLocationsCollectionsDataStoresSchemasListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent return c } -// PageSize sets the optional parameter "pageSize": The standard list page -// size. -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall { +// PageSize sets the optional parameter "pageSize": The maximum number of +// Schemas to return. The service may return fewer than this value. If +// unspecified, at most 100 Schemas are returned. The maximum value is 1000; +// values above 1000 are set to 1000. +func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSchemasListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } -// PageToken sets the optional parameter "pageToken": The standard list page -// token. -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall { +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous SchemaService.ListSchemas call. Provide this to retrieve the +// subsequent page. When paginating, all other parameters provided to +// SchemaService.ListSchemas must match the call that provided the page token. +func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSchemasListCall { c.urlParams_.Set("pageToken", pageToken) return c } -// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": -// When set to `true`, operations that are reachable are returned as normal, -// and those that are unreachable are returned in the -// ListOperationsResponse.unreachable field. This can only be `true` when -// reading across collections. For example, when `parent` is set to -// "projects/example/locations/-". This field is not supported by default and -// will result in an `UNIMPLEMENTED` error if set unless explicitly documented -// otherwise in service or product specific documentation. -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall { - c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) - return c -} - // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSchemasListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -38983,34 +40941,34 @@ func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) Fields( // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSchemasListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSchemasListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/operations") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/schemas") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -39018,19 +40976,19 @@ func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) doReque } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.models.operations.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.models.operations.list" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.schemas.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningListOperationsResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1ListSchemasResponse.ServerResponse.Header or +// (if a response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListSchemasResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -39049,7 +41007,7 @@ func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) Do(opts if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningListOperationsResponse{ + ret := &GoogleCloudDiscoveryengineV1ListSchemasResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -39060,14 +41018,14 @@ func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) Do(opts if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.models.operations.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { +func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListSchemasResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -39085,7 +41043,122 @@ func (c *ProjectsLocationsCollectionsDataStoresModelsOperationsListCall) Pages(c } } -type ProjectsLocationsCollectionsDataStoresOperationsGetCall struct { +type ProjectsLocationsCollectionsDataStoresSchemasPatchCall struct { + s *Service + name string + googleclouddiscoveryenginev1schema *GoogleCloudDiscoveryengineV1Schema + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates a Schema. +// +// - name: Immutable. The full resource name of the schema, in the format of +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/schemas/{schema}`. This field must be a UTF-8 encoded +// string with a length limit of 1024 characters. +func (r *ProjectsLocationsCollectionsDataStoresSchemasService) Patch(name string, googleclouddiscoveryenginev1schema *GoogleCloudDiscoveryengineV1Schema) *ProjectsLocationsCollectionsDataStoresSchemasPatchCall { + c := &ProjectsLocationsCollectionsDataStoresSchemasPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleclouddiscoveryenginev1schema = googleclouddiscoveryenginev1schema + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to true, and +// the Schema is not found, a new Schema is created. In this situation, +// `update_mask` is ignored. +func (c *ProjectsLocationsCollectionsDataStoresSchemasPatchCall) AllowMissing(allowMissing bool) *ProjectsLocationsCollectionsDataStoresSchemasPatchCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsCollectionsDataStoresSchemasPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSchemasPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresSchemasPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSchemasPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsCollectionsDataStoresSchemasPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresSchemasPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1schema) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.schemas.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresSchemasPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.patch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -39099,8 +41172,8 @@ type ProjectsLocationsCollectionsDataStoresOperationsGetCall struct { // service. // // - name: The name of the operation resource. -func (r *ProjectsLocationsCollectionsDataStoresOperationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresOperationsGetCall { - c := &ProjectsLocationsCollectionsDataStoresOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsCollectionsDataStoresSchemasOperationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall { + c := &ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -39108,7 +41181,7 @@ func (r *ProjectsLocationsCollectionsDataStoresOperationsService) Get(name strin // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -39116,27 +41189,27 @@ func (c *ProjectsLocationsCollectionsDataStoresOperationsGetCall) Fields(s ...go // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresOperationsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresOperationsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -39153,17 +41226,17 @@ func (c *ProjectsLocationsCollectionsDataStoresOperationsGetCall) doRequest(alt googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.operations.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.operations.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.operations.get" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.schemas.operations.get" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -39193,11 +41266,11 @@ func (c *ProjectsLocationsCollectionsDataStoresOperationsGetCall) Do(opts ...goo if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.operations.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.operations.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresOperationsListCall struct { +type ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -39210,28 +41283,28 @@ type ProjectsLocationsCollectionsDataStoresOperationsListCall struct { // the server doesn't support this method, it returns `UNIMPLEMENTED`. // // - name: The name of the operation's parent resource. -func (r *ProjectsLocationsCollectionsDataStoresOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresOperationsListCall { - c := &ProjectsLocationsCollectionsDataStoresOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsCollectionsDataStoresSchemasOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall { + c := &ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } // Filter sets the optional parameter "filter": The standard list filter. -func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall { c.urlParams_.Set("filter", filter) return c } // PageSize sets the optional parameter "pageSize": The standard list page // size. -func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": The standard list page // token. -func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -39244,7 +41317,7 @@ func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) PageToken(pag // "projects/example/locations/-". This field is not supported by default and // will result in an `UNIMPLEMENTED` error if set unless explicitly documented // otherwise in service or product specific documentation. -func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsCollectionsDataStoresOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall { c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) return c } @@ -39252,7 +41325,7 @@ func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) ReturnPartial // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -39260,27 +41333,27 @@ func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) Fields(s ...g // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -39297,17 +41370,17 @@ func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) doRequest(alt googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.operations.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.operations.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.operations.list" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.schemas.operations.list" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningListOperationsResponse.ServerResponse.Header or (if a // response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -39337,14 +41410,14 @@ func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) Do(opts ...go if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.operations.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.operations.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { +func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -39362,68 +41435,180 @@ func (c *ProjectsLocationsCollectionsDataStoresOperationsListCall) Pages(ctx con } } -type ProjectsLocationsCollectionsDataStoresSchemasCreateCall struct { - s *Service - parent string - googleclouddiscoveryenginev1schema *GoogleCloudDiscoveryengineV1Schema - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1answerqueryrequest *GoogleCloudDiscoveryengineV1AnswerQueryRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Answer: Answer query method. +// +// - servingConfig: The resource name of the Search serving config, such as +// `projects/*/locations/global/collections/default_collection/engines/*/servi +// ngConfigs/default_serving_config`, or +// `projects/*/locations/global/collections/default_collection/dataStores/*/se +// rvingConfigs/default_serving_config`. This field is used to identify the +// serving configuration name, set of models used to make the search. +func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) Answer(servingConfig string, googleclouddiscoveryenginev1answerqueryrequest *GoogleCloudDiscoveryengineV1AnswerQueryRequest) *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall { + c := &ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1answerqueryrequest = googleclouddiscoveryenginev1answerqueryrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1answerqueryrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+servingConfig}:answer") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "servingConfig": c.servingConfig, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.answer", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.answer" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1AnswerQueryResponse.ServerResponse.Header or +// (if a response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1AnswerQueryResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudDiscoveryengineV1AnswerQueryResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.answer", "response", internallog.HTTPResponse(res, b)) + return ret, nil } -// Create: Creates a Schema. +type ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall struct { + s *Service + parent string + googleclouddiscoveryenginev1servingconfig *GoogleCloudDiscoveryengineV1ServingConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a ServingConfig. Note: The Google Cloud console works only +// with the default serving config. Additional ServingConfigs can be created +// and managed only via the API. A maximum of 100 ServingConfigs are allowed in +// an Engine, otherwise a RESOURCE_EXHAUSTED error is returned. // -// - parent: The parent data store resource name, in the format of -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}`. -func (r *ProjectsLocationsCollectionsDataStoresSchemasService) Create(parent string, googleclouddiscoveryenginev1schema *GoogleCloudDiscoveryengineV1Schema) *ProjectsLocationsCollectionsDataStoresSchemasCreateCall { - c := &ProjectsLocationsCollectionsDataStoresSchemasCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: Full resource name of parent. Format: +// `projects/{project}/locations/{location}/collections/{collection}/engines/{ +// engine}`. +func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) Create(parent string, googleclouddiscoveryenginev1servingconfig *GoogleCloudDiscoveryengineV1ServingConfig) *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall { + c := &ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent - c.googleclouddiscoveryenginev1schema = googleclouddiscoveryenginev1schema + c.googleclouddiscoveryenginev1servingconfig = googleclouddiscoveryenginev1servingconfig return c } -// SchemaId sets the optional parameter "schemaId": Required. The ID to use for -// the Schema, which becomes the final component of the Schema.name. This field -// should conform to RFC-1034 (https://tools.ietf.org/html/rfc1034) standard -// with a length limit of 63 characters. -func (c *ProjectsLocationsCollectionsDataStoresSchemasCreateCall) SchemaId(schemaId string) *ProjectsLocationsCollectionsDataStoresSchemasCreateCall { - c.urlParams_.Set("schemaId", schemaId) +// ServingConfigId sets the optional parameter "servingConfigId": Required. The +// ID to use for the ServingConfig, which will become the final component of +// the ServingConfig's resource name. This value should be 4-63 characters, and +// valid characters are /a-zA-Z0-9+/. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall) ServingConfigId(servingConfigId string) *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall { + c.urlParams_.Set("servingConfigId", servingConfigId) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSchemasCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSchemasCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSchemasCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSchemasCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSchemasCreateCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSchemasCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1schema) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1servingconfig) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/schemas") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/servingConfigs") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -39433,17 +41618,17 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasCreateCall) doRequest(alt googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.schemas.create" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.create" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1ServingConfig.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSchemasCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ServingConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -39462,7 +41647,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasCreateCall) Do(opts ...goo if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1ServingConfig{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -39473,11 +41658,11 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasCreateCall) Do(opts ...goo if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSchemasDeleteCall struct { +type ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -39485,13 +41670,14 @@ type ProjectsLocationsCollectionsDataStoresSchemasDeleteCall struct { header_ http.Header } -// Delete: Deletes a Schema. +// Delete: Deletes a ServingConfig. Returns a NOT_FOUND error if the +// ServingConfig does not exist. // -// - name: The full resource name of the schema, in the format of -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/schemas/{schema}`. -func (r *ProjectsLocationsCollectionsDataStoresSchemasService) Delete(name string) *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall { - c := &ProjectsLocationsCollectionsDataStoresSchemasDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The resource name of the ServingConfig to delete. Format: +// `projects/{project}/locations/{location}/collections/{collection}/engines/{ +// engine}/servingConfigs/{serving_config_id}`. +func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) Delete(name string) *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall { + c := &ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -39499,27 +41685,27 @@ func (r *ProjectsLocationsCollectionsDataStoresSchemasService) Delete(name strin // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") @@ -39533,17 +41719,17 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall) doRequest(alt googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.schemas.delete" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +// *GoogleProtobufEmpty.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -39562,7 +41748,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall) Do(opts ...goo if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleProtobufEmpty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -39573,11 +41759,11 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasDeleteCall) Do(opts ...goo if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSchemasGetCall struct { +type ProjectsLocationsCollectionsDataStoresServingConfigsGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -39586,13 +41772,14 @@ type ProjectsLocationsCollectionsDataStoresSchemasGetCall struct { header_ http.Header } -// Get: Gets a Schema. +// Get: Gets a ServingConfig. Returns a NotFound error if the ServingConfig +// does not exist. // -// - name: The full resource name of the schema, in the format of -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/schemas/{schema}`. -func (r *ProjectsLocationsCollectionsDataStoresSchemasService) Get(name string) *ProjectsLocationsCollectionsDataStoresSchemasGetCall { - c := &ProjectsLocationsCollectionsDataStoresSchemasGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The resource name of the ServingConfig to get. Format: +// `projects/{project}/locations/{location}/collections/{collection}/engines/{ +// engine}/servingConfigs/{serving_config_id}`. +func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) Get(name string) *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall { + c := &ProjectsLocationsCollectionsDataStoresServingConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -39600,7 +41787,7 @@ func (r *ProjectsLocationsCollectionsDataStoresSchemasService) Get(name string) // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSchemasGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSchemasGetCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -39608,27 +41795,27 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasGetCall) Fields(s ...googl // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresSchemasGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSchemasGetCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSchemasGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSchemasGetCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSchemasGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSchemasGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -39645,17 +41832,17 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasGetCall) doRequest(alt str googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.schemas.get" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Schema.ServerResponse.Header or (if a response -// was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1ServingConfig.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSchemasGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Schema, error) { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ServingConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -39674,7 +41861,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasGetCall) Do(opts ...google if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Schema{ + ret := &GoogleCloudDiscoveryengineV1ServingConfig{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -39685,11 +41872,11 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasGetCall) Do(opts ...google if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSchemasListCall struct { +type ProjectsLocationsCollectionsDataStoresServingConfigsListCall struct { s *Service parent string urlParams_ gensupport.URLParams @@ -39698,31 +41885,29 @@ type ProjectsLocationsCollectionsDataStoresSchemasListCall struct { header_ http.Header } -// List: Gets a list of Schemas. +// List: Lists all ServingConfigs linked to this dataStore. // -// - parent: The parent data store resource name, in the format of -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}`. -func (r *ProjectsLocationsCollectionsDataStoresSchemasService) List(parent string) *ProjectsLocationsCollectionsDataStoresSchemasListCall { - c := &ProjectsLocationsCollectionsDataStoresSchemasListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: Full resource name of the parent resource. Format: +// `projects/{project}/locations/{location}/collections/{collection}/engines/{ +// engine}`. +func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) List(parent string) *ProjectsLocationsCollectionsDataStoresServingConfigsListCall { + c := &ProjectsLocationsCollectionsDataStoresServingConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// PageSize sets the optional parameter "pageSize": The maximum number of -// Schemas to return. The service may return fewer than this value. If -// unspecified, at most 100 Schemas are returned. The maximum value is 1000; -// values above 1000 are set to 1000. -func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSchemasListCall { +// PageSize sets the optional parameter "pageSize": Maximum number of results +// to return. If unspecified, defaults to 100. If a value greater than 100 is +// provided, at most 100 results are returned. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresServingConfigsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": A page token, received -// from a previous SchemaService.ListSchemas call. Provide this to retrieve the -// subsequent page. When paginating, all other parameters provided to -// SchemaService.ListSchemas must match the call that provided the page token. -func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSchemasListCall { +// from a previous `ListServingConfigs` call. Provide this to retrieve the +// subsequent page. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresServingConfigsListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -39730,7 +41915,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) PageToken(pageTo // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSchemasListCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -39738,34 +41923,34 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) Fields(s ...goog // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSchemasListCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresServingConfigsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSchemasListCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/schemas") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/servingConfigs") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -39775,17 +41960,19 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) doRequest(alt st googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.schemas.list" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ListSchemasResponse.ServerResponse.Header or -// (if a response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because +// *GoogleCloudDiscoveryengineV1ListServingConfigsResponse.ServerResponse.Header +// +// or (if a response was returned at all) in error.(*googleapi.Error).Header. +// +// Use googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListSchemasResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListServingConfigsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -39804,7 +41991,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) Do(opts ...googl if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ListSchemasResponse{ + ret := &GoogleCloudDiscoveryengineV1ListServingConfigsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -39815,14 +42002,14 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) Do(opts ...googl if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListSchemasResponse) error) error { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListServingConfigsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -39840,62 +42027,62 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasListCall) Pages(ctx contex } } -type ProjectsLocationsCollectionsDataStoresSchemasPatchCall struct { - s *Service - name string - googleclouddiscoveryenginev1schema *GoogleCloudDiscoveryengineV1Schema - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall struct { + s *Service + name string + googleclouddiscoveryenginev1servingconfig *GoogleCloudDiscoveryengineV1ServingConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Patch: Updates a Schema. +// Patch: Updates a ServingConfig. Returns a NOT_FOUND error if the +// ServingConfig does not exist. // -// - name: Immutable. The full resource name of the schema, in the format of -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/schemas/{schema}`. This field must be a UTF-8 encoded -// string with a length limit of 1024 characters. -func (r *ProjectsLocationsCollectionsDataStoresSchemasService) Patch(name string, googleclouddiscoveryenginev1schema *GoogleCloudDiscoveryengineV1Schema) *ProjectsLocationsCollectionsDataStoresSchemasPatchCall { - c := &ProjectsLocationsCollectionsDataStoresSchemasPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Immutable. Fully qualified name +// `projects/{project}/locations/{location}/collections/{collection_id}/engine +// s/{engine_id}/servingConfigs/{serving_config_id}`. +func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) Patch(name string, googleclouddiscoveryenginev1servingconfig *GoogleCloudDiscoveryengineV1ServingConfig) *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall { + c := &ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googleclouddiscoveryenginev1schema = googleclouddiscoveryenginev1schema + c.googleclouddiscoveryenginev1servingconfig = googleclouddiscoveryenginev1servingconfig return c } -// AllowMissing sets the optional parameter "allowMissing": If set to true, and -// the Schema is not found, a new Schema is created. In this situation, -// `update_mask` is ignored. -func (c *ProjectsLocationsCollectionsDataStoresSchemasPatchCall) AllowMissing(allowMissing bool) *ProjectsLocationsCollectionsDataStoresSchemasPatchCall { - c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) +// UpdateMask sets the optional parameter "updateMask": Indicates which fields +// in the provided ServingConfig to update. The following are NOT supported: * +// ServingConfig.name If not set, all supported fields are updated. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall { + c.urlParams_.Set("updateMask", updateMask) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSchemasPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSchemasPatchCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSchemasPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSchemasPatchCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSchemasPatchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSchemasPatchCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1schema) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1servingconfig) if err != nil { return nil, err } @@ -39911,17 +42098,17 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasPatchCall) doRequest(alt s googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.patch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.schemas.patch" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.patch" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1ServingConfig.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSchemasPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ServingConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -39940,7 +42127,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasPatchCall) Do(opts ...goog if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1ServingConfig{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -39951,89 +42138,89 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasPatchCall) Do(opts ...goog if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.patch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.patch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1recommendrequest *GoogleCloudDiscoveryengineV1RecommendRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Get: 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. +// Recommend: Makes a recommendation, which requires a contextual user event. // -// - name: The name of the operation resource. -func (r *ProjectsLocationsCollectionsDataStoresSchemasOperationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall { - c := &ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - servingConfig: Full resource name of a ServingConfig: +// `projects/*/locations/global/collections/*/engines/*/servingConfigs/*`, or +// `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*` +// One default serving config is created along with your recommendation +// engine creation. The engine ID is used as the ID of the default serving +// config. For example, for Engine +// `projects/*/locations/global/collections/*/engines/my-engine`, you can use +// `projects/*/locations/global/collections/*/engines/my-engine/servingConfigs +// /my-engine` for your RecommendationService.Recommend requests. +func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) Recommend(servingConfig string, googleclouddiscoveryenginev1recommendrequest *GoogleCloudDiscoveryengineV1RecommendRequest) *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall { + c := &ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1recommendrequest = googleclouddiscoveryenginev1recommendrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1recommendrequest) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+servingConfig}:recommend") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "servingConfig": c.servingConfig, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.operations.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.recommend", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.schemas.operations.get" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.recommend" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1RecommendResponse.ServerResponse.Header or (if +// a response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1RecommendResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -40052,7 +42239,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall) Do(opts if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1RecommendResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -40063,121 +42250,225 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsGetCall) Do(opts if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.operations.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.recommend", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1searchrequest *GoogleCloudDiscoveryengineV1SearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// List: Lists operations that match the specified filter in the request. If -// the server doesn't support this method, it returns `UNIMPLEMENTED`. +// Search: Performs a search. // -// - name: The name of the operation's parent resource. -func (r *ProjectsLocationsCollectionsDataStoresSchemasOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall { - c := &ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - servingConfig: The resource name of the Search serving config, such as +// `projects/*/locations/global/collections/default_collection/engines/*/servi +// ngConfigs/default_serving_config`, or +// `projects/*/locations/global/collections/default_collection/dataStores/defa +// ult_data_store/servingConfigs/default_serving_config`. This field is used +// to identify the serving configuration name, set of models used to make the +// search. +func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) Search(servingConfig string, googleclouddiscoveryenginev1searchrequest *GoogleCloudDiscoveryengineV1SearchRequest) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall { + c := &ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1searchrequest = googleclouddiscoveryenginev1searchrequest return c } -// Filter sets the optional parameter "filter": The standard list filter. -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall { - c.urlParams_.Set("filter", filter) +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// PageSize sets the optional parameter "pageSize": The standard list page -// size. -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall { + c.ctx_ = ctx return c } -// PageToken sets the optional parameter "pageToken": The standard list page -// token. -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall { - c.urlParams_.Set("pageToken", pageToken) - return c +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ } -// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": -// When set to `true`, operations that are reachable are returned as normal, -// and those that are unreachable are returned in the -// ListOperationsResponse.unreachable field. This can only be `true` when -// reading across collections. For example, when `parent` is set to -// "projects/example/locations/-". This field is not supported by default and -// will result in an `UNIMPLEMENTED` error if set unless explicitly documented -// otherwise in service or product specific documentation. -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall { - c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1searchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+servingConfig}:search") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "servingConfig": c.servingConfig, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.search", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.search" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1SearchResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1SearchResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudDiscoveryengineV1SearchResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.search", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1SearchResponse) error) error { + c.ctx_ = ctx + defer func(pt string) { c.googleclouddiscoveryenginev1searchrequest.PageToken = pt }(c.googleclouddiscoveryenginev1searchrequest.PageToken) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.googleclouddiscoveryenginev1searchrequest.PageToken = x.NextPageToken + } +} + +type ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1searchrequest *GoogleCloudDiscoveryengineV1SearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SearchLite: 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. +// +// - servingConfig: The resource name of the Search serving config, such as +// `projects/*/locations/global/collections/default_collection/engines/*/servi +// ngConfigs/default_serving_config`, or +// `projects/*/locations/global/collections/default_collection/dataStores/defa +// ult_data_store/servingConfigs/default_serving_config`. This field is used +// to identify the serving configuration name, set of models used to make the +// search. +func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) SearchLite(servingConfig string, googleclouddiscoveryenginev1searchrequest *GoogleCloudDiscoveryengineV1SearchRequest) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall { + c := &ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1searchrequest = googleclouddiscoveryenginev1searchrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1searchrequest) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/operations") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+servingConfig}:searchLite") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "servingConfig": c.servingConfig, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.operations.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.searchLite", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.schemas.operations.list" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.searchLite" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningListOperationsResponse.ServerResponse.Header or (if a +// *GoogleCloudDiscoveryengineV1SearchResponse.ServerResponse.Header or (if a // response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1SearchResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -40196,7 +42487,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) Do(opt if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningListOperationsResponse{ + ret := &GoogleCloudDiscoveryengineV1SearchResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -40207,16 +42498,16 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) Do(opt if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.schemas.operations.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.searchLite", "response", internallog.HTTPResponse(res, b)) return ret, nil } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1SearchResponse) error) error { c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) + defer func(pt string) { c.googleclouddiscoveryenginev1searchrequest.PageToken = pt }(c.googleclouddiscoveryenginev1searchrequest.PageToken) for { x, err := c.Do() if err != nil { @@ -40228,11 +42519,11 @@ func (c *ProjectsLocationsCollectionsDataStoresSchemasOperationsListCall) Pages( if x.NextPageToken == "" { return nil } - c.PageToken(x.NextPageToken) + c.googleclouddiscoveryenginev1searchrequest.PageToken = x.NextPageToken } } -type ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall struct { +type ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall struct { s *Service servingConfig string googleclouddiscoveryenginev1answerqueryrequest *GoogleCloudDiscoveryengineV1AnswerQueryRequest @@ -40241,7 +42532,9 @@ type ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall struct { header_ http.Header } -// Answer: Answer query method. +// StreamAnswer: Answer query method (streaming). It takes one +// AnswerQueryRequest and returns multiple AnswerQueryResponse messages in a +// stream. // // - servingConfig: The resource name of the Search serving config, such as // `projects/*/locations/global/collections/default_collection/engines/*/servi @@ -40249,8 +42542,8 @@ type ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall struct { // `projects/*/locations/global/collections/default_collection/dataStores/*/se // rvingConfigs/default_serving_config`. This field is used to identify the // serving configuration name, set of models used to make the search. -func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) Answer(servingConfig string, googleclouddiscoveryenginev1answerqueryrequest *GoogleCloudDiscoveryengineV1AnswerQueryRequest) *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall { - c := &ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) StreamAnswer(servingConfig string, googleclouddiscoveryenginev1answerqueryrequest *GoogleCloudDiscoveryengineV1AnswerQueryRequest) *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall { + c := &ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.servingConfig = servingConfig c.googleclouddiscoveryenginev1answerqueryrequest = googleclouddiscoveryenginev1answerqueryrequest return c @@ -40259,27 +42552,27 @@ func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) Answer(ser // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1answerqueryrequest) if err != nil { @@ -40287,7 +42580,7 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall) doReque } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+servingConfig}:answer") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+servingConfig}:streamAnswer") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -40297,17 +42590,17 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall) doReque googleapi.Expand(req.URL, map[string]string{ "servingConfig": c.servingConfig, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.answer", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.streamAnswer", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.answer" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.streamAnswer" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleCloudDiscoveryengineV1AnswerQueryResponse.ServerResponse.Header or // (if a response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1AnswerQueryResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1AnswerQueryResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -40337,75 +42630,64 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsAnswerCall) Do(opts if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.answer", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.streamAnswer", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall struct { - s *Service - parent string - googleclouddiscoveryenginev1servingconfig *GoogleCloudDiscoveryengineV1ServingConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresSessionsCreateCall struct { + s *Service + parent string + googleclouddiscoveryenginev1session *GoogleCloudDiscoveryengineV1Session + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Create: Creates a ServingConfig. Note: The Google Cloud console works only -// with the default serving config. Additional ServingConfigs can be created -// and managed only via the API. A maximum of 100 ServingConfigs are allowed in -// an Engine, otherwise a RESOURCE_EXHAUSTED error is returned. +// Create: Creates a Session. If the Session to create already exists, an +// ALREADY_EXISTS error is returned. // -// - parent: Full resource name of parent. Format: -// `projects/{project}/locations/{location}/collections/{collection}/engines/{ -// engine}`. -func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) Create(parent string, googleclouddiscoveryenginev1servingconfig *GoogleCloudDiscoveryengineV1ServingConfig) *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall { - c := &ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: Full resource name of parent data store. Format: +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store_id}`. +func (r *ProjectsLocationsCollectionsDataStoresSessionsService) Create(parent string, googleclouddiscoveryenginev1session *GoogleCloudDiscoveryengineV1Session) *ProjectsLocationsCollectionsDataStoresSessionsCreateCall { + c := &ProjectsLocationsCollectionsDataStoresSessionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent - c.googleclouddiscoveryenginev1servingconfig = googleclouddiscoveryenginev1servingconfig - return c -} - -// ServingConfigId sets the optional parameter "servingConfigId": Required. The -// ID to use for the ServingConfig, which will become the final component of -// the ServingConfig's resource name. This value should be 4-63 characters, and -// valid characters are /a-zA-Z0-9+/. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall) ServingConfigId(servingConfigId string) *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall { - c.urlParams_.Set("servingConfigId", servingConfigId) + c.googleclouddiscoveryenginev1session = googleclouddiscoveryenginev1session return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresSessionsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSessionsCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresSessionsCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSessionsCreateCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSessionsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSessionsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1servingconfig) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1session) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/servingConfigs") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/sessions") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -40415,17 +42697,17 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall) doReque googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.create" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.sessions.create" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ServingConfig.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1Session.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ServingConfig, error) { +func (c *ProjectsLocationsCollectionsDataStoresSessionsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Session, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -40444,7 +42726,7 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall) Do(opts if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ServingConfig{ + ret := &GoogleCloudDiscoveryengineV1Session{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -40455,11 +42737,11 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsCreateCall) Do(opts if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall struct { +type ProjectsLocationsCollectionsDataStoresSessionsDeleteCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -40467,14 +42749,14 @@ type ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall struct { header_ http.Header } -// Delete: Deletes a ServingConfig. Returns a NOT_FOUND error if the -// ServingConfig does not exist. +// Delete: Deletes a Session. If the Session to delete does not exist, a +// NOT_FOUND error is returned. // -// - name: The resource name of the ServingConfig to delete. Format: -// `projects/{project}/locations/{location}/collections/{collection}/engines/{ -// engine}/servingConfigs/{serving_config_id}`. -func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) Delete(name string) *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall { - c := &ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The resource name of the Session to delete. Format: +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store_id}/sessions/{session_id}`. +func (r *ProjectsLocationsCollectionsDataStoresSessionsService) Delete(name string) *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall { + c := &ProjectsLocationsCollectionsDataStoresSessionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -40482,27 +42764,27 @@ func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) Delete(nam // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") @@ -40516,17 +42798,17 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall) doReque googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.delete" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.sessions.delete" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleProtobufEmpty.ServerResponse.Header or (if a response was returned at // all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to // check whether the returned error was because http.StatusNotModified was // returned. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { +func (c *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -40556,11 +42838,11 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsDeleteCall) Do(opts if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresServingConfigsGetCall struct { +type ProjectsLocationsCollectionsDataStoresSessionsGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -40569,22 +42851,28 @@ type ProjectsLocationsCollectionsDataStoresServingConfigsGetCall struct { header_ http.Header } -// Get: Gets a ServingConfig. Returns a NotFound error if the ServingConfig -// does not exist. +// Get: Gets a Session. // -// - name: The resource name of the ServingConfig to get. Format: -// `projects/{project}/locations/{location}/collections/{collection}/engines/{ -// engine}/servingConfigs/{serving_config_id}`. -func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) Get(name string) *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall { - c := &ProjectsLocationsCollectionsDataStoresServingConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The resource name of the Session to get. Format: +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store_id}/sessions/{session_id}`. +func (r *ProjectsLocationsCollectionsDataStoresSessionsService) Get(name string) *ProjectsLocationsCollectionsDataStoresSessionsGetCall { + c := &ProjectsLocationsCollectionsDataStoresSessionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } +// IncludeAnswerDetails sets the optional parameter "includeAnswerDetails": If +// set to true, the full session including all answer details will be returned. +func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) IncludeAnswerDetails(includeAnswerDetails bool) *ProjectsLocationsCollectionsDataStoresSessionsGetCall { + c.urlParams_.Set("includeAnswerDetails", fmt.Sprint(includeAnswerDetails)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSessionsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -40592,27 +42880,27 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall) Fields(s . // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSessionsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSessionsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -40629,17 +42917,17 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall) doRequest( googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.get" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.sessions.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ServingConfig.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1Session.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ServingConfig, error) { +func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Session, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -40658,7 +42946,7 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall) Do(opts .. if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ServingConfig{ + ret := &GoogleCloudDiscoveryengineV1Session{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -40669,11 +42957,11 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsGetCall) Do(opts .. if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresServingConfigsListCall struct { +type ProjectsLocationsCollectionsDataStoresSessionsListCall struct { s *Service parent string urlParams_ gensupport.URLParams @@ -40682,29 +42970,50 @@ type ProjectsLocationsCollectionsDataStoresServingConfigsListCall struct { header_ http.Header } -// List: Lists all ServingConfigs linked to this dataStore. +// List: Lists all Sessions by their parent DataStore. // -// - parent: Full resource name of the parent resource. Format: -// `projects/{project}/locations/{location}/collections/{collection}/engines/{ -// engine}`. -func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) List(parent string) *ProjectsLocationsCollectionsDataStoresServingConfigsListCall { - c := &ProjectsLocationsCollectionsDataStoresServingConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: The data store resource name. Format: +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store_id}`. +func (r *ProjectsLocationsCollectionsDataStoresSessionsService) List(parent string) *ProjectsLocationsCollectionsDataStoresSessionsListCall { + c := &ProjectsLocationsCollectionsDataStoresSessionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } +// Filter sets the optional parameter "filter": A comma-separated list of +// fields to filter by, in EBNF grammar. The supported fields are: * +// `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * +// `labels` * `create_time` * `update_time` Examples: * `user_pseudo_id = +// some_id` * `display_name = "some_name" * `starred = true` * `is_pinned=true +// AND (NOT labels:hidden)` * `create_time > "1970-01-01T12:00:00Z" +func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresSessionsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": A comma-separated list of +// fields to order by, sorted in ascending order. Use "desc" after a field name +// for descending. Supported fields: * `update_time` * `create_time` * +// `session_name` * `is_pinned` Example: * `update_time desc` * `create_time` * +// `is_pinned desc,update_time desc`: list sessions by is_pinned first, then by +// update_time. +func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) OrderBy(orderBy string) *ProjectsLocationsCollectionsDataStoresSessionsListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + // PageSize sets the optional parameter "pageSize": Maximum number of results -// to return. If unspecified, defaults to 100. If a value greater than 100 is -// provided, at most 100 results are returned. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresServingConfigsListCall { +// to return. If unspecified, defaults to 50. Max allowed value is 1000. +func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSessionsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": A page token, received -// from a previous `ListServingConfigs` call. Provide this to retrieve the -// subsequent page. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresServingConfigsListCall { +// from a previous `ListSessions` call. Provide this to retrieve the subsequent +// page. +func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSessionsListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -40712,7 +43021,7 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) PageToken // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSessionsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -40720,34 +43029,34 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) Fields(s // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresServingConfigsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSessionsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSessionsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/servingConfigs") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/sessions") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -40757,19 +43066,17 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) doRequest googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.list" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.sessions.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ListServingConfigsResponse.ServerResponse.Header -// -// or (if a response was returned at all) in error.(*googleapi.Error).Header. -// -// Use googleapi.IsNotModified to check whether the returned error was because +// *GoogleCloudDiscoveryengineV1ListSessionsResponse.ServerResponse.Header or +// (if a response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListServingConfigsResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListSessionsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -40788,7 +43095,7 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) Do(opts . if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ListServingConfigsResponse{ + ret := &GoogleCloudDiscoveryengineV1ListSessionsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -40799,14 +43106,14 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) Do(opts . if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListServingConfigsResponse) error) error { +func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListSessionsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -40824,32 +43131,32 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsListCall) Pages(ctx } } -type ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall struct { - s *Service - name string - googleclouddiscoveryenginev1servingconfig *GoogleCloudDiscoveryengineV1ServingConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresSessionsPatchCall struct { + s *Service + name string + googleclouddiscoveryenginev1session *GoogleCloudDiscoveryengineV1Session + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Patch: Updates a ServingConfig. Returns a NOT_FOUND error if the -// ServingConfig does not exist. +// Patch: Updates a Session. Session action type cannot be changed. If the +// Session to update does not exist, a NOT_FOUND error is returned. // // - name: Immutable. Fully qualified name -// `projects/{project}/locations/{location}/collections/{collection_id}/engine -// s/{engine_id}/servingConfigs/{serving_config_id}`. -func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) Patch(name string, googleclouddiscoveryenginev1servingconfig *GoogleCloudDiscoveryengineV1ServingConfig) *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall { - c := &ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// `projects/{project}/locations/global/collections/{collection}/engines/{engi +// ne}/sessions/*`. +func (r *ProjectsLocationsCollectionsDataStoresSessionsService) Patch(name string, googleclouddiscoveryenginev1session *GoogleCloudDiscoveryengineV1Session) *ProjectsLocationsCollectionsDataStoresSessionsPatchCall { + c := &ProjectsLocationsCollectionsDataStoresSessionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googleclouddiscoveryenginev1servingconfig = googleclouddiscoveryenginev1servingconfig + c.googleclouddiscoveryenginev1session = googleclouddiscoveryenginev1session return c } // UpdateMask sets the optional parameter "updateMask": Indicates which fields -// in the provided ServingConfig to update. The following are NOT supported: * -// ServingConfig.name If not set, all supported fields are updated. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall { +// in the provided Session to update. The following are NOT supported: * +// Session.name If not set or empty, all supported fields are updated. +func (c *ProjectsLocationsCollectionsDataStoresSessionsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsDataStoresSessionsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c } @@ -40857,29 +43164,29 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall) UpdateMa // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall { +func (c *ProjectsLocationsCollectionsDataStoresSessionsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSessionsPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall { +func (c *ProjectsLocationsCollectionsDataStoresSessionsPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSessionsPatchCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSessionsPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSessionsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1servingconfig) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1session) if err != nil { return nil, err } @@ -40895,17 +43202,17 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall) doReques googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.patch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.patch" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.sessions.patch" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ServingConfig.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1Session.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ServingConfig, error) { +func (c *ProjectsLocationsCollectionsDataStoresSessionsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Session, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -40924,7 +43231,7 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall) Do(opts if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ServingConfig{ + ret := &GoogleCloudDiscoveryengineV1Session{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -40935,69 +43242,176 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsPatchCall) Do(opts if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.patch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.patch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall struct { - s *Service - servingConfig string - googleclouddiscoveryenginev1recommendrequest *GoogleCloudDiscoveryengineV1RecommendRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Recommend: Makes a recommendation, which requires a contextual user event. +// Get: Gets a Answer. // -// - servingConfig: Full resource name of a ServingConfig: -// `projects/*/locations/global/collections/*/engines/*/servingConfigs/*`, or -// `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*` -// One default serving config is created along with your recommendation -// engine creation. The engine ID is used as the ID of the default serving -// config. For example, for Engine -// `projects/*/locations/global/collections/*/engines/my-engine`, you can use -// `projects/*/locations/global/collections/*/engines/my-engine/servingConfigs -// /my-engine` for your RecommendationService.Recommend requests. -func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) Recommend(servingConfig string, googleclouddiscoveryenginev1recommendrequest *GoogleCloudDiscoveryengineV1RecommendRequest) *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall { - c := &ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.servingConfig = servingConfig - c.googleclouddiscoveryenginev1recommendrequest = googleclouddiscoveryenginev1recommendrequest +// - name: The resource name of the Answer to get. Format: +// `projects/{project}/locations/{location}/collections/{collection}/engines/{ +// engine_id}/sessions/{session_id}/answers/{answer_id}`. +func (r *ProjectsLocationsCollectionsDataStoresSessionsAnswersService) Get(name string) *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall { + c := &ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.answers.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.sessions.answers.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1Answer.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Answer, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudDiscoveryengineV1Answer{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.answers.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall struct { + s *Service + parent string + googleclouddiscoveryenginev1batchverifytargetsitesrequest *GoogleCloudDiscoveryengineV1BatchVerifyTargetSitesRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// BatchVerifyTargetSites: Verify target sites' ownership and validity. This +// API sends all the target sites under site search engine for verification. +// +// - parent: The parent resource shared by all TargetSites being verified. +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/siteSearchEngine`. +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineService) BatchVerifyTargetSites(parent string, googleclouddiscoveryenginev1batchverifytargetsitesrequest *GoogleCloudDiscoveryengineV1BatchVerifyTargetSitesRequest) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1batchverifytargetsitesrequest = googleclouddiscoveryenginev1batchverifytargetsitesrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1recommendrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1batchverifytargetsitesrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+servingConfig}:recommend") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}:batchVerifyTargetSites") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -41005,19 +43419,19 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall) doRe } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "servingConfig": c.servingConfig, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.recommend", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.batchVerifyTargetSites", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.recommend" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.batchVerifyTargetSites" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1RecommendResponse.ServerResponse.Header or (if -// a response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1RecommendResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -41036,7 +43450,7 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall) Do(o if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1RecommendResponse{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -41047,67 +43461,64 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall) Do(o if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.recommend", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.batchVerifyTargetSites", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall struct { - s *Service - servingConfig string - googleclouddiscoveryenginev1searchrequest *GoogleCloudDiscoveryengineV1SearchRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall struct { + s *Service + siteSearchEngine string + googleclouddiscoveryenginev1disableadvancedsitesearchrequest *GoogleCloudDiscoveryengineV1DisableAdvancedSiteSearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Search: Performs a search. +// DisableAdvancedSiteSearch: Downgrade from advanced site search to basic site +// search. // -// - servingConfig: The resource name of the Search serving config, such as -// `projects/*/locations/global/collections/default_collection/engines/*/servi -// ngConfigs/default_serving_config`, or -// `projects/*/locations/global/collections/default_collection/dataStores/defa -// ult_data_store/servingConfigs/default_serving_config`. This field is used -// to identify the serving configuration name, set of models used to make the -// search. -func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) Search(servingConfig string, googleclouddiscoveryenginev1searchrequest *GoogleCloudDiscoveryengineV1SearchRequest) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall { - c := &ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.servingConfig = servingConfig - c.googleclouddiscoveryenginev1searchrequest = googleclouddiscoveryenginev1searchrequest +// - siteSearchEngine: Full resource name of the SiteSearchEngine, such as +// `projects/{project}/locations/{location}/dataStores/{data_store_id}/siteSea +// rchEngine`. +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineService) DisableAdvancedSiteSearch(siteSearchEngine string, googleclouddiscoveryenginev1disableadvancedsitesearchrequest *GoogleCloudDiscoveryengineV1DisableAdvancedSiteSearchRequest) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.siteSearchEngine = siteSearchEngine + c.googleclouddiscoveryenginev1disableadvancedsitesearchrequest = googleclouddiscoveryenginev1disableadvancedsitesearchrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1searchrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1disableadvancedsitesearchrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+servingConfig}:search") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+siteSearchEngine}:disableAdvancedSiteSearch") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -41115,19 +43526,19 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) doReque } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "servingConfig": c.servingConfig, + "siteSearchEngine": c.siteSearchEngine, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.search", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.disableAdvancedSiteSearch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.search" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.disableAdvancedSiteSearch" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1SearchResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1SearchResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -41146,7 +43557,7 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) Do(opts if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1SearchResponse{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -41157,95 +43568,64 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) Do(opts if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.search", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.disableAdvancedSiteSearch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1SearchResponse) error) error { - c.ctx_ = ctx - defer func(pt string) { c.googleclouddiscoveryenginev1searchrequest.PageToken = pt }(c.googleclouddiscoveryenginev1searchrequest.PageToken) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.googleclouddiscoveryenginev1searchrequest.PageToken = x.NextPageToken - } -} - -type ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall struct { - s *Service - servingConfig string - googleclouddiscoveryenginev1searchrequest *GoogleCloudDiscoveryengineV1SearchRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall struct { + s *Service + siteSearchEngine string + googleclouddiscoveryenginev1enableadvancedsitesearchrequest *GoogleCloudDiscoveryengineV1EnableAdvancedSiteSearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// SearchLite: 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. +// EnableAdvancedSiteSearch: Upgrade from basic site search to advanced site +// search. // -// - servingConfig: The resource name of the Search serving config, such as -// `projects/*/locations/global/collections/default_collection/engines/*/servi -// ngConfigs/default_serving_config`, or -// `projects/*/locations/global/collections/default_collection/dataStores/defa -// ult_data_store/servingConfigs/default_serving_config`. This field is used -// to identify the serving configuration name, set of models used to make the -// search. -func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) SearchLite(servingConfig string, googleclouddiscoveryenginev1searchrequest *GoogleCloudDiscoveryengineV1SearchRequest) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall { - c := &ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.servingConfig = servingConfig - c.googleclouddiscoveryenginev1searchrequest = googleclouddiscoveryenginev1searchrequest +// - siteSearchEngine: Full resource name of the SiteSearchEngine, such as +// `projects/{project}/locations/{location}/dataStores/{data_store_id}/siteSea +// rchEngine`. +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineService) EnableAdvancedSiteSearch(siteSearchEngine string, googleclouddiscoveryenginev1enableadvancedsitesearchrequest *GoogleCloudDiscoveryengineV1EnableAdvancedSiteSearchRequest) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.siteSearchEngine = siteSearchEngine + c.googleclouddiscoveryenginev1enableadvancedsitesearchrequest = googleclouddiscoveryenginev1enableadvancedsitesearchrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1searchrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1enableadvancedsitesearchrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+servingConfig}:searchLite") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+siteSearchEngine}:enableAdvancedSiteSearch") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -41253,19 +43633,19 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) doR } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "servingConfig": c.servingConfig, + "siteSearchEngine": c.siteSearchEngine, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.searchLite", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.enableAdvancedSiteSearch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.searchLite" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.enableAdvancedSiteSearch" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1SearchResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1SearchResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -41284,7 +43664,7 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Do( if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1SearchResponse{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -41295,109 +43675,112 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Do( if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.searchLite", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.enableAdvancedSiteSearch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1SearchResponse) error) error { - c.ctx_ = ctx - defer func(pt string) { c.googleclouddiscoveryenginev1searchrequest.PageToken = pt }(c.googleclouddiscoveryenginev1searchrequest.PageToken) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.googleclouddiscoveryenginev1searchrequest.PageToken = x.NextPageToken - } +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall struct { + s *Service + siteSearchEngine string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -type ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall struct { - s *Service - servingConfig string - googleclouddiscoveryenginev1answerqueryrequest *GoogleCloudDiscoveryengineV1AnswerQueryRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +// FetchDomainVerificationStatus: Returns list of target sites with its domain +// verification status. This method can only be called under data store with +// BASIC_SITE_SEARCH state at the moment. +// +// - siteSearchEngine: The site search engine resource under which we fetch all +// the domain verification status. +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/siteSearchEngine`. +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineService) FetchDomainVerificationStatus(siteSearchEngine string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.siteSearchEngine = siteSearchEngine + return c } -// StreamAnswer: Answer query method (streaming). It takes one -// AnswerQueryRequest and returns multiple AnswerQueryResponse messages in a -// stream. -// -// - servingConfig: The resource name of the Search serving config, such as -// `projects/*/locations/global/collections/default_collection/engines/*/servi -// ngConfigs/default_serving_config`, or -// `projects/*/locations/global/collections/default_collection/dataStores/*/se -// rvingConfigs/default_serving_config`. This field is used to identify the -// serving configuration name, set of models used to make the search. -func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) StreamAnswer(servingConfig string, googleclouddiscoveryenginev1answerqueryrequest *GoogleCloudDiscoveryengineV1AnswerQueryRequest) *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall { - c := &ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.servingConfig = servingConfig - c.googleclouddiscoveryenginev1answerqueryrequest = googleclouddiscoveryenginev1answerqueryrequest +// PageSize sets the optional parameter "pageSize": Requested page size. Server +// may return fewer items than requested. If unspecified, server will pick an +// appropriate default. The maximum value is 1000; values above 1000 will be +// coerced to 1000. If this field is negative, an INVALID_ARGUMENT error is +// returned. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `FetchDomainVerificationStatus` call. Provide this to +// retrieve the subsequent page. When paginating, all other parameters provided +// to `FetchDomainVerificationStatus` must match the call that provided the +// page token. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall { + c.urlParams_.Set("pageToken", pageToken) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1answerqueryrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+servingConfig}:streamAnswer") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+siteSearchEngine}:fetchDomainVerificationStatus") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "servingConfig": c.servingConfig, + "siteSearchEngine": c.siteSearchEngine, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.streamAnswer", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.fetchDomainVerificationStatus", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.streamAnswer" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.fetchDomainVerificationStatus" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1AnswerQueryResponse.ServerResponse.Header or -// (if a response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1AnswerQueryResponse, error) { +// *GoogleCloudDiscoveryengineV1FetchDomainVerificationStatusResponse.ServerResp +// onse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1FetchDomainVerificationStatusResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -41416,7 +43799,7 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall) D if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1AnswerQueryResponse{ + ret := &GoogleCloudDiscoveryengineV1FetchDomainVerificationStatusResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -41427,64 +43810,83 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsStreamAnswerCall) D if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.servingConfigs.streamAnswer", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.fetchDomainVerificationStatus", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSessionsCreateCall struct { - s *Service - parent string - googleclouddiscoveryenginev1session *GoogleCloudDiscoveryengineV1Session - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1FetchDomainVerificationStatusResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } } -// Create: Creates a Session. If the Session to create already exists, an -// ALREADY_EXISTS error is returned. +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall struct { + s *Service + siteSearchEngine string + googleclouddiscoveryenginev1recrawlurisrequest *GoogleCloudDiscoveryengineV1RecrawlUrisRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// RecrawlUris: Request on-demand recrawl for a list of URIs. // -// - parent: Full resource name of parent data store. Format: -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store_id}`. -func (r *ProjectsLocationsCollectionsDataStoresSessionsService) Create(parent string, googleclouddiscoveryenginev1session *GoogleCloudDiscoveryengineV1Session) *ProjectsLocationsCollectionsDataStoresSessionsCreateCall { - c := &ProjectsLocationsCollectionsDataStoresSessionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.googleclouddiscoveryenginev1session = googleclouddiscoveryenginev1session +// - siteSearchEngine: Full resource name of the SiteSearchEngine, such as +// `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine`. +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineService) RecrawlUris(siteSearchEngine string, googleclouddiscoveryenginev1recrawlurisrequest *GoogleCloudDiscoveryengineV1RecrawlUrisRequest) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.siteSearchEngine = siteSearchEngine + c.googleclouddiscoveryenginev1recrawlurisrequest = googleclouddiscoveryenginev1recrawlurisrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSessionsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSessionsCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSessionsCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSessionsCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSessionsCreateCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSessionsCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1session) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1recrawlurisrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/sessions") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+siteSearchEngine}:recrawlUris") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -41492,19 +43894,19 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsCreateCall) doRequest(alt } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "siteSearchEngine": c.siteSearchEngine, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.recrawlUris", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.sessions.create" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.recrawlUris" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Session.ServerResponse.Header or (if a response -// was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSessionsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Session, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -41523,7 +43925,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsCreateCall) Do(opts ...go if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Session{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -41534,26 +43936,26 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsCreateCall) Do(opts ...go if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.recrawlUris", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSessionsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Delete: Deletes a Session. If the Session to delete does not exist, a -// NOT_FOUND error is returned. +// Get: 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. // -// - name: The resource name of the Session to delete. Format: -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store_id}/sessions/{session_id}`. -func (r *ProjectsLocationsCollectionsDataStoresSessionsService) Delete(name string) *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall { - c := &ProjectsLocationsCollectionsDataStoresSessionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The name of the operation resource. +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -41561,33 +43963,44 @@ func (r *ProjectsLocationsCollectionsDataStoresSessionsService) Delete(name stri // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -41595,17 +44008,17 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall) doRequest(alt googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.sessions.delete" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleProtobufEmpty.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -41624,7 +44037,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall) Do(opts ...go if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleProtobufEmpty{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -41635,11 +44048,11 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsDeleteCall) Do(opts ...go if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSessionsGetCall struct { +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -41648,28 +44061,53 @@ type ProjectsLocationsCollectionsDataStoresSessionsGetCall struct { header_ http.Header } -// Get: Gets a Session. +// List: Lists operations that match the specified filter in the request. If +// the server doesn't support this method, it returns `UNIMPLEMENTED`. // -// - name: The resource name of the Session to get. Format: -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store_id}/sessions/{session_id}`. -func (r *ProjectsLocationsCollectionsDataStoresSessionsService) Get(name string) *ProjectsLocationsCollectionsDataStoresSessionsGetCall { - c := &ProjectsLocationsCollectionsDataStoresSessionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The name of the operation's parent resource. +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } -// IncludeAnswerDetails sets the optional parameter "includeAnswerDetails": If -// set to true, the full session including all answer details will be returned. -func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) IncludeAnswerDetails(includeAnswerDetails bool) *ProjectsLocationsCollectionsDataStoresSessionsGetCall { - c.urlParams_.Set("includeAnswerDetails", fmt.Sprint(includeAnswerDetails)) +// Filter sets the optional parameter "filter": The standard list filter. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list page +// size. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list page +// token. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": +// When set to `true`, operations that are reachable are returned as normal, +// and those that are unreachable are returned in the +// ListOperationsResponse.unreachable field. This can only be `true` when +// reading across collections. For example, when `parent` is set to +// "projects/example/locations/-". This field is not supported by default and +// will result in an `UNIMPLEMENTED` error if set unless explicitly documented +// otherwise in service or product specific documentation. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSessionsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -41677,34 +44115,34 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) Fields(s ...goog // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSessionsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSessionsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/operations") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -41714,17 +44152,17 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) doRequest(alt st googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.sessions.get" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Session.ServerResponse.Header or (if a response -// was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningListOperationsResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Session, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -41743,7 +44181,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) Do(opts ...googl if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Session{ + ret := &GoogleLongrunningListOperationsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -41754,108 +44192,85 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsGetCall) Do(opts ...googl if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSessionsListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// List: Lists all Sessions by their parent DataStore. -// -// - parent: The data store resource name. Format: -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store_id}`. -func (r *ProjectsLocationsCollectionsDataStoresSessionsService) List(parent string) *ProjectsLocationsCollectionsDataStoresSessionsListCall { - c := &ProjectsLocationsCollectionsDataStoresSessionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// Filter sets the optional parameter "filter": A comma-separated list of -// fields to filter by, in EBNF grammar. The supported fields are: * -// `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * -// `labels` * `create_time` * `update_time` Examples: * `user_pseudo_id = -// some_id` * `display_name = "some_name" * `starred = true` * `is_pinned=true -// AND (NOT labels:hidden)` * `create_time > "1970-01-01T12:00:00Z" -func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresSessionsListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// OrderBy sets the optional parameter "orderBy": A comma-separated list of -// fields to order by, sorted in ascending order. Use "desc" after a field name -// for descending. Supported fields: * `update_time` * `create_time` * -// `session_name` * `is_pinned` Example: * `update_time desc` * `create_time` * -// `is_pinned desc,update_time desc`: list sessions by is_pinned first, then by -// update_time. -func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) OrderBy(orderBy string) *ProjectsLocationsCollectionsDataStoresSessionsListCall { - c.urlParams_.Set("orderBy", orderBy) - return c +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } } -// PageSize sets the optional parameter "pageSize": Maximum number of results -// to return. If unspecified, defaults to 50. Max allowed value is 1000. -func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSessionsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall struct { + s *Service + parent string + googleclouddiscoveryenginev1sitemap *GoogleCloudDiscoveryengineV1Sitemap + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// PageToken sets the optional parameter "pageToken": A page token, received -// from a previous `ListSessions` call. Provide this to retrieve the subsequent -// page. -func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSessionsListCall { - c.urlParams_.Set("pageToken", pageToken) +// Create: Creates a Sitemap. +// +// - parent: Parent resource name of the SiteSearchEngine, such as +// `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine`. +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsService) Create(parent string, googleclouddiscoveryenginev1sitemap *GoogleCloudDiscoveryengineV1Sitemap) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1sitemap = googleclouddiscoveryenginev1sitemap return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSessionsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSessionsListCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSessionsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1sitemap) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/sessions") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/sitemaps") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } @@ -41863,17 +44278,17 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) doRequest(alt s googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.sessions.list" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.create" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ListSessionsResponse.ServerResponse.Header or -// (if a response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListSessionsResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -41892,7 +44307,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) Do(opts ...goog if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ListSessionsResponse{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -41903,95 +44318,62 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) Do(opts ...goog if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresSessionsListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListSessionsResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.PageToken(x.NextPageToken) - } -} - -type ProjectsLocationsCollectionsDataStoresSessionsPatchCall struct { - s *Service - name string - googleclouddiscoveryenginev1session *GoogleCloudDiscoveryengineV1Session - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Patch: Updates a Session. Session action type cannot be changed. If the -// Session to update does not exist, a NOT_FOUND error is returned. +// Delete: Deletes a Sitemap. // -// - name: Immutable. Fully qualified name -// `projects/{project}/locations/global/collections/{collection}/engines/{engi -// ne}/sessions/*`. -func (r *ProjectsLocationsCollectionsDataStoresSessionsService) Patch(name string, googleclouddiscoveryenginev1session *GoogleCloudDiscoveryengineV1Session) *ProjectsLocationsCollectionsDataStoresSessionsPatchCall { - c := &ProjectsLocationsCollectionsDataStoresSessionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Full resource name of Sitemap, such as +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/siteSearchEngine/sitemaps/{sitemap}`. If the caller does +// not have permission to access the Sitemap, regardless of whether or not it +// exists, a PERMISSION_DENIED error is returned. If the requested Sitemap +// does not exist, a NOT_FOUND error is returned. +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsService) Delete(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googleclouddiscoveryenginev1session = googleclouddiscoveryenginev1session - return c -} - -// UpdateMask sets the optional parameter "updateMask": Indicates which fields -// in the provided Session to update. The following are NOT supported: * -// Session.name If not set or empty, all supported fields are updated. -func (c *ProjectsLocationsCollectionsDataStoresSessionsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsDataStoresSessionsPatchCall { - c.urlParams_.Set("updateMask", updateMask) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSessionsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSessionsPatchCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSessionsPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSessionsPatchCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSessionsPatchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSessionsPatchCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1session) - if err != nil { - return nil, err - } +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } @@ -41999,17 +44381,17 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsPatchCall) doRequest(alt googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.sessions.patch" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Session.ServerResponse.Header or (if a response -// was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSessionsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Session, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -42028,7 +44410,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsPatchCall) Do(opts ...goo if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Session{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -42039,34 +44421,40 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsPatchCall) Do(opts ...goo if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.patch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall struct { +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall struct { s *Service - name string + parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// Get: Gets a Answer. +// Fetch: Fetch Sitemaps in a DataStore. // -// - name: The resource name of the Answer to get. Format: -// `projects/{project}/locations/{location}/collections/{collection}/engines/{ -// engine_id}/sessions/{session_id}/answers/{answer_id}`. -func (r *ProjectsLocationsCollectionsDataStoresSessionsAnswersService) Get(name string) *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall { - c := &ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: Parent resource name of the SiteSearchEngine, such as +// `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine`. +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsService) Fetch(parent string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// MatcherUrisMatcherUris sets the optional parameter +// "matcher.urisMatcher.uris": The Sitemap uris. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall) MatcherUrisMatcherUris(matcherUrisMatcherUris ...string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall { + c.urlParams_.SetMulti("matcher.urisMatcher.uris", append([]string{}, matcherUrisMatcherUris...)) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -42074,34 +44462,34 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall) Fields(s // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/sitemaps:fetch") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -42109,19 +44497,19 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall) doRequest } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.answers.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.fetch", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.sessions.answers.get" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.fetch" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Answer.ServerResponse.Header or (if a response -// was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1FetchSitemapsResponse.ServerResponse.Header or +// (if a response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Answer, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1FetchSitemapsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -42140,7 +44528,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall) Do(opts . if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Answer{ + ret := &GoogleCloudDiscoveryengineV1FetchSitemapsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -42151,64 +44539,64 @@ func (c *ProjectsLocationsCollectionsDataStoresSessionsAnswersGetCall) Do(opts . if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.sessions.answers.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.fetch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall struct { +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall struct { s *Service parent string - googleclouddiscoveryenginev1batchverifytargetsitesrequest *GoogleCloudDiscoveryengineV1BatchVerifyTargetSitesRequest + googleclouddiscoveryenginev1batchcreatetargetsitesrequest *GoogleCloudDiscoveryengineV1BatchCreateTargetSitesRequest urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } -// BatchVerifyTargetSites: Verify target sites' ownership and validity. This -// API sends all the target sites under site search engine for verification. +// BatchCreate: Creates TargetSite in a batch. // -// - parent: The parent resource shared by all TargetSites being verified. +// - parent: The parent resource shared by all TargetSites being created. // `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/siteSearchEngine`. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineService) BatchVerifyTargetSites(parent string, googleclouddiscoveryenginev1batchverifytargetsitesrequest *GoogleCloudDiscoveryengineV1BatchVerifyTargetSitesRequest) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// s/{data_store}/siteSearchEngine`. The parent field in the +// CreateBookRequest messages must either be empty or match this field. +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService) BatchCreate(parent string, googleclouddiscoveryenginev1batchcreatetargetsitesrequest *GoogleCloudDiscoveryengineV1BatchCreateTargetSitesRequest) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent - c.googleclouddiscoveryenginev1batchverifytargetsitesrequest = googleclouddiscoveryenginev1batchverifytargetsitesrequest + c.googleclouddiscoveryenginev1batchcreatetargetsitesrequest = googleclouddiscoveryenginev1batchcreatetargetsitesrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1batchverifytargetsitesrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1batchcreatetargetsitesrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}:batchVerifyTargetSites") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/targetSites:batchCreate") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -42218,17 +44606,17 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTarget googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.batchVerifyTargetSites", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.batchCreate", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.batchVerifyTargetSites" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.batchCreate" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTargetSitesCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -42258,64 +44646,63 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineBatchVerifyTarget if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.batchVerifyTargetSites", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.batchCreate", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall struct { - s *Service - siteSearchEngine string - googleclouddiscoveryenginev1disableadvancedsitesearchrequest *GoogleCloudDiscoveryengineV1DisableAdvancedSiteSearchRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall struct { + s *Service + parent string + googleclouddiscoveryenginev1targetsite *GoogleCloudDiscoveryengineV1TargetSite + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// DisableAdvancedSiteSearch: Downgrade from advanced site search to basic site -// search. +// Create: Creates a TargetSite. // -// - siteSearchEngine: Full resource name of the SiteSearchEngine, such as -// `projects/{project}/locations/{location}/dataStores/{data_store_id}/siteSea -// rchEngine`. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineService) DisableAdvancedSiteSearch(siteSearchEngine string, googleclouddiscoveryenginev1disableadvancedsitesearchrequest *GoogleCloudDiscoveryengineV1DisableAdvancedSiteSearchRequest) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.siteSearchEngine = siteSearchEngine - c.googleclouddiscoveryenginev1disableadvancedsitesearchrequest = googleclouddiscoveryenginev1disableadvancedsitesearchrequest +// - parent: Parent resource name of TargetSite, such as +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/siteSearchEngine`. +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService) Create(parent string, googleclouddiscoveryenginev1targetsite *GoogleCloudDiscoveryengineV1TargetSite) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1targetsite = googleclouddiscoveryenginev1targetsite return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1disableadvancedsitesearchrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1targetsite) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+siteSearchEngine}:disableAdvancedSiteSearch") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/targetSites") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -42323,19 +44710,19 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSi } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "siteSearchEngine": c.siteSearchEngine, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.disableAdvancedSiteSearch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.disableAdvancedSiteSearch" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.create" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSiteSearchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -42365,84 +44752,195 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineDisableAdvancedSi if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.disableAdvancedSiteSearch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall struct { - s *Service - siteSearchEngine string - googleclouddiscoveryenginev1enableadvancedsitesearchrequest *GoogleCloudDiscoveryengineV1EnableAdvancedSiteSearchRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// EnableAdvancedSiteSearch: Upgrade from basic site search to advanced site -// search. +// Delete: Deletes a TargetSite. // -// - siteSearchEngine: Full resource name of the SiteSearchEngine, such as -// `projects/{project}/locations/{location}/dataStores/{data_store_id}/siteSea -// rchEngine`. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineService) EnableAdvancedSiteSearch(siteSearchEngine string, googleclouddiscoveryenginev1enableadvancedsitesearchrequest *GoogleCloudDiscoveryengineV1EnableAdvancedSiteSearchRequest) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.siteSearchEngine = siteSearchEngine - c.googleclouddiscoveryenginev1enableadvancedsitesearchrequest = googleclouddiscoveryenginev1enableadvancedsitesearchrequest +// - name: Full resource name of TargetSite, such as +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/siteSearchEngine/targetSites/{target_site}`. If the caller +// does not have permission to access the TargetSite, regardless of whether +// or not it exists, a PERMISSION_DENIED error is returned. If the requested +// TargetSite does not exist, a NOT_FOUND error is returned. +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService) Delete(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.delete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.delete" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.delete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets a TargetSite. +// +// - name: Full resource name of TargetSite, such as +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/siteSearchEngine/targetSites/{target_site}`. If the caller +// does not have permission to access the TargetSite, regardless of whether +// or not it exists, a PERMISSION_DENIED error is returned. If the requested +// TargetSite does not exist, a NOT_FOUND error is returned. +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService) Get(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1enableadvancedsitesearchrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+siteSearchEngine}:enableAdvancedSiteSearch") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "siteSearchEngine": c.siteSearchEngine, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.enableAdvancedSiteSearch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.enableAdvancedSiteSearch" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1TargetSite.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSiteSearchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1TargetSite, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -42461,7 +44959,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSit if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1TargetSite{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -42472,30 +44970,29 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineEnableAdvancedSit if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.enableAdvancedSiteSearch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall struct { - s *Service - siteSearchEngine string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// FetchDomainVerificationStatus: Returns list of target sites with its domain -// verification status. This method can only be called under data store with -// BASIC_SITE_SEARCH state at the moment. +// List: Gets a list of TargetSites. // -// - siteSearchEngine: The site search engine resource under which we fetch all -// the domain verification status. +// - parent: The parent site search engine resource name, such as // `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/siteSearchEngine`. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineService) FetchDomainVerificationStatus(siteSearchEngine string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.siteSearchEngine = siteSearchEngine +// s/{data_store}/siteSearchEngine`. If the caller does not have permission +// to list TargetSites under this site search engine, regardless of whether +// or not this branch exists, a PERMISSION_DENIED error is returned. +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService) List(parent string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent return c } @@ -42504,17 +45001,16 @@ func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineService) FetchDom // appropriate default. The maximum value is 1000; values above 1000 will be // coerced to 1000. If this field is negative, an INVALID_ARGUMENT error is // returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": A page token, received -// from a previous `FetchDomainVerificationStatus` call. Provide this to -// retrieve the subsequent page. When paginating, all other parameters provided -// to `FetchDomainVerificationStatus` must match the call that provided the -// page token. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall { +// from a previous `ListTargetSites` call. Provide this to retrieve the +// subsequent page. When paginating, all other parameters provided to +// `ListTargetSites` must match the call that provided the page token. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -42522,7 +45018,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerifi // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -42530,34 +45026,34 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerifi // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+siteSearchEngine}:fetchDomainVerificationStatus") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/targetSites") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -42565,19 +45061,19 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerifi } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "siteSearchEngine": c.siteSearchEngine, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.fetchDomainVerificationStatus", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.fetchDomainVerificationStatus" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1FetchDomainVerificationStatusResponse.ServerResp -// onse.Header or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1FetchDomainVerificationStatusResponse, error) { +// *GoogleCloudDiscoveryengineV1ListTargetSitesResponse.ServerResponse.Header +// or (if a response was returned at all) in error.(*googleapi.Error).Header. +// Use googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListTargetSitesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -42596,7 +45092,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerifi if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1FetchDomainVerificationStatusResponse{ + ret := &GoogleCloudDiscoveryengineV1ListTargetSitesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -42607,14 +45103,14 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerifi if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.fetchDomainVerificationStatus", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerificationStatusCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1FetchDomainVerificationStatusResponse) error) error { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListTargetSitesResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -42632,78 +45128,80 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineFetchDomainVerifi } } -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall struct { - s *Service - siteSearchEngine string - googleclouddiscoveryenginev1recrawlurisrequest *GoogleCloudDiscoveryengineV1RecrawlUrisRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall struct { + s *Service + name string + googleclouddiscoveryenginev1targetsite *GoogleCloudDiscoveryengineV1TargetSite + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// RecrawlUris: Request on-demand recrawl for a list of URIs. +// Patch: Updates a TargetSite. // -// - siteSearchEngine: Full resource name of the SiteSearchEngine, such as -// `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine`. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineService) RecrawlUris(siteSearchEngine string, googleclouddiscoveryenginev1recrawlurisrequest *GoogleCloudDiscoveryengineV1RecrawlUrisRequest) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.siteSearchEngine = siteSearchEngine - c.googleclouddiscoveryenginev1recrawlurisrequest = googleclouddiscoveryenginev1recrawlurisrequest +// - name: Output only. The fully qualified resource name of the target site. +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/siteSearchEngine/targetSites/{target_site}` The +// `target_site_id` is system-generated. +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService) Patch(name string, googleclouddiscoveryenginev1targetsite *GoogleCloudDiscoveryengineV1TargetSite) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleclouddiscoveryenginev1targetsite = googleclouddiscoveryenginev1targetsite return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1recrawlurisrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1targetsite) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+siteSearchEngine}:recrawlUris") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "siteSearchEngine": c.siteSearchEngine, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.recrawlUris", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.patch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.recrawlUris" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.patch" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -42733,11 +45231,11 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineRecrawlUrisCall) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.recrawlUris", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.patch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall struct { +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -42751,8 +45249,8 @@ type ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall str // service. // // - name: The name of the operation resource. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -42760,7 +45258,7 @@ func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -42768,27 +45266,27 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -42805,17 +45303,17 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.get" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.get" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -42845,11 +45343,11 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall struct { +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -42862,28 +45360,28 @@ type ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall st // the server doesn't support this method, it returns `UNIMPLEMENTED`. // // - name: The name of the operation's parent resource. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } // Filter sets the optional parameter "filter": The standard list filter. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { c.urlParams_.Set("filter", filter) return c } // PageSize sets the optional parameter "pageSize": The standard list page // size. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": The standard list page // token. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -42896,7 +45394,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCal // "projects/example/locations/-". This field is not supported by default and // will result in an `UNIMPLEMENTED` error if set unless explicitly documented // otherwise in service or product specific documentation. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) return c } @@ -42904,7 +45402,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCal // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -42912,27 +45410,27 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCal // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -42949,17 +45447,17 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCal googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.list" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.list" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningListOperationsResponse.ServerResponse.Header or (if a // response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -42989,14 +45487,14 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCal if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -43014,58 +45512,59 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCal } } -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall struct { - s *Service - parent string - googleclouddiscoveryenginev1sitemap *GoogleCloudDiscoveryengineV1Sitemap - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall struct { + s *Service + parent string + googleclouddiscoveryenginev1importsuggestiondenylistentriesrequest *GoogleCloudDiscoveryengineV1ImportSuggestionDenyListEntriesRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Create: Creates a Sitemap. +// Import: Imports all SuggestionDenyListEntry for a DataStore. // -// - parent: Parent resource name of the SiteSearchEngine, such as -// `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine`. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsService) Create(parent string, googleclouddiscoveryenginev1sitemap *GoogleCloudDiscoveryengineV1Sitemap) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: The parent data store resource name for which to import denylist +// entries. Follows pattern +// projects/*/locations/*/collections/*/dataStores/*. +func (r *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesService) Import(parent string, googleclouddiscoveryenginev1importsuggestiondenylistentriesrequest *GoogleCloudDiscoveryengineV1ImportSuggestionDenyListEntriesRequest) *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall { + c := &ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent - c.googleclouddiscoveryenginev1sitemap = googleclouddiscoveryenginev1sitemap + c.googleclouddiscoveryenginev1importsuggestiondenylistentriesrequest = googleclouddiscoveryenginev1importsuggestiondenylistentriesrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1sitemap) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1importsuggestiondenylistentriesrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/sitemaps") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/suggestionDenyListEntries:import") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -43075,17 +45574,17 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCal googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.suggestionDenyListEntries.import", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.create" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.suggestionDenyListEntries.import" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -43115,80 +45614,83 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsCreateCal if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.suggestionDenyListEntries.import", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall struct { + s *Service + parent string + googleclouddiscoveryenginev1purgesuggestiondenylistentriesrequest *GoogleCloudDiscoveryengineV1PurgeSuggestionDenyListEntriesRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Delete: Deletes a Sitemap. +// Purge: Permanently deletes all SuggestionDenyListEntry for a DataStore. // -// - name: Full resource name of Sitemap, such as -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/siteSearchEngine/sitemaps/{sitemap}`. If the caller does -// not have permission to access the Sitemap, regardless of whether or not it -// exists, a PERMISSION_DENIED error is returned. If the requested Sitemap -// does not exist, a NOT_FOUND error is returned. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsService) Delete(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: The parent data store resource name for which to import denylist +// entries. Follows pattern +// projects/*/locations/*/collections/*/dataStores/*. +func (r *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesService) Purge(parent string, googleclouddiscoveryenginev1purgesuggestiondenylistentriesrequest *GoogleCloudDiscoveryengineV1PurgeSuggestionDenyListEntriesRequest) *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall { + c := &ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1purgesuggestiondenylistentriesrequest = googleclouddiscoveryenginev1purgesuggestiondenylistentriesrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) +func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1purgesuggestiondenylistentriesrequest) + if err != nil { + return nil, err + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/suggestionDenyListEntries:purge") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.suggestionDenyListEntries.purge", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.delete" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.suggestionDenyListEntries.purge" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -43218,11 +45720,11 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsDeleteCal if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.suggestionDenyListEntries.purge", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall struct { +type ProjectsLocationsCollectionsDataStoresUserEventsCollectCall struct { s *Service parent string urlParams_ gensupport.URLParams @@ -43231,27 +45733,51 @@ type ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall str header_ http.Header } -// Fetch: Fetch Sitemaps in a DataStore. +// Collect: Writes a single user event from the browser. This uses a GET +// request to due to browser restriction of POST-ing to a third-party domain. +// This method is used only by the Discovery Engine API JavaScript pixel and +// Google Tag Manager. Users should not call this method directly. // -// - parent: Parent resource name of the SiteSearchEngine, such as -// `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine`. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsService) Fetch(parent string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: The parent resource name. If the collect user event action is +// applied in DataStore level, the format is: +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}`. If the collect user event action is applied in Location +// level, for example, the event with Document across multiple DataStore, the +// format is: `projects/{project}/locations/{location}`. +func (r *ProjectsLocationsCollectionsDataStoresUserEventsService) Collect(parent string) *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall { + c := &ProjectsLocationsCollectionsDataStoresUserEventsCollectCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// MatcherUrisMatcherUris sets the optional parameter -// "matcher.urisMatcher.uris": The Sitemap uris. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall) MatcherUrisMatcherUris(matcherUrisMatcherUris ...string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall { - c.urlParams_.SetMulti("matcher.urisMatcher.uris", append([]string{}, matcherUrisMatcherUris...)) +// Ets sets the optional parameter "ets": The event timestamp in milliseconds. +// This prevents browser caching of otherwise identical get requests. The name +// is abbreviated to reduce the payload bytes. +func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) Ets(ets int64) *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall { + c.urlParams_.Set("ets", fmt.Sprint(ets)) + return c +} + +// Uri sets the optional parameter "uri": The URL including cgi-parameters but +// excluding the hash fragment with a length limit of 5,000 characters. This is +// often more useful than the referer URL, because many browsers only send the +// domain for third-party requests. +func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) Uri(uri string) *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall { + c.urlParams_.Set("uri", uri) + return c +} + +// UserEvent sets the optional parameter "userEvent": Required. URL encoded +// UserEvent proto with a length limit of 2,000,000 characters. +func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) UserEvent(userEvent string) *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall { + c.urlParams_.Set("userEvent", userEvent) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -43259,34 +45785,34 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/sitemaps:fetch") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/userEvents:collect") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -43296,124 +45822,17 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.fetch", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.fetch" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1FetchSitemapsResponse.ServerResponse.Header or -// (if a response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineSitemapsFetchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1FetchSitemapsResponse, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleCloudDiscoveryengineV1FetchSitemapsResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.sitemaps.fetch", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall struct { - s *Service - parent string - googleclouddiscoveryenginev1batchcreatetargetsitesrequest *GoogleCloudDiscoveryengineV1BatchCreateTargetSitesRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// BatchCreate: Creates TargetSite in a batch. -// -// - parent: The parent resource shared by all TargetSites being created. -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/siteSearchEngine`. The parent field in the -// CreateBookRequest messages must either be empty or match this field. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService) BatchCreate(parent string, googleclouddiscoveryenginev1batchcreatetargetsitesrequest *GoogleCloudDiscoveryengineV1BatchCreateTargetSitesRequest) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.googleclouddiscoveryenginev1batchcreatetargetsitesrequest = googleclouddiscoveryenginev1batchcreatetargetsitesrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1batchcreatetargetsitesrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/targetSites:batchCreate") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.batchCreate", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.userEvents.collect", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.batchCreate" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +// Do executes the "discoveryengine.projects.locations.collections.dataStores.userEvents.collect" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleApiHttpBody.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) Do(opts ...googleapi.CallOption) (*GoogleApiHttpBody, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -43432,7 +45851,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchC if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleApiHttpBody{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -43443,63 +45862,67 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesBatchC if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.batchCreate", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.userEvents.collect", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall struct { - s *Service - parent string - googleclouddiscoveryenginev1targetsite *GoogleCloudDiscoveryengineV1TargetSite - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresUserEventsImportCall struct { + s *Service + parent string + googleclouddiscoveryenginev1importusereventsrequest *GoogleCloudDiscoveryengineV1ImportUserEventsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Create: Creates a TargetSite. +// Import: Bulk import of user events. Request processing might be synchronous. +// Events that already exist are skipped. Use this method for backfilling +// historical user events. Operation.response is of type ImportResponse. Note +// that it is possible for a subset of the items to be successfully inserted. +// Operation.metadata is of type ImportMetadata. // -// - parent: Parent resource name of TargetSite, such as +// - parent: Parent DataStore resource name, of the form // `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/siteSearchEngine`. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService) Create(parent string, googleclouddiscoveryenginev1targetsite *GoogleCloudDiscoveryengineV1TargetSite) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// s/{data_store}`. +func (r *ProjectsLocationsCollectionsDataStoresUserEventsService) Import(parent string, googleclouddiscoveryenginev1importusereventsrequest *GoogleCloudDiscoveryengineV1ImportUserEventsRequest) *ProjectsLocationsCollectionsDataStoresUserEventsImportCall { + c := &ProjectsLocationsCollectionsDataStoresUserEventsImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent - c.googleclouddiscoveryenginev1targetsite = googleclouddiscoveryenginev1targetsite + c.googleclouddiscoveryenginev1importusereventsrequest = googleclouddiscoveryenginev1importusereventsrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsImportCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresUserEventsImportCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsImportCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresUserEventsImportCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsImportCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsImportCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1targetsite) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1importusereventsrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/targetSites") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/userEvents:import") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -43509,17 +45932,17 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreate googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.userEvents.import", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.create" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.userEvents.import" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsImportCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -43549,80 +45972,87 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesCreate if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.userEvents.import", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall struct { + s *Service + parent string + googleclouddiscoveryenginev1purgeusereventsrequest *GoogleCloudDiscoveryengineV1PurgeUserEventsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Delete: Deletes a TargetSite. +// Purge: Deletes permanently all user events specified by the filter provided. +// Depending on the number of events specified by the filter, this operation +// could take hours or days to complete. To test a filter, use the list command +// first. // -// - name: Full resource name of TargetSite, such as -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/siteSearchEngine/targetSites/{target_site}`. If the caller -// does not have permission to access the TargetSite, regardless of whether -// or not it exists, a PERMISSION_DENIED error is returned. If the requested -// TargetSite does not exist, a NOT_FOUND error is returned. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService) Delete(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: The resource name of the catalog under which the events are +// created. The format is +// `projects/{project}/locations/global/collections/{collection}/dataStores/{d +// ataStore}`. +func (r *ProjectsLocationsCollectionsDataStoresUserEventsService) Purge(parent string, googleclouddiscoveryenginev1purgeusereventsrequest *GoogleCloudDiscoveryengineV1PurgeUserEventsRequest) *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall { + c := &ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1purgeusereventsrequest = googleclouddiscoveryenginev1purgeusereventsrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) +func (c *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1purgeusereventsrequest) + if err != nil { + return nil, err + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/userEvents:purge") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.userEvents.purge", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.delete" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.userEvents.purge" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -43652,92 +46082,94 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesDelete if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.userEvents.purge", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresUserEventsWriteCall struct { + s *Service + parent string + googleclouddiscoveryenginev1userevent *GoogleCloudDiscoveryengineV1UserEvent + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Get: Gets a TargetSite. +// Write: Writes a single user event. // -// - name: Full resource name of TargetSite, such as +// - parent: The parent resource name. If the write user event action is +// applied in DataStore level, the format is: // `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/siteSearchEngine/targetSites/{target_site}`. If the caller -// does not have permission to access the TargetSite, regardless of whether -// or not it exists, a PERMISSION_DENIED error is returned. If the requested -// TargetSite does not exist, a NOT_FOUND error is returned. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService) Get(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// s/{data_store}`. If the write user event action is applied in Location +// level, for example, the event with Document across multiple DataStore, the +// format is: `projects/{project}/locations/{location}`. +func (r *ProjectsLocationsCollectionsDataStoresUserEventsService) Write(parent string, googleclouddiscoveryenginev1userevent *GoogleCloudDiscoveryengineV1UserEvent) *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall { + c := &ProjectsLocationsCollectionsDataStoresUserEventsWriteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1userevent = googleclouddiscoveryenginev1userevent + return c +} + +// WriteAsync sets the optional parameter "writeAsync": If set to true, the +// user event is written asynchronously after validation, and the API responds +// without waiting for the write. +func (c *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall) WriteAsync(writeAsync bool) *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall { + c.urlParams_.Set("writeAsync", fmt.Sprint(writeAsync)) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) +func (c *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1userevent) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/userEvents:write") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.userEvents.write", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.get" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.userEvents.write" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1TargetSite.ServerResponse.Header or (if a +// *GoogleCloudDiscoveryengineV1UserEvent.ServerResponse.Header or (if a // response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1TargetSite, error) { +func (c *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1UserEvent, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -43756,7 +46188,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCal if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1TargetSite{ + ret := &GoogleCloudDiscoveryengineV1UserEvent{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -43767,55 +46199,54 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesGetCal if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.userEvents.write", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall struct { +type ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall struct { s *Service - parent string + name string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// List: Gets a list of TargetSites. +// Get: Gets a WidgetConfig. // -// - parent: The parent site search engine resource name, such as -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/siteSearchEngine`. If the caller does not have permission -// to list TargetSites under this site search engine, regardless of whether -// or not this branch exists, a PERMISSION_DENIED error is returned. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService) List(parent string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent +// - name: Full WidgetConfig resource name. Format: +// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt +// ores/{data_store_id}/widgetConfigs/{widget_config_id}`. +func (r *ProjectsLocationsCollectionsDataStoresWidgetConfigsService) Get(name string) *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall { + c := &ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name return c } -// PageSize sets the optional parameter "pageSize": Requested page size. Server -// may return fewer items than requested. If unspecified, server will pick an -// appropriate default. The maximum value is 1000; values above 1000 will be -// coerced to 1000. If this field is negative, an INVALID_ARGUMENT error is -// returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) +// AcceptCache sets the optional parameter "acceptCache": Whether it's +// acceptable to load the widget config from cache. If set to true, recent +// changes on widget configs may take a few minutes to reflect on the end +// user's view. It's recommended to set to true for maturely developed widgets, +// as it improves widget performance. Set to false to see changes reflected in +// prod right away, if your widget is under development. +func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) AcceptCache(acceptCache bool) *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall { + c.urlParams_.Set("acceptCache", fmt.Sprint(acceptCache)) return c } -// PageToken sets the optional parameter "pageToken": A page token, received -// from a previous `ListTargetSites` call. Provide this to retrieve the -// subsequent page. When paginating, all other parameters provided to -// `ListTargetSites` must match the call that provided the page token. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall { - c.urlParams_.Set("pageToken", pageToken) +// GetWidgetConfigRequestOptionTurnOffCollectionComponents sets the optional +// parameter "getWidgetConfigRequestOption.turnOffCollectionComponents": +// Whether to turn off collection_components in WidgetConfig to reduce latency +// and data transmission. +func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) GetWidgetConfigRequestOptionTurnOffCollectionComponents(getWidgetConfigRequestOptionTurnOffCollectionComponents bool) *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall { + c.urlParams_.Set("getWidgetConfigRequestOption.turnOffCollectionComponents", fmt.Sprint(getWidgetConfigRequestOptionTurnOffCollectionComponents)) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall { +func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -43823,34 +46254,34 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCa // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall { +func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall { +func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/targetSites") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -43858,19 +46289,19 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCa } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.widgetConfigs.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.list" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.widgetConfigs.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ListTargetSitesResponse.ServerResponse.Header -// or (if a response was returned at all) in error.(*googleapi.Error).Header. -// Use googleapi.IsNotModified to check whether the returned error was because +// *GoogleCloudDiscoveryengineV1WidgetConfig.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListTargetSitesResponse, error) { +func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1WidgetConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -43889,7 +46320,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCa if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ListTargetSitesResponse{ + ret := &GoogleCloudDiscoveryengineV1WidgetConfig{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -43900,79 +46331,67 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCa if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.widgetConfigs.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListTargetSitesResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.PageToken(x.NextPageToken) - } -} - -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall struct { - s *Service - name string - googleclouddiscoveryenginev1targetsite *GoogleCloudDiscoveryengineV1TargetSite - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall struct { + s *Service + name string + googleclouddiscoveryenginev1widgetconfig *GoogleCloudDiscoveryengineV1WidgetConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Patch: Updates a TargetSite. +// Patch: Update a WidgetConfig. // -// - name: Output only. The fully qualified resource name of the target site. -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}/siteSearchEngine/targetSites/{target_site}` The -// `target_site_id` is system-generated. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService) Patch(name string, googleclouddiscoveryenginev1targetsite *GoogleCloudDiscoveryengineV1TargetSite) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Immutable. The full resource name of the widget config. Format: +// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt +// ores/{data_store_id}/widgetConfigs/{widget_config_id}`. This field must be +// a UTF-8 encoded string with a length limit of 1024 characters. +func (r *ProjectsLocationsCollectionsDataStoresWidgetConfigsService) Patch(name string, googleclouddiscoveryenginev1widgetconfig *GoogleCloudDiscoveryengineV1WidgetConfig) *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall { + c := &ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googleclouddiscoveryenginev1targetsite = googleclouddiscoveryenginev1targetsite + c.googleclouddiscoveryenginev1widgetconfig = googleclouddiscoveryenginev1widgetconfig + return c +} + +// UpdateMask sets the optional parameter "updateMask": Indicates which fields +// in the provided WidgetConfig to update. The following are the only supported +// fields: * WidgetConfig.enable_autocomplete If not set, all supported fields +// are updated. +func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall { + c.urlParams_.Set("updateMask", updateMask) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall { +func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall { +func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1targetsite) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1widgetconfig) if err != nil { return nil, err } @@ -43988,17 +46407,17 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchC googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.widgetConfigs.patch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.patch" call. +// Do executes the "discoveryengine.projects.locations.collections.dataStores.widgetConfigs.patch" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1WidgetConfig.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1WidgetConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -44017,7 +46436,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchC if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1WidgetConfig{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -44028,89 +46447,92 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesPatchC if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.patch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.widgetConfigs.patch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesCreateCall struct { + s *Service + parent string + googleclouddiscoveryenginev1engine *GoogleCloudDiscoveryengineV1Engine + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Get: 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. +// Create: Creates an Engine. // -// - name: The name of the operation resource. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: The parent resource name, such as +// `projects/{project}/locations/{location}/collections/{collection}`. +func (r *ProjectsLocationsCollectionsEnginesService) Create(parent string, googleclouddiscoveryenginev1engine *GoogleCloudDiscoveryengineV1Engine) *ProjectsLocationsCollectionsEnginesCreateCall { + c := &ProjectsLocationsCollectionsEnginesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1engine = googleclouddiscoveryenginev1engine + return c +} + +// EngineId sets the optional parameter "engineId": Required. The ID to use for +// the Engine, which will become the final component of the Engine's resource +// name. This field must conform to RFC-1034 +// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 +// characters. Otherwise, an INVALID_ARGUMENT error is returned. +func (c *ProjectsLocationsCollectionsEnginesCreateCall) EngineId(engineId string) *ProjectsLocationsCollectionsEnginesCreateCall { + c.urlParams_.Set("engineId", engineId) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall { +func (c *ProjectsLocationsCollectionsEnginesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall { +func (c *ProjectsLocationsCollectionsEnginesCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesCreateCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) +func (c *ProjectsLocationsCollectionsEnginesCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1engine) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/engines") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.get" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.create" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleLongrunningOperation.ServerResponse.Header or (if a response was // returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsEnginesCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -44140,103 +46562,62 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperat if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// List: Lists operations that match the specified filter in the request. If -// the server doesn't support this method, it returns `UNIMPLEMENTED`. +// Delete: Deletes an Engine. // -// - name: The name of the operation's parent resource. -func (r *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { - c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Full resource name of Engine, such as +// `projects/{project}/locations/{location}/collections/{collection_id}/engine +// s/{engine_id}`. If the caller does not have permission to delete the +// Engine, regardless of whether or not it exists, a PERMISSION_DENIED error +// is returned. If the Engine to delete does not exist, a NOT_FOUND error is +// returned. +func (r *ProjectsLocationsCollectionsEnginesService) Delete(name string) *ProjectsLocationsCollectionsEnginesDeleteCall { + c := &ProjectsLocationsCollectionsEnginesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } -// Filter sets the optional parameter "filter": The standard list filter. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// PageSize sets the optional parameter "pageSize": The standard list page -// size. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": The standard list page -// token. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { - c.urlParams_.Set("pageToken", pageToken) - return c -} - -// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": -// When set to `true`, operations that are reachable are returned as normal, -// and those that are unreachable are returned in the -// ListOperationsResponse.unreachable field. This can only be `true` when -// reading across collections. For example, when `parent` is set to -// "projects/example/locations/-". This field is not supported by default and -// will result in an `UNIMPLEMENTED` error if set unless explicitly documented -// otherwise in service or product specific documentation. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { - c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) - return c -} - // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { +func (c *ProjectsLocationsCollectionsEnginesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { +func (c *ProjectsLocationsCollectionsEnginesDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesDeleteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsEnginesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/operations") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } @@ -44244,17 +46625,17 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperat googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.list" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningListOperationsResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, error) { +func (c *ProjectsLocationsCollectionsEnginesDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -44273,7 +46654,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperat if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningListOperationsResponse{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -44284,104 +46665,89 @@ func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperat if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.PageToken(x.NextPageToken) - } -} - -type ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall struct { - s *Service - parent string - googleclouddiscoveryenginev1importsuggestiondenylistentriesrequest *GoogleCloudDiscoveryengineV1ImportSuggestionDenyListEntriesRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Import: Imports all SuggestionDenyListEntry for a DataStore. +// Get: Gets an Engine. // -// - parent: The parent data store resource name for which to import denylist -// entries. Follows pattern -// projects/*/locations/*/collections/*/dataStores/*. -func (r *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesService) Import(parent string, googleclouddiscoveryenginev1importsuggestiondenylistentriesrequest *GoogleCloudDiscoveryengineV1ImportSuggestionDenyListEntriesRequest) *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall { - c := &ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.googleclouddiscoveryenginev1importsuggestiondenylistentriesrequest = googleclouddiscoveryenginev1importsuggestiondenylistentriesrequest +// - name: Full resource name of Engine, such as +// `projects/{project}/locations/{location}/collections/{collection_id}/engine +// s/{engine_id}`. +func (r *ProjectsLocationsCollectionsEnginesService) Get(name string) *ProjectsLocationsCollectionsEnginesGetCall { + c := &ProjectsLocationsCollectionsEnginesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall { +func (c *ProjectsLocationsCollectionsEnginesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsEnginesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall { +func (c *ProjectsLocationsCollectionsEnginesGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1importsuggestiondenylistentriesrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsCollectionsEnginesGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/suggestionDenyListEntries:import") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.suggestionDenyListEntries.import", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.suggestionDenyListEntries.import" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1Engine.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsEnginesGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Engine, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -44400,7 +46766,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCa if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1Engine{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -44411,83 +46777,109 @@ func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesImportCa if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.suggestionDenyListEntries.import", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall struct { - s *Service - parent string - googleclouddiscoveryenginev1purgesuggestiondenylistentriesrequest *GoogleCloudDiscoveryengineV1PurgeSuggestionDenyListEntriesRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Purge: Permanently deletes all SuggestionDenyListEntry for a DataStore. +// GetIamPolicy: Gets the IAM access control policy for an Engine. A +// `NOT_FOUND` error is returned if the resource does not exist. An empty +// policy is returned if the resource exists but does not have a policy set on +// it. // -// - parent: The parent data store resource name for which to import denylist -// entries. Follows pattern -// projects/*/locations/*/collections/*/dataStores/*. -func (r *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesService) Purge(parent string, googleclouddiscoveryenginev1purgesuggestiondenylistentriesrequest *GoogleCloudDiscoveryengineV1PurgeSuggestionDenyListEntriesRequest) *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall { - c := &ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.googleclouddiscoveryenginev1purgesuggestiondenylistentriesrequest = googleclouddiscoveryenginev1purgesuggestiondenylistentriesrequest +// - resource: REQUIRED: The resource for which the policy is being requested. +// See Resource names (https://cloud.google.com/apis/design/resource_names) +// for the appropriate value for this field. +func (r *ProjectsLocationsCollectionsEnginesService) GetIamPolicy(resource string) *ProjectsLocationsCollectionsEnginesGetIamPolicyCall { + c := &ProjectsLocationsCollectionsEnginesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "options.requestedPolicyVersion": The maximum policy version that will be +// used to format the policy. Valid values are 0, 1, and 3. Requests specifying +// an invalid value will be rejected. Requests for policies with any +// conditional role bindings must specify version 3. Policies with no +// conditional role bindings may specify any valid value or leave the field +// unset. The policy in the response might use the policy version that you +// specified, or it might use a lower policy version. For example, if you +// specify version 3, but the policy has no conditional role bindings, the +// response uses version 1. To learn which resources support conditions in +// their IAM policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsCollectionsEnginesGetIamPolicyCall { + c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall { +func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesGetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall { +func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesGetIamPolicyCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1purgesuggestiondenylistentriesrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/suggestionDenyListEntries:purge") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "resource": c.resource, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.suggestionDenyListEntries.purge", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.suggestionDenyListEntries.purge" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.getIamPolicy" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -44506,7 +46898,7 @@ func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCal if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleIamV1Policy{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -44517,11 +46909,11 @@ func (c *ProjectsLocationsCollectionsDataStoresSuggestionDenyListEntriesPurgeCal if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.suggestionDenyListEntries.purge", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.getIamPolicy", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresUserEventsCollectCall struct { +type ProjectsLocationsCollectionsEnginesListCall struct { s *Service parent string urlParams_ gensupport.URLParams @@ -44530,51 +46922,39 @@ type ProjectsLocationsCollectionsDataStoresUserEventsCollectCall struct { header_ http.Header } -// Collect: Writes a single user event from the browser. This uses a GET -// request to due to browser restriction of POST-ing to a third-party domain. -// This method is used only by the Discovery Engine API JavaScript pixel and -// Google Tag Manager. Users should not call this method directly. +// List: Lists all the Engines associated with the project. // -// - parent: The parent resource name. If the collect user event action is -// applied in DataStore level, the format is: -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}`. If the collect user event action is applied in Location -// level, for example, the event with Document across multiple DataStore, the -// format is: `projects/{project}/locations/{location}`. -func (r *ProjectsLocationsCollectionsDataStoresUserEventsService) Collect(parent string) *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall { - c := &ProjectsLocationsCollectionsDataStoresUserEventsCollectCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: The parent resource name, such as +// `projects/{project}/locations/{location}/collections/{collection_id}`. +func (r *ProjectsLocationsCollectionsEnginesService) List(parent string) *ProjectsLocationsCollectionsEnginesListCall { + c := &ProjectsLocationsCollectionsEnginesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// Ets sets the optional parameter "ets": The event timestamp in milliseconds. -// This prevents browser caching of otherwise identical get requests. The name -// is abbreviated to reduce the payload bytes. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) Ets(ets int64) *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall { - c.urlParams_.Set("ets", fmt.Sprint(ets)) +// Filter sets the optional parameter "filter": Filter by solution type. For +// example: solution_type=SOLUTION_TYPE_SEARCH +func (c *ProjectsLocationsCollectionsEnginesListCall) Filter(filter string) *ProjectsLocationsCollectionsEnginesListCall { + c.urlParams_.Set("filter", filter) return c } -// Uri sets the optional parameter "uri": The URL including cgi-parameters but -// excluding the hash fragment with a length limit of 5,000 characters. This is -// often more useful than the referer URL, because many browsers only send the -// domain for third-party requests. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) Uri(uri string) *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall { - c.urlParams_.Set("uri", uri) +// PageSize sets the optional parameter "pageSize": Not supported. +func (c *ProjectsLocationsCollectionsEnginesListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsEnginesListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } -// UserEvent sets the optional parameter "userEvent": Required. URL encoded -// UserEvent proto with a length limit of 2,000,000 characters. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) UserEvent(userEvent string) *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall { - c.urlParams_.Set("userEvent", userEvent) +// PageToken sets the optional parameter "pageToken": Not supported. +func (c *ProjectsLocationsCollectionsEnginesListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsEnginesListCall { + c.urlParams_.Set("pageToken", pageToken) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall { +func (c *ProjectsLocationsCollectionsEnginesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -44582,34 +46962,34 @@ func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) Fields(s . // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall { +func (c *ProjectsLocationsCollectionsEnginesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall { +func (c *ProjectsLocationsCollectionsEnginesListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsEnginesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/userEvents:collect") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/engines") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -44619,17 +46999,17 @@ func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) doRequest( googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.userEvents.collect", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.userEvents.collect" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleApiHttpBody.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) Do(opts ...googleapi.CallOption) (*GoogleApiHttpBody, error) { +// *GoogleCloudDiscoveryengineV1ListEnginesResponse.ServerResponse.Header or +// (if a response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsEnginesListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListEnginesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -44648,7 +47028,7 @@ func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) Do(opts .. if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleApiHttpBody{ + ret := &GoogleCloudDiscoveryengineV1ListEnginesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -44659,87 +47039,115 @@ func (c *ProjectsLocationsCollectionsDataStoresUserEventsCollectCall) Do(opts .. if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.userEvents.collect", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresUserEventsImportCall struct { - s *Service - parent string - googleclouddiscoveryenginev1importusereventsrequest *GoogleCloudDiscoveryengineV1ImportUserEventsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsCollectionsEnginesListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListEnginesResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } } -// Import: Bulk import of user events. Request processing might be synchronous. -// Events that already exist are skipped. Use this method for backfilling -// historical user events. Operation.response is of type ImportResponse. Note -// that it is possible for a subset of the items to be successfully inserted. -// Operation.metadata is of type ImportMetadata. +type ProjectsLocationsCollectionsEnginesPatchCall struct { + s *Service + name string + googleclouddiscoveryenginev1engine *GoogleCloudDiscoveryengineV1Engine + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates an Engine // -// - parent: Parent DataStore resource name, of the form -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}`. -func (r *ProjectsLocationsCollectionsDataStoresUserEventsService) Import(parent string, googleclouddiscoveryenginev1importusereventsrequest *GoogleCloudDiscoveryengineV1ImportUserEventsRequest) *ProjectsLocationsCollectionsDataStoresUserEventsImportCall { - c := &ProjectsLocationsCollectionsDataStoresUserEventsImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.googleclouddiscoveryenginev1importusereventsrequest = googleclouddiscoveryenginev1importusereventsrequest +// - name: Immutable. Identifier. The fully qualified resource name of the +// engine. This field must be a UTF-8 encoded string with a length limit of +// 1024 characters. Format: +// `projects/{project}/locations/{location}/collections/{collection}/engines/{ +// engine}` engine should be 1-63 characters, and valid characters are +// /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned. +func (r *ProjectsLocationsCollectionsEnginesService) Patch(name string, googleclouddiscoveryenginev1engine *GoogleCloudDiscoveryengineV1Engine) *ProjectsLocationsCollectionsEnginesPatchCall { + c := &ProjectsLocationsCollectionsEnginesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleclouddiscoveryenginev1engine = googleclouddiscoveryenginev1engine + return c +} + +// UpdateMask sets the optional parameter "updateMask": Indicates which fields +// in the provided Engine to update. If an unsupported or unknown field is +// provided, an INVALID_ARGUMENT error is returned. +func (c *ProjectsLocationsCollectionsEnginesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsEnginesPatchCall { + c.urlParams_.Set("updateMask", updateMask) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsImportCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresUserEventsImportCall { +func (c *ProjectsLocationsCollectionsEnginesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsImportCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresUserEventsImportCall { +func (c *ProjectsLocationsCollectionsEnginesPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesPatchCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsImportCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresUserEventsImportCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsEnginesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1importusereventsrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1engine) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/userEvents:import") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.userEvents.import", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.patch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.userEvents.import" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.patch" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1Engine.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsImportCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsEnginesPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Engine, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -44758,7 +47166,7 @@ func (c *ProjectsLocationsCollectionsDataStoresUserEventsImportCall) Do(opts ... if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1Engine{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -44769,67 +47177,68 @@ func (c *ProjectsLocationsCollectionsDataStoresUserEventsImportCall) Do(opts ... if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.userEvents.import", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.patch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall struct { - s *Service - parent string - googleclouddiscoveryenginev1purgeusereventsrequest *GoogleCloudDiscoveryengineV1PurgeUserEventsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesSetIamPolicyCall struct { + s *Service + resource string + googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Purge: Deletes permanently all user events specified by the filter provided. -// Depending on the number of events specified by the filter, this operation -// could take hours or days to complete. To test a filter, use the list command -// first. +// SetIamPolicy: Sets the IAM access control policy for an Engine. A +// `NOT_FOUND` error is returned if the resource does not exist. **Important:** +// When setting a policy directly on an Engine resource, the only recommended +// roles in the bindings are: `roles/discoveryengine.user` and +// `roles/discoveryengine.agentspaceUser`. Attempting to grant any other role +// will result in a warning in logging. // -// - parent: The resource name of the catalog under which the events are -// created. The format is -// `projects/{project}/locations/global/collections/{collection}/dataStores/{d -// ataStore}`. -func (r *ProjectsLocationsCollectionsDataStoresUserEventsService) Purge(parent string, googleclouddiscoveryenginev1purgeusereventsrequest *GoogleCloudDiscoveryengineV1PurgeUserEventsRequest) *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall { - c := &ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.googleclouddiscoveryenginev1purgeusereventsrequest = googleclouddiscoveryenginev1purgeusereventsrequest +// - resource: REQUIRED: The resource for which the policy is being specified. +// See Resource names (https://cloud.google.com/apis/design/resource_names) +// for the appropriate value for this field. +func (r *ProjectsLocationsCollectionsEnginesService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsCollectionsEnginesSetIamPolicyCall { + c := &ProjectsLocationsCollectionsEnginesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall { +func (c *ProjectsLocationsCollectionsEnginesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesSetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall { +func (c *ProjectsLocationsCollectionsEnginesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesSetIamPolicyCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesSetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsEnginesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1purgeusereventsrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1setiampolicyrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/userEvents:purge") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -44837,19 +47246,19 @@ func (c *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall) doRequest(al } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "resource": c.resource, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.userEvents.purge", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.userEvents.purge" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.setIamPolicy" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsCollectionsEnginesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -44868,7 +47277,7 @@ func (c *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall) Do(opts ...g if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleIamV1Policy{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -44879,74 +47288,72 @@ func (c *ProjectsLocationsCollectionsDataStoresUserEventsPurgeCall) Do(opts ...g if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.userEvents.purge", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.setIamPolicy", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresUserEventsWriteCall struct { +type ProjectsLocationsCollectionsEnginesAssistantsCreateCall struct { s *Service parent string - googleclouddiscoveryenginev1userevent *GoogleCloudDiscoveryengineV1UserEvent + googleclouddiscoveryenginev1assistant *GoogleCloudDiscoveryengineV1Assistant urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } -// Write: Writes a single user event. +// Create: Creates an Assistant. // -// - parent: The parent resource name. If the write user event action is -// applied in DataStore level, the format is: -// `projects/{project}/locations/{location}/collections/{collection}/dataStore -// s/{data_store}`. If the write user event action is applied in Location -// level, for example, the event with Document across multiple DataStore, the -// format is: `projects/{project}/locations/{location}`. -func (r *ProjectsLocationsCollectionsDataStoresUserEventsService) Write(parent string, googleclouddiscoveryenginev1userevent *GoogleCloudDiscoveryengineV1UserEvent) *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall { - c := &ProjectsLocationsCollectionsDataStoresUserEventsWriteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: The parent resource name. Format: +// `projects/{project}/locations/{location}/collections/{collection}/engines/{ +// engine}`. +func (r *ProjectsLocationsCollectionsEnginesAssistantsService) Create(parent string, googleclouddiscoveryenginev1assistant *GoogleCloudDiscoveryengineV1Assistant) *ProjectsLocationsCollectionsEnginesAssistantsCreateCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent - c.googleclouddiscoveryenginev1userevent = googleclouddiscoveryenginev1userevent + c.googleclouddiscoveryenginev1assistant = googleclouddiscoveryenginev1assistant return c } -// WriteAsync sets the optional parameter "writeAsync": If set to true, the -// user event is written asynchronously after validation, and the API responds -// without waiting for the write. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall) WriteAsync(writeAsync bool) *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall { - c.urlParams_.Set("writeAsync", fmt.Sprint(writeAsync)) +// AssistantId sets the optional parameter "assistantId": Required. The ID to +// use for the Assistant, which will become the final component of the +// Assistant's resource name. This field must conform to RFC-1034 +// (https://tools.ietf.org/html/rfc1034) with a length limit of 63 characters. +func (c *ProjectsLocationsCollectionsEnginesAssistantsCreateCall) AssistantId(assistantId string) *ProjectsLocationsCollectionsEnginesAssistantsCreateCall { + c.urlParams_.Set("assistantId", assistantId) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsCreateCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1userevent) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1assistant) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/userEvents:write") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/assistants") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -44956,17 +47363,17 @@ func (c *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall) doRequest(al googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.userEvents.write", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.userEvents.write" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.create" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1UserEvent.ServerResponse.Header or (if a +// *GoogleCloudDiscoveryengineV1Assistant.ServerResponse.Header or (if a // response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1UserEvent, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Assistant, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -44985,7 +47392,7 @@ func (c *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall) Do(opts ...g if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1UserEvent{ + ret := &GoogleCloudDiscoveryengineV1Assistant{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -44996,91 +47403,62 @@ func (c *ProjectsLocationsCollectionsDataStoresUserEventsWriteCall) Do(opts ...g if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.userEvents.write", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesAssistantsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Get: Gets a WidgetConfig. +// Delete: Deletes an Assistant. // -// - name: Full WidgetConfig resource name. Format: -// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt -// ores/{data_store_id}/widgetConfigs/{widget_config_id}`. -func (r *ProjectsLocationsCollectionsDataStoresWidgetConfigsService) Get(name string) *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall { - c := &ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Resource name of Assistant. Format: +// `projects/{project}/locations/{location}/collections/{collection}/engines/{ +// engine}/assistants/{assistant}` If the caller does not have permission to +// delete the Assistant, regardless of whether or not it exists, a +// PERMISSION_DENIED error is returned. If the Assistant to delete does not +// exist, a NOT_FOUND error is returned. +func (r *ProjectsLocationsCollectionsEnginesAssistantsService) Delete(name string) *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } -// AcceptCache sets the optional parameter "acceptCache": Whether it's -// acceptable to load the widget config from cache. If set to true, recent -// changes on widget configs may take a few minutes to reflect on the end -// user's view. It's recommended to set to true for maturely developed widgets, -// as it improves widget performance. Set to false to see changes reflected in -// prod right away, if your widget is under development. -func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) AcceptCache(acceptCache bool) *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall { - c.urlParams_.Set("acceptCache", fmt.Sprint(acceptCache)) - return c -} - -// GetWidgetConfigRequestOptionTurnOffCollectionComponents sets the optional -// parameter "getWidgetConfigRequestOption.turnOffCollectionComponents": -// Whether to turn off collection_components in WidgetConfig to reduce latency -// and data transmission. -func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) GetWidgetConfigRequestOptionTurnOffCollectionComponents(getWidgetConfigRequestOptionTurnOffCollectionComponents bool) *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall { - c.urlParams_.Set("getWidgetConfigRequestOption.turnOffCollectionComponents", fmt.Sprint(getWidgetConfigRequestOptionTurnOffCollectionComponents)) - return c -} - // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } @@ -45088,17 +47466,17 @@ func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) doRequest(a googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.widgetConfigs.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.widgetConfigs.get" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1WidgetConfig.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1WidgetConfig, error) { +// *GoogleProtobufEmpty.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -45117,7 +47495,7 @@ func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) Do(opts ... if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1WidgetConfig{ + ret := &GoogleProtobufEmpty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -45128,75 +47506,71 @@ func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsGetCall) Do(opts ... if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.widgetConfigs.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall struct { - s *Service - name string - googleclouddiscoveryenginev1widgetconfig *GoogleCloudDiscoveryengineV1WidgetConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesAssistantsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Patch: Update a WidgetConfig. +// Get: Gets an Assistant. // -// - name: Immutable. The full resource name of the widget config. Format: -// `projects/{project}/locations/{location}/collections/{collection_id}/dataSt -// ores/{data_store_id}/widgetConfigs/{widget_config_id}`. This field must be -// a UTF-8 encoded string with a length limit of 1024 characters. -func (r *ProjectsLocationsCollectionsDataStoresWidgetConfigsService) Patch(name string, googleclouddiscoveryenginev1widgetconfig *GoogleCloudDiscoveryengineV1WidgetConfig) *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall { - c := &ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Resource name of Assistant. Format: +// `projects/{project}/locations/{location}/collections/{collection}/engines/{ +// engine}/assistants/{assistant}`. +func (r *ProjectsLocationsCollectionsEnginesAssistantsService) Get(name string) *ProjectsLocationsCollectionsEnginesAssistantsGetCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googleclouddiscoveryenginev1widgetconfig = googleclouddiscoveryenginev1widgetconfig - return c -} - -// UpdateMask sets the optional parameter "updateMask": Indicates which fields -// in the provided WidgetConfig to update. The following are the only supported -// fields: * WidgetConfig.enable_autocomplete If not set, all supported fields -// are updated. -func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall { - c.urlParams_.Set("updateMask", updateMask) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsEnginesAssistantsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesAssistantsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1widgetconfig) - if err != nil { - return nil, err +func (c *ProjectsLocationsCollectionsEnginesAssistantsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -45204,17 +47578,17 @@ func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall) doRequest googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.widgetConfigs.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.widgetConfigs.patch" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1WidgetConfig.ServerResponse.Header or (if a +// *GoogleCloudDiscoveryengineV1Assistant.ServerResponse.Header or (if a // response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1WidgetConfig, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Assistant, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -45233,7 +47607,7 @@ func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall) Do(opts . if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1WidgetConfig{ + ret := &GoogleCloudDiscoveryengineV1Assistant{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -45244,74 +47618,89 @@ func (c *ProjectsLocationsCollectionsDataStoresWidgetConfigsPatchCall) Do(opts . if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.dataStores.widgetConfigs.patch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsEnginesCreateCall struct { - s *Service - parent string - googleclouddiscoveryenginev1engine *GoogleCloudDiscoveryengineV1Engine - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesAssistantsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Create: Creates an Engine. +// List: Lists all Assistants under an Engine. // -// - parent: The parent resource name, such as -// `projects/{project}/locations/{location}/collections/{collection}`. -func (r *ProjectsLocationsCollectionsEnginesService) Create(parent string, googleclouddiscoveryenginev1engine *GoogleCloudDiscoveryengineV1Engine) *ProjectsLocationsCollectionsEnginesCreateCall { - c := &ProjectsLocationsCollectionsEnginesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: The parent resource name. Format: +// `projects/{project}/locations/{location}/collections/{collection}/engines/{ +// engine}`. +func (r *ProjectsLocationsCollectionsEnginesAssistantsService) List(parent string) *ProjectsLocationsCollectionsEnginesAssistantsListCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent - c.googleclouddiscoveryenginev1engine = googleclouddiscoveryenginev1engine return c } -// EngineId sets the optional parameter "engineId": Required. The ID to use for -// the Engine, which will become the final component of the Engine's resource -// name. This field must conform to RFC-1034 -// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 -// characters. Otherwise, an INVALID_ARGUMENT error is returned. -func (c *ProjectsLocationsCollectionsEnginesCreateCall) EngineId(engineId string) *ProjectsLocationsCollectionsEnginesCreateCall { - c.urlParams_.Set("engineId", engineId) +// PageSize sets the optional parameter "pageSize": Maximum number of +// Assistants to return. If unspecified, defaults to 100. The maximum allowed +// value is 1000; anything above that will be coerced down to 1000. +func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsEnginesAssistantsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token +// ListAssistantsResponse.next_page_token, received from a previous +// AssistantService.ListAssistants call. Provide this to retrieve the +// subsequent page. When paginating, all other parameters provided to +// ListAssistants must match the call that provided the page token. +func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsEnginesAssistantsListCall { + c.urlParams_.Set("pageToken", pageToken) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsEnginesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesCreateCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesAssistantsListCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsEnginesCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesCreateCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsEnginesCreateCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsEnginesCreateCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1engine) - if err != nil { - return nil, err +func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/engines") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/assistants") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -45319,17 +47708,17 @@ func (c *ProjectsLocationsCollectionsEnginesCreateCall) doRequest(alt string) (* googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.engines.create" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1ListAssistantsResponse.ServerResponse.Header or +// (if a response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsEnginesCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListAssistantsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -45348,7 +47737,7 @@ func (c *ProjectsLocationsCollectionsEnginesCreateCall) Do(opts ...googleapi.Cal if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1ListAssistantsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -45359,62 +47748,94 @@ func (c *ProjectsLocationsCollectionsEnginesCreateCall) Do(opts ...googleapi.Cal if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsEnginesDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListAssistantsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } } -// Delete: Deletes an Engine. +type ProjectsLocationsCollectionsEnginesAssistantsPatchCall struct { + s *Service + name string + googleclouddiscoveryenginev1assistant *GoogleCloudDiscoveryengineV1Assistant + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates an Assistant // -// - name: Full resource name of Engine, such as -// `projects/{project}/locations/{location}/collections/{collection_id}/engine -// s/{engine_id}`. If the caller does not have permission to delete the -// Engine, regardless of whether or not it exists, a PERMISSION_DENIED error -// is returned. If the Engine to delete does not exist, a NOT_FOUND error is -// returned. -func (r *ProjectsLocationsCollectionsEnginesService) Delete(name string) *ProjectsLocationsCollectionsEnginesDeleteCall { - c := &ProjectsLocationsCollectionsEnginesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Immutable. Resource name of the assistant. Format: +// `projects/{project}/locations/{location}/collections/{collection}/engines/{ +// engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a +// length limit of 1024 characters. +func (r *ProjectsLocationsCollectionsEnginesAssistantsService) Patch(name string, googleclouddiscoveryenginev1assistant *GoogleCloudDiscoveryengineV1Assistant) *ProjectsLocationsCollectionsEnginesAssistantsPatchCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name + c.googleclouddiscoveryenginev1assistant = googleclouddiscoveryenginev1assistant + return c +} + +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. +func (c *ProjectsLocationsCollectionsEnginesAssistantsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsEnginesAssistantsPatchCall { + c.urlParams_.Set("updateMask", updateMask) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsEnginesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesDeleteCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsEnginesDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesDeleteCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsPatchCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsEnginesDeleteCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsEnginesDeleteCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) +func (c *ProjectsLocationsCollectionsEnginesAssistantsPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1assistant) + if err != nil { + return nil, err + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) + req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } @@ -45422,17 +47843,17 @@ func (c *ProjectsLocationsCollectionsEnginesDeleteCall) doRequest(alt string) (* googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.patch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.engines.delete" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.patch" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1Assistant.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsEnginesDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Assistant, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -45451,7 +47872,7 @@ func (c *ProjectsLocationsCollectionsEnginesDeleteCall) Do(opts ...googleapi.Cal if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1Assistant{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -45462,71 +47883,65 @@ func (c *ProjectsLocationsCollectionsEnginesDeleteCall) Do(opts ...googleapi.Cal if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.patch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsEnginesGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall struct { + s *Service + name string + googleclouddiscoveryenginev1streamassistrequest *GoogleCloudDiscoveryengineV1StreamAssistRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Get: Gets an Engine. +// StreamAssist: Assists the user with a query in a streaming fashion. // -// - name: Full resource name of Engine, such as -// `projects/{project}/locations/{location}/collections/{collection_id}/engine -// s/{engine_id}`. -func (r *ProjectsLocationsCollectionsEnginesService) Get(name string) *ProjectsLocationsCollectionsEnginesGetCall { - c := &ProjectsLocationsCollectionsEnginesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The resource name of the Assistant. Format: +// `projects/{project}/locations/{location}/collections/{collection}/engines/{ +// engine}/assistants/{assistant}`. +func (r *ProjectsLocationsCollectionsEnginesAssistantsService) StreamAssist(name string, googleclouddiscoveryenginev1streamassistrequest *GoogleCloudDiscoveryengineV1StreamAssistRequest) *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name + c.googleclouddiscoveryenginev1streamassistrequest = googleclouddiscoveryenginev1streamassistrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsEnginesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesGetCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsEnginesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesGetCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsEnginesGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesGetCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsEnginesGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsEnginesGetCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) +func (c *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1streamassistrequest) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:streamAssist") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } @@ -45534,17 +47949,17 @@ func (c *ProjectsLocationsCollectionsEnginesGetCall) doRequest(alt string) (*htt googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.streamAssist", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.engines.get" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.streamAssist" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Engine.ServerResponse.Header or (if a response -// was returned at all) in error.(*googleapi.Error).Header. Use +// *GoogleCloudDiscoveryengineV1StreamAssistResponse.ServerResponse.Header or +// (if a response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsEnginesGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Engine, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1StreamAssistResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -45563,7 +47978,7 @@ func (c *ProjectsLocationsCollectionsEnginesGetCall) Do(opts ...googleapi.CallOp if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Engine{ + ret := &GoogleCloudDiscoveryengineV1StreamAssistResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -45574,54 +47989,33 @@ func (c *ProjectsLocationsCollectionsEnginesGetCall) Do(opts ...googleapi.CallOp if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.streamAssist", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsEnginesGetIamPolicyCall struct { +type ProjectsLocationsCollectionsEnginesAssistantsAgentsGetCardCall struct { s *Service - resource string + tenant string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// GetIamPolicy: Gets the IAM access control policy for an Engine. A -// `NOT_FOUND` error is returned if the resource does not exist. An empty -// policy is returned if the resource exists but does not have a policy set on -// it. +// GetCard: GetAgentCard returns the agent card for the agent. // -// - resource: REQUIRED: The resource for which the policy is being requested. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *ProjectsLocationsCollectionsEnginesService) GetIamPolicy(resource string) *ProjectsLocationsCollectionsEnginesGetIamPolicyCall { - c := &ProjectsLocationsCollectionsEnginesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - return c -} - -// OptionsRequestedPolicyVersion sets the optional parameter -// "options.requestedPolicyVersion": The maximum policy version that will be -// used to format the policy. Valid values are 0, 1, and 3. Requests specifying -// an invalid value will be rejected. Requests for policies with any -// conditional role bindings must specify version 3. Policies with no -// conditional role bindings may specify any valid value or leave the field -// unset. The policy in the response might use the policy version that you -// specified, or it might use a lower policy version. For example, if you -// specify version 3, but the policy has no conditional role bindings, the -// response uses version 1. To learn which resources support conditions in -// their IAM policies, see the IAM documentation -// (https://cloud.google.com/iam/help/conditions/resource-policies). -func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsCollectionsEnginesGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) +// - tenant: Optional tenant, provided as a path parameter. Experimental, might +// still change for 1.0 release. +func (r *ProjectsLocationsCollectionsEnginesAssistantsAgentsService) GetCard(tenant string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsGetCardCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsAgentsGetCardCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.tenant = tenant return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesGetIamPolicyCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsGetCardCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsAgentsGetCardCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -45629,34 +48023,34 @@ func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) Fields(s ...google // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesGetIamPolicyCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsGetCardCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsGetCardCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesGetIamPolicyCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsGetCardCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsAgentsGetCardCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsGetCardCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsGetCardCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "{+tenant}/card") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -45664,19 +48058,18 @@ func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) doRequest(alt stri } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "tenant": c.tenant, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.getCard", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.engines.getIamPolicy" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.agents.getCard" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +// *A2aV1AgentCard.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsGetCardCall) Do(opts ...googleapi.CallOption) (*A2aV1AgentCard, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -45695,7 +48088,7 @@ func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) Do(opts ...googlea if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleIamV1Policy{ + ret := &A2aV1AgentCard{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -45706,107 +48099,83 @@ func (c *ProjectsLocationsCollectionsEnginesGetIamPolicyCall) Do(opts ...googlea if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.getIamPolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.getCard", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsEnginesListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageSendCall struct { + s *Service + tenant string + a2av1sendmessagerequest *A2aV1SendMessageRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// List: Lists all the Engines associated with the project. +// Send: Send a message to the agent. This is a blocking call that will return +// the task once it is completed, or a LRO if requested. // -// - parent: The parent resource name, such as -// `projects/{project}/locations/{location}/collections/{collection_id}`. -func (r *ProjectsLocationsCollectionsEnginesService) List(parent string) *ProjectsLocationsCollectionsEnginesListCall { - c := &ProjectsLocationsCollectionsEnginesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// Filter sets the optional parameter "filter": Filter by solution type. For -// example: solution_type=SOLUTION_TYPE_SEARCH -func (c *ProjectsLocationsCollectionsEnginesListCall) Filter(filter string) *ProjectsLocationsCollectionsEnginesListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// PageSize sets the optional parameter "pageSize": Not supported. -func (c *ProjectsLocationsCollectionsEnginesListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsEnginesListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": Not supported. -func (c *ProjectsLocationsCollectionsEnginesListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsEnginesListCall { - c.urlParams_.Set("pageToken", pageToken) +// - tenant: Optional tenant, provided as a path parameter. Experimental, might +// still change for 1.0 release. +func (r *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageService) Send(tenant string, a2av1sendmessagerequest *A2aV1SendMessageRequest) *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageSendCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageSendCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.tenant = tenant + c.a2av1sendmessagerequest = a2av1sendmessagerequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsEnginesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesListCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageSendCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageSendCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsEnginesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesListCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsEnginesListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesListCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageSendCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageSendCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsEnginesListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageSendCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsEnginesListCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageSendCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.a2av1sendmessagerequest) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/engines") + urls := googleapi.ResolveRelative(c.s.BasePath, "{+tenant}/message:send") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "tenant": c.tenant, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.message.send", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.engines.list" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.agents.message.send" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ListEnginesResponse.ServerResponse.Header or -// (if a response was returned at all) in error.(*googleapi.Error).Header. Use +// *A2aV1SendMessageResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsEnginesListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListEnginesResponse, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageSendCall) Do(opts ...googleapi.CallOption) (*A2aV1SendMessageResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -45825,7 +48194,7 @@ func (c *ProjectsLocationsCollectionsEnginesListCall) Do(opts ...googleapi.CallO if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ListEnginesResponse{ + ret := &A2aV1SendMessageResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -45836,115 +48205,83 @@ func (c *ProjectsLocationsCollectionsEnginesListCall) Do(opts ...googleapi.CallO if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.message.send", "response", internallog.HTTPResponse(res, b)) return ret, nil } -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsEnginesListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListEnginesResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.PageToken(x.NextPageToken) - } -} - -type ProjectsLocationsCollectionsEnginesPatchCall struct { - s *Service - name string - googleclouddiscoveryenginev1engine *GoogleCloudDiscoveryengineV1Engine - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageStreamCall struct { + s *Service + tenant string + a2av1sendmessagerequest *A2aV1SendMessageRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Patch: Updates an Engine +// Stream: SendStreamingMessage is a streaming call that will return a stream +// of task update events until the Task is in an interrupted or terminal state. // -// - name: Immutable. Identifier. The fully qualified resource name of the -// engine. This field must be a UTF-8 encoded string with a length limit of -// 1024 characters. Format: -// `projects/{project}/locations/{location}/collections/{collection}/engines/{ -// engine}` engine should be 1-63 characters, and valid characters are -// /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned. -func (r *ProjectsLocationsCollectionsEnginesService) Patch(name string, googleclouddiscoveryenginev1engine *GoogleCloudDiscoveryengineV1Engine) *ProjectsLocationsCollectionsEnginesPatchCall { - c := &ProjectsLocationsCollectionsEnginesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.googleclouddiscoveryenginev1engine = googleclouddiscoveryenginev1engine - return c -} - -// UpdateMask sets the optional parameter "updateMask": Indicates which fields -// in the provided Engine to update. If an unsupported or unknown field is -// provided, an INVALID_ARGUMENT error is returned. -func (c *ProjectsLocationsCollectionsEnginesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsEnginesPatchCall { - c.urlParams_.Set("updateMask", updateMask) +// - tenant: Optional tenant, provided as a path parameter. Experimental, might +// still change for 1.0 release. +func (r *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageService) Stream(tenant string, a2av1sendmessagerequest *A2aV1SendMessageRequest) *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageStreamCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageStreamCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.tenant = tenant + c.a2av1sendmessagerequest = a2av1sendmessagerequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsEnginesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesPatchCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageStreamCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageStreamCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsEnginesPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesPatchCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageStreamCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageStreamCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsEnginesPatchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageStreamCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsEnginesPatchCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageStreamCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1engine) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.a2av1sendmessagerequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "{+tenant}/message:stream") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "tenant": c.tenant, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.message.stream", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.engines.patch" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.agents.message.stream" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Engine.ServerResponse.Header or (if a response -// was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsEnginesPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Engine, error) { +// *A2aV1StreamResponse.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsMessageStreamCall) Do(opts ...googleapi.CallOption) (*A2aV1StreamResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -45963,7 +48300,7 @@ func (c *ProjectsLocationsCollectionsEnginesPatchCall) Do(opts ...googleapi.Call if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Engine{ + ret := &A2aV1StreamResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -45974,88 +48311,89 @@ func (c *ProjectsLocationsCollectionsEnginesPatchCall) Do(opts ...googleapi.Call if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.patch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.message.stream", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsEnginesSetIamPolicyCall struct { - s *Service - resource string - googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// SetIamPolicy: Sets the IAM access control policy for an Engine. A -// `NOT_FOUND` error is returned if the resource does not exist. **Important:** -// When setting a policy directly on an Engine resource, the only recommended -// roles in the bindings are: `roles/discoveryengine.user` and -// `roles/discoveryengine.agentspaceUser`. Attempting to grant any other role -// will result in a warning in logging. +// Get: 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. // -// - resource: REQUIRED: The resource for which the policy is being specified. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *ProjectsLocationsCollectionsEnginesService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsCollectionsEnginesSetIamPolicyCall { - c := &ProjectsLocationsCollectionsEnginesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest +// - name: The name of the operation resource. +func (r *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsService) Get(name string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsEnginesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesSetIamPolicyCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsEnginesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesSetIamPolicyCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsEnginesSetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsEnginesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleiamv1setiampolicyrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.operations.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.engines.setIamPolicy" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.agents.operations.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ProjectsLocationsCollectionsEnginesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -46074,7 +48412,7 @@ func (c *ProjectsLocationsCollectionsEnginesSetIamPolicyCall) Do(opts ...googlea if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleIamV1Policy{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -46085,72 +48423,66 @@ func (c *ProjectsLocationsCollectionsEnginesSetIamPolicyCall) Do(opts ...googlea if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.setIamPolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.operations.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsEnginesAssistantsCreateCall struct { - s *Service - parent string - googleclouddiscoveryenginev1assistant *GoogleCloudDiscoveryengineV1Assistant - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksCancelCall struct { + s *Service + tenant string + name string + a2av1canceltaskrequest *A2aV1CancelTaskRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Create: Creates an Assistant. +// Cancel: Cancel a task from the agent. If supported one should expect no more +// task updates for the task. // -// - parent: The parent resource name. Format: -// `projects/{project}/locations/{location}/collections/{collection}/engines/{ -// engine}`. -func (r *ProjectsLocationsCollectionsEnginesAssistantsService) Create(parent string, googleclouddiscoveryenginev1assistant *GoogleCloudDiscoveryengineV1Assistant) *ProjectsLocationsCollectionsEnginesAssistantsCreateCall { - c := &ProjectsLocationsCollectionsEnginesAssistantsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.googleclouddiscoveryenginev1assistant = googleclouddiscoveryenginev1assistant - return c -} - -// AssistantId sets the optional parameter "assistantId": Required. The ID to -// use for the Assistant, which will become the final component of the -// Assistant's resource name. This field must conform to RFC-1034 -// (https://tools.ietf.org/html/rfc1034) with a length limit of 63 characters. -func (c *ProjectsLocationsCollectionsEnginesAssistantsCreateCall) AssistantId(assistantId string) *ProjectsLocationsCollectionsEnginesAssistantsCreateCall { - c.urlParams_.Set("assistantId", assistantId) +// - name: The resource name of the task to cancel. Format: tasks/{task_id}. +// - tenant: Optional tenant, provided as a path parameter. Experimental, might +// still change for 1.0 release. +func (r *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksService) Cancel(tenant string, name string, a2av1canceltaskrequest *A2aV1CancelTaskRequest) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksCancelCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.tenant = tenant + c.name = name + c.a2av1canceltaskrequest = a2av1canceltaskrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsEnginesAssistantsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsCreateCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksCancelCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsEnginesAssistantsCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsCreateCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksCancelCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksCancelCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsEnginesAssistantsCreateCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksCancelCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsEnginesAssistantsCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1assistant) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.a2av1canceltaskrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/assistants") + urls := googleapi.ResolveRelative(c.s.BasePath, "{+tenant}/{+name}:cancel") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -46158,19 +48490,19 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsCreateCall) doRequest(alt } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "tenant": c.tenant, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.cancel", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.create" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.cancel" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Assistant.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsEnginesAssistantsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Assistant, error) { +// *A2aV1Task.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksCancelCall) Do(opts ...googleapi.CallOption) (*A2aV1Task, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -46189,7 +48521,7 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsCreateCall) Do(opts ...goo if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Assistant{ + ret := &A2aV1Task{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -46200,80 +48532,98 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsCreateCall) Do(opts ...goo if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.cancel", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsEnginesAssistantsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksGetCall struct { + s *Service + tenant string + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Delete: Deletes an Assistant. +// Get: Get the current state of a task from the agent. // -// - name: Resource name of Assistant. Format: -// `projects/{project}/locations/{location}/collections/{collection}/engines/{ -// engine}/assistants/{assistant}` If the caller does not have permission to -// delete the Assistant, regardless of whether or not it exists, a -// PERMISSION_DENIED error is returned. If the Assistant to delete does not -// exist, a NOT_FOUND error is returned. -func (r *ProjectsLocationsCollectionsEnginesAssistantsService) Delete(name string) *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall { - c := &ProjectsLocationsCollectionsEnginesAssistantsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The resource name of the task. Format: tasks/{task_id}. +// - tenant: Optional tenant, provided as a path parameter. Experimental, might +// still change for 1.0 release. +func (r *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksService) Get(tenant string, name string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksGetCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.tenant = tenant c.name = name return c } +// HistoryLength sets the optional parameter "historyLength": The number of +// most recent messages from the task's history to retrieve. +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksGetCall) HistoryLength(historyLength int64) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksGetCall { + c.urlParams_.Set("historyLength", fmt.Sprint(historyLength)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "{+tenant}/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "tenant": c.tenant, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.delete" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleProtobufEmpty.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { +// *A2aV1Task.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksGetCall) Do(opts ...googleapi.CallOption) (*A2aV1Task, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -46292,7 +48642,7 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall) Do(opts ...goo if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleProtobufEmpty{ + ret := &A2aV1Task{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -46303,12 +48653,13 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsDeleteCall) Do(opts ...goo if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsEnginesAssistantsGetCall struct { +type ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksSubscribeCall struct { s *Service + tenant string name string urlParams_ gensupport.URLParams ifNoneMatch_ string @@ -46316,13 +48667,18 @@ type ProjectsLocationsCollectionsEnginesAssistantsGetCall struct { header_ http.Header } -// Get: Gets an Assistant. +// Subscribe: TaskSubscription is a streaming call that will return a stream of +// task update events. This attaches the stream to an existing in process task. +// If the task is complete the stream will return the completed task (like +// GetTask) and close the stream. // -// - name: Resource name of Assistant. Format: -// `projects/{project}/locations/{location}/collections/{collection}/engines/{ -// engine}/assistants/{assistant}`. -func (r *ProjectsLocationsCollectionsEnginesAssistantsService) Get(name string) *ProjectsLocationsCollectionsEnginesAssistantsGetCall { - c := &ProjectsLocationsCollectionsEnginesAssistantsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The resource name of the task to subscribe to. Format: +// tasks/{task_id}. +// - tenant: Optional tenant, provided as a path parameter. Experimental, might +// still change for 1.0 release. +func (r *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksService) Subscribe(tenant string, name string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksSubscribeCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksSubscribeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.tenant = tenant c.name = name return c } @@ -46330,7 +48686,7 @@ func (r *ProjectsLocationsCollectionsEnginesAssistantsService) Get(name string) // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsEnginesAssistantsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsGetCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksSubscribeCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksSubscribeCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -46338,34 +48694,34 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsGetCall) Fields(s ...googl // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsEnginesAssistantsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesAssistantsGetCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksSubscribeCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksSubscribeCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsEnginesAssistantsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsGetCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksSubscribeCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksSubscribeCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsEnginesAssistantsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksSubscribeCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsEnginesAssistantsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksSubscribeCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "{+tenant}/{+name}:subscribe") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -46373,19 +48729,20 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsGetCall) doRequest(alt str } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "tenant": c.tenant, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.subscribe", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.get" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.subscribe" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Assistant.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsEnginesAssistantsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Assistant, error) { +// *A2aV1StreamResponse.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksSubscribeCall) Do(opts ...googleapi.CallOption) (*A2aV1StreamResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -46404,7 +48761,7 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsGetCall) Do(opts ...google if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Assistant{ + ret := &A2aV1StreamResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -46415,107 +48772,93 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsGetCall) Do(opts ...google if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.subscribe", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsEnginesAssistantsListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsCreateCall struct { + s *Service + tenant string + parent string + a2av1taskpushnotificationconfig *A2aV1TaskPushNotificationConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// List: Lists all Assistants under an Engine. +// Create: Set a push notification config for a task. // -// - parent: The parent resource name. Format: -// `projects/{project}/locations/{location}/collections/{collection}/engines/{ -// engine}`. -func (r *ProjectsLocationsCollectionsEnginesAssistantsService) List(parent string) *ProjectsLocationsCollectionsEnginesAssistantsListCall { - c := &ProjectsLocationsCollectionsEnginesAssistantsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: The parent task resource for this config. Format: tasks/{task_id}. +// - tenant: Optional tenant, provided as a path parameter. Experimental, might +// still change for 1.0 release. +func (r *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsService) Create(tenant string, parent string, a2av1taskpushnotificationconfig *A2aV1TaskPushNotificationConfig) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsCreateCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.tenant = tenant c.parent = parent + c.a2av1taskpushnotificationconfig = a2av1taskpushnotificationconfig return c } -// PageSize sets the optional parameter "pageSize": Maximum number of -// Assistants to return. If unspecified, defaults to 100. The maximum allowed -// value is 1000; anything above that will be coerced down to 1000. -func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsEnginesAssistantsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": A page token -// ListAssistantsResponse.next_page_token, received from a previous -// AssistantService.ListAssistants call. Provide this to retrieve the -// subsequent page. When paginating, all other parameters provided to -// ListAssistants must match the call that provided the page token. -func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsEnginesAssistantsListCall { - c.urlParams_.Set("pageToken", pageToken) +// ConfigId sets the optional parameter "configId": Required. The ID for the +// new config. +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsCreateCall) ConfigId(configId string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsCreateCall { + c.urlParams_.Set("configId", configId) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsListCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesAssistantsListCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsListCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsCreateCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsCreateCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.a2av1taskpushnotificationconfig) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/assistants") + urls := googleapi.ResolveRelative(c.s.BasePath, "{+tenant}/{+parent}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ + "tenant": c.tenant, "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.list" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.create" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ListAssistantsResponse.ServerResponse.Header or -// (if a response was returned at all) in error.(*googleapi.Error).Header. Use +// *A2aV1TaskPushNotificationConfig.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListAssistantsResponse, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsCreateCall) Do(opts ...googleapi.CallOption) (*A2aV1TaskPushNotificationConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -46534,7 +48877,7 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) Do(opts ...googl if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ListAssistantsResponse{ + ret := &A2aV1TaskPushNotificationConfig{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -46545,112 +48888,81 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) Do(opts ...googl if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsCollectionsEnginesAssistantsListCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1ListAssistantsResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.PageToken(x.NextPageToken) - } -} - -type ProjectsLocationsCollectionsEnginesAssistantsPatchCall struct { - s *Service - name string - googleclouddiscoveryenginev1assistant *GoogleCloudDiscoveryengineV1Assistant - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsDeleteCall struct { + s *Service + tenant string + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Patch: Updates an Assistant +// Delete: Delete a push notification config for a task. // -// - name: Immutable. Resource name of the assistant. Format: -// `projects/{project}/locations/{location}/collections/{collection}/engines/{ -// engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a -// length limit of 1024 characters. -func (r *ProjectsLocationsCollectionsEnginesAssistantsService) Patch(name string, googleclouddiscoveryenginev1assistant *GoogleCloudDiscoveryengineV1Assistant) *ProjectsLocationsCollectionsEnginesAssistantsPatchCall { - c := &ProjectsLocationsCollectionsEnginesAssistantsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The resource name of the config to delete. Format: +// tasks/{task_id}/pushNotificationConfigs/{config_id}. +// - tenant: Optional tenant, provided as a path parameter. Experimental, might +// still change for 1.0 release. +func (r *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsService) Delete(tenant string, name string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsDeleteCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.tenant = tenant c.name = name - c.googleclouddiscoveryenginev1assistant = googleclouddiscoveryenginev1assistant - return c -} - -// UpdateMask sets the optional parameter "updateMask": The list of fields to -// update. -func (c *ProjectsLocationsCollectionsEnginesAssistantsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsEnginesAssistantsPatchCall { - c.urlParams_.Set("updateMask", updateMask) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsEnginesAssistantsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsPatchCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsEnginesAssistantsPatchCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsPatchCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsDeleteCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsEnginesAssistantsPatchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsEnginesAssistantsPatchCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1assistant) - if err != nil { - return nil, err - } +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "{+tenant}/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "tenant": c.tenant, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.patch" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1Assistant.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsEnginesAssistantsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1Assistant, error) { +// *GoogleProtobufEmpty.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -46669,7 +48981,7 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsPatchCall) Do(opts ...goog if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1Assistant{ + ret := &GoogleProtobufEmpty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -46680,83 +48992,93 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsPatchCall) Do(opts ...goog if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.patch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall struct { - s *Service - name string - googleclouddiscoveryenginev1streamassistrequest *GoogleCloudDiscoveryengineV1StreamAssistRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsGetCall struct { + s *Service + tenant string + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// StreamAssist: Assists the user with a query in a streaming fashion. +// Get: Get a push notification config for a task. // -// - name: The resource name of the Assistant. Format: -// `projects/{project}/locations/{location}/collections/{collection}/engines/{ -// engine}/assistants/{assistant}`. -func (r *ProjectsLocationsCollectionsEnginesAssistantsService) StreamAssist(name string, googleclouddiscoveryenginev1streamassistrequest *GoogleCloudDiscoveryengineV1StreamAssistRequest) *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall { - c := &ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The resource name of the config to retrieve. Format: +// tasks/{task_id}/pushNotificationConfigs/{config_id}. +// - tenant: Optional tenant, provided as a path parameter. Experimental, might +// still change for 1.0 release. +func (r *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsService) Get(tenant string, name string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsGetCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.tenant = tenant c.name = name - c.googleclouddiscoveryenginev1streamassistrequest = googleclouddiscoveryenginev1streamassistrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1streamassistrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:streamAssist") + urls := googleapi.ResolveRelative(c.s.BasePath, "{+tenant}/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "tenant": c.tenant, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.streamAssist", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.streamAssist" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1StreamAssistResponse.ServerResponse.Header or -// (if a response was returned at all) in error.(*googleapi.Error).Header. Use +// *A2aV1TaskPushNotificationConfig.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1StreamAssistResponse, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsGetCall) Do(opts ...googleapi.CallOption) (*A2aV1TaskPushNotificationConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -46775,7 +49097,7 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall) Do(opts if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1StreamAssistResponse{ + ret := &A2aV1TaskPushNotificationConfig{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -46786,34 +49108,54 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsStreamAssistCall) Do(opts if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.streamAssist", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall struct { +type ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall struct { s *Service - name string + tenant string + parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// Get: 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. +// List: Get a list of push notifications configured for a task. // -// - name: The name of the operation resource. -func (r *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsService) Get(name string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall { - c := &ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: The parent task resource. Format: tasks/{task_id}. +// - tenant: Optional tenant, provided as a path parameter. Experimental, might +// still change for 1.0 release. +func (r *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsService) List(tenant string, parent string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall { + c := &ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.tenant = tenant + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": For AIP-158 these fields +// are present. Usually not used/needed. The maximum number of configurations +// to return. If unspecified, all configs will be returned. +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token received +// from a previous ListTaskPushNotificationConfigRequest call. Provide this to +// retrieve the subsequent page. When paginating, all other parameters provided +// to `ListTaskPushNotificationConfigRequest` must match the call that provided +// the page token. +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall { + c.urlParams_.Set("pageToken", pageToken) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -46821,34 +49163,34 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall) F // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "{+tenant}/{+parent}/pushNotificationConfigs") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -46856,19 +49198,20 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall) d } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "tenant": c.tenant, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.operations.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.agents.operations.get" call. +// Do executes the "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *A2aV1ListTaskPushNotificationConfigResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use // googleapi.IsNotModified to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall) Do(opts ...googleapi.CallOption) (*A2aV1ListTaskPushNotificationConfigResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -46887,7 +49230,7 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall) D if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &A2aV1ListTaskPushNotificationConfigResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -46898,10 +49241,31 @@ func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsOperationsGetCall) D if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.operations.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.engines.assistants.agents.tasks.pushNotificationConfigs.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsCollectionsEnginesAssistantsAgentsTasksPushNotificationConfigsListCall) Pages(ctx context.Context, f func(*A2aV1ListTaskPushNotificationConfigResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + type ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall struct { s *Service completionConfig string diff --git a/discoveryengine/v1alpha/discoveryengine-api.json b/discoveryengine/v1alpha/discoveryengine-api.json index 88976db31d..1ff4799766 100644 --- a/discoveryengine/v1alpha/discoveryengine-api.json +++ b/discoveryengine/v1alpha/discoveryengine-api.json @@ -12250,7 +12250,7 @@ } } }, - "revision": "20260209", + "revision": "20260215", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -13723,7 +13723,8 @@ "THIRD_PARTY_EUA", "GCNV", "GOOGLE_CHAT", - "GOOGLE_SITES" + "GOOGLE_SITES", + "REMOTE_MCP" ], "enumDescriptions": [ "Default value.", @@ -13739,7 +13740,8 @@ "Connector utilized for End User Authentication features.", "Google Cloud NetApp Volumes connector.", "Google Chat connector.", - "Google Sites connector." + "Google Sites connector.", + "Remote MCP based connector." ], "readOnly": true, "type": "string" @@ -14728,6 +14730,13 @@ ], "type": "string" }, + "connectorTenantInfo": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", + "type": "object" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -15514,13 +15523,15 @@ "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", - "SUBSCRIPTION_TERM_THREE_YEARS" + "SUBSCRIPTION_TERM_THREE_YEARS", + "SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", - "3 years." + "3 years.", + "Custom term. Must set the end_date." ], "type": "string" }, @@ -20020,13 +20031,15 @@ "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", - "SUBSCRIPTION_TERM_THREE_YEARS" + "SUBSCRIPTION_TERM_THREE_YEARS", + "SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", - "3 years." + "3 years.", + "Custom term. Must set the end_date." ], "type": "string" }, @@ -21911,7 +21924,8 @@ "THIRD_PARTY_EUA", "GCNV", "GOOGLE_CHAT", - "GOOGLE_SITES" + "GOOGLE_SITES", + "REMOTE_MCP" ], "enumDescriptions": [ "Default value.", @@ -21927,7 +21941,8 @@ "Connector utilized for End User Authentication features.", "Google Cloud NetApp Volumes connector.", "Google Chat connector.", - "Google Sites connector." + "Google Sites connector.", + "Remote MCP based connector." ], "readOnly": true, "type": "string" @@ -23294,6 +23309,13 @@ ], "type": "string" }, + "connectorTenantInfo": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", + "type": "object" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -25475,13 +25497,15 @@ "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", - "SUBSCRIPTION_TERM_THREE_YEARS" + "SUBSCRIPTION_TERM_THREE_YEARS", + "SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", - "3 years." + "3 years.", + "Custom term. Must set the end_date." ], "type": "string" }, @@ -28165,7 +28189,7 @@ "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "numResultsPerDataStore": { - "description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit.", + "description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit.", "format": "int32", "type": "integer" }, @@ -33339,6 +33363,13 @@ ], "type": "string" }, + "connectorTenantInfo": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", + "type": "object" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -34302,13 +34333,15 @@ "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", - "SUBSCRIPTION_TERM_THREE_YEARS" + "SUBSCRIPTION_TERM_THREE_YEARS", + "SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", - "3 years." + "3 years.", + "Custom term. Must set the end_date." ], "type": "string" }, @@ -34939,7 +34972,7 @@ "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "numResultsPerDataStore": { - "description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit.", + "description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit.", "format": "int32", "type": "integer" }, diff --git a/discoveryengine/v1alpha/discoveryengine-gen.go b/discoveryengine/v1alpha/discoveryengine-gen.go index 7d4c23edd9..b656d8d586 100644 --- a/discoveryengine/v1alpha/discoveryengine-gen.go +++ b/discoveryengine/v1alpha/discoveryengine-gen.go @@ -3511,6 +3511,7 @@ type GoogleCloudDiscoveryengineV1DataConnector struct { // "GCNV" - Google Cloud NetApp Volumes connector. // "GOOGLE_CHAT" - Google Chat connector. // "GOOGLE_SITES" - Google Sites connector. + // "REMOTE_MCP" - Remote MCP based connector. ConnectorType string `json:"connectorType,omitempty"` // CreateEuaSaas: Optional. Whether the END USER AUTHENTICATION connector is // created in SaaS. @@ -4634,6 +4635,10 @@ type GoogleCloudDiscoveryengineV1Engine struct { // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows // configurations specified by customer. ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` + // ConnectorTenantInfo: Optional. Maps a connector ID (e.g., "hybrid-github", + // "shopify") to tenant-specific information required for that connector. The + // structure of the tenant information string is connector-dependent. + ConnectorTenantInfo map[string]string `json:"connectorTenantInfo,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -5666,6 +5671,7 @@ type GoogleCloudDiscoveryengineV1LicenseConfig struct { // "SUBSCRIPTION_TERM_ONE_MONTH" - 1 month. // "SUBSCRIPTION_TERM_ONE_YEAR" - 1 year. // "SUBSCRIPTION_TERM_THREE_YEARS" - 3 years. + // "SUBSCRIPTION_TERM_CUSTOM" - Custom term. Must set the end_date. SubscriptionTerm string `json:"subscriptionTerm,omitempty"` // SubscriptionTier: Required. Subscription tier information for the license // config. @@ -11716,6 +11722,7 @@ type GoogleCloudDiscoveryengineV1alphaBillingAccountLicenseConfig struct { // "SUBSCRIPTION_TERM_ONE_MONTH" - 1 month. // "SUBSCRIPTION_TERM_ONE_YEAR" - 1 year. // "SUBSCRIPTION_TERM_THREE_YEARS" - 3 years. + // "SUBSCRIPTION_TERM_CUSTOM" - Custom term. Must set the end_date. SubscriptionTerm string `json:"subscriptionTerm,omitempty"` // SubscriptionTier: Required. The subscription tier. // @@ -14155,6 +14162,7 @@ type GoogleCloudDiscoveryengineV1alphaDataConnector struct { // "GCNV" - Google Cloud NetApp Volumes connector. // "GOOGLE_CHAT" - Google Chat connector. // "GOOGLE_SITES" - Google Sites connector. + // "REMOTE_MCP" - Remote MCP based connector. ConnectorType string `json:"connectorType,omitempty"` // CreateEuaSaas: Optional. Whether the END USER AUTHENTICATION connector is // created in SaaS. @@ -15908,6 +15916,10 @@ type GoogleCloudDiscoveryengineV1alphaEngine struct { // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows // configurations specified by customer. ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` + // ConnectorTenantInfo: Optional. Maps a connector ID (e.g., "hybrid-github", + // "shopify") to tenant-specific information required for that connector. The + // structure of the tenant information string is connector-dependent. + ConnectorTenantInfo map[string]string `json:"connectorTenantInfo,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -18792,6 +18804,7 @@ type GoogleCloudDiscoveryengineV1alphaLicenseConfig struct { // "SUBSCRIPTION_TERM_ONE_MONTH" - 1 month. // "SUBSCRIPTION_TERM_ONE_YEAR" - 1 year. // "SUBSCRIPTION_TERM_THREE_YEARS" - 3 years. + // "SUBSCRIPTION_TERM_CUSTOM" - Custom term. Must set the end_date. SubscriptionTerm string `json:"subscriptionTerm,omitempty"` // SubscriptionTier: Required. Subscription tier information for the license // config. @@ -22799,8 +22812,8 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequest struct { NaturalLanguageQueryUnderstandingSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec `json:"naturalLanguageQueryUnderstandingSpec,omitempty"` // NumResultsPerDataStore: Optional. The maximum number of results to retrieve // from each data store. If not specified, it will use the - // SearchRequest.data_store_specs.num_results if provided, otherwise there is - // no limit. + // SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no + // limit. NumResultsPerDataStore int64 `json:"numResultsPerDataStore,omitempty"` // Offset: A 0-indexed integer that specifies the current offset (that is, // starting result location, amongst the Documents deemed by the API as @@ -29679,6 +29692,10 @@ type GoogleCloudDiscoveryengineV1betaEngine struct { // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows // configurations specified by customer. ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` + // ConnectorTenantInfo: Optional. Maps a connector ID (e.g., "hybrid-github", + // "shopify") to tenant-specific information required for that connector. The + // structure of the tenant information string is connector-dependent. + ConnectorTenantInfo map[string]string `json:"connectorTenantInfo,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -30927,6 +30944,7 @@ type GoogleCloudDiscoveryengineV1betaLicenseConfig struct { // "SUBSCRIPTION_TERM_ONE_MONTH" - 1 month. // "SUBSCRIPTION_TERM_ONE_YEAR" - 1 year. // "SUBSCRIPTION_TERM_THREE_YEARS" - 3 years. + // "SUBSCRIPTION_TERM_CUSTOM" - Custom term. Must set the end_date. SubscriptionTerm string `json:"subscriptionTerm,omitempty"` // SubscriptionTier: Required. Subscription tier information for the license // config. @@ -31812,8 +31830,8 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { NaturalLanguageQueryUnderstandingSpec *GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec `json:"naturalLanguageQueryUnderstandingSpec,omitempty"` // NumResultsPerDataStore: Optional. The maximum number of results to retrieve // from each data store. If not specified, it will use the - // SearchRequest.data_store_specs.num_results if provided, otherwise there is - // no limit. + // SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no + // limit. NumResultsPerDataStore int64 `json:"numResultsPerDataStore,omitempty"` // Offset: A 0-indexed integer that specifies the current offset (that is, // starting result location, amongst the Documents deemed by the API as diff --git a/discoveryengine/v1beta/discoveryengine-api.json b/discoveryengine/v1beta/discoveryengine-api.json index cf1a34ade2..4262436624 100644 --- a/discoveryengine/v1beta/discoveryengine-api.json +++ b/discoveryengine/v1beta/discoveryengine-api.json @@ -9167,7 +9167,7 @@ } } }, - "revision": "20260209", + "revision": "20260215", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -10640,7 +10640,8 @@ "THIRD_PARTY_EUA", "GCNV", "GOOGLE_CHAT", - "GOOGLE_SITES" + "GOOGLE_SITES", + "REMOTE_MCP" ], "enumDescriptions": [ "Default value.", @@ -10656,7 +10657,8 @@ "Connector utilized for End User Authentication features.", "Google Cloud NetApp Volumes connector.", "Google Chat connector.", - "Google Sites connector." + "Google Sites connector.", + "Remote MCP based connector." ], "readOnly": true, "type": "string" @@ -11645,6 +11647,13 @@ ], "type": "string" }, + "connectorTenantInfo": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", + "type": "object" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -12431,13 +12440,15 @@ "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", - "SUBSCRIPTION_TERM_THREE_YEARS" + "SUBSCRIPTION_TERM_THREE_YEARS", + "SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", - "3 years." + "3 years.", + "Custom term. Must set the end_date." ], "type": "string" }, @@ -15873,7 +15884,8 @@ "THIRD_PARTY_EUA", "GCNV", "GOOGLE_CHAT", - "GOOGLE_SITES" + "GOOGLE_SITES", + "REMOTE_MCP" ], "enumDescriptions": [ "Default value.", @@ -15889,7 +15901,8 @@ "Connector utilized for End User Authentication features.", "Google Cloud NetApp Volumes connector.", "Google Chat connector.", - "Google Sites connector." + "Google Sites connector.", + "Remote MCP based connector." ], "readOnly": true, "type": "string" @@ -16992,6 +17005,13 @@ ], "type": "string" }, + "connectorTenantInfo": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", + "type": "object" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -18288,13 +18308,15 @@ "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", - "SUBSCRIPTION_TERM_THREE_YEARS" + "SUBSCRIPTION_TERM_THREE_YEARS", + "SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", - "3 years." + "3 years.", + "Custom term. Must set the end_date." ], "type": "string" }, @@ -19494,7 +19516,7 @@ "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "numResultsPerDataStore": { - "description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit.", + "description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit.", "format": "int32", "type": "integer" }, @@ -25648,6 +25670,13 @@ ], "type": "string" }, + "connectorTenantInfo": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Maps a connector ID (e.g., \"hybrid-github\", \"shopify\") to tenant-specific information required for that connector. The structure of the tenant information string is connector-dependent.", + "type": "object" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -27083,13 +27112,15 @@ "SUBSCRIPTION_TERM_UNSPECIFIED", "SUBSCRIPTION_TERM_ONE_MONTH", "SUBSCRIPTION_TERM_ONE_YEAR", - "SUBSCRIPTION_TERM_THREE_YEARS" + "SUBSCRIPTION_TERM_THREE_YEARS", + "SUBSCRIPTION_TERM_CUSTOM" ], "enumDescriptions": [ "Default value, do not use.", "1 month.", "1 year.", - "3 years." + "3 years.", + "Custom term. Must set the end_date." ], "type": "string" }, @@ -28851,7 +28882,7 @@ "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "numResultsPerDataStore": { - "description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.data_store_specs.num_results if provided, otherwise there is no limit.", + "description": "Optional. The maximum number of results to retrieve from each data store. If not specified, it will use the SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no limit.", "format": "int32", "type": "integer" }, diff --git a/discoveryengine/v1beta/discoveryengine-gen.go b/discoveryengine/v1beta/discoveryengine-gen.go index db65d7f7fc..85e931f5c9 100644 --- a/discoveryengine/v1beta/discoveryengine-gen.go +++ b/discoveryengine/v1beta/discoveryengine-gen.go @@ -3259,6 +3259,7 @@ type GoogleCloudDiscoveryengineV1DataConnector struct { // "GCNV" - Google Cloud NetApp Volumes connector. // "GOOGLE_CHAT" - Google Chat connector. // "GOOGLE_SITES" - Google Sites connector. + // "REMOTE_MCP" - Remote MCP based connector. ConnectorType string `json:"connectorType,omitempty"` // CreateEuaSaas: Optional. Whether the END USER AUTHENTICATION connector is // created in SaaS. @@ -4382,6 +4383,10 @@ type GoogleCloudDiscoveryengineV1Engine struct { // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows // configurations specified by customer. ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` + // ConnectorTenantInfo: Optional. Maps a connector ID (e.g., "hybrid-github", + // "shopify") to tenant-specific information required for that connector. The + // structure of the tenant information string is connector-dependent. + ConnectorTenantInfo map[string]string `json:"connectorTenantInfo,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -5414,6 +5419,7 @@ type GoogleCloudDiscoveryengineV1LicenseConfig struct { // "SUBSCRIPTION_TERM_ONE_MONTH" - 1 month. // "SUBSCRIPTION_TERM_ONE_YEAR" - 1 year. // "SUBSCRIPTION_TERM_THREE_YEARS" - 3 years. + // "SUBSCRIPTION_TERM_CUSTOM" - Custom term. Must set the end_date. SubscriptionTerm string `json:"subscriptionTerm,omitempty"` // SubscriptionTier: Required. Subscription tier information for the license // config. @@ -9812,6 +9818,7 @@ type GoogleCloudDiscoveryengineV1alphaDataConnector struct { // "GCNV" - Google Cloud NetApp Volumes connector. // "GOOGLE_CHAT" - Google Chat connector. // "GOOGLE_SITES" - Google Sites connector. + // "REMOTE_MCP" - Remote MCP based connector. ConnectorType string `json:"connectorType,omitempty"` // CreateEuaSaas: Optional. Whether the END USER AUTHENTICATION connector is // created in SaaS. @@ -11143,6 +11150,10 @@ type GoogleCloudDiscoveryengineV1alphaEngine struct { // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows // configurations specified by customer. ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` + // ConnectorTenantInfo: Optional. Maps a connector ID (e.g., "hybrid-github", + // "shopify") to tenant-specific information required for that connector. The + // structure of the tenant information string is connector-dependent. + ConnectorTenantInfo map[string]string `json:"connectorTenantInfo,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -12807,6 +12818,7 @@ type GoogleCloudDiscoveryengineV1alphaLicenseConfig struct { // "SUBSCRIPTION_TERM_ONE_MONTH" - 1 month. // "SUBSCRIPTION_TERM_ONE_YEAR" - 1 year. // "SUBSCRIPTION_TERM_THREE_YEARS" - 3 years. + // "SUBSCRIPTION_TERM_CUSTOM" - Custom term. Must set the end_date. SubscriptionTerm string `json:"subscriptionTerm,omitempty"` // SubscriptionTier: Required. Subscription tier information for the license // config. @@ -14378,8 +14390,8 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequest struct { NaturalLanguageQueryUnderstandingSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec `json:"naturalLanguageQueryUnderstandingSpec,omitempty"` // NumResultsPerDataStore: Optional. The maximum number of results to retrieve // from each data store. If not specified, it will use the - // SearchRequest.data_store_specs.num_results if provided, otherwise there is - // no limit. + // SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no + // limit. NumResultsPerDataStore int64 `json:"numResultsPerDataStore,omitempty"` // Offset: A 0-indexed integer that specifies the current offset (that is, // starting result location, amongst the Documents deemed by the API as @@ -22926,6 +22938,10 @@ type GoogleCloudDiscoveryengineV1betaEngine struct { // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows // configurations specified by customer. ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` + // ConnectorTenantInfo: Optional. Maps a connector ID (e.g., "hybrid-github", + // "shopify") to tenant-specific information required for that connector. The + // structure of the tenant information string is connector-dependent. + ConnectorTenantInfo map[string]string `json:"connectorTenantInfo,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -24897,6 +24913,7 @@ type GoogleCloudDiscoveryengineV1betaLicenseConfig struct { // "SUBSCRIPTION_TERM_ONE_MONTH" - 1 month. // "SUBSCRIPTION_TERM_ONE_YEAR" - 1 year. // "SUBSCRIPTION_TERM_THREE_YEARS" - 3 years. + // "SUBSCRIPTION_TERM_CUSTOM" - Custom term. Must set the end_date. SubscriptionTerm string `json:"subscriptionTerm,omitempty"` // SubscriptionTier: Required. Subscription tier information for the license // config. @@ -27590,8 +27607,8 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { NaturalLanguageQueryUnderstandingSpec *GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec `json:"naturalLanguageQueryUnderstandingSpec,omitempty"` // NumResultsPerDataStore: Optional. The maximum number of results to retrieve // from each data store. If not specified, it will use the - // SearchRequest.data_store_specs.num_results if provided, otherwise there is - // no limit. + // SearchRequest.DataStoreSpec.num_results if provided, otherwise there is no + // limit. NumResultsPerDataStore int64 `json:"numResultsPerDataStore,omitempty"` // Offset: A 0-indexed integer that specifies the current offset (that is, // starting result location, amongst the Documents deemed by the API as diff --git a/documentai/v1/documentai-api.json b/documentai/v1/documentai-api.json index 62af1ed6aa..dc35cf12a5 100644 --- a/documentai/v1/documentai-api.json +++ b/documentai/v1/documentai-api.json @@ -1431,7 +1431,7 @@ } } }, - "revision": "20260203", + "revision": "20260217", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "CloudAiDocumentaiLabHifiaToolsValidationValidatorInput": { @@ -2163,12 +2163,14 @@ "enum": [ "METHOD_UNSPECIFIED", "EXTRACT", - "DERIVE" + "DERIVE", + "RELAXED_EXTRACT" ], "enumDescriptions": [ "Unspecified method. It defaults to `EXTRACT`.", "The entity's value is directly extracted as-is from the document text.", - "The entity's value is derived through inference and is not necessarily an exact text extraction from the document." + "The entity's value is derived through inference and is not necessarily an exact text extraction from the document.", + "Attempts to extract the position and value as-is from the document text. If the value cannot be grounded in the text, it falls back to derivation through inference, for both position and value. Note: The inference fallback is currently only supported for boolean entities." ], "type": "string" }, @@ -3195,12 +3197,14 @@ "enum": [ "METHOD_UNSPECIFIED", "EXTRACT", - "DERIVE" + "DERIVE", + "RELAXED_EXTRACT" ], "enumDescriptions": [ "Unspecified method. It defaults to `EXTRACT`.", "The entity's value is directly extracted as-is from the document text.", - "The entity's value is derived through inference and is not necessarily an exact text extraction from the document." + "The entity's value is derived through inference and is not necessarily an exact text extraction from the document.", + "Attempts to extract the position and value as-is from the document text. If the value cannot be grounded in the text, it falls back to derivation through inference, for both position and value. Note: The inference fallback is currently only supported for boolean entities." ], "type": "string" }, @@ -5304,12 +5308,14 @@ "enum": [ "METHOD_UNSPECIFIED", "EXTRACT", - "DERIVE" + "DERIVE", + "RELAXED_EXTRACT" ], "enumDescriptions": [ "Unspecified method. It defaults to `EXTRACT`.", "The entity's value is directly extracted as-is from the document text.", - "The entity's value is derived through inference and is not necessarily an exact text extraction from the document." + "The entity's value is derived through inference and is not necessarily an exact text extraction from the document.", + "Attempts to extract the position and value as-is from the document text. If the value cannot be grounded in the text, it falls back to derivation through inference, for both position and value. Note: The inference fallback is currently only supported for boolean entities." ], "type": "string" }, @@ -7561,12 +7567,14 @@ "enum": [ "METHOD_UNSPECIFIED", "EXTRACT", - "DERIVE" + "DERIVE", + "RELAXED_EXTRACT" ], "enumDescriptions": [ "Unspecified method. It defaults to `EXTRACT`.", "The entity's value is directly extracted as-is from the document text.", - "The entity's value is derived through inference and is not necessarily an exact text extraction from the document." + "The entity's value is derived through inference and is not necessarily an exact text extraction from the document.", + "Attempts to extract the position and value as-is from the document text. If the value cannot be grounded in the text, it falls back to derivation through inference, for both position and value. Note: The inference fallback is currently only supported for boolean entities." ], "type": "string" }, diff --git a/documentai/v1/documentai-gen.go b/documentai/v1/documentai-gen.go index 163664d1d1..6d57c26742 100644 --- a/documentai/v1/documentai-gen.go +++ b/documentai/v1/documentai-gen.go @@ -1258,6 +1258,10 @@ type GoogleCloudDocumentaiUiv1beta3DocumentSchemaEntityTypeProperty struct { // document text. // "DERIVE" - The entity's value is derived through inference and is not // necessarily an exact text extraction from the document. + // "RELAXED_EXTRACT" - Attempts to extract the position and value as-is from + // the document text. If the value cannot be grounded in the text, it falls + // back to derivation through inference, for both position and value. Note: The + // inference fallback is currently only supported for boolean entities. Method string `json:"method,omitempty"` // Name: The name of the property. Follows the same guidelines as the // EntityType name. @@ -2570,6 +2574,10 @@ type GoogleCloudDocumentaiUiv1beta3SchemaEntityType struct { // document text. // "DERIVE" - The entity's value is derived through inference and is not // necessarily an exact text extraction from the document. + // "RELAXED_EXTRACT" - Attempts to extract the position and value as-is from + // the document text. If the value cannot be grounded in the text, it falls + // back to derivation through inference, for both position and value. Note: The + // inference fallback is currently only supported for boolean entities. Method string `json:"method,omitempty"` // OccurrenceType: Occurrence type limits the number of times an entity type // appears in the document. @@ -5185,6 +5193,10 @@ type GoogleCloudDocumentaiV1DocumentSchemaEntityTypeProperty struct { // document text. // "DERIVE" - The entity's value is derived through inference and is not // necessarily an exact text extraction from the document. + // "RELAXED_EXTRACT" - Attempts to extract the position and value as-is from + // the document text. If the value cannot be grounded in the text, it falls + // back to derivation through inference, for both position and value. Note: The + // inference fallback is currently only supported for boolean entities. Method string `json:"method,omitempty"` // Name: The name of the property. Follows the same guidelines as the // EntityType name. @@ -8210,6 +8222,10 @@ type GoogleCloudDocumentaiV1beta3DocumentSchemaEntityTypeProperty struct { // document text. // "DERIVE" - The entity's value is derived through inference and is not // necessarily an exact text extraction from the document. + // "RELAXED_EXTRACT" - Attempts to extract the position and value as-is from + // the document text. If the value cannot be grounded in the text, it falls + // back to derivation through inference, for both position and value. Note: The + // inference fallback is currently only supported for boolean entities. Method string `json:"method,omitempty"` // Name: The name of the property. Follows the same guidelines as the // EntityType name. diff --git a/documentai/v1beta3/documentai-api.json b/documentai/v1beta3/documentai-api.json index 634013f9a5..8c0675b83b 100644 --- a/documentai/v1beta3/documentai-api.json +++ b/documentai/v1beta3/documentai-api.json @@ -1673,7 +1673,7 @@ } } }, - "revision": "20260203", + "revision": "20260217", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "CloudAiDocumentaiLabHifiaToolsValidationValidatorInput": { @@ -2405,12 +2405,14 @@ "enum": [ "METHOD_UNSPECIFIED", "EXTRACT", - "DERIVE" + "DERIVE", + "RELAXED_EXTRACT" ], "enumDescriptions": [ "Unspecified method. It defaults to `EXTRACT`.", "The entity's value is directly extracted as-is from the document text.", - "The entity's value is derived through inference and is not necessarily an exact text extraction from the document." + "The entity's value is derived through inference and is not necessarily an exact text extraction from the document.", + "Attempts to extract the position and value as-is from the document text. If the value cannot be grounded in the text, it falls back to derivation through inference, for both position and value. Note: The inference fallback is currently only supported for boolean entities." ], "type": "string" }, @@ -3437,12 +3439,14 @@ "enum": [ "METHOD_UNSPECIFIED", "EXTRACT", - "DERIVE" + "DERIVE", + "RELAXED_EXTRACT" ], "enumDescriptions": [ "Unspecified method. It defaults to `EXTRACT`.", "The entity's value is directly extracted as-is from the document text.", - "The entity's value is derived through inference and is not necessarily an exact text extraction from the document." + "The entity's value is derived through inference and is not necessarily an exact text extraction from the document.", + "Attempts to extract the position and value as-is from the document text. If the value cannot be grounded in the text, it falls back to derivation through inference, for both position and value. Note: The inference fallback is currently only supported for boolean entities." ], "type": "string" }, @@ -6426,12 +6430,14 @@ "enum": [ "METHOD_UNSPECIFIED", "EXTRACT", - "DERIVE" + "DERIVE", + "RELAXED_EXTRACT" ], "enumDescriptions": [ "Unspecified method. It defaults to `EXTRACT`.", "The entity's value is directly extracted as-is from the document text.", - "The entity's value is derived through inference and is not necessarily an exact text extraction from the document." + "The entity's value is derived through inference and is not necessarily an exact text extraction from the document.", + "Attempts to extract the position and value as-is from the document text. If the value cannot be grounded in the text, it falls back to derivation through inference, for both position and value. Note: The inference fallback is currently only supported for boolean entities." ], "type": "string" }, diff --git a/documentai/v1beta3/documentai-gen.go b/documentai/v1beta3/documentai-gen.go index a584f00a9b..9da6f0c576 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -1246,6 +1246,10 @@ type GoogleCloudDocumentaiUiv1beta3DocumentSchemaEntityTypeProperty struct { // document text. // "DERIVE" - The entity's value is derived through inference and is not // necessarily an exact text extraction from the document. + // "RELAXED_EXTRACT" - Attempts to extract the position and value as-is from + // the document text. If the value cannot be grounded in the text, it falls + // back to derivation through inference, for both position and value. Note: The + // inference fallback is currently only supported for boolean entities. Method string `json:"method,omitempty"` // Name: The name of the property. Follows the same guidelines as the // EntityType name. @@ -2558,6 +2562,10 @@ type GoogleCloudDocumentaiUiv1beta3SchemaEntityType struct { // document text. // "DERIVE" - The entity's value is derived through inference and is not // necessarily an exact text extraction from the document. + // "RELAXED_EXTRACT" - Attempts to extract the position and value as-is from + // the document text. If the value cannot be grounded in the text, it falls + // back to derivation through inference, for both position and value. Note: The + // inference fallback is currently only supported for boolean entities. Method string `json:"method,omitempty"` // OccurrenceType: Occurrence type limits the number of times an entity type // appears in the document. @@ -6359,6 +6367,10 @@ type GoogleCloudDocumentaiV1beta3DocumentSchemaEntityTypeProperty struct { // document text. // "DERIVE" - The entity's value is derived through inference and is not // necessarily an exact text extraction from the document. + // "RELAXED_EXTRACT" - Attempts to extract the position and value as-is from + // the document text. If the value cannot be grounded in the text, it falls + // back to derivation through inference, for both position and value. Note: The + // inference fallback is currently only supported for boolean entities. Method string `json:"method,omitempty"` // Name: The name of the property. Follows the same guidelines as the // EntityType name. diff --git a/firebaseml/v2beta/firebaseml-api.json b/firebaseml/v2beta/firebaseml-api.json index c4fc7a23d8..23ec0fc710 100644 --- a/firebaseml/v2beta/firebaseml-api.json +++ b/firebaseml/v2beta/firebaseml-api.json @@ -206,7 +206,7 @@ } } }, - "revision": "20260201", + "revision": "20260215", "rootUrl": "https://firebaseml.googleapis.com/", "schemas": { "Date": { @@ -978,6 +978,22 @@ }, "description": "Required. The function response in JSON object format. Use \"output\" key to specify function output and \"error\" key to specify error details (if any). If \"output\" and \"error\" keys are not specified, then whole \"response\" is treated as function output.", "type": "object" + }, + "scheduling": { + "description": "Optional. Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE.", + "enum": [ + "SCHEDULING_UNSPECIFIED", + "SILENT", + "WHEN_IDLE", + "INTERRUPT" + ], + "enumDescriptions": [ + "This value is unused.", + "Only add the result to the conversation context, do not interrupt or trigger generation.", + "Add the result to the conversation context, and prompt to generate output without interrupting ongoing generation.", + "Add the result to the conversation context, interrupt ongoing generation and prompt to generate output." + ], + "type": "string" } }, "type": "object" @@ -1554,7 +1570,7 @@ "type": "object" }, "GoogleCloudAiplatformV1beta1GroundingChunkMaps": { - "description": "A `Maps` chunk is a piece of evidence that comes from Google Maps. It contains information about a place, such as its name, address, and reviews. This is used to provide the user with rich, location-based information.", + "description": "A `Maps` chunk is a piece of evidence that comes from Google Maps, containing information about places or routes. This is used to provide the user with rich, location-based information.", "id": "GoogleCloudAiplatformV1beta1GroundingChunkMaps", "properties": { "placeAnswerSources": { diff --git a/firebaseml/v2beta/firebaseml-gen.go b/firebaseml/v2beta/firebaseml-gen.go index a3e288c0e9..1875a845f6 100644 --- a/firebaseml/v2beta/firebaseml-gen.go +++ b/firebaseml/v2beta/firebaseml-gen.go @@ -1222,6 +1222,19 @@ type GoogleCloudAiplatformV1beta1FunctionResponse struct { // details (if any). If "output" and "error" keys are not specified, then whole // "response" is treated as function output. Response googleapi.RawMessage `json:"response,omitempty"` + // Scheduling: Optional. Specifies how the response should be scheduled in the + // conversation. Only applicable to NON_BLOCKING function calls, is ignored + // otherwise. Defaults to WHEN_IDLE. + // + // Possible values: + // "SCHEDULING_UNSPECIFIED" - This value is unused. + // "SILENT" - Only add the result to the conversation context, do not + // interrupt or trigger generation. + // "WHEN_IDLE" - Add the result to the conversation context, and prompt to + // generate output without interrupting ongoing generation. + // "INTERRUPT" - Add the result to the conversation context, interrupt + // ongoing generation and prompt to generate output. + Scheduling string `json:"scheduling,omitempty"` // ForceSendFields is a list of field names (e.g. "Id") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -1951,9 +1964,9 @@ func (s GoogleCloudAiplatformV1beta1GroundingChunk) MarshalJSON() ([]byte, error } // GoogleCloudAiplatformV1beta1GroundingChunkMaps: A `Maps` chunk is a piece of -// evidence that comes from Google Maps. It contains information about a place, -// such as its name, address, and reviews. This is used to provide the user -// with rich, location-based information. +// evidence that comes from Google Maps, containing information about places or +// routes. This is used to provide the user with rich, location-based +// information. type GoogleCloudAiplatformV1beta1GroundingChunkMaps struct { // PlaceAnswerSources: The sources that were used to generate the place answer. // This includes review snippets and photos that were used to generate the diff --git a/firestore/v1/firestore-api.json b/firestore/v1/firestore-api.json index 3e7dfa3239..42df388a9b 100644 --- a/firestore/v1/firestore-api.json +++ b/firestore/v1/firestore-api.json @@ -2445,7 +2445,7 @@ } } }, - "revision": "20260130", + "revision": "20260212", "rootUrl": "https://firestore.googleapis.com/", "schemas": { "Aggregation": { @@ -3285,7 +3285,7 @@ "type": "string" }, "name": { - "description": "Output only. The unique resource name of the Backup. Format is `projects/{project}/locations/{location}/backups/{backup}`.", + "description": "Output only. The unique resource name of the Backup. Format is `projects/{project}/locations/{location}/backups/{backup}`. The location in the name will be the Standard Managed Multi-Region (SMMR) location (e.g. `us`) if the backup was created with an SMMR location, or the Google Managed Multi-Region (GMMR) location (e.g. `nam5`) if the backup was created with a GMMR location.", "readOnly": true, "type": "string" }, @@ -4475,15 +4475,7 @@ "GoogleFirestoreAdminV1LocationMetadata": { "description": "The metadata message for google.cloud.location.Location.metadata.", "id": "GoogleFirestoreAdminV1LocationMetadata", - "properties": { - "availableStoragePlacements": { - "description": "The storage placements available in the location. When the location represents a Standard Managed Multi-Region (SMMR) like \"us\", this field lists the available Google-Managed Multi-Regions (GMMRs) within it, such as \"nam5\" or \"eur3\".", - "items": { - "type": "string" - }, - "type": "array" - } - }, + "properties": {}, "type": "object" }, "GoogleFirestoreAdminV1PitrSnapshot": { diff --git a/firestore/v1/firestore-gen.go b/firestore/v1/firestore-gen.go index 722917c619..49e0fbc675 100644 --- a/firestore/v1/firestore-gen.go +++ b/firestore/v1/firestore-gen.go @@ -1593,7 +1593,11 @@ type GoogleFirestoreAdminV1Backup struct { // ExpireTime: Output only. The timestamp at which this backup expires. ExpireTime string `json:"expireTime,omitempty"` // Name: Output only. The unique resource name of the Backup. Format is - // `projects/{project}/locations/{location}/backups/{backup}`. + // `projects/{project}/locations/{location}/backups/{backup}`. The location in + // the name will be the Standard Managed Multi-Region (SMMR) location (e.g. + // `us`) if the backup was created with an SMMR location, or the Google Managed + // Multi-Region (GMMR) location (e.g. `nam5`) if the backup was created with a + // GMMR location. Name string `json:"name,omitempty"` // SnapshotTime: Output only. The backup contains an externally consistent copy // of the database at this time. @@ -2993,27 +2997,6 @@ func (s GoogleFirestoreAdminV1ListUserCredsResponse) MarshalJSON() ([]byte, erro // GoogleFirestoreAdminV1LocationMetadata: The metadata message for // google.cloud.location.Location.metadata. type GoogleFirestoreAdminV1LocationMetadata struct { - // AvailableStoragePlacements: The storage placements available in the - // location. When the location represents a Standard Managed Multi-Region - // (SMMR) like "us", this field lists the available Google-Managed - // Multi-Regions (GMMRs) within it, such as "nam5" or "eur3". - AvailableStoragePlacements []string `json:"availableStoragePlacements,omitempty"` - // ForceSendFields is a list of field names (e.g. "AvailableStoragePlacements") - // to unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AvailableStoragePlacements") to - // include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s GoogleFirestoreAdminV1LocationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleFirestoreAdminV1LocationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } // GoogleFirestoreAdminV1PitrSnapshot: A consistent snapshot of a database at a diff --git a/gkebackup/v1/gkebackup-api.json b/gkebackup/v1/gkebackup-api.json index e9273b4ed2..a8cef45307 100644 --- a/gkebackup/v1/gkebackup-api.json +++ b/gkebackup/v1/gkebackup-api.json @@ -2338,7 +2338,7 @@ } } }, - "revision": "20260202", + "revision": "20260213", "rootUrl": "https://gkebackup.googleapis.com/", "schemas": { "AuditConfig": { @@ -2660,6 +2660,12 @@ "readOnly": true, "type": "string" }, + "namespaceCount": { + "description": "Output only. The total number of user managed namespaces contained in the Backup.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, "permissiveMode": { "description": "Output only. If false, Backup will fail when Backup for GKE detects Kubernetes configuration that is non-standard or requires additional setup to restore. Inherited from the parent BackupPlan's permissive_mode value.", "readOnly": true, @@ -2957,6 +2963,12 @@ "readOnly": true, "type": "string" }, + "protectedNamespaceCount": { + "description": "Output only. The number of user managed namespaces backed up in the last successful Backup created via this BackupPlan.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, "protectedPodCount": { "description": "Output only. The number of Kubernetes Pods backed up in the last successful Backup created via this BackupPlan.", "format": "int32", diff --git a/gkebackup/v1/gkebackup-gen.go b/gkebackup/v1/gkebackup-gen.go index 09a955d198..caf704f32d 100644 --- a/gkebackup/v1/gkebackup-gen.go +++ b/gkebackup/v1/gkebackup-gen.go @@ -590,6 +590,9 @@ type Backup struct { // Name: Output only. Identifier. The fully qualified name of the Backup. // `projects/*/locations/*/backupPlans/*/backups/*` Name string `json:"name,omitempty"` + // NamespaceCount: Output only. The total number of user managed namespaces + // contained in the Backup. + NamespaceCount int64 `json:"namespaceCount,omitempty"` // PermissiveMode: Output only. If false, Backup will fail when Backup for GKE // detects Kubernetes configuration that is non-standard or requires additional // setup to restore. Inherited from the parent BackupPlan's permissive_mode @@ -877,6 +880,9 @@ type BackupPlan struct { // Name: Output only. Identifier. The full name of the BackupPlan resource. // Format: `projects/*/locations/*/backupPlans/*` Name string `json:"name,omitempty"` + // ProtectedNamespaceCount: Output only. The number of user managed namespaces + // backed up in the last successful Backup created via this BackupPlan. + ProtectedNamespaceCount int64 `json:"protectedNamespaceCount,omitempty"` // ProtectedPodCount: Output only. The number of Kubernetes Pods backed up in // the last successful Backup created via this BackupPlan. ProtectedPodCount int64 `json:"protectedPodCount,omitempty"` diff --git a/gkehub/v1/gkehub-api.json b/gkehub/v1/gkehub-api.json index ace85acfad..64ecd21ab5 100644 --- a/gkehub/v1/gkehub-api.json +++ b/gkehub/v1/gkehub-api.json @@ -2122,7 +2122,7 @@ } } }, - "revision": "20260126", + "revision": "20260215", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceFeatureSpec": { @@ -2631,7 +2631,8 @@ "type": "object" }, "CompliancePostureConfig": { - "description": "CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture.", + "deprecated": true, + "description": "Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture.", "id": "CompliancePostureConfig", "properties": { "complianceStandards": { @@ -3736,11 +3737,12 @@ }, "compliancePostureConfig": { "$ref": "CompliancePostureConfig", - "description": "Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask." + "deprecated": true, + "description": "Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask." }, "securityPostureConfig": { "$ref": "SecurityPostureConfig", - "description": "Enable/Disable Security Posture features for the cluster." + "description": "Optional. Enable/Disable Security Posture features for the cluster." } }, "type": "object" @@ -6264,11 +6266,17 @@ "BASIC", "ENTERPRISE" ], + "enumDeprecated": [ + false, + false, + false, + true + ], "enumDescriptions": [ "Default value not specified.", "Disables Security Posture features on the cluster.", "Applies Security Posture features on the cluster.", - "Applies the Security Posture off cluster Enterprise level features." + "Deprecated: Security Posture Enterprise features are no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Applies the Security Posture off cluster Enterprise level features." ], "type": "string" }, @@ -6280,10 +6288,16 @@ "VULNERABILITY_BASIC", "VULNERABILITY_ENTERPRISE" ], + "enumDeprecated": [ + false, + false, + true, + false + ], "enumDescriptions": [ "Default value not specified.", "Disables vulnerability scanning on the cluster.", - "Applies basic vulnerability scanning on the cluster.", + "Deprecated: Basic vulnerability scanning is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Applies basic vulnerability scanning on the cluster.", "Applies the Security Posture's vulnerability on cluster Enterprise level features." ], "type": "string" diff --git a/gkehub/v1/gkehub-gen.go b/gkehub/v1/gkehub-gen.go index 3a3943284f..57f6257fa1 100644 --- a/gkehub/v1/gkehub-gen.go +++ b/gkehub/v1/gkehub-gen.go @@ -1077,8 +1077,11 @@ func (s CommonFleetDefaultMemberConfigSpec) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// CompliancePostureConfig: CompliancePostureConfig defines the settings needed -// to enable/disable features for the Compliance Posture. +// CompliancePostureConfig: Deprecated: Compliance Posture is no longer +// supported. For more details, see +// https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. +// CompliancePostureConfig defines the settings needed to enable/disable +// features for the Compliance Posture. type CompliancePostureConfig struct { // ComplianceStandards: List of enabled compliance standards. ComplianceStandards []*ComplianceStandard `json:"complianceStandards,omitempty"` @@ -2244,13 +2247,15 @@ type DefaultClusterConfig struct { // BinaryAuthorizationConfig: Optional. Enable/Disable binary authorization // features for the cluster. BinaryAuthorizationConfig *BinaryAuthorizationConfig `json:"binaryAuthorizationConfig,omitempty"` - // CompliancePostureConfig: Optional. Enable/Disable Compliance Posture - // features for the cluster. Note that on UpdateFleet, only full replacement of - // this field is allowed. Users are not allowed for partial updates through - // field mask. + // CompliancePostureConfig: Optional. Deprecated: Compliance Posture is no + // longer supported. For more details, see + // https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. + // Enable/Disable Compliance Posture features for the cluster. Note that on + // UpdateFleet, only full replacement of this field is allowed. Users are not + // allowed for partial updates through field mask. CompliancePostureConfig *CompliancePostureConfig `json:"compliancePostureConfig,omitempty"` - // SecurityPostureConfig: Enable/Disable Security Posture features for the - // cluster. + // SecurityPostureConfig: Optional. Enable/Disable Security Posture features + // for the cluster. SecurityPostureConfig *SecurityPostureConfig `json:"securityPostureConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "BinaryAuthorizationConfig") // to unconditionally include in API requests. By default, fields with empty or @@ -5504,16 +5509,20 @@ type SecurityPostureConfig struct { // "MODE_UNSPECIFIED" - Default value not specified. // "DISABLED" - Disables Security Posture features on the cluster. // "BASIC" - Applies Security Posture features on the cluster. - // "ENTERPRISE" - Applies the Security Posture off cluster Enterprise level - // features. + // "ENTERPRISE" - Deprecated: Security Posture Enterprise features are no + // longer supported. For more details, see + // https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. + // Applies the Security Posture off cluster Enterprise level features. Mode string `json:"mode,omitempty"` // VulnerabilityMode: Sets which mode to use for vulnerability scanning. // // Possible values: // "VULNERABILITY_MODE_UNSPECIFIED" - Default value not specified. // "VULNERABILITY_DISABLED" - Disables vulnerability scanning on the cluster. - // "VULNERABILITY_BASIC" - Applies basic vulnerability scanning on the - // cluster. + // "VULNERABILITY_BASIC" - Deprecated: Basic vulnerability scanning is no + // longer supported. For more details, see + // https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. + // Applies basic vulnerability scanning on the cluster. // "VULNERABILITY_ENTERPRISE" - Applies the Security Posture's vulnerability // on cluster Enterprise level features. VulnerabilityMode string `json:"vulnerabilityMode,omitempty"` diff --git a/gkehub/v1alpha/gkehub-api.json b/gkehub/v1alpha/gkehub-api.json index 96342577ca..f8ba4fa8cc 100644 --- a/gkehub/v1alpha/gkehub-api.json +++ b/gkehub/v1alpha/gkehub-api.json @@ -2498,7 +2498,7 @@ } } }, - "revision": "20260126", + "revision": "20260215", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceFeatureSpec": { @@ -2734,6 +2734,21 @@ "$ref": "ClusterUpgradePostConditions", "description": "Required. Post conditions to evaluate to mark an upgrade COMPLETE. Required." }, + "upgradeEngine": { + "description": "Output only. The effective upgrade engine for the fleet.", + "enum": [ + "UPGRADE_ENGINE_UNSPECIFIED", + "SEQUENCING_V1", + "SEQUENCING_V2" + ], + "enumDescriptions": [ + "Default value.", + "Upgrades are managed using fleet-based rollout sequencing.", + "Upgrades are managed using rollout sequencing with custom stages." + ], + "readOnly": true, + "type": "string" + }, "upstreamFleets": { "description": "This fleet consumes upgrades that have COMPLETE status code in the upstream fleets. See UpgradeStatus.Code for code definitions. The fleet name should be either fleet project number or id. This is defined as repeated for future proof reasons. Initial implementation will enforce at most one upstream fleet.", "items": { @@ -3134,7 +3149,8 @@ "type": "object" }, "CompliancePostureConfig": { - "description": "CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture.", + "deprecated": true, + "description": "Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture.", "id": "CompliancePostureConfig", "properties": { "complianceStandards": { @@ -4300,11 +4316,12 @@ }, "compliancePostureConfig": { "$ref": "CompliancePostureConfig", - "description": "Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask." + "deprecated": true, + "description": "Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask." }, "securityPostureConfig": { "$ref": "SecurityPostureConfig", - "description": "Enable/Disable Security Posture features for the cluster." + "description": "Optional. Enable/Disable Security Posture features for the cluster." } }, "type": "object" @@ -4326,35 +4343,6 @@ "properties": {}, "type": "object" }, - "ExcludedCluster": { - "description": "An excluded cluster from the rollout.", - "id": "ExcludedCluster", - "properties": { - "membership": { - "description": "Output only. The name of the fleet Membership resource associated to the excluded cluster.", - "readOnly": true, - "type": "string" - }, - "reason": { - "description": "Output only. The reason for excluding the cluster from the rollout.", - "enum": [ - "REASON_UNSPECIFIED", - "EXCLUDED_BY_FILTER", - "ALREADY_UPGRADED", - "VERSION_TOO_OLD" - ], - "enumDescriptions": [ - "Default value.", - "The cluster was excluded by the rollout filter.", - "The cluster was already upgraded.", - "The cluster version is too old." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, "Expr": { "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() \u003c 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' \u0026\u0026 document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.", "id": "Expr", @@ -4559,21 +4547,6 @@ }, "type": "object" }, - "FeatureUpdate": { - "description": "Feature config to use for Rollout.", - "id": "FeatureUpdate", - "properties": { - "binaryAuthorizationConfig": { - "$ref": "BinaryAuthorizationConfig", - "description": "Optional. Configuration for Binary Authorization." - }, - "securityPostureConfig": { - "$ref": "SecurityPostureConfig", - "description": "Optional. Configuration for Security Posture." - } - }, - "type": "object" - }, "Fleet": { "description": "Fleet contains the Fleet-wide metadata and configuration.", "id": "Fleet", @@ -7011,18 +6984,6 @@ "readOnly": true, "type": "string" }, - "excludedClusters": { - "description": "Optional. Output only. The excluded clusters from the rollout.", - "items": { - "$ref": "ExcludedCluster" - }, - "readOnly": true, - "type": "array" - }, - "feature": { - "$ref": "FeatureUpdate", - "description": "Optional. Feature config to use for Rollout." - }, "labels": { "additionalProperties": { "type": "string" @@ -7046,11 +7007,6 @@ "description": "Optional. Immutable. The full, unique resource name of the rollout sequence that initiatied this Rollout. In the format of `projects/{project}/locations/global/rolloutSequences/{rollout_sequence}`.", "type": "string" }, - "schedule": { - "$ref": "Schedule", - "description": "Output only. The schedule of the Rollout.", - "readOnly": true - }, "stages": { "description": "Output only. The stages of the Rollout.", "items": { @@ -7066,16 +7022,14 @@ "RUNNING", "PAUSED", "CANCELLED", - "COMPLETED", - "SCHEDULED" + "COMPLETED" ], "enumDescriptions": [ "Unspecified state.", "The Rollout is running.", "The Rollout is paused.", "The Rollout is in a failure terminal state.", - "The Rollout is in a terminal state.", - "The Rollout is scheduled to start." + "The Rollout is in a terminal state." ], "readOnly": true, "type": "string" @@ -7173,6 +7127,11 @@ }, "type": "array" }, + "state": { + "$ref": "RolloutSequenceState", + "description": "Output only. State of the Rollout Sequence as a whole.", + "readOnly": true + }, "uid": { "description": "Output only. Google-generated UUID for this resource. This is unique across all Rollout Sequence resources. If a Rollout Sequence resource is deleted and another resource with the same name is created, it gets a different uid.", "readOnly": true, @@ -7187,6 +7146,54 @@ }, "type": "object" }, + "RolloutSequenceState": { + "description": "State and reasons of the Rollout Sequence.", + "id": "RolloutSequenceState", + "properties": { + "lifecycleState": { + "description": "Output only. Lifecycle state of the Rollout Sequence.", + "enum": [ + "LIFECYCLE_STATE_UNSPECIFIED", + "LIFECYCLE_STATE_ACTIVE", + "LIFECYCLE_STATE_WARNING", + "LIFECYCLE_STATE_ERROR" + ], + "enumDescriptions": [ + "The default value. This value is used if the state is omitted.", + "The Rollout Sequence is active.", + "The Rollout Sequence has warnings.", + "The Rollout Sequence has errors." + ], + "readOnly": true, + "type": "string" + }, + "stateReasons": { + "description": "Output only. StateReason represents the reason for the Rollout Sequence state.", + "items": { + "enum": [ + "STATE_REASON_UNSPECIFIED", + "FLEET_FEATURE_DELETED_ERROR", + "FLEET_DELETED_ERROR", + "EMPTY_STAGE_WARNING", + "MIXED_RELEASE_CHANNELS_WARNING", + "INTERNAL_ERROR" + ], + "enumDescriptions": [ + "Default unspecified value.", + "A fleet feature is deleted.", + "A fleet is deleted.", + "A stage is empty.", + "Mixed release channels in the sequence.", + "Internal error, for example when host project is soft-deleted." + ], + "type": "string" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, "RolloutStage": { "description": "Stage represents a single stage in the Rollout.", "id": "RolloutStage", @@ -7290,21 +7297,6 @@ }, "type": "object" }, - "Schedule": { - "description": "Schedule represents the schedule of the Rollout.", - "id": "Schedule", - "properties": { - "waves": { - "description": "Output only. The schedule of each wave in the Rollout.", - "items": { - "$ref": "WaveSchedule" - }, - "readOnly": true, - "type": "array" - } - }, - "type": "object" - }, "Scope": { "description": "Scope represents a Scope in a Fleet.", "id": "Scope", @@ -7423,11 +7415,17 @@ "BASIC", "ENTERPRISE" ], + "enumDeprecated": [ + false, + false, + false, + true + ], "enumDescriptions": [ "Default value not specified.", "Disables Security Posture features on the cluster.", "Applies Security Posture features on the cluster.", - "Applies the Security Posture off cluster Enterprise level features." + "Deprecated: Security Posture Enterprise features are no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Applies the Security Posture off cluster Enterprise level features." ], "type": "string" }, @@ -7439,10 +7437,16 @@ "VULNERABILITY_BASIC", "VULNERABILITY_ENTERPRISE" ], + "enumDeprecated": [ + false, + false, + true, + false + ], "enumDescriptions": [ "Default value not specified.", "Disables vulnerability scanning on the cluster.", - "Applies basic vulnerability scanning on the cluster.", + "Deprecated: Basic vulnerability scanning is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Applies basic vulnerability scanning on the cluster.", "Applies the Security Posture's vulnerability on cluster Enterprise level features." ], "type": "string" @@ -8250,45 +8254,18 @@ "enum": [ "TYPE_UNSPECIFIED", "TYPE_CONTROL_PLANE", - "TYPE_NODE_POOL", - "TYPE_CONFIG_SYNC" + "TYPE_NODE_POOL" ], "enumDescriptions": [ "Default value.", "Control plane upgrade.", - "Node pool upgrade.", - "Config Sync upgrade." + "Node pool upgrade." ], "type": "string" } }, "type": "object" }, - "WaveSchedule": { - "description": "WaveSchedule represents the schedule of a single rollout wave.", - "id": "WaveSchedule", - "properties": { - "waveEndTime": { - "description": "Output only. The time at which the wave ends.", - "format": "google-datetime", - "readOnly": true, - "type": "string" - }, - "waveNumber": { - "description": "Output only. The wave number to which this schedule applies.", - "format": "int32", - "readOnly": true, - "type": "integer" - }, - "waveStartTime": { - "description": "Output only. The time at which the wave starts.", - "format": "google-datetime", - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, "WorkloadIdentityFeatureSpec": { "description": "**WorkloadIdentity**: Global feature specification.", "id": "WorkloadIdentityFeatureSpec", diff --git a/gkehub/v1alpha/gkehub-gen.go b/gkehub/v1alpha/gkehub-gen.go index 682dccaf0c..d85279a24f 100644 --- a/gkehub/v1alpha/gkehub-gen.go +++ b/gkehub/v1alpha/gkehub-gen.go @@ -751,6 +751,15 @@ type ClusterUpgradeFleetSpec struct { // PostConditions: Required. Post conditions to evaluate to mark an upgrade // COMPLETE. Required. PostConditions *ClusterUpgradePostConditions `json:"postConditions,omitempty"` + // UpgradeEngine: Output only. The effective upgrade engine for the fleet. + // + // Possible values: + // "UPGRADE_ENGINE_UNSPECIFIED" - Default value. + // "SEQUENCING_V1" - Upgrades are managed using fleet-based rollout + // sequencing. + // "SEQUENCING_V2" - Upgrades are managed using rollout sequencing with + // custom stages. + UpgradeEngine string `json:"upgradeEngine,omitempty"` // UpstreamFleets: This fleet consumes upgrades that have COMPLETE status code // in the upstream fleets. See UpgradeStatus.Code for code definitions. The // fleet name should be either fleet project number or id. This is defined as @@ -1263,8 +1272,11 @@ func (s CommonFleetDefaultMemberConfigSpec) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// CompliancePostureConfig: CompliancePostureConfig defines the settings needed -// to enable/disable features for the Compliance Posture. +// CompliancePostureConfig: Deprecated: Compliance Posture is no longer +// supported. For more details, see +// https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. +// CompliancePostureConfig defines the settings needed to enable/disable +// features for the Compliance Posture. type CompliancePostureConfig struct { // ComplianceStandards: List of enabled compliance standards. ComplianceStandards []*ComplianceStandard `json:"complianceStandards,omitempty"` @@ -2510,13 +2522,15 @@ type DefaultClusterConfig struct { // BinaryAuthorizationConfig: Optional. Enable/Disable binary authorization // features for the cluster. BinaryAuthorizationConfig *BinaryAuthorizationConfig `json:"binaryAuthorizationConfig,omitempty"` - // CompliancePostureConfig: Optional. Enable/Disable Compliance Posture - // features for the cluster. Note that on UpdateFleet, only full replacement of - // this field is allowed. Users are not allowed for partial updates through - // field mask. + // CompliancePostureConfig: Optional. Deprecated: Compliance Posture is no + // longer supported. For more details, see + // https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. + // Enable/Disable Compliance Posture features for the cluster. Note that on + // UpdateFleet, only full replacement of this field is allowed. Users are not + // allowed for partial updates through field mask. CompliancePostureConfig *CompliancePostureConfig `json:"compliancePostureConfig,omitempty"` - // SecurityPostureConfig: Enable/Disable Security Posture features for the - // cluster. + // SecurityPostureConfig: Optional. Enable/Disable Security Posture features + // for the cluster. SecurityPostureConfig *SecurityPostureConfig `json:"securityPostureConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "BinaryAuthorizationConfig") // to unconditionally include in API requests. By default, fields with empty or @@ -2571,37 +2585,6 @@ type Empty struct { googleapi.ServerResponse `json:"-"` } -// ExcludedCluster: An excluded cluster from the rollout. -type ExcludedCluster struct { - // Membership: Output only. The name of the fleet Membership resource - // associated to the excluded cluster. - Membership string `json:"membership,omitempty"` - // Reason: Output only. The reason for excluding the cluster from the rollout. - // - // Possible values: - // "REASON_UNSPECIFIED" - Default value. - // "EXCLUDED_BY_FILTER" - The cluster was excluded by the rollout filter. - // "ALREADY_UPGRADED" - The cluster was already upgraded. - // "VERSION_TOO_OLD" - The cluster version is too old. - Reason string `json:"reason,omitempty"` - // ForceSendFields is a list of field names (e.g. "Membership") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Membership") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ExcludedCluster) MarshalJSON() ([]byte, error) { - type NoMethod ExcludedCluster - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Expr: Represents a textual expression in the Common Expression Language // (CEL) syntax. CEL is a C-like expression language. The syntax and semantics // of CEL are documented at https://github.com/google/cel-spec. Example @@ -2850,30 +2833,6 @@ func (s FeatureState) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// FeatureUpdate: Feature config to use for Rollout. -type FeatureUpdate struct { - // BinaryAuthorizationConfig: Optional. Configuration for Binary Authorization. - BinaryAuthorizationConfig *BinaryAuthorizationConfig `json:"binaryAuthorizationConfig,omitempty"` - // SecurityPostureConfig: Optional. Configuration for Security Posture. - SecurityPostureConfig *SecurityPostureConfig `json:"securityPostureConfig,omitempty"` - // ForceSendFields is a list of field names (e.g. "BinaryAuthorizationConfig") - // to unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BinaryAuthorizationConfig") to - // include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s FeatureUpdate) MarshalJSON() ([]byte, error) { - type NoMethod FeatureUpdate - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Fleet: Fleet contains the Fleet-wide metadata and configuration. type Fleet struct { // CreateTime: Output only. When the Fleet was created. @@ -6018,11 +5977,6 @@ type Rollout struct { DisplayName string `json:"displayName,omitempty"` // Etag: Output only. etag of the Rollout Ex. abc1234 Etag string `json:"etag,omitempty"` - // ExcludedClusters: Optional. Output only. The excluded clusters from the - // rollout. - ExcludedClusters []*ExcludedCluster `json:"excludedClusters,omitempty"` - // Feature: Optional. Feature config to use for Rollout. - Feature *FeatureUpdate `json:"feature,omitempty"` // Labels: Optional. Labels for this Rollout. Labels map[string]string `json:"labels,omitempty"` // MembershipStates: Output only. States of upgrading control plane or node @@ -6037,8 +5991,6 @@ type Rollout struct { // rollout sequence that initiatied this Rollout. In the format of // `projects/{project}/locations/global/rolloutSequences/{rollout_sequence}`. RolloutSequence string `json:"rolloutSequence,omitempty"` - // Schedule: Output only. The schedule of the Rollout. - Schedule *Schedule `json:"schedule,omitempty"` // Stages: Output only. The stages of the Rollout. Stages []*RolloutStage `json:"stages,omitempty"` // State: Output only. State specifies various states of the Rollout. @@ -6049,7 +6001,6 @@ type Rollout struct { // "PAUSED" - The Rollout is paused. // "CANCELLED" - The Rollout is in a failure terminal state. // "COMPLETED" - The Rollout is in a terminal state. - // "SCHEDULED" - The Rollout is scheduled to start. State string `json:"state,omitempty"` // StateReason: Output only. A human-readable description explaining the reason // for the current state. @@ -6133,6 +6084,8 @@ type RolloutSequence struct { Name string `json:"name,omitempty"` // Stages: Required. Ordered list of stages that constitutes this Rollout. Stages []*Stage `json:"stages,omitempty"` + // State: Output only. State of the Rollout Sequence as a whole. + State *RolloutSequenceState `json:"state,omitempty"` // Uid: Output only. Google-generated UUID for this resource. This is unique // across all Rollout Sequence resources. If a Rollout Sequence resource is // deleted and another resource with the same name is created, it gets a @@ -6162,6 +6115,47 @@ func (s RolloutSequence) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// RolloutSequenceState: State and reasons of the Rollout Sequence. +type RolloutSequenceState struct { + // LifecycleState: Output only. Lifecycle state of the Rollout Sequence. + // + // Possible values: + // "LIFECYCLE_STATE_UNSPECIFIED" - The default value. This value is used if + // the state is omitted. + // "LIFECYCLE_STATE_ACTIVE" - The Rollout Sequence is active. + // "LIFECYCLE_STATE_WARNING" - The Rollout Sequence has warnings. + // "LIFECYCLE_STATE_ERROR" - The Rollout Sequence has errors. + LifecycleState string `json:"lifecycleState,omitempty"` + // StateReasons: Output only. StateReason represents the reason for the Rollout + // Sequence state. + // + // Possible values: + // "STATE_REASON_UNSPECIFIED" - Default unspecified value. + // "FLEET_FEATURE_DELETED_ERROR" - A fleet feature is deleted. + // "FLEET_DELETED_ERROR" - A fleet is deleted. + // "EMPTY_STAGE_WARNING" - A stage is empty. + // "MIXED_RELEASE_CHANNELS_WARNING" - Mixed release channels in the sequence. + // "INTERNAL_ERROR" - Internal error, for example when host project is + // soft-deleted. + StateReasons []string `json:"stateReasons,omitempty"` + // ForceSendFields is a list of field names (e.g. "LifecycleState") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "LifecycleState") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RolloutSequenceState) MarshalJSON() ([]byte, error) { + type NoMethod RolloutSequenceState + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // RolloutStage: Stage represents a single stage in the Rollout. type RolloutStage struct { // EndTime: Optional. Output only. The time at which the wave ended. @@ -6251,28 +6245,6 @@ func (s RolloutTarget) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Schedule: Schedule represents the schedule of the Rollout. -type Schedule struct { - // Waves: Output only. The schedule of each wave in the Rollout. - Waves []*WaveSchedule `json:"waves,omitempty"` - // ForceSendFields is a list of field names (e.g. "Waves") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Waves") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s Schedule) MarshalJSON() ([]byte, error) { - type NoMethod Schedule - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Scope: Scope represents a Scope in a Fleet. type Scope struct { // CreateTime: Output only. When the scope was created. @@ -6405,16 +6377,20 @@ type SecurityPostureConfig struct { // "MODE_UNSPECIFIED" - Default value not specified. // "DISABLED" - Disables Security Posture features on the cluster. // "BASIC" - Applies Security Posture features on the cluster. - // "ENTERPRISE" - Applies the Security Posture off cluster Enterprise level - // features. + // "ENTERPRISE" - Deprecated: Security Posture Enterprise features are no + // longer supported. For more details, see + // https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. + // Applies the Security Posture off cluster Enterprise level features. Mode string `json:"mode,omitempty"` // VulnerabilityMode: Sets which mode to use for vulnerability scanning. // // Possible values: // "VULNERABILITY_MODE_UNSPECIFIED" - Default value not specified. // "VULNERABILITY_DISABLED" - Disables vulnerability scanning on the cluster. - // "VULNERABILITY_BASIC" - Applies basic vulnerability scanning on the - // cluster. + // "VULNERABILITY_BASIC" - Deprecated: Basic vulnerability scanning is no + // longer supported. For more details, see + // https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. + // Applies basic vulnerability scanning on the cluster. // "VULNERABILITY_ENTERPRISE" - Applies the Security Posture's vulnerability // on cluster Enterprise level features. VulnerabilityMode string `json:"vulnerabilityMode,omitempty"` @@ -7312,7 +7288,6 @@ type VersionUpgrade struct { // "TYPE_UNSPECIFIED" - Default value. // "TYPE_CONTROL_PLANE" - Control plane upgrade. // "TYPE_NODE_POOL" - Node pool upgrade. - // "TYPE_CONFIG_SYNC" - Config Sync upgrade. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "DesiredVersion") to // unconditionally include in API requests. By default, fields with empty or @@ -7332,32 +7307,6 @@ func (s VersionUpgrade) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// WaveSchedule: WaveSchedule represents the schedule of a single rollout wave. -type WaveSchedule struct { - // WaveEndTime: Output only. The time at which the wave ends. - WaveEndTime string `json:"waveEndTime,omitempty"` - // WaveNumber: Output only. The wave number to which this schedule applies. - WaveNumber int64 `json:"waveNumber,omitempty"` - // WaveStartTime: Output only. The time at which the wave starts. - WaveStartTime string `json:"waveStartTime,omitempty"` - // ForceSendFields is a list of field names (e.g. "WaveEndTime") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "WaveEndTime") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s WaveSchedule) MarshalJSON() ([]byte, error) { - type NoMethod WaveSchedule - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // WorkloadIdentityFeatureSpec: **WorkloadIdentity**: Global feature // specification. type WorkloadIdentityFeatureSpec struct { diff --git a/gkehub/v1beta/gkehub-api.json b/gkehub/v1beta/gkehub-api.json index e93e47f8b6..70c7310c04 100644 --- a/gkehub/v1beta/gkehub-api.json +++ b/gkehub/v1beta/gkehub-api.json @@ -2354,7 +2354,7 @@ } } }, - "revision": "20260126", + "revision": "20260215", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceFeatureSpec": { @@ -2874,7 +2874,8 @@ "type": "object" }, "CompliancePostureConfig": { - "description": "CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture.", + "deprecated": true, + "description": "Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture.", "id": "CompliancePostureConfig", "properties": { "complianceStandards": { @@ -4040,11 +4041,12 @@ }, "compliancePostureConfig": { "$ref": "CompliancePostureConfig", - "description": "Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask." + "deprecated": true, + "description": "Optional. Deprecated: Compliance Posture is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask." }, "securityPostureConfig": { "$ref": "SecurityPostureConfig", - "description": "Enable/Disable Security Posture features for the cluster." + "description": "Optional. Enable/Disable Security Posture features for the cluster." } }, "type": "object" @@ -4066,35 +4068,6 @@ "properties": {}, "type": "object" }, - "ExcludedCluster": { - "description": "An excluded cluster from the rollout.", - "id": "ExcludedCluster", - "properties": { - "membership": { - "description": "Output only. The name of the fleet Membership resource associated to the excluded cluster.", - "readOnly": true, - "type": "string" - }, - "reason": { - "description": "Output only. The reason for excluding the cluster from the rollout.", - "enum": [ - "REASON_UNSPECIFIED", - "EXCLUDED_BY_FILTER", - "ALREADY_UPGRADED", - "VERSION_TOO_OLD" - ], - "enumDescriptions": [ - "Default value.", - "The cluster was excluded by the rollout filter.", - "The cluster was already upgraded.", - "The cluster version is too old." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, "Expr": { "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() \u003c 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' \u0026\u0026 document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.", "id": "Expr", @@ -4270,21 +4243,6 @@ }, "type": "object" }, - "FeatureUpdate": { - "description": "Feature config to use for Rollout.", - "id": "FeatureUpdate", - "properties": { - "binaryAuthorizationConfig": { - "$ref": "BinaryAuthorizationConfig", - "description": "Optional. Configuration for Binary Authorization." - }, - "securityPostureConfig": { - "$ref": "SecurityPostureConfig", - "description": "Optional. Configuration for Security Posture." - } - }, - "type": "object" - }, "Fleet": { "description": "Fleet contains the Fleet-wide metadata and configuration.", "id": "Fleet", @@ -6635,18 +6593,6 @@ "readOnly": true, "type": "string" }, - "excludedClusters": { - "description": "Optional. Output only. The excluded clusters from the rollout.", - "items": { - "$ref": "ExcludedCluster" - }, - "readOnly": true, - "type": "array" - }, - "feature": { - "$ref": "FeatureUpdate", - "description": "Optional. Feature config to use for Rollout." - }, "labels": { "additionalProperties": { "type": "string" @@ -6670,11 +6616,6 @@ "description": "Optional. Immutable. The full, unique resource name of the rollout sequence that initiatied this Rollout. In the format of `projects/{project}/locations/global/rolloutSequences/{rollout_sequence}`.", "type": "string" }, - "schedule": { - "$ref": "Schedule", - "description": "Output only. The schedule of the Rollout.", - "readOnly": true - }, "stages": { "description": "Output only. The stages of the Rollout.", "items": { @@ -6690,16 +6631,14 @@ "RUNNING", "PAUSED", "CANCELLED", - "COMPLETED", - "SCHEDULED" + "COMPLETED" ], "enumDescriptions": [ "Unspecified state.", "The Rollout is running.", "The Rollout is paused.", "The Rollout is in a failure terminal state.", - "The Rollout is in a terminal state.", - "The Rollout is scheduled to start." + "The Rollout is in a terminal state." ], "readOnly": true, "type": "string" @@ -6797,6 +6736,11 @@ }, "type": "array" }, + "state": { + "$ref": "RolloutSequenceState", + "description": "Output only. State of the Rollout Sequence as a whole.", + "readOnly": true + }, "uid": { "description": "Output only. Google-generated UUID for this resource. This is unique across all Rollout Sequence resources. If a Rollout Sequence resource is deleted and another resource with the same name is created, it gets a different uid.", "readOnly": true, @@ -6811,6 +6755,54 @@ }, "type": "object" }, + "RolloutSequenceState": { + "description": "State and reasons of the Rollout Sequence.", + "id": "RolloutSequenceState", + "properties": { + "lifecycleState": { + "description": "Output only. Lifecycle state of the Rollout Sequence.", + "enum": [ + "LIFECYCLE_STATE_UNSPECIFIED", + "LIFECYCLE_STATE_ACTIVE", + "LIFECYCLE_STATE_WARNING", + "LIFECYCLE_STATE_ERROR" + ], + "enumDescriptions": [ + "The default value. This value is used if the state is omitted.", + "The Rollout Sequence is active.", + "The Rollout Sequence has warnings.", + "The Rollout Sequence has errors." + ], + "readOnly": true, + "type": "string" + }, + "stateReasons": { + "description": "Output only. StateReason represents the reason for the Rollout Sequence state.", + "items": { + "enum": [ + "STATE_REASON_UNSPECIFIED", + "FLEET_FEATURE_DELETED_ERROR", + "FLEET_DELETED_ERROR", + "EMPTY_STAGE_WARNING", + "MIXED_RELEASE_CHANNELS_WARNING", + "INTERNAL_ERROR" + ], + "enumDescriptions": [ + "Default unspecified value.", + "A fleet feature is deleted.", + "A fleet is deleted.", + "A stage is empty.", + "Mixed release channels in the sequence.", + "Internal error, for example when host project is soft-deleted." + ], + "type": "string" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, "RolloutStage": { "description": "Stage represents a single stage in the Rollout.", "id": "RolloutStage", @@ -6914,21 +6906,6 @@ }, "type": "object" }, - "Schedule": { - "description": "Schedule represents the schedule of the Rollout.", - "id": "Schedule", - "properties": { - "waves": { - "description": "Output only. The schedule of each wave in the Rollout.", - "items": { - "$ref": "WaveSchedule" - }, - "readOnly": true, - "type": "array" - } - }, - "type": "object" - }, "Scope": { "description": "Scope represents a Scope in a Fleet.", "id": "Scope", @@ -7038,11 +7015,17 @@ "BASIC", "ENTERPRISE" ], + "enumDeprecated": [ + false, + false, + false, + true + ], "enumDescriptions": [ "Default value not specified.", "Disables Security Posture features on the cluster.", "Applies Security Posture features on the cluster.", - "Applies the Security Posture off cluster Enterprise level features." + "Deprecated: Security Posture Enterprise features are no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Applies the Security Posture off cluster Enterprise level features." ], "type": "string" }, @@ -7054,10 +7037,16 @@ "VULNERABILITY_BASIC", "VULNERABILITY_ENTERPRISE" ], + "enumDeprecated": [ + false, + false, + true, + false + ], "enumDescriptions": [ "Default value not specified.", "Disables vulnerability scanning on the cluster.", - "Applies basic vulnerability scanning on the cluster.", + "Deprecated: Basic vulnerability scanning is no longer supported. For more details, see https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. Applies basic vulnerability scanning on the cluster.", "Applies the Security Posture's vulnerability on cluster Enterprise level features." ], "type": "string" @@ -7521,45 +7510,18 @@ "enum": [ "TYPE_UNSPECIFIED", "TYPE_CONTROL_PLANE", - "TYPE_NODE_POOL", - "TYPE_CONFIG_SYNC" + "TYPE_NODE_POOL" ], "enumDescriptions": [ "Default value.", "Control plane upgrade.", - "Node pool upgrade.", - "Config Sync upgrade." + "Node pool upgrade." ], "type": "string" } }, "type": "object" }, - "WaveSchedule": { - "description": "WaveSchedule represents the schedule of a single rollout wave.", - "id": "WaveSchedule", - "properties": { - "waveEndTime": { - "description": "Output only. The time at which the wave ends.", - "format": "google-datetime", - "readOnly": true, - "type": "string" - }, - "waveNumber": { - "description": "Output only. The wave number to which this schedule applies.", - "format": "int32", - "readOnly": true, - "type": "integer" - }, - "waveStartTime": { - "description": "Output only. The time at which the wave starts.", - "format": "google-datetime", - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, "WorkloadIdentityFeatureSpec": { "description": "**WorkloadIdentity**: Global feature specification.", "id": "WorkloadIdentityFeatureSpec", diff --git a/gkehub/v1beta/gkehub-gen.go b/gkehub/v1beta/gkehub-gen.go index 51e4b26d66..7b5259e564 100644 --- a/gkehub/v1beta/gkehub-gen.go +++ b/gkehub/v1beta/gkehub-gen.go @@ -1124,8 +1124,11 @@ func (s CommonFleetDefaultMemberConfigSpec) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// CompliancePostureConfig: CompliancePostureConfig defines the settings needed -// to enable/disable features for the Compliance Posture. +// CompliancePostureConfig: Deprecated: Compliance Posture is no longer +// supported. For more details, see +// https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. +// CompliancePostureConfig defines the settings needed to enable/disable +// features for the Compliance Posture. type CompliancePostureConfig struct { // ComplianceStandards: List of enabled compliance standards. ComplianceStandards []*ComplianceStandard `json:"complianceStandards,omitempty"` @@ -2371,13 +2374,15 @@ type DefaultClusterConfig struct { // BinaryAuthorizationConfig: Optional. Enable/Disable binary authorization // features for the cluster. BinaryAuthorizationConfig *BinaryAuthorizationConfig `json:"binaryAuthorizationConfig,omitempty"` - // CompliancePostureConfig: Optional. Enable/Disable Compliance Posture - // features for the cluster. Note that on UpdateFleet, only full replacement of - // this field is allowed. Users are not allowed for partial updates through - // field mask. + // CompliancePostureConfig: Optional. Deprecated: Compliance Posture is no + // longer supported. For more details, see + // https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. + // Enable/Disable Compliance Posture features for the cluster. Note that on + // UpdateFleet, only full replacement of this field is allowed. Users are not + // allowed for partial updates through field mask. CompliancePostureConfig *CompliancePostureConfig `json:"compliancePostureConfig,omitempty"` - // SecurityPostureConfig: Enable/Disable Security Posture features for the - // cluster. + // SecurityPostureConfig: Optional. Enable/Disable Security Posture features + // for the cluster. SecurityPostureConfig *SecurityPostureConfig `json:"securityPostureConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "BinaryAuthorizationConfig") // to unconditionally include in API requests. By default, fields with empty or @@ -2432,37 +2437,6 @@ type Empty struct { googleapi.ServerResponse `json:"-"` } -// ExcludedCluster: An excluded cluster from the rollout. -type ExcludedCluster struct { - // Membership: Output only. The name of the fleet Membership resource - // associated to the excluded cluster. - Membership string `json:"membership,omitempty"` - // Reason: Output only. The reason for excluding the cluster from the rollout. - // - // Possible values: - // "REASON_UNSPECIFIED" - Default value. - // "EXCLUDED_BY_FILTER" - The cluster was excluded by the rollout filter. - // "ALREADY_UPGRADED" - The cluster was already upgraded. - // "VERSION_TOO_OLD" - The cluster version is too old. - Reason string `json:"reason,omitempty"` - // ForceSendFields is a list of field names (e.g. "Membership") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Membership") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ExcludedCluster) MarshalJSON() ([]byte, error) { - type NoMethod ExcludedCluster - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Expr: Represents a textual expression in the Common Expression Language // (CEL) syntax. CEL is a C-like expression language. The syntax and semantics // of CEL are documented at https://github.com/google/cel-spec. Example @@ -2674,30 +2648,6 @@ func (s FeatureState) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// FeatureUpdate: Feature config to use for Rollout. -type FeatureUpdate struct { - // BinaryAuthorizationConfig: Optional. Configuration for Binary Authorization. - BinaryAuthorizationConfig *BinaryAuthorizationConfig `json:"binaryAuthorizationConfig,omitempty"` - // SecurityPostureConfig: Optional. Configuration for Security Posture. - SecurityPostureConfig *SecurityPostureConfig `json:"securityPostureConfig,omitempty"` - // ForceSendFields is a list of field names (e.g. "BinaryAuthorizationConfig") - // to unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BinaryAuthorizationConfig") to - // include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s FeatureUpdate) MarshalJSON() ([]byte, error) { - type NoMethod FeatureUpdate - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Fleet: Fleet contains the Fleet-wide metadata and configuration. type Fleet struct { // CreateTime: Output only. When the Fleet was created. @@ -5726,11 +5676,6 @@ type Rollout struct { DisplayName string `json:"displayName,omitempty"` // Etag: Output only. etag of the Rollout Ex. abc1234 Etag string `json:"etag,omitempty"` - // ExcludedClusters: Optional. Output only. The excluded clusters from the - // rollout. - ExcludedClusters []*ExcludedCluster `json:"excludedClusters,omitempty"` - // Feature: Optional. Feature config to use for Rollout. - Feature *FeatureUpdate `json:"feature,omitempty"` // Labels: Optional. Labels for this Rollout. Labels map[string]string `json:"labels,omitempty"` // MembershipStates: Output only. States of upgrading control plane or node @@ -5745,8 +5690,6 @@ type Rollout struct { // rollout sequence that initiatied this Rollout. In the format of // `projects/{project}/locations/global/rolloutSequences/{rollout_sequence}`. RolloutSequence string `json:"rolloutSequence,omitempty"` - // Schedule: Output only. The schedule of the Rollout. - Schedule *Schedule `json:"schedule,omitempty"` // Stages: Output only. The stages of the Rollout. Stages []*RolloutStage `json:"stages,omitempty"` // State: Output only. State specifies various states of the Rollout. @@ -5757,7 +5700,6 @@ type Rollout struct { // "PAUSED" - The Rollout is paused. // "CANCELLED" - The Rollout is in a failure terminal state. // "COMPLETED" - The Rollout is in a terminal state. - // "SCHEDULED" - The Rollout is scheduled to start. State string `json:"state,omitempty"` // StateReason: Output only. A human-readable description explaining the reason // for the current state. @@ -5841,6 +5783,8 @@ type RolloutSequence struct { Name string `json:"name,omitempty"` // Stages: Required. Ordered list of stages that constitutes this Rollout. Stages []*Stage `json:"stages,omitempty"` + // State: Output only. State of the Rollout Sequence as a whole. + State *RolloutSequenceState `json:"state,omitempty"` // Uid: Output only. Google-generated UUID for this resource. This is unique // across all Rollout Sequence resources. If a Rollout Sequence resource is // deleted and another resource with the same name is created, it gets a @@ -5870,6 +5814,47 @@ func (s RolloutSequence) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// RolloutSequenceState: State and reasons of the Rollout Sequence. +type RolloutSequenceState struct { + // LifecycleState: Output only. Lifecycle state of the Rollout Sequence. + // + // Possible values: + // "LIFECYCLE_STATE_UNSPECIFIED" - The default value. This value is used if + // the state is omitted. + // "LIFECYCLE_STATE_ACTIVE" - The Rollout Sequence is active. + // "LIFECYCLE_STATE_WARNING" - The Rollout Sequence has warnings. + // "LIFECYCLE_STATE_ERROR" - The Rollout Sequence has errors. + LifecycleState string `json:"lifecycleState,omitempty"` + // StateReasons: Output only. StateReason represents the reason for the Rollout + // Sequence state. + // + // Possible values: + // "STATE_REASON_UNSPECIFIED" - Default unspecified value. + // "FLEET_FEATURE_DELETED_ERROR" - A fleet feature is deleted. + // "FLEET_DELETED_ERROR" - A fleet is deleted. + // "EMPTY_STAGE_WARNING" - A stage is empty. + // "MIXED_RELEASE_CHANNELS_WARNING" - Mixed release channels in the sequence. + // "INTERNAL_ERROR" - Internal error, for example when host project is + // soft-deleted. + StateReasons []string `json:"stateReasons,omitempty"` + // ForceSendFields is a list of field names (e.g. "LifecycleState") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "LifecycleState") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RolloutSequenceState) MarshalJSON() ([]byte, error) { + type NoMethod RolloutSequenceState + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // RolloutStage: Stage represents a single stage in the Rollout. type RolloutStage struct { // EndTime: Optional. Output only. The time at which the wave ended. @@ -5959,28 +5944,6 @@ func (s RolloutTarget) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Schedule: Schedule represents the schedule of the Rollout. -type Schedule struct { - // Waves: Output only. The schedule of each wave in the Rollout. - Waves []*WaveSchedule `json:"waves,omitempty"` - // ForceSendFields is a list of field names (e.g. "Waves") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Waves") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s Schedule) MarshalJSON() ([]byte, error) { - type NoMethod Schedule - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Scope: Scope represents a Scope in a Fleet. type Scope struct { // CreateTime: Output only. When the scope was created. @@ -6093,16 +6056,20 @@ type SecurityPostureConfig struct { // "MODE_UNSPECIFIED" - Default value not specified. // "DISABLED" - Disables Security Posture features on the cluster. // "BASIC" - Applies Security Posture features on the cluster. - // "ENTERPRISE" - Applies the Security Posture off cluster Enterprise level - // features. + // "ENTERPRISE" - Deprecated: Security Posture Enterprise features are no + // longer supported. For more details, see + // https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. + // Applies the Security Posture off cluster Enterprise level features. Mode string `json:"mode,omitempty"` // VulnerabilityMode: Sets which mode to use for vulnerability scanning. // // Possible values: // "VULNERABILITY_MODE_UNSPECIFIED" - Default value not specified. // "VULNERABILITY_DISABLED" - Disables vulnerability scanning on the cluster. - // "VULNERABILITY_BASIC" - Applies basic vulnerability scanning on the - // cluster. + // "VULNERABILITY_BASIC" - Deprecated: Basic vulnerability scanning is no + // longer supported. For more details, see + // https://cloud.google.com/kubernetes-engine/docs/deprecations/posture-management-deprecation. + // Applies basic vulnerability scanning on the cluster. // "VULNERABILITY_ENTERPRISE" - Applies the Security Posture's vulnerability // on cluster Enterprise level features. VulnerabilityMode string `json:"vulnerabilityMode,omitempty"` @@ -6617,7 +6584,6 @@ type VersionUpgrade struct { // "TYPE_UNSPECIFIED" - Default value. // "TYPE_CONTROL_PLANE" - Control plane upgrade. // "TYPE_NODE_POOL" - Node pool upgrade. - // "TYPE_CONFIG_SYNC" - Config Sync upgrade. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "DesiredVersion") to // unconditionally include in API requests. By default, fields with empty or @@ -6637,32 +6603,6 @@ func (s VersionUpgrade) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// WaveSchedule: WaveSchedule represents the schedule of a single rollout wave. -type WaveSchedule struct { - // WaveEndTime: Output only. The time at which the wave ends. - WaveEndTime string `json:"waveEndTime,omitempty"` - // WaveNumber: Output only. The wave number to which this schedule applies. - WaveNumber int64 `json:"waveNumber,omitempty"` - // WaveStartTime: Output only. The time at which the wave starts. - WaveStartTime string `json:"waveStartTime,omitempty"` - // ForceSendFields is a list of field names (e.g. "WaveEndTime") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "WaveEndTime") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s WaveSchedule) MarshalJSON() ([]byte, error) { - type NoMethod WaveSchedule - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // WorkloadIdentityFeatureSpec: **WorkloadIdentity**: Global feature // specification. type WorkloadIdentityFeatureSpec struct { diff --git a/go.mod b/go.mod index 4d0331f5b3..b425f82edb 100644 --- a/go.mod +++ b/go.mod @@ -1,6 +1,6 @@ module google.golang.org/api -go 1.24.0 +go 1.25.0 retract v0.258.0 // due to https://github.com/googleapis/google-cloud-go/issues/13503 diff --git a/go.work b/go.work index 52540bd418..029212a8d2 100644 --- a/go.work +++ b/go.work @@ -1,4 +1,4 @@ -go 1.24.0 +go 1.25.0 use ( . diff --git a/healthcare/v1/healthcare-api.json b/healthcare/v1/healthcare-api.json index 9cc39a8452..7a49d11f26 100644 --- a/healthcare/v1/healthcare-api.json +++ b/healthcare/v1/healthcare-api.json @@ -139,7 +139,7 @@ ] }, "list": { - "description": "Lists information about the supported locations for this service.", + "description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "healthcare.projects.locations.list", @@ -3100,6 +3100,35 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "bulkDelete": { + "description": "Bulk deletes the FHIR resources from the given FHIR store. This method returns an Operation that can be used to track the progress of the deletion by calling GetOperation. The success and secondary_success counters correspond to the deleted current version and historical versions, respectively.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/fhirStores/{fhirStoresId}:bulkDelete", + "httpMethod": "POST", + "id": "healthcare.projects.locations.datasets.fhirStores.bulkDelete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the FHIR store to bulk delete resources from, in the format of `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/fhirStores/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:bulkDelete", + "request": { + "$ref": "BulkDeleteResourcesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-healthcare", + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "create": { "description": "Creates a new FHIR store within the parent dataset.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/fhirStores", @@ -5142,7 +5171,7 @@ } } }, - "revision": "20251211", + "revision": "20260128", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "AccessDeterminationLogConfig": { @@ -5584,6 +5613,41 @@ }, "type": "object" }, + "BulkDeleteResourcesRequest": { + "description": "Request to bulk delete FHIR resources.", + "id": "BulkDeleteResourcesRequest", + "properties": { + "gcsDestination": { + "$ref": "GoogleCloudHealthcareV1FhirGcsDestination", + "description": "Optional. The Cloud Storage output destination. The Healthcare Service Agent account requires the `roles/storage.objectAdmin` role on the Cloud Storage location. The deleted resources outputs are organized by FHIR resource types. The server creates one or more objects per resource type. Each object contains newline delimited strings in the format {resourceType}/{resourceId}." + }, + "type": { + "description": "Optional. String of comma-delimited FHIR resource types. If provided, only resources of the specified resource type(s) will be deleted.", + "type": "string" + }, + "until": { + "description": "Optional. If provided, only resources updated before or atthis time are deleted. The time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz. For example, `2015-02-07T13:28:17.239+02:00` or `2017-01-01T00:00:00Z`. The time must be specified to the second and include a time zone.", + "type": "string" + }, + "versionConfig": { + "description": "Optional. Specifies which version of the resources to delete.", + "enum": [ + "VERSION_CONFIG_UNSPECIFIED", + "ALL", + "CURRENT_ONLY", + "HISTORY_ONLY" + ], + "enumDescriptions": [ + "Unspecified version config. Defaults to ALL.", + "Delete the current version and all history versions.", + "Delete the current version only and create a historical version of the deleted resource.", + "Delete all history versions only." + ], + "type": "string" + } + }, + "type": "object" + }, "BulkExportGcsDestination": { "description": "The configuration for exporting to Cloud Storage using the bulk export API.", "id": "BulkExportGcsDestination", @@ -6087,7 +6151,7 @@ "description": "Deidentify configuration. Only one of `config` and `gcs_config_uri` can be specified." }, "destinationStore": { - "description": "Required. The name of the DICOM store to create and write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomStores/{dicom_store_id}`. * The destination dataset must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The destination DICOM store must not exist. * The caller must have the necessary permissions to create the destination DICOM store.", + "description": "Required. The name of the DICOM store to write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomStores/{dicom_store_id}`. * The destination dataset and DICOM store must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The caller must have the healthcare.dicomStores.dicomWebWrite permission to write to the destination DICOM store.", "type": "string" }, "filterConfig": { @@ -6110,7 +6174,7 @@ "description": "Deidentify configuration. Only one of `config` and `gcs_config_uri` can be specified." }, "destinationStore": { - "description": "Required. The name of the FHIR store to create and write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`. * The destination dataset must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The destination FHIR store must exist. * The caller must have the healthcare.fhirResources.update permission to write to the destination FHIR store.", + "description": "Required. The name of the FHIR store to write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`. * The destination dataset and FHIR store must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The caller must have the healthcare.fhirResources.update permission to write to the destination FHIR store.", "type": "string" }, "gcsConfigUri": { @@ -7073,7 +7137,7 @@ "id": "GoogleCloudHealthcareV1DicomGcsDestination", "properties": { "mimeType": { - "description": "MIME types supported by DICOM spec. Each file is written in the following format: `.../{study_id}/{series_id}/{instance_id}[/{frame_number}].{extension}` The frame_number component exists only for multi-frame instances. Supported MIME types are consistent with supported formats in DICOMweb: https://cloud.google.com/healthcare/docs/dicom#retrieve_transaction. Specifically, the following are supported: - application/dicom; transfer-syntax=1.2.840.10008.1.2.1 (uncompressed DICOM) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.50 (DICOM with embedded JPEG Baseline) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.90 (DICOM with embedded JPEG 2000 Lossless Only) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.91 (DICOM with embedded JPEG 2000) - application/dicom; transfer-syntax=* (DICOM with no transcoding) - application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1 (raw uncompressed PixelData) - application/octet-stream; transfer-syntax=* (raw PixelData in whatever format it was uploaded in) - image/jpeg; transfer-syntax=1.2.840.10008.1.2.4.50 (Consumer JPEG) - image/png The following extensions are used for output files: - application/dicom -\u003e .dcm - image/jpeg -\u003e .jpg - image/png -\u003e .png - application/octet-stream -\u003e no extension If unspecified, the instances are exported in the original DICOM format they were uploaded in.", + "description": "MIME types supported by DICOM spec. Each file is written in the following format: `.../{study_id}/{series_id}/{instance_id}[/{frame_number}].{extension}` The frame_number component exists only for multi-frame instances. Supported MIME types are consistent with supported formats in DICOMweb: https://cloud.google.com/healthcare/docs/dicom#retrieve_transaction. Specifically, the following are supported: - application/dicom; transfer-syntax=1.2.840.10008.1.2 (DICOM Implicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.1 (DICOM Explicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.1.99 (DICOM Deflated Explicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.50 (DICOM with embedded JPEG Baseline) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.51 (DICOM with embedded JPEG Extended) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.57 (DICOM with embedded JPEG Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.70 (DICOM with embedded JPEG Lossless First-Order Prediction) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.80 (DICOM with embedded JPEG-LS Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.81 (DICOM with embedded JPEG-LS Lossy (Near-Lossless)) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.90 (DICOM with embedded JPEG 2000 Lossless Only) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.91 (DICOM with embedded JPEG 2000) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.110 (DICOM with embedded JPEG XL Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.111 (DICOM with embedded JPEG XL JPEG Recompression) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.112 (DICOM with embedded JPEG XL) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.201 (DICOM with embedded High-Throughput JPEG 2000 Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.202 (DICOM with embedded High-Throughput JPEG 2000 with RPCL Options Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.203 (DICOM with embedded High-Throughput JPEG 2000) - application/dicom; transfer-syntax=1.2.840.10008.1.2.5 (DICOM with embedded RLE Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.8.1 (DICOM with embedded Deflated Image Frame Compression) - application/dicom; transfer-syntax=* (DICOM with no transcoding) - application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1 (raw uncompressed PixelData) - application/octet-stream; transfer-syntax=* (raw PixelData in whatever format it was uploaded in) - image/jpeg; transfer-syntax=1.2.840.10008.1.2.4.50 (Consumer JPEG) - image/png The following extensions are used for output files: - application/dicom -\u003e .dcm - image/jpeg -\u003e .jpg - image/png -\u003e .png - application/octet-stream -\u003e no extension If unspecified, the instances are exported in the original DICOM format they were uploaded in.", "type": "string" }, "uriPrefix": { diff --git a/healthcare/v1/healthcare-gen.go b/healthcare/v1/healthcare-gen.go index 7f578201b3..1ceefcda45 100644 --- a/healthcare/v1/healthcare-gen.go +++ b/healthcare/v1/healthcare-gen.go @@ -1201,6 +1201,51 @@ func (s BlobStorageSettings) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// BulkDeleteResourcesRequest: Request to bulk delete FHIR resources. +type BulkDeleteResourcesRequest struct { + // GcsDestination: Optional. The Cloud Storage output destination. The + // Healthcare Service Agent account requires the `roles/storage.objectAdmin` + // role on the Cloud Storage location. The deleted resources outputs are + // organized by FHIR resource types. The server creates one or more objects per + // resource type. Each object contains newline delimited strings in the format + // {resourceType}/{resourceId}. + GcsDestination *GoogleCloudHealthcareV1FhirGcsDestination `json:"gcsDestination,omitempty"` + // Type: Optional. String of comma-delimited FHIR resource types. If provided, + // only resources of the specified resource type(s) will be deleted. + Type string `json:"type,omitempty"` + // Until: Optional. If provided, only resources updated before or atthis time + // are deleted. The time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz. For + // example, `2015-02-07T13:28:17.239+02:00` or `2017-01-01T00:00:00Z`. The time + // must be specified to the second and include a time zone. + Until string `json:"until,omitempty"` + // VersionConfig: Optional. Specifies which version of the resources to delete. + // + // Possible values: + // "VERSION_CONFIG_UNSPECIFIED" - Unspecified version config. Defaults to + // ALL. + // "ALL" - Delete the current version and all history versions. + // "CURRENT_ONLY" - Delete the current version only and create a historical + // version of the deleted resource. + // "HISTORY_ONLY" - Delete all history versions only. + VersionConfig string `json:"versionConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "GcsDestination") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "GcsDestination") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s BulkDeleteResourcesRequest) MarshalJSON() ([]byte, error) { + type NoMethod BulkDeleteResourcesRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // BulkExportGcsDestination: The configuration for exporting to Cloud Storage // using the bulk export API. type BulkExportGcsDestination struct { @@ -1955,14 +2000,14 @@ type DeidentifyDicomStoreRequest struct { // Config: Deidentify configuration. Only one of `config` and `gcs_config_uri` // can be specified. Config *DeidentifyConfig `json:"config,omitempty"` - // DestinationStore: Required. The name of the DICOM store to create and write - // the redacted data to. For example, + // DestinationStore: Required. The name of the DICOM store to write the + // redacted data to. For example, // `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomSto - // res/{dicom_store_id}`. * The destination dataset must exist. * The source - // dataset and destination dataset must both reside in the same location. - // De-identifying data across multiple locations is not supported. * The - // destination DICOM store must not exist. * The caller must have the necessary - // permissions to create the destination DICOM store. + // res/{dicom_store_id}`. * The destination dataset and DICOM store must exist. + // * The source dataset and destination dataset must both reside in the same + // location. De-identifying data across multiple locations is not supported. * + // The caller must have the healthcare.dicomStores.dicomWebWrite permission to + // write to the destination DICOM store. DestinationStore string `json:"destinationStore,omitempty"` // FilterConfig: Filter configuration. FilterConfig *DicomFilterConfig `json:"filterConfig,omitempty"` @@ -1997,15 +2042,14 @@ type DeidentifyFhirStoreRequest struct { // Config: Deidentify configuration. Only one of `config` and `gcs_config_uri` // can be specified. Config *DeidentifyConfig `json:"config,omitempty"` - // DestinationStore: Required. The name of the FHIR store to create and write - // the redacted data to. For example, + // DestinationStore: Required. The name of the FHIR store to write the redacted + // data to. For example, // `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStor - // es/{fhir_store_id}`. * The destination dataset must exist. * The source - // dataset and destination dataset must both reside in the same location. - // De-identifying data across multiple locations is not supported. * The - // destination FHIR store must exist. * The caller must have the - // healthcare.fhirResources.update permission to write to the destination FHIR - // store. + // es/{fhir_store_id}`. * The destination dataset and FHIR store must exist. * + // The source dataset and destination dataset must both reside in the same + // location. De-identifying data across multiple locations is not supported. * + // The caller must have the healthcare.fhirResources.update permission to write + // to the destination FHIR store. DestinationStore string `json:"destinationStore,omitempty"` // GcsConfigUri: Cloud Storage location to read the JSON // cloud.healthcare.deidentify.DeidentifyConfig from, overriding the default @@ -3491,16 +3535,38 @@ type GoogleCloudHealthcareV1DicomGcsDestination struct { // types are consistent with supported formats in DICOMweb: // https://cloud.google.com/healthcare/docs/dicom#retrieve_transaction. // Specifically, the following are supported: - application/dicom; - // transfer-syntax=1.2.840.10008.1.2.1 (uncompressed DICOM) - - // application/dicom; transfer-syntax=1.2.840.10008.1.2.4.50 (DICOM with - // embedded JPEG Baseline) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2 (DICOM Implicit VR Little Endian) - + // application/dicom; transfer-syntax=1.2.840.10008.1.2.1 (DICOM Explicit VR + // Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.1.99 + // (DICOM Deflated Explicit VR Little Endian) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2.4.50 (DICOM with embedded JPEG Baseline) - + // application/dicom; transfer-syntax=1.2.840.10008.1.2.4.51 (DICOM with + // embedded JPEG Extended) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2.4.57 (DICOM with embedded JPEG Lossless) - + // application/dicom; transfer-syntax=1.2.840.10008.1.2.4.70 (DICOM with + // embedded JPEG Lossless First-Order Prediction) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2.4.80 (DICOM with embedded JPEG-LS + // Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.81 (DICOM + // with embedded JPEG-LS Lossy (Near-Lossless)) - application/dicom; // transfer-syntax=1.2.840.10008.1.2.4.90 (DICOM with embedded JPEG 2000 // Lossless Only) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.91 - // (DICOM with embedded JPEG 2000) - application/dicom; transfer-syntax=* - // (DICOM with no transcoding) - application/octet-stream; - // transfer-syntax=1.2.840.10008.1.2.1 (raw uncompressed PixelData) - - // application/octet-stream; transfer-syntax=* (raw PixelData in whatever - // format it was uploaded in) - image/jpeg; + // (DICOM with embedded JPEG 2000) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2.4.110 (DICOM with embedded JPEG XL + // Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.111 + // (DICOM with embedded JPEG XL JPEG Recompression) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2.4.112 (DICOM with embedded JPEG XL) - + // application/dicom; transfer-syntax=1.2.840.10008.1.2.4.201 (DICOM with + // embedded High-Throughput JPEG 2000 Lossless) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2.4.202 (DICOM with embedded High-Throughput + // JPEG 2000 with RPCL Options Lossless) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2.4.203 (DICOM with embedded High-Throughput + // JPEG 2000) - application/dicom; transfer-syntax=1.2.840.10008.1.2.5 (DICOM + // with embedded RLE Lossless) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2.8.1 (DICOM with embedded Deflated Image + // Frame Compression) - application/dicom; transfer-syntax=* (DICOM with no + // transcoding) - application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1 + // (raw uncompressed PixelData) - application/octet-stream; transfer-syntax=* + // (raw PixelData in whatever format it was uploaded in) - image/jpeg; // transfer-syntax=1.2.840.10008.1.2.4.50 (Consumer JPEG) - image/png The // following extensions are used for output files: - application/dicom -> .dcm // - image/jpeg -> .jpg - image/png -> .png - application/octet-stream -> no @@ -6670,7 +6736,11 @@ type ProjectsLocationsListCall struct { header_ http.Header } -// List: Lists information about the supported locations for this service. +// List: Lists information about the supported locations for this service. This +// method can be called in two ways: * **List all public locations:** Use the +// path `GET /v1/locations`. * **List project-visible locations:** Use the path +// `GET /v1/projects/{project_id}/locations`. This may include public locations +// as well as private or other locations specifically visible to the project. // // - name: The resource that owns the locations collection, if applicable. func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { @@ -16881,6 +16951,116 @@ func (c *ProjectsLocationsDatasetsFhirStoresBulkExportGroupCall) Do(opts ...goog return c.doRequest("") } +type ProjectsLocationsDatasetsFhirStoresBulkDeleteCall struct { + s *Service + name string + bulkdeleteresourcesrequest *BulkDeleteResourcesRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// BulkDelete: Bulk deletes the FHIR resources from the given FHIR store. This +// method returns an Operation that can be used to track the progress of the +// deletion by calling GetOperation. The success and secondary_success counters +// correspond to the deleted current version and historical versions, +// respectively. +// +// - name: The name of the FHIR store to bulk delete resources from, in the +// format of +// `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirSt +// ores/{fhir_store_id}`. +func (r *ProjectsLocationsDatasetsFhirStoresService) BulkDelete(name string, bulkdeleteresourcesrequest *BulkDeleteResourcesRequest) *ProjectsLocationsDatasetsFhirStoresBulkDeleteCall { + c := &ProjectsLocationsDatasetsFhirStoresBulkDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.bulkdeleteresourcesrequest = bulkdeleteresourcesrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsDatasetsFhirStoresBulkDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsDatasetsFhirStoresBulkDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsDatasetsFhirStoresBulkDeleteCall) Context(ctx context.Context) *ProjectsLocationsDatasetsFhirStoresBulkDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsDatasetsFhirStoresBulkDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDatasetsFhirStoresBulkDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.bulkdeleteresourcesrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:bulkDelete") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "healthcare.projects.locations.datasets.fhirStores.bulkDelete", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "healthcare.projects.locations.datasets.fhirStores.bulkDelete" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsDatasetsFhirStoresBulkDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "healthcare.projects.locations.datasets.fhirStores.bulkDelete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsDatasetsFhirStoresCreateCall struct { s *Service parent string diff --git a/healthcare/v1beta1/healthcare-api.json b/healthcare/v1beta1/healthcare-api.json index 193692772d..4a8a716333 100644 --- a/healthcare/v1beta1/healthcare-api.json +++ b/healthcare/v1beta1/healthcare-api.json @@ -139,7 +139,7 @@ ] }, "list": { - "description": "Lists information about the supported locations for this service.", + "description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1beta1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "healthcare.projects.locations.list", @@ -3285,6 +3285,35 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "bulkDelete": { + "description": "Bulk deletes the FHIR resources from the given FHIR store. This method returns an Operation that can be used to track the progress of the deletion by calling GetOperation. The success and secondary_success counters correspond to the deleted current version and historical versions, respectively.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/fhirStores/{fhirStoresId}:bulkDelete", + "httpMethod": "POST", + "id": "healthcare.projects.locations.datasets.fhirStores.bulkDelete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the FHIR store to bulk delete resources from, in the format of `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/fhirStores/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}:bulkDelete", + "request": { + "$ref": "BulkDeleteResourcesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-healthcare", + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "configureSearch": { "description": "Configure the search parameters for the FHIR store and reindex resources in the FHIR store according to the defined search parameters. The search parameters provided in this request will replace any previous search configuration. The target SearchParameter resources need to exist in the store before calling ConfigureSearch, otherwise an error will occur. This method returns an Operation that can be used to track the progress of the reindexing by calling GetOperation.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/fhirStores/{fhirStoresId}:configureSearch", @@ -5689,7 +5718,7 @@ } } }, - "revision": "20251211", + "revision": "20260128", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "AccessDeterminationLogConfig": { @@ -6191,6 +6220,41 @@ }, "type": "object" }, + "BulkDeleteResourcesRequest": { + "description": "Request to bulk delete FHIR resources.", + "id": "BulkDeleteResourcesRequest", + "properties": { + "gcsDestination": { + "$ref": "GoogleCloudHealthcareV1beta1FhirGcsDestination", + "description": "Optional. The Cloud Storage output destination. The Healthcare Service Agent account requires the `roles/storage.objectAdmin` role on the Cloud Storage location. The deleted resources outputs are organized by FHIR resource types. The server creates one or more objects per resource type. Each object contains newline delimited strings in the format {resourceType}/{resourceId}." + }, + "type": { + "description": "Optional. String of comma-delimited FHIR resource types. If provided, only resources of the specified resource type(s) will be deleted.", + "type": "string" + }, + "until": { + "description": "Optional. If provided, only resources updated before or atthis time are deleted. The time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz. For example, `2015-02-07T13:28:17.239+02:00` or `2017-01-01T00:00:00Z`. The time must be specified to the second and include a time zone.", + "type": "string" + }, + "versionConfig": { + "description": "Optional. Specifies which version of the resources to delete.", + "enum": [ + "VERSION_CONFIG_UNSPECIFIED", + "ALL", + "CURRENT_ONLY", + "HISTORY_ONLY" + ], + "enumDescriptions": [ + "Unspecified version config. Defaults to ALL.", + "Delete the current version and all history versions.", + "Delete the current version only and create a historical version of the deleted resource.", + "Delete all history versions only." + ], + "type": "string" + } + }, + "type": "object" + }, "BulkExportGcsDestination": { "description": "The configuration for exporting to Cloud Storage using the bulk export API.", "id": "BulkExportGcsDestination", @@ -6769,7 +6833,7 @@ "description": "Deidentify configuration. Only one of `config` and `gcs_config_uri` can be specified." }, "destinationStore": { - "description": "Required. The name of the DICOM store to create and write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomStores/{dicom_store_id}`. * The destination dataset must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The destination DICOM store must not exist. * The caller must have the necessary permissions to create the destination DICOM store.", + "description": "Required. The name of the DICOM store to write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomStores/{dicom_store_id}`. * The destination dataset and DICOM store must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The caller must have the healthcare.dicomStores.dicomWebWrite permission to write to the destination DICOM store.", "type": "string" }, "filterConfig": { @@ -6792,7 +6856,7 @@ "description": "Deidentify configuration. Only one of `config` and `gcs_config_uri` can be specified." }, "destinationStore": { - "description": "Required. The name of the FHIR store to create and write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`. * The destination dataset must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The destination FHIR store must exist. * The caller must have the healthcare.fhirResources.update permission to write to the destination FHIR store.", + "description": "Required. The name of the FHIR store to write the redacted data to. For example, `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStores/{fhir_store_id}`. * The destination dataset and FHIR store must exist. * The source dataset and destination dataset must both reside in the same location. De-identifying data across multiple locations is not supported. * The caller must have the healthcare.fhirResources.update permission to write to the destination FHIR store.", "type": "string" }, "gcsConfigUri": { @@ -7965,7 +8029,7 @@ "id": "GoogleCloudHealthcareV1beta1DicomGcsDestination", "properties": { "mimeType": { - "description": "MIME types supported by DICOM spec. Each file is written in the following format: `.../{study_id}/{series_id}/{instance_id}[/{frame_number}].{extension}` The frame_number component exists only for multi-frame instances. Supported MIME types are consistent with supported formats in DICOMweb: https://cloud.google.com/healthcare/docs/dicom#retrieve_transaction. Specifically, the following are supported: - application/dicom; transfer-syntax=1.2.840.10008.1.2.1 (uncompressed DICOM) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.50 (DICOM with embedded JPEG Baseline) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.90 (DICOM with embedded JPEG 2000 Lossless Only) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.91 (DICOM with embedded JPEG 2000)h - application/dicom; transfer-syntax=* (DICOM with no transcoding) - application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1 (raw uncompressed PixelData) - application/octet-stream; transfer-syntax=* (raw PixelData in whatever format it was uploaded in) - image/jpeg; transfer-syntax=1.2.840.10008.1.2.4.50 (Consumer JPEG) - image/png The following extensions are used for output files: - application/dicom -\u003e .dcm - image/jpeg -\u003e .jpg - image/png -\u003e .png - application/octet-stream -\u003e no extension If unspecified, the instances are exported in the original DICOM format they were uploaded in.", + "description": "MIME types supported by DICOM spec. Each file is written in the following format: `.../{study_id}/{series_id}/{instance_id}[/{frame_number}].{extension}` The frame_number component exists only for multi-frame instances. Supported MIME types are consistent with supported formats in DICOMweb: https://cloud.google.com/healthcare/docs/dicom#retrieve_transaction. Specifically, the following are supported: - application/dicom; transfer-syntax=1.2.840.10008.1.2 (DICOM Implicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.1 (DICOM Explicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.1.99 (DICOM Deflated Explicit VR Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.50 (DICOM with embedded JPEG Baseline) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.51 (DICOM with embedded JPEG Extended) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.57 (DICOM with embedded JPEG Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.70 (DICOM with embedded JPEG Lossless First-Order Prediction) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.80 (DICOM with embedded JPEG-LS Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.81 (DICOM with embedded JPEG-LS Lossy (Near-Lossless)) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.90 (DICOM with embedded JPEG 2000 Lossless Only) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.91 (DICOM with embedded JPEG 2000) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.110 (DICOM with embedded JPEG XL Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.111 (DICOM with embedded JPEG XL JPEG Recompression) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.112 (DICOM with embedded JPEG XL) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.201 (DICOM with embedded High-Throughput JPEG 2000 Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.202 (DICOM with embedded High-Throughput JPEG 2000 with RPCL Options Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.203 (DICOM with embedded High-Throughput JPEG 2000) - application/dicom; transfer-syntax=1.2.840.10008.1.2.5 (DICOM with embedded RLE Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.8.1 (DICOM with embedded Deflated Image Frame Compression) - application/dicom; transfer-syntax=* (DICOM with no transcoding) - application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1 (raw uncompressed PixelData) - application/octet-stream; transfer-syntax=* (raw PixelData in whatever format it was uploaded in) - image/jpeg; transfer-syntax=1.2.840.10008.1.2.4.50 (Consumer JPEG) - image/png The following extensions are used for output files: - application/dicom -\u003e .dcm - image/jpeg -\u003e .jpg - image/png -\u003e .png - application/octet-stream -\u003e no extension If unspecified, the instances are exported in the original DICOM format they were uploaded in.", "type": "string" }, "uriPrefix": { diff --git a/healthcare/v1beta1/healthcare-gen.go b/healthcare/v1beta1/healthcare-gen.go index e57ea7c013..701085b981 100644 --- a/healthcare/v1beta1/healthcare-gen.go +++ b/healthcare/v1beta1/healthcare-gen.go @@ -1276,6 +1276,51 @@ func (s BlobStorageSettings) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// BulkDeleteResourcesRequest: Request to bulk delete FHIR resources. +type BulkDeleteResourcesRequest struct { + // GcsDestination: Optional. The Cloud Storage output destination. The + // Healthcare Service Agent account requires the `roles/storage.objectAdmin` + // role on the Cloud Storage location. The deleted resources outputs are + // organized by FHIR resource types. The server creates one or more objects per + // resource type. Each object contains newline delimited strings in the format + // {resourceType}/{resourceId}. + GcsDestination *GoogleCloudHealthcareV1beta1FhirGcsDestination `json:"gcsDestination,omitempty"` + // Type: Optional. String of comma-delimited FHIR resource types. If provided, + // only resources of the specified resource type(s) will be deleted. + Type string `json:"type,omitempty"` + // Until: Optional. If provided, only resources updated before or atthis time + // are deleted. The time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz. For + // example, `2015-02-07T13:28:17.239+02:00` or `2017-01-01T00:00:00Z`. The time + // must be specified to the second and include a time zone. + Until string `json:"until,omitempty"` + // VersionConfig: Optional. Specifies which version of the resources to delete. + // + // Possible values: + // "VERSION_CONFIG_UNSPECIFIED" - Unspecified version config. Defaults to + // ALL. + // "ALL" - Delete the current version and all history versions. + // "CURRENT_ONLY" - Delete the current version only and create a historical + // version of the deleted resource. + // "HISTORY_ONLY" - Delete all history versions only. + VersionConfig string `json:"versionConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "GcsDestination") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "GcsDestination") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s BulkDeleteResourcesRequest) MarshalJSON() ([]byte, error) { + type NoMethod BulkDeleteResourcesRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // BulkExportGcsDestination: The configuration for exporting to Cloud Storage // using the bulk export API. type BulkExportGcsDestination struct { @@ -2123,14 +2168,14 @@ type DeidentifyDicomStoreRequest struct { // Config: Deidentify configuration. Only one of `config` and `gcs_config_uri` // can be specified. Config *DeidentifyConfig `json:"config,omitempty"` - // DestinationStore: Required. The name of the DICOM store to create and write - // the redacted data to. For example, + // DestinationStore: Required. The name of the DICOM store to write the + // redacted data to. For example, // `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomSto - // res/{dicom_store_id}`. * The destination dataset must exist. * The source - // dataset and destination dataset must both reside in the same location. - // De-identifying data across multiple locations is not supported. * The - // destination DICOM store must not exist. * The caller must have the necessary - // permissions to create the destination DICOM store. + // res/{dicom_store_id}`. * The destination dataset and DICOM store must exist. + // * The source dataset and destination dataset must both reside in the same + // location. De-identifying data across multiple locations is not supported. * + // The caller must have the healthcare.dicomStores.dicomWebWrite permission to + // write to the destination DICOM store. DestinationStore string `json:"destinationStore,omitempty"` // FilterConfig: Filter configuration. FilterConfig *DicomFilterConfig `json:"filterConfig,omitempty"` @@ -2165,15 +2210,14 @@ type DeidentifyFhirStoreRequest struct { // Config: Deidentify configuration. Only one of `config` and `gcs_config_uri` // can be specified. Config *DeidentifyConfig `json:"config,omitempty"` - // DestinationStore: Required. The name of the FHIR store to create and write - // the redacted data to. For example, + // DestinationStore: Required. The name of the FHIR store to write the redacted + // data to. For example, // `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirStor - // es/{fhir_store_id}`. * The destination dataset must exist. * The source - // dataset and destination dataset must both reside in the same location. - // De-identifying data across multiple locations is not supported. * The - // destination FHIR store must exist. * The caller must have the - // healthcare.fhirResources.update permission to write to the destination FHIR - // store. + // es/{fhir_store_id}`. * The destination dataset and FHIR store must exist. * + // The source dataset and destination dataset must both reside in the same + // location. De-identifying data across multiple locations is not supported. * + // The caller must have the healthcare.fhirResources.update permission to write + // to the destination FHIR store. DestinationStore string `json:"destinationStore,omitempty"` // GcsConfigUri: Cloud Storage location to read the JSON // cloud.healthcare.deidentify.DeidentifyConfig from, overriding the default @@ -3983,16 +4027,38 @@ type GoogleCloudHealthcareV1beta1DicomGcsDestination struct { // types are consistent with supported formats in DICOMweb: // https://cloud.google.com/healthcare/docs/dicom#retrieve_transaction. // Specifically, the following are supported: - application/dicom; - // transfer-syntax=1.2.840.10008.1.2.1 (uncompressed DICOM) - - // application/dicom; transfer-syntax=1.2.840.10008.1.2.4.50 (DICOM with - // embedded JPEG Baseline) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2 (DICOM Implicit VR Little Endian) - + // application/dicom; transfer-syntax=1.2.840.10008.1.2.1 (DICOM Explicit VR + // Little Endian) - application/dicom; transfer-syntax=1.2.840.10008.1.2.1.99 + // (DICOM Deflated Explicit VR Little Endian) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2.4.50 (DICOM with embedded JPEG Baseline) - + // application/dicom; transfer-syntax=1.2.840.10008.1.2.4.51 (DICOM with + // embedded JPEG Extended) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2.4.57 (DICOM with embedded JPEG Lossless) - + // application/dicom; transfer-syntax=1.2.840.10008.1.2.4.70 (DICOM with + // embedded JPEG Lossless First-Order Prediction) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2.4.80 (DICOM with embedded JPEG-LS + // Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.81 (DICOM + // with embedded JPEG-LS Lossy (Near-Lossless)) - application/dicom; // transfer-syntax=1.2.840.10008.1.2.4.90 (DICOM with embedded JPEG 2000 // Lossless Only) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.91 - // (DICOM with embedded JPEG 2000)h - application/dicom; transfer-syntax=* - // (DICOM with no transcoding) - application/octet-stream; - // transfer-syntax=1.2.840.10008.1.2.1 (raw uncompressed PixelData) - - // application/octet-stream; transfer-syntax=* (raw PixelData in whatever - // format it was uploaded in) - image/jpeg; + // (DICOM with embedded JPEG 2000) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2.4.110 (DICOM with embedded JPEG XL + // Lossless) - application/dicom; transfer-syntax=1.2.840.10008.1.2.4.111 + // (DICOM with embedded JPEG XL JPEG Recompression) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2.4.112 (DICOM with embedded JPEG XL) - + // application/dicom; transfer-syntax=1.2.840.10008.1.2.4.201 (DICOM with + // embedded High-Throughput JPEG 2000 Lossless) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2.4.202 (DICOM with embedded High-Throughput + // JPEG 2000 with RPCL Options Lossless) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2.4.203 (DICOM with embedded High-Throughput + // JPEG 2000) - application/dicom; transfer-syntax=1.2.840.10008.1.2.5 (DICOM + // with embedded RLE Lossless) - application/dicom; + // transfer-syntax=1.2.840.10008.1.2.8.1 (DICOM with embedded Deflated Image + // Frame Compression) - application/dicom; transfer-syntax=* (DICOM with no + // transcoding) - application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1 + // (raw uncompressed PixelData) - application/octet-stream; transfer-syntax=* + // (raw PixelData in whatever format it was uploaded in) - image/jpeg; // transfer-syntax=1.2.840.10008.1.2.4.50 (Consumer JPEG) - image/png The // following extensions are used for output files: - application/dicom -> .dcm // - image/jpeg -> .jpg - image/png -> .png - application/octet-stream -> no @@ -7440,7 +7506,11 @@ type ProjectsLocationsListCall struct { header_ http.Header } -// List: Lists information about the supported locations for this service. +// List: Lists information about the supported locations for this service. This +// method can be called in two ways: * **List all public locations:** Use the +// path `GET /v1/locations`. * **List project-visible locations:** Use the path +// `GET /v1/projects/{project_id}/locations`. This may include public locations +// as well as private or other locations specifically visible to the project. // // - name: The resource that owns the locations collection, if applicable. func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { @@ -18081,6 +18151,116 @@ func (c *ProjectsLocationsDatasetsFhirStoresBulkExportGroupCall) Do(opts ...goog return c.doRequest("") } +type ProjectsLocationsDatasetsFhirStoresBulkDeleteCall struct { + s *Service + name string + bulkdeleteresourcesrequest *BulkDeleteResourcesRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// BulkDelete: Bulk deletes the FHIR resources from the given FHIR store. This +// method returns an Operation that can be used to track the progress of the +// deletion by calling GetOperation. The success and secondary_success counters +// correspond to the deleted current version and historical versions, +// respectively. +// +// - name: The name of the FHIR store to bulk delete resources from, in the +// format of +// `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/fhirSt +// ores/{fhir_store_id}`. +func (r *ProjectsLocationsDatasetsFhirStoresService) BulkDelete(name string, bulkdeleteresourcesrequest *BulkDeleteResourcesRequest) *ProjectsLocationsDatasetsFhirStoresBulkDeleteCall { + c := &ProjectsLocationsDatasetsFhirStoresBulkDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.bulkdeleteresourcesrequest = bulkdeleteresourcesrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsDatasetsFhirStoresBulkDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsDatasetsFhirStoresBulkDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsDatasetsFhirStoresBulkDeleteCall) Context(ctx context.Context) *ProjectsLocationsDatasetsFhirStoresBulkDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsDatasetsFhirStoresBulkDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDatasetsFhirStoresBulkDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.bulkdeleteresourcesrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:bulkDelete") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "healthcare.projects.locations.datasets.fhirStores.bulkDelete", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "healthcare.projects.locations.datasets.fhirStores.bulkDelete" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsDatasetsFhirStoresBulkDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "healthcare.projects.locations.datasets.fhirStores.bulkDelete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsDatasetsFhirStoresConfigureSearchCall struct { s *Service name string diff --git a/iam/v1/iam-api.json b/iam/v1/iam-api.json index 6eaf1fc9b0..9063de1d06 100644 --- a/iam/v1/iam-api.json +++ b/iam/v1/iam-api.json @@ -4160,7 +4160,7 @@ } } }, - "revision": "20260206", + "revision": "20260213", "rootUrl": "https://iam.googleapis.com/", "schemas": { "AccessRestrictions": { @@ -6557,12 +6557,14 @@ "enum": [ "MODE_UNSPECIFIED", "FEDERATION_ONLY", - "TRUST_DOMAIN" + "TRUST_DOMAIN", + "SYSTEM_TRUST_DOMAIN" ], "enumDescriptions": [ "State unspecified. New pools should not use this mode. Pools with an unspecified mode will operate as if they are in federation-only mode.", - "Federation-only mode. Federation-only pools can only be used for federating external workload identities into Google Cloud. Unless otherwise noted, no structure or format constraints are applied to workload identities in a federation-only pool, and you cannot create any resources within the pool besides providers.", - "Trust-domain mode. Trust-domain pools can be used to assign identities to Google Cloud workloads. All identities within a trust-domain pool must consist of a single namespace and individual workload identifier. The subject identifier for all identities must conform to the following format: `ns//sa/` WorkloadIdentityPoolProviders cannot be created within trust-domain pools." + "Federation-only mode. FEDERATION_ONLY mode pools can only be used for federating external workload identities into Google Cloud. Unless otherwise noted, no structure or format constraints are applied to workload identities in a FEDERATION_ONLY mode pool, and you cannot create any resources within the pool besides providers.", + "Trust-domain mode. TRUST_DOMAIN mode pools can be used to assign identities to Google Cloud workloads. Identities within a TRUST_DOMAIN mode pool share the same root of trust. WorkloadIdentityPoolProviders cannot be created within trust-domain pools.", + "SYSTEM_TRUST_DOMAIN mode pools are managed by Google Cloud services. Neither WorkloadIdentityPoolNamespaces nor WorkloadIdentityPoolProviders can be created within SYSTEM_TRUST_DOMAIN mode pools. All identities within a SYSTEM_TRUST_DOMAIN mode pool are in one of the following formats: * `spiffe:///ns//sa/` * `spiffe:///resources//`" ], "type": "string" }, diff --git a/iam/v1/iam-gen.go b/iam/v1/iam-gen.go index dc43cfec83..17de90581a 100644 --- a/iam/v1/iam-gen.go +++ b/iam/v1/iam-gen.go @@ -4144,17 +4144,20 @@ type WorkloadIdentityPool struct { // "MODE_UNSPECIFIED" - State unspecified. New pools should not use this // mode. Pools with an unspecified mode will operate as if they are in // federation-only mode. - // "FEDERATION_ONLY" - Federation-only mode. Federation-only pools can only - // be used for federating external workload identities into Google Cloud. + // "FEDERATION_ONLY" - Federation-only mode. FEDERATION_ONLY mode pools can + // only be used for federating external workload identities into Google Cloud. // Unless otherwise noted, no structure or format constraints are applied to - // workload identities in a federation-only pool, and you cannot create any - // resources within the pool besides providers. - // "TRUST_DOMAIN" - Trust-domain mode. Trust-domain pools can be used to - // assign identities to Google Cloud workloads. All identities within a - // trust-domain pool must consist of a single namespace and individual workload - // identifier. The subject identifier for all identities must conform to the - // following format: `ns//sa/` WorkloadIdentityPoolProviders cannot be created - // within trust-domain pools. + // workload identities in a FEDERATION_ONLY mode pool, and you cannot create + // any resources within the pool besides providers. + // "TRUST_DOMAIN" - Trust-domain mode. TRUST_DOMAIN mode pools can be used to + // assign identities to Google Cloud workloads. Identities within a + // TRUST_DOMAIN mode pool share the same root of trust. + // WorkloadIdentityPoolProviders cannot be created within trust-domain pools. + // "SYSTEM_TRUST_DOMAIN" - SYSTEM_TRUST_DOMAIN mode pools are managed by + // Google Cloud services. Neither WorkloadIdentityPoolNamespaces nor + // WorkloadIdentityPoolProviders can be created within SYSTEM_TRUST_DOMAIN mode + // pools. All identities within a SYSTEM_TRUST_DOMAIN mode pool are in one of + // the following formats: * `spiffe:///ns//sa/` * `spiffe:///resources//` Mode string `json:"mode,omitempty"` // Name: Identifier. The resource name of the pool. Name string `json:"name,omitempty"` diff --git a/internal/kokoro/discogen/go.mod b/internal/kokoro/discogen/go.mod index f7b1b7814b..3fce43d4f7 100644 --- a/internal/kokoro/discogen/go.mod +++ b/internal/kokoro/discogen/go.mod @@ -1,6 +1,6 @@ module google.golang.org/api/internal/kokoro/discogen -go 1.24.0 +go 1.25.0 require ( github.com/go-git/go-git/v5 v5.16.5 diff --git a/internal/kokoro/vet.sh b/internal/kokoro/vet.sh index 8e671acce7..34f0a29a93 100755 --- a/internal/kokoro/vet.sh +++ b/internal/kokoro/vet.sh @@ -41,7 +41,7 @@ golint ./... 2>&1 | ( grep -vE "\.pb\.go:" || true ) | tee /dev/stderr | (! read) -staticcheck -go 1.24 ./... 2>&1 | ( +staticcheck -go 1.25 ./... 2>&1 | ( grep -v "SA1019" | grep -v "S1007" | grep -v "error var Done should have name of the form ErrFoo" | diff --git a/internal/version.go b/internal/version.go index 63038cb6d0..2d273eca2f 100644 --- a/internal/version.go +++ b/internal/version.go @@ -5,4 +5,4 @@ package internal // Version is the current tagged release of the library. -const Version = "0.267.0" +const Version = "0.268.0" diff --git a/kmsinventory/v1/kmsinventory-api.json b/kmsinventory/v1/kmsinventory-api.json index 86def180c1..9d681f3d0e 100644 --- a/kmsinventory/v1/kmsinventory-api.json +++ b/kmsinventory/v1/kmsinventory-api.json @@ -141,7 +141,7 @@ "type": "string" }, "scope": { - "description": "Required. A scope can be an organization or a project. Resources protected by the crypto key in provided scope will be returned. The allowed values are: * organizations/{ORGANIZATION_NUMBER} (e.g., \"organizations/12345678\") * projects/{PROJECT_ID} (e.g., \"projects/foo-bar\") * projects/{PROJECT_NUMBER} (e.g., \"projects/12345678\")", + "description": "Required. A scope can be an organization or a project. Resources protected by the crypto key in provided scope will be returned. The following values are allowed: * organizations/{ORGANIZATION_NUMBER} (e.g., \"organizations/12345678\") * projects/{PROJECT_ID} (e.g., \"projects/foo-bar\") * projects/{PROJECT_NUMBER} (e.g., \"projects/12345678\")", "location": "path", "pattern": "^organizations/[^/]+$", "required": true, @@ -286,7 +286,7 @@ "type": "string" }, "scope": { - "description": "Required. A scope can be an organization or a project. Resources protected by the crypto key in provided scope will be returned. The allowed values are: * organizations/{ORGANIZATION_NUMBER} (e.g., \"organizations/12345678\") * projects/{PROJECT_ID} (e.g., \"projects/foo-bar\") * projects/{PROJECT_NUMBER} (e.g., \"projects/12345678\")", + "description": "Required. A scope can be an organization or a project. Resources protected by the crypto key in provided scope will be returned. The following values are allowed: * organizations/{ORGANIZATION_NUMBER} (e.g., \"organizations/12345678\") * projects/{PROJECT_ID} (e.g., \"projects/foo-bar\") * projects/{PROJECT_NUMBER} (e.g., \"projects/12345678\")", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -306,7 +306,7 @@ } } }, - "revision": "20260201", + "revision": "20260216", "rootUrl": "https://kmsinventory.googleapis.com/", "schemas": { "GoogleCloudKmsInventoryV1ListCryptoKeysResponse": { @@ -453,7 +453,7 @@ "type": "object" }, "GoogleCloudKmsInventoryV1Warning": { - "description": "Warning message specifying various states of response data that might indicate incomplete or partial results.", + "description": "A warning message that indicates potential problems with the response data.", "id": "GoogleCloudKmsInventoryV1Warning", "properties": { "displayMessage": { @@ -470,9 +470,9 @@ ], "enumDescriptions": [ "Default value. This value is unused.", - "Indicates that the caller or service agent lacks necessary permissions to view some of the requested data. The response may be partial. Examples: - KMS organization service agent {service_agent_name} lacks the `cloudasset.assets.searchAllResources` permission on the scope.", - "Indicates that a resource limit has been exceeded, resulting in partial data. Examples: - The project has more than 10,000 assets (resources, crypto keys, key handles, IAM policies, etc).", - "Indicates that the project is org-less. Thus the analysis is only done for the project level data and results might be partial." + "Indicates that the caller or service agent lacks necessary permissions to view some of the requested data. The response may be partial. Example: - KMS organization service agent {service_agent_name} lacks the `cloudasset.assets.searchAllResources` permission on the scope.", + "Indicates that a resource limit has been exceeded, resulting in partial data. Example: - The project has more than 10,000 assets (resources, crypto keys, key handles, IAM policies, etc).", + "Indicates that the project exists outside of an organization resource. Thus the analysis is only done for the project level data and results might be partial." ], "type": "string" } diff --git a/kmsinventory/v1/kmsinventory-gen.go b/kmsinventory/v1/kmsinventory-gen.go index 1f74312bdc..7d5922ca30 100644 --- a/kmsinventory/v1/kmsinventory-gen.go +++ b/kmsinventory/v1/kmsinventory-gen.go @@ -408,8 +408,8 @@ func (s GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse) MarshalJSON() return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudKmsInventoryV1Warning: Warning message specifying various states -// of response data that might indicate incomplete or partial results. +// GoogleCloudKmsInventoryV1Warning: A warning message that indicates potential +// problems with the response data. type GoogleCloudKmsInventoryV1Warning struct { // DisplayMessage: The literal message providing context and details about the // warnings. @@ -420,16 +420,16 @@ type GoogleCloudKmsInventoryV1Warning struct { // "WARNING_CODE_UNSPECIFIED" - Default value. This value is unused. // "INSUFFICIENT_PERMISSIONS_PARTIAL_DATA" - Indicates that the caller or // service agent lacks necessary permissions to view some of the requested - // data. The response may be partial. Examples: - KMS organization service - // agent {service_agent_name} lacks the `cloudasset.assets.searchAllResources` + // data. The response may be partial. Example: - KMS organization service agent + // {service_agent_name} lacks the `cloudasset.assets.searchAllResources` // permission on the scope. // "RESOURCE_LIMIT_EXCEEDED_PARTIAL_DATA" - Indicates that a resource limit - // has been exceeded, resulting in partial data. Examples: - The project has + // has been exceeded, resulting in partial data. Example: - The project has // more than 10,000 assets (resources, crypto keys, key handles, IAM policies, // etc). - // "ORG_LESS_PROJECT_PARTIAL_DATA" - Indicates that the project is org-less. - // Thus the analysis is only done for the project level data and results might - // be partial. + // "ORG_LESS_PROJECT_PARTIAL_DATA" - Indicates that the project exists + // outside of an organization resource. Thus the analysis is only done for the + // project level data and results might be partial. WarningCode string `json:"warningCode,omitempty"` // ForceSendFields is a list of field names (e.g. "DisplayMessage") to // unconditionally include in API requests. By default, fields with empty or @@ -1062,10 +1062,11 @@ type OrganizationsProtectedResourcesSearchCall struct { // KMS CryptoKey in the given Cloud organization/project. // // - scope: A scope can be an organization or a project. Resources protected by -// the crypto key in provided scope will be returned. The allowed values are: -// - organizations/{ORGANIZATION_NUMBER} (e.g., "organizations/12345678") * -// projects/{PROJECT_ID} (e.g., "projects/foo-bar") * -// projects/{PROJECT_NUMBER} (e.g., "projects/12345678"). +// the crypto key in provided scope will be returned. The following values +// are allowed: * organizations/{ORGANIZATION_NUMBER} (e.g., +// "organizations/12345678") * projects/{PROJECT_ID} (e.g., +// "projects/foo-bar") * projects/{PROJECT_NUMBER} (e.g., +// "projects/12345678"). func (r *OrganizationsProtectedResourcesService) Search(scope string) *OrganizationsProtectedResourcesSearchCall { c := &OrganizationsProtectedResourcesSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.scope = scope @@ -1522,10 +1523,11 @@ type ProjectsProtectedResourcesSearchCall struct { // KMS CryptoKey in the given Cloud organization/project. // // - scope: A scope can be an organization or a project. Resources protected by -// the crypto key in provided scope will be returned. The allowed values are: -// - organizations/{ORGANIZATION_NUMBER} (e.g., "organizations/12345678") * -// projects/{PROJECT_ID} (e.g., "projects/foo-bar") * -// projects/{PROJECT_NUMBER} (e.g., "projects/12345678"). +// the crypto key in provided scope will be returned. The following values +// are allowed: * organizations/{ORGANIZATION_NUMBER} (e.g., +// "organizations/12345678") * projects/{PROJECT_ID} (e.g., +// "projects/foo-bar") * projects/{PROJECT_NUMBER} (e.g., +// "projects/12345678"). func (r *ProjectsProtectedResourcesService) Search(scope string) *ProjectsProtectedResourcesSearchCall { c := &ProjectsProtectedResourcesSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.scope = scope diff --git a/merchantapi/accounts/v1/merchantapi-api.json b/merchantapi/accounts/v1/merchantapi-api.json index c1949e39cb..9b33cb5343 100644 --- a/merchantapi/accounts/v1/merchantapi-api.json +++ b/merchantapi/accounts/v1/merchantapi-api.json @@ -2410,7 +2410,7 @@ } } }, - "revision": "20260206", + "revision": "20260218", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "About": { @@ -2484,7 +2484,7 @@ "type": "string" }, "accountName": { - "description": "Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information.", + "description": "Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the \"/\" or \"_\" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information.", "type": "string" }, "adultContent": { @@ -3123,7 +3123,7 @@ "readOnly": true }, "eligibleDestinations": { - "description": "Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS`", + "description": "Optional. Required for the create operation. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies. Valid destination values are `SHOPPING_ADS` and `FREE_LISTINGS`.", "items": { "enum": [ "DESTINATION_ENUM_UNSPECIFIED", @@ -4871,7 +4871,7 @@ "type": "object" }, "Program": { - "description": "Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `shopping-ads` * `youtube-shopping-checkout`", + "description": "Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `product-ratings` * `shopping-ads` * `youtube-shopping-checkout`", "id": "Program", "properties": { "activeRegionCodes": { diff --git a/merchantapi/accounts/v1/merchantapi-gen.go b/merchantapi/accounts/v1/merchantapi-gen.go index 63232bdf36..c71ce281e4 100644 --- a/merchantapi/accounts/v1/merchantapi-gen.go +++ b/merchantapi/accounts/v1/merchantapi-gen.go @@ -530,8 +530,9 @@ func (s Accepted) MarshalJSON() ([]byte, error) { type Account struct { // AccountId: Output only. The ID of the account. AccountId int64 `json:"accountId,omitempty,string"` - // AccountName: Required. A human-readable name of the account. See store name - // (https://support.google.com/merchants/answer/160556) and business name + // AccountName: Required. A human-readable name of the account. Don't use + // punctuation, capitalization, or non-alphanumeric symbols such as the "/" or + // "_" symbols. See Adding a business name // (https://support.google.com/merchants/answer/12159159) for more information. AccountName string `json:"accountName,omitempty"` // AdultContent: Optional. Whether this account contains adult content. @@ -1465,10 +1466,11 @@ type CheckoutSettings struct { // be a copy of url settings. Otherwise, it will have the value of the parent // account (for only marketplace sellers). EffectiveUriSettings *UriSettings `json:"effectiveUriSettings,omitempty"` - // EligibleDestinations: Optional. The destinations (also known as Marketing - // methods (https://support.google.com/merchants/answer/15130232)) to which the - // checkout program applies, valid destination values are `SHOPPING_ADS`, - // `FREE_LISTINGS` + // EligibleDestinations: Optional. Required for the create operation. The + // destinations (also known as Marketing methods + // (https://support.google.com/merchants/answer/15130232)) to which the + // checkout program applies. Valid destination values are `SHOPPING_ADS` and + // `FREE_LISTINGS`. // // Possible values: // "DESTINATION_ENUM_UNSPECIFIED" - Not specified. @@ -3786,8 +3788,8 @@ type ProductsManagement struct { // (https://support.google.com/merchants/answer/13889434) program, which // enables products from a business's store to be shown across Google for free. // The following list is the available set of program resource IDs accessible -// through the API: * `checkout` * `free-listings` * `shopping-ads` * -// `youtube-shopping-checkout` +// through the API: * `checkout` * `free-listings` * `product-ratings` * +// `shopping-ads` * `youtube-shopping-checkout` type Program struct { // ActiveRegionCodes: Output only. The regions in which the account is actively // participating in the program. Active regions are defined as those where all diff --git a/merchantapi/accounts_v1beta/merchantapi-api.json b/merchantapi/accounts_v1beta/merchantapi-api.json index 983bd84168..de61bd070f 100644 --- a/merchantapi/accounts_v1beta/merchantapi-api.json +++ b/merchantapi/accounts_v1beta/merchantapi-api.json @@ -2360,7 +2360,7 @@ } } }, - "revision": "20260206", + "revision": "20260218", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "About": { @@ -2434,7 +2434,7 @@ "type": "string" }, "accountName": { - "description": "Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information.", + "description": "Required. A human-readable name of the account. Don't use punctuation, capitalization, or non-alphanumeric symbols such as the \"/\" or \"_\" symbols. See [Adding a business name](https://support.google.com/merchants/answer/12159159) for more information.", "type": "string" }, "adultContent": { @@ -3003,7 +3003,7 @@ "readOnly": true }, "eligibleDestinations": { - "description": "Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS`", + "description": "Optional. Required for the create operation. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies. Valid destination values are `SHOPPING_ADS` and `FREE_LISTINGS`.", "items": { "enum": [ "DESTINATION_ENUM_UNSPECIFIED", @@ -4748,7 +4748,7 @@ "type": "object" }, "Program": { - "description": "Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `shopping-ads` * `youtube-shopping-checkout`", + "description": "Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to a Merchant Center accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/answer/13889434) program, which enables products from a business's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `checkout` * `free-listings` * `product-ratings` * `shopping-ads` * `youtube-shopping-checkout`", "id": "Program", "properties": { "activeRegionCodes": { diff --git a/merchantapi/accounts_v1beta/merchantapi-gen.go b/merchantapi/accounts_v1beta/merchantapi-gen.go index 2acec739d7..33edb53d6c 100644 --- a/merchantapi/accounts_v1beta/merchantapi-gen.go +++ b/merchantapi/accounts_v1beta/merchantapi-gen.go @@ -530,8 +530,9 @@ func (s Accepted) MarshalJSON() ([]byte, error) { type Account struct { // AccountId: Output only. The ID of the account. AccountId int64 `json:"accountId,omitempty,string"` - // AccountName: Required. A human-readable name of the account. See store name - // (https://support.google.com/merchants/answer/160556) and business name + // AccountName: Required. A human-readable name of the account. Don't use + // punctuation, capitalization, or non-alphanumeric symbols such as the "/" or + // "_" symbols. See Adding a business name // (https://support.google.com/merchants/answer/12159159) for more information. AccountName string `json:"accountName,omitempty"` // AdultContent: Optional. Whether this account contains adult content. @@ -1341,10 +1342,11 @@ type CheckoutSettings struct { // be a copy of url settings. Otherwise, it will have the value of the parent // account (for only marketplace sellers). EffectiveUriSettings *UriSettings `json:"effectiveUriSettings,omitempty"` - // EligibleDestinations: Optional. The destinations (also known as Marketing - // methods (https://support.google.com/merchants/answer/15130232)) to which the - // checkout program applies, valid destination values are `SHOPPING_ADS`, - // `FREE_LISTINGS` + // EligibleDestinations: Optional. Required for the create operation. The + // destinations (also known as Marketing methods + // (https://support.google.com/merchants/answer/15130232)) to which the + // checkout program applies. Valid destination values are `SHOPPING_ADS` and + // `FREE_LISTINGS`. // // Possible values: // "DESTINATION_ENUM_UNSPECIFIED" - Not specified. @@ -3643,8 +3645,8 @@ type ProductsManagement struct { // (https://support.google.com/merchants/answer/13889434) program, which // enables products from a business's store to be shown across Google for free. // The following list is the available set of program resource IDs accessible -// through the API: * `checkout` * `free-listings` * `shopping-ads` * -// `youtube-shopping-checkout` +// through the API: * `checkout` * `free-listings` * `product-ratings` * +// `shopping-ads` * `youtube-shopping-checkout` type Program struct { // ActiveRegionCodes: Output only. The regions in which the account is actively // participating in the program. Active regions are defined as those where all diff --git a/monitoring/v1/monitoring-api.json b/monitoring/v1/monitoring-api.json index 450255f4a6..6df7a204b0 100644 --- a/monitoring/v1/monitoring-api.json +++ b/monitoring/v1/monitoring-api.json @@ -753,7 +753,7 @@ } } }, - "revision": "20260108", + "revision": "20260212", "rootUrl": "https://monitoring.googleapis.com/", "schemas": { "Aggregation": { @@ -1087,6 +1087,21 @@ }, "type": "object" }, + "CoordinatedWidget": { + "description": "A widget that contains two widget visualizations that are coordinated in display. Currently, we only support the primary widget of TimeSeriesTable with the secondary widget of XyChart.", + "id": "CoordinatedWidget", + "properties": { + "primary": { + "$ref": "Widget", + "description": "Required. The primary visualization. Must be set. Must contain a data source." + }, + "secondary": { + "$ref": "Widget", + "description": "Required. The secondary visualization. Must be set. Must contain a data source." + } + }, + "type": "object" + }, "Dashboard": { "description": "A Google Stackdriver dashboard. Dashboards define the content and layout of pages in the Stackdriver web application.", "id": "Dashboard", @@ -3006,6 +3021,10 @@ "$ref": "CollapsibleGroup", "description": "A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets." }, + "coordinatedWidget": { + "$ref": "CoordinatedWidget", + "description": "A widget that contains two widget visualizations that are coordinated in display." + }, "errorReportingPanel": { "$ref": "ErrorReportingPanel", "description": "A widget that displays a list of error groups." diff --git a/monitoring/v1/monitoring-gen.go b/monitoring/v1/monitoring-gen.go index 860badfec5..a80c9573ca 100644 --- a/monitoring/v1/monitoring-gen.go +++ b/monitoring/v1/monitoring-gen.go @@ -872,6 +872,34 @@ func (s ColumnSortingOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// CoordinatedWidget: A widget that contains two widget visualizations that are +// coordinated in display. Currently, we only support the primary widget of +// TimeSeriesTable with the secondary widget of XyChart. +type CoordinatedWidget struct { + // Primary: Required. The primary visualization. Must be set. Must contain a + // data source. + Primary *Widget `json:"primary,omitempty"` + // Secondary: Required. The secondary visualization. Must be set. Must contain + // a data source. + Secondary *Widget `json:"secondary,omitempty"` + // ForceSendFields is a list of field names (e.g. "Primary") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Primary") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s CoordinatedWidget) MarshalJSON() ([]byte, error) { + type NoMethod CoordinatedWidget + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Dashboard: A Google Stackdriver dashboard. Dashboards define the content and // layout of pages in the Stackdriver web application. type Dashboard struct { @@ -3284,6 +3312,9 @@ type Widget struct { // are within the area spanned by the grouping widget are considered member // widgets. CollapsibleGroup *CollapsibleGroup `json:"collapsibleGroup,omitempty"` + // CoordinatedWidget: A widget that contains two widget visualizations that are + // coordinated in display. + CoordinatedWidget *CoordinatedWidget `json:"coordinatedWidget,omitempty"` // ErrorReportingPanel: A widget that displays a list of error groups. ErrorReportingPanel *ErrorReportingPanel `json:"errorReportingPanel,omitempty"` // FilterControl: A widget that displays an input field to change the value of diff --git a/netapp/v1/netapp-api.json b/netapp/v1/netapp-api.json index 4b275cbe32..0fa025e38f 100644 --- a/netapp/v1/netapp-api.json +++ b/netapp/v1/netapp-api.json @@ -2715,7 +2715,7 @@ } } }, - "revision": "20260125", + "revision": "20260218", "rootUrl": "https://netapp.googleapis.com/", "schemas": { "ActiveDirectory": { @@ -3391,6 +3391,29 @@ "properties": {}, "type": "object" }, + "CloneDetails": { + "description": "Details about a clone volume.", + "id": "CloneDetails", + "properties": { + "sharedSpaceGib": { + "description": "Output only. Shared space in GiB. Determined at volume creation time based on size of source snapshot.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "sourceSnapshot": { + "description": "Output only. Specifies the full resource name of the source snapshot from which this volume was cloned. Format: projects/{project}/locations/{location}/volumes/{volume}/snapshots/{snapshot}", + "readOnly": true, + "type": "string" + }, + "sourceVolume": { + "description": "Output only. Full name of the source volume resource. Format: projects/{project}/locations/{location}/volumes/{volume}", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "DailySchedule": { "description": "Make a snapshot every day e.g. at 04:00, 05:20, 23:50", "id": "DailySchedule", @@ -5322,6 +5345,11 @@ "format": "int64", "type": "string" }, + "cloneDetails": { + "$ref": "CloneDetails", + "description": "Output only. If this volume is a clone, this field contains details about the clone.", + "readOnly": true + }, "coldTierSizeGib": { "description": "Output only. Size of the volume cold tier data rounded down to the nearest GiB.", "format": "int64", diff --git a/netapp/v1/netapp-gen.go b/netapp/v1/netapp-gen.go index c31e03dadd..284d380251 100644 --- a/netapp/v1/netapp-gen.go +++ b/netapp/v1/netapp-gen.go @@ -901,6 +901,36 @@ func (s CachePrePopulate) MarshalJSON() ([]byte, error) { type CancelOperationRequest struct { } +// CloneDetails: Details about a clone volume. +type CloneDetails struct { + // SharedSpaceGib: Output only. Shared space in GiB. Determined at volume + // creation time based on size of source snapshot. + SharedSpaceGib int64 `json:"sharedSpaceGib,omitempty,string"` + // SourceSnapshot: Output only. Specifies the full resource name of the source + // snapshot from which this volume was cloned. Format: + // projects/{project}/locations/{location}/volumes/{volume}/snapshots/{snapshot} + SourceSnapshot string `json:"sourceSnapshot,omitempty"` + // SourceVolume: Output only. Full name of the source volume resource. Format: + // projects/{project}/locations/{location}/volumes/{volume} + SourceVolume string `json:"sourceVolume,omitempty"` + // ForceSendFields is a list of field names (e.g. "SharedSpaceGib") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "SharedSpaceGib") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s CloneDetails) MarshalJSON() ([]byte, error) { + type NoMethod CloneDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // DailySchedule: Make a snapshot every day e.g. at 04:00, 05:20, 23:50 type DailySchedule struct { // Hour: Set the hour to start the snapshot (0-23), defaults to midnight (0). @@ -2886,6 +2916,9 @@ type Volume struct { CacheParameters *CacheParameters `json:"cacheParameters,omitempty"` // CapacityGib: Required. Capacity in GIB of the volume CapacityGib int64 `json:"capacityGib,omitempty,string"` + // CloneDetails: Output only. If this volume is a clone, this field contains + // details about the clone. + CloneDetails *CloneDetails `json:"cloneDetails,omitempty"` // ColdTierSizeGib: Output only. Size of the volume cold tier data rounded down // to the nearest GiB. ColdTierSizeGib int64 `json:"coldTierSizeGib,omitempty,string"` diff --git a/netapp/v1beta1/netapp-api.json b/netapp/v1beta1/netapp-api.json index ee9376540a..2eab759346 100644 --- a/netapp/v1beta1/netapp-api.json +++ b/netapp/v1beta1/netapp-api.json @@ -1809,6 +1809,118 @@ "https://www.googleapis.com/auth/cloud-platform" ] } + }, + "resources": { + "ontap": { + "methods": { + "executeOntapDelete": { + "description": "`ExecuteOntapDelete` dispatches the ONTAP `DELETE` request to the `StoragePool` cluster.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/storagePools/{storagePoolsId}/ontap/{ontapId}", + "httpMethod": "DELETE", + "id": "netapp.projects.locations.storagePools.ontap.executeOntapDelete", + "parameterOrder": [ + "ontapPath" + ], + "parameters": { + "ontapPath": { + "description": "Required. The resource path of the ONTAP resource. Format: `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`. For example: `projects/123456789/locations/us-central1/storagePools/my-storage-pool/ontap/api/storage/volumes`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/storagePools/[^/]+/ontap/.*$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+ontapPath}", + "response": { + "$ref": "ExecuteOntapDeleteResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "executeOntapGet": { + "description": "`ExecuteOntapGet` dispatches the ONTAP `GET` request to the `StoragePool` cluster.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/storagePools/{storagePoolsId}/ontap/{ontapId}", + "httpMethod": "GET", + "id": "netapp.projects.locations.storagePools.ontap.executeOntapGet", + "parameterOrder": [ + "ontapPath" + ], + "parameters": { + "ontapPath": { + "description": "Required. The resource path of the ONTAP resource. Format: `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`. For example: `projects/123456789/locations/us-central1/storagePools/my-storage-pool/ontap/api/storage/volumes`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/storagePools/[^/]+/ontap/.*$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+ontapPath}", + "response": { + "$ref": "ExecuteOntapGetResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "executeOntapPatch": { + "description": "`ExecuteOntapPatch` dispatches the ONTAP `PATCH` request to the `StoragePool` cluster.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/storagePools/{storagePoolsId}/ontap/{ontapId}", + "httpMethod": "PATCH", + "id": "netapp.projects.locations.storagePools.ontap.executeOntapPatch", + "parameterOrder": [ + "ontapPath" + ], + "parameters": { + "ontapPath": { + "description": "Required. The resource path of the ONTAP resource. Format: `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`. For example: `projects/123456789/locations/us-central1/storagePools/my-storage-pool/ontap/api/storage/volumes`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/storagePools/[^/]+/ontap/.*$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+ontapPath}", + "request": { + "$ref": "ExecuteOntapPatchRequest" + }, + "response": { + "$ref": "ExecuteOntapPatchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "executeOntapPost": { + "description": "`ExecuteOntapPost` dispatches the ONTAP `POST` request to the `StoragePool` cluster.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/storagePools/{storagePoolsId}/ontap/{ontapId}", + "httpMethod": "POST", + "id": "netapp.projects.locations.storagePools.ontap.executeOntapPost", + "parameterOrder": [ + "ontapPath" + ], + "parameters": { + "ontapPath": { + "description": "Required. The resource path of the ONTAP resource. Format: `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`. For example: `projects/123456789/locations/us-central1/storagePools/my-storage-pool/ontap/api/storage/volumes`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/storagePools/[^/]+/ontap/.*$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+ontapPath}", + "request": { + "$ref": "ExecuteOntapPostRequest" + }, + "response": { + "$ref": "ExecuteOntapPostResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } } }, "volumes": { @@ -2715,7 +2827,7 @@ } } }, - "revision": "20260125", + "revision": "20260218", "rootUrl": "https://netapp.googleapis.com/", "schemas": { "ActiveDirectory": { @@ -3391,6 +3503,29 @@ "properties": {}, "type": "object" }, + "CloneDetails": { + "description": "Details about a clone volume.", + "id": "CloneDetails", + "properties": { + "sharedSpaceGib": { + "description": "Output only. Shared space in GiB. Determined at volume creation time based on size of source snapshot.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "sourceSnapshot": { + "description": "Output only. Specifies the full resource name of the source snapshot from which this volume was cloned. Format: projects/{project}/locations/{location}/volumes/{volume}/snapshots/{snapshot}", + "readOnly": true, + "type": "string" + }, + "sourceVolume": { + "description": "Output only. Full name of the source volume resource. Format: projects/{project}/locations/{location}/volumes/{volume}", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "DailySchedule": { "description": "Make a snapshot every day e.g. at 04:00, 05:20, 23:50", "id": "DailySchedule", @@ -3498,6 +3633,96 @@ }, "type": "object" }, + "ExecuteOntapDeleteResponse": { + "description": "Response message for `ExecuteOntapDelete` API.", + "id": "ExecuteOntapDeleteResponse", + "properties": { + "body": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "The raw `JSON` body of the response.", + "type": "object" + } + }, + "type": "object" + }, + "ExecuteOntapGetResponse": { + "description": "Response message for `ExecuteOntapGet` API.", + "id": "ExecuteOntapGetResponse", + "properties": { + "body": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "The raw `JSON` body of the response.", + "type": "object" + } + }, + "type": "object" + }, + "ExecuteOntapPatchRequest": { + "description": "Request message for `ExecuteOntapPatch` API.", + "id": "ExecuteOntapPatchRequest", + "properties": { + "body": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Required. The raw `JSON` body of the request. The body should be in the format of the ONTAP resource. For example: ``` { \"body\": { \"field1\": \"value1\", \"field2\": \"value2\", } } ```", + "type": "object" + } + }, + "type": "object" + }, + "ExecuteOntapPatchResponse": { + "description": "Response message for `ExecuteOntapPatch` API.", + "id": "ExecuteOntapPatchResponse", + "properties": { + "body": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "The raw `JSON` body of the response.", + "type": "object" + } + }, + "type": "object" + }, + "ExecuteOntapPostRequest": { + "description": "Request message for `ExecuteOntapPost` API.", + "id": "ExecuteOntapPostRequest", + "properties": { + "body": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Required. The raw `JSON` body of the request. The body should be in the format of the ONTAP resource. For example: ``` { \"body\": { \"field1\": \"value1\", \"field2\": \"value2\", } } ```", + "type": "object" + } + }, + "type": "object" + }, + "ExecuteOntapPostResponse": { + "description": "Response message for `ExecuteOntapPost` API.", + "id": "ExecuteOntapPostResponse", + "properties": { + "body": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "The raw `JSON` body of the response.", + "type": "object" + } + }, + "type": "object" + }, "ExportPolicy": { "description": "Defines the export policy for the volume.", "id": "ExportPolicy", @@ -3826,6 +4051,18 @@ }, "type": "object" }, + "LargeCapacityConfig": { + "description": "Configuration for a Large Capacity Volume. A Large Capacity Volume supports sizes ranging from 12 TiB to 20 PiB, it is composed of multiple internal constituents, and must be created in a large capacity pool.", + "id": "LargeCapacityConfig", + "properties": { + "constituentCount": { + "description": "Optional. The number of internal constituents (e.g., FlexVols) for this large volume. The minimum number of constituents is 2.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "ListActiveDirectoriesResponse": { "description": "ListActiveDirectoriesResponse contains all the active directories requested.", "id": "ListActiveDirectoriesResponse", @@ -5004,6 +5241,20 @@ "description": "Optional. Flag indicating if the pool is NFS LDAP enabled or not.", "type": "boolean" }, + "mode": { + "description": "Optional. Mode of the storage pool. This field is used to control whether the user can perform the ONTAP operations on the storage pool using the GCNV ONTAP Mode APIs. If not specified during creation, it defaults to `DEFAULT`.", + "enum": [ + "MODE_UNSPECIFIED", + "DEFAULT", + "ONTAP" + ], + "enumDescriptions": [ + "The `StoragePool` `Mode` is not specified.", + "The `StoragePool` and its resources are managed by the GCNV APIs.", + "The `StoragePool` and its resources are managed by the GCNV ONTAP Mode APIs." + ], + "type": "string" + }, "name": { "description": "Identifier. Name of the storage pool", "type": "string" @@ -5044,6 +5295,20 @@ "readOnly": true, "type": "boolean" }, + "scaleTier": { + "description": "Optional. The effective scale tier of the storage pool. If `scale_tier` is not specified during creation, this defaults to `SCALE_TIER_STANDARD`.", + "enum": [ + "SCALE_TIER_UNSPECIFIED", + "SCALE_TIER_STANDARD", + "SCALE_TIER_ENTERPRISE" + ], + "enumDescriptions": [ + "The default value. This value is unused.", + "The standard capacity and performance tier. Suitable for general purpose workloads.", + "A higher capacity and performance tier. Suitable for more demanding workloads." + ], + "type": "string" + }, "serviceLevel": { "description": "Required. Service level of the storage pool", "enum": [ @@ -5322,6 +5587,11 @@ "format": "int64", "type": "string" }, + "cloneDetails": { + "$ref": "CloneDetails", + "description": "Output only. If this volume is a clone, this field contains details about the clone.", + "readOnly": true + }, "coldTierSizeGib": { "description": "Output only. Size of the volume cold tier data rounded down to the nearest GiB.", "format": "int64", @@ -5392,6 +5662,10 @@ "description": "Optional. Flag indicating if the volume will be a large capacity volume or a regular volume.", "type": "boolean" }, + "largeCapacityConfig": { + "$ref": "LargeCapacityConfig", + "description": "Optional. Large capacity config for the volume." + }, "ldapEnabled": { "description": "Output only. Flag indicating if the volume is NFS LDAP enabled or not.", "readOnly": true, diff --git a/netapp/v1beta1/netapp-gen.go b/netapp/v1beta1/netapp-gen.go index 28d1ead685..6d40ab3bdd 100644 --- a/netapp/v1beta1/netapp-gen.go +++ b/netapp/v1beta1/netapp-gen.go @@ -267,11 +267,23 @@ type ProjectsLocationsOperationsService struct { func NewProjectsLocationsStoragePoolsService(s *Service) *ProjectsLocationsStoragePoolsService { rs := &ProjectsLocationsStoragePoolsService{s: s} + rs.Ontap = NewProjectsLocationsStoragePoolsOntapService(s) return rs } type ProjectsLocationsStoragePoolsService struct { s *Service + + Ontap *ProjectsLocationsStoragePoolsOntapService +} + +func NewProjectsLocationsStoragePoolsOntapService(s *Service) *ProjectsLocationsStoragePoolsOntapService { + rs := &ProjectsLocationsStoragePoolsOntapService{s: s} + return rs +} + +type ProjectsLocationsStoragePoolsOntapService struct { + s *Service } func NewProjectsLocationsVolumesService(s *Service) *ProjectsLocationsVolumesService { @@ -901,6 +913,36 @@ func (s CachePrePopulate) MarshalJSON() ([]byte, error) { type CancelOperationRequest struct { } +// CloneDetails: Details about a clone volume. +type CloneDetails struct { + // SharedSpaceGib: Output only. Shared space in GiB. Determined at volume + // creation time based on size of source snapshot. + SharedSpaceGib int64 `json:"sharedSpaceGib,omitempty,string"` + // SourceSnapshot: Output only. Specifies the full resource name of the source + // snapshot from which this volume was cloned. Format: + // projects/{project}/locations/{location}/volumes/{volume}/snapshots/{snapshot} + SourceSnapshot string `json:"sourceSnapshot,omitempty"` + // SourceVolume: Output only. Full name of the source volume resource. Format: + // projects/{project}/locations/{location}/volumes/{volume} + SourceVolume string `json:"sourceVolume,omitempty"` + // ForceSendFields is a list of field names (e.g. "SharedSpaceGib") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "SharedSpaceGib") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s CloneDetails) MarshalJSON() ([]byte, error) { + type NoMethod CloneDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // DailySchedule: Make a snapshot every day e.g. at 04:00, 05:20, 23:50 type DailySchedule struct { // Hour: Set the hour to start the snapshot (0-23), defaults to midnight (0). @@ -1051,6 +1093,154 @@ func (s EstablishVolumePeeringRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ExecuteOntapDeleteResponse: Response message for `ExecuteOntapDelete` API. +type ExecuteOntapDeleteResponse struct { + // Body: The raw `JSON` body of the response. + Body googleapi.RawMessage `json:"body,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Body") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Body") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ExecuteOntapDeleteResponse) MarshalJSON() ([]byte, error) { + type NoMethod ExecuteOntapDeleteResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ExecuteOntapGetResponse: Response message for `ExecuteOntapGet` API. +type ExecuteOntapGetResponse struct { + // Body: The raw `JSON` body of the response. + Body googleapi.RawMessage `json:"body,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Body") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Body") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ExecuteOntapGetResponse) MarshalJSON() ([]byte, error) { + type NoMethod ExecuteOntapGetResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ExecuteOntapPatchRequest: Request message for `ExecuteOntapPatch` API. +type ExecuteOntapPatchRequest struct { + // Body: Required. The raw `JSON` body of the request. The body should be in + // the format of the ONTAP resource. For example: ``` { "body": { "field1": + // "value1", "field2": "value2", } } ``` + Body googleapi.RawMessage `json:"body,omitempty"` + // ForceSendFields is a list of field names (e.g. "Body") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Body") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ExecuteOntapPatchRequest) MarshalJSON() ([]byte, error) { + type NoMethod ExecuteOntapPatchRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ExecuteOntapPatchResponse: Response message for `ExecuteOntapPatch` API. +type ExecuteOntapPatchResponse struct { + // Body: The raw `JSON` body of the response. + Body googleapi.RawMessage `json:"body,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Body") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Body") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ExecuteOntapPatchResponse) MarshalJSON() ([]byte, error) { + type NoMethod ExecuteOntapPatchResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ExecuteOntapPostRequest: Request message for `ExecuteOntapPost` API. +type ExecuteOntapPostRequest struct { + // Body: Required. The raw `JSON` body of the request. The body should be in + // the format of the ONTAP resource. For example: ``` { "body": { "field1": + // "value1", "field2": "value2", } } ``` + Body googleapi.RawMessage `json:"body,omitempty"` + // ForceSendFields is a list of field names (e.g. "Body") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Body") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ExecuteOntapPostRequest) MarshalJSON() ([]byte, error) { + type NoMethod ExecuteOntapPostRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ExecuteOntapPostResponse: Response message for `ExecuteOntapPost` API. +type ExecuteOntapPostResponse struct { + // Body: The raw `JSON` body of the response. + Body googleapi.RawMessage `json:"body,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Body") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Body") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ExecuteOntapPostResponse) MarshalJSON() ([]byte, error) { + type NoMethod ExecuteOntapPostResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ExportPolicy: Defines the export policy for the volume. type ExportPolicy struct { // Rules: Required. List of export policy rules @@ -1363,6 +1553,32 @@ func (s KmsConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// LargeCapacityConfig: Configuration for a Large Capacity Volume. A Large +// Capacity Volume supports sizes ranging from 12 TiB to 20 PiB, it is composed +// of multiple internal constituents, and must be created in a large capacity +// pool. +type LargeCapacityConfig struct { + // ConstituentCount: Optional. The number of internal constituents (e.g., + // FlexVols) for this large volume. The minimum number of constituents is 2. + ConstituentCount int64 `json:"constituentCount,omitempty"` + // ForceSendFields is a list of field names (e.g. "ConstituentCount") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ConstituentCount") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s LargeCapacityConfig) MarshalJSON() ([]byte, error) { + type NoMethod LargeCapacityConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ListActiveDirectoriesResponse: ListActiveDirectoriesResponse contains all // the active directories requested. type ListActiveDirectoriesResponse struct { @@ -2590,6 +2806,18 @@ type StoragePool struct { // LdapEnabled: Optional. Flag indicating if the pool is NFS LDAP enabled or // not. LdapEnabled bool `json:"ldapEnabled,omitempty"` + // Mode: Optional. Mode of the storage pool. This field is used to control + // whether the user can perform the ONTAP operations on the storage pool using + // the GCNV ONTAP Mode APIs. If not specified during creation, it defaults to + // `DEFAULT`. + // + // Possible values: + // "MODE_UNSPECIFIED" - The `StoragePool` `Mode` is not specified. + // "DEFAULT" - The `StoragePool` and its resources are managed by the GCNV + // APIs. + // "ONTAP" - The `StoragePool` and its resources are managed by the GCNV + // ONTAP Mode APIs. + Mode string `json:"mode,omitempty"` // Name: Identifier. Name of the storage pool Name string `json:"name,omitempty"` // Network: Required. VPC Network name. Format: @@ -2611,6 +2839,17 @@ type StoragePool struct { SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` // SatisfiesPzs: Output only. Reserved for future use SatisfiesPzs bool `json:"satisfiesPzs,omitempty"` + // ScaleTier: Optional. The effective scale tier of the storage pool. If + // `scale_tier` is not specified during creation, this defaults to + // `SCALE_TIER_STANDARD`. + // + // Possible values: + // "SCALE_TIER_UNSPECIFIED" - The default value. This value is unused. + // "SCALE_TIER_STANDARD" - The standard capacity and performance tier. + // Suitable for general purpose workloads. + // "SCALE_TIER_ENTERPRISE" - A higher capacity and performance tier. Suitable + // for more demanding workloads. + ScaleTier string `json:"scaleTier,omitempty"` // ServiceLevel: Required. Service level of the storage pool // // Possible values: @@ -2886,6 +3125,9 @@ type Volume struct { CacheParameters *CacheParameters `json:"cacheParameters,omitempty"` // CapacityGib: Required. Capacity in GIB of the volume CapacityGib int64 `json:"capacityGib,omitempty,string"` + // CloneDetails: Output only. If this volume is a clone, this field contains + // details about the clone. + CloneDetails *CloneDetails `json:"cloneDetails,omitempty"` // ColdTierSizeGib: Output only. Size of the volume cold tier data rounded down // to the nearest GiB. ColdTierSizeGib int64 `json:"coldTierSizeGib,omitempty,string"` @@ -2926,6 +3168,8 @@ type Volume struct { // LargeCapacity: Optional. Flag indicating if the volume will be a large // capacity volume or a regular volume. LargeCapacity bool `json:"largeCapacity,omitempty"` + // LargeCapacityConfig: Optional. Large capacity config for the volume. + LargeCapacityConfig *LargeCapacityConfig `json:"largeCapacityConfig,omitempty"` // LdapEnabled: Output only. Flag indicating if the volume is NFS LDAP enabled // or not. LdapEnabled bool `json:"ldapEnabled,omitempty"` @@ -8486,6 +8730,442 @@ func (c *ProjectsLocationsStoragePoolsValidateDirectoryServiceCall) Do(opts ...g return ret, nil } +type ProjectsLocationsStoragePoolsOntapExecuteOntapDeleteCall struct { + s *Service + ontapPath string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// ExecuteOntapDelete: `ExecuteOntapDelete` dispatches the ONTAP `DELETE` +// request to the `StoragePool` cluster. +// +// - ontapPath: The resource path of the ONTAP resource. Format: +// `projects/{project_number}/locations/{location_id}/storagePools/{storage_po +// ol_id}/ontap/{ontap_resource_path}`. For example: +// `projects/123456789/locations/us-central1/storagePools/my-storage-pool/onta +// p/api/storage/volumes`. +func (r *ProjectsLocationsStoragePoolsOntapService) ExecuteOntapDelete(ontapPath string) *ProjectsLocationsStoragePoolsOntapExecuteOntapDeleteCall { + c := &ProjectsLocationsStoragePoolsOntapExecuteOntapDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.ontapPath = ontapPath + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsStoragePoolsOntapExecuteOntapDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapDeleteCall) Context(ctx context.Context) *ProjectsLocationsStoragePoolsOntapExecuteOntapDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+ontapPath}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "ontapPath": c.ontapPath, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "netapp.projects.locations.storagePools.ontap.executeOntapDelete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "netapp.projects.locations.storagePools.ontap.executeOntapDelete" call. +// Any non-2xx status code is an error. Response headers are in either +// *ExecuteOntapDeleteResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapDeleteCall) Do(opts ...googleapi.CallOption) (*ExecuteOntapDeleteResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ExecuteOntapDeleteResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "netapp.projects.locations.storagePools.ontap.executeOntapDelete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsStoragePoolsOntapExecuteOntapGetCall struct { + s *Service + ontapPath string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// ExecuteOntapGet: `ExecuteOntapGet` dispatches the ONTAP `GET` request to the +// `StoragePool` cluster. +// +// - ontapPath: The resource path of the ONTAP resource. Format: +// `projects/{project_number}/locations/{location_id}/storagePools/{storage_po +// ol_id}/ontap/{ontap_resource_path}`. For example: +// `projects/123456789/locations/us-central1/storagePools/my-storage-pool/onta +// p/api/storage/volumes`. +func (r *ProjectsLocationsStoragePoolsOntapService) ExecuteOntapGet(ontapPath string) *ProjectsLocationsStoragePoolsOntapExecuteOntapGetCall { + c := &ProjectsLocationsStoragePoolsOntapExecuteOntapGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.ontapPath = ontapPath + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsStoragePoolsOntapExecuteOntapGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsStoragePoolsOntapExecuteOntapGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapGetCall) Context(ctx context.Context) *ProjectsLocationsStoragePoolsOntapExecuteOntapGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+ontapPath}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "ontapPath": c.ontapPath, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "netapp.projects.locations.storagePools.ontap.executeOntapGet", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "netapp.projects.locations.storagePools.ontap.executeOntapGet" call. +// Any non-2xx status code is an error. Response headers are in either +// *ExecuteOntapGetResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapGetCall) Do(opts ...googleapi.CallOption) (*ExecuteOntapGetResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ExecuteOntapGetResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "netapp.projects.locations.storagePools.ontap.executeOntapGet", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsStoragePoolsOntapExecuteOntapPatchCall struct { + s *Service + ontapPath string + executeontappatchrequest *ExecuteOntapPatchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// ExecuteOntapPatch: `ExecuteOntapPatch` dispatches the ONTAP `PATCH` request +// to the `StoragePool` cluster. +// +// - ontapPath: The resource path of the ONTAP resource. Format: +// `projects/{project_number}/locations/{location_id}/storagePools/{storage_po +// ol_id}/ontap/{ontap_resource_path}`. For example: +// `projects/123456789/locations/us-central1/storagePools/my-storage-pool/onta +// p/api/storage/volumes`. +func (r *ProjectsLocationsStoragePoolsOntapService) ExecuteOntapPatch(ontapPath string, executeontappatchrequest *ExecuteOntapPatchRequest) *ProjectsLocationsStoragePoolsOntapExecuteOntapPatchCall { + c := &ProjectsLocationsStoragePoolsOntapExecuteOntapPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.ontapPath = ontapPath + c.executeontappatchrequest = executeontappatchrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsStoragePoolsOntapExecuteOntapPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapPatchCall) Context(ctx context.Context) *ProjectsLocationsStoragePoolsOntapExecuteOntapPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.executeontappatchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+ontapPath}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "ontapPath": c.ontapPath, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "netapp.projects.locations.storagePools.ontap.executeOntapPatch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "netapp.projects.locations.storagePools.ontap.executeOntapPatch" call. +// Any non-2xx status code is an error. Response headers are in either +// *ExecuteOntapPatchResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapPatchCall) Do(opts ...googleapi.CallOption) (*ExecuteOntapPatchResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ExecuteOntapPatchResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "netapp.projects.locations.storagePools.ontap.executeOntapPatch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsStoragePoolsOntapExecuteOntapPostCall struct { + s *Service + ontapPath string + executeontappostrequest *ExecuteOntapPostRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// ExecuteOntapPost: `ExecuteOntapPost` dispatches the ONTAP `POST` request to +// the `StoragePool` cluster. +// +// - ontapPath: The resource path of the ONTAP resource. Format: +// `projects/{project_number}/locations/{location_id}/storagePools/{storage_po +// ol_id}/ontap/{ontap_resource_path}`. For example: +// `projects/123456789/locations/us-central1/storagePools/my-storage-pool/onta +// p/api/storage/volumes`. +func (r *ProjectsLocationsStoragePoolsOntapService) ExecuteOntapPost(ontapPath string, executeontappostrequest *ExecuteOntapPostRequest) *ProjectsLocationsStoragePoolsOntapExecuteOntapPostCall { + c := &ProjectsLocationsStoragePoolsOntapExecuteOntapPostCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.ontapPath = ontapPath + c.executeontappostrequest = executeontappostrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapPostCall) Fields(s ...googleapi.Field) *ProjectsLocationsStoragePoolsOntapExecuteOntapPostCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapPostCall) Context(ctx context.Context) *ProjectsLocationsStoragePoolsOntapExecuteOntapPostCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapPostCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapPostCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.executeontappostrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+ontapPath}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "ontapPath": c.ontapPath, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "netapp.projects.locations.storagePools.ontap.executeOntapPost", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "netapp.projects.locations.storagePools.ontap.executeOntapPost" call. +// Any non-2xx status code is an error. Response headers are in either +// *ExecuteOntapPostResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsStoragePoolsOntapExecuteOntapPostCall) Do(opts ...googleapi.CallOption) (*ExecuteOntapPostResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ExecuteOntapPostResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "netapp.projects.locations.storagePools.ontap.executeOntapPost", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsVolumesCreateCall struct { s *Service parent string diff --git a/networkmanagement/v1/networkmanagement-api.json b/networkmanagement/v1/networkmanagement-api.json index 9542a4978a..7c8765bb81 100644 --- a/networkmanagement/v1/networkmanagement-api.json +++ b/networkmanagement/v1/networkmanagement-api.json @@ -1237,7 +1237,7 @@ } } }, - "revision": "20260130", + "revision": "20260211", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -3326,6 +3326,17 @@ }, "type": "object" }, + "NgfwPacketInspectionInfo": { + "description": "For display only. Metadata associated with a layer 7 packet inspection by the firewall.", + "id": "NgfwPacketInspectionInfo", + "properties": { + "securityProfileGroupUri": { + "description": "URI of the security profile group associated with this firewall packet inspection.", + "type": "string" + } + }, + "type": "object" + }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -4124,6 +4135,10 @@ "$ref": "NetworkInfo", "description": "Display information of a Google Cloud network." }, + "ngfwPacketInspection": { + "$ref": "NgfwPacketInspectionInfo", + "description": "Display information of a layer 7 packet inspection by the firewall." + }, "projectId": { "description": "Project ID that contains the configuration this step is validating.", "type": "string" @@ -4187,6 +4202,7 @@ "ARRIVE_AT_VPC_CONNECTOR", "DIRECT_VPC_EGRESS_CONNECTION", "SERVERLESS_EXTERNAL_CONNECTION", + "NGFW_PACKET_INSPECTION", "NAT", "SKIP_GKE_POD_IP_MASQUERADING", "PROXY_CONNECTION", @@ -4236,6 +4252,7 @@ false, false, false, + false, false ], "enumDescriptions": [ @@ -4271,6 +4288,7 @@ "Forwarding state: arriving at a VPC connector.", "Forwarding state: for packets originating from a serverless endpoint forwarded through Direct VPC egress.", "Forwarding state: for packets originating from a serverless endpoint forwarded through public (external) connectivity.", + "Forwarding state: Layer 7 packet inspection by the firewall endpoint based on the configured security profile group.", "Transition state: packet header translated. The `nat` field is populated with the translation information.", "Transition state: GKE Pod IP masquerading is skipped. The `ip_masquerading_skipped` field is populated with the reason.", "Transition state: original connection is terminated and a new proxied connection is initiated.", diff --git a/networkmanagement/v1/networkmanagement-gen.go b/networkmanagement/v1/networkmanagement-gen.go index 22464b8a68..19acea74e6 100644 --- a/networkmanagement/v1/networkmanagement-gen.go +++ b/networkmanagement/v1/networkmanagement-gen.go @@ -2622,6 +2622,30 @@ func (s NetworkInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// NgfwPacketInspectionInfo: For display only. Metadata associated with a layer +// 7 packet inspection by the firewall. +type NgfwPacketInspectionInfo struct { + // SecurityProfileGroupUri: URI of the security profile group associated with + // this firewall packet inspection. + SecurityProfileGroupUri string `json:"securityProfileGroupUri,omitempty"` + // ForceSendFields is a list of field names (e.g. "SecurityProfileGroupUri") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "SecurityProfileGroupUri") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s NgfwPacketInspectionInfo) MarshalJSON() ([]byte, error) { + type NoMethod NgfwPacketInspectionInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Operation: This resource represents a long-running operation that is the // result of a network API call. type Operation struct { @@ -3458,6 +3482,9 @@ type Step struct { Nat *NatInfo `json:"nat,omitempty"` // Network: Display information of a Google Cloud network. Network *NetworkInfo `json:"network,omitempty"` + // NgfwPacketInspection: Display information of a layer 7 packet inspection by + // the firewall. + NgfwPacketInspection *NgfwPacketInspectionInfo `json:"ngfwPacketInspection,omitempty"` // ProjectId: Project ID that contains the configuration this step is // validating. ProjectId string `json:"projectId,omitempty"` @@ -3552,6 +3579,8 @@ type Step struct { // "SERVERLESS_EXTERNAL_CONNECTION" - Forwarding state: for packets // originating from a serverless endpoint forwarded through public (external) // connectivity. + // "NGFW_PACKET_INSPECTION" - Forwarding state: Layer 7 packet inspection by + // the firewall endpoint based on the configured security profile group. // "NAT" - Transition state: packet header translated. The `nat` field is // populated with the translation information. // "SKIP_GKE_POD_IP_MASQUERADING" - Transition state: GKE Pod IP masquerading diff --git a/networkmanagement/v1beta1/networkmanagement-api.json b/networkmanagement/v1beta1/networkmanagement-api.json index ea6bfd7a94..3faf1f37b9 100644 --- a/networkmanagement/v1beta1/networkmanagement-api.json +++ b/networkmanagement/v1beta1/networkmanagement-api.json @@ -1237,7 +1237,7 @@ } } }, - "revision": "20260130", + "revision": "20260211", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -3326,6 +3326,17 @@ }, "type": "object" }, + "NgfwPacketInspectionInfo": { + "description": "For display only. Metadata associated with a layer 7 packet inspection by the firewall.", + "id": "NgfwPacketInspectionInfo", + "properties": { + "securityProfileGroupUri": { + "description": "URI of the security profile group associated with this firewall packet inspection.", + "type": "string" + } + }, + "type": "object" + }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -4124,6 +4135,10 @@ "$ref": "NetworkInfo", "description": "Display information of a Google Cloud network." }, + "ngfwPacketInspection": { + "$ref": "NgfwPacketInspectionInfo", + "description": "Display information of a layer 7 packet inspection by the firewall." + }, "projectId": { "description": "Project ID that contains the configuration this step is validating.", "type": "string" @@ -4187,6 +4202,7 @@ "ARRIVE_AT_VPC_CONNECTOR", "DIRECT_VPC_EGRESS_CONNECTION", "SERVERLESS_EXTERNAL_CONNECTION", + "NGFW_PACKET_INSPECTION", "NAT", "SKIP_GKE_POD_IP_MASQUERADING", "PROXY_CONNECTION", @@ -4236,6 +4252,7 @@ false, false, false, + false, false ], "enumDescriptions": [ @@ -4271,6 +4288,7 @@ "Forwarding state: arriving at a VPC connector.", "Forwarding state: for packets originating from a serverless endpoint forwarded through Direct VPC egress.", "Forwarding state: for packets originating from a serverless endpoint forwarded through public (external) connectivity.", + "Forwarding state: Layer 7 packet inspection by the firewall endpoint based on the configured security profile group.", "Transition state: packet header translated. The `nat` field is populated with the translation information.", "Transition state: GKE Pod IP masquerading is skipped. The `ip_masquerading_skipped` field is populated with the reason.", "Transition state: original connection is terminated and a new proxied connection is initiated.", diff --git a/networkmanagement/v1beta1/networkmanagement-gen.go b/networkmanagement/v1beta1/networkmanagement-gen.go index b789c02e0d..0c5048ef7b 100644 --- a/networkmanagement/v1beta1/networkmanagement-gen.go +++ b/networkmanagement/v1beta1/networkmanagement-gen.go @@ -2620,6 +2620,30 @@ func (s NetworkInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// NgfwPacketInspectionInfo: For display only. Metadata associated with a layer +// 7 packet inspection by the firewall. +type NgfwPacketInspectionInfo struct { + // SecurityProfileGroupUri: URI of the security profile group associated with + // this firewall packet inspection. + SecurityProfileGroupUri string `json:"securityProfileGroupUri,omitempty"` + // ForceSendFields is a list of field names (e.g. "SecurityProfileGroupUri") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "SecurityProfileGroupUri") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s NgfwPacketInspectionInfo) MarshalJSON() ([]byte, error) { + type NoMethod NgfwPacketInspectionInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Operation: This resource represents a long-running operation that is the // result of a network API call. type Operation struct { @@ -3456,6 +3480,9 @@ type Step struct { Nat *NatInfo `json:"nat,omitempty"` // Network: Display information of a Google Cloud network. Network *NetworkInfo `json:"network,omitempty"` + // NgfwPacketInspection: Display information of a layer 7 packet inspection by + // the firewall. + NgfwPacketInspection *NgfwPacketInspectionInfo `json:"ngfwPacketInspection,omitempty"` // ProjectId: Project ID that contains the configuration this step is // validating. ProjectId string `json:"projectId,omitempty"` @@ -3552,6 +3579,8 @@ type Step struct { // "SERVERLESS_EXTERNAL_CONNECTION" - Forwarding state: for packets // originating from a serverless endpoint forwarded through public (external) // connectivity. + // "NGFW_PACKET_INSPECTION" - Forwarding state: Layer 7 packet inspection by + // the firewall endpoint based on the configured security profile group. // "NAT" - Transition state: packet header translated. The `nat` field is // populated with the translation information. // "SKIP_GKE_POD_IP_MASQUERADING" - Transition state: GKE Pod IP masquerading diff --git a/oracledatabase/v1/oracledatabase-api.json b/oracledatabase/v1/oracledatabase-api.json index 6ead72e227..36834e100b 100644 --- a/oracledatabase/v1/oracledatabase-api.json +++ b/oracledatabase/v1/oracledatabase-api.json @@ -16,10 +16,80 @@ "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/oracle/database/docs", "endpoints": [ + { + "description": "Regional Endpoint", + "endpointUrl": "https://oracledatabase.asia-northeast1.rep.googleapis.com/", + "location": "asia-northeast1" + }, { "description": "Regional Endpoint", "endpointUrl": "https://oracledatabase.asia-northeast2.rep.googleapis.com/", "location": "asia-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://oracledatabase.asia-south1.rep.googleapis.com/", + "location": "asia-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://oracledatabase.asia-south2.rep.googleapis.com/", + "location": "asia-south2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://oracledatabase.australia-southeast1.rep.googleapis.com/", + "location": "australia-southeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://oracledatabase.australia-southeast2.rep.googleapis.com/", + "location": "australia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://oracledatabase.europe-west2.rep.googleapis.com/", + "location": "europe-west2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://oracledatabase.europe-west3.rep.googleapis.com/", + "location": "europe-west3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://oracledatabase.europe-west8.rep.googleapis.com/", + "location": "europe-west8" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://oracledatabase.northamerica-northeast1.rep.googleapis.com/", + "location": "northamerica-northeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://oracledatabase.northamerica-northeast2.rep.googleapis.com/", + "location": "northamerica-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://oracledatabase.southamerica-east1.rep.googleapis.com/", + "location": "southamerica-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://oracledatabase.us-central1.rep.googleapis.com/", + "location": "us-central1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://oracledatabase.us-east4.rep.googleapis.com/", + "location": "us-east4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://oracledatabase.us-west3.rep.googleapis.com/", + "location": "us-west3" } ], "fullyEncodeReservedExpansion": true, @@ -2479,7 +2549,7 @@ } } }, - "revision": "20260212", + "revision": "20260220", "rootUrl": "https://oracledatabase.googleapis.com/", "schemas": { "AllConnectionStrings": { diff --git a/run/v1/run-api.json b/run/v1/run-api.json index 3196767e4a..b02bb0b374 100644 --- a/run/v1/run-api.json +++ b/run/v1/run-api.json @@ -620,7 +620,9 @@ "$ref": "ListAuthorizedDomainsResponse" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] } } @@ -751,7 +753,8 @@ "$ref": "DomainMapping" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run" ] }, "delete": { @@ -796,7 +799,8 @@ "$ref": "Status" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run" ] }, "get": { @@ -821,7 +825,9 @@ "$ref": "DomainMapping" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] }, "list": { @@ -882,7 +888,9 @@ "$ref": "ListDomainMappingsResponse" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] } } @@ -1730,7 +1738,8 @@ "$ref": "Service" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run" ] }, "delete": { @@ -1775,7 +1784,8 @@ "$ref": "Status" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run" ] }, "get": { @@ -1800,7 +1810,9 @@ "$ref": "Service" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] }, "list": { @@ -1861,7 +1873,9 @@ "$ref": "ListServicesResponse" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] }, "replaceService": { @@ -1894,7 +1908,8 @@ "$ref": "Service" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run" ] } } @@ -2194,7 +2209,9 @@ "$ref": "ListAuthorizedDomainsResponse" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] } } @@ -2285,7 +2302,9 @@ "$ref": "ListAuthorizedDomainsResponse" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] } } @@ -2416,7 +2435,8 @@ "$ref": "DomainMapping" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run" ] }, "delete": { @@ -2461,7 +2481,8 @@ "$ref": "Status" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run" ] }, "get": { @@ -2486,7 +2507,9 @@ "$ref": "DomainMapping" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] }, "list": { @@ -2547,7 +2570,9 @@ "$ref": "ListDomainMappingsResponse" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] } } @@ -3119,7 +3144,8 @@ "$ref": "Service" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run" ] }, "delete": { @@ -3164,7 +3190,8 @@ "$ref": "Status" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run" ] }, "get": { @@ -3189,7 +3216,9 @@ "$ref": "Service" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] }, "getIamPolicy": { @@ -3220,7 +3249,9 @@ "$ref": "Policy" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] }, "list": { @@ -3281,7 +3312,9 @@ "$ref": "ListServicesResponse" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] }, "replaceService": { @@ -3314,7 +3347,8 @@ "$ref": "Service" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run" ] }, "setIamPolicy": { @@ -3342,7 +3376,8 @@ "$ref": "Policy" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run" ] }, "testIamPermissions": { @@ -3370,7 +3405,9 @@ "$ref": "TestIamPermissionsResponse" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] } } @@ -3471,7 +3508,7 @@ } } }, - "revision": "20260206", + "revision": "20260213", "rootUrl": "https://run.googleapis.com/", "schemas": { "Addressable": { diff --git a/run/v2/run-api.json b/run/v2/run-api.json index e6931712eb..b6a359cbf9 100644 --- a/run/v2/run-api.json +++ b/run/v2/run-api.json @@ -4,6 +4,12 @@ "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." + }, + "https://www.googleapis.com/auth/run": { + "description": "See, edit, configure, and delete your Google Cloud Run data and see the email address for your Google Account" + }, + "https://www.googleapis.com/auth/run.readonly": { + "description": "See your Google Cloud Run data and the email address of your Google Account" } } } @@ -1615,7 +1621,8 @@ "$ref": "GoogleLongrunningOperation" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run" ] }, "delete": { @@ -1650,7 +1657,8 @@ "$ref": "GoogleLongrunningOperation" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run" ] }, "get": { @@ -1675,7 +1683,9 @@ "$ref": "GoogleCloudRunV2Service" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] }, "getIamPolicy": { @@ -1706,7 +1716,9 @@ "$ref": "GoogleIamV1Policy" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] }, "list": { @@ -1747,7 +1759,9 @@ "$ref": "GoogleCloudRunV2ListServicesResponse" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] }, "patch": { @@ -1764,6 +1778,11 @@ "location": "query", "type": "boolean" }, + "forceNewRevision": { + "description": "Optional. If set to true, a new revision will be created from the template even if the system doesn't detect any changes from the previously deployed revision. This may be useful for cases where the underlying resources need to be recreated or reinitialized. For example if the image is specified by label, but the underlying image digest has changed) or if the container performs deployment initialization work that needs to be performed again.", + "location": "query", + "type": "boolean" + }, "name": { "description": "Identifier. The fully qualified name of this Service. In CreateServiceRequest, this field is ignored, and instead composed from CreateServiceRequest.parent and CreateServiceRequest.service_id. Format: projects/{project}/locations/{location}/services/{service_id}", "location": "path", @@ -1791,7 +1810,8 @@ "$ref": "GoogleLongrunningOperation" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run" ] }, "setIamPolicy": { @@ -1819,7 +1839,8 @@ "$ref": "GoogleIamV1Policy" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run" ] }, "testIamPermissions": { @@ -1847,7 +1868,9 @@ "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly" ] } }, @@ -2383,7 +2406,7 @@ } } }, - "revision": "20260206", + "revision": "20260213", "rootUrl": "https://run.googleapis.com/", "schemas": { "GoogleCloudRunV2BinaryAuthorization": { @@ -2528,7 +2551,7 @@ "id": "GoogleCloudRunV2CloudSqlInstance", "properties": { "instances": { - "description": "The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance}", + "description": "A list of Cloud SQL instance connection names. Cloud Run uses these to establish connections to the specified Cloud SQL instances. While the SQL instance name itself is unique within a project, the full connection name requires the location for proper routing. Format: `{project}:{location}:{instance}` Example: `my-project:us-central1:my-instance` You can find this value on the instance's **Overview** page in the Google Cloud console or by using the following `gcloud` command: ```sh gcloud sql instances describe INSTANCE_NAME \\ --format='value(connectionName)' ``` Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run.", "items": { "type": "string" }, @@ -4171,7 +4194,7 @@ "type": "array" }, "containers": { - "description": "Containers holds the list which define the units of execution for this Revision.", + "description": "Holds the list which define the units of execution for this Revision.", "items": { "$ref": "GoogleCloudRunV2Container" }, @@ -4381,12 +4404,12 @@ "id": "GoogleCloudRunV2RevisionScaling", "properties": { "concurrencyUtilization": { - "description": "Optional. Determines a threshold for concurrency utilization before scaling begins.", + "description": "Optional. Determines a threshold for concurrency utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable concurrency utilization as threshold for scaling.", "format": "float", "type": "number" }, "cpuUtilization": { - "description": "Optional. Determines a threshold for CPU utilization before scaling begins.", + "description": "Optional. Determines a threshold for CPU utilization before scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or `0.0` to disable CPU utilization as threshold for scaling.", "format": "float", "type": "number" }, @@ -4435,7 +4458,7 @@ "type": "string" }, "containers": { - "description": "Holds the single container that defines the unit of execution for this Revision.", + "description": "Holds the list which define the units of execution for this Revision.", "items": { "$ref": "GoogleCloudRunV2Container" }, diff --git a/run/v2/run-gen.go b/run/v2/run-gen.go index 5b6b01a940..935b7b4eb1 100644 --- a/run/v2/run-gen.go +++ b/run/v2/run-gen.go @@ -34,6 +34,11 @@ // // # Other authentication options // +// By default, all available scopes (see "Constants") are used to authenticate. +// To restrict scopes, use [google.golang.org/api/option.WithScopes]: +// +// runService, err := run.NewService(ctx, option.WithScopes(run.RunReadonlyScope)) +// // To use an API key for authentication (note: some APIs do not support API // keys), use [google.golang.org/api/option.WithAPIKey]: // @@ -101,12 +106,21 @@ const ( // See, edit, configure, and delete your Google Cloud data and see the email // address for your Google Account. CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform" + + // See, edit, configure, and delete your Google Cloud Run data and see the + // email address for your Google Account + RunScope = "https://www.googleapis.com/auth/run" + + // See your Google Cloud Run data and the email address of your Google Account + RunReadonlyScope = "https://www.googleapis.com/auth/run.readonly" ) // NewService creates a new Service. func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error) { scopesOption := internaloption.WithDefaultScopes( "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/run", + "https://www.googleapis.com/auth/run.readonly", ) // NOTE: prepend, so we don't override user-specified scopes. opts = append([]option.ClientOption{scopesOption}, opts...) @@ -482,11 +496,17 @@ func (s GoogleCloudRunV2CancelExecutionRequest) MarshalJSON() ([]byte, error) { // https://cloud.google.com/sql/docs/mysql/connect-run for more information on // how to connect Cloud SQL and Cloud Run. type GoogleCloudRunV2CloudSqlInstance struct { - // Instances: The Cloud SQL instance connection names, as can be found in - // https://console.cloud.google.com/sql/instances. Visit + // Instances: A list of Cloud SQL instance connection names. Cloud Run uses + // these to establish connections to the specified Cloud SQL instances. While + // the SQL instance name itself is unique within a project, the full connection + // name requires the location for proper routing. Format: + // `{project}:{location}:{instance}` Example: + // `my-project:us-central1:my-instance` You can find this value on the + // instance's **Overview** page in the Google Cloud console or by using the + // following `gcloud` command: ```sh gcloud sql instances describe + // INSTANCE_NAME \ --format='value(connectionName)' ``` Visit // https://cloud.google.com/sql/docs/mysql/connect-run for more information on - // how to connect Cloud SQL and Cloud Run. Format: - // {project}:{location}:{instance} + // how to connect Cloud SQL and Cloud Run. Instances []string `json:"instances,omitempty"` // ForceSendFields is a list of field names (e.g. "Instances") to // unconditionally include in API requests. By default, fields with empty or @@ -2303,8 +2323,8 @@ type GoogleCloudRunV2Revision struct { // readiness status, and detailed error information in case it did not reach a // serving state. Conditions []*GoogleCloudRunV2Condition `json:"conditions,omitempty"` - // Containers: Containers holds the list which define the units of execution - // for this Revision. + // Containers: Holds the list which define the units of execution for this + // Revision. Containers []*GoogleCloudRunV2Container `json:"containers,omitempty"` // CreateTime: Output only. The creation time. CreateTime string `json:"createTime,omitempty"` @@ -2470,10 +2490,13 @@ func (s GoogleCloudRunV2Revision) MarshalJSON() ([]byte, error) { // settings. type GoogleCloudRunV2RevisionScaling struct { // ConcurrencyUtilization: Optional. Determines a threshold for concurrency - // utilization before scaling begins. + // utilization before scaling begins. Accepted values are between `0.4` and + // `0.95` (inclusive) or `0.0` to disable concurrency utilization as threshold + // for scaling. ConcurrencyUtilization float64 `json:"concurrencyUtilization,omitempty"` // CpuUtilization: Optional. Determines a threshold for CPU utilization before - // scaling begins. + // scaling begins. Accepted values are between `0.4` and `0.95` (inclusive) or + // `0.0` to disable CPU utilization as threshold for scaling. CpuUtilization float64 `json:"cpuUtilization,omitempty"` // MaxInstanceCount: Optional. Maximum number of serving instances that this // resource should have. When unspecified, the field is set to the server @@ -2557,8 +2580,8 @@ type GoogleCloudRunV2RevisionTemplate struct { Client string `json:"client,omitempty"` // ClientVersion: Optional. Arbitrary version identifier for the API client. ClientVersion string `json:"clientVersion,omitempty"` - // Containers: Holds the single container that defines the unit of execution - // for this Revision. + // Containers: Holds the list which define the units of execution for this + // Revision. Containers []*GoogleCloudRunV2Container `json:"containers,omitempty"` // EncryptionKey: A reference to a customer managed encryption key (CMEK) to // use to encrypt this container image. For more information, go to @@ -10757,6 +10780,18 @@ func (c *ProjectsLocationsServicesPatchCall) AllowMissing(allowMissing bool) *Pr return c } +// ForceNewRevision sets the optional parameter "forceNewRevision": If set to +// true, a new revision will be created from the template even if the system +// doesn't detect any changes from the previously deployed revision. This may +// be useful for cases where the underlying resources need to be recreated or +// reinitialized. For example if the image is specified by label, but the +// underlying image digest has changed) or if the container performs deployment +// initialization work that needs to be performed again. +func (c *ProjectsLocationsServicesPatchCall) ForceNewRevision(forceNewRevision bool) *ProjectsLocationsServicesPatchCall { + c.urlParams_.Set("forceNewRevision", fmt.Sprint(forceNewRevision)) + return c +} + // UpdateMask sets the optional parameter "updateMask": The list of fields to // be updated. func (c *ProjectsLocationsServicesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsServicesPatchCall { diff --git a/saasservicemgmt/v1beta1/saasservicemgmt-api.json b/saasservicemgmt/v1beta1/saasservicemgmt-api.json index f7a969bf3f..b357faa45f 100644 --- a/saasservicemgmt/v1beta1/saasservicemgmt-api.json +++ b/saasservicemgmt/v1beta1/saasservicemgmt-api.json @@ -1804,7 +1804,7 @@ } } }, - "revision": "20260128", + "revision": "20260214", "rootUrl": "https://saasservicemgmt.googleapis.com/", "schemas": { "Aggregate": { @@ -3059,7 +3059,7 @@ "type": "object" }, "UnitOperation": { - "description": "UnitOperation encapsulates the intent of changing/interacting with the service component represented by the specific Unit. Multiple UnitOperations can be created (requested) and scheduled in the future, however only one will be allowed to execute at a time (that can change in the future for non-mutating operations). UnitOperations allow different actors interacting with the same unit to focus only on the change they have requested. This is a base object that contains the common fields in all unit operations. Next: 19", + "description": "UnitOperation encapsulates the intent of changing/interacting with the service component represented by the specific Unit. Multiple UnitOperations can be created (requested) and scheduled in the future, however only one will be allowed to execute at a time (that can change in the future for non-mutating operations). UnitOperations allow different actors interacting with the same unit to focus only on the change they have requested. This is a base object that contains the common fields in all unit operations. Next: 22", "id": "UnitOperation", "properties": { "annotations": { @@ -3237,14 +3237,18 @@ "TYPE_SCHEDULED", "TYPE_RUNNING", "TYPE_SUCCEEDED", - "TYPE_CANCELLED" + "TYPE_CANCELLED", + "TYPE_APP_CREATED", + "TYPE_APP_COMPONENTS_REGISTERED" ], "enumDescriptions": [ "Condition type is unspecified.", "Condition type is scheduled.", "Condition type is running.", "Condition type is succeeded.", - "Condition type is cancelled." + "Condition type is cancelled.", + "Indicates if AppHub app has been created.", + "Indicates if services and workloads have been registered with AppHub." ], "type": "string" } diff --git a/saasservicemgmt/v1beta1/saasservicemgmt-gen.go b/saasservicemgmt/v1beta1/saasservicemgmt-gen.go index cb87e6db25..ab4f8c94ea 100644 --- a/saasservicemgmt/v1beta1/saasservicemgmt-gen.go +++ b/saasservicemgmt/v1beta1/saasservicemgmt-gen.go @@ -1694,7 +1694,7 @@ func (s UnitKind) MarshalJSON() ([]byte, error) { // the future for non-mutating operations). UnitOperations allow different // actors interacting with the same unit to focus only on the change they have // requested. This is a base object that contains the common fields in all unit -// operations. Next: 19 +// operations. Next: 22 type UnitOperation struct { // Annotations: Optional. Annotations is an unstructured key-value map stored // with a resource that may be set by external tools to store and retrieve @@ -1832,6 +1832,9 @@ type UnitOperationCondition struct { // "TYPE_RUNNING" - Condition type is running. // "TYPE_SUCCEEDED" - Condition type is succeeded. // "TYPE_CANCELLED" - Condition type is cancelled. + // "TYPE_APP_CREATED" - Indicates if AppHub app has been created. + // "TYPE_APP_COMPONENTS_REGISTERED" - Indicates if services and workloads + // have been registered with AppHub. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "LastTransitionTime") to // unconditionally include in API requests. By default, fields with empty or diff --git a/secretmanager/v1/secretmanager-api.json b/secretmanager/v1/secretmanager-api.json index d0bb4c924f..9c618f7165 100644 --- a/secretmanager/v1/secretmanager-api.json +++ b/secretmanager/v1/secretmanager-api.json @@ -435,131 +435,6 @@ } }, "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": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", - "httpMethod": "POST", - "id": "secretmanager.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": "v1/{+name}:cancel", - "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": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", - "httpMethod": "DELETE", - "id": "secretmanager.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": "v1/{+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": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", - "httpMethod": "GET", - "id": "secretmanager.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": "v1/{+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": "v1/projects/{projectsId}/locations/{locationsId}/operations", - "httpMethod": "GET", - "id": "secretmanager.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" - }, - "returnPartialSuccess": { - "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", - "location": "query", - "type": "boolean" - } - }, - "path": "v1/{+name}/operations", - "response": { - "$ref": "ListOperationsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - } - } - }, "secrets": { "methods": { "addVersion": { @@ -1491,7 +1366,7 @@ } } }, - "revision": "20260127", + "revision": "20260213", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { @@ -1715,31 +1590,6 @@ }, "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" - }, - "unreachable": { - "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "ListSecretVersionsResponse": { "description": "Response message for SecretManagerService.ListSecretVersions.", "id": "ListSecretVersionsResponse", diff --git a/secretmanager/v1/secretmanager-gen.go b/secretmanager/v1/secretmanager-gen.go index 16518b3234..43961f7fab 100644 --- a/secretmanager/v1/secretmanager-gen.go +++ b/secretmanager/v1/secretmanager-gen.go @@ -171,7 +171,6 @@ type ProjectsService struct { func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs := &ProjectsLocationsService{s: s} - rs.Operations = NewProjectsLocationsOperationsService(s) rs.Secrets = NewProjectsLocationsSecretsService(s) return rs } @@ -179,20 +178,9 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { type ProjectsLocationsService struct { s *Service - Operations *ProjectsLocationsOperationsService - Secrets *ProjectsLocationsSecretsService } -func NewProjectsLocationsOperationsService(s *Service) *ProjectsLocationsOperationsService { - rs := &ProjectsLocationsOperationsService{s: s} - return rs -} - -type ProjectsLocationsOperationsService struct { - s *Service -} - func NewProjectsLocationsSecretsService(s *Service) *ProjectsLocationsSecretsService { rs := &ProjectsLocationsSecretsService{s: s} rs.Versions = NewProjectsLocationsSecretsVersionsService(s) @@ -729,39 +717,6 @@ func (s ListLocationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ListOperationsResponse: The response message for Operations.ListOperations. -type ListOperationsResponse struct { - // NextPageToken: The standard List next-page token. - NextPageToken string `json:"nextPageToken,omitempty"` - // Operations: A list of operations that matches the specified filter in the - // request. - Operations []*Operation `json:"operations,omitempty"` - // Unreachable: Unordered list. Unreachable resources. Populated when the - // request sets `ListOperationsRequest.return_partial_success` and reads across - // collections. For example, when attempting to list all resources across all - // supported locations. - Unreachable []string `json:"unreachable,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "NextPageToken") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "NextPageToken") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ListOperationsResponse) MarshalJSON() ([]byte, error) { - type NoMethod ListOperationsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ListSecretVersionsResponse: Response message for // SecretManagerService.ListSecretVersions. type ListSecretVersionsResponse struct { @@ -891,9 +846,6 @@ type Operation struct { // original method name. For example, if the original method name is // `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`. Response googleapi.RawMessage `json:"response,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "Done") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -1839,487 +1791,6 @@ func (c *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocat } } -type ProjectsLocationsOperationsCancelCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Cancel: 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`. -// -// - name: The name of the operation resource to be cancelled. -func (r *ProjectsLocationsOperationsService) Cancel(name string) *ProjectsLocationsOperationsCancelCall { - c := &ProjectsLocationsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsOperationsCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsCancelCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsOperationsCancelCall) Context(ctx context.Context) *ProjectsLocationsOperationsCancelCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsOperationsCancelCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsOperationsCancelCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:cancel") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "secretmanager.projects.locations.operations.cancel", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "secretmanager.projects.locations.operations.cancel" call. -// Any non-2xx status code is an error. Response headers are in either -// *Empty.ServerResponse.Header or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *ProjectsLocationsOperationsCancelCall) Do(opts ...googleapi.CallOption) (*Empty, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Empty{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "secretmanager.projects.locations.operations.cancel", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsOperationsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Delete: 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`. -// -// - name: The name of the operation resource to be deleted. -func (r *ProjectsLocationsOperationsService) Delete(name string) *ProjectsLocationsOperationsDeleteCall { - c := &ProjectsLocationsOperationsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsOperationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsDeleteCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsOperationsDeleteCall) Context(ctx context.Context) *ProjectsLocationsOperationsDeleteCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsOperationsDeleteCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "secretmanager.projects.locations.operations.delete", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "secretmanager.projects.locations.operations.delete" call. -// Any non-2xx status code is an error. Response headers are in either -// *Empty.ServerResponse.Header or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *ProjectsLocationsOperationsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Empty{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "secretmanager.projects.locations.operations.delete", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsOperationsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// Get: 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. -// -// - name: The name of the operation resource. -func (r *ProjectsLocationsOperationsService) Get(name string) *ProjectsLocationsOperationsGetCall { - c := &ProjectsLocationsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsGetCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsOperationsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsOperationsGetCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsOperationsGetCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsOperationsGetCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "secretmanager.projects.locations.operations.get", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "secretmanager.projects.locations.operations.get" call. -// Any non-2xx status code is an error. Response headers are in either -// *Operation.ServerResponse.Header or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *ProjectsLocationsOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Operation{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "secretmanager.projects.locations.operations.get", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsOperationsListCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// List: Lists operations that match the specified filter in the request. If -// the server doesn't support this method, it returns `UNIMPLEMENTED`. -// -// - name: The name of the operation's parent resource. -func (r *ProjectsLocationsOperationsService) List(name string) *ProjectsLocationsOperationsListCall { - c := &ProjectsLocationsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Filter sets the optional parameter "filter": The standard list filter. -func (c *ProjectsLocationsOperationsListCall) Filter(filter string) *ProjectsLocationsOperationsListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// PageSize sets the optional parameter "pageSize": The standard list page -// size. -func (c *ProjectsLocationsOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsOperationsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": The standard list page -// token. -func (c *ProjectsLocationsOperationsListCall) PageToken(pageToken string) *ProjectsLocationsOperationsListCall { - c.urlParams_.Set("pageToken", pageToken) - return c -} - -// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": -// When set to `true`, operations that are reachable are returned as normal, -// and those that are unreachable are returned in the -// ListOperationsResponse.unreachable field. This can only be `true` when -// reading across collections. For example, when `parent` is set to -// "projects/example/locations/-". This field is not supported by default and -// will result in an `UNIMPLEMENTED` error if set unless explicitly documented -// otherwise in service or product specific documentation. -func (c *ProjectsLocationsOperationsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsOperationsListCall { - c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsListCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsOperationsListCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsOperationsListCall) Context(ctx context.Context) *ProjectsLocationsOperationsListCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsOperationsListCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsOperationsListCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/operations") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "secretmanager.projects.locations.operations.list", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "secretmanager.projects.locations.operations.list" call. -// Any non-2xx status code is an error. Response headers are in either -// *ListOperationsResponse.ServerResponse.Header or (if a response was returned -// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ProjectsLocationsOperationsListCall) Do(opts ...googleapi.CallOption) (*ListOperationsResponse, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &ListOperationsResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "secretmanager.projects.locations.operations.list", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsOperationsListCall) Pages(ctx context.Context, f func(*ListOperationsResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.PageToken(x.NextPageToken) - } -} - type ProjectsLocationsSecretsAddVersionCall struct { s *Service parent string diff --git a/secretmanager/v1beta2/secretmanager-api.json b/secretmanager/v1beta2/secretmanager-api.json index 0401296236..84d4899434 100644 --- a/secretmanager/v1beta2/secretmanager-api.json +++ b/secretmanager/v1beta2/secretmanager-api.json @@ -435,131 +435,6 @@ } }, "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": "v1beta2/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", - "httpMethod": "POST", - "id": "secretmanager.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": "v1beta2/{+name}:cancel", - "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": "v1beta2/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", - "httpMethod": "DELETE", - "id": "secretmanager.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": "v1beta2/{+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": "v1beta2/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", - "httpMethod": "GET", - "id": "secretmanager.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": "v1beta2/{+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": "v1beta2/projects/{projectsId}/locations/{locationsId}/operations", - "httpMethod": "GET", - "id": "secretmanager.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" - }, - "returnPartialSuccess": { - "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", - "location": "query", - "type": "boolean" - } - }, - "path": "v1beta2/{+name}/operations", - "response": { - "$ref": "ListOperationsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - } - } - }, "secrets": { "methods": { "addVersion": { @@ -1491,7 +1366,7 @@ } } }, - "revision": "20260127", + "revision": "20260213", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { @@ -1715,31 +1590,6 @@ }, "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" - }, - "unreachable": { - "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "ListSecretVersionsResponse": { "description": "Response message for SecretManagerService.ListSecretVersions.", "id": "ListSecretVersionsResponse", diff --git a/secretmanager/v1beta2/secretmanager-gen.go b/secretmanager/v1beta2/secretmanager-gen.go index 612768b1ab..2491b7a0d9 100644 --- a/secretmanager/v1beta2/secretmanager-gen.go +++ b/secretmanager/v1beta2/secretmanager-gen.go @@ -171,7 +171,6 @@ type ProjectsService struct { func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs := &ProjectsLocationsService{s: s} - rs.Operations = NewProjectsLocationsOperationsService(s) rs.Secrets = NewProjectsLocationsSecretsService(s) return rs } @@ -179,20 +178,9 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { type ProjectsLocationsService struct { s *Service - Operations *ProjectsLocationsOperationsService - Secrets *ProjectsLocationsSecretsService } -func NewProjectsLocationsOperationsService(s *Service) *ProjectsLocationsOperationsService { - rs := &ProjectsLocationsOperationsService{s: s} - return rs -} - -type ProjectsLocationsOperationsService struct { - s *Service -} - func NewProjectsLocationsSecretsService(s *Service) *ProjectsLocationsSecretsService { rs := &ProjectsLocationsSecretsService{s: s} rs.Versions = NewProjectsLocationsSecretsVersionsService(s) @@ -729,39 +717,6 @@ func (s ListLocationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ListOperationsResponse: The response message for Operations.ListOperations. -type ListOperationsResponse struct { - // NextPageToken: The standard List next-page token. - NextPageToken string `json:"nextPageToken,omitempty"` - // Operations: A list of operations that matches the specified filter in the - // request. - Operations []*Operation `json:"operations,omitempty"` - // Unreachable: Unordered list. Unreachable resources. Populated when the - // request sets `ListOperationsRequest.return_partial_success` and reads across - // collections. For example, when attempting to list all resources across all - // supported locations. - Unreachable []string `json:"unreachable,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "NextPageToken") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "NextPageToken") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ListOperationsResponse) MarshalJSON() ([]byte, error) { - type NoMethod ListOperationsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ListSecretVersionsResponse: Response message for // SecretManagerService.ListSecretVersions. type ListSecretVersionsResponse struct { @@ -891,9 +846,6 @@ type Operation struct { // original method name. For example, if the original method name is // `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`. Response googleapi.RawMessage `json:"response,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "Done") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -1839,487 +1791,6 @@ func (c *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocat } } -type ProjectsLocationsOperationsCancelCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Cancel: 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`. -// -// - name: The name of the operation resource to be cancelled. -func (r *ProjectsLocationsOperationsService) Cancel(name string) *ProjectsLocationsOperationsCancelCall { - c := &ProjectsLocationsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsOperationsCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsCancelCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsOperationsCancelCall) Context(ctx context.Context) *ProjectsLocationsOperationsCancelCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsOperationsCancelCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsOperationsCancelCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta2/{+name}:cancel") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "secretmanager.projects.locations.operations.cancel", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "secretmanager.projects.locations.operations.cancel" call. -// Any non-2xx status code is an error. Response headers are in either -// *Empty.ServerResponse.Header or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *ProjectsLocationsOperationsCancelCall) Do(opts ...googleapi.CallOption) (*Empty, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Empty{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "secretmanager.projects.locations.operations.cancel", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsOperationsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Delete: 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`. -// -// - name: The name of the operation resource to be deleted. -func (r *ProjectsLocationsOperationsService) Delete(name string) *ProjectsLocationsOperationsDeleteCall { - c := &ProjectsLocationsOperationsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsOperationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsDeleteCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsOperationsDeleteCall) Context(ctx context.Context) *ProjectsLocationsOperationsDeleteCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsOperationsDeleteCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta2/{+name}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "secretmanager.projects.locations.operations.delete", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "secretmanager.projects.locations.operations.delete" call. -// Any non-2xx status code is an error. Response headers are in either -// *Empty.ServerResponse.Header or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *ProjectsLocationsOperationsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Empty{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "secretmanager.projects.locations.operations.delete", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsOperationsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// Get: 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. -// -// - name: The name of the operation resource. -func (r *ProjectsLocationsOperationsService) Get(name string) *ProjectsLocationsOperationsGetCall { - c := &ProjectsLocationsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsGetCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsOperationsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsOperationsGetCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsOperationsGetCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsOperationsGetCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta2/{+name}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "secretmanager.projects.locations.operations.get", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "secretmanager.projects.locations.operations.get" call. -// Any non-2xx status code is an error. Response headers are in either -// *Operation.ServerResponse.Header or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check -// whether the returned error was because http.StatusNotModified was returned. -func (c *ProjectsLocationsOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Operation{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "secretmanager.projects.locations.operations.get", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsOperationsListCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// List: Lists operations that match the specified filter in the request. If -// the server doesn't support this method, it returns `UNIMPLEMENTED`. -// -// - name: The name of the operation's parent resource. -func (r *ProjectsLocationsOperationsService) List(name string) *ProjectsLocationsOperationsListCall { - c := &ProjectsLocationsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Filter sets the optional parameter "filter": The standard list filter. -func (c *ProjectsLocationsOperationsListCall) Filter(filter string) *ProjectsLocationsOperationsListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// PageSize sets the optional parameter "pageSize": The standard list page -// size. -func (c *ProjectsLocationsOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsOperationsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": The standard list page -// token. -func (c *ProjectsLocationsOperationsListCall) PageToken(pageToken string) *ProjectsLocationsOperationsListCall { - c.urlParams_.Set("pageToken", pageToken) - return c -} - -// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": -// When set to `true`, operations that are reachable are returned as normal, -// and those that are unreachable are returned in the -// ListOperationsResponse.unreachable field. This can only be `true` when -// reading across collections. For example, when `parent` is set to -// "projects/example/locations/-". This field is not supported by default and -// will result in an `UNIMPLEMENTED` error if set unless explicitly documented -// otherwise in service or product specific documentation. -func (c *ProjectsLocationsOperationsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsOperationsListCall { - c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsLocationsOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsListCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *ProjectsLocationsOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsOperationsListCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsOperationsListCall) Context(ctx context.Context) *ProjectsLocationsOperationsListCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsLocationsOperationsListCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsOperationsListCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta2/{+name}/operations") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "secretmanager.projects.locations.operations.list", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "secretmanager.projects.locations.operations.list" call. -// Any non-2xx status code is an error. Response headers are in either -// *ListOperationsResponse.ServerResponse.Header or (if a response was returned -// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ProjectsLocationsOperationsListCall) Do(opts ...googleapi.CallOption) (*ListOperationsResponse, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &ListOperationsResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "secretmanager.projects.locations.operations.list", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsOperationsListCall) Pages(ctx context.Context, f func(*ListOperationsResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.PageToken(x.NextPageToken) - } -} - type ProjectsLocationsSecretsAddVersionCall struct { s *Service parent string diff --git a/securitycenter/v1/securitycenter-api.json b/securitycenter/v1/securitycenter-api.json index 4cbd5f9fce..a5b14044b9 100644 --- a/securitycenter/v1/securitycenter-api.json +++ b/securitycenter/v1/securitycenter-api.json @@ -5944,7 +5944,7 @@ } } }, - "revision": "20260123", + "revision": "20260219", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -7958,6 +7958,61 @@ }, "type": "object" }, + "ExternalExposure": { + "description": "Details about the externally exposed resource associated with the finding.", + "id": "ExternalExposure", + "properties": { + "backendService": { + "description": "The full resource name of load balancer backend service, for example, \"//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}\".", + "type": "string" + }, + "exposedEndpoint": { + "description": "The resource which is running the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.”", + "type": "string" + }, + "exposedService": { + "description": "The name and version of the service, for example, \"Jupyter Notebook 6.14.0\".", + "type": "string" + }, + "forwardingRule": { + "description": "The full resource name of the forwarding rule, for example, \"//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}\".", + "type": "string" + }, + "instanceGroup": { + "description": "The full resource name of the instance group, for example, \"//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}\".", + "type": "string" + }, + "loadBalancerFirewallPolicy": { + "description": "The full resource name of the load balancer firewall policy, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", + "type": "string" + }, + "networkEndpointGroup": { + "description": "The full resource name of the network endpoint group, for example, \"//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}\".", + "type": "string" + }, + "privateIpAddress": { + "description": "Private IP address of the exposed endpoint.", + "type": "string" + }, + "privatePort": { + "description": "Port number associated with private IP address.", + "type": "string" + }, + "publicIpAddress": { + "description": "Public IP address of the exposed endpoint.", + "type": "string" + }, + "publicPort": { + "description": "Public port number of the exposed endpoint.", + "type": "string" + }, + "serviceFirewallPolicy": { + "description": "The full resource name of the firewall policy of the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", + "type": "string" + } + }, + "type": "object" + }, "File": { "description": "File information about the related binary/library used by an executable, or the script used by a script interpreter", "id": "File", @@ -8179,6 +8234,10 @@ "$ref": "Exfiltration", "description": "Represents exfiltrations associated with the finding." }, + "externalExposure": { + "$ref": "ExternalExposure", + "description": "External exposure associated with the finding." + }, "externalSystems": { "additionalProperties": { "$ref": "GoogleCloudSecuritycenterV1ExternalSystem" @@ -8210,7 +8269,8 @@ "POSTURE_VIOLATION", "TOXIC_COMBINATION", "SENSITIVE_DATA_RISK", - "CHOKEPOINT" + "CHOKEPOINT", + "EXTERNAL_EXPOSURE" ], "enumDescriptions": [ "Unspecified finding class.", @@ -8222,7 +8282,8 @@ "Describes a potential security risk due to a change in the security posture.", "Describes a group of security issues that, when the issues occur together, represent a greater risk than when the issues occur independently. A group of such issues is referred to as a toxic combination.", "Describes a potential security risk to data assets that contain sensitive data.", - "Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS)." + "Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS).", + "Describes a potential security risk due to the resource being exposed to the internet." ], "type": "string" }, @@ -11102,6 +11163,61 @@ }, "type": "object" }, + "GoogleCloudSecuritycenterV2ExternalExposure": { + "description": "Details about the externally exposed resource associated with the finding.", + "id": "GoogleCloudSecuritycenterV2ExternalExposure", + "properties": { + "backendService": { + "description": "The full resource name of load balancer backend service, for example, \"//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}\".", + "type": "string" + }, + "exposedEndpoint": { + "description": "The resource which is running the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.”", + "type": "string" + }, + "exposedService": { + "description": "The name and version of the service, for example, \"Jupyter Notebook 6.14.0\".", + "type": "string" + }, + "forwardingRule": { + "description": "The full resource name of the forwarding rule, for example, \"//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}\".", + "type": "string" + }, + "instanceGroup": { + "description": "The full resource name of the instance group, for example, \"//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}\".", + "type": "string" + }, + "loadBalancerFirewallPolicy": { + "description": "The full resource name of the load balancer firewall policy, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", + "type": "string" + }, + "networkEndpointGroup": { + "description": "The full resource name of the network endpoint group, for example, \"//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}\".", + "type": "string" + }, + "privateIpAddress": { + "description": "Private IP address of the exposed endpoint.", + "type": "string" + }, + "privatePort": { + "description": "Port number associated with private IP address.", + "type": "string" + }, + "publicIpAddress": { + "description": "Public IP address of the exposed endpoint.", + "type": "string" + }, + "publicPort": { + "description": "Public port number of the exposed endpoint.", + "type": "string" + }, + "serviceFirewallPolicy": { + "description": "The full resource name of the firewall policy of the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudSecuritycenterV2ExternalSystem": { "description": "Representation of third party SIEM/SOAR fields within SCC.", "id": "GoogleCloudSecuritycenterV2ExternalSystem", @@ -11388,6 +11504,10 @@ "$ref": "GoogleCloudSecuritycenterV2Exfiltration", "description": "Represents exfiltrations associated with the finding." }, + "externalExposure": { + "$ref": "GoogleCloudSecuritycenterV2ExternalExposure", + "description": "External exposure associated with the finding." + }, "externalSystems": { "additionalProperties": { "$ref": "GoogleCloudSecuritycenterV2ExternalSystem" @@ -11419,7 +11539,8 @@ "POSTURE_VIOLATION", "TOXIC_COMBINATION", "SENSITIVE_DATA_RISK", - "CHOKEPOINT" + "CHOKEPOINT", + "EXTERNAL_EXPOSURE" ], "enumDescriptions": [ "Unspecified finding class.", @@ -11431,7 +11552,8 @@ "Describes a potential security risk due to a change in the security posture.", "Describes a combination of security issues that represent a more severe security problem when taken together.", "Describes a potential security risk to data assets that contain sensitive data.", - "Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS)." + "Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS).", + "Describes a potential security risk due to the resource being exposed to the internet." ], "type": "string" }, diff --git a/securitycenter/v1/securitycenter-gen.go b/securitycenter/v1/securitycenter-gen.go index c941cf45f3..09b0908f8d 100644 --- a/securitycenter/v1/securitycenter-gen.go +++ b/securitycenter/v1/securitycenter-gen.go @@ -3597,6 +3597,71 @@ func (s Expr) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ExternalExposure: Details about the externally exposed resource associated +// with the finding. +type ExternalExposure struct { + // BackendService: The full resource name of load balancer backend service, for + // example, + // "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name} + // ". + BackendService string `json:"backendService,omitempty"` + // ExposedEndpoint: The resource which is running the exposed service, for + // example, + // "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{insta + // nce}.” + ExposedEndpoint string `json:"exposedEndpoint,omitempty"` + // ExposedService: The name and version of the service, for example, "Jupyter + // Notebook 6.14.0". + ExposedService string `json:"exposedService,omitempty"` + // ForwardingRule: The full resource name of the forwarding rule, for example, + // "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwa + // rding-rule-name}". + ForwardingRule string `json:"forwardingRule,omitempty"` + // InstanceGroup: The full resource name of the instance group, for example, + // "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}" + // . + InstanceGroup string `json:"instanceGroup,omitempty"` + // LoadBalancerFirewallPolicy: The full resource name of the load balancer + // firewall policy, for example, + // "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{poli + // cy-name}". + LoadBalancerFirewallPolicy string `json:"loadBalancerFirewallPolicy,omitempty"` + // NetworkEndpointGroup: The full resource name of the network endpoint group, + // for example, + // "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/ + // {name}". + NetworkEndpointGroup string `json:"networkEndpointGroup,omitempty"` + // PrivateIpAddress: Private IP address of the exposed endpoint. + PrivateIpAddress string `json:"privateIpAddress,omitempty"` + // PrivatePort: Port number associated with private IP address. + PrivatePort string `json:"privatePort,omitempty"` + // PublicIpAddress: Public IP address of the exposed endpoint. + PublicIpAddress string `json:"publicIpAddress,omitempty"` + // PublicPort: Public port number of the exposed endpoint. + PublicPort string `json:"publicPort,omitempty"` + // ServiceFirewallPolicy: The full resource name of the firewall policy of the + // exposed service, for example, + // "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{poli + // cy-name}". + ServiceFirewallPolicy string `json:"serviceFirewallPolicy,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackendService") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BackendService") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ExternalExposure) MarshalJSON() ([]byte, error) { + type NoMethod ExternalExposure + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // File: File information about the related binary/library used by an // executable, or the script used by a script interpreter type File struct { @@ -3767,6 +3832,8 @@ type Finding struct { EventTime string `json:"eventTime,omitempty"` // Exfiltration: Represents exfiltrations associated with the finding. Exfiltration *Exfiltration `json:"exfiltration,omitempty"` + // ExternalExposure: External exposure associated with the finding. + ExternalExposure *ExternalExposure `json:"externalExposure,omitempty"` // ExternalSystems: Output only. Third party SIEM/SOAR fields within SCC, // contains external system information and external system finding fields. ExternalSystems map[string]GoogleCloudSecuritycenterV1ExternalSystem `json:"externalSystems,omitempty"` @@ -3797,6 +3864,8 @@ type Finding struct { // that contain sensitive data. // "CHOKEPOINT" - Describes a resource or resource group where high risk // attack paths converge, based on attack path simulations (APS). + // "EXTERNAL_EXPOSURE" - Describes a potential security risk due to the + // resource being exposed to the internet. FindingClass string `json:"findingClass,omitempty"` // GroupMemberships: Contains details about groups of which this finding is a // member. A group is a collection of findings that are related in some way. @@ -7383,6 +7452,71 @@ func (s GoogleCloudSecuritycenterV2Exfiltration) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudSecuritycenterV2ExternalExposure: Details about the externally +// exposed resource associated with the finding. +type GoogleCloudSecuritycenterV2ExternalExposure struct { + // BackendService: The full resource name of load balancer backend service, for + // example, + // "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name} + // ". + BackendService string `json:"backendService,omitempty"` + // ExposedEndpoint: The resource which is running the exposed service, for + // example, + // "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{insta + // nce}.” + ExposedEndpoint string `json:"exposedEndpoint,omitempty"` + // ExposedService: The name and version of the service, for example, "Jupyter + // Notebook 6.14.0". + ExposedService string `json:"exposedService,omitempty"` + // ForwardingRule: The full resource name of the forwarding rule, for example, + // "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwa + // rding-rule-name}". + ForwardingRule string `json:"forwardingRule,omitempty"` + // InstanceGroup: The full resource name of the instance group, for example, + // "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}" + // . + InstanceGroup string `json:"instanceGroup,omitempty"` + // LoadBalancerFirewallPolicy: The full resource name of the load balancer + // firewall policy, for example, + // "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{poli + // cy-name}". + LoadBalancerFirewallPolicy string `json:"loadBalancerFirewallPolicy,omitempty"` + // NetworkEndpointGroup: The full resource name of the network endpoint group, + // for example, + // "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/ + // {name}". + NetworkEndpointGroup string `json:"networkEndpointGroup,omitempty"` + // PrivateIpAddress: Private IP address of the exposed endpoint. + PrivateIpAddress string `json:"privateIpAddress,omitempty"` + // PrivatePort: Port number associated with private IP address. + PrivatePort string `json:"privatePort,omitempty"` + // PublicIpAddress: Public IP address of the exposed endpoint. + PublicIpAddress string `json:"publicIpAddress,omitempty"` + // PublicPort: Public port number of the exposed endpoint. + PublicPort string `json:"publicPort,omitempty"` + // ServiceFirewallPolicy: The full resource name of the firewall policy of the + // exposed service, for example, + // "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{poli + // cy-name}". + ServiceFirewallPolicy string `json:"serviceFirewallPolicy,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackendService") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BackendService") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudSecuritycenterV2ExternalExposure) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudSecuritycenterV2ExternalExposure + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudSecuritycenterV2ExternalSystem: Representation of third party // SIEM/SOAR fields within SCC. type GoogleCloudSecuritycenterV2ExternalSystem struct { @@ -7621,6 +7755,8 @@ type GoogleCloudSecuritycenterV2Finding struct { EventTime string `json:"eventTime,omitempty"` // Exfiltration: Represents exfiltrations associated with the finding. Exfiltration *GoogleCloudSecuritycenterV2Exfiltration `json:"exfiltration,omitempty"` + // ExternalExposure: External exposure associated with the finding. + ExternalExposure *GoogleCloudSecuritycenterV2ExternalExposure `json:"externalExposure,omitempty"` // ExternalSystems: Output only. Third party SIEM/SOAR fields within SCC, // contains external system information and external system finding fields. ExternalSystems map[string]GoogleCloudSecuritycenterV2ExternalSystem `json:"externalSystems,omitempty"` @@ -7650,6 +7786,8 @@ type GoogleCloudSecuritycenterV2Finding struct { // that contain sensitive data. // "CHOKEPOINT" - Describes a resource or resource group where high risk // attack paths converge, based on attack path simulations (APS). + // "EXTERNAL_EXPOSURE" - Describes a potential security risk due to the + // resource being exposed to the internet. FindingClass string `json:"findingClass,omitempty"` // GroupMemberships: Contains details about groups of which this finding is a // member. A group is a collection of findings that are related in some way. diff --git a/securitycenter/v1beta1/securitycenter-api.json b/securitycenter/v1beta1/securitycenter-api.json index 40896f997e..47080c3818 100644 --- a/securitycenter/v1beta1/securitycenter-api.json +++ b/securitycenter/v1beta1/securitycenter-api.json @@ -919,7 +919,7 @@ } } }, - "revision": "20260123", + "revision": "20260219", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -2547,6 +2547,61 @@ }, "type": "object" }, + "ExternalExposure": { + "description": "Details about the externally exposed resource associated with the finding.", + "id": "ExternalExposure", + "properties": { + "backendService": { + "description": "The full resource name of load balancer backend service, for example, \"//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}\".", + "type": "string" + }, + "exposedEndpoint": { + "description": "The resource which is running the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.”", + "type": "string" + }, + "exposedService": { + "description": "The name and version of the service, for example, \"Jupyter Notebook 6.14.0\".", + "type": "string" + }, + "forwardingRule": { + "description": "The full resource name of the forwarding rule, for example, \"//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}\".", + "type": "string" + }, + "instanceGroup": { + "description": "The full resource name of the instance group, for example, \"//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}\".", + "type": "string" + }, + "loadBalancerFirewallPolicy": { + "description": "The full resource name of the load balancer firewall policy, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", + "type": "string" + }, + "networkEndpointGroup": { + "description": "The full resource name of the network endpoint group, for example, \"//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}\".", + "type": "string" + }, + "privateIpAddress": { + "description": "Private IP address of the exposed endpoint.", + "type": "string" + }, + "privatePort": { + "description": "Port number associated with private IP address.", + "type": "string" + }, + "publicIpAddress": { + "description": "Public IP address of the exposed endpoint.", + "type": "string" + }, + "publicPort": { + "description": "Public port number of the exposed endpoint.", + "type": "string" + }, + "serviceFirewallPolicy": { + "description": "The full resource name of the firewall policy of the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", + "type": "string" + } + }, + "type": "object" + }, "File": { "description": "File information about the related binary/library used by an executable, or the script used by a script interpreter", "id": "File", @@ -2768,6 +2823,10 @@ "$ref": "Exfiltration", "description": "Represents exfiltrations associated with the finding." }, + "externalExposure": { + "$ref": "ExternalExposure", + "description": "External exposure associated with the finding." + }, "externalSystems": { "additionalProperties": { "$ref": "GoogleCloudSecuritycenterV1ExternalSystem" @@ -2799,7 +2858,8 @@ "POSTURE_VIOLATION", "TOXIC_COMBINATION", "SENSITIVE_DATA_RISK", - "CHOKEPOINT" + "CHOKEPOINT", + "EXTERNAL_EXPOSURE" ], "enumDescriptions": [ "Unspecified finding class.", @@ -2811,7 +2871,8 @@ "Describes a potential security risk due to a change in the security posture.", "Describes a group of security issues that, when the issues occur together, represent a greater risk than when the issues occur independently. A group of such issues is referred to as a toxic combination.", "Describes a potential security risk to data assets that contain sensitive data.", - "Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS)." + "Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS).", + "Describes a potential security risk due to the resource being exposed to the internet." ], "type": "string" }, @@ -5772,6 +5833,61 @@ }, "type": "object" }, + "GoogleCloudSecuritycenterV2ExternalExposure": { + "description": "Details about the externally exposed resource associated with the finding.", + "id": "GoogleCloudSecuritycenterV2ExternalExposure", + "properties": { + "backendService": { + "description": "The full resource name of load balancer backend service, for example, \"//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}\".", + "type": "string" + }, + "exposedEndpoint": { + "description": "The resource which is running the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.”", + "type": "string" + }, + "exposedService": { + "description": "The name and version of the service, for example, \"Jupyter Notebook 6.14.0\".", + "type": "string" + }, + "forwardingRule": { + "description": "The full resource name of the forwarding rule, for example, \"//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}\".", + "type": "string" + }, + "instanceGroup": { + "description": "The full resource name of the instance group, for example, \"//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}\".", + "type": "string" + }, + "loadBalancerFirewallPolicy": { + "description": "The full resource name of the load balancer firewall policy, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", + "type": "string" + }, + "networkEndpointGroup": { + "description": "The full resource name of the network endpoint group, for example, \"//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}\".", + "type": "string" + }, + "privateIpAddress": { + "description": "Private IP address of the exposed endpoint.", + "type": "string" + }, + "privatePort": { + "description": "Port number associated with private IP address.", + "type": "string" + }, + "publicIpAddress": { + "description": "Public IP address of the exposed endpoint.", + "type": "string" + }, + "publicPort": { + "description": "Public port number of the exposed endpoint.", + "type": "string" + }, + "serviceFirewallPolicy": { + "description": "The full resource name of the firewall policy of the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudSecuritycenterV2ExternalSystem": { "description": "Representation of third party SIEM/SOAR fields within SCC.", "id": "GoogleCloudSecuritycenterV2ExternalSystem", @@ -6058,6 +6174,10 @@ "$ref": "GoogleCloudSecuritycenterV2Exfiltration", "description": "Represents exfiltrations associated with the finding." }, + "externalExposure": { + "$ref": "GoogleCloudSecuritycenterV2ExternalExposure", + "description": "External exposure associated with the finding." + }, "externalSystems": { "additionalProperties": { "$ref": "GoogleCloudSecuritycenterV2ExternalSystem" @@ -6089,7 +6209,8 @@ "POSTURE_VIOLATION", "TOXIC_COMBINATION", "SENSITIVE_DATA_RISK", - "CHOKEPOINT" + "CHOKEPOINT", + "EXTERNAL_EXPOSURE" ], "enumDescriptions": [ "Unspecified finding class.", @@ -6101,7 +6222,8 @@ "Describes a potential security risk due to a change in the security posture.", "Describes a combination of security issues that represent a more severe security problem when taken together.", "Describes a potential security risk to data assets that contain sensitive data.", - "Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS)." + "Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS).", + "Describes a potential security risk due to the resource being exposed to the internet." ], "type": "string" }, diff --git a/securitycenter/v1beta1/securitycenter-gen.go b/securitycenter/v1beta1/securitycenter-gen.go index 0b1616db6f..83899744cd 100644 --- a/securitycenter/v1beta1/securitycenter-gen.go +++ b/securitycenter/v1beta1/securitycenter-gen.go @@ -2461,6 +2461,71 @@ func (s Expr) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ExternalExposure: Details about the externally exposed resource associated +// with the finding. +type ExternalExposure struct { + // BackendService: The full resource name of load balancer backend service, for + // example, + // "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name} + // ". + BackendService string `json:"backendService,omitempty"` + // ExposedEndpoint: The resource which is running the exposed service, for + // example, + // "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{insta + // nce}.” + ExposedEndpoint string `json:"exposedEndpoint,omitempty"` + // ExposedService: The name and version of the service, for example, "Jupyter + // Notebook 6.14.0". + ExposedService string `json:"exposedService,omitempty"` + // ForwardingRule: The full resource name of the forwarding rule, for example, + // "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwa + // rding-rule-name}". + ForwardingRule string `json:"forwardingRule,omitempty"` + // InstanceGroup: The full resource name of the instance group, for example, + // "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}" + // . + InstanceGroup string `json:"instanceGroup,omitempty"` + // LoadBalancerFirewallPolicy: The full resource name of the load balancer + // firewall policy, for example, + // "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{poli + // cy-name}". + LoadBalancerFirewallPolicy string `json:"loadBalancerFirewallPolicy,omitempty"` + // NetworkEndpointGroup: The full resource name of the network endpoint group, + // for example, + // "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/ + // {name}". + NetworkEndpointGroup string `json:"networkEndpointGroup,omitempty"` + // PrivateIpAddress: Private IP address of the exposed endpoint. + PrivateIpAddress string `json:"privateIpAddress,omitempty"` + // PrivatePort: Port number associated with private IP address. + PrivatePort string `json:"privatePort,omitempty"` + // PublicIpAddress: Public IP address of the exposed endpoint. + PublicIpAddress string `json:"publicIpAddress,omitempty"` + // PublicPort: Public port number of the exposed endpoint. + PublicPort string `json:"publicPort,omitempty"` + // ServiceFirewallPolicy: The full resource name of the firewall policy of the + // exposed service, for example, + // "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{poli + // cy-name}". + ServiceFirewallPolicy string `json:"serviceFirewallPolicy,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackendService") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BackendService") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ExternalExposure) MarshalJSON() ([]byte, error) { + type NoMethod ExternalExposure + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // File: File information about the related binary/library used by an // executable, or the script used by a script interpreter type File struct { @@ -2631,6 +2696,8 @@ type Finding struct { EventTime string `json:"eventTime,omitempty"` // Exfiltration: Represents exfiltrations associated with the finding. Exfiltration *Exfiltration `json:"exfiltration,omitempty"` + // ExternalExposure: External exposure associated with the finding. + ExternalExposure *ExternalExposure `json:"externalExposure,omitempty"` // ExternalSystems: Output only. Third party SIEM/SOAR fields within SCC, // contains external system information and external system finding fields. ExternalSystems map[string]GoogleCloudSecuritycenterV1ExternalSystem `json:"externalSystems,omitempty"` @@ -2661,6 +2728,8 @@ type Finding struct { // that contain sensitive data. // "CHOKEPOINT" - Describes a resource or resource group where high risk // attack paths converge, based on attack path simulations (APS). + // "EXTERNAL_EXPOSURE" - Describes a potential security risk due to the + // resource being exposed to the internet. FindingClass string `json:"findingClass,omitempty"` // GroupMemberships: Contains details about groups of which this finding is a // member. A group is a collection of findings that are related in some way. @@ -6344,6 +6413,71 @@ func (s GoogleCloudSecuritycenterV2Exfiltration) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudSecuritycenterV2ExternalExposure: Details about the externally +// exposed resource associated with the finding. +type GoogleCloudSecuritycenterV2ExternalExposure struct { + // BackendService: The full resource name of load balancer backend service, for + // example, + // "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name} + // ". + BackendService string `json:"backendService,omitempty"` + // ExposedEndpoint: The resource which is running the exposed service, for + // example, + // "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{insta + // nce}.” + ExposedEndpoint string `json:"exposedEndpoint,omitempty"` + // ExposedService: The name and version of the service, for example, "Jupyter + // Notebook 6.14.0". + ExposedService string `json:"exposedService,omitempty"` + // ForwardingRule: The full resource name of the forwarding rule, for example, + // "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwa + // rding-rule-name}". + ForwardingRule string `json:"forwardingRule,omitempty"` + // InstanceGroup: The full resource name of the instance group, for example, + // "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}" + // . + InstanceGroup string `json:"instanceGroup,omitempty"` + // LoadBalancerFirewallPolicy: The full resource name of the load balancer + // firewall policy, for example, + // "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{poli + // cy-name}". + LoadBalancerFirewallPolicy string `json:"loadBalancerFirewallPolicy,omitempty"` + // NetworkEndpointGroup: The full resource name of the network endpoint group, + // for example, + // "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/ + // {name}". + NetworkEndpointGroup string `json:"networkEndpointGroup,omitempty"` + // PrivateIpAddress: Private IP address of the exposed endpoint. + PrivateIpAddress string `json:"privateIpAddress,omitempty"` + // PrivatePort: Port number associated with private IP address. + PrivatePort string `json:"privatePort,omitempty"` + // PublicIpAddress: Public IP address of the exposed endpoint. + PublicIpAddress string `json:"publicIpAddress,omitempty"` + // PublicPort: Public port number of the exposed endpoint. + PublicPort string `json:"publicPort,omitempty"` + // ServiceFirewallPolicy: The full resource name of the firewall policy of the + // exposed service, for example, + // "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{poli + // cy-name}". + ServiceFirewallPolicy string `json:"serviceFirewallPolicy,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackendService") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BackendService") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudSecuritycenterV2ExternalExposure) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudSecuritycenterV2ExternalExposure + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudSecuritycenterV2ExternalSystem: Representation of third party // SIEM/SOAR fields within SCC. type GoogleCloudSecuritycenterV2ExternalSystem struct { @@ -6582,6 +6716,8 @@ type GoogleCloudSecuritycenterV2Finding struct { EventTime string `json:"eventTime,omitempty"` // Exfiltration: Represents exfiltrations associated with the finding. Exfiltration *GoogleCloudSecuritycenterV2Exfiltration `json:"exfiltration,omitempty"` + // ExternalExposure: External exposure associated with the finding. + ExternalExposure *GoogleCloudSecuritycenterV2ExternalExposure `json:"externalExposure,omitempty"` // ExternalSystems: Output only. Third party SIEM/SOAR fields within SCC, // contains external system information and external system finding fields. ExternalSystems map[string]GoogleCloudSecuritycenterV2ExternalSystem `json:"externalSystems,omitempty"` @@ -6611,6 +6747,8 @@ type GoogleCloudSecuritycenterV2Finding struct { // that contain sensitive data. // "CHOKEPOINT" - Describes a resource or resource group where high risk // attack paths converge, based on attack path simulations (APS). + // "EXTERNAL_EXPOSURE" - Describes a potential security risk due to the + // resource being exposed to the internet. FindingClass string `json:"findingClass,omitempty"` // GroupMemberships: Contains details about groups of which this finding is a // member. A group is a collection of findings that are related in some way. diff --git a/securitycenter/v1beta2/securitycenter-api.json b/securitycenter/v1beta2/securitycenter-api.json index 3ddd1ca65e..fa59a4dd94 100644 --- a/securitycenter/v1beta2/securitycenter-api.json +++ b/securitycenter/v1beta2/securitycenter-api.json @@ -2003,7 +2003,7 @@ } } }, - "revision": "20260123", + "revision": "20260219", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -3638,6 +3638,61 @@ }, "type": "object" }, + "ExternalExposure": { + "description": "Details about the externally exposed resource associated with the finding.", + "id": "ExternalExposure", + "properties": { + "backendService": { + "description": "The full resource name of load balancer backend service, for example, \"//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}\".", + "type": "string" + }, + "exposedEndpoint": { + "description": "The resource which is running the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.”", + "type": "string" + }, + "exposedService": { + "description": "The name and version of the service, for example, \"Jupyter Notebook 6.14.0\".", + "type": "string" + }, + "forwardingRule": { + "description": "The full resource name of the forwarding rule, for example, \"//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}\".", + "type": "string" + }, + "instanceGroup": { + "description": "The full resource name of the instance group, for example, \"//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}\".", + "type": "string" + }, + "loadBalancerFirewallPolicy": { + "description": "The full resource name of the load balancer firewall policy, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", + "type": "string" + }, + "networkEndpointGroup": { + "description": "The full resource name of the network endpoint group, for example, \"//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}\".", + "type": "string" + }, + "privateIpAddress": { + "description": "Private IP address of the exposed endpoint.", + "type": "string" + }, + "privatePort": { + "description": "Port number associated with private IP address.", + "type": "string" + }, + "publicIpAddress": { + "description": "Public IP address of the exposed endpoint.", + "type": "string" + }, + "publicPort": { + "description": "Public port number of the exposed endpoint.", + "type": "string" + }, + "serviceFirewallPolicy": { + "description": "The full resource name of the firewall policy of the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", + "type": "string" + } + }, + "type": "object" + }, "File": { "description": "File information about the related binary/library used by an executable, or the script used by a script interpreter", "id": "File", @@ -3859,6 +3914,10 @@ "$ref": "Exfiltration", "description": "Represents exfiltrations associated with the finding." }, + "externalExposure": { + "$ref": "ExternalExposure", + "description": "External exposure associated with the finding." + }, "externalSystems": { "additionalProperties": { "$ref": "GoogleCloudSecuritycenterV1ExternalSystem" @@ -3890,7 +3949,8 @@ "POSTURE_VIOLATION", "TOXIC_COMBINATION", "SENSITIVE_DATA_RISK", - "CHOKEPOINT" + "CHOKEPOINT", + "EXTERNAL_EXPOSURE" ], "enumDescriptions": [ "Unspecified finding class.", @@ -3902,7 +3962,8 @@ "Describes a potential security risk due to a change in the security posture.", "Describes a group of security issues that, when the issues occur together, represent a greater risk than when the issues occur independently. A group of such issues is referred to as a toxic combination.", "Describes a potential security risk to data assets that contain sensitive data.", - "Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS)." + "Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS).", + "Describes a potential security risk due to the resource being exposed to the internet." ], "type": "string" }, @@ -6759,6 +6820,61 @@ }, "type": "object" }, + "GoogleCloudSecuritycenterV2ExternalExposure": { + "description": "Details about the externally exposed resource associated with the finding.", + "id": "GoogleCloudSecuritycenterV2ExternalExposure", + "properties": { + "backendService": { + "description": "The full resource name of load balancer backend service, for example, \"//compute.googleapis.com/projects/{project-id}/global/backendServices/{name}\".", + "type": "string" + }, + "exposedEndpoint": { + "description": "The resource which is running the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{instance}.”", + "type": "string" + }, + "exposedService": { + "description": "The name and version of the service, for example, \"Jupyter Notebook 6.14.0\".", + "type": "string" + }, + "forwardingRule": { + "description": "The full resource name of the forwarding rule, for example, \"//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwarding-rule-name}\".", + "type": "string" + }, + "instanceGroup": { + "description": "The full resource name of the instance group, for example, \"//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}\".", + "type": "string" + }, + "loadBalancerFirewallPolicy": { + "description": "The full resource name of the load balancer firewall policy, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", + "type": "string" + }, + "networkEndpointGroup": { + "description": "The full resource name of the network endpoint group, for example, \"//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/{name}\".", + "type": "string" + }, + "privateIpAddress": { + "description": "Private IP address of the exposed endpoint.", + "type": "string" + }, + "privatePort": { + "description": "Port number associated with private IP address.", + "type": "string" + }, + "publicIpAddress": { + "description": "Public IP address of the exposed endpoint.", + "type": "string" + }, + "publicPort": { + "description": "Public port number of the exposed endpoint.", + "type": "string" + }, + "serviceFirewallPolicy": { + "description": "The full resource name of the firewall policy of the exposed service, for example, \"//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{policy-name}\".", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudSecuritycenterV2ExternalSystem": { "description": "Representation of third party SIEM/SOAR fields within SCC.", "id": "GoogleCloudSecuritycenterV2ExternalSystem", @@ -7045,6 +7161,10 @@ "$ref": "GoogleCloudSecuritycenterV2Exfiltration", "description": "Represents exfiltrations associated with the finding." }, + "externalExposure": { + "$ref": "GoogleCloudSecuritycenterV2ExternalExposure", + "description": "External exposure associated with the finding." + }, "externalSystems": { "additionalProperties": { "$ref": "GoogleCloudSecuritycenterV2ExternalSystem" @@ -7076,7 +7196,8 @@ "POSTURE_VIOLATION", "TOXIC_COMBINATION", "SENSITIVE_DATA_RISK", - "CHOKEPOINT" + "CHOKEPOINT", + "EXTERNAL_EXPOSURE" ], "enumDescriptions": [ "Unspecified finding class.", @@ -7088,7 +7209,8 @@ "Describes a potential security risk due to a change in the security posture.", "Describes a combination of security issues that represent a more severe security problem when taken together.", "Describes a potential security risk to data assets that contain sensitive data.", - "Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS)." + "Describes a resource or resource group where high risk attack paths converge, based on attack path simulations (APS).", + "Describes a potential security risk due to the resource being exposed to the internet." ], "type": "string" }, diff --git a/securitycenter/v1beta2/securitycenter-gen.go b/securitycenter/v1beta2/securitycenter-gen.go index 326a8d58ed..0d19f1d3f8 100644 --- a/securitycenter/v1beta2/securitycenter-gen.go +++ b/securitycenter/v1beta2/securitycenter-gen.go @@ -2585,6 +2585,71 @@ func (s Expr) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ExternalExposure: Details about the externally exposed resource associated +// with the finding. +type ExternalExposure struct { + // BackendService: The full resource name of load balancer backend service, for + // example, + // "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name} + // ". + BackendService string `json:"backendService,omitempty"` + // ExposedEndpoint: The resource which is running the exposed service, for + // example, + // "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{insta + // nce}.” + ExposedEndpoint string `json:"exposedEndpoint,omitempty"` + // ExposedService: The name and version of the service, for example, "Jupyter + // Notebook 6.14.0". + ExposedService string `json:"exposedService,omitempty"` + // ForwardingRule: The full resource name of the forwarding rule, for example, + // "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwa + // rding-rule-name}". + ForwardingRule string `json:"forwardingRule,omitempty"` + // InstanceGroup: The full resource name of the instance group, for example, + // "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}" + // . + InstanceGroup string `json:"instanceGroup,omitempty"` + // LoadBalancerFirewallPolicy: The full resource name of the load balancer + // firewall policy, for example, + // "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{poli + // cy-name}". + LoadBalancerFirewallPolicy string `json:"loadBalancerFirewallPolicy,omitempty"` + // NetworkEndpointGroup: The full resource name of the network endpoint group, + // for example, + // "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/ + // {name}". + NetworkEndpointGroup string `json:"networkEndpointGroup,omitempty"` + // PrivateIpAddress: Private IP address of the exposed endpoint. + PrivateIpAddress string `json:"privateIpAddress,omitempty"` + // PrivatePort: Port number associated with private IP address. + PrivatePort string `json:"privatePort,omitempty"` + // PublicIpAddress: Public IP address of the exposed endpoint. + PublicIpAddress string `json:"publicIpAddress,omitempty"` + // PublicPort: Public port number of the exposed endpoint. + PublicPort string `json:"publicPort,omitempty"` + // ServiceFirewallPolicy: The full resource name of the firewall policy of the + // exposed service, for example, + // "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{poli + // cy-name}". + ServiceFirewallPolicy string `json:"serviceFirewallPolicy,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackendService") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BackendService") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ExternalExposure) MarshalJSON() ([]byte, error) { + type NoMethod ExternalExposure + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // File: File information about the related binary/library used by an // executable, or the script used by a script interpreter type File struct { @@ -2755,6 +2820,8 @@ type Finding struct { EventTime string `json:"eventTime,omitempty"` // Exfiltration: Represents exfiltrations associated with the finding. Exfiltration *Exfiltration `json:"exfiltration,omitempty"` + // ExternalExposure: External exposure associated with the finding. + ExternalExposure *ExternalExposure `json:"externalExposure,omitempty"` // ExternalSystems: Output only. Third party SIEM/SOAR fields within SCC, // contains external system information and external system finding fields. ExternalSystems map[string]GoogleCloudSecuritycenterV1ExternalSystem `json:"externalSystems,omitempty"` @@ -2785,6 +2852,8 @@ type Finding struct { // that contain sensitive data. // "CHOKEPOINT" - Describes a resource or resource group where high risk // attack paths converge, based on attack path simulations (APS). + // "EXTERNAL_EXPOSURE" - Describes a potential security risk due to the + // resource being exposed to the internet. FindingClass string `json:"findingClass,omitempty"` // GroupMemberships: Contains details about groups of which this finding is a // member. A group is a collection of findings that are related in some way. @@ -6295,6 +6364,71 @@ func (s GoogleCloudSecuritycenterV2Exfiltration) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudSecuritycenterV2ExternalExposure: Details about the externally +// exposed resource associated with the finding. +type GoogleCloudSecuritycenterV2ExternalExposure struct { + // BackendService: The full resource name of load balancer backend service, for + // example, + // "//compute.googleapis.com/projects/{project-id}/global/backendServices/{name} + // ". + BackendService string `json:"backendService,omitempty"` + // ExposedEndpoint: The resource which is running the exposed service, for + // example, + // "//compute.googleapis.com/projects/{project-id}/zones/{zone}/instances/{insta + // nce}.” + ExposedEndpoint string `json:"exposedEndpoint,omitempty"` + // ExposedService: The name and version of the service, for example, "Jupyter + // Notebook 6.14.0". + ExposedService string `json:"exposedService,omitempty"` + // ForwardingRule: The full resource name of the forwarding rule, for example, + // "//compute.googleapis.com/projects/{project-id}/global/forwardingRules/{forwa + // rding-rule-name}". + ForwardingRule string `json:"forwardingRule,omitempty"` + // InstanceGroup: The full resource name of the instance group, for example, + // "//compute.googleapis.com/projects/{project-id}/global/instanceGroups/{name}" + // . + InstanceGroup string `json:"instanceGroup,omitempty"` + // LoadBalancerFirewallPolicy: The full resource name of the load balancer + // firewall policy, for example, + // "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{poli + // cy-name}". + LoadBalancerFirewallPolicy string `json:"loadBalancerFirewallPolicy,omitempty"` + // NetworkEndpointGroup: The full resource name of the network endpoint group, + // for example, + // "//compute.googleapis.com/projects/{project-id}/global/networkEndpointGroups/ + // {name}". + NetworkEndpointGroup string `json:"networkEndpointGroup,omitempty"` + // PrivateIpAddress: Private IP address of the exposed endpoint. + PrivateIpAddress string `json:"privateIpAddress,omitempty"` + // PrivatePort: Port number associated with private IP address. + PrivatePort string `json:"privatePort,omitempty"` + // PublicIpAddress: Public IP address of the exposed endpoint. + PublicIpAddress string `json:"publicIpAddress,omitempty"` + // PublicPort: Public port number of the exposed endpoint. + PublicPort string `json:"publicPort,omitempty"` + // ServiceFirewallPolicy: The full resource name of the firewall policy of the + // exposed service, for example, + // "//compute.googleapis.com/projects/{project-id}/global/firewallPolicies/{poli + // cy-name}". + ServiceFirewallPolicy string `json:"serviceFirewallPolicy,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackendService") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BackendService") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudSecuritycenterV2ExternalExposure) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudSecuritycenterV2ExternalExposure + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudSecuritycenterV2ExternalSystem: Representation of third party // SIEM/SOAR fields within SCC. type GoogleCloudSecuritycenterV2ExternalSystem struct { @@ -6533,6 +6667,8 @@ type GoogleCloudSecuritycenterV2Finding struct { EventTime string `json:"eventTime,omitempty"` // Exfiltration: Represents exfiltrations associated with the finding. Exfiltration *GoogleCloudSecuritycenterV2Exfiltration `json:"exfiltration,omitempty"` + // ExternalExposure: External exposure associated with the finding. + ExternalExposure *GoogleCloudSecuritycenterV2ExternalExposure `json:"externalExposure,omitempty"` // ExternalSystems: Output only. Third party SIEM/SOAR fields within SCC, // contains external system information and external system finding fields. ExternalSystems map[string]GoogleCloudSecuritycenterV2ExternalSystem `json:"externalSystems,omitempty"` @@ -6562,6 +6698,8 @@ type GoogleCloudSecuritycenterV2Finding struct { // that contain sensitive data. // "CHOKEPOINT" - Describes a resource or resource group where high risk // attack paths converge, based on attack path simulations (APS). + // "EXTERNAL_EXPOSURE" - Describes a potential security risk due to the + // resource being exposed to the internet. FindingClass string `json:"findingClass,omitempty"` // GroupMemberships: Contains details about groups of which this finding is a // member. A group is a collection of findings that are related in some way. diff --git a/servicedirectory/v1/servicedirectory-api.json b/servicedirectory/v1/servicedirectory-api.json index 302d856cb0..dd68f8eaed 100644 --- a/servicedirectory/v1/servicedirectory-api.json +++ b/servicedirectory/v1/servicedirectory-api.json @@ -135,7 +135,7 @@ ] }, "list": { - "description": "Lists information about the supported locations for this service.", + "description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "servicedirectory.projects.locations.list", @@ -889,7 +889,7 @@ } } }, - "revision": "20251030", + "revision": "20260217", "rootUrl": "https://servicedirectory.googleapis.com/", "schemas": { "Binding": { diff --git a/servicedirectory/v1/servicedirectory-gen.go b/servicedirectory/v1/servicedirectory-gen.go index eae85e7d31..54f05699d1 100644 --- a/servicedirectory/v1/servicedirectory-gen.go +++ b/servicedirectory/v1/servicedirectory-gen.go @@ -1074,7 +1074,11 @@ type ProjectsLocationsListCall struct { header_ http.Header } -// List: Lists information about the supported locations for this service. +// List: Lists information about the supported locations for this service. This +// method can be called in two ways: * **List all public locations:** Use the +// path `GET /v1/locations`. * **List project-visible locations:** Use the path +// `GET /v1/projects/{project_id}/locations`. This may include public locations +// as well as private or other locations specifically visible to the project. // // - name: The resource that owns the locations collection, if applicable. func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { diff --git a/servicedirectory/v1beta1/servicedirectory-api.json b/servicedirectory/v1beta1/servicedirectory-api.json index a011f3ee58..df2db7eef4 100644 --- a/servicedirectory/v1beta1/servicedirectory-api.json +++ b/servicedirectory/v1beta1/servicedirectory-api.json @@ -135,7 +135,7 @@ ] }, "list": { - "description": "Lists information about the supported locations for this service.", + "description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.", "flatPath": "v1beta1/projects/{projectsId}/locations", "httpMethod": "GET", "id": "servicedirectory.projects.locations.list", @@ -977,7 +977,7 @@ } } }, - "revision": "20251030", + "revision": "20260217", "rootUrl": "https://servicedirectory.googleapis.com/", "schemas": { "Binding": { diff --git a/servicedirectory/v1beta1/servicedirectory-gen.go b/servicedirectory/v1beta1/servicedirectory-gen.go index 63f24851da..e1a2340ee6 100644 --- a/servicedirectory/v1beta1/servicedirectory-gen.go +++ b/servicedirectory/v1beta1/servicedirectory-gen.go @@ -1098,7 +1098,11 @@ type ProjectsLocationsListCall struct { header_ http.Header } -// List: Lists information about the supported locations for this service. +// List: Lists information about the supported locations for this service. This +// method can be called in two ways: * **List all public locations:** Use the +// path `GET /v1/locations`. * **List project-visible locations:** Use the path +// `GET /v1/projects/{project_id}/locations`. This may include public locations +// as well as private or other locations specifically visible to the project. // // - name: The resource that owns the locations collection, if applicable. func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { diff --git a/servicenetworking/v1/servicenetworking-api.json b/servicenetworking/v1/servicenetworking-api.json index 4b564c173c..0e14cca5ca 100644 --- a/servicenetworking/v1/servicenetworking-api.json +++ b/servicenetworking/v1/servicenetworking-api.json @@ -1034,7 +1034,7 @@ } } }, - "revision": "20260119", + "revision": "20260216", "rootUrl": "https://servicenetworking.googleapis.com/", "schemas": { "AddDnsRecordSetMetadata": { @@ -1304,6 +1304,13 @@ "description": "The type of this aspect configuration.", "type": "string" }, + "rules": { + "description": "Optional. Rules of the Configuration.", + "items": { + "$ref": "AspectRule" + }, + "type": "array" + }, "spec": { "additionalProperties": { "description": "Properties of the object.", @@ -1315,6 +1322,25 @@ }, "type": "object" }, + "AspectRule": { + "description": "Rule-based configuration for an aspect.", + "id": "AspectRule", + "properties": { + "config": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Required. Rules of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`.", + "type": "object" + }, + "selector": { + "description": "Required. Selects the RPC methods to which this rule applies. Refer to selector for syntax details.", + "type": "string" + } + }, + "type": "object" + }, "AuthProvider": { "description": "Configuration for an authentication provider, including support for [JSON Web Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).", "id": "AuthProvider", diff --git a/servicenetworking/v1/servicenetworking-gen.go b/servicenetworking/v1/servicenetworking-gen.go index 6f100f3e4d..78083fd8bb 100644 --- a/servicenetworking/v1/servicenetworking-gen.go +++ b/servicenetworking/v1/servicenetworking-gen.go @@ -656,6 +656,8 @@ func (s Api) MarshalJSON() ([]byte, error) { type Aspect struct { // Kind: The type of this aspect configuration. Kind string `json:"kind,omitempty"` + // Rules: Optional. Rules of the Configuration. + Rules []*AspectRule `json:"rules,omitempty"` // Spec: Content of the configuration. The underlying schema should be defined // by Aspect owners as protobuf message under `google/api/configaspects/proto`. Spec googleapi.RawMessage `json:"spec,omitempty"` @@ -677,6 +679,33 @@ func (s Aspect) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// AspectRule: Rule-based configuration for an aspect. +type AspectRule struct { + // Config: Required. Rules of the configuration. The underlying schema should + // be defined by Aspect owners as protobuf message under + // `google/api/configaspects/proto`. + Config googleapi.RawMessage `json:"config,omitempty"` + // Selector: Required. Selects the RPC methods to which this rule applies. + // Refer to selector for syntax details. + Selector string `json:"selector,omitempty"` + // ForceSendFields is a list of field names (e.g. "Config") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Config") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s AspectRule) MarshalJSON() ([]byte, error) { + type NoMethod AspectRule + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // AuthProvider: Configuration for an authentication provider, including // support for JSON Web Token (JWT) // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). diff --git a/servicenetworking/v1beta/servicenetworking-api.json b/servicenetworking/v1beta/servicenetworking-api.json index aad624b072..ac05cc49ec 100644 --- a/servicenetworking/v1beta/servicenetworking-api.json +++ b/servicenetworking/v1beta/servicenetworking-api.json @@ -307,7 +307,7 @@ } } }, - "revision": "20260119", + "revision": "20260216", "rootUrl": "https://servicenetworking.googleapis.com/", "schemas": { "AddDnsRecordSetMetadata": { @@ -466,6 +466,13 @@ "description": "The type of this aspect configuration.", "type": "string" }, + "rules": { + "description": "Optional. Rules of the Configuration.", + "items": { + "$ref": "AspectRule" + }, + "type": "array" + }, "spec": { "additionalProperties": { "description": "Properties of the object.", @@ -477,6 +484,25 @@ }, "type": "object" }, + "AspectRule": { + "description": "Rule-based configuration for an aspect.", + "id": "AspectRule", + "properties": { + "config": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Required. Rules of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`.", + "type": "object" + }, + "selector": { + "description": "Required. Selects the RPC methods to which this rule applies. Refer to selector for syntax details.", + "type": "string" + } + }, + "type": "object" + }, "AuthProvider": { "description": "Configuration for an authentication provider, including support for [JSON Web Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).", "id": "AuthProvider", diff --git a/servicenetworking/v1beta/servicenetworking-gen.go b/servicenetworking/v1beta/servicenetworking-gen.go index c3b5c3d617..b1dc71b88e 100644 --- a/servicenetworking/v1beta/servicenetworking-gen.go +++ b/servicenetworking/v1beta/servicenetworking-gen.go @@ -391,6 +391,8 @@ func (s Api) MarshalJSON() ([]byte, error) { type Aspect struct { // Kind: The type of this aspect configuration. Kind string `json:"kind,omitempty"` + // Rules: Optional. Rules of the Configuration. + Rules []*AspectRule `json:"rules,omitempty"` // Spec: Content of the configuration. The underlying schema should be defined // by Aspect owners as protobuf message under `google/api/configaspects/proto`. Spec googleapi.RawMessage `json:"spec,omitempty"` @@ -412,6 +414,33 @@ func (s Aspect) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// AspectRule: Rule-based configuration for an aspect. +type AspectRule struct { + // Config: Required. Rules of the configuration. The underlying schema should + // be defined by Aspect owners as protobuf message under + // `google/api/configaspects/proto`. + Config googleapi.RawMessage `json:"config,omitempty"` + // Selector: Required. Selects the RPC methods to which this rule applies. + // Refer to selector for syntax details. + Selector string `json:"selector,omitempty"` + // ForceSendFields is a list of field names (e.g. "Config") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Config") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s AspectRule) MarshalJSON() ([]byte, error) { + type NoMethod AspectRule + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // AuthProvider: Configuration for an authentication provider, including // support for JSON Web Token (JWT) // (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). diff --git a/sheets/v4/sheets-api.json b/sheets/v4/sheets-api.json index 795b2ceb7e..ecae044ab9 100644 --- a/sheets/v4/sheets-api.json +++ b/sheets/v4/sheets-api.json @@ -213,7 +213,7 @@ ] }, "getByDataFilter": { - "description": "Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. This method differs from GetSpreadsheet in that it allows selecting which subsets of spreadsheet data to return by specifying a dataFilters parameter. Multiple DataFilters can be specified. Specifying one or more data filters returns the portions of the spreadsheet that intersect ranges matched by any of the filters. By default, data within grids is not returned. You can include grid data one of 2 ways: * Specify a [field mask](https://developers.google.com/workspace/sheets/api/guides/field-masks) listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, as a best practice, retrieve only the specific spreadsheet fields that you want.", + "description": "Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). This method differs from GetSpreadsheet in that it allows selecting which subsets of spreadsheet data to return by specifying a dataFilters parameter. Multiple DataFilters can be specified. Specifying one or more data filters returns the portions of the spreadsheet that intersect ranges matched by any of the filters. By default, data within grids is not returned. You can include grid data in one of two ways: * Specify a [field mask](https://developers.google.com/workspace/sheets/api/guides/field-masks) listing your desired fields using the `fields` URL parameter in HTTP. * Set the includeGridData parameter to `true`. If a field mask is set, the `includeGridData` parameter is ignored. For large spreadsheets, as a best practice, retrieve only the specific spreadsheet fields that you want.", "flatPath": "v4/spreadsheets/{spreadsheetId}:getByDataFilter", "httpMethod": "POST", "id": "sheets.spreadsheets.getByDataFilter", @@ -246,7 +246,7 @@ "developerMetadata": { "methods": { "get": { - "description": "Returns the developer metadata with the specified ID. The caller must specify the spreadsheet ID and the developer metadata's unique metadataId.", + "description": "Returns the developer metadata with the specified ID. The caller must specify the spreadsheet ID and the developer metadata's unique metadataId. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata).", "flatPath": "v4/spreadsheets/{spreadsheetId}/developerMetadata/{metadataId}", "httpMethod": "GET", "id": "sheets.spreadsheets.developerMetadata.get", @@ -280,7 +280,7 @@ ] }, "search": { - "description": "Returns all developer metadata matching the specified DataFilter. If the provided DataFilter represents a DeveloperMetadataLookup object, this will return all DeveloperMetadata entries selected by it. If the DataFilter represents a location in a spreadsheet, this will return all developer metadata associated with locations intersecting that region.", + "description": "Returns all developer metadata matching the specified DataFilter. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). If the provided DataFilter represents a DeveloperMetadataLookup object, this will return all DeveloperMetadata entries selected by it. If the DataFilter represents a location in a spreadsheet, this will return all developer metadata associated with locations intersecting that region.", "flatPath": "v4/spreadsheets/{spreadsheetId}/developerMetadata:search", "httpMethod": "POST", "id": "sheets.spreadsheets.developerMetadata.search", @@ -480,7 +480,7 @@ ] }, "batchClearByDataFilter": { - "description": "Clears one or more ranges of values from a spreadsheet. The caller must specify the spreadsheet ID and one or more DataFilters. Ranges matching any of the specified data filters will be cleared. Only values are cleared -- all other properties of the cell (such as formatting, data validation, etc..) are kept.", + "description": "Clears one or more ranges of values from a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). The caller must specify the spreadsheet ID and one or more DataFilters. Ranges matching any of the specified data filters will be cleared. Only values are cleared -- all other properties of the cell (such as formatting, data validation, etc.) are kept.", "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter", "httpMethod": "POST", "id": "sheets.spreadsheets.values.batchClearByDataFilter", @@ -586,7 +586,7 @@ ] }, "batchGetByDataFilter": { - "description": "Returns one or more ranges of values that match the specified data filters. The caller must specify the spreadsheet ID and one or more DataFilters. Ranges that match any of the data filters in the request will be returned.", + "description": "Returns one or more ranges of values that match the specified data filters. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). The caller must specify the spreadsheet ID and one or more DataFilters. Ranges that match any of the data filters in the request will be returned.", "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter", "httpMethod": "POST", "id": "sheets.spreadsheets.values.batchGetByDataFilter", @@ -644,7 +644,7 @@ ] }, "batchUpdateByDataFilter": { - "description": "Sets values in one or more ranges of a spreadsheet. The caller must specify the spreadsheet ID, a valueInputOption, and one or more DataFilterValueRanges.", + "description": "Sets values in one or more ranges of a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). The caller must specify the spreadsheet ID, a valueInputOption, and one or more DataFilterValueRanges.", "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter", "httpMethod": "POST", "id": "sheets.spreadsheets.values.batchUpdateByDataFilter", @@ -875,7 +875,7 @@ } } }, - "revision": "20251110", + "revision": "20260213", "rootUrl": "https://sheets.googleapis.com/", "schemas": { "AddBandingRequest": { @@ -995,7 +995,7 @@ "properties": { "filter": { "$ref": "FilterView", - "description": "The filter to add. The filterViewId field is optional; if one is not set, an id will be randomly generated. (It is an error to specify the ID of a filter that already exists.)" + "description": "The filter to add. The filterViewId field is optional. If one is not set, an ID will be randomly generated. (It is an error to specify the ID of a filter that already exists.)" } }, "type": "object" @@ -1614,7 +1614,7 @@ "type": "object" }, "BasicFilter": { - "description": "The default filter associated with a sheet.", + "description": "The default filter associated with a sheet. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters).", "id": "BasicFilter", "properties": { "criteria": { @@ -1694,7 +1694,7 @@ "id": "BatchClearValuesByDataFilterResponse", "properties": { "clearedRanges": { - "description": "The ranges that were cleared, in [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). If the requests are for an unbounded range or a ranger larger than the bounds of the sheet, this is the actual ranges that were cleared, bounded to the sheet's limits.", + "description": "The ranges that were cleared, in [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). If the requests are for an unbounded range or a range larger than the bounds of the sheet, this is the actual ranges that were cleared, bounded to the sheet's limits.", "items": { "type": "string" }, @@ -1726,7 +1726,7 @@ "id": "BatchClearValuesResponse", "properties": { "clearedRanges": { - "description": "The ranges that were cleared, in A1 notation. If the requests are for an unbounded range or a ranger larger than the bounds of the sheet, this is the actual ranges that were cleared, bounded to the sheet's limits.", + "description": "The ranges that were cleared, in A1 notation. If the requests are for an unbounded range or a range larger than the bounds of the sheet, this is the actual ranges that were cleared, bounded to the sheet's limits.", "items": { "type": "string" }, @@ -3030,7 +3030,7 @@ "id": "ClearValuesResponse", "properties": { "clearedRange": { - "description": "The range (in A1 notation) that was cleared. (If the request was for an unbounded range or a ranger larger than the bounds of the sheet, this will be the actual range that was cleared, bounded to the sheet's limits.)", + "description": "The range (in A1 notation) that was cleared. (If the request was for an unbounded range or a range larger than the bounds of the sheet, this will be the actual range that was cleared, bounded to the sheet's limits.)", "type": "string" }, "spreadsheetId": { @@ -3365,7 +3365,7 @@ "type": "object" }, "DataFilter": { - "description": "Filter that describes what data should be selected or returned from a request.", + "description": "Filter that describes what data should be selected or returned from a request. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata).", "id": "DataFilter", "properties": { "a1Range": { @@ -4156,7 +4156,7 @@ "type": "object" }, "DeveloperMetadata": { - "description": "Developer metadata associated with a location or object in a spreadsheet. Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata will still be associated with the row it was first associated with (what is now row 6). If the associated object is deleted its metadata is deleted too.", + "description": "Developer metadata associated with a location or object in a spreadsheet. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). Developer metadata may be used to associate arbitrary data with various parts of a spreadsheet and it will remain associated at those locations as they move around and the spreadsheet is edited. For example, if developer metadata is associated with row 5 and another row is then subsequently inserted above row 5, that original metadata is still associated with the row it was first associated with (what is now row 6). If the associated object is deleted then its metadata is deleted too.", "id": "DeveloperMetadata", "properties": { "location": { @@ -4177,7 +4177,7 @@ "type": "string" }, "visibility": { - "description": "The metadata visibility. Developer metadata must always have a visibility specified.", + "description": "The metadata visibility. Developer metadata must always have visibility specified.", "enum": [ "DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED", "DOCUMENT", @@ -4199,7 +4199,7 @@ "properties": { "dimensionRange": { "$ref": "DimensionRange", - "description": "Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span multiple rows or columns." + "description": "Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column. It cannot be unbounded or span multiple rows or columns." }, "locationType": { "description": "The type of location this object represents. This field is read-only.", @@ -4232,7 +4232,7 @@ "type": "object" }, "DeveloperMetadataLookup": { - "description": "Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that matches the intersection of all the specified fields; any field or combination of fields may be specified.", + "description": "Selects DeveloperMetadata that matches all of the specified fields. For example, if only a metadata ID is specified this considers the DeveloperMetadata with that particular unique ID. If a metadata key is specified, this considers all developer metadata with that key. If a key, visibility, and location type are all specified, this considers all developer metadata with that key and visibility that are associated with a location of that type. In general, this selects all DeveloperMetadata that match the intersection of all the specified fields; any field or combination of fields may be specified.", "id": "DeveloperMetadataLookup", "properties": { "locationMatchingStrategy": { @@ -4250,7 +4250,7 @@ "type": "string" }, "locationType": { - "description": "Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location: spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT.", + "description": "Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location. Spreadsheet metadata cannot intersect any other developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT.", "enum": [ "DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED", "ROW", @@ -4602,12 +4602,12 @@ "type": "object" }, "FilterCriteria": { - "description": "Criteria for showing/hiding rows in a filter or filter view.", + "description": "Criteria for showing or hiding rows in a filter or filter view.", "id": "FilterCriteria", "properties": { "condition": { "$ref": "BooleanCondition", - "description": "A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.)" + "description": "A condition that must be `true` for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.)" }, "hiddenValues": { "description": "Values that should be hidden.", @@ -4658,7 +4658,7 @@ "type": "object" }, "FilterView": { - "description": "A filter view.", + "description": "A filter view. For more information, see [Manage data visibility with filters](https://developers.google.com/workspace/sheets/api/guides/filters).", "id": "FilterView", "properties": { "criteria": { @@ -4670,7 +4670,7 @@ "type": "object" }, "filterSpecs": { - "description": "The filter criteria for showing/hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence.", + "description": "The filter criteria for showing or hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence.", "items": { "$ref": "FilterSpec" }, @@ -4682,12 +4682,12 @@ "type": "integer" }, "namedRangeId": { - "description": "The named range this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set.", + "description": "The named range this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set.", "type": "string" }, "range": { "$ref": "GridRange", - "description": "The range this filter view covers. When writing, only one of range or named_range_id or table_id may be set." + "description": "The range this filter view covers. When writing, only one of range, named_range_id, or table_id may be set." }, "sortSpecs": { "description": "The sort order per column. Later specifications are used when values are equal in the earlier specifications.", @@ -4697,7 +4697,7 @@ "type": "array" }, "tableId": { - "description": "The table this filter view is backed by, if any. When writing, only one of range or named_range_id or table_id may be set.", + "description": "The table this filter view is backed by, if any. When writing, only one of range, named_range_id, or table_id may be set.", "type": "string" }, "title": { diff --git a/sheets/v4/sheets-gen.go b/sheets/v4/sheets-gen.go index 7521a49ed8..db1631c3ba 100644 --- a/sheets/v4/sheets-gen.go +++ b/sheets/v4/sheets-gen.go @@ -447,8 +447,8 @@ func (s AddDimensionGroupResponse) MarshalJSON() ([]byte, error) { // AddFilterViewRequest: Adds a filter view. type AddFilterViewRequest struct { - // Filter: The filter to add. The filterViewId field is optional; if one is not - // set, an id will be randomly generated. (It is an error to specify the ID of + // Filter: The filter to add. The filterViewId field is optional. If one is not + // set, an ID will be randomly generated. (It is an error to specify the ID of // a filter that already exists.) Filter *FilterView `json:"filter,omitempty"` // ForceSendFields is a list of field names (e.g. "Filter") to unconditionally @@ -1274,7 +1274,9 @@ func (s BasicChartSpec) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// BasicFilter: The default filter associated with a sheet. +// BasicFilter: The default filter associated with a sheet. For more +// information, see Manage data visibility with filters +// (https://developers.google.com/workspace/sheets/api/guides/filters). type BasicFilter struct { // Criteria: The criteria for showing/hiding values per column. The map's key // is the column index, and the value is the criteria for that column. This @@ -1372,9 +1374,9 @@ func (s BatchClearValuesByDataFilterRequest) MarshalJSON() ([]byte, error) { type BatchClearValuesByDataFilterResponse struct { // ClearedRanges: The ranges that were cleared, in A1 notation // (https://developers.google.com/workspace/sheets/api/guides/concepts#cell). - // If the requests are for an unbounded range or a ranger larger than the - // bounds of the sheet, this is the actual ranges that were cleared, bounded to - // the sheet's limits. + // If the requests are for an unbounded range or a range larger than the bounds + // of the sheet, this is the actual ranges that were cleared, bounded to the + // sheet's limits. ClearedRanges []string `json:"clearedRanges,omitempty"` // SpreadsheetId: The spreadsheet the updates were applied to. SpreadsheetId string `json:"spreadsheetId,omitempty"` @@ -1427,7 +1429,7 @@ func (s BatchClearValuesRequest) MarshalJSON() ([]byte, error) { // spreadsheet. type BatchClearValuesResponse struct { // ClearedRanges: The ranges that were cleared, in A1 notation. If the requests - // are for an unbounded range or a ranger larger than the bounds of the sheet, + // are for an unbounded range or a range larger than the bounds of the sheet, // this is the actual ranges that were cleared, bounded to the sheet's limits. ClearedRanges []string `json:"clearedRanges,omitempty"` // SpreadsheetId: The spreadsheet the updates were applied to. @@ -3115,7 +3117,7 @@ type ClearValuesRequest struct { // spreadsheet. type ClearValuesResponse struct { // ClearedRange: The range (in A1 notation) that was cleared. (If the request - // was for an unbounded range or a ranger larger than the bounds of the sheet, + // was for an unbounded range or a range larger than the bounds of the sheet, // this will be the actual range that was cleared, bounded to the sheet's // limits.) ClearedRange string `json:"clearedRange,omitempty"` @@ -3582,7 +3584,8 @@ func (s DataExecutionStatus) MarshalJSON() ([]byte, error) { } // DataFilter: Filter that describes what data should be selected or returned -// from a request. +// from a request. For more information, see Read, write, and search metadata +// (https://developers.google.com/workspace/sheets/api/guides/metadata). type DataFilter struct { // A1Range: Selects data that matches the specified A1 range. A1Range string `json:"a1Range,omitempty"` @@ -4704,13 +4707,15 @@ func (s DeleteTableRequest) MarshalJSON() ([]byte, error) { } // DeveloperMetadata: Developer metadata associated with a location or object -// in a spreadsheet. Developer metadata may be used to associate arbitrary data -// with various parts of a spreadsheet and will remain associated at those -// locations as they move around and the spreadsheet is edited. For example, if -// developer metadata is associated with row 5 and another row is then -// subsequently inserted above row 5, that original metadata will still be -// associated with the row it was first associated with (what is now row 6). If -// the associated object is deleted its metadata is deleted too. +// in a spreadsheet. For more information, see Read, write, and search metadata +// (https://developers.google.com/workspace/sheets/api/guides/metadata). +// Developer metadata may be used to associate arbitrary data with various +// parts of a spreadsheet and it will remain associated at those locations as +// they move around and the spreadsheet is edited. For example, if developer +// metadata is associated with row 5 and another row is then subsequently +// inserted above row 5, that original metadata is still associated with the +// row it was first associated with (what is now row 6). If the associated +// object is deleted then its metadata is deleted too. type DeveloperMetadata struct { // Location: The location where the metadata is associated. Location *DeveloperMetadataLocation `json:"location,omitempty"` @@ -4724,7 +4729,7 @@ type DeveloperMetadata struct { MetadataKey string `json:"metadataKey,omitempty"` // MetadataValue: Data associated with the metadata's key. MetadataValue string `json:"metadataValue,omitempty"` - // Visibility: The metadata visibility. Developer metadata must always have a + // Visibility: The metadata visibility. Developer metadata must always have // visibility specified. // // Possible values: @@ -4760,7 +4765,7 @@ func (s DeveloperMetadata) MarshalJSON() ([]byte, error) { type DeveloperMetadataLocation struct { // DimensionRange: Represents the row or column when metadata is associated // with a dimension. The specified DimensionRange must represent a single row - // or column; it cannot be unbounded or span multiple rows or columns. + // or column. It cannot be unbounded or span multiple rows or columns. DimensionRange *DimensionRange `json:"dimensionRange,omitempty"` // LocationType: The type of location this object represents. This field is // read-only. @@ -4802,7 +4807,7 @@ func (s DeveloperMetadataLocation) MarshalJSON() ([]byte, error) { // key. If a key, visibility, and location type are all specified, this // considers all developer metadata with that key and visibility that are // associated with a location of that type. In general, this selects all -// DeveloperMetadata that matches the intersection of all the specified fields; +// DeveloperMetadata that match the intersection of all the specified fields; // any field or combination of fields may be specified. type DeveloperMetadataLookup struct { // LocationMatchingStrategy: Determines how this lookup matches the location. @@ -4834,7 +4839,7 @@ type DeveloperMetadataLookup struct { // associated on rows. If the field is left unspecified, all location types are // considered. This field cannot be specified as SPREADSHEET when the // locationMatchingStrategy is specified as INTERSECTING or when the - // metadataLocation is specified as a non-spreadsheet location: spreadsheet + // metadataLocation is specified as a non-spreadsheet location. Spreadsheet // metadata cannot intersect any other developer metadata location. This field // also must be left unspecified when the locationMatchingStrategy is specified // as EXACT. @@ -5293,11 +5298,12 @@ func (s *ExtendedValue) UnmarshalJSON(data []byte) error { return nil } -// FilterCriteria: Criteria for showing/hiding rows in a filter or filter view. +// FilterCriteria: Criteria for showing or hiding rows in a filter or filter +// view. type FilterCriteria struct { - // Condition: A condition that must be true for values to be shown. (This does - // not override hidden_values -- if a value is listed there, it will still be - // hidden.) + // Condition: A condition that must be `true` for values to be shown. (This + // does not override hidden_values -- if a value is listed there, it will still + // be hidden.) Condition *BooleanCondition `json:"condition,omitempty"` // HiddenValues: Values that should be hidden. HiddenValues []string `json:"hiddenValues,omitempty"` @@ -5363,29 +5369,31 @@ func (s FilterSpec) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// FilterView: A filter view. +// FilterView: A filter view. For more information, see Manage data visibility +// with filters +// (https://developers.google.com/workspace/sheets/api/guides/filters). type FilterView struct { // Criteria: The criteria for showing/hiding values per column. The map's key // is the column index, and the value is the criteria for that column. This // field is deprecated in favor of filter_specs. Criteria map[string]FilterCriteria `json:"criteria,omitempty"` - // FilterSpecs: The filter criteria for showing/hiding values per column. Both - // criteria and filter_specs are populated in responses. If both fields are - // specified in an update request, this field takes precedence. + // FilterSpecs: The filter criteria for showing or hiding values per column. + // Both criteria and filter_specs are populated in responses. If both fields + // are specified in an update request, this field takes precedence. FilterSpecs []*FilterSpec `json:"filterSpecs,omitempty"` // FilterViewId: The ID of the filter view. FilterViewId int64 `json:"filterViewId,omitempty"` // NamedRangeId: The named range this filter view is backed by, if any. When - // writing, only one of range or named_range_id or table_id may be set. + // writing, only one of range, named_range_id, or table_id may be set. NamedRangeId string `json:"namedRangeId,omitempty"` - // Range: The range this filter view covers. When writing, only one of range or - // named_range_id or table_id may be set. + // Range: The range this filter view covers. When writing, only one of range, + // named_range_id, or table_id may be set. Range *GridRange `json:"range,omitempty"` // SortSpecs: The sort order per column. Later specifications are used when // values are equal in the earlier specifications. SortSpecs []*SortSpec `json:"sortSpecs,omitempty"` // TableId: The table this filter view is backed by, if any. When writing, only - // one of range or named_range_id or table_id may be set. + // one of range, named_range_id, or table_id may be set. TableId string `json:"tableId,omitempty"` // Title: The name of the filter view. Title string `json:"title,omitempty"` @@ -10119,17 +10127,19 @@ type SpreadsheetsGetByDataFilterCall struct { } // GetByDataFilter: Returns the spreadsheet at the given ID. The caller must -// specify the spreadsheet ID. This method differs from GetSpreadsheet in that -// it allows selecting which subsets of spreadsheet data to return by -// specifying a dataFilters parameter. Multiple DataFilters can be specified. -// Specifying one or more data filters returns the portions of the spreadsheet -// that intersect ranges matched by any of the filters. By default, data within -// grids is not returned. You can include grid data one of 2 ways: * Specify a -// field mask +// specify the spreadsheet ID. For more information, see Read, write, and +// search metadata +// (https://developers.google.com/workspace/sheets/api/guides/metadata). This +// method differs from GetSpreadsheet in that it allows selecting which subsets +// of spreadsheet data to return by specifying a dataFilters parameter. +// Multiple DataFilters can be specified. Specifying one or more data filters +// returns the portions of the spreadsheet that intersect ranges matched by any +// of the filters. By default, data within grids is not returned. You can +// include grid data in one of two ways: * Specify a field mask // (https://developers.google.com/workspace/sheets/api/guides/field-masks) -// listing your desired fields using the `fields` URL parameter in HTTP * Set -// the includeGridData parameter to true. If a field mask is set, the -// `includeGridData` parameter is ignored For large spreadsheets, as a best +// listing your desired fields using the `fields` URL parameter in HTTP. * Set +// the includeGridData parameter to `true`. If a field mask is set, the +// `includeGridData` parameter is ignored. For large spreadsheets, as a best // practice, retrieve only the specific spreadsheet fields that you want. // // - spreadsheetId: The spreadsheet to request. @@ -10236,6 +10246,8 @@ type SpreadsheetsDeveloperMetadataGetCall struct { // Get: Returns the developer metadata with the specified ID. The caller must // specify the spreadsheet ID and the developer metadata's unique metadataId. +// For more information, see Read, write, and search metadata +// (https://developers.google.com/workspace/sheets/api/guides/metadata). // // - metadataId: The ID of the developer metadata to retrieve. // - spreadsheetId: The ID of the spreadsheet to retrieve metadata from. @@ -10348,9 +10360,11 @@ type SpreadsheetsDeveloperMetadataSearchCall struct { header_ http.Header } -// Search: Returns all developer metadata matching the specified DataFilter. If -// the provided DataFilter represents a DeveloperMetadataLookup object, this -// will return all DeveloperMetadata entries selected by it. If the DataFilter +// Search: Returns all developer metadata matching the specified DataFilter. +// For more information, see Read, write, and search metadata +// (https://developers.google.com/workspace/sheets/api/guides/metadata). If the +// provided DataFilter represents a DeveloperMetadataLookup object, this will +// return all DeveloperMetadata entries selected by it. If the DataFilter // represents a location in a spreadsheet, this will return all developer // metadata associated with locations intersecting that region. // @@ -10901,10 +10915,12 @@ type SpreadsheetsValuesBatchClearByDataFilterCall struct { } // BatchClearByDataFilter: Clears one or more ranges of values from a -// spreadsheet. The caller must specify the spreadsheet ID and one or more -// DataFilters. Ranges matching any of the specified data filters will be -// cleared. Only values are cleared -- all other properties of the cell (such -// as formatting, data validation, etc..) are kept. +// spreadsheet. For more information, see Read, write, and search metadata +// (https://developers.google.com/workspace/sheets/api/guides/metadata). The +// caller must specify the spreadsheet ID and one or more DataFilters. Ranges +// matching any of the specified data filters will be cleared. Only values are +// cleared -- all other properties of the cell (such as formatting, data +// validation, etc.) are kept. // // - spreadsheetId: The ID of the spreadsheet to update. func (r *SpreadsheetsValuesService) BatchClearByDataFilter(spreadsheetId string, batchclearvaluesbydatafilterrequest *BatchClearValuesByDataFilterRequest) *SpreadsheetsValuesBatchClearByDataFilterCall { @@ -11203,9 +11219,11 @@ type SpreadsheetsValuesBatchGetByDataFilterCall struct { } // BatchGetByDataFilter: Returns one or more ranges of values that match the -// specified data filters. The caller must specify the spreadsheet ID and one -// or more DataFilters. Ranges that match any of the data filters in the -// request will be returned. +// specified data filters. For more information, see Read, write, and search +// metadata +// (https://developers.google.com/workspace/sheets/api/guides/metadata). The +// caller must specify the spreadsheet ID and one or more DataFilters. Ranges +// that match any of the data filters in the request will be returned. // // - spreadsheetId: The ID of the spreadsheet to retrieve data from. func (r *SpreadsheetsValuesService) BatchGetByDataFilter(spreadsheetId string, batchgetvaluesbydatafilterrequest *BatchGetValuesByDataFilterRequest) *SpreadsheetsValuesBatchGetByDataFilterCall { @@ -11416,8 +11434,10 @@ type SpreadsheetsValuesBatchUpdateByDataFilterCall struct { } // BatchUpdateByDataFilter: Sets values in one or more ranges of a spreadsheet. -// The caller must specify the spreadsheet ID, a valueInputOption, and one or -// more DataFilterValueRanges. +// For more information, see Read, write, and search metadata +// (https://developers.google.com/workspace/sheets/api/guides/metadata). The +// caller must specify the spreadsheet ID, a valueInputOption, and one or more +// DataFilterValueRanges. // // - spreadsheetId: The ID of the spreadsheet to update. func (r *SpreadsheetsValuesService) BatchUpdateByDataFilter(spreadsheetId string, batchupdatevaluesbydatafilterrequest *BatchUpdateValuesByDataFilterRequest) *SpreadsheetsValuesBatchUpdateByDataFilterCall { diff --git a/threatintelligence/v1beta/threatintelligence-api.json b/threatintelligence/v1beta/threatintelligence-api.json index 0595c93311..7ea1818615 100644 --- a/threatintelligence/v1beta/threatintelligence-api.json +++ b/threatintelligence/v1beta/threatintelligence-api.json @@ -430,62 +430,6 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, - "refreshUriStatus": { - "description": "Return the status of a URI submitted to Google WebRisk.", - "flatPath": "v1beta/projects/{projectsId}/alerts/{alertsId}:refreshUriStatus", - "httpMethod": "POST", - "id": "threatintelligence.projects.alerts.refreshUriStatus", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. Name of alert to refresh status from WebRisk", - "location": "path", - "pattern": "^projects/[^/]+/alerts/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta/{+name}:refreshUriStatus", - "request": { - "$ref": "RefreshAlertUriStatusRequest" - }, - "response": { - "$ref": "RefreshAlertUriStatusResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "reportAlertUri": { - "description": "Report the URI associated with an alert to Google WebRisk.", - "flatPath": "v1beta/projects/{projectsId}/alerts/{alertsId}:reportAlertUri", - "httpMethod": "POST", - "id": "threatintelligence.projects.alerts.reportAlertUri", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. Name of alert to submit to WebRisk.", - "location": "path", - "pattern": "^projects/[^/]+/alerts/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta/{+name}:reportAlertUri", - "request": { - "$ref": "ReportAlertUriRequest" - }, - "response": { - "$ref": "ReportAlertUriResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "resolve": { "description": "Marks an alert to closed state - RESOLVED.", "flatPath": "v1beta/projects/{projectsId}/alerts/{alertsId}:resolve", @@ -888,24 +832,9 @@ } } }, - "revision": "20260211", + "revision": "20260218", "rootUrl": "https://threatintelligence.googleapis.com/", "schemas": { - "AffectedSoftware": { - "description": "The software that is affected by the vulnerability.", - "id": "AffectedSoftware", - "properties": { - "product": { - "description": "Optional. The product of the software.", - "type": "string" - }, - "vendor": { - "description": "Optional. The vendor of the software.", - "type": "string" - } - }, - "type": "object" - }, "Alert": { "description": "Stateful object representing a group of Findings. Key feature to an Alert is that it expresses the user's intent towards the findings of that group, even those that haven't occurred yet.", "id": "Alert", @@ -914,14 +843,6 @@ "description": "Optional. AI summary of the finding.", "type": "string" }, - "assets": { - "description": "Output only. Assets that are impacted by this alert.", - "items": { - "type": "string" - }, - "readOnly": true, - "type": "array" - }, "audit": { "$ref": "Audit", "description": "Output only. Audit information for the alert.", @@ -1054,14 +975,6 @@ "insiderThreat": { "$ref": "InsiderThreatAlertDetail", "description": "Insider Threat alert detail type." - }, - "suspiciousDomain": { - "$ref": "SuspiciousDomainAlertDetail", - "description": "Domain Monitoring alert detail type." - }, - "targetTechnology": { - "$ref": "TargetTechnologyAlertDetail", - "description": "Technology Watchlist alert detail type." } }, "type": "object" @@ -1158,133 +1071,6 @@ }, "type": "object" }, - "AssetDiscoveryConfig": { - "description": "Customer defined Configuration for asset discovery.", - "id": "AssetDiscoveryConfig", - "properties": { - "lastScanCompleteTime": { - "description": "Output only. Timestamp of the last scan completed. This field is set by the system and cannot be modified by the user.", - "format": "google-datetime", - "readOnly": true, - "type": "string" - }, - "lastScanStartTime": { - "description": "Output only. Timestamp of the last scan started - used for scheduling the next scan. This field is set by the system and cannot be modified by the user.", - "format": "google-datetime", - "readOnly": true, - "type": "string" - }, - "scanFrequency": { - "description": "Required. Frequency at which the scheduled discovery scan should be run. If not specified, the default frequency is DAILY.", - "enum": [ - "ASSET_DISCOVERY_SCAN_FREQUENCY_UNSPECIFIED", - "ON_DEMAND", - "WEEKLY", - "DAILY", - "MONTHLY" - ], - "enumDescriptions": [ - "Default value, should never be set.", - "Scan is triggered on demand.", - "Scan is triggered weekly.", - "Scan is triggered daily.", - "Scan is triggered monthly." - ], - "type": "string" - }, - "scopeExclusionAssets": { - "description": "Optional. Seed assets that are out of scope for the scheduled discovery scan.", - "items": { - "$ref": "AssetDiscoverySeed" - }, - "type": "array" - }, - "seedAssets": { - "description": "Required. Seed assets for the scheduled discovery scan. At least one seed asset is required.", - "items": { - "$ref": "AssetDiscoverySeed" - }, - "type": "array" - }, - "workflow": { - "description": "Required. Workflow to be used for the scheduled discovery scan. If not specified, the default workflow is EXTERNAL_DISCOVERY.", - "enum": [ - "ASSET_DISCOVERY_WORKFLOW_UNSPECIFIED", - "EXTERNAL_DISCOVERY", - "EXTERNAL_DISCOVERY_AND_ASSESSMENT", - "MOBILE_APP_DISCOVERY" - ], - "enumDescriptions": [ - "Default value, should never be set.", - "Discovery workflow that only discovers external facing assets.", - "Discovery workflow that discovers external facing assets and generates relevant alerts on them.", - "Discovery workflow that discovers mobile app assets." - ], - "type": "string" - } - }, - "type": "object" - }, - "AssetDiscoverySeed": { - "description": "Seed assets for asset discovery.", - "id": "AssetDiscoverySeed", - "properties": { - "seedType": { - "description": "Required. Type of the seed asset.", - "enum": [ - "ASSET_DISCOVERY_SEED_TYPE_UNSPECIFIED", - "IP_ADDRESS", - "NETWORK_SERVICE" - ], - "enumDescriptions": [ - "Default value, should never be set.", - "Seed asset is an IP address.", - "Seed asset is a network service." - ], - "type": "string" - }, - "seedValue": { - "description": "Required. Value for the seed asset. Could be an IP address, network service, email addresses, etc.", - "type": "string" - } - }, - "type": "object" - }, - "Association": { - "description": "Represents an association with a vulnerability.", - "id": "Association", - "properties": { - "id": { - "description": "Required. The ID of the association.", - "type": "string" - }, - "type": { - "description": "Required. The type of the association.", - "enum": [ - "THREAT_INTEL_OBJECT_TYPE_UNSPECIFIED", - "THREAT_INTEL_OBJECT_TYPE_THREAT_ACTOR", - "THREAT_INTEL_OBJECT_TYPE_MALWARE", - "THREAT_INTEL_OBJECT_TYPE_REPORT", - "THREAT_INTEL_OBJECT_TYPE_CAMPAIGN", - "THREAT_INTEL_OBJECT_TYPE_IOC_COLLECTION", - "THREAT_INTEL_OBJECT_TYPE_SOFTWARE_AND_TOOLKITS", - "THREAT_INTEL_OBJECT_TYPE_VULNERABILITY" - ], - "enumDescriptions": [ - "Unspecified object type.", - "Threat actor object type.", - "Malware object type.", - "Report object type.", - "Campaign object type.", - "IoC Collection object type.", - "Software and toolkits object type.", - "Vulnerability object type." - ], - "type": "string" - } - }, - "type": "object" - }, "Audit": { "description": "Tracks basic CRUD facts.", "id": "Audit", @@ -1314,73 +1100,6 @@ }, "type": "object" }, - "CompromisedCredentialsFindingDetail": { - "description": "Sample compromised credential detail.", - "id": "CompromisedCredentialsFindingDetail", - "properties": { - "author": { - "deprecated": true, - "description": "Optional. Reference to the author this detail was extracted from. This is deprecated and will be removed.", - "type": "string" - }, - "credentialService": { - "description": "Optional. Claimed site the credential is intended for.", - "type": "string" - }, - "darkWebDoc": { - "deprecated": true, - "description": "Optional. Reference to the dark web document. This is deprecated and will be removed.", - "type": "string" - }, - "externalReferenceUri": { - "description": "Optional. This will contain a link to the external reference for this credential. If set, this is a link back to the DTM product to allow customers to get additional context about this finding.", - "type": "string" - }, - "fileDump": { - "description": "Optional. If the source of the credential was from a file dump this will contain the name of the file the credential was found in. This can be used by customers for context on where the credential was found and to try to find other references to the file in the wild.", - "type": "string" - }, - "fileDumpHashes": { - "description": "Optional. A list of hashes of the file dump. These will be prefixed with the algorithm. Example: \"sha256:\"", - "items": { - "type": "string" - }, - "type": "array" - }, - "fileDumpSizeBytes": { - "description": "Optional. If file_dump is set this will contain the size of the dump file in bytes. File dumps can be very large.", - "format": "int64", - "type": "string" - }, - "forum": { - "deprecated": true, - "description": "Optional. Reference to the forum this detail was extracted from. This is deprecated and will be removed.", - "type": "string" - }, - "malwareFamily": { - "description": "Optional. This will indicate the malware family that leaked this credential, if known.", - "type": "string" - }, - "postedTime": { - "description": "Optional. This indicates our best guess as to when the credential was leaked to the particular venue that triggered this finding. This is not necessarily the time the credential was actually leaked and it may not always be be accurate.", - "format": "google-datetime", - "type": "string" - }, - "sourceUri": { - "description": "Optional. If the source of a credential is publicly addressable this will contain a uri to the where the credential was found.", - "type": "string" - }, - "userKey": { - "description": "Required. This field will always be set and will be used to identify the user named in the credential leak. In cases where customers are authorized to see the actual user key this will be set to the actual user key. In cases where the customer is not authorized to see the actual user key this will be set to a hash of the user key. The hashed value is an intentionally opaque value that is not intended to be used for any other purpose than to uniquely identify the user in the context of this specific customer, service domain, and user name. Example: \"user@example.com\" or \"redacted:\".", - "type": "string" - }, - "userSecretEvidence": { - "description": "Optional. Claimed evidence of the password/secret. This will always be hashed. In the event where the plaintext password is known it will be set to \"redacted:\" where the same hash will be presented when the same password is found for the same organization for the same service. Redaction is done by hashing the password with a salt that is unique to the customer organization and service. In the event where the plaintext password is not known it will be set to \":\" where the algorithm is the hash algorithm used and the hash is the hash of the password using that algorithm. In the event we don't know the exact algorithm used we will set it to \"hashed:\".", - "type": "string" - } - }, - "type": "object" - }, "Configuration": { "description": "A configuration represents a behavior an engine should follow when producing new findings.", "id": "Configuration", @@ -1404,7 +1123,7 @@ "type": "string" }, "name": { - "description": "Identifier. Server generated name for the configuration. format is vaults/{vault}/configurations/{configuration}", + "description": "Identifier. Server generated name for the configuration. format is projects/{project}/configurations/{configuration}", "type": "string" }, "provider": { @@ -1438,10 +1157,6 @@ "description": "Wrapper class that contains the union struct for all the various configuration detail specific classes.", "id": "ConfigurationDetail", "properties": { - "assetDiscovery": { - "$ref": "AssetDiscoveryConfig", - "description": "Asset Discovery detail config." - }, "customerProfile": { "$ref": "CustomerProfileConfig", "description": "Customer Profile detail config." @@ -1450,18 +1165,6 @@ "description": "Output only. Name of the detail type. Will be set by the server during creation to the name of the field that is set in the detail union.", "readOnly": true, "type": "string" - }, - "domainMonitoring": { - "$ref": "DomainMonitoringConfig", - "description": "Domain Monitoring detail config." - }, - "initialAccessBroker": { - "$ref": "InitialAccessBrokerConfig", - "description": "Initial Access Broker (IAB) detail config." - }, - "technologyWatchlist": { - "$ref": "TechnologyWatchListConfig", - "description": "Technology Watchlist detail config." } }, "type": "object" @@ -1477,7 +1180,7 @@ "type": "string" }, "name": { - "description": "Identifier. The name of the ConfigurationRevision Format: vaults//configurations//revisions/ OR projects//configurations//revisions/", + "description": "Identifier. The name of the ConfigurationRevision Format: projects//configurations//revisions/", "type": "string" }, "snapshot": { @@ -1899,88 +1602,6 @@ }, "type": "object" }, - "DomainMonitoringConfig": { - "description": "Any account-level configuration options will go here.", - "id": "DomainMonitoringConfig", - "properties": { - "domains": { - "description": "The domains to use as \"seeds\" for Suspicious Domain Monitoring.", - "items": { - "$ref": "DomainMonitoringDomain" - }, - "type": "array" - } - }, - "type": "object" - }, - "DomainMonitoringDomain": { - "description": "A Domain Monitoring \"domain\"", - "id": "DomainMonitoringDomain", - "properties": { - "domain": { - "description": "The domain name to match against.", - "type": "string" - } - }, - "type": "object" - }, - "EntityProfile": { - "description": "EntityProfile represents the structured profile of a customer entity, containing key identifiers and descriptive attributes optimized for contextual matching against threat intelligence, particularly Initial Access Broker (IAB) offerings.", - "id": "EntityProfile", - "properties": { - "countries": { - "description": "Optional. List of specific countries of operation. Purpose: Essential for matching geographically targeted threats (e.g., actor specifies victims in 'DE'). Use ISO 3166-1 alpha-2 codes (e.g., \"US\", \"GB\", \"JP\", \"DE\").", - "items": { - "type": "string" - }, - "type": "array" - }, - "domains": { - "description": "Required. List of primary internet domain names associated with the entity. Purpose: Crucial for explicit matching against domains mentioned in threat intel and can inform semantic matching. Must contain at least one domain. Example: [\"acme.com\", \"acme.co.uk\"]", - "items": { - "type": "string" - }, - "type": "array" - }, - "industries": { - "description": "Optional. List of primary industry sectors the entity operates within. Purpose: Crucial for matching industry-specific threats and understanding attacker motivation. Use standardized GTI Industry Classification values. Example: [\"Technology\", \"Financial Services\", \"Healthcare\"]", - "items": { - "type": "string" - }, - "type": "array" - }, - "name": { - "description": "Required. Canonical name of the entity (e.g., the legal company name). Purpose: Primary identifier for the customer.", - "type": "string" - }, - "operationalAreas": { - "description": "Optional. Specific geographic areas of *significant* operational concentration or strategic importance below the country level, if clearly identifiable and relevant. Purpose: Useful for highly localized threats, less commonly populated than `countries`. Example: [\"Silicon Valley\", \"Frankfurt am Main Metropolitan Region\"]", - "items": { - "type": "string" - }, - "type": "array" - }, - "profileSummary": { - "description": "Required. A concise, machine-generated (e.g., LLM) or human-curated summary of the entity. Purpose: Captures the semantic essence for embedding generation and similarity matching. Should synthesize key aspects like core business, scale, and market. Example: \"Acme Corporation is a large, US-based multinational conglomerate operating...\"", - "type": "string" - }, - "regions": { - "description": "Optional. List of primary geopolitical regions where the entity has significant operations. Purpose: Filters geographically relevant threats. Use standardized names or codes where possible (e.g., \"North America\", \"EMEA\", \"APAC\", UN M49 codes).", - "items": { - "type": "string" - }, - "type": "array" - }, - "subIndustries": { - "description": "Optional. List of more granular sub-industries, if applicable and known. Purpose: Provides finer-grained context for more specific threat matching. Should align with GTI classifications if possible. Example: [\"Semiconductors\", \"Cloud Computing Services\", \"Investment Banking\"]", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "EnumerateAlertFacetsResponse": { "description": "Response message for EnumerateAlertFacets.", "id": "EnumerateAlertFacetsResponse", @@ -2079,10 +1700,6 @@ "description": "Optional. Name of the alert that this finding is bound to.", "type": "string" }, - "asset": { - "description": "Optional. Optional - asset name if known. Format: vaults/{vault}/assets/{asset}", - "type": "string" - }, "audit": { "$ref": "Audit", "description": "Output only. Audit data about the finding.", @@ -2103,12 +1720,8 @@ "description": "Required. A short descriptive title for the finding \u003c= 250 chars. EX: \"Actor 'baddy' offering $1000 for credentials of 'goodguy'\".", "type": "string" }, - "issue": { - "description": "Optional. Optional - name of the issue that this finding is bound to. Format: vaults/{vault}/issues/{issue}", - "type": "string" - }, "name": { - "description": "Identifier. Server generated name for the finding (leave clear during creation). Format: vaults/{vault}/findings/{finding}", + "description": "Identifier. Server generated name for the finding (leave clear during creation). Format: projects/{project}/findings/{finding}", "type": "string" }, "provider": { @@ -2147,10 +1760,6 @@ "description": "Wrapper class that contains the union struct for all the various findings detail specific classes.", "id": "FindingDetail", "properties": { - "compromisedCredentials": { - "$ref": "CompromisedCredentialsFindingDetail", - "description": "Compromised Credentials detail type." - }, "dataLeak": { "$ref": "DataLeakFindingDetail", "description": "Data Leak finding detail type." @@ -2160,10 +1769,6 @@ "readOnly": true, "type": "string" }, - "inbandVulnerability": { - "$ref": "InbandVulnerabilityFindingDetail", - "description": "Inband vulnerability detail type." - }, "initialAccessBroker": { "$ref": "InitialAccessBrokerFindingDetail", "description": "Initial Access Broker finding detail type." @@ -2171,18 +1776,6 @@ "insiderThreat": { "$ref": "InsiderThreatFindingDetail", "description": "Insider Threat finding detail type." - }, - "misconfiguration": { - "$ref": "MisconfigurationFindingDetail", - "description": "Misconfiguration finding detail type." - }, - "suspiciousDomain": { - "$ref": "SuspiciousDomainFindingDetail", - "description": "Domain Monitoring finding detail type." - }, - "targetTechnology": { - "$ref": "TargetTechnologyFindingDetail", - "description": "Technology Watchlist finding detail type." } }, "type": "object" @@ -2202,139 +1795,34 @@ }, "type": "object" }, - "InbandVulnerability": { - "description": "Fleshed out vulnerability object that includes enough details to fill out a vulnerability specific view for an issue.", - "id": "InbandVulnerability", + "InitialAccessBrokerAlertDetail": { + "description": "Captures the specific details of InitialAccessBroker (IAB) alert.", + "id": "InitialAccessBrokerAlertDetail", "properties": { - "affectedSoftware": { - "description": "Optional. The software that is affected by the vulnerability.", - "items": { - "$ref": "AffectedSoftware" - }, - "type": "array" - }, - "authors": { - "description": "Optional. The authors of the vulnerability detection.", + "discoveryDocumentIds": { + "description": "Required. Array of ids to accommodate multiple discovery documents", "items": { "type": "string" }, "type": "array" }, - "cveId": { - "description": "Required. The CVE ID of the vulnerability.", + "severity": { + "description": "Required. IAB specific severity", + "type": "string" + } + }, + "type": "object" + }, + "InitialAccessBrokerFindingDetail": { + "description": "A detail object for an Initial Access Broker (IAB) finding.", + "id": "InitialAccessBrokerFindingDetail", + "properties": { + "documentId": { + "description": "Required. The unique identifier of the document that triggered the IAB finding. This ID can be used to retrieve the content of the document for further analysis.", "type": "string" }, - "cvssV31Score": { - "description": "Required. The CVSS V3.1 score (Base score)for the vulnerability. ( )", - "format": "float", - "type": "number" - }, - "cvssV31ScoreTemporal": { - "description": "Optional. Temporal CVSS V3.1 score for the vulnerability.", - "format": "float", - "type": "number" - }, - "description": { - "description": "Optional. The human readable description. This can be basic HTML formatted text.", - "type": "string" - }, - "disclosureTime": { - "description": "Optional. The date the vulnerability was first disclosed.", - "format": "google-datetime", - "type": "string" - }, - "exploitationState": { - "description": "Optional. Exploitation state of the vulnerability, for example \"Available\".", - "type": "string" - }, - "externalVulnerabilityId": { - "description": "Required. The external ID of the vulnerability.", - "type": "string" - }, - "isExploitedWild": { - "description": "Optional. Whether this is exploited in the wild.", - "type": "boolean" - }, - "referenceUrls": { - "description": "Optional. Reference URLs to the vulnerability.", - "items": { - "type": "string" - }, - "type": "array" - }, - "remediation": { - "description": "Optional. The human readable remediation recommendation. This can be basic HTML formatted text.", - "type": "string" - }, - "riskRating": { - "description": "Optional. Risk rating for the vulnerability, for example \"High\".", - "type": "string" - }, - "title": { - "description": "Optional. Human readable name for the vulnerability.", - "type": "string" - } - }, - "type": "object" - }, - "InbandVulnerabilityFindingDetail": { - "description": "This is a temporary detail type that will be used to support vulnerabilities until the engines start using the full vulnerability objects. The \"Inband\" refers to the fact that all vulnerability details are included with every finding.", - "id": "InbandVulnerabilityFindingDetail", - "properties": { - "formattedProofDetails": { - "description": "Optional. A short description of the proof of the vulnerability.", - "type": "string" - }, - "requestUri": { - "description": "Optional. The URI that lead to this detection, if appropriate.", - "type": "string" - }, - "vulnerability": { - "$ref": "InbandVulnerability", - "description": "Required. Vulnerability metadata." - } - }, - "type": "object" - }, - "InitialAccessBrokerAlertDetail": { - "description": "Captures the specific details of InitialAccessBroker (IAB) alert.", - "id": "InitialAccessBrokerAlertDetail", - "properties": { - "discoveryDocumentIds": { - "description": "Required. Array of ids to accommodate multiple discovery documents", - "items": { - "type": "string" - }, - "type": "array" - }, - "severity": { - "description": "Required. IAB specific severity", - "type": "string" - } - }, - "type": "object" - }, - "InitialAccessBrokerConfig": { - "description": "InitialAccessBrokerConfig is specific to Initial Access Broker (IAB) matching scenarios.", - "id": "InitialAccessBrokerConfig", - "properties": { - "entityProfile": { - "$ref": "EntityProfile", - "description": "Represents the comprehensive profile of the customer entity used for matching." - } - }, - "type": "object" - }, - "InitialAccessBrokerFindingDetail": { - "description": "A detail object for an Initial Access Broker (IAB) finding.", - "id": "InitialAccessBrokerFindingDetail", - "properties": { - "documentId": { - "description": "Required. The unique identifier of the document that triggered the IAB finding. This ID can be used to retrieve the content of the document for further analysis.", - "type": "string" - }, - "matchScore": { - "description": "Required. Reference to the match score of the IAB finding. This is a float value between 0 and 1 calculated by the matching engine based on the similarity of the document and the user provided configurations.", + "matchScore": { + "description": "Required. Reference to the match score of the IAB finding. This is a float value between 0 and 1 calculated by the matching engine based on the similarity of the document and the user provided configurations.", "format": "float", "type": "number" }, @@ -2542,66 +2030,6 @@ "properties": {}, "type": "object" }, - "MisconfigurationFindingDetail": { - "description": "Misconfiguration finding detail.", - "id": "MisconfigurationFindingDetail", - "properties": { - "misconfigurationMetadata": { - "$ref": "MisconfigurationMetadata", - "description": "Required. The misconfiguration metadata." - } - }, - "type": "object" - }, - "MisconfigurationMetadata": { - "description": "Misconfiguration metadata.", - "id": "MisconfigurationMetadata", - "properties": { - "description": { - "description": "Optional. Description of the misconfiguration.", - "type": "string" - }, - "displayName": { - "description": "Optional. A user-friendly name for the misconfiguration.", - "type": "string" - }, - "misconfigurationId": { - "description": "Required. The identifier for the misconfiguration. This is an internal name generated by the finding provider.", - "type": "string" - }, - "references": { - "description": "Optional. References to external resources that provide more information about the misconfiguration.", - "items": { - "$ref": "MisconfigurationReference" - }, - "type": "array" - }, - "remediation": { - "description": "Optional. Recommended remediation steps for the misconfiguration.", - "type": "string" - }, - "vulnerableUri": { - "description": "Optional. The endpoint which was found to have the vulnerability.", - "type": "string" - } - }, - "type": "object" - }, - "MisconfigurationReference": { - "description": "A reference to an external resource that provides more information about a misconfiguration.", - "id": "MisconfigurationReference", - "properties": { - "type": { - "description": "Required. The type of the reference (e.g., \"description\", \"remediation\").", - "type": "string" - }, - "uri": { - "description": "Required. The URI of the reference.", - "type": "string" - } - }, - "type": "object" - }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -2682,40 +2110,6 @@ }, "type": "object" }, - "RefreshAlertUriStatusRequest": { - "description": "Request message for FetchAlertUriStatus.", - "id": "RefreshAlertUriStatusRequest", - "properties": {}, - "type": "object" - }, - "RefreshAlertUriStatusResponse": { - "description": "Response message for FetchAlertUriStatus.", - "id": "RefreshAlertUriStatusResponse", - "properties": { - "state": { - "description": "Output only. Status of the alert in WebRisk.", - "enum": [ - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_UNSPECIFIED", - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_NOT_SUBMITTED", - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_SUBMITTED", - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_PROCESSING", - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_ADDED", - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_REJECTED" - ], - "enumDescriptions": [ - "Unspecified status.", - "Issue has not been submitted to WebRisk.", - "Issue has been submitted to WebRisk.", - "Issue has been submitted to WebRisk and is being processed.", - "Issue has been processed by WebRisk and the domain was added to the blocklist.", - "Issue has been processed by WebRisk and was rejected." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, "RelevanceAnalysis": { "description": "Structured relevance analysis for a threat.", "id": "RelevanceAnalysis", @@ -2767,40 +2161,6 @@ }, "type": "object" }, - "ReportAlertUriRequest": { - "description": "Request message for ReportAlertUri.", - "id": "ReportAlertUriRequest", - "properties": {}, - "type": "object" - }, - "ReportAlertUriResponse": { - "description": "Response message for ReportAlertUri.", - "id": "ReportAlertUriResponse", - "properties": { - "state": { - "description": "Output only. Status of the alert in WebRisk.", - "enum": [ - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_UNSPECIFIED", - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_NOT_SUBMITTED", - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_SUBMITTED", - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_PROCESSING", - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_ADDED", - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_REJECTED" - ], - "enumDescriptions": [ - "Unspecified status.", - "Issue has not been submitted to WebRisk.", - "Issue has been submitted to WebRisk.", - "Issue has been submitted to WebRisk and is being processed.", - "Issue has been processed by WebRisk and the domain was added to the blocklist.", - "Issue has been processed by WebRisk and was rejected." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, "SearchFindingsResponse": { "description": "Response message for SearchFindings.", "id": "SearchFindingsResponse", @@ -2889,297 +2249,6 @@ }, "type": "object" }, - "SuspiciousDomainAlertDetail": { - "description": "The alert detail for a suspicious domain finding.", - "id": "SuspiciousDomainAlertDetail", - "properties": { - "dns": { - "$ref": "SuspiciousDomainDnsDetails", - "description": "The DNS details of the suspicious domain." - }, - "domain": { - "description": "Required. The suspicious domain name.", - "type": "string" - }, - "gtiDetails": { - "$ref": "SuspiciousDomainGtiDetails", - "description": "The GTI details of the suspicious domain." - }, - "webRiskOperation": { - "description": "Output only. Name of Web Risk submission operation.", - "readOnly": true, - "type": "string" - }, - "webRiskState": { - "description": "Output only. Status of the Web Risk submission.", - "enum": [ - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_UNSPECIFIED", - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_NOT_SUBMITTED", - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_SUBMITTED", - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_PROCESSING", - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_ADDED", - "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_REJECTED" - ], - "enumDescriptions": [ - "Unspecified status.", - "Issue has not been submitted to WebRisk.", - "Issue has been submitted to WebRisk.", - "Issue has been submitted to WebRisk and is being processed.", - "Issue has been processed by WebRisk and the domain was added to the blocklist.", - "Issue has been processed by WebRisk and was rejected." - ], - "readOnly": true, - "type": "string" - }, - "whois": { - "$ref": "SuspiciousDomainWhoIsDetails", - "description": "The whois details of the suspicious domain." - } - }, - "type": "object" - }, - "SuspiciousDomainDnsDetails": { - "description": "The DNS details of the suspicious domain.", - "id": "SuspiciousDomainDnsDetails", - "properties": { - "dnsRecords": { - "description": "The DNS records of the suspicious domain.", - "items": { - "$ref": "SuspiciousDomainDnsRecord" - }, - "type": "array" - }, - "retrievalTime": { - "description": "The time the DNS details were retrieved.", - "format": "google-datetime", - "type": "string" - } - }, - "type": "object" - }, - "SuspiciousDomainDnsRecord": { - "description": "The DNS record of the suspicious domain.", - "id": "SuspiciousDomainDnsRecord", - "properties": { - "record": { - "description": "The name of the DNS record.", - "type": "string" - }, - "ttl": { - "description": "The TTL of the DNS record.", - "format": "int32", - "type": "integer" - }, - "type": { - "description": "The type of the DNS record.", - "type": "string" - }, - "value": { - "description": "The value of the DNS record.", - "type": "string" - } - }, - "type": "object" - }, - "SuspiciousDomainFindingDetail": { - "description": "A detailed object for a suspicious Domain finding.", - "id": "SuspiciousDomainFindingDetail", - "properties": { - "dns": { - "$ref": "SuspiciousDomainDnsDetails", - "description": "The DNS details of the suspicious domain." - }, - "domain": { - "description": "Required. The suspicious domain name.", - "type": "string" - }, - "gtiDetails": { - "$ref": "SuspiciousDomainGtiDetails", - "description": "The GTI details of the suspicious domain." - }, - "matchScore": { - "description": "Required. Reference to the match score of the finding. This is a float value between 0 and 1 calculated by the matching engine.", - "format": "float", - "type": "number" - }, - "severity": { - "description": "Required. The severity of the finding. This indicates the potential impact of the threat.", - "enum": [ - "SEVERITY_UNSPECIFIED", - "LOW", - "MEDIUM", - "HIGH", - "CRITICAL" - ], - "enumDescriptions": [ - "Default value, should never be set.", - "Low severity.", - "Medium severity.", - "High severity.", - "Critical severity." - ], - "type": "string" - }, - "whois": { - "$ref": "SuspiciousDomainWhoIsDetails", - "description": "The whois details of the suspicious domain." - } - }, - "type": "object" - }, - "SuspiciousDomainGtiDetails": { - "description": "The GTI details of the suspicious domain.", - "id": "SuspiciousDomainGtiDetails", - "properties": { - "threatScore": { - "description": "The threat score of the suspicious domain. The threat score is a number between 0 and 100.", - "format": "int32", - "type": "integer" - }, - "verdict": { - "description": "Output only. The verdict of the suspicious domain.", - "enum": [ - "SUSPICIOUS_DOMAIN_GTI_VERDICT_UNSPECIFIED", - "SUSPICIOUS_DOMAIN_GTI_VERDICT_BENIGN", - "SUSPICIOUS_DOMAIN_GTI_VERDICT_UNDETECTED", - "SUSPICIOUS_DOMAIN_GTI_VERDICT_SUSPICIOUS", - "SUSPICIOUS_DOMAIN_GTI_VERDICT_MALICIOUS", - "SUSPICIOUS_DOMAIN_GTI_VERDICT_UNKNOWN" - ], - "enumDescriptions": [ - "Unspecified verdict.", - "Verdict is clean; the entity is considered harmless.", - "Verdict is undetected; no immediate evidence of malicious intent.", - "Verdict is suspicious; possible malicious activity detected.", - "Verdict is malicious; high confidence that the entity poses a threat.", - "Verdict is not applicable; not able to generate a verdict for this entity." - ], - "readOnly": true, - "type": "string" - }, - "virustotalUri": { - "description": "VirusTotal link for the domain", - "type": "string" - } - }, - "type": "object" - }, - "SuspiciousDomainWhoIsDetails": { - "description": "The whois details of the suspicious domain.", - "id": "SuspiciousDomainWhoIsDetails", - "properties": { - "retrievalTime": { - "description": "The time the whois details were retrieved.", - "format": "google-datetime", - "type": "string" - }, - "whois": { - "description": "The whois details of the suspicious domain.", - "type": "string" - } - }, - "type": "object" - }, - "TargetTechnologyAlertDetail": { - "description": "Contains details for a technology watchlist alert.", - "id": "TargetTechnologyAlertDetail", - "properties": { - "vulnerabilityMatch": { - "$ref": "VulnerabilityMatch", - "description": "Optional. The vulnerability match details." - } - }, - "type": "object" - }, - "TargetTechnologyFindingDetail": { - "description": "Contains details for a technology watchlist finding.", - "id": "TargetTechnologyFindingDetail", - "properties": { - "vulnerabilityMatch": { - "$ref": "VulnerabilityMatch", - "description": "Optional. The vulnerability match details." - } - }, - "type": "object" - }, - "TechnologyWatchListAlertThreshold": { - "description": "TechnologyWatchListAlertThreshold contains the thresholds for alerting.", - "id": "TechnologyWatchListAlertThreshold", - "properties": { - "cvssScoreMinimum": { - "description": "Optional. The minimum cvss V3 score for the alert. Ex: 7.0. Valid range is [0.0, 10.0].", - "format": "float", - "type": "number" - }, - "epssScoreMinimum": { - "description": "Optional. The minimum epss score for the alert. Ex: 0.8. Valid range is [0.0, 1.0].", - "format": "float", - "type": "number" - }, - "exploitationStates": { - "description": "Optional. The exploitation states of the alert.", - "items": { - "enum": [ - "EXPLOITATION_STATE_UNSPECIFIED", - "EXPLOITATION_STATE_NO_KNOWN", - "EXPLOITATION_STATE_REPORTED", - "EXPLOITATION_STATE_SUSPECTED", - "EXPLOITATION_STATE_CONFIRMED", - "EXPLOITATION_STATE_WIDESPREAD" - ], - "enumDescriptions": [ - "Unspecified exploitation state.", - "No known exploitation.", - "Exploitation has been reported.", - "Exploitation is suspected.", - "Exploitation is confirmed.", - "Widespread exploitation." - ], - "type": "string" - }, - "type": "array" - }, - "priorityMinimum": { - "description": "Optional. The minimum priority for the alert.", - "enum": [ - "PRIORITY_UNSPECIFIED", - "P0", - "P1", - "P2", - "P3", - "P4" - ], - "enumDescriptions": [ - "Unspecified priority.", - "Priority level 0.", - "Priority level 1.", - "Priority level 2.", - "Priority level 3.", - "Priority level 4." - ], - "type": "string" - } - }, - "type": "object" - }, - "TechnologyWatchListConfig": { - "description": "TechnologyWatchListConfig is the configuration for the technology watchlist.", - "id": "TechnologyWatchListConfig", - "properties": { - "alertThreshold": { - "$ref": "TechnologyWatchListAlertThreshold", - "description": "Optional. Alert thresholds to effectively reduce noise." - }, - "technologies": { - "description": "Optional. List of vendor, technology or cpe fingerprint. example: Microsoft office 360 Apache Server 3.5 cpe:2.3:a:microsoft:outlook:*:*:*:*:*:*:*:*", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "UpsertConfigurationResponse": { "description": "Response message for UpsertConfiguration.", "id": "UpsertConfigurationResponse", @@ -3191,84 +2260,6 @@ } }, "type": "object" - }, - "VulnerabilityMatch": { - "description": "Contains details about a vulnerability match.", - "id": "VulnerabilityMatch", - "properties": { - "associations": { - "description": "Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting.", - "items": { - "$ref": "Association" - }, - "type": "array" - }, - "collectionId": { - "description": "Required. The collection ID of the vulnerability. Ex: \"vulnerability--cve-2025-9876\".", - "type": "string" - }, - "cveId": { - "description": "Required. The CVE ID of the vulnerability. Ex: \"CVE-2025-9876\". See https://www.cve.org/ for more information.", - "type": "string" - }, - "cvss3Score": { - "description": "Required. The CVSS v3 score of the vulnerability. Example: 6.4.", - "format": "float", - "type": "number" - }, - "description": { - "description": "Required. A description of the vulnerability.", - "type": "string" - }, - "exploitationState": { - "description": "Required. The exploitation state of the vulnerability.", - "enum": [ - "EXPLOITATION_STATE_UNSPECIFIED", - "EXPLOITATION_STATE_NO_KNOWN", - "EXPLOITATION_STATE_REPORTED", - "EXPLOITATION_STATE_SUSPECTED", - "EXPLOITATION_STATE_CONFIRMED", - "EXPLOITATION_STATE_WIDESPREAD" - ], - "enumDescriptions": [ - "Unspecified exploitation state.", - "No known exploitation.", - "Exploitation has been reported.", - "Exploitation is suspected.", - "Exploitation is confirmed.", - "Widespread exploitation." - ], - "type": "string" - }, - "riskRating": { - "description": "Required. The risk rating of the vulnerability.", - "enum": [ - "RISK_RATING_UNSPECIFIED", - "LOW", - "MEDIUM", - "HIGH", - "CRITICAL", - "UNRATED" - ], - "enumDescriptions": [ - "Unspecified risk rating. This is the default value when the risk rating is not set.", - "Low risk rating.", - "Medium risk rating.", - "High risk rating.", - "Critical risk rating.", - "The vulnerability has been assessed, but a specific risk rating could not be determined or assigned." - ], - "type": "string" - }, - "technologies": { - "description": "Required. The affected technologies. Ex: \"Apache Struts\".", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" } }, "servicePath": "", diff --git a/threatintelligence/v1beta/threatintelligence-gen.go b/threatintelligence/v1beta/threatintelligence-gen.go index 73ca3cc052..01f5edc72b 100644 --- a/threatintelligence/v1beta/threatintelligence-gen.go +++ b/threatintelligence/v1beta/threatintelligence-gen.go @@ -223,38 +223,12 @@ type ProjectsFindingsService struct { s *Service } -// AffectedSoftware: The software that is affected by the vulnerability. -type AffectedSoftware struct { - // Product: Optional. The product of the software. - Product string `json:"product,omitempty"` - // Vendor: Optional. The vendor of the software. - Vendor string `json:"vendor,omitempty"` - // ForceSendFields is a list of field names (e.g. "Product") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Product") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s AffectedSoftware) MarshalJSON() ([]byte, error) { - type NoMethod AffectedSoftware - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Alert: Stateful object representing a group of Findings. Key feature to an // Alert is that it expresses the user's intent towards the findings of that // group, even those that haven't occurred yet. type Alert struct { // AiSummary: Optional. AI summary of the finding. AiSummary string `json:"aiSummary,omitempty"` - // Assets: Output only. Assets that are impacted by this alert. - Assets []string `json:"assets,omitempty"` // Audit: Output only. Audit information for the alert. Audit *Audit `json:"audit,omitempty"` // Configurations: Output only. The resource names of the Configurations bound @@ -342,10 +316,6 @@ type AlertDetail struct { InitialAccessBroker *InitialAccessBrokerAlertDetail `json:"initialAccessBroker,omitempty"` // InsiderThreat: Insider Threat alert detail type. InsiderThreat *InsiderThreatAlertDetail `json:"insiderThreat,omitempty"` - // SuspiciousDomain: Domain Monitoring alert detail type. - SuspiciousDomain *SuspiciousDomainAlertDetail `json:"suspiciousDomain,omitempty"` - // TargetTechnology: Technology Watchlist alert detail type. - TargetTechnology *TargetTechnologyAlertDetail `json:"targetTechnology,omitempty"` // ForceSendFields is a list of field names (e.g. "DataLeak") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -440,129 +410,6 @@ func (s AlertDocumentTranslation) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// AssetDiscoveryConfig: Customer defined Configuration for asset discovery. -type AssetDiscoveryConfig struct { - // LastScanCompleteTime: Output only. Timestamp of the last scan completed. - // This field is set by the system and cannot be modified by the user. - LastScanCompleteTime string `json:"lastScanCompleteTime,omitempty"` - // LastScanStartTime: Output only. Timestamp of the last scan started - used - // for scheduling the next scan. This field is set by the system and cannot be - // modified by the user. - LastScanStartTime string `json:"lastScanStartTime,omitempty"` - // ScanFrequency: Required. Frequency at which the scheduled discovery scan - // should be run. If not specified, the default frequency is DAILY. - // - // Possible values: - // "ASSET_DISCOVERY_SCAN_FREQUENCY_UNSPECIFIED" - Default value, should never - // be set. - // "ON_DEMAND" - Scan is triggered on demand. - // "WEEKLY" - Scan is triggered weekly. - // "DAILY" - Scan is triggered daily. - // "MONTHLY" - Scan is triggered monthly. - ScanFrequency string `json:"scanFrequency,omitempty"` - // ScopeExclusionAssets: Optional. Seed assets that are out of scope for the - // scheduled discovery scan. - ScopeExclusionAssets []*AssetDiscoverySeed `json:"scopeExclusionAssets,omitempty"` - // SeedAssets: Required. Seed assets for the scheduled discovery scan. At least - // one seed asset is required. - SeedAssets []*AssetDiscoverySeed `json:"seedAssets,omitempty"` - // Workflow: Required. Workflow to be used for the scheduled discovery scan. If - // not specified, the default workflow is EXTERNAL_DISCOVERY. - // - // Possible values: - // "ASSET_DISCOVERY_WORKFLOW_UNSPECIFIED" - Default value, should never be - // set. - // "EXTERNAL_DISCOVERY" - Discovery workflow that only discovers external - // facing assets. - // "EXTERNAL_DISCOVERY_AND_ASSESSMENT" - Discovery workflow that discovers - // external facing assets and generates relevant alerts on them. - // "MOBILE_APP_DISCOVERY" - Discovery workflow that discovers mobile app - // assets. - Workflow string `json:"workflow,omitempty"` - // ForceSendFields is a list of field names (e.g. "LastScanCompleteTime") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "LastScanCompleteTime") to include - // in API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s AssetDiscoveryConfig) MarshalJSON() ([]byte, error) { - type NoMethod AssetDiscoveryConfig - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// AssetDiscoverySeed: Seed assets for asset discovery. -type AssetDiscoverySeed struct { - // SeedType: Required. Type of the seed asset. - // - // Possible values: - // "ASSET_DISCOVERY_SEED_TYPE_UNSPECIFIED" - Default value, should never be - // set. - // "IP_ADDRESS" - Seed asset is an IP address. - // "NETWORK_SERVICE" - Seed asset is a network service. - SeedType string `json:"seedType,omitempty"` - // SeedValue: Required. Value for the seed asset. Could be an IP address, - // network service, email addresses, etc. - SeedValue string `json:"seedValue,omitempty"` - // ForceSendFields is a list of field names (e.g. "SeedType") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "SeedType") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s AssetDiscoverySeed) MarshalJSON() ([]byte, error) { - type NoMethod AssetDiscoverySeed - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// Association: Represents an association with a vulnerability. -type Association struct { - // Id: Required. The ID of the association. - Id string `json:"id,omitempty"` - // Type: Required. The type of the association. - // - // Possible values: - // "THREAT_INTEL_OBJECT_TYPE_UNSPECIFIED" - Unspecified object type. - // "THREAT_INTEL_OBJECT_TYPE_THREAT_ACTOR" - Threat actor object type. - // "THREAT_INTEL_OBJECT_TYPE_MALWARE" - Malware object type. - // "THREAT_INTEL_OBJECT_TYPE_REPORT" - Report object type. - // "THREAT_INTEL_OBJECT_TYPE_CAMPAIGN" - Campaign object type. - // "THREAT_INTEL_OBJECT_TYPE_IOC_COLLECTION" - IoC Collection object type. - // "THREAT_INTEL_OBJECT_TYPE_SOFTWARE_AND_TOOLKITS" - Software and toolkits - // object type. - // "THREAT_INTEL_OBJECT_TYPE_VULNERABILITY" - Vulnerability object type. - Type string `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Id") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Id") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s Association) MarshalJSON() ([]byte, error) { - type NoMethod Association - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Audit: Tracks basic CRUD facts. type Audit struct { // CreateTime: Output only. Time of creation. @@ -593,83 +440,6 @@ func (s Audit) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// CompromisedCredentialsFindingDetail: Sample compromised credential detail. -type CompromisedCredentialsFindingDetail struct { - // Author: Optional. Reference to the author this detail was extracted from. - // This is deprecated and will be removed. - Author string `json:"author,omitempty"` - // CredentialService: Optional. Claimed site the credential is intended for. - CredentialService string `json:"credentialService,omitempty"` - // DarkWebDoc: Optional. Reference to the dark web document. This is deprecated - // and will be removed. - DarkWebDoc string `json:"darkWebDoc,omitempty"` - // ExternalReferenceUri: Optional. This will contain a link to the external - // reference for this credential. If set, this is a link back to the DTM - // product to allow customers to get additional context about this finding. - ExternalReferenceUri string `json:"externalReferenceUri,omitempty"` - // FileDump: Optional. If the source of the credential was from a file dump - // this will contain the name of the file the credential was found in. This can - // be used by customers for context on where the credential was found and to - // try to find other references to the file in the wild. - FileDump string `json:"fileDump,omitempty"` - // FileDumpHashes: Optional. A list of hashes of the file dump. These will be - // prefixed with the algorithm. Example: "sha256:" - FileDumpHashes []string `json:"fileDumpHashes,omitempty"` - // FileDumpSizeBytes: Optional. If file_dump is set this will contain the size - // of the dump file in bytes. File dumps can be very large. - FileDumpSizeBytes int64 `json:"fileDumpSizeBytes,omitempty,string"` - // Forum: Optional. Reference to the forum this detail was extracted from. This - // is deprecated and will be removed. - Forum string `json:"forum,omitempty"` - // MalwareFamily: Optional. This will indicate the malware family that leaked - // this credential, if known. - MalwareFamily string `json:"malwareFamily,omitempty"` - // PostedTime: Optional. This indicates our best guess as to when the - // credential was leaked to the particular venue that triggered this finding. - // This is not necessarily the time the credential was actually leaked and it - // may not always be be accurate. - PostedTime string `json:"postedTime,omitempty"` - // SourceUri: Optional. If the source of a credential is publicly addressable - // this will contain a uri to the where the credential was found. - SourceUri string `json:"sourceUri,omitempty"` - // UserKey: Required. This field will always be set and will be used to - // identify the user named in the credential leak. In cases where customers are - // authorized to see the actual user key this will be set to the actual user - // key. In cases where the customer is not authorized to see the actual user - // key this will be set to a hash of the user key. The hashed value is an - // intentionally opaque value that is not intended to be used for any other - // purpose than to uniquely identify the user in the context of this specific - // customer, service domain, and user name. Example: "user@example.com" or - // "redacted:". - UserKey string `json:"userKey,omitempty"` - // UserSecretEvidence: Optional. Claimed evidence of the password/secret. This - // will always be hashed. In the event where the plaintext password is known it - // will be set to "redacted:" where the same hash will be presented when the - // same password is found for the same organization for the same service. - // Redaction is done by hashing the password with a salt that is unique to the - // customer organization and service. In the event where the plaintext password - // is not known it will be set to ":" where the algorithm is the hash algorithm - // used and the hash is the hash of the password using that algorithm. In the - // event we don't know the exact algorithm used we will set it to "hashed:". - UserSecretEvidence string `json:"userSecretEvidence,omitempty"` - // ForceSendFields is a list of field names (e.g. "Author") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Author") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s CompromisedCredentialsFindingDetail) MarshalJSON() ([]byte, error) { - type NoMethod CompromisedCredentialsFindingDetail - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Configuration: A configuration represents a behavior an engine should follow // when producing new findings. type Configuration struct { @@ -682,7 +452,7 @@ type Configuration struct { // DisplayName: Output only. Human readable name for the configuration. DisplayName string `json:"displayName,omitempty"` // Name: Identifier. Server generated name for the configuration. format is - // vaults/{vault}/configurations/{configuration} + // projects/{project}/configurations/{configuration} Name string `json:"name,omitempty"` // Provider: Required. Name of the service that provides the configuration. Provider string `json:"provider,omitempty"` @@ -723,26 +493,18 @@ func (s Configuration) MarshalJSON() ([]byte, error) { // ConfigurationDetail: Wrapper class that contains the union struct for all // the various configuration detail specific classes. type ConfigurationDetail struct { - // AssetDiscovery: Asset Discovery detail config. - AssetDiscovery *AssetDiscoveryConfig `json:"assetDiscovery,omitempty"` // CustomerProfile: Customer Profile detail config. CustomerProfile *CustomerProfileConfig `json:"customerProfile,omitempty"` // DetailType: Output only. Name of the detail type. Will be set by the server // during creation to the name of the field that is set in the detail union. DetailType string `json:"detailType,omitempty"` - // DomainMonitoring: Domain Monitoring detail config. - DomainMonitoring *DomainMonitoringConfig `json:"domainMonitoring,omitempty"` - // InitialAccessBroker: Initial Access Broker (IAB) detail config. - InitialAccessBroker *InitialAccessBrokerConfig `json:"initialAccessBroker,omitempty"` - // TechnologyWatchlist: Technology Watchlist detail config. - TechnologyWatchlist *TechnologyWatchListConfig `json:"technologyWatchlist,omitempty"` - // ForceSendFields is a list of field names (e.g. "AssetDiscovery") to + // ForceSendFields is a list of field names (e.g. "CustomerProfile") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AssetDiscovery") to include in + // NullFields is a list of field names (e.g. "CustomerProfile") to include in // API requests with the JSON null value. By default, fields with empty values // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. @@ -760,7 +522,7 @@ type ConfigurationRevision struct { // CreateTime: Output only. The time the Revision was created CreateTime string `json:"createTime,omitempty"` // Name: Identifier. The name of the ConfigurationRevision Format: - // vaults//configurations//revisions/ OR projects//configurations//revisions/ + // projects//configurations//revisions/ Name string `json:"name,omitempty"` // Snapshot: The snapshot of the configuration Snapshot *Configuration `json:"snapshot,omitempty"` @@ -1223,115 +985,6 @@ func (s *DataLeakFindingDetail) UnmarshalJSON(data []byte) error { return nil } -// DomainMonitoringConfig: Any account-level configuration options will go -// here. -type DomainMonitoringConfig struct { - // Domains: The domains to use as "seeds" for Suspicious Domain Monitoring. - Domains []*DomainMonitoringDomain `json:"domains,omitempty"` - // ForceSendFields is a list of field names (e.g. "Domains") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Domains") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s DomainMonitoringConfig) MarshalJSON() ([]byte, error) { - type NoMethod DomainMonitoringConfig - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// DomainMonitoringDomain: A Domain Monitoring "domain" -type DomainMonitoringDomain struct { - // Domain: The domain name to match against. - Domain string `json:"domain,omitempty"` - // ForceSendFields is a list of field names (e.g. "Domain") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Domain") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s DomainMonitoringDomain) MarshalJSON() ([]byte, error) { - type NoMethod DomainMonitoringDomain - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// EntityProfile: EntityProfile represents the structured profile of a customer -// entity, containing key identifiers and descriptive attributes optimized for -// contextual matching against threat intelligence, particularly Initial Access -// Broker (IAB) offerings. -type EntityProfile struct { - // Countries: Optional. List of specific countries of operation. Purpose: - // Essential for matching geographically targeted threats (e.g., actor - // specifies victims in 'DE'). Use ISO 3166-1 alpha-2 codes (e.g., "US", "GB", - // "JP", "DE"). - Countries []string `json:"countries,omitempty"` - // Domains: Required. List of primary internet domain names associated with the - // entity. Purpose: Crucial for explicit matching against domains mentioned in - // threat intel and can inform semantic matching. Must contain at least one - // domain. Example: ["acme.com", "acme.co.uk"] - Domains []string `json:"domains,omitempty"` - // Industries: Optional. List of primary industry sectors the entity operates - // within. Purpose: Crucial for matching industry-specific threats and - // understanding attacker motivation. Use standardized GTI Industry - // Classification values. Example: ["Technology", "Financial Services", - // "Healthcare"] - Industries []string `json:"industries,omitempty"` - // Name: Required. Canonical name of the entity (e.g., the legal company name). - // Purpose: Primary identifier for the customer. - Name string `json:"name,omitempty"` - // OperationalAreas: Optional. Specific geographic areas of *significant* - // operational concentration or strategic importance below the country level, - // if clearly identifiable and relevant. Purpose: Useful for highly localized - // threats, less commonly populated than `countries`. Example: ["Silicon - // Valley", "Frankfurt am Main Metropolitan Region"] - OperationalAreas []string `json:"operationalAreas,omitempty"` - // ProfileSummary: Required. A concise, machine-generated (e.g., LLM) or - // human-curated summary of the entity. Purpose: Captures the semantic essence - // for embedding generation and similarity matching. Should synthesize key - // aspects like core business, scale, and market. Example: "Acme Corporation is - // a large, US-based multinational conglomerate operating..." - ProfileSummary string `json:"profileSummary,omitempty"` - // Regions: Optional. List of primary geopolitical regions where the entity has - // significant operations. Purpose: Filters geographically relevant threats. - // Use standardized names or codes where possible (e.g., "North America", - // "EMEA", "APAC", UN M49 codes). - Regions []string `json:"regions,omitempty"` - // SubIndustries: Optional. List of more granular sub-industries, if applicable - // and known. Purpose: Provides finer-grained context for more specific threat - // matching. Should align with GTI classifications if possible. Example: - // ["Semiconductors", "Cloud Computing Services", "Investment Banking"] - SubIndustries []string `json:"subIndustries,omitempty"` - // ForceSendFields is a list of field names (e.g. "Countries") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Countries") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s EntityProfile) MarshalJSON() ([]byte, error) { - type NoMethod EntityProfile - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // EnumerateAlertFacetsResponse: Response message for EnumerateAlertFacets. type EnumerateAlertFacetsResponse struct { // Facets: List of facets and the counts. @@ -1455,9 +1108,6 @@ type Finding struct { AiSummary string `json:"aiSummary,omitempty"` // Alert: Optional. Name of the alert that this finding is bound to. Alert string `json:"alert,omitempty"` - // Asset: Optional. Optional - asset name if known. Format: - // vaults/{vault}/assets/{asset} - Asset string `json:"asset,omitempty"` // Audit: Output only. Audit data about the finding. Audit *Audit `json:"audit,omitempty"` // Configurations: Optional. Configuration names that are bound to this @@ -1468,11 +1118,8 @@ type Finding struct { // DisplayName: Required. A short descriptive title for the finding <= 250 // chars. EX: "Actor 'baddy' offering $1000 for credentials of 'goodguy'". DisplayName string `json:"displayName,omitempty"` - // Issue: Optional. Optional - name of the issue that this finding is bound to. - // Format: vaults/{vault}/issues/{issue} - Issue string `json:"issue,omitempty"` // Name: Identifier. Server generated name for the finding (leave clear during - // creation). Format: vaults/{vault}/findings/{finding} + // creation). Format: projects/{project}/findings/{finding} Name string `json:"name,omitempty"` // Provider: Required. Logical source of this finding (name of the sub-engine). Provider string `json:"provider,omitempty"` @@ -1526,34 +1173,24 @@ func (s *Finding) UnmarshalJSON(data []byte) error { // FindingDetail: Wrapper class that contains the union struct for all the // various findings detail specific classes. type FindingDetail struct { - // CompromisedCredentials: Compromised Credentials detail type. - CompromisedCredentials *CompromisedCredentialsFindingDetail `json:"compromisedCredentials,omitempty"` // DataLeak: Data Leak finding detail type. DataLeak *DataLeakFindingDetail `json:"dataLeak,omitempty"` // DetailType: Output only. Name of the detail type. Will be set by the server // during creation to the name of the field that is set in the detail union. DetailType string `json:"detailType,omitempty"` - // InbandVulnerability: Inband vulnerability detail type. - InbandVulnerability *InbandVulnerabilityFindingDetail `json:"inbandVulnerability,omitempty"` // InitialAccessBroker: Initial Access Broker finding detail type. InitialAccessBroker *InitialAccessBrokerFindingDetail `json:"initialAccessBroker,omitempty"` // InsiderThreat: Insider Threat finding detail type. InsiderThreat *InsiderThreatFindingDetail `json:"insiderThreat,omitempty"` - // Misconfiguration: Misconfiguration finding detail type. - Misconfiguration *MisconfigurationFindingDetail `json:"misconfiguration,omitempty"` - // SuspiciousDomain: Domain Monitoring finding detail type. - SuspiciousDomain *SuspiciousDomainFindingDetail `json:"suspiciousDomain,omitempty"` - // TargetTechnology: Technology Watchlist finding detail type. - TargetTechnology *TargetTechnologyFindingDetail `json:"targetTechnology,omitempty"` - // ForceSendFields is a list of field names (e.g. "CompromisedCredentials") to + // ForceSendFields is a list of field names (e.g. "DataLeak") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CompromisedCredentials") to - // include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See + // NullFields is a list of field names (e.g. "DataLeak") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -1590,107 +1227,6 @@ func (s GenerateOrgProfileConfigurationRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// InbandVulnerability: Fleshed out vulnerability object that includes enough -// details to fill out a vulnerability specific view for an issue. -type InbandVulnerability struct { - // AffectedSoftware: Optional. The software that is affected by the - // vulnerability. - AffectedSoftware []*AffectedSoftware `json:"affectedSoftware,omitempty"` - // Authors: Optional. The authors of the vulnerability detection. - Authors []string `json:"authors,omitempty"` - // CveId: Required. The CVE ID of the vulnerability. - CveId string `json:"cveId,omitempty"` - // CvssV31Score: Required. The CVSS V3.1 score (Base score)for the - // vulnerability. ( ) - CvssV31Score float64 `json:"cvssV31Score,omitempty"` - // CvssV31ScoreTemporal: Optional. Temporal CVSS V3.1 score for the - // vulnerability. - CvssV31ScoreTemporal float64 `json:"cvssV31ScoreTemporal,omitempty"` - // Description: Optional. The human readable description. This can be basic - // HTML formatted text. - Description string `json:"description,omitempty"` - // DisclosureTime: Optional. The date the vulnerability was first disclosed. - DisclosureTime string `json:"disclosureTime,omitempty"` - // ExploitationState: Optional. Exploitation state of the vulnerability, for - // example "Available". - ExploitationState string `json:"exploitationState,omitempty"` - // ExternalVulnerabilityId: Required. The external ID of the vulnerability. - ExternalVulnerabilityId string `json:"externalVulnerabilityId,omitempty"` - // IsExploitedWild: Optional. Whether this is exploited in the wild. - IsExploitedWild bool `json:"isExploitedWild,omitempty"` - // ReferenceUrls: Optional. Reference URLs to the vulnerability. - ReferenceUrls []string `json:"referenceUrls,omitempty"` - // Remediation: Optional. The human readable remediation recommendation. This - // can be basic HTML formatted text. - Remediation string `json:"remediation,omitempty"` - // RiskRating: Optional. Risk rating for the vulnerability, for example "High". - RiskRating string `json:"riskRating,omitempty"` - // Title: Optional. Human readable name for the vulnerability. - Title string `json:"title,omitempty"` - // ForceSendFields is a list of field names (e.g. "AffectedSoftware") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AffectedSoftware") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s InbandVulnerability) MarshalJSON() ([]byte, error) { - type NoMethod InbandVulnerability - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -func (s *InbandVulnerability) UnmarshalJSON(data []byte) error { - type NoMethod InbandVulnerability - var s1 struct { - CvssV31Score gensupport.JSONFloat64 `json:"cvssV31Score"` - CvssV31ScoreTemporal gensupport.JSONFloat64 `json:"cvssV31ScoreTemporal"` - *NoMethod - } - s1.NoMethod = (*NoMethod)(s) - if err := json.Unmarshal(data, &s1); err != nil { - return err - } - s.CvssV31Score = float64(s1.CvssV31Score) - s.CvssV31ScoreTemporal = float64(s1.CvssV31ScoreTemporal) - return nil -} - -// InbandVulnerabilityFindingDetail: This is a temporary detail type that will -// be used to support vulnerabilities until the engines start using the full -// vulnerability objects. The "Inband" refers to the fact that all -// vulnerability details are included with every finding. -type InbandVulnerabilityFindingDetail struct { - // FormattedProofDetails: Optional. A short description of the proof of the - // vulnerability. - FormattedProofDetails string `json:"formattedProofDetails,omitempty"` - // RequestUri: Optional. The URI that lead to this detection, if appropriate. - RequestUri string `json:"requestUri,omitempty"` - // Vulnerability: Required. Vulnerability metadata. - Vulnerability *InbandVulnerability `json:"vulnerability,omitempty"` - // ForceSendFields is a list of field names (e.g. "FormattedProofDetails") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "FormattedProofDetails") to - // include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s InbandVulnerabilityFindingDetail) MarshalJSON() ([]byte, error) { - type NoMethod InbandVulnerabilityFindingDetail - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // InitialAccessBrokerAlertDetail: Captures the specific details of // InitialAccessBroker (IAB) alert. type InitialAccessBrokerAlertDetail struct { @@ -1717,30 +1253,6 @@ func (s InitialAccessBrokerAlertDetail) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// InitialAccessBrokerConfig: InitialAccessBrokerConfig is specific to Initial -// Access Broker (IAB) matching scenarios. -type InitialAccessBrokerConfig struct { - // EntityProfile: Represents the comprehensive profile of the customer entity - // used for matching. - EntityProfile *EntityProfile `json:"entityProfile,omitempty"` - // ForceSendFields is a list of field names (e.g. "EntityProfile") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "EntityProfile") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s InitialAccessBrokerConfig) MarshalJSON() ([]byte, error) { - type NoMethod InitialAccessBrokerConfig - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // InitialAccessBrokerFindingDetail: A detail object for an Initial Access // Broker (IAB) finding. type InitialAccessBrokerFindingDetail struct { @@ -2044,90 +1556,6 @@ type MarkAlertAsTrackedExternallyRequest struct { type MarkAlertAsTriagedRequest struct { } -// MisconfigurationFindingDetail: Misconfiguration finding detail. -type MisconfigurationFindingDetail struct { - // MisconfigurationMetadata: Required. The misconfiguration metadata. - MisconfigurationMetadata *MisconfigurationMetadata `json:"misconfigurationMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "MisconfigurationMetadata") - // to unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "MisconfigurationMetadata") to - // include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s MisconfigurationFindingDetail) MarshalJSON() ([]byte, error) { - type NoMethod MisconfigurationFindingDetail - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// MisconfigurationMetadata: Misconfiguration metadata. -type MisconfigurationMetadata struct { - // Description: Optional. Description of the misconfiguration. - Description string `json:"description,omitempty"` - // DisplayName: Optional. A user-friendly name for the misconfiguration. - DisplayName string `json:"displayName,omitempty"` - // MisconfigurationId: Required. The identifier for the misconfiguration. This - // is an internal name generated by the finding provider. - MisconfigurationId string `json:"misconfigurationId,omitempty"` - // References: Optional. References to external resources that provide more - // information about the misconfiguration. - References []*MisconfigurationReference `json:"references,omitempty"` - // Remediation: Optional. Recommended remediation steps for the - // misconfiguration. - Remediation string `json:"remediation,omitempty"` - // VulnerableUri: Optional. The endpoint which was found to have the - // vulnerability. - VulnerableUri string `json:"vulnerableUri,omitempty"` - // ForceSendFields is a list of field names (e.g. "Description") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Description") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s MisconfigurationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod MisconfigurationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// MisconfigurationReference: A reference to an external resource that provides -// more information about a misconfiguration. -type MisconfigurationReference struct { - // Type: Required. The type of the reference (e.g., "description", - // "remediation"). - Type string `json:"type,omitempty"` - // Uri: Required. The URI of the reference. - Uri string `json:"uri,omitempty"` - // ForceSendFields is a list of field names (e.g. "Type") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Type") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s MisconfigurationReference) MarshalJSON() ([]byte, error) { - type NoMethod MisconfigurationReference - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Operation: This resource represents a long-running operation that is the // result of a network API call. type Operation struct { @@ -2216,48 +1644,6 @@ func (s PriorityAnalysis) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// RefreshAlertUriStatusRequest: Request message for FetchAlertUriStatus. -type RefreshAlertUriStatusRequest struct { -} - -// RefreshAlertUriStatusResponse: Response message for FetchAlertUriStatus. -type RefreshAlertUriStatusResponse struct { - // State: Output only. Status of the alert in WebRisk. - // - // Possible values: - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_UNSPECIFIED" - Unspecified status. - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_NOT_SUBMITTED" - Issue has not been - // submitted to WebRisk. - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_SUBMITTED" - Issue has been submitted to - // WebRisk. - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_PROCESSING" - Issue has been submitted - // to WebRisk and is being processed. - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_ADDED" - Issue has been processed by - // WebRisk and the domain was added to the blocklist. - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_REJECTED" - Issue has been processed by - // WebRisk and was rejected. - State string `json:"state,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "State") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "State") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s RefreshAlertUriStatusResponse) MarshalJSON() ([]byte, error) { - type NoMethod RefreshAlertUriStatusResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // RelevanceAnalysis: Structured relevance analysis for a threat. type RelevanceAnalysis struct { // Confidence: The level of confidence in the given verdict. @@ -2303,54 +1689,12 @@ func (s RelevanceAnalysis) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ReportAlertUriRequest: Request message for ReportAlertUri. -type ReportAlertUriRequest struct { -} - -// ReportAlertUriResponse: Response message for ReportAlertUri. -type ReportAlertUriResponse struct { - // State: Output only. Status of the alert in WebRisk. - // - // Possible values: - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_UNSPECIFIED" - Unspecified status. - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_NOT_SUBMITTED" - Issue has not been - // submitted to WebRisk. - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_SUBMITTED" - Issue has been submitted to - // WebRisk. - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_PROCESSING" - Issue has been submitted - // to WebRisk and is being processed. - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_ADDED" - Issue has been processed by - // WebRisk and the domain was added to the blocklist. - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_REJECTED" - Issue has been processed by - // WebRisk and was rejected. - State string `json:"state,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "State") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "State") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ReportAlertUriResponse) MarshalJSON() ([]byte, error) { - type NoMethod ReportAlertUriResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// SearchFindingsResponse: Response message for SearchFindings. -type SearchFindingsResponse struct { - // Findings: List of findings. - Findings []*Finding `json:"findings,omitempty"` - // NextPageToken: Page token. - NextPageToken string `json:"nextPageToken,omitempty"` +// SearchFindingsResponse: Response message for SearchFindings. +type SearchFindingsResponse struct { + // Findings: List of findings. + Findings []*Finding `json:"findings,omitempty"` + // NextPageToken: Page token. + NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -2446,360 +1790,6 @@ func (s Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// SuspiciousDomainAlertDetail: The alert detail for a suspicious domain -// finding. -type SuspiciousDomainAlertDetail struct { - // Dns: The DNS details of the suspicious domain. - Dns *SuspiciousDomainDnsDetails `json:"dns,omitempty"` - // Domain: Required. The suspicious domain name. - Domain string `json:"domain,omitempty"` - // GtiDetails: The GTI details of the suspicious domain. - GtiDetails *SuspiciousDomainGtiDetails `json:"gtiDetails,omitempty"` - // WebRiskOperation: Output only. Name of Web Risk submission operation. - WebRiskOperation string `json:"webRiskOperation,omitempty"` - // WebRiskState: Output only. Status of the Web Risk submission. - // - // Possible values: - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_UNSPECIFIED" - Unspecified status. - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_NOT_SUBMITTED" - Issue has not been - // submitted to WebRisk. - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_SUBMITTED" - Issue has been submitted to - // WebRisk. - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_PROCESSING" - Issue has been submitted - // to WebRisk and is being processed. - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_ADDED" - Issue has been processed by - // WebRisk and the domain was added to the blocklist. - // "SUSPICIOUS_DOMAIN_WEB_RISK_STATE_REJECTED" - Issue has been processed by - // WebRisk and was rejected. - WebRiskState string `json:"webRiskState,omitempty"` - // Whois: The whois details of the suspicious domain. - Whois *SuspiciousDomainWhoIsDetails `json:"whois,omitempty"` - // ForceSendFields is a list of field names (e.g. "Dns") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Dns") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SuspiciousDomainAlertDetail) MarshalJSON() ([]byte, error) { - type NoMethod SuspiciousDomainAlertDetail - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// SuspiciousDomainDnsDetails: The DNS details of the suspicious domain. -type SuspiciousDomainDnsDetails struct { - // DnsRecords: The DNS records of the suspicious domain. - DnsRecords []*SuspiciousDomainDnsRecord `json:"dnsRecords,omitempty"` - // RetrievalTime: The time the DNS details were retrieved. - RetrievalTime string `json:"retrievalTime,omitempty"` - // ForceSendFields is a list of field names (e.g. "DnsRecords") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "DnsRecords") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SuspiciousDomainDnsDetails) MarshalJSON() ([]byte, error) { - type NoMethod SuspiciousDomainDnsDetails - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// SuspiciousDomainDnsRecord: The DNS record of the suspicious domain. -type SuspiciousDomainDnsRecord struct { - // Record: The name of the DNS record. - Record string `json:"record,omitempty"` - // Ttl: The TTL of the DNS record. - Ttl int64 `json:"ttl,omitempty"` - // Type: The type of the DNS record. - Type string `json:"type,omitempty"` - // Value: The value of the DNS record. - Value string `json:"value,omitempty"` - // ForceSendFields is a list of field names (e.g. "Record") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Record") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SuspiciousDomainDnsRecord) MarshalJSON() ([]byte, error) { - type NoMethod SuspiciousDomainDnsRecord - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// SuspiciousDomainFindingDetail: A detailed object for a suspicious Domain -// finding. -type SuspiciousDomainFindingDetail struct { - // Dns: The DNS details of the suspicious domain. - Dns *SuspiciousDomainDnsDetails `json:"dns,omitempty"` - // Domain: Required. The suspicious domain name. - Domain string `json:"domain,omitempty"` - // GtiDetails: The GTI details of the suspicious domain. - GtiDetails *SuspiciousDomainGtiDetails `json:"gtiDetails,omitempty"` - // MatchScore: Required. Reference to the match score of the finding. This is a - // float value between 0 and 1 calculated by the matching engine. - MatchScore float64 `json:"matchScore,omitempty"` - // Severity: Required. The severity of the finding. This indicates the - // potential impact of the threat. - // - // Possible values: - // "SEVERITY_UNSPECIFIED" - Default value, should never be set. - // "LOW" - Low severity. - // "MEDIUM" - Medium severity. - // "HIGH" - High severity. - // "CRITICAL" - Critical severity. - Severity string `json:"severity,omitempty"` - // Whois: The whois details of the suspicious domain. - Whois *SuspiciousDomainWhoIsDetails `json:"whois,omitempty"` - // ForceSendFields is a list of field names (e.g. "Dns") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Dns") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SuspiciousDomainFindingDetail) MarshalJSON() ([]byte, error) { - type NoMethod SuspiciousDomainFindingDetail - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -func (s *SuspiciousDomainFindingDetail) UnmarshalJSON(data []byte) error { - type NoMethod SuspiciousDomainFindingDetail - var s1 struct { - MatchScore gensupport.JSONFloat64 `json:"matchScore"` - *NoMethod - } - s1.NoMethod = (*NoMethod)(s) - if err := json.Unmarshal(data, &s1); err != nil { - return err - } - s.MatchScore = float64(s1.MatchScore) - return nil -} - -// SuspiciousDomainGtiDetails: The GTI details of the suspicious domain. -type SuspiciousDomainGtiDetails struct { - // ThreatScore: The threat score of the suspicious domain. The threat score is - // a number between 0 and 100. - ThreatScore int64 `json:"threatScore,omitempty"` - // Verdict: Output only. The verdict of the suspicious domain. - // - // Possible values: - // "SUSPICIOUS_DOMAIN_GTI_VERDICT_UNSPECIFIED" - Unspecified verdict. - // "SUSPICIOUS_DOMAIN_GTI_VERDICT_BENIGN" - Verdict is clean; the entity is - // considered harmless. - // "SUSPICIOUS_DOMAIN_GTI_VERDICT_UNDETECTED" - Verdict is undetected; no - // immediate evidence of malicious intent. - // "SUSPICIOUS_DOMAIN_GTI_VERDICT_SUSPICIOUS" - Verdict is suspicious; - // possible malicious activity detected. - // "SUSPICIOUS_DOMAIN_GTI_VERDICT_MALICIOUS" - Verdict is malicious; high - // confidence that the entity poses a threat. - // "SUSPICIOUS_DOMAIN_GTI_VERDICT_UNKNOWN" - Verdict is not applicable; not - // able to generate a verdict for this entity. - Verdict string `json:"verdict,omitempty"` - // VirustotalUri: VirusTotal link for the domain - VirustotalUri string `json:"virustotalUri,omitempty"` - // ForceSendFields is a list of field names (e.g. "ThreatScore") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ThreatScore") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SuspiciousDomainGtiDetails) MarshalJSON() ([]byte, error) { - type NoMethod SuspiciousDomainGtiDetails - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// SuspiciousDomainWhoIsDetails: The whois details of the suspicious domain. -type SuspiciousDomainWhoIsDetails struct { - // RetrievalTime: The time the whois details were retrieved. - RetrievalTime string `json:"retrievalTime,omitempty"` - // Whois: The whois details of the suspicious domain. - Whois string `json:"whois,omitempty"` - // ForceSendFields is a list of field names (e.g. "RetrievalTime") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RetrievalTime") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SuspiciousDomainWhoIsDetails) MarshalJSON() ([]byte, error) { - type NoMethod SuspiciousDomainWhoIsDetails - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// TargetTechnologyAlertDetail: Contains details for a technology watchlist -// alert. -type TargetTechnologyAlertDetail struct { - // VulnerabilityMatch: Optional. The vulnerability match details. - VulnerabilityMatch *VulnerabilityMatch `json:"vulnerabilityMatch,omitempty"` - // ForceSendFields is a list of field names (e.g. "VulnerabilityMatch") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "VulnerabilityMatch") to include - // in API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s TargetTechnologyAlertDetail) MarshalJSON() ([]byte, error) { - type NoMethod TargetTechnologyAlertDetail - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// TargetTechnologyFindingDetail: Contains details for a technology watchlist -// finding. -type TargetTechnologyFindingDetail struct { - // VulnerabilityMatch: Optional. The vulnerability match details. - VulnerabilityMatch *VulnerabilityMatch `json:"vulnerabilityMatch,omitempty"` - // ForceSendFields is a list of field names (e.g. "VulnerabilityMatch") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "VulnerabilityMatch") to include - // in API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s TargetTechnologyFindingDetail) MarshalJSON() ([]byte, error) { - type NoMethod TargetTechnologyFindingDetail - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// TechnologyWatchListAlertThreshold: TechnologyWatchListAlertThreshold -// contains the thresholds for alerting. -type TechnologyWatchListAlertThreshold struct { - // CvssScoreMinimum: Optional. The minimum cvss V3 score for the alert. Ex: - // 7.0. Valid range is [0.0, 10.0]. - CvssScoreMinimum float64 `json:"cvssScoreMinimum,omitempty"` - // EpssScoreMinimum: Optional. The minimum epss score for the alert. Ex: 0.8. - // Valid range is [0.0, 1.0]. - EpssScoreMinimum float64 `json:"epssScoreMinimum,omitempty"` - // ExploitationStates: Optional. The exploitation states of the alert. - // - // Possible values: - // "EXPLOITATION_STATE_UNSPECIFIED" - Unspecified exploitation state. - // "EXPLOITATION_STATE_NO_KNOWN" - No known exploitation. - // "EXPLOITATION_STATE_REPORTED" - Exploitation has been reported. - // "EXPLOITATION_STATE_SUSPECTED" - Exploitation is suspected. - // "EXPLOITATION_STATE_CONFIRMED" - Exploitation is confirmed. - // "EXPLOITATION_STATE_WIDESPREAD" - Widespread exploitation. - ExploitationStates []string `json:"exploitationStates,omitempty"` - // PriorityMinimum: Optional. The minimum priority for the alert. - // - // Possible values: - // "PRIORITY_UNSPECIFIED" - Unspecified priority. - // "P0" - Priority level 0. - // "P1" - Priority level 1. - // "P2" - Priority level 2. - // "P3" - Priority level 3. - // "P4" - Priority level 4. - PriorityMinimum string `json:"priorityMinimum,omitempty"` - // ForceSendFields is a list of field names (e.g. "CvssScoreMinimum") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CvssScoreMinimum") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s TechnologyWatchListAlertThreshold) MarshalJSON() ([]byte, error) { - type NoMethod TechnologyWatchListAlertThreshold - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -func (s *TechnologyWatchListAlertThreshold) UnmarshalJSON(data []byte) error { - type NoMethod TechnologyWatchListAlertThreshold - var s1 struct { - CvssScoreMinimum gensupport.JSONFloat64 `json:"cvssScoreMinimum"` - EpssScoreMinimum gensupport.JSONFloat64 `json:"epssScoreMinimum"` - *NoMethod - } - s1.NoMethod = (*NoMethod)(s) - if err := json.Unmarshal(data, &s1); err != nil { - return err - } - s.CvssScoreMinimum = float64(s1.CvssScoreMinimum) - s.EpssScoreMinimum = float64(s1.EpssScoreMinimum) - return nil -} - -// TechnologyWatchListConfig: TechnologyWatchListConfig is the configuration -// for the technology watchlist. -type TechnologyWatchListConfig struct { - // AlertThreshold: Optional. Alert thresholds to effectively reduce noise. - AlertThreshold *TechnologyWatchListAlertThreshold `json:"alertThreshold,omitempty"` - // Technologies: Optional. List of vendor, technology or cpe fingerprint. - // example: Microsoft office 360 Apache Server 3.5 - // cpe:2.3:a:microsoft:outlook:*:*:*:*:*:*:*:* - Technologies []string `json:"technologies,omitempty"` - // ForceSendFields is a list of field names (e.g. "AlertThreshold") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AlertThreshold") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s TechnologyWatchListConfig) MarshalJSON() ([]byte, error) { - type NoMethod TechnologyWatchListConfig - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // UpsertConfigurationResponse: Response message for UpsertConfiguration. type UpsertConfigurationResponse struct { // Configuration: Output only. Created configuration ID with server assigned @@ -2826,78 +1816,6 @@ func (s UpsertConfigurationResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// VulnerabilityMatch: Contains details about a vulnerability match. -type VulnerabilityMatch struct { - // Associations: Optional. Associated threat actors, malware, etc. This is - // embedded as a snapshot because the details of the association at the time of - // the vulnerability match are important for context and reporting. - Associations []*Association `json:"associations,omitempty"` - // CollectionId: Required. The collection ID of the vulnerability. Ex: - // "vulnerability--cve-2025-9876". - CollectionId string `json:"collectionId,omitempty"` - // CveId: Required. The CVE ID of the vulnerability. Ex: "CVE-2025-9876". See - // https://www.cve.org/ for more information. - CveId string `json:"cveId,omitempty"` - // Cvss3Score: Required. The CVSS v3 score of the vulnerability. Example: 6.4. - Cvss3Score float64 `json:"cvss3Score,omitempty"` - // Description: Required. A description of the vulnerability. - Description string `json:"description,omitempty"` - // ExploitationState: Required. The exploitation state of the vulnerability. - // - // Possible values: - // "EXPLOITATION_STATE_UNSPECIFIED" - Unspecified exploitation state. - // "EXPLOITATION_STATE_NO_KNOWN" - No known exploitation. - // "EXPLOITATION_STATE_REPORTED" - Exploitation has been reported. - // "EXPLOITATION_STATE_SUSPECTED" - Exploitation is suspected. - // "EXPLOITATION_STATE_CONFIRMED" - Exploitation is confirmed. - // "EXPLOITATION_STATE_WIDESPREAD" - Widespread exploitation. - ExploitationState string `json:"exploitationState,omitempty"` - // RiskRating: Required. The risk rating of the vulnerability. - // - // Possible values: - // "RISK_RATING_UNSPECIFIED" - Unspecified risk rating. This is the default - // value when the risk rating is not set. - // "LOW" - Low risk rating. - // "MEDIUM" - Medium risk rating. - // "HIGH" - High risk rating. - // "CRITICAL" - Critical risk rating. - // "UNRATED" - The vulnerability has been assessed, but a specific risk - // rating could not be determined or assigned. - RiskRating string `json:"riskRating,omitempty"` - // Technologies: Required. The affected technologies. Ex: "Apache Struts". - Technologies []string `json:"technologies,omitempty"` - // ForceSendFields is a list of field names (e.g. "Associations") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Associations") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s VulnerabilityMatch) MarshalJSON() ([]byte, error) { - type NoMethod VulnerabilityMatch - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -func (s *VulnerabilityMatch) UnmarshalJSON(data []byte) error { - type NoMethod VulnerabilityMatch - var s1 struct { - Cvss3Score gensupport.JSONFloat64 `json:"cvss3Score"` - *NoMethod - } - s1.NoMethod = (*NoMethod)(s) - if err := json.Unmarshal(data, &s1); err != nil { - return err - } - s.Cvss3Score = float64(s1.Cvss3Score) - return nil -} - type ProjectsGenerateOrgProfileCall struct { s *Service name string @@ -4010,214 +2928,6 @@ func (c *ProjectsAlertsReadCall) Do(opts ...googleapi.CallOption) (*Alert, error return ret, nil } -type ProjectsAlertsRefreshUriStatusCall struct { - s *Service - name string - refreshalerturistatusrequest *RefreshAlertUriStatusRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// RefreshUriStatus: Return the status of a URI submitted to Google WebRisk. -// -// - name: Name of alert to refresh status from WebRisk. -func (r *ProjectsAlertsService) RefreshUriStatus(name string, refreshalerturistatusrequest *RefreshAlertUriStatusRequest) *ProjectsAlertsRefreshUriStatusCall { - c := &ProjectsAlertsRefreshUriStatusCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.refreshalerturistatusrequest = refreshalerturistatusrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsAlertsRefreshUriStatusCall) Fields(s ...googleapi.Field) *ProjectsAlertsRefreshUriStatusCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsAlertsRefreshUriStatusCall) Context(ctx context.Context) *ProjectsAlertsRefreshUriStatusCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsAlertsRefreshUriStatusCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsAlertsRefreshUriStatusCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.refreshalerturistatusrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+name}:refreshUriStatus") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "threatintelligence.projects.alerts.refreshUriStatus", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "threatintelligence.projects.alerts.refreshUriStatus" call. -// Any non-2xx status code is an error. Response headers are in either -// *RefreshAlertUriStatusResponse.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *ProjectsAlertsRefreshUriStatusCall) Do(opts ...googleapi.CallOption) (*RefreshAlertUriStatusResponse, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &RefreshAlertUriStatusResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "threatintelligence.projects.alerts.refreshUriStatus", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsAlertsReportAlertUriCall struct { - s *Service - name string - reportalerturirequest *ReportAlertUriRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// ReportAlertUri: Report the URI associated with an alert to Google WebRisk. -// -// - name: Name of alert to submit to WebRisk. -func (r *ProjectsAlertsService) ReportAlertUri(name string, reportalerturirequest *ReportAlertUriRequest) *ProjectsAlertsReportAlertUriCall { - c := &ProjectsAlertsReportAlertUriCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.reportalerturirequest = reportalerturirequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *ProjectsAlertsReportAlertUriCall) Fields(s ...googleapi.Field) *ProjectsAlertsReportAlertUriCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsAlertsReportAlertUriCall) Context(ctx context.Context) *ProjectsAlertsReportAlertUriCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *ProjectsAlertsReportAlertUriCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsAlertsReportAlertUriCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.reportalerturirequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+name}:reportAlertUri") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "threatintelligence.projects.alerts.reportAlertUri", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "threatintelligence.projects.alerts.reportAlertUri" call. -// Any non-2xx status code is an error. Response headers are in either -// *ReportAlertUriResponse.ServerResponse.Header or (if a response was returned -// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ProjectsAlertsReportAlertUriCall) Do(opts ...googleapi.CallOption) (*ReportAlertUriResponse, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &ReportAlertUriResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - b, err := gensupport.DecodeResponseBytes(target, res) - if err != nil { - return nil, err - } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "threatintelligence.projects.alerts.reportAlertUri", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - type ProjectsAlertsResolveCall struct { s *Service name string diff --git a/walletobjects/v1/walletobjects-api.json b/walletobjects/v1/walletobjects-api.json index 61b3a53b5e..e187959213 100644 --- a/walletobjects/v1/walletobjects-api.json +++ b/walletobjects/v1/walletobjects-api.json @@ -2713,7 +2713,7 @@ } } }, - "revision": "20260213", + "revision": "20260220", "rootUrl": "https://walletobjects.googleapis.com/", "schemas": { "ActivationOptions": { @@ -6405,10 +6405,11 @@ "type": "object" }, "JwtResource": { + "description": "A JWT representation of a pass.", "id": "JwtResource", "properties": { "jwt": { - "description": "A string representing a JWT of the format described at https://developers.google.com/wallet/reference/rest/v1/Jwt", + "description": "Required. A string representing a JWT of the format described at https://developers.google.com/wallet/reference/rest/v1/Jwt", "type": "string" } }, diff --git a/walletobjects/v1/walletobjects-gen.go b/walletobjects/v1/walletobjects-gen.go index 7632ac9fae..1b72530c24 100644 --- a/walletobjects/v1/walletobjects-gen.go +++ b/walletobjects/v1/walletobjects-gen.go @@ -4371,8 +4371,9 @@ func (s JwtInsertResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// JwtResource: A JWT representation of a pass. type JwtResource struct { - // Jwt: A string representing a JWT of the format described at + // Jwt: Required. A string representing a JWT of the format described at // https://developers.google.com/wallet/reference/rest/v1/Jwt Jwt string `json:"jwt,omitempty"` // ForceSendFields is a list of field names (e.g. "Jwt") to unconditionally