diff --git a/accessapproval/v1/accessapproval-api.json b/accessapproval/v1/accessapproval-api.json index 41b09ea779d..c5322fb98df 100644 --- a/accessapproval/v1/accessapproval-api.json +++ b/accessapproval/v1/accessapproval-api.json @@ -14,7 +14,7 @@ "canonicalName": "Access Approval", "description": "An API for controlling access to data by Google personnel.", "discoveryVersion": "v1", - "documentationLink": "https://cloud.google.com/cloud-provider-access-management/access-approval/docs", + "documentationLink": "https://cloud.google.com/assured-workloads/access-approval/docs", "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -913,7 +913,7 @@ } } }, - "revision": "20230421", + "revision": "20230505", "rootUrl": "https://accessapproval.googleapis.com/", "schemas": { "AccessApprovalServiceAccount": { @@ -1149,7 +1149,7 @@ "id": "EnrolledService", "properties": { "cloudProduct": { - "description": "The product for which Access Approval will be enrolled. Allowed values are listed below (case-sensitive): * all * GA * App Engine * Artifact Registry * BigQuery * Certificate Authority Service * Cloud Bigtable * Cloud Key Management Service * Compute Engine * Cloud Composer * Cloud Dataflow * Cloud Dataproc * Cloud DLP * Cloud EKM * Cloud Firestore * Cloud HSM * Cloud Identity and Access Management * Cloud Logging * Cloud NAT * Cloud Pub/Sub * Cloud Spanner * Cloud SQL * Cloud Storage * Google Kubernetes Engine * Organization Policy Serivice * Persistent Disk * Resource Manager * Secret Manager * Speaker ID Note: These values are supported as input for legacy purposes, but will not be returned from the API. * all * ga-only * appengine.googleapis.com * artifactregistry.googleapis.com * bigquery.googleapis.com * bigtable.googleapis.com * container.googleapis.com * cloudkms.googleapis.com * cloudresourcemanager.googleapis.com * cloudsql.googleapis.com * compute.googleapis.com * dataflow.googleapis.com * dataproc.googleapis.com * dlp.googleapis.com * iam.googleapis.com * logging.googleapis.com * orgpolicy.googleapis.com * pubsub.googleapis.com * spanner.googleapis.com * secretmanager.googleapis.com * speakerid.googleapis.com * storage.googleapis.com Calls to UpdateAccessApprovalSettings using 'all' or any of the XXX.googleapis.com will be translated to the associated product name ('all', 'App Engine', etc.). Note: 'all' will enroll the resource in all products supported at both 'GA' and 'Preview' levels. More information about levels of support is available at https://cloud.google.com/access-approval/docs/supported-services", + "description": "The product for which Access Approval will be enrolled. Allowed values are listed below (case-sensitive): * all * GA * App Engine * Artifact Registry * BigQuery * Certificate Authority Service * Cloud Bigtable * Cloud Key Management Service * Compute Engine * Cloud Composer * Cloud Dataflow * Cloud Dataproc * Cloud DLP * Cloud EKM * Cloud Firestore * Cloud HSM * Cloud Identity and Access Management * Cloud Logging * Cloud NAT * Cloud Pub/Sub * Cloud Spanner * Cloud SQL * Cloud Storage * Eventarc * Google Kubernetes Engine * Organization Policy Serivice * Persistent Disk * Resource Manager * Secret Manager * Speaker ID Note: These values are supported as input for legacy purposes, but will not be returned from the API. * all * ga-only * appengine.googleapis.com * artifactregistry.googleapis.com * bigquery.googleapis.com * bigtable.googleapis.com * container.googleapis.com * cloudkms.googleapis.com * cloudresourcemanager.googleapis.com * cloudsql.googleapis.com * compute.googleapis.com * dataflow.googleapis.com * dataproc.googleapis.com * dlp.googleapis.com * iam.googleapis.com * logging.googleapis.com * orgpolicy.googleapis.com * pubsub.googleapis.com * spanner.googleapis.com * secretmanager.googleapis.com * speakerid.googleapis.com * storage.googleapis.com Calls to UpdateAccessApprovalSettings using 'all' or any of the XXX.googleapis.com will be translated to the associated product name ('all', 'App Engine', etc.). Note: 'all' will enroll the resource in all products supported at both 'GA' and 'Preview' levels. More information about levels of support is available at https://cloud.google.com/access-approval/docs/supported-services", "type": "string" }, "enrollmentLevel": { diff --git a/accessapproval/v1/accessapproval-gen.go b/accessapproval/v1/accessapproval-gen.go index efa8a68430b..6645b921e09 100644 --- a/accessapproval/v1/accessapproval-gen.go +++ b/accessapproval/v1/accessapproval-gen.go @@ -6,7 +6,7 @@ // Package accessapproval provides access to the Access Approval API. // -// For product documentation, see: https://cloud.google.com/cloud-provider-access-management/access-approval/docs +// For product documentation, see: https://cloud.google.com/assured-workloads/access-approval/docs // // # Creating a client // @@ -642,25 +642,25 @@ type EnrolledService struct { // Cloud Composer * Cloud Dataflow * Cloud Dataproc * Cloud DLP * Cloud // EKM * Cloud Firestore * Cloud HSM * Cloud Identity and Access // Management * Cloud Logging * Cloud NAT * Cloud Pub/Sub * Cloud - // Spanner * Cloud SQL * Cloud Storage * Google Kubernetes Engine * - // Organization Policy Serivice * Persistent Disk * Resource Manager * - // Secret Manager * Speaker ID Note: These values are supported as input - // for legacy purposes, but will not be returned from the API. * all * - // ga-only * appengine.googleapis.com * artifactregistry.googleapis.com - // * bigquery.googleapis.com * bigtable.googleapis.com * - // container.googleapis.com * cloudkms.googleapis.com * - // cloudresourcemanager.googleapis.com * cloudsql.googleapis.com * - // compute.googleapis.com * dataflow.googleapis.com * - // dataproc.googleapis.com * dlp.googleapis.com * iam.googleapis.com * - // logging.googleapis.com * orgpolicy.googleapis.com * - // pubsub.googleapis.com * spanner.googleapis.com * - // secretmanager.googleapis.com * speakerid.googleapis.com * - // storage.googleapis.com Calls to UpdateAccessApprovalSettings using - // 'all' or any of the XXX.googleapis.com will be translated to the - // associated product name ('all', 'App Engine', etc.). Note: 'all' will - // enroll the resource in all products supported at both 'GA' and - // 'Preview' levels. More information about levels of support is - // available at + // Spanner * Cloud SQL * Cloud Storage * Eventarc * Google Kubernetes + // Engine * Organization Policy Serivice * Persistent Disk * Resource + // Manager * Secret Manager * Speaker ID Note: These values are + // supported as input for legacy purposes, but will not be returned from + // the API. * all * ga-only * appengine.googleapis.com * + // artifactregistry.googleapis.com * bigquery.googleapis.com * + // bigtable.googleapis.com * container.googleapis.com * + // cloudkms.googleapis.com * cloudresourcemanager.googleapis.com * + // cloudsql.googleapis.com * compute.googleapis.com * + // dataflow.googleapis.com * dataproc.googleapis.com * + // dlp.googleapis.com * iam.googleapis.com * logging.googleapis.com * + // orgpolicy.googleapis.com * pubsub.googleapis.com * + // spanner.googleapis.com * secretmanager.googleapis.com * + // speakerid.googleapis.com * storage.googleapis.com Calls to + // UpdateAccessApprovalSettings using 'all' or any of the + // XXX.googleapis.com will be translated to the associated product name + // ('all', 'App Engine', etc.). Note: 'all' will enroll the resource in + // all products supported at both 'GA' and 'Preview' levels. More + // information about levels of support is available at // https://cloud.google.com/access-approval/docs/supported-services CloudProduct string `json:"cloudProduct,omitempty"` diff --git a/adexchangebuyer2/v2beta1/adexchangebuyer2-api.json b/adexchangebuyer2/v2beta1/adexchangebuyer2-api.json index 5feb20648dd..ec5967f0959 100644 --- a/adexchangebuyer2/v2beta1/adexchangebuyer2-api.json +++ b/adexchangebuyer2/v2beta1/adexchangebuyer2-api.json @@ -2568,7 +2568,7 @@ } } }, - "revision": "20230419", + "revision": "20230508", "rootUrl": "https://adexchangebuyer.googleapis.com/", "schemas": { "AbsoluteDateRange": { @@ -4441,7 +4441,7 @@ "type": "string" }, "guaranteedLooks": { - "description": "Count of guaranteed looks. Required for deal, optional for product.", + "description": "Count of guaranteed looks. Required for deal, optional for product. For CPD deals, buyer changes to guaranteed_looks will be ignored.", "format": "int64", "type": "string" }, @@ -4451,7 +4451,7 @@ "type": "string" }, "minimumDailyLooks": { - "description": "Daily minimum looks for CPD deal types.", + "description": "Daily minimum looks for CPD deal types. For CPD deals, buyer should negotiate on this field instead of guaranteed_looks.", "format": "int64", "type": "string" }, diff --git a/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go b/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go index 6ea5954db39..b52eda67dc9 100644 --- a/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go +++ b/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go @@ -2927,14 +2927,17 @@ type GuaranteedFixedPriceTerms struct { GuaranteedImpressions int64 `json:"guaranteedImpressions,omitempty,string"` // GuaranteedLooks: Count of guaranteed looks. Required for deal, - // optional for product. + // optional for product. For CPD deals, buyer changes to + // guaranteed_looks will be ignored. GuaranteedLooks int64 `json:"guaranteedLooks,omitempty,string"` // ImpressionCap: The lifetime impression cap for CPM sponsorship deals. // The deal will stop serving when the cap is reached. ImpressionCap int64 `json:"impressionCap,omitempty,string"` - // MinimumDailyLooks: Daily minimum looks for CPD deal types. + // MinimumDailyLooks: Daily minimum looks for CPD deal types. For CPD + // deals, buyer should negotiate on this field instead of + // guaranteed_looks. MinimumDailyLooks int64 `json:"minimumDailyLooks,omitempty,string"` // PercentShareOfVoice: For sponsorship deals, this is the percentage of diff --git a/analyticsadmin/v1alpha/analyticsadmin-api.json b/analyticsadmin/v1alpha/analyticsadmin-api.json index cb5ab92cbe5..238d0a12cd5 100644 --- a/analyticsadmin/v1alpha/analyticsadmin-api.json +++ b/analyticsadmin/v1alpha/analyticsadmin-api.json @@ -2745,6 +2745,160 @@ } }, "resources": { + "eventCreateRules": { + "methods": { + "create": { + "description": "Creates an EventCreateRule.", + "flatPath": "v1alpha/properties/{propertiesId}/dataStreams/{dataStreamsId}/eventCreateRules", + "httpMethod": "POST", + "id": "analyticsadmin.properties.dataStreams.eventCreateRules.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. Example format: properties/123/dataStreams/456", + "location": "path", + "pattern": "^properties/[^/]+/dataStreams/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/eventCreateRules", + "request": { + "$ref": "GoogleAnalyticsAdminV1alphaEventCreateRule" + }, + "response": { + "$ref": "GoogleAnalyticsAdminV1alphaEventCreateRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/analytics.edit" + ] + }, + "delete": { + "description": "Deletes an EventCreateRule.", + "flatPath": "v1alpha/properties/{propertiesId}/dataStreams/{dataStreamsId}/eventCreateRules/{eventCreateRulesId}", + "httpMethod": "DELETE", + "id": "analyticsadmin.properties.dataStreams.eventCreateRules.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Example format: properties/123/dataStreams/456/eventCreateRules/789", + "location": "path", + "pattern": "^properties/[^/]+/dataStreams/[^/]+/eventCreateRules/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleProtobufEmpty" + }, + "scopes": [ + "https://www.googleapis.com/auth/analytics.edit" + ] + }, + "get": { + "description": "Lookup for a single EventCreateRule.", + "flatPath": "v1alpha/properties/{propertiesId}/dataStreams/{dataStreamsId}/eventCreateRules/{eventCreateRulesId}", + "httpMethod": "GET", + "id": "analyticsadmin.properties.dataStreams.eventCreateRules.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the EventCreateRule to get. Example format: properties/123/dataStreams/456/eventCreateRules/789", + "location": "path", + "pattern": "^properties/[^/]+/dataStreams/[^/]+/eventCreateRules/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleAnalyticsAdminV1alphaEventCreateRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/analytics.edit", + "https://www.googleapis.com/auth/analytics.readonly" + ] + }, + "list": { + "description": "Lists EventCreateRules on a web data stream.", + "flatPath": "v1alpha/properties/{propertiesId}/dataStreams/{dataStreamsId}/eventCreateRules", + "httpMethod": "GET", + "id": "analyticsadmin.properties.dataStreams.eventCreateRules.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200 (higher values will be coerced to the maximum).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A page token, received from a previous `ListEventCreateRules` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListEventCreateRules` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Example format: properties/123/dataStreams/456", + "location": "path", + "pattern": "^properties/[^/]+/dataStreams/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/eventCreateRules", + "response": { + "$ref": "GoogleAnalyticsAdminV1alphaListEventCreateRulesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/analytics.edit", + "https://www.googleapis.com/auth/analytics.readonly" + ] + }, + "patch": { + "description": "Updates an EventCreateRule.", + "flatPath": "v1alpha/properties/{propertiesId}/dataStreams/{dataStreamsId}/eventCreateRules/{eventCreateRulesId}", + "httpMethod": "PATCH", + "id": "analyticsadmin.properties.dataStreams.eventCreateRules.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. Resource name for this EventCreateRule resource. Format: properties/{property}/dataStreams/{data_stream}/eventCreateRules", + "location": "path", + "pattern": "^properties/[^/]+/dataStreams/[^/]+/eventCreateRules/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. The list of fields to be updated. Field names must be in snake case (e.g., \"field_to_update\"). Omitted fields will not be updated. To replace the entire entity, use one path with the string \"*\" to match all fields.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "request": { + "$ref": "GoogleAnalyticsAdminV1alphaEventCreateRule" + }, + "response": { + "$ref": "GoogleAnalyticsAdminV1alphaEventCreateRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/analytics.edit" + ] + } + } + }, "measurementProtocolSecrets": { "methods": { "create": { @@ -4062,7 +4216,7 @@ } } }, - "revision": "20230424", + "revision": "20230507", "rootUrl": "https://analyticsadmin.googleapis.com/", "schemas": { "GoogleAnalyticsAdminV1alphaAccessBetweenFilter": { @@ -5388,6 +5542,10 @@ "$ref": "GoogleAnalyticsAdminV1alphaAttributionSettings", "description": "A snapshot of AttributionSettings resource in change history." }, + "audience": { + "$ref": "GoogleAnalyticsAdminV1alphaAudience", + "description": "A snapshot of an Audience resource in change history." + }, "bigqueryLink": { "$ref": "GoogleAnalyticsAdminV1alphaBigQueryLink", "description": "A snapshot of a BigQuery link resource in change history." @@ -5428,6 +5586,10 @@ "$ref": "GoogleAnalyticsAdminV1alphaEnhancedMeasurementSettings", "description": "A snapshot of EnhancedMeasurementSettings resource in change history." }, + "eventCreateRule": { + "$ref": "GoogleAnalyticsAdminV1alphaEventCreateRule", + "description": "A snapshot of an EventCreateRule resource in change history." + }, "expandedDataSet": { "$ref": "GoogleAnalyticsAdminV1alphaExpandedDataSet", "description": "A snapshot of an ExpandedDataSet resource in change history." @@ -6211,6 +6373,40 @@ }, "type": "object" }, + "GoogleAnalyticsAdminV1alphaEventCreateRule": { + "description": "An Event Create Rule defines conditions that will trigger the creation of an entirely new event based upon matched criteria of a source event. Additional mutations of the parameters from the source event can be defined. Unlike Event Edit rules, Event Creation Rules have no defined order. They will all be run independently. Event Edit and Event Create rules can't be used to modify an event created from an Event Create rule.", + "id": "GoogleAnalyticsAdminV1alphaEventCreateRule", + "properties": { + "destinationEvent": { + "description": "Required. The name of the new event to be created. This value must: * be less than 40 characters * consist only of letters, digits or _ (underscores) * start with a letter", + "type": "string" + }, + "eventConditions": { + "description": "Required. Must have at least one condition, and can have up to 10 max. Conditions on the source event must match for this rule to be applied.", + "items": { + "$ref": "GoogleAnalyticsAdminV1alphaMatchingCondition" + }, + "type": "array" + }, + "name": { + "description": "Output only. Resource name for this EventCreateRule resource. Format: properties/{property}/dataStreams/{data_stream}/eventCreateRules", + "readOnly": true, + "type": "string" + }, + "parameterMutations": { + "description": "Parameter mutations define parameter behavior on the new event, and are applied in order. A maximum of 20 mutations can be applied.", + "items": { + "$ref": "GoogleAnalyticsAdminV1alphaParameterMutation" + }, + "type": "array" + }, + "sourceCopyParameters": { + "description": "If true, the source parameters are copied to the new event. If false, or unset, all non-internal parameters are not copied from the source event. Parameter mutations are applied after the parameters have been copied.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleAnalyticsAdminV1alphaExpandedDataSet": { "description": "A resource message representing a GA4 ExpandedDataSet.", "id": "GoogleAnalyticsAdminV1alphaExpandedDataSet", @@ -6814,6 +7010,24 @@ }, "type": "object" }, + "GoogleAnalyticsAdminV1alphaListEventCreateRulesResponse": { + "description": "Response message for ListEventCreateRules RPC.", + "id": "GoogleAnalyticsAdminV1alphaListEventCreateRulesResponse", + "properties": { + "eventCreateRules": { + "description": "List of EventCreateRules. These will be ordered stably, but in an arbitrary order.", + "items": { + "$ref": "GoogleAnalyticsAdminV1alphaEventCreateRule" + }, + "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" + }, "GoogleAnalyticsAdminV1alphaListExpandedDataSetsResponse": { "description": "Response message for ListExpandedDataSets RPC.", "id": "GoogleAnalyticsAdminV1alphaListExpandedDataSetsResponse", @@ -6940,6 +7154,63 @@ }, "type": "object" }, + "GoogleAnalyticsAdminV1alphaMatchingCondition": { + "description": "Defines a condition for when an Event Edit or Event Creation rule applies to an event.", + "id": "GoogleAnalyticsAdminV1alphaMatchingCondition", + "properties": { + "comparisonType": { + "description": "Required. The type of comparison to be applied to the value.", + "enum": [ + "COMPARISON_TYPE_UNSPECIFIED", + "EQUALS", + "EQUALS_CASE_INSENSITIVE", + "CONTAINS", + "CONTAINS_CASE_INSENSITIVE", + "STARTS_WITH", + "STARTS_WITH_CASE_INSENSITIVE", + "ENDS_WITH", + "ENDS_WITH_CASE_INSENSITIVE", + "GREATER_THAN", + "GREATER_THAN_OR_EQUAL", + "LESS_THAN", + "LESS_THAN_OR_EQUAL", + "REGULAR_EXPRESSION", + "REGULAR_EXPRESSION_CASE_INSENSITIVE" + ], + "enumDescriptions": [ + "Unknown", + "Equals, case sensitive", + "Equals, case insensitive", + "Contains, case sensitive", + "Contains, case insensitive", + "Starts with, case sensitive", + "Starts with, case insensitive", + "Ends with, case sensitive", + "Ends with, case insensitive", + "Greater than", + "Greater than or equal", + "Less than", + "Less than or equal", + "regular expression. Only supported for web streams.", + "regular expression, case insensitive. Only supported for web streams." + ], + "type": "string" + }, + "field": { + "description": "Required. The name of the field that is compared against for the condition. If 'event_name' is specified this condition will apply to the name of the event. Otherwise the condition will apply to a parameter with the specified name. This value cannot contain spaces.", + "type": "string" + }, + "negated": { + "description": "Whether or not the result of the comparison should be negated. For example, if `negated` is true, then 'equals' comparisons would function as 'not equals'.", + "type": "boolean" + }, + "value": { + "description": "Required. The value being compared against for this condition. The runtime implementation may perform type coercion of this value to evaluate this condition based on the type of the parameter value.", + "type": "string" + } + }, + "type": "object" + }, "GoogleAnalyticsAdminV1alphaMeasurementProtocolSecret": { "description": "A secret value used for sending hits to Measurement Protocol.", "id": "GoogleAnalyticsAdminV1alphaMeasurementProtocolSecret", @@ -6978,6 +7249,21 @@ }, "type": "object" }, + "GoogleAnalyticsAdminV1alphaParameterMutation": { + "description": "Defines an event parameter to mutate.", + "id": "GoogleAnalyticsAdminV1alphaParameterMutation", + "properties": { + "parameter": { + "description": "Required. The name of the parameter to mutate. This value must: * be less than 40 characters. * be unique across across all mutations within the rule * consist only of letters, digits or _ (underscores) For event edit rules, the name may also be set to 'event_name' to modify the event_name in place.", + "type": "string" + }, + "parameterValue": { + "description": "Required. The value mutation to perform. * Must be less than 100 characters. * To specify a constant value for the param, use the value's string. * To copy value from another parameter, use syntax like \"[[other_parameter]]\" For more details, see this [help center article](https://support.google.com/analytics/answer/10085872#modify-an-event\u0026zippy=%2Cin-this-article%2Cmodify-parameters).", + "type": "string" + } + }, + "type": "object" + }, "GoogleAnalyticsAdminV1alphaProperty": { "description": "A resource message representing a Google Analytics GA4 property.", "id": "GoogleAnalyticsAdminV1alphaProperty", @@ -7398,7 +7684,9 @@ "ATTRIBUTION_SETTINGS", "EXPANDED_DATA_SET", "CHANNEL_GROUP", - "ENHANCED_MEASUREMENT_SETTINGS" + "ENHANCED_MEASUREMENT_SETTINGS", + "AUDIENCE", + "EVENT_CREATE_RULE" ], "enumDescriptions": [ "Resource type unknown or not specified.", @@ -7419,7 +7707,9 @@ "AttributionSettings resource", "ExpandedDataSet resource", "ChannelGroup resource", - "EnhancedMeasurementSettings resource" + "EnhancedMeasurementSettings resource", + "Audience resource", + "EventCreateRule resource" ], "type": "string" }, diff --git a/analyticsadmin/v1alpha/analyticsadmin-gen.go b/analyticsadmin/v1alpha/analyticsadmin-gen.go index 3de9d5891c2..dd14ecc4a5a 100644 --- a/analyticsadmin/v1alpha/analyticsadmin-gen.go +++ b/analyticsadmin/v1alpha/analyticsadmin-gen.go @@ -320,6 +320,7 @@ type PropertiesCustomMetricsService struct { func NewPropertiesDataStreamsService(s *Service) *PropertiesDataStreamsService { rs := &PropertiesDataStreamsService{s: s} + rs.EventCreateRules = NewPropertiesDataStreamsEventCreateRulesService(s) rs.MeasurementProtocolSecrets = NewPropertiesDataStreamsMeasurementProtocolSecretsService(s) return rs } @@ -327,9 +328,20 @@ func NewPropertiesDataStreamsService(s *Service) *PropertiesDataStreamsService { type PropertiesDataStreamsService struct { s *Service + EventCreateRules *PropertiesDataStreamsEventCreateRulesService + MeasurementProtocolSecrets *PropertiesDataStreamsMeasurementProtocolSecretsService } +func NewPropertiesDataStreamsEventCreateRulesService(s *Service) *PropertiesDataStreamsEventCreateRulesService { + rs := &PropertiesDataStreamsEventCreateRulesService{s: s} + return rs +} + +type PropertiesDataStreamsEventCreateRulesService struct { + s *Service +} + func NewPropertiesDataStreamsMeasurementProtocolSecretsService(s *Service) *PropertiesDataStreamsMeasurementProtocolSecretsService { rs := &PropertiesDataStreamsMeasurementProtocolSecretsService{s: s} return rs @@ -2818,6 +2830,9 @@ type GoogleAnalyticsAdminV1alphaChangeHistoryChangeChangeHistoryResource struct // change history. AttributionSettings *GoogleAnalyticsAdminV1alphaAttributionSettings `json:"attributionSettings,omitempty"` + // Audience: A snapshot of an Audience resource in change history. + Audience *GoogleAnalyticsAdminV1alphaAudience `json:"audience,omitempty"` + // BigqueryLink: A snapshot of a BigQuery link resource in change // history. BigqueryLink *GoogleAnalyticsAdminV1alphaBigQueryLink `json:"bigqueryLink,omitempty"` @@ -2857,6 +2872,10 @@ type GoogleAnalyticsAdminV1alphaChangeHistoryChangeChangeHistoryResource struct // EnhancedMeasurementSettings resource in change history. EnhancedMeasurementSettings *GoogleAnalyticsAdminV1alphaEnhancedMeasurementSettings `json:"enhancedMeasurementSettings,omitempty"` + // EventCreateRule: A snapshot of an EventCreateRule resource in change + // history. + EventCreateRule *GoogleAnalyticsAdminV1alphaEventCreateRule `json:"eventCreateRule,omitempty"` + // ExpandedDataSet: A snapshot of an ExpandedDataSet resource in change // history. ExpandedDataSet *GoogleAnalyticsAdminV1alphaExpandedDataSet `json:"expandedDataSet,omitempty"` @@ -4186,6 +4205,68 @@ func (s *GoogleAnalyticsAdminV1alphaEnhancedMeasurementSettings) MarshalJSON() ( return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleAnalyticsAdminV1alphaEventCreateRule: An Event Create Rule +// defines conditions that will trigger the creation of an entirely new +// event based upon matched criteria of a source event. Additional +// mutations of the parameters from the source event can be defined. +// Unlike Event Edit rules, Event Creation Rules have no defined order. +// They will all be run independently. Event Edit and Event Create rules +// can't be used to modify an event created from an Event Create rule. +type GoogleAnalyticsAdminV1alphaEventCreateRule struct { + // DestinationEvent: Required. The name of the new event to be created. + // This value must: * be less than 40 characters * consist only of + // letters, digits or _ (underscores) * start with a letter + DestinationEvent string `json:"destinationEvent,omitempty"` + + // EventConditions: Required. Must have at least one condition, and can + // have up to 10 max. Conditions on the source event must match for this + // rule to be applied. + EventConditions []*GoogleAnalyticsAdminV1alphaMatchingCondition `json:"eventConditions,omitempty"` + + // Name: Output only. Resource name for this EventCreateRule resource. + // Format: + // properties/{property}/dataStreams/{data_stream}/eventCreateRules + Name string `json:"name,omitempty"` + + // ParameterMutations: Parameter mutations define parameter behavior on + // the new event, and are applied in order. A maximum of 20 mutations + // can be applied. + ParameterMutations []*GoogleAnalyticsAdminV1alphaParameterMutation `json:"parameterMutations,omitempty"` + + // SourceCopyParameters: If true, the source parameters are copied to + // the new event. If false, or unset, all non-internal parameters are + // not copied from the source event. Parameter mutations are applied + // after the parameters have been copied. + SourceCopyParameters bool `json:"sourceCopyParameters,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "DestinationEvent") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DestinationEvent") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleAnalyticsAdminV1alphaEventCreateRule) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAnalyticsAdminV1alphaEventCreateRule + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleAnalyticsAdminV1alphaExpandedDataSet: A resource message // representing a GA4 ExpandedDataSet. type GoogleAnalyticsAdminV1alphaExpandedDataSet struct { @@ -5385,6 +5466,46 @@ func (s *GoogleAnalyticsAdminV1alphaListDisplayVideo360AdvertiserLinksResponse) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleAnalyticsAdminV1alphaListEventCreateRulesResponse: Response +// message for ListEventCreateRules RPC. +type GoogleAnalyticsAdminV1alphaListEventCreateRulesResponse struct { + // EventCreateRules: List of EventCreateRules. These will be ordered + // stably, but in an arbitrary order. + EventCreateRules []*GoogleAnalyticsAdminV1alphaEventCreateRule `json:"eventCreateRules,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. "EventCreateRules") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "EventCreateRules") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleAnalyticsAdminV1alphaListEventCreateRulesResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAnalyticsAdminV1alphaListEventCreateRulesResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleAnalyticsAdminV1alphaListExpandedDataSetsResponse: Response // message for ListExpandedDataSets RPC. type GoogleAnalyticsAdminV1alphaListExpandedDataSetsResponse struct { @@ -5661,6 +5782,72 @@ func (s *GoogleAnalyticsAdminV1alphaListUserLinksResponse) MarshalJSON() ([]byte return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleAnalyticsAdminV1alphaMatchingCondition: Defines a condition for +// when an Event Edit or Event Creation rule applies to an event. +type GoogleAnalyticsAdminV1alphaMatchingCondition struct { + // ComparisonType: Required. The type of comparison to be applied to the + // value. + // + // Possible values: + // "COMPARISON_TYPE_UNSPECIFIED" - Unknown + // "EQUALS" - Equals, case sensitive + // "EQUALS_CASE_INSENSITIVE" - Equals, case insensitive + // "CONTAINS" - Contains, case sensitive + // "CONTAINS_CASE_INSENSITIVE" - Contains, case insensitive + // "STARTS_WITH" - Starts with, case sensitive + // "STARTS_WITH_CASE_INSENSITIVE" - Starts with, case insensitive + // "ENDS_WITH" - Ends with, case sensitive + // "ENDS_WITH_CASE_INSENSITIVE" - Ends with, case insensitive + // "GREATER_THAN" - Greater than + // "GREATER_THAN_OR_EQUAL" - Greater than or equal + // "LESS_THAN" - Less than + // "LESS_THAN_OR_EQUAL" - Less than or equal + // "REGULAR_EXPRESSION" - regular expression. Only supported for web + // streams. + // "REGULAR_EXPRESSION_CASE_INSENSITIVE" - regular expression, case + // insensitive. Only supported for web streams. + ComparisonType string `json:"comparisonType,omitempty"` + + // Field: Required. The name of the field that is compared against for + // the condition. If 'event_name' is specified this condition will apply + // to the name of the event. Otherwise the condition will apply to a + // parameter with the specified name. This value cannot contain spaces. + Field string `json:"field,omitempty"` + + // Negated: Whether or not the result of the comparison should be + // negated. For example, if `negated` is true, then 'equals' comparisons + // would function as 'not equals'. + Negated bool `json:"negated,omitempty"` + + // Value: Required. The value being compared against for this condition. + // The runtime implementation may perform type coercion of this value to + // evaluate this condition based on the type of the parameter value. + Value string `json:"value,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ComparisonType") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ComparisonType") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleAnalyticsAdminV1alphaMatchingCondition) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAnalyticsAdminV1alphaMatchingCondition + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleAnalyticsAdminV1alphaMeasurementProtocolSecret: A secret value // used for sending hits to Measurement Protocol. type GoogleAnalyticsAdminV1alphaMeasurementProtocolSecret struct { @@ -5750,6 +5937,47 @@ func (s *GoogleAnalyticsAdminV1alphaNumericValue) UnmarshalJSON(data []byte) err return nil } +// GoogleAnalyticsAdminV1alphaParameterMutation: Defines an event +// parameter to mutate. +type GoogleAnalyticsAdminV1alphaParameterMutation struct { + // Parameter: Required. The name of the parameter to mutate. This value + // must: * be less than 40 characters. * be unique across across all + // mutations within the rule * consist only of letters, digits or _ + // (underscores) For event edit rules, the name may also be set to + // 'event_name' to modify the event_name in place. + Parameter string `json:"parameter,omitempty"` + + // ParameterValue: Required. The value mutation to perform. * Must be + // less than 100 characters. * To specify a constant value for the + // param, use the value's string. * To copy value from another + // parameter, use syntax like "[[other_parameter]]" For more details, + // see this help center article + // (https://support.google.com/analytics/answer/10085872#modify-an-event&zippy=%2Cin-this-article%2Cmodify-parameters). + ParameterValue string `json:"parameterValue,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Parameter") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Parameter") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleAnalyticsAdminV1alphaParameterMutation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAnalyticsAdminV1alphaParameterMutation + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleAnalyticsAdminV1alphaProperty: A resource message representing // a Google Analytics GA4 property. type GoogleAnalyticsAdminV1alphaProperty struct { @@ -6291,6 +6519,8 @@ type GoogleAnalyticsAdminV1alphaSearchChangeHistoryEventsRequest struct { // "CHANNEL_GROUP" - ChannelGroup resource // "ENHANCED_MEASUREMENT_SETTINGS" - EnhancedMeasurementSettings // resource + // "AUDIENCE" - Audience resource + // "EVENT_CREATE_RULE" - EventCreateRule resource ResourceType []string `json:"resourceType,omitempty"` // ForceSendFields is a list of field names (e.g. "Action") to @@ -20588,6 +20818,796 @@ func (c *PropertiesDataStreamsUpdateEnhancedMeasurementSettingsCall) Do(opts ... } +// method id "analyticsadmin.properties.dataStreams.eventCreateRules.create": + +type PropertiesDataStreamsEventCreateRulesCreateCall struct { + s *Service + parent string + googleanalyticsadminv1alphaeventcreaterule *GoogleAnalyticsAdminV1alphaEventCreateRule + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates an EventCreateRule. +// +// - parent: Example format: properties/123/dataStreams/456. +func (r *PropertiesDataStreamsEventCreateRulesService) Create(parent string, googleanalyticsadminv1alphaeventcreaterule *GoogleAnalyticsAdminV1alphaEventCreateRule) *PropertiesDataStreamsEventCreateRulesCreateCall { + c := &PropertiesDataStreamsEventCreateRulesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleanalyticsadminv1alphaeventcreaterule = googleanalyticsadminv1alphaeventcreaterule + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *PropertiesDataStreamsEventCreateRulesCreateCall) Fields(s ...googleapi.Field) *PropertiesDataStreamsEventCreateRulesCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *PropertiesDataStreamsEventCreateRulesCreateCall) Context(ctx context.Context) *PropertiesDataStreamsEventCreateRulesCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *PropertiesDataStreamsEventCreateRulesCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PropertiesDataStreamsEventCreateRulesCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleanalyticsadminv1alphaeventcreaterule) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/eventCreateRules") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "analyticsadmin.properties.dataStreams.eventCreateRules.create" call. +// Exactly one of *GoogleAnalyticsAdminV1alphaEventCreateRule or error +// will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleAnalyticsAdminV1alphaEventCreateRule.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 *PropertiesDataStreamsEventCreateRulesCreateCall) Do(opts ...googleapi.CallOption) (*GoogleAnalyticsAdminV1alphaEventCreateRule, 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 := &GoogleAnalyticsAdminV1alphaEventCreateRule{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates an EventCreateRule.", + // "flatPath": "v1alpha/properties/{propertiesId}/dataStreams/{dataStreamsId}/eventCreateRules", + // "httpMethod": "POST", + // "id": "analyticsadmin.properties.dataStreams.eventCreateRules.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. Example format: properties/123/dataStreams/456", + // "location": "path", + // "pattern": "^properties/[^/]+/dataStreams/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+parent}/eventCreateRules", + // "request": { + // "$ref": "GoogleAnalyticsAdminV1alphaEventCreateRule" + // }, + // "response": { + // "$ref": "GoogleAnalyticsAdminV1alphaEventCreateRule" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/analytics.edit" + // ] + // } + +} + +// method id "analyticsadmin.properties.dataStreams.eventCreateRules.delete": + +type PropertiesDataStreamsEventCreateRulesDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes an EventCreateRule. +// +// - name: Example format: +// properties/123/dataStreams/456/eventCreateRules/789. +func (r *PropertiesDataStreamsEventCreateRulesService) Delete(name string) *PropertiesDataStreamsEventCreateRulesDeleteCall { + c := &PropertiesDataStreamsEventCreateRulesDeleteCall{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 information. +func (c *PropertiesDataStreamsEventCreateRulesDeleteCall) Fields(s ...googleapi.Field) *PropertiesDataStreamsEventCreateRulesDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *PropertiesDataStreamsEventCreateRulesDeleteCall) Context(ctx context.Context) *PropertiesDataStreamsEventCreateRulesDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *PropertiesDataStreamsEventCreateRulesDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PropertiesDataStreamsEventCreateRulesDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "analyticsadmin.properties.dataStreams.eventCreateRules.delete" call. +// Exactly one of *GoogleProtobufEmpty or error will be non-nil. 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 *PropertiesDataStreamsEventCreateRulesDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, 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 := &GoogleProtobufEmpty{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Deletes an EventCreateRule.", + // "flatPath": "v1alpha/properties/{propertiesId}/dataStreams/{dataStreamsId}/eventCreateRules/{eventCreateRulesId}", + // "httpMethod": "DELETE", + // "id": "analyticsadmin.properties.dataStreams.eventCreateRules.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Example format: properties/123/dataStreams/456/eventCreateRules/789", + // "location": "path", + // "pattern": "^properties/[^/]+/dataStreams/[^/]+/eventCreateRules/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}", + // "response": { + // "$ref": "GoogleProtobufEmpty" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/analytics.edit" + // ] + // } + +} + +// method id "analyticsadmin.properties.dataStreams.eventCreateRules.get": + +type PropertiesDataStreamsEventCreateRulesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Lookup for a single EventCreateRule. +// +// - name: The name of the EventCreateRule to get. Example format: +// properties/123/dataStreams/456/eventCreateRules/789. +func (r *PropertiesDataStreamsEventCreateRulesService) Get(name string) *PropertiesDataStreamsEventCreateRulesGetCall { + c := &PropertiesDataStreamsEventCreateRulesGetCall{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 information. +func (c *PropertiesDataStreamsEventCreateRulesGetCall) Fields(s ...googleapi.Field) *PropertiesDataStreamsEventCreateRulesGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *PropertiesDataStreamsEventCreateRulesGetCall) IfNoneMatch(entityTag string) *PropertiesDataStreamsEventCreateRulesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *PropertiesDataStreamsEventCreateRulesGetCall) Context(ctx context.Context) *PropertiesDataStreamsEventCreateRulesGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *PropertiesDataStreamsEventCreateRulesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PropertiesDataStreamsEventCreateRulesGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "analyticsadmin.properties.dataStreams.eventCreateRules.get" call. +// Exactly one of *GoogleAnalyticsAdminV1alphaEventCreateRule or error +// will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleAnalyticsAdminV1alphaEventCreateRule.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 *PropertiesDataStreamsEventCreateRulesGetCall) Do(opts ...googleapi.CallOption) (*GoogleAnalyticsAdminV1alphaEventCreateRule, 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 := &GoogleAnalyticsAdminV1alphaEventCreateRule{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lookup for a single EventCreateRule.", + // "flatPath": "v1alpha/properties/{propertiesId}/dataStreams/{dataStreamsId}/eventCreateRules/{eventCreateRulesId}", + // "httpMethod": "GET", + // "id": "analyticsadmin.properties.dataStreams.eventCreateRules.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The name of the EventCreateRule to get. Example format: properties/123/dataStreams/456/eventCreateRules/789", + // "location": "path", + // "pattern": "^properties/[^/]+/dataStreams/[^/]+/eventCreateRules/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}", + // "response": { + // "$ref": "GoogleAnalyticsAdminV1alphaEventCreateRule" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/analytics.edit", + // "https://www.googleapis.com/auth/analytics.readonly" + // ] + // } + +} + +// method id "analyticsadmin.properties.dataStreams.eventCreateRules.list": + +type PropertiesDataStreamsEventCreateRulesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists EventCreateRules on a web data stream. +// +// - parent: Example format: properties/123/dataStreams/456. +func (r *PropertiesDataStreamsEventCreateRulesService) List(parent string) *PropertiesDataStreamsEventCreateRulesListCall { + c := &PropertiesDataStreamsEventCreateRulesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number +// of resources to return. If unspecified, at most 50 resources will be +// returned. The maximum value is 200 (higher values will be coerced to +// the maximum). +func (c *PropertiesDataStreamsEventCreateRulesListCall) PageSize(pageSize int64) *PropertiesDataStreamsEventCreateRulesListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, +// received from a previous `ListEventCreateRules` call. Provide this to +// retrieve the subsequent page. When paginating, all other parameters +// provided to `ListEventCreateRules` must match the call that provided +// the page token. +func (c *PropertiesDataStreamsEventCreateRulesListCall) PageToken(pageToken string) *PropertiesDataStreamsEventCreateRulesListCall { + 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 information. +func (c *PropertiesDataStreamsEventCreateRulesListCall) Fields(s ...googleapi.Field) *PropertiesDataStreamsEventCreateRulesListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *PropertiesDataStreamsEventCreateRulesListCall) IfNoneMatch(entityTag string) *PropertiesDataStreamsEventCreateRulesListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *PropertiesDataStreamsEventCreateRulesListCall) Context(ctx context.Context) *PropertiesDataStreamsEventCreateRulesListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *PropertiesDataStreamsEventCreateRulesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PropertiesDataStreamsEventCreateRulesListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/eventCreateRules") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "analyticsadmin.properties.dataStreams.eventCreateRules.list" call. +// Exactly one of +// *GoogleAnalyticsAdminV1alphaListEventCreateRulesResponse or error +// will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleAnalyticsAdminV1alphaListEventCreateRulesResponse.ServerRespons +// e.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 *PropertiesDataStreamsEventCreateRulesListCall) Do(opts ...googleapi.CallOption) (*GoogleAnalyticsAdminV1alphaListEventCreateRulesResponse, 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 := &GoogleAnalyticsAdminV1alphaListEventCreateRulesResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists EventCreateRules on a web data stream.", + // "flatPath": "v1alpha/properties/{propertiesId}/dataStreams/{dataStreamsId}/eventCreateRules", + // "httpMethod": "GET", + // "id": "analyticsadmin.properties.dataStreams.eventCreateRules.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200 (higher values will be coerced to the maximum).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "A page token, received from a previous `ListEventCreateRules` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListEventCreateRules` must match the call that provided the page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. Example format: properties/123/dataStreams/456", + // "location": "path", + // "pattern": "^properties/[^/]+/dataStreams/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+parent}/eventCreateRules", + // "response": { + // "$ref": "GoogleAnalyticsAdminV1alphaListEventCreateRulesResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/analytics.edit", + // "https://www.googleapis.com/auth/analytics.readonly" + // ] + // } + +} + +// 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 *PropertiesDataStreamsEventCreateRulesListCall) Pages(ctx context.Context, f func(*GoogleAnalyticsAdminV1alphaListEventCreateRulesResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "analyticsadmin.properties.dataStreams.eventCreateRules.patch": + +type PropertiesDataStreamsEventCreateRulesPatchCall struct { + s *Service + name string + googleanalyticsadminv1alphaeventcreaterule *GoogleAnalyticsAdminV1alphaEventCreateRule + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates an EventCreateRule. +// +// - name: Output only. Resource name for this EventCreateRule resource. +// Format: +// properties/{property}/dataStreams/{data_stream}/eventCreateRules. +func (r *PropertiesDataStreamsEventCreateRulesService) Patch(name string, googleanalyticsadminv1alphaeventcreaterule *GoogleAnalyticsAdminV1alphaEventCreateRule) *PropertiesDataStreamsEventCreateRulesPatchCall { + c := &PropertiesDataStreamsEventCreateRulesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleanalyticsadminv1alphaeventcreaterule = googleanalyticsadminv1alphaeventcreaterule + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. The +// list of fields to be updated. Field names must be in snake case +// (e.g., "field_to_update"). Omitted fields will not be updated. To +// replace the entire entity, use one path with the string "*" to match +// all fields. +func (c *PropertiesDataStreamsEventCreateRulesPatchCall) UpdateMask(updateMask string) *PropertiesDataStreamsEventCreateRulesPatchCall { + 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 information. +func (c *PropertiesDataStreamsEventCreateRulesPatchCall) Fields(s ...googleapi.Field) *PropertiesDataStreamsEventCreateRulesPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *PropertiesDataStreamsEventCreateRulesPatchCall) Context(ctx context.Context) *PropertiesDataStreamsEventCreateRulesPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *PropertiesDataStreamsEventCreateRulesPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PropertiesDataStreamsEventCreateRulesPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleanalyticsadminv1alphaeventcreaterule) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "analyticsadmin.properties.dataStreams.eventCreateRules.patch" call. +// Exactly one of *GoogleAnalyticsAdminV1alphaEventCreateRule or error +// will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleAnalyticsAdminV1alphaEventCreateRule.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 *PropertiesDataStreamsEventCreateRulesPatchCall) Do(opts ...googleapi.CallOption) (*GoogleAnalyticsAdminV1alphaEventCreateRule, 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 := &GoogleAnalyticsAdminV1alphaEventCreateRule{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates an EventCreateRule.", + // "flatPath": "v1alpha/properties/{propertiesId}/dataStreams/{dataStreamsId}/eventCreateRules/{eventCreateRulesId}", + // "httpMethod": "PATCH", + // "id": "analyticsadmin.properties.dataStreams.eventCreateRules.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Output only. Resource name for this EventCreateRule resource. Format: properties/{property}/dataStreams/{data_stream}/eventCreateRules", + // "location": "path", + // "pattern": "^properties/[^/]+/dataStreams/[^/]+/eventCreateRules/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Required. The list of fields to be updated. Field names must be in snake case (e.g., \"field_to_update\"). Omitted fields will not be updated. To replace the entire entity, use one path with the string \"*\" to match all fields.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}", + // "request": { + // "$ref": "GoogleAnalyticsAdminV1alphaEventCreateRule" + // }, + // "response": { + // "$ref": "GoogleAnalyticsAdminV1alphaEventCreateRule" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/analytics.edit" + // ] + // } + +} + // method id "analyticsadmin.properties.dataStreams.measurementProtocolSecrets.create": type PropertiesDataStreamsMeasurementProtocolSecretsCreateCall struct { diff --git a/api-list.json b/api-list.json index b92eeb680c1..ffaea337524 100644 --- a/api-list.json +++ b/api-list.json @@ -44,7 +44,7 @@ "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" }, - "documentationLink": "https://cloud.google.com/cloud-provider-access-management/access-approval/docs", + "documentationLink": "https://cloud.google.com/assured-workloads/access-approval/docs", "preferred": true }, { diff --git a/apigateway/v1/apigateway-api.json b/apigateway/v1/apigateway-api.json index 1a629d25923..ae8ce2fc612 100644 --- a/apigateway/v1/apigateway-api.json +++ b/apigateway/v1/apigateway-api.json @@ -1083,7 +1083,7 @@ } } }, - "revision": "20230308", + "revision": "20230426", "rootUrl": "https://apigateway.googleapis.com/", "schemas": { "ApigatewayApi": { @@ -1555,7 +1555,7 @@ "type": "object" }, "ApigatewayLocation": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "ApigatewayLocation", "properties": { "displayName": { diff --git a/apigateway/v1/apigateway-gen.go b/apigateway/v1/apigateway-gen.go index d60e72a06df..cada34eeed6 100644 --- a/apigateway/v1/apigateway-gen.go +++ b/apigateway/v1/apigateway-gen.go @@ -971,7 +971,7 @@ func (s *ApigatewayListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ApigatewayLocation: A resource that represents Google Cloud Platform +// ApigatewayLocation: A resource that represents a Google Cloud // location. type ApigatewayLocation struct { // DisplayName: The friendly name for this location, typically a nearby diff --git a/apigateway/v1beta/apigateway-api.json b/apigateway/v1beta/apigateway-api.json index 1fd0e3af013..e71210c3f5e 100644 --- a/apigateway/v1beta/apigateway-api.json +++ b/apigateway/v1beta/apigateway-api.json @@ -1083,7 +1083,7 @@ } } }, - "revision": "20230308", + "revision": "20230426", "rootUrl": "https://apigateway.googleapis.com/", "schemas": { "ApigatewayApi": { @@ -1581,7 +1581,7 @@ "type": "object" }, "ApigatewayLocation": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "ApigatewayLocation", "properties": { "displayName": { diff --git a/apigateway/v1beta/apigateway-gen.go b/apigateway/v1beta/apigateway-gen.go index 3d143e09062..459f2b9e284 100644 --- a/apigateway/v1beta/apigateway-gen.go +++ b/apigateway/v1beta/apigateway-gen.go @@ -1044,7 +1044,7 @@ func (s *ApigatewayListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ApigatewayLocation: A resource that represents Google Cloud Platform +// ApigatewayLocation: A resource that represents a Google Cloud // location. type ApigatewayLocation struct { // DisplayName: The friendly name for this location, typically a nearby diff --git a/apigee/v1/apigee-api.json b/apigee/v1/apigee-api.json index 92c7d2f1c96..294fce0c68b 100644 --- a/apigee/v1/apigee-api.json +++ b/apigee/v1/apigee-api.json @@ -8621,7 +8621,7 @@ }, "path": "v1/{+name}", "response": { - "$ref": "GoogleCloudApigeeV1ApiResponseWrapper" + "$ref": "GoogleCloudApigeeV1DeleteResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" @@ -8744,7 +8744,7 @@ } } }, - "revision": "20230421", + "revision": "20230508", "rootUrl": "https://apigee.googleapis.com/", "schemas": { "EdgeConfigstoreBundleBadBundle": { @@ -9002,6 +9002,10 @@ "description": "the Api category resource.", "id": "GoogleCloudApigeeV1ApiCategoryData", "properties": { + "gcpResource": { + "description": "GCP name of api category resource.", + "type": "string" + }, "id": { "description": "ID of the category (a UUID).", "type": "string" @@ -9336,28 +9340,6 @@ }, "type": "object" }, - "GoogleCloudApigeeV1ApiResponseWrapper": { - "id": "GoogleCloudApigeeV1ApiResponseWrapper", - "properties": { - "errorCode": { - "description": "ID that can be used to find errors in the log files.", - "type": "string" - }, - "message": { - "description": "Description of the operation.", - "type": "string" - }, - "requestId": { - "description": "ID that can be used to find request details in the log files.", - "type": "string" - }, - "status": { - "description": "Status of the operation.", - "type": "string" - } - }, - "type": "object" - }, "GoogleCloudApigeeV1ApiSecurityConfig": { "description": "Configurations of the API Security add-on.", "id": "GoogleCloudApigeeV1ApiSecurityConfig", @@ -10410,6 +10392,33 @@ }, "type": "object" }, + "GoogleCloudApigeeV1DeleteResponse": { + "description": "Response for certain delete operations.", + "id": "GoogleCloudApigeeV1DeleteResponse", + "properties": { + "errorCode": { + "description": "ID that can be used to find errors in the log files.", + "type": "string" + }, + "gcpResource": { + "description": "GCP name of deleted resource.", + "type": "string" + }, + "message": { + "description": "Description of the operation.", + "type": "string" + }, + "requestId": { + "description": "ID that can be used to find request details in the log files.", + "type": "string" + }, + "status": { + "description": "Status of the operation.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudApigeeV1Deployment": { "id": "GoogleCloudApigeeV1Deployment", "properties": { diff --git a/apigee/v1/apigee-gen.go b/apigee/v1/apigee-gen.go index 128bd7b38b0..da8c0ad0e0f 100644 --- a/apigee/v1/apigee-gen.go +++ b/apigee/v1/apigee-gen.go @@ -1607,6 +1607,9 @@ func (s *GoogleCloudApigeeV1ApiCategory) MarshalJSON() ([]byte, error) { // GoogleCloudApigeeV1ApiCategoryData: the Api category resource. type GoogleCloudApigeeV1ApiCategoryData struct { + // GcpResource: GCP name of api category resource. + GcpResource string `json:"gcpResource,omitempty"` + // Id: ID of the category (a UUID). Id string `json:"id,omitempty"` @@ -1620,7 +1623,7 @@ type GoogleCloudApigeeV1ApiCategoryData struct { // epoch. UpdateTime int64 `json:"updateTime,omitempty,string"` - // ForceSendFields is a list of field names (e.g. "Id") to + // ForceSendFields is a list of field names (e.g. "GcpResource") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -1628,10 +1631,10 @@ type GoogleCloudApigeeV1ApiCategoryData struct { // This may be used to include empty fields in Patch requests. 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. However, any field with an - // empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "GcpResource") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` @@ -2043,47 +2046,6 @@ func (s *GoogleCloudApigeeV1ApiProxyRevision) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -type GoogleCloudApigeeV1ApiResponseWrapper struct { - // ErrorCode: ID that can be used to find errors in the log files. - ErrorCode string `json:"errorCode,omitempty"` - - // Message: Description of the operation. - Message string `json:"message,omitempty"` - - // RequestId: ID that can be used to find request details in the log - // files. - RequestId string `json:"requestId,omitempty"` - - // Status: Status of the operation. - 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. "ErrorCode") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "ErrorCode") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *GoogleCloudApigeeV1ApiResponseWrapper) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudApigeeV1ApiResponseWrapper - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleCloudApigeeV1ApiSecurityConfig: Configurations of the API // Security add-on. type GoogleCloudApigeeV1ApiSecurityConfig struct { @@ -3602,6 +3564,52 @@ func (s *GoogleCloudApigeeV1DeleteCustomReportResponse) MarshalJSON() ([]byte, e return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudApigeeV1DeleteResponse: Response for certain delete +// operations. +type GoogleCloudApigeeV1DeleteResponse struct { + // ErrorCode: ID that can be used to find errors in the log files. + ErrorCode string `json:"errorCode,omitempty"` + + // GcpResource: GCP name of deleted resource. + GcpResource string `json:"gcpResource,omitempty"` + + // Message: Description of the operation. + Message string `json:"message,omitempty"` + + // RequestId: ID that can be used to find request details in the log + // files. + RequestId string `json:"requestId,omitempty"` + + // Status: Status of the operation. + 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. "ErrorCode") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ErrorCode") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudApigeeV1DeleteResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudApigeeV1DeleteResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + type GoogleCloudApigeeV1Deployment struct { // ApiProxy: API proxy. ApiProxy string `json:"apiProxy,omitempty"` @@ -54880,14 +54888,14 @@ func (c *OrganizationsSitesApicategoriesDeleteCall) doRequest(alt string) (*http } // Do executes the "apigee.organizations.sites.apicategories.delete" call. -// Exactly one of *GoogleCloudApigeeV1ApiResponseWrapper or error will -// be non-nil. Any non-2xx status code is an error. Response headers are -// in either -// *GoogleCloudApigeeV1ApiResponseWrapper.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 *OrganizationsSitesApicategoriesDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApigeeV1ApiResponseWrapper, error) { +// Exactly one of *GoogleCloudApigeeV1DeleteResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *GoogleCloudApigeeV1DeleteResponse.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 *OrganizationsSitesApicategoriesDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleCloudApigeeV1DeleteResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -54906,7 +54914,7 @@ func (c *OrganizationsSitesApicategoriesDeleteCall) Do(opts ...googleapi.CallOpt if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudApigeeV1ApiResponseWrapper{ + ret := &GoogleCloudApigeeV1DeleteResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -54936,7 +54944,7 @@ func (c *OrganizationsSitesApicategoriesDeleteCall) Do(opts ...googleapi.CallOpt // }, // "path": "v1/{+name}", // "response": { - // "$ref": "GoogleCloudApigeeV1ApiResponseWrapper" + // "$ref": "GoogleCloudApigeeV1DeleteResponse" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" diff --git a/appengine/v1/appengine-api.json b/appengine/v1/appengine-api.json index 448819c5e71..f0842c4a168 100644 --- a/appengine/v1/appengine-api.json +++ b/appengine/v1/appengine-api.json @@ -1687,7 +1687,7 @@ } } }, - "revision": "20230403", + "revision": "20230501", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "ApiConfigHandler": { @@ -2815,7 +2815,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/appengine/v1/appengine-gen.go b/appengine/v1/appengine-gen.go index 7c4b50994f7..824b4b39615 100644 --- a/appengine/v1/appengine-gen.go +++ b/appengine/v1/appengine-gen.go @@ -2262,7 +2262,7 @@ func (s *LivenessCheck) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/appengine/v1alpha/appengine-api.json b/appengine/v1alpha/appengine-api.json index 8eb06c1a838..c0cc7bcfc1a 100644 --- a/appengine/v1alpha/appengine-api.json +++ b/appengine/v1alpha/appengine-api.json @@ -887,7 +887,7 @@ } } }, - "revision": "20230403", + "revision": "20230501", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "AuthorizedCertificate": { @@ -1147,7 +1147,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/appengine/v1alpha/appengine-gen.go b/appengine/v1alpha/appengine-gen.go index e6666c9b72a..af882afddb8 100644 --- a/appengine/v1alpha/appengine-gen.go +++ b/appengine/v1alpha/appengine-gen.go @@ -794,7 +794,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/appengine/v1beta/appengine-api.json b/appengine/v1beta/appengine-api.json index 20c4585d65c..ee9662f96d1 100644 --- a/appengine/v1beta/appengine-api.json +++ b/appengine/v1beta/appengine-api.json @@ -1898,7 +1898,7 @@ } } }, - "revision": "20230403", + "revision": "20230501", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "ApiConfigHandler": { @@ -3077,7 +3077,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/appengine/v1beta/appengine-gen.go b/appengine/v1beta/appengine-gen.go index f996d494210..6d81f81b796 100644 --- a/appengine/v1beta/appengine-gen.go +++ b/appengine/v1beta/appengine-gen.go @@ -2371,7 +2371,7 @@ func (s *LivenessCheck) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/artifactregistry/v1/artifactregistry-api.json b/artifactregistry/v1/artifactregistry-api.json index 8394ec7351d..3dfc4e15175 100644 --- a/artifactregistry/v1/artifactregistry-api.json +++ b/artifactregistry/v1/artifactregistry-api.json @@ -803,6 +803,78 @@ } } }, + "googetArtifacts": { + "methods": { + "import": { + "description": "Imports GooGet artifacts. The returned Operation will complete once the resources are imported. Package, Version, and File resources are created based on the imported artifacts. Imported artifacts that conflict with existing resources are ignored.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/googetArtifacts:import", + "httpMethod": "POST", + "id": "artifactregistry.projects.locations.repositories.googetArtifacts.import", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "The name of the parent resource where the artifacts will be imported.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/googetArtifacts:import", + "request": { + "$ref": "ImportGoogetArtifactsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "upload": { + "description": "Directly uploads a GooGet artifact. The returned Operation will complete once the resources are uploaded. Package, Version, and File resources are created based on the imported artifact. Imported artifacts that conflict with existing resources are ignored.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/googetArtifacts:create", + "httpMethod": "POST", + "id": "artifactregistry.projects.locations.repositories.googetArtifacts.upload", + "mediaUpload": { + "accept": [ + "*/*" + ], + "protocols": { + "simple": { + "multipart": true, + "path": "/upload/v1/{+parent}/googetArtifacts:create" + } + } + }, + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "The name of the parent resource where the artifacts will be uploaded.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/googetArtifacts:create", + "request": { + "$ref": "UploadGoogetArtifactRequest" + }, + "response": { + "$ref": "UploadGoogetArtifactMediaResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ], + "supportsMediaUpload": true + } + } + }, "kfpArtifacts": { "methods": { "upload": { @@ -1517,7 +1589,7 @@ } } }, - "revision": "20230317", + "revision": "20230502", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "AptArtifact": { @@ -1852,6 +1924,35 @@ }, "type": "object" }, + "ImportGoogetArtifactsGcsSource": { + "description": "Google Cloud Storage location where the artifacts currently reside.", + "id": "ImportGoogetArtifactsGcsSource", + "properties": { + "uris": { + "description": "Cloud Storage paths URI (e.g., gs://my_bucket/my_object).", + "items": { + "type": "string" + }, + "type": "array" + }, + "useWildcards": { + "description": "Supports URI wildcards for matching multiple objects from a single URI.", + "type": "boolean" + } + }, + "type": "object" + }, + "ImportGoogetArtifactsRequest": { + "description": "The request to import new googet artifacts.", + "id": "ImportGoogetArtifactsRequest", + "properties": { + "gcsSource": { + "$ref": "ImportGoogetArtifactsGcsSource", + "description": "Google Cloud Storage location where input content is located." + } + }, + "type": "object" + }, "ImportYumArtifactsErrorInfo": { "description": "Error information explaining why a package was not imported.", "id": "ImportYumArtifactsErrorInfo", @@ -2518,6 +2619,7 @@ "NPM", "APT", "YUM", + "GOOGET", "PYTHON", "KFP" ], @@ -2528,6 +2630,7 @@ "NPM package format.", "APT package format.", "YUM package format.", + "GooGet package format.", "Python package format.", "Kubeflow Pipelines package format." ], @@ -2714,6 +2817,23 @@ }, "type": "object" }, + "UploadGoogetArtifactMediaResponse": { + "description": "The response to upload an artifact.", + "id": "UploadGoogetArtifactMediaResponse", + "properties": { + "operation": { + "$ref": "Operation", + "description": "Operation to be returned to the user." + } + }, + "type": "object" + }, + "UploadGoogetArtifactRequest": { + "description": "The request to upload an artifact.", + "id": "UploadGoogetArtifactRequest", + "properties": {}, + "type": "object" + }, "UploadKfpArtifactMediaResponse": { "description": "The response to upload an artifact.", "id": "UploadKfpArtifactMediaResponse", diff --git a/artifactregistry/v1/artifactregistry-gen.go b/artifactregistry/v1/artifactregistry-gen.go index 19857e20680..bdd942e2396 100644 --- a/artifactregistry/v1/artifactregistry-gen.go +++ b/artifactregistry/v1/artifactregistry-gen.go @@ -188,6 +188,7 @@ func NewProjectsLocationsRepositoriesService(s *Service) *ProjectsLocationsRepos rs.AptArtifacts = NewProjectsLocationsRepositoriesAptArtifactsService(s) rs.DockerImages = NewProjectsLocationsRepositoriesDockerImagesService(s) rs.Files = NewProjectsLocationsRepositoriesFilesService(s) + rs.GoogetArtifacts = NewProjectsLocationsRepositoriesGoogetArtifactsService(s) rs.KfpArtifacts = NewProjectsLocationsRepositoriesKfpArtifactsService(s) rs.MavenArtifacts = NewProjectsLocationsRepositoriesMavenArtifactsService(s) rs.NpmPackages = NewProjectsLocationsRepositoriesNpmPackagesService(s) @@ -206,6 +207,8 @@ type ProjectsLocationsRepositoriesService struct { Files *ProjectsLocationsRepositoriesFilesService + GoogetArtifacts *ProjectsLocationsRepositoriesGoogetArtifactsService + KfpArtifacts *ProjectsLocationsRepositoriesKfpArtifactsService MavenArtifacts *ProjectsLocationsRepositoriesMavenArtifactsService @@ -246,6 +249,15 @@ type ProjectsLocationsRepositoriesFilesService struct { s *Service } +func NewProjectsLocationsRepositoriesGoogetArtifactsService(s *Service) *ProjectsLocationsRepositoriesGoogetArtifactsService { + rs := &ProjectsLocationsRepositoriesGoogetArtifactsService{s: s} + return rs +} + +type ProjectsLocationsRepositoriesGoogetArtifactsService struct { + s *Service +} + func NewProjectsLocationsRepositoriesKfpArtifactsService(s *Service) *ProjectsLocationsRepositoriesKfpArtifactsService { rs := &ProjectsLocationsRepositoriesKfpArtifactsService{s: s} return rs @@ -918,6 +930,69 @@ func (s *ImportAptArtifactsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ImportGoogetArtifactsGcsSource: Google Cloud Storage location where +// the artifacts currently reside. +type ImportGoogetArtifactsGcsSource struct { + // Uris: Cloud Storage paths URI (e.g., gs://my_bucket/my_object). + Uris []string `json:"uris,omitempty"` + + // UseWildcards: Supports URI wildcards for matching multiple objects + // from a single URI. + UseWildcards bool `json:"useWildcards,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Uris") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Uris") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ImportGoogetArtifactsGcsSource) MarshalJSON() ([]byte, error) { + type NoMethod ImportGoogetArtifactsGcsSource + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ImportGoogetArtifactsRequest: The request to import new googet +// artifacts. +type ImportGoogetArtifactsRequest struct { + // GcsSource: Google Cloud Storage location where input content is + // located. + GcsSource *ImportGoogetArtifactsGcsSource `json:"gcsSource,omitempty"` + + // ForceSendFields is a list of field names (e.g. "GcsSource") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "GcsSource") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ImportGoogetArtifactsRequest) MarshalJSON() ([]byte, error) { + type NoMethod ImportGoogetArtifactsRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ImportYumArtifactsErrorInfo: Error information explaining why a // package was not imported. type ImportYumArtifactsErrorInfo struct { @@ -2140,6 +2215,7 @@ type Repository struct { // "NPM" - NPM package format. // "APT" - APT package format. // "YUM" - YUM package format. + // "GOOGET" - GooGet package format. // "PYTHON" - Python package format. // "KFP" - Kubeflow Pipelines package format. Format string `json:"format,omitempty"` @@ -2481,6 +2557,43 @@ func (s *UploadAptArtifactResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// UploadGoogetArtifactMediaResponse: The response to upload an +// artifact. +type UploadGoogetArtifactMediaResponse struct { + // Operation: Operation to be returned to the user. + Operation *Operation `json:"operation,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Operation") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Operation") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *UploadGoogetArtifactMediaResponse) MarshalJSON() ([]byte, error) { + type NoMethod UploadGoogetArtifactMediaResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// UploadGoogetArtifactRequest: The request to upload an artifact. +type UploadGoogetArtifactRequest struct { +} + // UploadKfpArtifactMediaResponse: The response to upload an artifact. type UploadKfpArtifactMediaResponse struct { // Operation: Operation that will be returned to the user. @@ -6307,6 +6420,379 @@ func (c *ProjectsLocationsRepositoriesFilesListCall) Pages(ctx context.Context, } } +// method id "artifactregistry.projects.locations.repositories.googetArtifacts.import": + +type ProjectsLocationsRepositoriesGoogetArtifactsImportCall struct { + s *Service + parent string + importgoogetartifactsrequest *ImportGoogetArtifactsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Import: Imports GooGet artifacts. The returned Operation will +// complete once the resources are imported. Package, Version, and File +// resources are created based on the imported artifacts. Imported +// artifacts that conflict with existing resources are ignored. +// +// - parent: The name of the parent resource where the artifacts will be +// imported. +func (r *ProjectsLocationsRepositoriesGoogetArtifactsService) Import(parent string, importgoogetartifactsrequest *ImportGoogetArtifactsRequest) *ProjectsLocationsRepositoriesGoogetArtifactsImportCall { + c := &ProjectsLocationsRepositoriesGoogetArtifactsImportCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.importgoogetartifactsrequest = importgoogetartifactsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsRepositoriesGoogetArtifactsImportCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesGoogetArtifactsImportCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsRepositoriesGoogetArtifactsImportCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesGoogetArtifactsImportCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsRepositoriesGoogetArtifactsImportCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRepositoriesGoogetArtifactsImportCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.importgoogetartifactsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/googetArtifacts:import") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "artifactregistry.projects.locations.repositories.googetArtifacts.import" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsRepositoriesGoogetArtifactsImportCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Imports GooGet artifacts. The returned Operation will complete once the resources are imported. Package, Version, and File resources are created based on the imported artifacts. Imported artifacts that conflict with existing resources are ignored.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/googetArtifacts:import", + // "httpMethod": "POST", + // "id": "artifactregistry.projects.locations.repositories.googetArtifacts.import", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "The name of the parent resource where the artifacts will be imported.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/googetArtifacts:import", + // "request": { + // "$ref": "ImportGoogetArtifactsRequest" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "artifactregistry.projects.locations.repositories.googetArtifacts.upload": + +type ProjectsLocationsRepositoriesGoogetArtifactsUploadCall struct { + s *Service + parent string + uploadgoogetartifactrequest *UploadGoogetArtifactRequest + urlParams_ gensupport.URLParams + mediaInfo_ *gensupport.MediaInfo + ctx_ context.Context + header_ http.Header +} + +// Upload: Directly uploads a GooGet artifact. The returned Operation +// will complete once the resources are uploaded. Package, Version, and +// File resources are created based on the imported artifact. Imported +// artifacts that conflict with existing resources are ignored. +// +// - parent: The name of the parent resource where the artifacts will be +// uploaded. +func (r *ProjectsLocationsRepositoriesGoogetArtifactsService) Upload(parent string, uploadgoogetartifactrequest *UploadGoogetArtifactRequest) *ProjectsLocationsRepositoriesGoogetArtifactsUploadCall { + c := &ProjectsLocationsRepositoriesGoogetArtifactsUploadCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.uploadgoogetartifactrequest = uploadgoogetartifactrequest + return c +} + +// Media specifies the media to upload in one or more chunks. The chunk +// size may be controlled by supplying a MediaOption generated by +// googleapi.ChunkSize. The chunk size defaults to +// googleapi.DefaultUploadChunkSize.The Content-Type header used in the +// upload request will be determined by sniffing the contents of r, +// unless a MediaOption generated by googleapi.ContentType is +// supplied. +// At most one of Media and ResumableMedia may be set. +func (c *ProjectsLocationsRepositoriesGoogetArtifactsUploadCall) Media(r io.Reader, options ...googleapi.MediaOption) *ProjectsLocationsRepositoriesGoogetArtifactsUploadCall { + c.mediaInfo_ = gensupport.NewInfoFromMedia(r, options) + return c +} + +// ResumableMedia specifies the media to upload in chunks and can be +// canceled with ctx. +// +// Deprecated: use Media instead. +// +// At most one of Media and ResumableMedia may be set. mediaType +// identifies the MIME media type of the upload, such as "image/png". If +// mediaType is "", it will be auto-detected. The provided ctx will +// supersede any context previously provided to the Context method. +func (c *ProjectsLocationsRepositoriesGoogetArtifactsUploadCall) ResumableMedia(ctx context.Context, r io.ReaderAt, size int64, mediaType string) *ProjectsLocationsRepositoriesGoogetArtifactsUploadCall { + c.ctx_ = ctx + c.mediaInfo_ = gensupport.NewInfoFromResumableMedia(r, size, mediaType) + return c +} + +// ProgressUpdater provides a callback function that will be called +// after every chunk. It should be a low-latency function in order to +// not slow down the upload operation. This should only be called when +// using ResumableMedia (as opposed to Media). +func (c *ProjectsLocationsRepositoriesGoogetArtifactsUploadCall) ProgressUpdater(pu googleapi.ProgressUpdater) *ProjectsLocationsRepositoriesGoogetArtifactsUploadCall { + c.mediaInfo_.SetProgressUpdater(pu) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsRepositoriesGoogetArtifactsUploadCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesGoogetArtifactsUploadCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +// This context will supersede any context previously provided to the +// ResumableMedia method. +func (c *ProjectsLocationsRepositoriesGoogetArtifactsUploadCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesGoogetArtifactsUploadCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsRepositoriesGoogetArtifactsUploadCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRepositoriesGoogetArtifactsUploadCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.uploadgoogetartifactrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/googetArtifacts:create") + if c.mediaInfo_ != nil { + urls = googleapi.ResolveRelative(c.s.BasePath, "/upload/v1/{+parent}/googetArtifacts:create") + c.urlParams_.Set("uploadType", c.mediaInfo_.UploadType()) + } + if body == nil { + body = new(bytes.Buffer) + reqHeaders.Set("Content-Type", "application/json") + } + body, getBody, cleanup := c.mediaInfo_.UploadRequest(reqHeaders, body) + defer cleanup() + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + req.GetBody = getBody + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "artifactregistry.projects.locations.repositories.googetArtifacts.upload" call. +// Exactly one of *UploadGoogetArtifactMediaResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *UploadGoogetArtifactMediaResponse.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 *ProjectsLocationsRepositoriesGoogetArtifactsUploadCall) Do(opts ...googleapi.CallOption) (*UploadGoogetArtifactMediaResponse, 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) + } + rx := c.mediaInfo_.ResumableUpload(res.Header.Get("Location")) + if rx != nil { + rx.Client = c.s.client + rx.UserAgent = c.s.userAgent() + ctx := c.ctx_ + if ctx == nil { + ctx = context.TODO() + } + res, err = rx.Upload(ctx) + if err != nil { + return nil, err + } + defer res.Body.Close() + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + } + ret := &UploadGoogetArtifactMediaResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Directly uploads a GooGet artifact. The returned Operation will complete once the resources are uploaded. Package, Version, and File resources are created based on the imported artifact. Imported artifacts that conflict with existing resources are ignored.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/googetArtifacts:create", + // "httpMethod": "POST", + // "id": "artifactregistry.projects.locations.repositories.googetArtifacts.upload", + // "mediaUpload": { + // "accept": [ + // "*/*" + // ], + // "protocols": { + // "simple": { + // "multipart": true, + // "path": "/upload/v1/{+parent}/googetArtifacts:create" + // } + // } + // }, + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "The name of the parent resource where the artifacts will be uploaded.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/googetArtifacts:create", + // "request": { + // "$ref": "UploadGoogetArtifactRequest" + // }, + // "response": { + // "$ref": "UploadGoogetArtifactMediaResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ], + // "supportsMediaUpload": true + // } + +} + // method id "artifactregistry.projects.locations.repositories.kfpArtifacts.upload": type ProjectsLocationsRepositoriesKfpArtifactsUploadCall struct { diff --git a/artifactregistry/v1beta1/artifactregistry-api.json b/artifactregistry/v1beta1/artifactregistry-api.json index 0f38497dc7d..d03b484e817 100644 --- a/artifactregistry/v1beta1/artifactregistry-api.json +++ b/artifactregistry/v1beta1/artifactregistry-api.json @@ -929,7 +929,7 @@ } } }, - "revision": "20230307", + "revision": "20230502", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "Binding": { @@ -1297,6 +1297,7 @@ "NPM", "APT", "YUM", + "GOOGET", "PYTHON" ], "enumDescriptions": [ @@ -1306,6 +1307,7 @@ "NPM package format.", "APT package format.", "YUM package format.", + "GooGet package format.", "Python package format." ], "type": "string" diff --git a/artifactregistry/v1beta1/artifactregistry-gen.go b/artifactregistry/v1beta1/artifactregistry-gen.go index acdcfbcd0c0..8c7a1e9ef26 100644 --- a/artifactregistry/v1beta1/artifactregistry-gen.go +++ b/artifactregistry/v1beta1/artifactregistry-gen.go @@ -973,6 +973,7 @@ type Repository struct { // "NPM" - NPM package format. // "APT" - APT package format. // "YUM" - YUM package format. + // "GOOGET" - GooGet package format. // "PYTHON" - Python package format. Format string `json:"format,omitempty"` diff --git a/artifactregistry/v1beta2/artifactregistry-api.json b/artifactregistry/v1beta2/artifactregistry-api.json index e8e3de51832..06832c43919 100644 --- a/artifactregistry/v1beta2/artifactregistry-api.json +++ b/artifactregistry/v1beta2/artifactregistry-api.json @@ -1135,7 +1135,7 @@ } } }, - "revision": "20230307", + "revision": "20230502", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "AptArtifact": { @@ -1751,6 +1751,7 @@ "NPM", "APT", "YUM", + "GOOGET", "PYTHON" ], "enumDescriptions": [ @@ -1760,6 +1761,7 @@ "NPM package format.", "APT package format.", "YUM package format.", + "GooGet package format.", "Python package format." ], "type": "string" diff --git a/artifactregistry/v1beta2/artifactregistry-gen.go b/artifactregistry/v1beta2/artifactregistry-gen.go index e846d1cf119..5c9c3793cfb 100644 --- a/artifactregistry/v1beta2/artifactregistry-gen.go +++ b/artifactregistry/v1beta2/artifactregistry-gen.go @@ -1411,6 +1411,7 @@ type Repository struct { // "NPM" - NPM package format. // "APT" - APT package format. // "YUM" - YUM package format. + // "GOOGET" - GooGet package format. // "PYTHON" - Python package format. Format string `json:"format,omitempty"` diff --git a/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-api.json b/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-api.json index 5fd19b94c6f..127e52be53d 100644 --- a/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-api.json +++ b/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-api.json @@ -1307,7 +1307,7 @@ } } }, - "revision": "20220907", + "revision": "20230508", "rootUrl": "https://authorizedbuyersmarketplace.googleapis.com/", "schemas": { "AcceptProposalRequest": { @@ -2515,7 +2515,7 @@ "description": "Fixed price for the deal." }, "guaranteedLooks": { - "description": "Count of guaranteed looks.", + "description": "Count of guaranteed looks. For CPD deals, buyer changes to guaranteed_looks will be ignored.", "format": "int64", "type": "string" }, @@ -2525,7 +2525,7 @@ "type": "string" }, "minimumDailyLooks": { - "description": "Daily minimum looks for CPD deal types.", + "description": "Daily minimum looks for CPD deal types. For CPD deals, buyer should negotiate on this field instead of guaranteed_looks.", "format": "int64", "type": "string" }, diff --git a/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-gen.go b/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-gen.go index a2b1b4e5212..0ec568e31d5 100644 --- a/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-gen.go +++ b/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-gen.go @@ -2103,14 +2103,17 @@ type ProgrammaticGuaranteedTerms struct { // FixedPrice: Fixed price for the deal. FixedPrice *Price `json:"fixedPrice,omitempty"` - // GuaranteedLooks: Count of guaranteed looks. + // GuaranteedLooks: Count of guaranteed looks. For CPD deals, buyer + // changes to guaranteed_looks will be ignored. GuaranteedLooks int64 `json:"guaranteedLooks,omitempty,string"` // ImpressionCap: The lifetime impression cap for CPM Sponsorship deals. // Deal will stop serving when cap is reached. ImpressionCap int64 `json:"impressionCap,omitempty,string"` - // MinimumDailyLooks: Daily minimum looks for CPD deal types. + // MinimumDailyLooks: Daily minimum looks for CPD deal types. For CPD + // deals, buyer should negotiate on this field instead of + // guaranteed_looks. MinimumDailyLooks int64 `json:"minimumDailyLooks,omitempty,string"` // PercentShareOfVoice: For sponsorship deals, this is the percentage of diff --git a/baremetalsolution/v2/baremetalsolution-api.json b/baremetalsolution/v2/baremetalsolution-api.json index fe06e0f25c1..92903fdc2a6 100644 --- a/baremetalsolution/v2/baremetalsolution-api.json +++ b/baremetalsolution/v2/baremetalsolution-api.json @@ -1605,7 +1605,7 @@ } } }, - "revision": "20230315", + "revision": "20230501", "rootUrl": "https://baremetalsolution.googleapis.com/", "schemas": { "AllowedClient": { @@ -2240,7 +2240,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/baremetalsolution/v2/baremetalsolution-gen.go b/baremetalsolution/v2/baremetalsolution-gen.go index bc6daa307bb..8bbf88c8d5f 100644 --- a/baremetalsolution/v2/baremetalsolution-gen.go +++ b/baremetalsolution/v2/baremetalsolution-gen.go @@ -1186,7 +1186,7 @@ func (s *ListVolumesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/batch/v1/batch-api.json b/batch/v1/batch-api.json index 8f3f9479b5d..e1284bd3780 100644 --- a/batch/v1/batch-api.json +++ b/batch/v1/batch-api.json @@ -556,7 +556,7 @@ } } }, - "revision": "20230412", + "revision": "20230426", "rootUrl": "https://batch.googleapis.com/", "schemas": { "Accelerator": { @@ -1351,7 +1351,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/batch/v1/batch-gen.go b/batch/v1/batch-gen.go index f2c4861b7a3..5ed8ba5ac26 100644 --- a/batch/v1/batch-gen.go +++ b/batch/v1/batch-gen.go @@ -1428,7 +1428,7 @@ func (s *ListTasksResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/beyondcorp/v1/beyondcorp-api.json b/beyondcorp/v1/beyondcorp-api.json index 31ed4e6de4b..37d92300c28 100644 --- a/beyondcorp/v1/beyondcorp-api.json +++ b/beyondcorp/v1/beyondcorp-api.json @@ -105,6 +105,202 @@ }, "protocol": "rest", "resources": { + "organizations": { + "resources": { + "locations": { + "resources": { + "global": { + "resources": { + "tenants": { + "methods": { + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/organizations/{organizationsId}/locations/global/tenants/{tenantsId}:getIamPolicy", + "httpMethod": "GET", + "id": "beyondcorp.organizations.locations.global.tenants.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. 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).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "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.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "GoogleIamV1Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/organizations/{organizationsId}/locations/global/tenants/{tenantsId}:setIamPolicy", + "httpMethod": "POST", + "id": "beyondcorp.organizations.locations.global.tenants.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "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.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "GoogleIamV1SetIamPolicyRequest" + }, + "response": { + "$ref": "GoogleIamV1Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/organizations/{organizationsId}/locations/global/tenants/{tenantsId}:testIamPermissions", + "httpMethod": "POST", + "id": "beyondcorp.organizations.locations.global.tenants.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "GoogleIamV1TestIamPermissionsRequest" + }, + "response": { + "$ref": "GoogleIamV1TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "proxyConfigs": { + "methods": { + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/organizations/{organizationsId}/locations/global/tenants/{tenantsId}/proxyConfigs/{proxyConfigsId}:getIamPolicy", + "httpMethod": "GET", + "id": "beyondcorp.organizations.locations.global.tenants.proxyConfigs.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. 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).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "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.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+/proxyConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "GoogleIamV1Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/organizations/{organizationsId}/locations/global/tenants/{tenantsId}/proxyConfigs/{proxyConfigsId}:setIamPolicy", + "httpMethod": "POST", + "id": "beyondcorp.organizations.locations.global.tenants.proxyConfigs.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "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.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+/proxyConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "GoogleIamV1SetIamPolicyRequest" + }, + "response": { + "$ref": "GoogleIamV1Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/organizations/{organizationsId}/locations/global/tenants/{tenantsId}/proxyConfigs/{proxyConfigsId}:testIamPermissions", + "httpMethod": "POST", + "id": "beyondcorp.organizations.locations.global.tenants.proxyConfigs.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+/proxyConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "GoogleIamV1TestIamPermissionsRequest" + }, + "response": { + "$ref": "GoogleIamV1TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + } + } + } + } + }, "projects": { "resources": { "locations": { @@ -1394,7 +1590,7 @@ } } }, - "revision": "20230406", + "revision": "20230501", "rootUrl": "https://beyondcorp.googleapis.com/", "schemas": { "AllocatedConnection": { @@ -2605,6 +2801,94 @@ "properties": {}, "type": "object" }, + "GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerServiceOperationMetadata": { + "description": "Represents the metadata of the long-running operation.", + "id": "GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerServiceOperationMetadata", + "properties": { + "apiVersion": { + "description": "Output only. API version used to start the operation.", + "readOnly": true, + "type": "string" + }, + "createTime": { + "description": "Output only. The time the operation was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "endTime": { + "description": "Output only. The time the operation finished running.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "requestedCancellation": { + "description": "Output only. Identifies whether the caller has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "readOnly": true, + "type": "boolean" + }, + "statusMessage": { + "description": "Output only. Human-readable status of the operation, if any.", + "readOnly": true, + "type": "string" + }, + "target": { + "description": "Output only. Server-defined resource path for the target of the operation.", + "readOnly": true, + "type": "string" + }, + "verb": { + "description": "Output only. Name of the verb executed by the operation.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudBeyondcorpPartnerservicesV1mainPartnerServiceOperationMetadata": { + "description": "Represents the metadata of the long-running operation.", + "id": "GoogleCloudBeyondcorpPartnerservicesV1mainPartnerServiceOperationMetadata", + "properties": { + "apiVersion": { + "description": "Output only. API version used to start the operation.", + "readOnly": true, + "type": "string" + }, + "createTime": { + "description": "Output only. The time the operation was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "endTime": { + "description": "Output only. The time the operation finished running.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "requestedCancellation": { + "description": "Output only. Identifies whether the caller has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "readOnly": true, + "type": "boolean" + }, + "statusMessage": { + "description": "Output only. Human-readable status of the operation, if any.", + "readOnly": true, + "type": "string" + }, + "target": { + "description": "Output only. Server-defined resource path for the target of the operation.", + "readOnly": true, + "type": "string" + }, + "verb": { + "description": "Output only. Name of the verb executed by the operation.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudLocationListLocationsResponse": { "description": "The response message for Locations.ListLocations.", "id": "GoogleCloudLocationListLocationsResponse", @@ -2624,7 +2908,7 @@ "type": "object" }, "GoogleCloudLocationLocation": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "GoogleCloudLocationLocation", "properties": { "displayName": { diff --git a/beyondcorp/v1/beyondcorp-gen.go b/beyondcorp/v1/beyondcorp-gen.go index c1583102465..38c37ff8d10 100644 --- a/beyondcorp/v1/beyondcorp-gen.go +++ b/beyondcorp/v1/beyondcorp-gen.go @@ -119,6 +119,7 @@ func New(client *http.Client) (*Service, error) { return nil, errors.New("client is nil") } s := &Service{client: client, BasePath: basePath} + s.Organizations = NewOrganizationsService(s) s.Projects = NewProjectsService(s) return s, nil } @@ -128,6 +129,8 @@ type Service struct { BasePath string // API endpoint base URL UserAgent string // optional additional User-Agent fragment + Organizations *OrganizationsService + Projects *ProjectsService } @@ -138,6 +141,63 @@ func (s *Service) userAgent() string { return googleapi.UserAgent + " " + s.UserAgent } +func NewOrganizationsService(s *Service) *OrganizationsService { + rs := &OrganizationsService{s: s} + rs.Locations = NewOrganizationsLocationsService(s) + return rs +} + +type OrganizationsService struct { + s *Service + + Locations *OrganizationsLocationsService +} + +func NewOrganizationsLocationsService(s *Service) *OrganizationsLocationsService { + rs := &OrganizationsLocationsService{s: s} + rs.Global = NewOrganizationsLocationsGlobalService(s) + return rs +} + +type OrganizationsLocationsService struct { + s *Service + + Global *OrganizationsLocationsGlobalService +} + +func NewOrganizationsLocationsGlobalService(s *Service) *OrganizationsLocationsGlobalService { + rs := &OrganizationsLocationsGlobalService{s: s} + rs.Tenants = NewOrganizationsLocationsGlobalTenantsService(s) + return rs +} + +type OrganizationsLocationsGlobalService struct { + s *Service + + Tenants *OrganizationsLocationsGlobalTenantsService +} + +func NewOrganizationsLocationsGlobalTenantsService(s *Service) *OrganizationsLocationsGlobalTenantsService { + rs := &OrganizationsLocationsGlobalTenantsService{s: s} + rs.ProxyConfigs = NewOrganizationsLocationsGlobalTenantsProxyConfigsService(s) + return rs +} + +type OrganizationsLocationsGlobalTenantsService struct { + s *Service + + ProxyConfigs *OrganizationsLocationsGlobalTenantsProxyConfigsService +} + +func NewOrganizationsLocationsGlobalTenantsProxyConfigsService(s *Service) *OrganizationsLocationsGlobalTenantsProxyConfigsService { + rs := &OrganizationsLocationsGlobalTenantsProxyConfigsService{s: s} + return rs +} + +type OrganizationsLocationsGlobalTenantsProxyConfigsService struct { + s *Service +} + func NewProjectsService(s *Service) *ProjectsService { rs := &ProjectsService{s: s} rs.Locations = NewProjectsLocationsService(s) @@ -1901,6 +1961,110 @@ func (s *GoogleCloudBeyondcorpConnectorsV1alphaContainerHealthDetails) MarshalJS type GoogleCloudBeyondcorpConnectorsV1alphaRemoteAgentDetails struct { } +// GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerServiceOperationMeta +// data: Represents the metadata of the long-running operation. +type GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerServiceOperationMetadata struct { + // ApiVersion: Output only. API version used to start the operation. + ApiVersion string `json:"apiVersion,omitempty"` + + // CreateTime: Output only. The time the operation was created. + CreateTime string `json:"createTime,omitempty"` + + // EndTime: Output only. The time the operation finished running. + EndTime string `json:"endTime,omitempty"` + + // RequestedCancellation: Output only. Identifies whether the caller has + // requested cancellation of the operation. Operations that have + // successfully been cancelled have Operation.error value with a + // google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`. + RequestedCancellation bool `json:"requestedCancellation,omitempty"` + + // StatusMessage: Output only. Human-readable status of the operation, + // if any. + StatusMessage string `json:"statusMessage,omitempty"` + + // Target: Output only. Server-defined resource path for the target of + // the operation. + Target string `json:"target,omitempty"` + + // Verb: Output only. Name of the verb executed by the operation. + Verb string `json:"verb,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ApiVersion") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ApiVersion") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerServiceOperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerServiceOperationMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudBeyondcorpPartnerservicesV1mainPartnerServiceOperationMetad +// ata: Represents the metadata of the long-running operation. +type GoogleCloudBeyondcorpPartnerservicesV1mainPartnerServiceOperationMetadata struct { + // ApiVersion: Output only. API version used to start the operation. + ApiVersion string `json:"apiVersion,omitempty"` + + // CreateTime: Output only. The time the operation was created. + CreateTime string `json:"createTime,omitempty"` + + // EndTime: Output only. The time the operation finished running. + EndTime string `json:"endTime,omitempty"` + + // RequestedCancellation: Output only. Identifies whether the caller has + // requested cancellation of the operation. Operations that have + // successfully been cancelled have Operation.error value with a + // google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`. + RequestedCancellation bool `json:"requestedCancellation,omitempty"` + + // StatusMessage: Output only. Human-readable status of the operation, + // if any. + StatusMessage string `json:"statusMessage,omitempty"` + + // Target: Output only. Server-defined resource path for the target of + // the operation. + Target string `json:"target,omitempty"` + + // Verb: Output only. Name of the verb executed by the operation. + Verb string `json:"verb,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ApiVersion") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ApiVersion") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudBeyondcorpPartnerservicesV1mainPartnerServiceOperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpPartnerservicesV1mainPartnerServiceOperationMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudLocationListLocationsResponse: The response message for // Locations.ListLocations. type GoogleCloudLocationListLocationsResponse struct { @@ -1938,8 +2102,8 @@ func (s *GoogleCloudLocationListLocationsResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudLocationLocation: A resource that represents Google Cloud -// Platform location. +// GoogleCloudLocationLocation: A resource that represents a Google +// Cloud location. type GoogleCloudLocationLocation struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -2708,6 +2872,952 @@ func (s *Tunnelv1ProtoTunnelerInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// method id "beyondcorp.organizations.locations.global.tenants.getIamPolicy": + +type OrganizationsLocationsGlobalTenantsGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - 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 *OrganizationsLocationsGlobalTenantsService) GetIamPolicy(resource string) *OrganizationsLocationsGlobalTenantsGetIamPolicyCall { + c := &OrganizationsLocationsGlobalTenantsGetIamPolicyCall{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 *OrganizationsLocationsGlobalTenantsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *OrganizationsLocationsGlobalTenantsGetIamPolicyCall { + 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 information. +func (c *OrganizationsLocationsGlobalTenantsGetIamPolicyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalTenantsGetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *OrganizationsLocationsGlobalTenantsGetIamPolicyCall) IfNoneMatch(entityTag string) *OrganizationsLocationsGlobalTenantsGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *OrganizationsLocationsGlobalTenantsGetIamPolicyCall) Context(ctx context.Context) *OrganizationsLocationsGlobalTenantsGetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *OrganizationsLocationsGlobalTenantsGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsGlobalTenantsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.organizations.locations.global.tenants.getIamPolicy" call. +// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *OrganizationsLocationsGlobalTenantsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, 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 := &GoogleIamV1Policy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/organizations/{organizationsId}/locations/global/tenants/{tenantsId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "beyondcorp.organizations.locations.global.tenants.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. 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).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "GoogleIamV1Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "beyondcorp.organizations.locations.global.tenants.setIamPolicy": + +type OrganizationsLocationsGlobalTenantsSetIamPolicyCall struct { + s *Service + resource string + googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - 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 *OrganizationsLocationsGlobalTenantsService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *OrganizationsLocationsGlobalTenantsSetIamPolicyCall { + c := &OrganizationsLocationsGlobalTenantsSetIamPolicyCall{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 information. +func (c *OrganizationsLocationsGlobalTenantsSetIamPolicyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalTenantsSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *OrganizationsLocationsGlobalTenantsSetIamPolicyCall) Context(ctx context.Context) *OrganizationsLocationsGlobalTenantsSetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *OrganizationsLocationsGlobalTenantsSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsGlobalTenantsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.organizations.locations.global.tenants.setIamPolicy" call. +// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *OrganizationsLocationsGlobalTenantsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, 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 := &GoogleIamV1Policy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1/organizations/{organizationsId}/locations/global/tenants/{tenantsId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "beyondcorp.organizations.locations.global.tenants.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "GoogleIamV1SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "GoogleIamV1Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "beyondcorp.organizations.locations.global.tenants.testIamPermissions": + +type OrganizationsLocationsGlobalTenantsTestIamPermissionsCall struct { + s *Service + resource string + googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. +func (r *OrganizationsLocationsGlobalTenantsService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *OrganizationsLocationsGlobalTenantsTestIamPermissionsCall { + c := &OrganizationsLocationsGlobalTenantsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *OrganizationsLocationsGlobalTenantsTestIamPermissionsCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalTenantsTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *OrganizationsLocationsGlobalTenantsTestIamPermissionsCall) Context(ctx context.Context) *OrganizationsLocationsGlobalTenantsTestIamPermissionsCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *OrganizationsLocationsGlobalTenantsTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsGlobalTenantsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.organizations.locations.global.tenants.testIamPermissions" call. +// Exactly one of *GoogleIamV1TestIamPermissionsResponse or error will +// be non-nil. Any non-2xx status code is an error. Response headers are +// in either +// *GoogleIamV1TestIamPermissionsResponse.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 *OrganizationsLocationsGlobalTenantsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, 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 := &GoogleIamV1TestIamPermissionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/organizations/{organizationsId}/locations/global/tenants/{tenantsId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "beyondcorp.organizations.locations.global.tenants.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "GoogleIamV1TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "GoogleIamV1TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "beyondcorp.organizations.locations.global.tenants.proxyConfigs.getIamPolicy": + +type OrganizationsLocationsGlobalTenantsProxyConfigsGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - 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 *OrganizationsLocationsGlobalTenantsProxyConfigsService) GetIamPolicy(resource string) *OrganizationsLocationsGlobalTenantsProxyConfigsGetIamPolicyCall { + c := &OrganizationsLocationsGlobalTenantsProxyConfigsGetIamPolicyCall{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 *OrganizationsLocationsGlobalTenantsProxyConfigsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *OrganizationsLocationsGlobalTenantsProxyConfigsGetIamPolicyCall { + 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 information. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsGetIamPolicyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalTenantsProxyConfigsGetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsGetIamPolicyCall) IfNoneMatch(entityTag string) *OrganizationsLocationsGlobalTenantsProxyConfigsGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsGetIamPolicyCall) Context(ctx context.Context) *OrganizationsLocationsGlobalTenantsProxyConfigsGetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.organizations.locations.global.tenants.proxyConfigs.getIamPolicy" call. +// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *OrganizationsLocationsGlobalTenantsProxyConfigsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, 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 := &GoogleIamV1Policy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/organizations/{organizationsId}/locations/global/tenants/{tenantsId}/proxyConfigs/{proxyConfigsId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "beyondcorp.organizations.locations.global.tenants.proxyConfigs.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. 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).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+/proxyConfigs/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "GoogleIamV1Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "beyondcorp.organizations.locations.global.tenants.proxyConfigs.setIamPolicy": + +type OrganizationsLocationsGlobalTenantsProxyConfigsSetIamPolicyCall struct { + s *Service + resource string + googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - 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 *OrganizationsLocationsGlobalTenantsProxyConfigsService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *OrganizationsLocationsGlobalTenantsProxyConfigsSetIamPolicyCall { + c := &OrganizationsLocationsGlobalTenantsProxyConfigsSetIamPolicyCall{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 information. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsSetIamPolicyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalTenantsProxyConfigsSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsSetIamPolicyCall) Context(ctx context.Context) *OrganizationsLocationsGlobalTenantsProxyConfigsSetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.organizations.locations.global.tenants.proxyConfigs.setIamPolicy" call. +// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *OrganizationsLocationsGlobalTenantsProxyConfigsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, 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 := &GoogleIamV1Policy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1/organizations/{organizationsId}/locations/global/tenants/{tenantsId}/proxyConfigs/{proxyConfigsId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "beyondcorp.organizations.locations.global.tenants.proxyConfigs.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+/proxyConfigs/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "GoogleIamV1SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "GoogleIamV1Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "beyondcorp.organizations.locations.global.tenants.proxyConfigs.testIamPermissions": + +type OrganizationsLocationsGlobalTenantsProxyConfigsTestIamPermissionsCall struct { + s *Service + resource string + googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. +func (r *OrganizationsLocationsGlobalTenantsProxyConfigsService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *OrganizationsLocationsGlobalTenantsProxyConfigsTestIamPermissionsCall { + c := &OrganizationsLocationsGlobalTenantsProxyConfigsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsTestIamPermissionsCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalTenantsProxyConfigsTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsTestIamPermissionsCall) Context(ctx context.Context) *OrganizationsLocationsGlobalTenantsProxyConfigsTestIamPermissionsCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.organizations.locations.global.tenants.proxyConfigs.testIamPermissions" call. +// Exactly one of *GoogleIamV1TestIamPermissionsResponse or error will +// be non-nil. Any non-2xx status code is an error. Response headers are +// in either +// *GoogleIamV1TestIamPermissionsResponse.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 *OrganizationsLocationsGlobalTenantsProxyConfigsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, 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 := &GoogleIamV1TestIamPermissionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/organizations/{organizationsId}/locations/global/tenants/{tenantsId}/proxyConfigs/{proxyConfigsId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "beyondcorp.organizations.locations.global.tenants.proxyConfigs.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+/proxyConfigs/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "GoogleIamV1TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "GoogleIamV1TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "beyondcorp.projects.locations.get": type ProjectsLocationsGetCall struct { diff --git a/beyondcorp/v1alpha/beyondcorp-api.json b/beyondcorp/v1alpha/beyondcorp-api.json index 8fadf9ac623..48b4b17051c 100644 --- a/beyondcorp/v1alpha/beyondcorp-api.json +++ b/beyondcorp/v1alpha/beyondcorp-api.json @@ -109,6 +109,136 @@ "resources": { "locations": { "resources": { + "global": { + "resources": { + "tenants": { + "methods": { + "create": { + "description": "Creates a new BeyondCorp Enterprise tenant in a given organization and can only be called by onboarded BeyondCorp Enterprise partner.", + "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/tenants", + "httpMethod": "POST", + "id": "beyondcorp.organizations.locations.global.tenants.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The resource name of the Tenant using the form: `organizations/{organization_id}/locations/global`", + "location": "path", + "pattern": "^organizations/[^/]+/locations/global$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. 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. The server will guarantee that for at least 60 minutes since the first request. 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).", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+parent}/tenants", + "request": { + "$ref": "GoogleCloudBeyondcorpPartnerservicesV1alphaTenant" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single Tenant.", + "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/tenants/{tenantsId}", + "httpMethod": "GET", + "id": "beyondcorp.organizations.locations.global.tenants.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the Tenant using the form: `organizations/{organization_id}/locations/global/tenants/{tenant_id}`", + "location": "path", + "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleCloudBeyondcorpPartnerservicesV1alphaTenant" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "proxyConfigs": { + "methods": { + "create": { + "description": "Creates a new BeyondCorp Enterprise ProxyConfiguration in a given organization and tenant. Can only be called by on onboarded Beyondcorp Enterprise partner.", + "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/tenants/{tenantsId}/proxyConfigs", + "httpMethod": "POST", + "id": "beyondcorp.organizations.locations.global.tenants.proxyConfigs.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The resource name of the ProxyConfig using the form: `organizations/{organization_id}/locations/global/tenants/{tenant_id}`", + "location": "path", + "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. 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. The server will guarantee that for at least 60 minutes since the first request. 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).", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+parent}/proxyConfigs", + "request": { + "$ref": "GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single Tenant.", + "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/tenants/{tenantsId}/proxyConfigs/{proxyConfigsId}", + "httpMethod": "GET", + "id": "beyondcorp.organizations.locations.global.tenants.proxyConfigs.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the Tenant using the form: `organizations/{organization_id}/locations/global/tenants/{tenant_id}/proxyConfigs/{proxy_config_id}`", + "location": "path", + "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+/proxyConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + }, "insights": { "methods": { "configuredInsight": { @@ -3072,7 +3202,7 @@ } } }, - "revision": "20230406", + "revision": "20230501", "rootUrl": "https://beyondcorp.googleapis.com/", "schemas": { "AllocatedConnection": { @@ -4701,6 +4831,226 @@ }, "type": "object" }, + "GoogleCloudBeyondcorpPartnerservicesV1alphaAuthenticationInfo": { + "description": "Message contains the authentication information to validate against the proxy server.", + "id": "GoogleCloudBeyondcorpPartnerservicesV1alphaAuthenticationInfo", + "properties": { + "encryptionSaEmail": { + "description": "Optional. Service Account for encrypting the JWT.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerMetadata": { + "description": "Metadata associated with Tenant and is provided by the Partner.", + "id": "GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerMetadata", + "properties": { + "partnerTenantId": { + "description": "Optional. UUID used by the Partner to refer to the Tenant in their internal systems.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerServiceOperationMetadata": { + "description": "Represents the metadata of the long-running operation.", + "id": "GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerServiceOperationMetadata", + "properties": { + "apiVersion": { + "description": "Output only. API version used to start the operation.", + "readOnly": true, + "type": "string" + }, + "createTime": { + "description": "Output only. The time the operation was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "endTime": { + "description": "Output only. The time the operation finished running.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "requestedCancellation": { + "description": "Output only. Identifies whether the caller has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "readOnly": true, + "type": "boolean" + }, + "statusMessage": { + "description": "Output only. Human-readable status of the operation, if any.", + "readOnly": true, + "type": "string" + }, + "target": { + "description": "Output only. Server-defined resource path for the target of the operation.", + "readOnly": true, + "type": "string" + }, + "verb": { + "description": "Output only. Name of the verb executed by the operation.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig": { + "description": "Proxy Configuration of a Tenant.", + "id": "GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig", + "properties": { + "authenticationInfo": { + "$ref": "GoogleCloudBeyondcorpPartnerservicesV1alphaAuthenticationInfo", + "description": "Optional. Information to facilitate Authentication against the proxy server." + }, + "createTime": { + "description": "Output only. Timestamp when the resource was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Optional. An arbitrary caller-provided name for the ProxyConfig. Cannot exceed 64 characters.", + "type": "string" + }, + "name": { + "description": "Output only. ProxyConfig resource name.", + "readOnly": true, + "type": "string" + }, + "proxyUri": { + "description": "Required. The URI of the proxy server.", + "type": "string" + }, + "routingInfo": { + "$ref": "GoogleCloudBeyondcorpPartnerservicesV1alphaRoutingInfo", + "description": "Required. Routing info to direct traffic to the proxy server." + }, + "transportInfo": { + "$ref": "GoogleCloudBeyondcorpPartnerservicesV1alphaTransportInfo", + "description": "Required. Transport layer information to verify for the proxy server." + }, + "updateTime": { + "description": "Output only. Timestamp when the resource was last modified.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudBeyondcorpPartnerservicesV1alphaRoutingInfo": { + "description": "Message contains the routing information to direct traffic to the proxy server.", + "id": "GoogleCloudBeyondcorpPartnerservicesV1alphaRoutingInfo", + "properties": { + "pacUri": { + "description": "Required. Proxy Auto-Configuration (PAC) URI.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudBeyondcorpPartnerservicesV1alphaTenant": { + "description": "Information about a BeyoncCorp Enterprise Tenant.", + "id": "GoogleCloudBeyondcorpPartnerservicesV1alphaTenant", + "properties": { + "createTime": { + "description": "Output only. Timestamp when the resource was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Optional. An arbitrary caller-provided name for the Tenant. Cannot exceed 64 characters.", + "type": "string" + }, + "googleGroupEmail": { + "description": "Optional. Google group email to which the Tenant is enabled.", + "type": "string" + }, + "googleGroupId": { + "description": "Optional. Google group ID to which the Tenant is enabled.", + "type": "string" + }, + "name": { + "description": "Output only. Unique resource name of the Tenant. The name is ignored when creating Tenant.", + "readOnly": true, + "type": "string" + }, + "partnerMetadata": { + "$ref": "GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerMetadata", + "description": "Optional. Metadata provided by the Partner associated with Tenant." + }, + "updateTime": { + "description": "Output only. Timestamp when the resource was last modified.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudBeyondcorpPartnerservicesV1alphaTransportInfo": { + "description": "Message contains the transport layer information to verify the proxy server.", + "id": "GoogleCloudBeyondcorpPartnerservicesV1alphaTransportInfo", + "properties": { + "serverCaCertPem": { + "description": "Required. PEM encoded CA certificate associated with the proxy server certificate.", + "type": "string" + }, + "sslDecryptCaCertPem": { + "description": "Optional. PEM encoded CA certificate associated with the certificate used by proxy server for SSL decryption.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudBeyondcorpPartnerservicesV1mainPartnerServiceOperationMetadata": { + "description": "Represents the metadata of the long-running operation.", + "id": "GoogleCloudBeyondcorpPartnerservicesV1mainPartnerServiceOperationMetadata", + "properties": { + "apiVersion": { + "description": "Output only. API version used to start the operation.", + "readOnly": true, + "type": "string" + }, + "createTime": { + "description": "Output only. The time the operation was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "endTime": { + "description": "Output only. The time the operation finished running.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "requestedCancellation": { + "description": "Output only. Identifies whether the caller has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "readOnly": true, + "type": "boolean" + }, + "statusMessage": { + "description": "Output only. Human-readable status of the operation, if any.", + "readOnly": true, + "type": "string" + }, + "target": { + "description": "Output only. Server-defined resource path for the target of the operation.", + "readOnly": true, + "type": "string" + }, + "verb": { + "description": "Output only. Name of the verb executed by the operation.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudBeyondcorpSaasplatformInsightsV1alphaAppliedConfig": { "description": "The configuration that was applied to generate the result.", "id": "GoogleCloudBeyondcorpSaasplatformInsightsV1alphaAppliedConfig", @@ -5117,7 +5467,7 @@ "type": "object" }, "GoogleCloudLocationLocation": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "GoogleCloudLocationLocation", "properties": { "displayName": { diff --git a/beyondcorp/v1alpha/beyondcorp-gen.go b/beyondcorp/v1alpha/beyondcorp-gen.go index ccdef22fbe8..bc292c10a9d 100644 --- a/beyondcorp/v1alpha/beyondcorp-gen.go +++ b/beyondcorp/v1alpha/beyondcorp-gen.go @@ -155,6 +155,7 @@ type OrganizationsService struct { func NewOrganizationsLocationsService(s *Service) *OrganizationsLocationsService { rs := &OrganizationsLocationsService{s: s} + rs.Global = NewOrganizationsLocationsGlobalService(s) rs.Insights = NewOrganizationsLocationsInsightsService(s) rs.Subscriptions = NewOrganizationsLocationsSubscriptionsService(s) return rs @@ -163,11 +164,46 @@ func NewOrganizationsLocationsService(s *Service) *OrganizationsLocationsService type OrganizationsLocationsService struct { s *Service + Global *OrganizationsLocationsGlobalService + Insights *OrganizationsLocationsInsightsService Subscriptions *OrganizationsLocationsSubscriptionsService } +func NewOrganizationsLocationsGlobalService(s *Service) *OrganizationsLocationsGlobalService { + rs := &OrganizationsLocationsGlobalService{s: s} + rs.Tenants = NewOrganizationsLocationsGlobalTenantsService(s) + return rs +} + +type OrganizationsLocationsGlobalService struct { + s *Service + + Tenants *OrganizationsLocationsGlobalTenantsService +} + +func NewOrganizationsLocationsGlobalTenantsService(s *Service) *OrganizationsLocationsGlobalTenantsService { + rs := &OrganizationsLocationsGlobalTenantsService{s: s} + rs.ProxyConfigs = NewOrganizationsLocationsGlobalTenantsProxyConfigsService(s) + return rs +} + +type OrganizationsLocationsGlobalTenantsService struct { + s *Service + + ProxyConfigs *OrganizationsLocationsGlobalTenantsProxyConfigsService +} + +func NewOrganizationsLocationsGlobalTenantsProxyConfigsService(s *Service) *OrganizationsLocationsGlobalTenantsProxyConfigsService { + rs := &OrganizationsLocationsGlobalTenantsProxyConfigsService{s: s} + return rs +} + +type OrganizationsLocationsGlobalTenantsProxyConfigsService struct { + s *Service +} + func NewOrganizationsLocationsInsightsService(s *Service) *OrganizationsLocationsInsightsService { rs := &OrganizationsLocationsInsightsService{s: s} return rs @@ -2587,81 +2623,45 @@ func (s *GoogleCloudBeyondcorpAppgatewaysV1AppGatewayOperationMetadata) MarshalJ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaAppliedConfig: The -// configuration that was applied to generate the result. -type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaAppliedConfig struct { - // Aggregation: Output only. Aggregation type applied. - // - // Possible values: - // "AGGREGATION_UNSPECIFIED" - Unspecified. - // "HOURLY" - Insight should be aggregated at hourly level. - // "DAILY" - Insight should be aggregated at daily level. - // "WEEKLY" - Insight should be aggregated at weekly level. - // "MONTHLY" - Insight should be aggregated at monthly level. - // "CUSTOM_DATE_RANGE" - Insight should be aggregated at the custom - // date range passed in as the start and end time in the request. - Aggregation string `json:"aggregation,omitempty"` - - // CustomGrouping: Output only. Customised grouping applied. - CustomGrouping *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaCustomGrouping `json:"customGrouping,omitempty"` - - // EndTime: Output only. Ending time for the duration for which insight - // was pulled. - EndTime string `json:"endTime,omitempty"` - - // FieldFilter: Output only. Filters applied. - FieldFilter string `json:"fieldFilter,omitempty"` - - // Group: Output only. Group id of the grouping applied. - Group string `json:"group,omitempty"` - - // StartTime: Output only. Starting time for the duration for which - // insight was pulled. - StartTime string `json:"startTime,omitempty"` +// GoogleCloudBeyondcorpPartnerservicesV1alphaAuthenticationInfo: +// Message contains the authentication information to validate against +// the proxy server. +type GoogleCloudBeyondcorpPartnerservicesV1alphaAuthenticationInfo struct { + // EncryptionSaEmail: Optional. Service Account for encrypting the JWT. + EncryptionSaEmail string `json:"encryptionSaEmail,omitempty"` - // ForceSendFields is a list of field names (e.g. "Aggregation") to - // unconditionally include in API requests. By default, fields with + // ForceSendFields is a list of field names (e.g. "EncryptionSaEmail") + // to unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be // sent to the server regardless of whether the field is empty or not. // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Aggregation") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. + // NullFields is a list of field names (e.g. "EncryptionSaEmail") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. NullFields []string `json:"-"` } -func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaAppliedConfig) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaAppliedConfig +func (s *GoogleCloudBeyondcorpPartnerservicesV1alphaAuthenticationInfo) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpPartnerservicesV1alphaAuthenticationInfo raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightRespo -// nse: The response for the configured insight. -type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse struct { - // AppliedConfig: Output only. Applied insight config to generate the - // result data rows. - AppliedConfig *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaAppliedConfig `json:"appliedConfig,omitempty"` - - // NextPageToken: Output only. Next page token to be fetched. Set to - // empty or NULL if there are no more pages available. - NextPageToken string `json:"nextPageToken,omitempty"` - - // Rows: Output only. Result rows returned containing the required - // value(s) for configured insight. - Rows []*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRow `json:"rows,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the - // server. - googleapi.ServerResponse `json:"-"` +// GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerMetadata: Metadata +// associated with Tenant and is provided by the Partner. +type GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerMetadata struct { + // PartnerTenantId: Optional. UUID used by the Partner to refer to the + // Tenant in their internal systems. + PartnerTenantId string `json:"partnerTenantId,omitempty"` - // ForceSendFields is a list of field names (e.g. "AppliedConfig") to + // ForceSendFields is a list of field names (e.g. "PartnerTenantId") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -2669,43 +2669,52 @@ type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse s // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AppliedConfig") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. + // NullFields is a list of field names (e.g. "PartnerTenantId") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. NullFields []string `json:"-"` } -func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse +func (s *GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerMetadata raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaCustomGrouping: -// Customised grouping option that allows setting the group_by fields -// and also the filters togather for a configured insight request. -type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaCustomGrouping struct { - // FieldFilter: Optional. Filterable parameters to be added to the - // grouping clause. Available fields could be fetched by calling insight - // list and get APIs in `BASIC` view. `=` is the only comparison - // operator supported. `AND` is the only logical operator supported. - // Usage: field_filter="fieldName1=fieldVal1 AND fieldName2=fieldVal2". - // NOTE: Only `AND` conditions are allowed. NOTE: Use the `filter_alias` - // from `Insight.Metadata.Field` message for the filtering the - // corresponding fields in this filter field. (These expressions are - // based on the filter language described at - // https://google.aip.dev/160). - FieldFilter string `json:"fieldFilter,omitempty"` +// GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerServiceOperationMeta +// data: Represents the metadata of the long-running operation. +type GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerServiceOperationMetadata struct { + // ApiVersion: Output only. API version used to start the operation. + ApiVersion string `json:"apiVersion,omitempty"` - // GroupFields: Required. Fields to be used for grouping. NOTE: Use the - // `filter_alias` from `Insight.Metadata.Field` message for declaring - // the fields to be grouped-by here. - GroupFields []string `json:"groupFields,omitempty"` + // CreateTime: Output only. The time the operation was created. + CreateTime string `json:"createTime,omitempty"` - // ForceSendFields is a list of field names (e.g. "FieldFilter") to + // EndTime: Output only. The time the operation finished running. + EndTime string `json:"endTime,omitempty"` + + // RequestedCancellation: Output only. Identifies whether the caller has + // requested cancellation of the operation. Operations that have + // successfully been cancelled have Operation.error value with a + // google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`. + RequestedCancellation bool `json:"requestedCancellation,omitempty"` + + // StatusMessage: Output only. Human-readable status of the operation, + // if any. + StatusMessage string `json:"statusMessage,omitempty"` + + // Target: Output only. Server-defined resource path for the target of + // the operation. + Target string `json:"target,omitempty"` + + // Verb: Output only. Name of the verb executed by the operation. + Verb string `json:"verb,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ApiVersion") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -2713,107 +2722,89 @@ type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaCustomGrouping struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "FieldFilter") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "ApiVersion") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaCustomGrouping) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaCustomGrouping +func (s *GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerServiceOperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerServiceOperationMetadata raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight: The Insight -// object with configuration that was returned and actual list of -// records. -type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight struct { - // AppliedConfig: Output only. Applied insight config to generate the - // result data rows. - AppliedConfig *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaAppliedConfig `json:"appliedConfig,omitempty"` +// GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig: Proxy +// Configuration of a Tenant. +type GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig struct { + // AuthenticationInfo: Optional. Information to facilitate + // Authentication against the proxy server. + AuthenticationInfo *GoogleCloudBeyondcorpPartnerservicesV1alphaAuthenticationInfo `json:"authenticationInfo,omitempty"` - // Metadata: Output only. Metadata for the Insight. - Metadata *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadata `json:"metadata,omitempty"` + // CreateTime: Output only. Timestamp when the resource was created. + CreateTime string `json:"createTime,omitempty"` - // Name: Output only. The insight resource name. e.g. - // `organizations/{organization_id}/locations/{location_id}/insights/{ins - // ight_id}` OR - // `projects/{project_id}/locations/{location_id}/insights/{insight_id}`. + // DisplayName: Optional. An arbitrary caller-provided name for the + // ProxyConfig. Cannot exceed 64 characters. + DisplayName string `json:"displayName,omitempty"` + + // Name: Output only. ProxyConfig resource name. Name string `json:"name,omitempty"` - // Rows: Output only. Result rows returned containing the required - // value(s). - Rows []*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRow `json:"rows,omitempty"` + // ProxyUri: Required. The URI of the proxy server. + ProxyUri string `json:"proxyUri,omitempty"` + + // RoutingInfo: Required. Routing info to direct traffic to the proxy + // server. + RoutingInfo *GoogleCloudBeyondcorpPartnerservicesV1alphaRoutingInfo `json:"routingInfo,omitempty"` + + // TransportInfo: Required. Transport layer information to verify for + // the proxy server. + TransportInfo *GoogleCloudBeyondcorpPartnerservicesV1alphaTransportInfo `json:"transportInfo,omitempty"` + + // UpdateTime: Output only. Timestamp when the resource was last + // modified. + UpdateTime string `json:"updateTime,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "AppliedConfig") to - // unconditionally include in API requests. By default, fields with + // ForceSendFields is a list of field names (e.g. "AuthenticationInfo") + // to unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be // sent to the server regardless of whether the field is empty or not. // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AppliedConfig") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. + // NullFields is a list of field names (e.g. "AuthenticationInfo") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. NullFields []string `json:"-"` } -func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight +func (s *GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadata: -// Insight filters, groupings and aggregations that can be applied for -// the insight. Examples: aggregations, groups, field filters. -type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadata struct { - // Aggregations: Output only. List of aggregation types available for - // insight. - // - // Possible values: - // "AGGREGATION_UNSPECIFIED" - Unspecified. - // "HOURLY" - Insight should be aggregated at hourly level. - // "DAILY" - Insight should be aggregated at daily level. - // "WEEKLY" - Insight should be aggregated at weekly level. - // "MONTHLY" - Insight should be aggregated at monthly level. - // "CUSTOM_DATE_RANGE" - Insight should be aggregated at the custom - // date range passed in as the start and end time in the request. - Aggregations []string `json:"aggregations,omitempty"` - - // Category: Output only. Category of the insight. - Category string `json:"category,omitempty"` - - // DisplayName: Output only. Common name of the insight. - DisplayName string `json:"displayName,omitempty"` - - // Fields: Output only. List of fields available for insight. - Fields []*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadataField `json:"fields,omitempty"` - - // Groups: Output only. List of groupings available for insight. - Groups []string `json:"groups,omitempty"` - - // SubCategory: Output only. Sub-Category of the insight. - SubCategory string `json:"subCategory,omitempty"` - - // Type: Output only. Type of the insight. It is metadata describing - // whether the insight is a metric (e.g. count) or a report (e.g. list, - // status). - Type string `json:"type,omitempty"` +// GoogleCloudBeyondcorpPartnerservicesV1alphaRoutingInfo: Message +// contains the routing information to direct traffic to the proxy +// server. +type GoogleCloudBeyondcorpPartnerservicesV1alphaRoutingInfo struct { + // PacUri: Required. Proxy Auto-Configuration (PAC) URI. + PacUri string `json:"pacUri,omitempty"` - // ForceSendFields is a list of field names (e.g. "Aggregations") to + // ForceSendFields is a list of field names (e.g. "PacUri") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -2821,47 +2812,56 @@ type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadata struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Aggregations") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "PacUri") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadata +func (s *GoogleCloudBeyondcorpPartnerservicesV1alphaRoutingInfo) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpPartnerservicesV1alphaRoutingInfo raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadataField: -// Field metadata. Commonly understandable name and description for the -// field. Multiple such fields constitute the Insight. -type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadataField struct { - // Description: Output only. Description of the field. - Description string `json:"description,omitempty"` +// GoogleCloudBeyondcorpPartnerservicesV1alphaTenant: Information about +// a BeyoncCorp Enterprise Tenant. +type GoogleCloudBeyondcorpPartnerservicesV1alphaTenant struct { + // CreateTime: Output only. Timestamp when the resource was created. + CreateTime string `json:"createTime,omitempty"` - // DisplayName: Output only. Name of the field. + // DisplayName: Optional. An arbitrary caller-provided name for the + // Tenant. Cannot exceed 64 characters. DisplayName string `json:"displayName,omitempty"` - // FilterAlias: Output only. Field name to be used in filter while - // requesting configured insight filtered on this field. - FilterAlias string `json:"filterAlias,omitempty"` + // GoogleGroupEmail: Optional. Google group email to which the Tenant is + // enabled. + GoogleGroupEmail string `json:"googleGroupEmail,omitempty"` - // Filterable: Output only. Indicates whether the field can be used for - // filtering. - Filterable bool `json:"filterable,omitempty"` + // GoogleGroupId: Optional. Google group ID to which the Tenant is + // enabled. + GoogleGroupId string `json:"googleGroupId,omitempty"` - // Groupable: Output only. Indicates whether the field can be used for - // grouping in custom grouping request. - Groupable bool `json:"groupable,omitempty"` + // Name: Output only. Unique resource name of the Tenant. The name is + // ignored when creating Tenant. + Name string `json:"name,omitempty"` - // Id: Output only. Field id for which this is the metadata. - Id string `json:"id,omitempty"` + // PartnerMetadata: Optional. Metadata provided by the Partner + // associated with Tenant. + PartnerMetadata *GoogleCloudBeyondcorpPartnerservicesV1alphaPartnerMetadata `json:"partnerMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "Description") to + // UpdateTime: Output only. Timestamp when the resource was last + // modified. + UpdateTime string `json:"updateTime,omitempty"` + + // 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 // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -2869,36 +2869,86 @@ type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadataField struct // This may be used to include empty fields in Patch requests. 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. However, any field with - // an empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "CreateTime") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadataField) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadataField +func (s *GoogleCloudBeyondcorpPartnerservicesV1alphaTenant) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpPartnerservicesV1alphaTenant raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse: -// The response for the list of insights. -type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse struct { - // Insights: Output only. List of all insights. - Insights []*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight `json:"insights,omitempty"` +// GoogleCloudBeyondcorpPartnerservicesV1alphaTransportInfo: Message +// contains the transport layer information to verify the proxy server. +type GoogleCloudBeyondcorpPartnerservicesV1alphaTransportInfo struct { + // ServerCaCertPem: Required. PEM encoded CA certificate associated with + // the proxy server certificate. + ServerCaCertPem string `json:"serverCaCertPem,omitempty"` - // NextPageToken: Output only. Next page token to be fetched. Set to - // empty or NULL if there are no more pages available. - NextPageToken string `json:"nextPageToken,omitempty"` + // SslDecryptCaCertPem: Optional. PEM encoded CA certificate associated + // with the certificate used by proxy server for SSL decryption. + SslDecryptCaCertPem string `json:"sslDecryptCaCertPem,omitempty"` - // ServerResponse contains the HTTP response code and headers from the - // server. - googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "ServerCaCertPem") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` - // ForceSendFields is a list of field names (e.g. "Insights") to + // NullFields is a list of field names (e.g. "ServerCaCertPem") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudBeyondcorpPartnerservicesV1alphaTransportInfo) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpPartnerservicesV1alphaTransportInfo + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudBeyondcorpPartnerservicesV1mainPartnerServiceOperationMetad +// ata: Represents the metadata of the long-running operation. +type GoogleCloudBeyondcorpPartnerservicesV1mainPartnerServiceOperationMetadata struct { + // ApiVersion: Output only. API version used to start the operation. + ApiVersion string `json:"apiVersion,omitempty"` + + // CreateTime: Output only. The time the operation was created. + CreateTime string `json:"createTime,omitempty"` + + // EndTime: Output only. The time the operation finished running. + EndTime string `json:"endTime,omitempty"` + + // RequestedCancellation: Output only. Identifies whether the caller has + // requested cancellation of the operation. Operations that have + // successfully been cancelled have Operation.error value with a + // google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`. + RequestedCancellation bool `json:"requestedCancellation,omitempty"` + + // StatusMessage: Output only. Human-readable status of the operation, + // if any. + StatusMessage string `json:"statusMessage,omitempty"` + + // Target: Output only. Server-defined resource path for the target of + // the operation. + Target string `json:"target,omitempty"` + + // Verb: Output only. Name of the verb executed by the operation. + Verb string `json:"verb,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ApiVersion") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -2906,7 +2956,7 @@ type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse struct // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Insights") to include in + // NullFields is a list of field names (e.g. "ApiVersion") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as @@ -2915,19 +2965,45 @@ type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse struct NullFields []string `json:"-"` } -func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse +func (s *GoogleCloudBeyondcorpPartnerservicesV1mainPartnerServiceOperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpPartnerservicesV1mainPartnerServiceOperationMetadata raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRow: Row of the fetch -// response consisting of a set of entries. -type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRow struct { - // FieldValues: Output only. Columns/entries/key-vals in the result. - FieldValues []*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRowFieldVal `json:"fieldValues,omitempty"` +// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaAppliedConfig: The +// configuration that was applied to generate the result. +type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaAppliedConfig struct { + // Aggregation: Output only. Aggregation type applied. + // + // Possible values: + // "AGGREGATION_UNSPECIFIED" - Unspecified. + // "HOURLY" - Insight should be aggregated at hourly level. + // "DAILY" - Insight should be aggregated at daily level. + // "WEEKLY" - Insight should be aggregated at weekly level. + // "MONTHLY" - Insight should be aggregated at monthly level. + // "CUSTOM_DATE_RANGE" - Insight should be aggregated at the custom + // date range passed in as the start and end time in the request. + Aggregation string `json:"aggregation,omitempty"` - // ForceSendFields is a list of field names (e.g. "FieldValues") to + // CustomGrouping: Output only. Customised grouping applied. + CustomGrouping *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaCustomGrouping `json:"customGrouping,omitempty"` + + // EndTime: Output only. Ending time for the duration for which insight + // was pulled. + EndTime string `json:"endTime,omitempty"` + + // FieldFilter: Output only. Filters applied. + FieldFilter string `json:"fieldFilter,omitempty"` + + // Group: Output only. Group id of the grouping applied. + Group string `json:"group,omitempty"` + + // StartTime: Output only. Starting time for the duration for which + // insight was pulled. + StartTime string `json:"startTime,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Aggregation") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -2935,7 +3011,7 @@ type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRow struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "FieldValues") to include + // NullFields is a list of field names (e.g. "Aggregation") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as @@ -2944,31 +3020,32 @@ type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRow struct { NullFields []string `json:"-"` } -func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRow) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRow +func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaAppliedConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaAppliedConfig raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRowFieldVal: Column -// or key value pair from the request as part of key to use in query or -// a single pair of the fetch response. -type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRowFieldVal struct { - // DisplayName: Output only. Name of the field. - DisplayName string `json:"displayName,omitempty"` +// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightRespo +// nse: The response for the configured insight. +type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse struct { + // AppliedConfig: Output only. Applied insight config to generate the + // result data rows. + AppliedConfig *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaAppliedConfig `json:"appliedConfig,omitempty"` - // FilterAlias: Output only. Field name to be used in filter while - // requesting configured insight filtered on this field. - FilterAlias string `json:"filterAlias,omitempty"` + // NextPageToken: Output only. Next page token to be fetched. Set to + // empty or NULL if there are no more pages available. + NextPageToken string `json:"nextPageToken,omitempty"` - // Id: Output only. Field id. - Id string `json:"id,omitempty"` + // Rows: Output only. Result rows returned containing the required + // value(s) for configured insight. + Rows []*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRow `json:"rows,omitempty"` - // Value: Output only. Value of the field in string format. Acceptable - // values are strings or numbers. - Value string `json:"value,omitempty"` + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "DisplayName") to + // ForceSendFields is a list of field names (e.g. "AppliedConfig") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -2976,7 +3053,7 @@ type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRowFieldVal struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "DisplayName") to include + // NullFields is a list of field names (e.g. "AppliedConfig") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as @@ -2985,28 +3062,34 @@ type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRowFieldVal struct { NullFields []string `json:"-"` } -func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRowFieldVal) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRowFieldVal +func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaListSubscriptions -// Response: Response message for BeyondCorp.ListSubscriptions. -type GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaListSubscriptionsResponse struct { - // NextPageToken: A token to retrieve the next page of results, or empty - // if there are no more results in the list. - NextPageToken string `json:"nextPageToken,omitempty"` - - // Subscriptions: A list of BeyondCorp Subscriptions in the - // organization. - Subscriptions []*GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription `json:"subscriptions,omitempty"` +// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaCustomGrouping: +// Customised grouping option that allows setting the group_by fields +// and also the filters togather for a configured insight request. +type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaCustomGrouping struct { + // FieldFilter: Optional. Filterable parameters to be added to the + // grouping clause. Available fields could be fetched by calling insight + // list and get APIs in `BASIC` view. `=` is the only comparison + // operator supported. `AND` is the only logical operator supported. + // Usage: field_filter="fieldName1=fieldVal1 AND fieldName2=fieldVal2". + // NOTE: Only `AND` conditions are allowed. NOTE: Use the `filter_alias` + // from `Insight.Metadata.Field` message for the filtering the + // corresponding fields in this filter field. (These expressions are + // based on the filter language described at + // https://google.aip.dev/160). + FieldFilter string `json:"fieldFilter,omitempty"` - // ServerResponse contains the HTTP response code and headers from the - // server. - googleapi.ServerResponse `json:"-"` + // GroupFields: Required. Fields to be used for grouping. NOTE: Use the + // `filter_alias` from `Insight.Metadata.Field` message for declaring + // the fields to be grouped-by here. + GroupFields []string `json:"groupFields,omitempty"` - // ForceSendFields is a list of field names (e.g. "NextPageToken") to + // ForceSendFields is a list of field names (e.g. "FieldFilter") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3014,7 +3097,7 @@ type GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaListSubscriptionsRespo // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "NextPageToken") to include + // NullFields is a list of field names (e.g. "FieldFilter") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as @@ -3023,67 +3106,38 @@ type GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaListSubscriptionsRespo NullFields []string `json:"-"` } -func (s *GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaListSubscriptionsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaListSubscriptionsResponse +func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaCustomGrouping) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaCustomGrouping raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription: A -// BeyondCorp Subscription resource represents BeyondCorp Enterprise -// Subscription. BeyondCorp Enterprise Subscription enables BeyondCorp -// Enterprise permium features for an organization. -type GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription struct { - // AutoRenewEnabled: Output only. Represents that, if subscription will - // renew or end when the term ends. - AutoRenewEnabled bool `json:"autoRenewEnabled,omitempty"` - - // CreateTime: Output only. Create time of the subscription. - CreateTime string `json:"createTime,omitempty"` +// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight: The Insight +// object with configuration that was returned and actual list of +// records. +type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight struct { + // AppliedConfig: Output only. Applied insight config to generate the + // result data rows. + AppliedConfig *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaAppliedConfig `json:"appliedConfig,omitempty"` - // EndTime: Output only. End time of the subscription. - EndTime string `json:"endTime,omitempty"` + // Metadata: Output only. Metadata for the Insight. + Metadata *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadata `json:"metadata,omitempty"` - // Name: Required. Unique resource name of the Subscription. The name is - // ignored when creating a subscription. + // Name: Output only. The insight resource name. e.g. + // `organizations/{organization_id}/locations/{location_id}/insights/{ins + // ight_id}` OR + // `projects/{project_id}/locations/{location_id}/insights/{insight_id}`. Name string `json:"name,omitempty"` - // SeatCount: Output only. Number of seats in the subscription. - SeatCount int64 `json:"seatCount,omitempty,string"` + // Rows: Output only. Result rows returned containing the required + // value(s). + Rows []*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRow `json:"rows,omitempty"` - // Sku: Required. SKU of subscription. - // - // Possible values: - // "SKU_UNSPECIFIED" - Default value. This value is unused. - // "BCE_STANDARD_SKU" - Represents BeyondCorp Standard SKU. - Sku string `json:"sku,omitempty"` + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` - // StartTime: Output only. Start time of the subscription. - StartTime string `json:"startTime,omitempty"` - - // State: Output only. The current state of the subscription. - // - // Possible values: - // "STATE_UNSPECIFIED" - Default value. This value is unused. - // "ACTIVE" - Represents an active subscription. - // "INACTIVE" - Represents an upcomming subscription. - // "COMPLETED" - Represents a completed subscription. - State string `json:"state,omitempty"` - - // Type: Required. Type of subscription. - // - // Possible values: - // "TYPE_UNSPECIFIED" - Default value. This value is unused. - // "TRIAL" - Represents a trial subscription. - // "PAID" - Represents a paid subscription. - // "ALLOWLIST" - Reresents an allowlisted subscription. - Type string `json:"type,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the - // server. - googleapi.ServerResponse `json:"-"` - - // ForceSendFields is a list of field names (e.g. "AutoRenewEnabled") to + // ForceSendFields is a list of field names (e.g. "AppliedConfig") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3091,37 +3145,59 @@ type GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AutoRenewEnabled") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the - // server as null. It is an error if a field in this list has a - // non-empty value. This may be used to include null fields in Patch - // requests. + // NullFields is a list of field names (e.g. "AppliedConfig") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription +func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudLocationListLocationsResponse: The response message for -// Locations.ListLocations. -type GoogleCloudLocationListLocationsResponse struct { - // Locations: A list of locations that matches the specified filter in - // the request. - Locations []*GoogleCloudLocationLocation `json:"locations,omitempty"` +// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadata: +// Insight filters, groupings and aggregations that can be applied for +// the insight. Examples: aggregations, groups, field filters. +type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadata struct { + // Aggregations: Output only. List of aggregation types available for + // insight. + // + // Possible values: + // "AGGREGATION_UNSPECIFIED" - Unspecified. + // "HOURLY" - Insight should be aggregated at hourly level. + // "DAILY" - Insight should be aggregated at daily level. + // "WEEKLY" - Insight should be aggregated at weekly level. + // "MONTHLY" - Insight should be aggregated at monthly level. + // "CUSTOM_DATE_RANGE" - Insight should be aggregated at the custom + // date range passed in as the start and end time in the request. + Aggregations []string `json:"aggregations,omitempty"` - // NextPageToken: The standard List next-page token. - NextPageToken string `json:"nextPageToken,omitempty"` + // Category: Output only. Category of the insight. + Category string `json:"category,omitempty"` - // ServerResponse contains the HTTP response code and headers from the - // server. - googleapi.ServerResponse `json:"-"` + // DisplayName: Output only. Common name of the insight. + DisplayName string `json:"displayName,omitempty"` - // ForceSendFields is a list of field names (e.g. "Locations") to + // Fields: Output only. List of fields available for insight. + Fields []*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadataField `json:"fields,omitempty"` + + // Groups: Output only. List of groupings available for insight. + Groups []string `json:"groups,omitempty"` + + // SubCategory: Output only. Sub-Category of the insight. + SubCategory string `json:"subCategory,omitempty"` + + // Type: Output only. Type of the insight. It is metadata describing + // whether the insight is a metric (e.g. count) or a report (e.g. list, + // status). + Type string `json:"type,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Aggregations") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3129,50 +3205,47 @@ type GoogleCloudLocationListLocationsResponse struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Locations") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "Aggregations") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *GoogleCloudLocationListLocationsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudLocationListLocationsResponse +func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadata raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudLocationLocation: A resource that represents Google Cloud -// Platform location. -type GoogleCloudLocationLocation struct { - // DisplayName: The friendly name for this location, typically a nearby - // city name. For example, "Tokyo". - DisplayName string `json:"displayName,omitempty"` +// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadataField: +// Field metadata. Commonly understandable name and description for the +// field. Multiple such fields constitute the Insight. +type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadataField struct { + // Description: Output only. Description of the field. + Description string `json:"description,omitempty"` - // Labels: Cross-service attributes for the location. For example - // {"cloud.googleapis.com/region": "us-east1"} - Labels map[string]string `json:"labels,omitempty"` + // DisplayName: Output only. Name of the field. + DisplayName string `json:"displayName,omitempty"` - // LocationId: The canonical id for this location. For example: - // "us-east1". - LocationId string `json:"locationId,omitempty"` + // FilterAlias: Output only. Field name to be used in filter while + // requesting configured insight filtered on this field. + FilterAlias string `json:"filterAlias,omitempty"` - // Metadata: Service-specific metadata. For example the available - // capacity at the given location. - Metadata googleapi.RawMessage `json:"metadata,omitempty"` + // Filterable: Output only. Indicates whether the field can be used for + // filtering. + Filterable bool `json:"filterable,omitempty"` - // Name: Resource name for the location, which may vary between - // implementations. For example: - // "projects/example-project/locations/us-east1" - Name string `json:"name,omitempty"` + // Groupable: Output only. Indicates whether the field can be used for + // grouping in custom grouping request. + Groupable bool `json:"groupable,omitempty"` - // ServerResponse contains the HTTP response code and headers from the - // server. - googleapi.ServerResponse `json:"-"` + // Id: Output only. Field id for which this is the metadata. + Id string `json:"id,omitempty"` - // ForceSendFields is a list of field names (e.g. "DisplayName") to + // 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. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3180,7 +3253,7 @@ type GoogleCloudLocationLocation struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "DisplayName") to include + // 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. However, any field with // an empty value appearing in NullFields will be sent to the server as @@ -3189,41 +3262,27 @@ type GoogleCloudLocationLocation struct { NullFields []string `json:"-"` } -func (s *GoogleCloudLocationLocation) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudLocationLocation +func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadataField) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsightMetadataField raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleIamV1AuditConfig: Specifies the audit configuration for a -// service. The configuration determines which permission types are -// logged, and what identities, if any, are exempted from logging. An -// AuditConfig must have one or more AuditLogConfigs. If there are -// AuditConfigs for both `allServices` and a specific service, the union -// of the two AuditConfigs is used for that service: the log_types -// specified in each AuditConfig are enabled, and the exempted_members -// in each AuditLogConfig are exempted. Example Policy with multiple -// AuditConfigs: { "audit_configs": [ { "service": "allServices", -// "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": -// [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { -// "log_type": "ADMIN_READ" } ] }, { "service": -// "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": -// "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ -// "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy -// enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts -// `jose@example.com` from DATA_READ logging, and `aliya@example.com` -// from DATA_WRITE logging. -type GoogleIamV1AuditConfig struct { - // AuditLogConfigs: The configuration for logging of each type of - // permission. - AuditLogConfigs []*GoogleIamV1AuditLogConfig `json:"auditLogConfigs,omitempty"` +// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse: +// The response for the list of insights. +type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse struct { + // Insights: Output only. List of all insights. + Insights []*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight `json:"insights,omitempty"` - // Service: Specifies a service that will be enabled for audit logging. - // For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. - // `allServices` is a special value that covers all services. - Service string `json:"service,omitempty"` + // NextPageToken: Output only. Next page token to be fetched. Set to + // empty or NULL if there are no more pages available. + NextPageToken string `json:"nextPageToken,omitempty"` - // ForceSendFields is a list of field names (e.g. "AuditLogConfigs") to + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Insights") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3231,44 +3290,28 @@ type GoogleIamV1AuditConfig struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AuditLogConfigs") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the - // server as null. It is an error if a field in this list has a - // non-empty value. This may be used to include null fields in Patch - // requests. + // NullFields is a list of field names (e.g. "Insights") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *GoogleIamV1AuditConfig) MarshalJSON() ([]byte, error) { - type NoMethod GoogleIamV1AuditConfig +func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleIamV1AuditLogConfig: Provides the configuration for logging a -// type of permissions. Example: { "audit_log_configs": [ { "log_type": -// "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { -// "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and -// 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ -// logging. -type GoogleIamV1AuditLogConfig struct { - // ExemptedMembers: Specifies the identities that do not cause logging - // for this type of permission. Follows the same format of - // Binding.members. - ExemptedMembers []string `json:"exemptedMembers,omitempty"` - - // LogType: The log type that this config enables. - // - // Possible values: - // "LOG_TYPE_UNSPECIFIED" - Default case. Should never be this. - // "ADMIN_READ" - Admin reads. Example: CloudIAM getIamPolicy - // "DATA_WRITE" - Data writes. Example: CloudSQL Users create - // "DATA_READ" - Data reads. Example: CloudSQL Users list - LogType string `json:"logType,omitempty"` +// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRow: Row of the fetch +// response consisting of a set of entries. +type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRow struct { + // FieldValues: Output only. Columns/entries/key-vals in the result. + FieldValues []*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRowFieldVal `json:"fieldValues,omitempty"` - // ForceSendFields is a list of field names (e.g. "ExemptedMembers") to + // ForceSendFields is a list of field names (e.g. "FieldValues") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3276,79 +3319,40 @@ type GoogleIamV1AuditLogConfig struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ExemptedMembers") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the - // server as null. It is an error if a field in this list has a - // non-empty value. This may be used to include null fields in Patch - // requests. + // NullFields is a list of field names (e.g. "FieldValues") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *GoogleIamV1AuditLogConfig) MarshalJSON() ([]byte, error) { - type NoMethod GoogleIamV1AuditLogConfig +func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRow) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRow raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleIamV1Binding: Associates `members`, or principals, with a -// `role`. -type GoogleIamV1Binding struct { - // Condition: The condition that is associated with this binding. If the - // condition evaluates to `true`, then this binding applies to the - // current request. If the condition evaluates to `false`, then this - // binding does not apply to the current request. However, a different - // role binding might grant the same role to one or more of the - // principals in this binding. To learn which resources support - // conditions in their IAM policies, see the IAM documentation - // (https://cloud.google.com/iam/help/conditions/resource-policies). - Condition *GoogleTypeExpr `json:"condition,omitempty"` +// GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRowFieldVal: Column +// or key value pair from the request as part of key to use in query or +// a single pair of the fetch response. +type GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRowFieldVal struct { + // DisplayName: Output only. Name of the field. + DisplayName string `json:"displayName,omitempty"` - // Members: Specifies the principals requesting access for a Google - // Cloud resource. `members` can have the following values: * - // `allUsers`: A special identifier that represents anyone who is on the - // internet; with or without a Google account. * - // `allAuthenticatedUsers`: A special identifier that represents anyone - // who is authenticated with a Google account or a service account. Does - // not include identities that come from external identity providers - // (IdPs) through identity federation. * `user:{emailid}`: An email - // address that represents a specific Google account. For example, - // `alice@example.com` . * `serviceAccount:{emailid}`: An email address - // that represents a Google service account. For example, - // `my-other-app@appspot.gserviceaccount.com`. * - // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: - // An identifier for a Kubernetes service account - // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). - // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. - // * `group:{emailid}`: An email address that represents a Google group. - // For example, `admins@example.com`. * `domain:{domain}`: The G Suite - // domain (primary) that represents all the users of that domain. For - // example, `google.com` or `example.com`. * - // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus - // unique identifier) representing a user that has been recently - // deleted. For example, `alice@example.com?uid=123456789012345678901`. - // If the user is recovered, this value reverts to `user:{emailid}` and - // the recovered user retains the role in the binding. * - // `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address - // (plus unique identifier) representing a service account that has been - // recently deleted. For example, - // `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. - // If the service account is undeleted, this value reverts to - // `serviceAccount:{emailid}` and the undeleted service account retains - // the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: - // An email address (plus unique identifier) representing a Google group - // that has been recently deleted. For example, - // `admins@example.com?uid=123456789012345678901`. If the group is - // recovered, this value reverts to `group:{emailid}` and the recovered - // group retains the role in the binding. - Members []string `json:"members,omitempty"` + // FilterAlias: Output only. Field name to be used in filter while + // requesting configured insight filtered on this field. + FilterAlias string `json:"filterAlias,omitempty"` - // Role: Role that is assigned to the list of `members`, or principals. - // For example, `roles/viewer`, `roles/editor`, or `roles/owner`. - Role string `json:"role,omitempty"` + // Id: Output only. Field id. + Id string `json:"id,omitempty"` - // ForceSendFields is a list of field names (e.g. "Condition") to + // Value: Output only. Value of the field in string format. Acceptable + // values are strings or numbers. + Value string `json:"value,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DisplayName") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3356,109 +3360,37 @@ type GoogleIamV1Binding struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Condition") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "DisplayName") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *GoogleIamV1Binding) MarshalJSON() ([]byte, error) { - type NoMethod GoogleIamV1Binding +func (s *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRowFieldVal) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSaasplatformInsightsV1alphaRowFieldVal raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleIamV1Policy: An Identity and Access Management (IAM) policy, -// which specifies access controls for Google Cloud resources. A -// `Policy` is a collection of `bindings`. A `binding` binds one or more -// `members`, or principals, to a single `role`. Principals can be user -// accounts, service accounts, Google groups, and domains (such as G -// Suite). A `role` is a named list of permissions; each `role` can be -// an IAM predefined role or a user-created custom role. For some types -// of Google Cloud resources, a `binding` can also specify a -// `condition`, which is a logical expression that allows access to a -// resource only if the expression evaluates to `true`. A condition can -// add constraints based on attributes of the request, the resource, or -// both. To learn which resources support conditions in their IAM -// policies, see the IAM documentation -// (https://cloud.google.com/iam/help/conditions/resource-policies). -// **JSON example:** { "bindings": [ { "role": -// "roles/resourcemanager.organizationAdmin", "members": [ -// "user:mike@example.com", "group:admins@example.com", -// "domain:google.com", -// "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { -// "role": "roles/resourcemanager.organizationViewer", "members": [ -// "user:eve@example.com" ], "condition": { "title": "expirable access", -// "description": "Does not grant access after Sep 2020", "expression": -// "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], -// "etag": "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - -// members: - user:mike@example.com - group:admins@example.com - -// domain:google.com - -// serviceAccount:my-project-id@appspot.gserviceaccount.com role: -// roles/resourcemanager.organizationAdmin - members: - -// user:eve@example.com role: roles/resourcemanager.organizationViewer -// condition: title: expirable access description: Does not grant access -// after Sep 2020 expression: request.time < -// timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 -// For a description of IAM and its features, see the IAM documentation -// (https://cloud.google.com/iam/docs/). -type GoogleIamV1Policy struct { - // AuditConfigs: Specifies cloud audit logging configuration for this - // policy. - AuditConfigs []*GoogleIamV1AuditConfig `json:"auditConfigs,omitempty"` - - // Bindings: Associates a list of `members`, or principals, with a - // `role`. Optionally, may specify a `condition` that determines how and - // when the `bindings` are applied. Each of the `bindings` must contain - // at least one principal. The `bindings` in a `Policy` can refer to up - // to 1,500 principals; up to 250 of these principals can be Google - // groups. Each occurrence of a principal counts towards these limits. - // For example, if the `bindings` grant 50 different roles to - // `user:alice@example.com`, and not to any other principal, then you - // can add another 1,450 principals to the `bindings` in the `Policy`. - Bindings []*GoogleIamV1Binding `json:"bindings,omitempty"` - - // Etag: `etag` is used for optimistic concurrency control as a way to - // help prevent simultaneous updates of a policy from overwriting each - // other. It is strongly suggested that systems make use of the `etag` - // in the read-modify-write cycle to perform policy updates in order to - // avoid race conditions: An `etag` is returned in the response to - // `getIamPolicy`, and systems are expected to put that etag in the - // request to `setIamPolicy` to ensure that their change will be applied - // to the same version of the policy. **Important:** If you use IAM - // Conditions, you must include the `etag` field whenever you call - // `setIamPolicy`. If you omit this field, then IAM allows you to - // overwrite a version `3` policy with a version `1` policy, and all of - // the conditions in the version `3` policy are lost. - Etag string `json:"etag,omitempty"` +// GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaListSubscriptions +// Response: Response message for BeyondCorp.ListSubscriptions. +type GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaListSubscriptionsResponse struct { + // NextPageToken: A token to retrieve the next page of results, or empty + // if there are no more results in the list. + NextPageToken string `json:"nextPageToken,omitempty"` - // Version: Specifies the format of the policy. Valid values are `0`, - // `1`, and `3`. Requests that specify an invalid value are rejected. - // Any operation that affects conditional role bindings must specify - // version `3`. This requirement applies to the following operations: * - // Getting a policy that includes a conditional role binding * Adding a - // conditional role binding to a policy * Changing a conditional role - // binding in a policy * Removing any role binding, with or without a - // condition, from a policy that includes conditions **Important:** If - // you use IAM Conditions, you must include the `etag` field whenever - // you call `setIamPolicy`. If you omit this field, then IAM allows you - // to overwrite a version `3` policy with a version `1` policy, and all - // of the conditions in the version `3` policy are lost. If a policy - // does not include any conditions, operations on that policy may - // specify any valid version or leave the field unset. To learn which - // resources support conditions in their IAM policies, see the IAM - // documentation - // (https://cloud.google.com/iam/help/conditions/resource-policies). - Version int64 `json:"version,omitempty"` + // Subscriptions: A list of BeyondCorp Subscriptions in the + // organization. + Subscriptions []*GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription `json:"subscriptions,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "AuditConfigs") to + // 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. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3466,7 +3398,7 @@ type GoogleIamV1Policy struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AuditConfigs") to include + // 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. However, any field with // an empty value appearing in NullFields will be sent to the server as @@ -3475,28 +3407,67 @@ type GoogleIamV1Policy struct { NullFields []string `json:"-"` } -func (s *GoogleIamV1Policy) MarshalJSON() ([]byte, error) { - type NoMethod GoogleIamV1Policy +func (s *GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaListSubscriptionsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaListSubscriptionsResponse raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleIamV1SetIamPolicyRequest: Request message for `SetIamPolicy` -// method. -type GoogleIamV1SetIamPolicyRequest struct { - // Policy: REQUIRED: The complete policy to be applied to the - // `resource`. The size of the policy is limited to a few 10s of KB. An - // empty policy is a valid policy but certain Google Cloud services - // (such as Projects) might reject them. - Policy *GoogleIamV1Policy `json:"policy,omitempty"` +// GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription: A +// BeyondCorp Subscription resource represents BeyondCorp Enterprise +// Subscription. BeyondCorp Enterprise Subscription enables BeyondCorp +// Enterprise permium features for an organization. +type GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription struct { + // AutoRenewEnabled: Output only. Represents that, if subscription will + // renew or end when the term ends. + AutoRenewEnabled bool `json:"autoRenewEnabled,omitempty"` - // UpdateMask: OPTIONAL: A FieldMask specifying which fields of the - // policy to modify. Only the fields in the mask will be modified. If no - // mask is provided, the following default mask is used: `paths: - // "bindings, etag" - UpdateMask string `json:"updateMask,omitempty"` + // CreateTime: Output only. Create time of the subscription. + CreateTime string `json:"createTime,omitempty"` - // ForceSendFields is a list of field names (e.g. "Policy") to + // EndTime: Output only. End time of the subscription. + EndTime string `json:"endTime,omitempty"` + + // Name: Required. Unique resource name of the Subscription. The name is + // ignored when creating a subscription. + Name string `json:"name,omitempty"` + + // SeatCount: Output only. Number of seats in the subscription. + SeatCount int64 `json:"seatCount,omitempty,string"` + + // Sku: Required. SKU of subscription. + // + // Possible values: + // "SKU_UNSPECIFIED" - Default value. This value is unused. + // "BCE_STANDARD_SKU" - Represents BeyondCorp Standard SKU. + Sku string `json:"sku,omitempty"` + + // StartTime: Output only. Start time of the subscription. + StartTime string `json:"startTime,omitempty"` + + // State: Output only. The current state of the subscription. + // + // Possible values: + // "STATE_UNSPECIFIED" - Default value. This value is unused. + // "ACTIVE" - Represents an active subscription. + // "INACTIVE" - Represents an upcomming subscription. + // "COMPLETED" - Represents a completed subscription. + State string `json:"state,omitempty"` + + // Type: Required. Type of subscription. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Default value. This value is unused. + // "TRIAL" - Represents a trial subscription. + // "PAID" - Represents a paid subscription. + // "ALLOWLIST" - Reresents an allowlisted subscription. + Type string `json:"type,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "AutoRenewEnabled") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3504,65 +3475,37 @@ type GoogleIamV1SetIamPolicyRequest struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Policy") to include in API - // requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. + // NullFields is a list of field names (e.g. "AutoRenewEnabled") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. NullFields []string `json:"-"` } -func (s *GoogleIamV1SetIamPolicyRequest) MarshalJSON() ([]byte, error) { - type NoMethod GoogleIamV1SetIamPolicyRequest +func (s *GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleIamV1TestIamPermissionsRequest: Request message for -// `TestIamPermissions` method. -type GoogleIamV1TestIamPermissionsRequest struct { - // Permissions: The set of permissions to check for the `resource`. - // Permissions with wildcards (such as `*` or `storage.*`) are not - // allowed. For more information see IAM Overview - // (https://cloud.google.com/iam/docs/overview#permissions). - Permissions []string `json:"permissions,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Permissions") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Permissions") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *GoogleIamV1TestIamPermissionsRequest) MarshalJSON() ([]byte, error) { - type NoMethod GoogleIamV1TestIamPermissionsRequest - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} +// GoogleCloudLocationListLocationsResponse: The response message for +// Locations.ListLocations. +type GoogleCloudLocationListLocationsResponse struct { + // Locations: A list of locations that matches the specified filter in + // the request. + Locations []*GoogleCloudLocationLocation `json:"locations,omitempty"` -// GoogleIamV1TestIamPermissionsResponse: Response message for -// `TestIamPermissions` method. -type GoogleIamV1TestIamPermissionsResponse struct { - // Permissions: A subset of `TestPermissionsRequest.permissions` that - // the caller is allowed. - Permissions []string `json:"permissions,omitempty"` + // NextPageToken: The standard List next-page token. + 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. "Permissions") to + // 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. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3570,41 +3513,50 @@ type GoogleIamV1TestIamPermissionsResponse struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Permissions") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "Locations") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *GoogleIamV1TestIamPermissionsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleIamV1TestIamPermissionsResponse +func (s *GoogleCloudLocationListLocationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudLocationListLocationsResponse raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleLongrunningCancelOperationRequest: The request message for -// Operations.CancelOperation. -type GoogleLongrunningCancelOperationRequest struct { -} +// GoogleCloudLocationLocation: A resource that represents a Google +// Cloud location. +type GoogleCloudLocationLocation struct { + // DisplayName: The friendly name for this location, typically a nearby + // city name. For example, "Tokyo". + DisplayName string `json:"displayName,omitempty"` -// GoogleLongrunningListOperationsResponse: The response message for -// Operations.ListOperations. -type GoogleLongrunningListOperationsResponse struct { - // NextPageToken: The standard List next-page token. - NextPageToken string `json:"nextPageToken,omitempty"` + // Labels: Cross-service attributes for the location. For example + // {"cloud.googleapis.com/region": "us-east1"} + Labels map[string]string `json:"labels,omitempty"` - // Operations: A list of operations that matches the specified filter in - // the request. - Operations []*GoogleLongrunningOperation `json:"operations,omitempty"` + // LocationId: The canonical id for this location. For example: + // "us-east1". + LocationId string `json:"locationId,omitempty"` + + // Metadata: Service-specific metadata. For example the available + // capacity at the given location. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + + // Name: Resource name for the location, which may vary between + // implementations. For example: + // "projects/example-project/locations/us-east1" + Name string `json:"name,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 + // ForceSendFields is a list of field names (e.g. "DisplayName") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3612,7 +3564,7 @@ type GoogleLongrunningListOperationsResponse struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "NextPageToken") to include + // NullFields is a list of field names (e.g. "DisplayName") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as @@ -3621,52 +3573,41 @@ type GoogleLongrunningListOperationsResponse struct { NullFields []string `json:"-"` } -func (s *GoogleLongrunningListOperationsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleLongrunningListOperationsResponse +func (s *GoogleCloudLocationLocation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudLocationLocation raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleLongrunningOperation: This resource represents a long-running -// operation that is the result of a network API call. -type GoogleLongrunningOperation struct { - // Done: If the value is `false`, it means the operation is still in - // progress. If `true`, the operation is completed, and either `error` - // or `response` is available. - Done bool `json:"done,omitempty"` - - // Error: The error result of the operation in case of failure or - // cancellation. - Error *GoogleRpcStatus `json:"error,omitempty"` - - // Metadata: Service-specific metadata associated with the operation. It - // typically contains progress information and common metadata such as - // create time. Some services might not provide such metadata. Any - // method that returns a long-running operation should document the - // metadata type, if any. - Metadata googleapi.RawMessage `json:"metadata,omitempty"` - - // Name: The server-assigned name, which is only unique within the same - // service that originally returns it. If you use the default HTTP - // mapping, the `name` should be a resource name ending with - // `operations/{unique_id}`. - Name string `json:"name,omitempty"` - - // Response: The normal response of the operation in case of success. If - // the original method returns no data on success, such as `Delete`, the - // response is `google.protobuf.Empty`. If the original method is - // standard `Get`/`Create`/`Update`, the response should be the - // resource. For other methods, the response should have the type - // `XxxResponse`, where `Xxx` is the original method name. For example, - // if the original method name is `TakeSnapshot()`, the inferred - // response type is `TakeSnapshotResponse`. - Response googleapi.RawMessage `json:"response,omitempty"` +// GoogleIamV1AuditConfig: Specifies the audit configuration for a +// service. The configuration determines which permission types are +// logged, and what identities, if any, are exempted from logging. An +// AuditConfig must have one or more AuditLogConfigs. If there are +// AuditConfigs for both `allServices` and a specific service, the union +// of the two AuditConfigs is used for that service: the log_types +// specified in each AuditConfig are enabled, and the exempted_members +// in each AuditLogConfig are exempted. Example Policy with multiple +// AuditConfigs: { "audit_configs": [ { "service": "allServices", +// "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": +// [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { +// "log_type": "ADMIN_READ" } ] }, { "service": +// "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": +// "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ +// "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy +// enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts +// `jose@example.com` from DATA_READ logging, and `aliya@example.com` +// from DATA_WRITE logging. +type GoogleIamV1AuditConfig struct { + // AuditLogConfigs: The configuration for logging of each type of + // permission. + AuditLogConfigs []*GoogleIamV1AuditLogConfig `json:"auditLogConfigs,omitempty"` - // ServerResponse contains the HTTP response code and headers from the - // server. - googleapi.ServerResponse `json:"-"` + // Service: Specifies a service that will be enabled for audit logging. + // For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. + // `allServices` is a special value that covers all services. + Service string `json:"service,omitempty"` - // ForceSendFields is a list of field names (e.g. "Done") to + // ForceSendFields is a list of field names (e.g. "AuditLogConfigs") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3674,43 +3615,44 @@ type GoogleLongrunningOperation struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Done") to include in API - // requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. + // NullFields is a list of field names (e.g. "AuditLogConfigs") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. NullFields []string `json:"-"` } -func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { - type NoMethod GoogleLongrunningOperation +func (s *GoogleIamV1AuditConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamV1AuditConfig raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleRpcStatus: 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 GoogleRpcStatus 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"` +// GoogleIamV1AuditLogConfig: Provides the configuration for logging a +// type of permissions. Example: { "audit_log_configs": [ { "log_type": +// "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { +// "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and +// 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ +// logging. +type GoogleIamV1AuditLogConfig struct { + // ExemptedMembers: Specifies the identities that do not cause logging + // for this type of permission. Follows the same format of + // Binding.members. + ExemptedMembers []string `json:"exemptedMembers,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"` + // LogType: The log type that this config enables. + // + // Possible values: + // "LOG_TYPE_UNSPECIFIED" - Default case. Should never be this. + // "ADMIN_READ" - Admin reads. Example: CloudIAM getIamPolicy + // "DATA_WRITE" - Data writes. Example: CloudSQL Users create + // "DATA_READ" - Data reads. Example: CloudSQL Users list + LogType string `json:"logType,omitempty"` - // ForceSendFields is a list of field names (e.g. "Code") to + // ForceSendFields is a list of field names (e.g. "ExemptedMembers") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3718,59 +3660,79 @@ type GoogleRpcStatus struct { // This may be used to include empty fields in Patch requests. 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. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. + // NullFields is a list of field names (e.g. "ExemptedMembers") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. NullFields []string `json:"-"` } -func (s *GoogleRpcStatus) MarshalJSON() ([]byte, error) { - type NoMethod GoogleRpcStatus +func (s *GoogleIamV1AuditLogConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamV1AuditLogConfig raw := NoMethod(*s) return gensupport.MarshalJSON(raw, 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"` +// GoogleIamV1Binding: Associates `members`, or principals, with a +// `role`. +type GoogleIamV1Binding struct { + // Condition: The condition that is associated with this binding. If the + // condition evaluates to `true`, then this binding applies to the + // current request. If the condition evaluates to `false`, then this + // binding does not apply to the current request. However, a different + // role binding might grant the same role to one or more of the + // principals in this binding. To learn which resources support + // conditions in their IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). + Condition *GoogleTypeExpr `json:"condition,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"` + // Members: Specifies the principals requesting access for a Google + // Cloud resource. `members` can have the following values: * + // `allUsers`: A special identifier that represents anyone who is on the + // internet; with or without a Google account. * + // `allAuthenticatedUsers`: A special identifier that represents anyone + // who is authenticated with a Google account or a service account. Does + // not include identities that come from external identity providers + // (IdPs) through identity federation. * `user:{emailid}`: An email + // address that represents a specific Google account. For example, + // `alice@example.com` . * `serviceAccount:{emailid}`: An email address + // that represents a Google service account. For example, + // `my-other-app@appspot.gserviceaccount.com`. * + // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: + // An identifier for a Kubernetes service account + // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). + // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. + // * `group:{emailid}`: An email address that represents a Google group. + // For example, `admins@example.com`. * `domain:{domain}`: The G Suite + // domain (primary) that represents all the users of that domain. For + // example, `google.com` or `example.com`. * + // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus + // unique identifier) representing a user that has been recently + // deleted. For example, `alice@example.com?uid=123456789012345678901`. + // If the user is recovered, this value reverts to `user:{emailid}` and + // the recovered user retains the role in the binding. * + // `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address + // (plus unique identifier) representing a service account that has been + // recently deleted. For example, + // `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. + // If the service account is undeleted, this value reverts to + // `serviceAccount:{emailid}` and the undeleted service account retains + // the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: + // An email address (plus unique identifier) representing a Google group + // that has been recently deleted. For example, + // `admins@example.com?uid=123456789012345678901`. If the group is + // recovered, this value reverts to `group:{emailid}` and the recovered + // group retains the role in the binding. + Members []string `json:"members,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"` + // Role: Role that is assigned to the list of `members`, or principals. + // For example, `roles/viewer`, `roles/editor`, or `roles/owner`. + Role string `json:"role,omitempty"` - // ForceSendFields is a list of field names (e.g. "Description") to + // ForceSendFields is a list of field names (e.g. "Condition") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3778,32 +3740,109 @@ type GoogleTypeExpr struct { // This may be used to include empty fields in Patch requests. 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. However, any field with - // an empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "Condition") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *GoogleTypeExpr) MarshalJSON() ([]byte, error) { - type NoMethod GoogleTypeExpr +func (s *GoogleIamV1Binding) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamV1Binding raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ImageConfig: ImageConfig defines the control plane images to run. -type ImageConfig struct { - // StableImage: The stable image that the remote agent will fallback to - // if the target image fails. - StableImage string `json:"stableImage,omitempty"` +// GoogleIamV1Policy: An Identity and Access Management (IAM) policy, +// which specifies access controls for Google Cloud resources. A +// `Policy` is a collection of `bindings`. A `binding` binds one or more +// `members`, or principals, to a single `role`. Principals can be user +// accounts, service accounts, Google groups, and domains (such as G +// Suite). A `role` is a named list of permissions; each `role` can be +// an IAM predefined role or a user-created custom role. For some types +// of Google Cloud resources, a `binding` can also specify a +// `condition`, which is a logical expression that allows access to a +// resource only if the expression evaluates to `true`. A condition can +// add constraints based on attributes of the request, the resource, or +// both. To learn which resources support conditions in their IAM +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": +// "roles/resourcemanager.organizationAdmin", "members": [ +// "user:mike@example.com", "group:admins@example.com", +// "domain:google.com", +// "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { +// "role": "roles/resourcemanager.organizationViewer", "members": [ +// "user:eve@example.com" ], "condition": { "title": "expirable access", +// "description": "Does not grant access after Sep 2020", "expression": +// "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], +// "etag": "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - +// members: - user:mike@example.com - group:admins@example.com - +// domain:google.com - +// serviceAccount:my-project-id@appspot.gserviceaccount.com role: +// roles/resourcemanager.organizationAdmin - members: - +// user:eve@example.com role: roles/resourcemanager.organizationViewer +// condition: title: expirable access description: Does not grant access +// after Sep 2020 expression: request.time < +// timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 +// For a description of IAM and its features, see the IAM documentation +// (https://cloud.google.com/iam/docs/). +type GoogleIamV1Policy struct { + // AuditConfigs: Specifies cloud audit logging configuration for this + // policy. + AuditConfigs []*GoogleIamV1AuditConfig `json:"auditConfigs,omitempty"` - // TargetImage: The initial image the remote agent will attempt to run - // for the control plane. - TargetImage string `json:"targetImage,omitempty"` + // Bindings: Associates a list of `members`, or principals, with a + // `role`. Optionally, may specify a `condition` that determines how and + // when the `bindings` are applied. Each of the `bindings` must contain + // at least one principal. The `bindings` in a `Policy` can refer to up + // to 1,500 principals; up to 250 of these principals can be Google + // groups. Each occurrence of a principal counts towards these limits. + // For example, if the `bindings` grant 50 different roles to + // `user:alice@example.com`, and not to any other principal, then you + // can add another 1,450 principals to the `bindings` in the `Policy`. + Bindings []*GoogleIamV1Binding `json:"bindings,omitempty"` - // ForceSendFields is a list of field names (e.g. "StableImage") to + // Etag: `etag` is used for optimistic concurrency control as a way to + // help prevent simultaneous updates of a policy from overwriting each + // other. It is strongly suggested that systems make use of the `etag` + // in the read-modify-write cycle to perform policy updates in order to + // avoid race conditions: An `etag` is returned in the response to + // `getIamPolicy`, and systems are expected to put that etag in the + // request to `setIamPolicy` to ensure that their change will be applied + // to the same version of the policy. **Important:** If you use IAM + // Conditions, you must include the `etag` field whenever you call + // `setIamPolicy`. If you omit this field, then IAM allows you to + // overwrite a version `3` policy with a version `1` policy, and all of + // the conditions in the version `3` policy are lost. + Etag string `json:"etag,omitempty"` + + // Version: Specifies the format of the policy. Valid values are `0`, + // `1`, and `3`. Requests that specify an invalid value are rejected. + // Any operation that affects conditional role bindings must specify + // version `3`. This requirement applies to the following operations: * + // Getting a policy that includes a conditional role binding * Adding a + // conditional role binding to a policy * Changing a conditional role + // binding in a policy * Removing any role binding, with or without a + // condition, from a policy that includes conditions **Important:** If + // you use IAM Conditions, you must include the `etag` field whenever + // you call `setIamPolicy`. If you omit this field, then IAM allows you + // to overwrite a version `3` policy with a version `1` policy, and all + // of the conditions in the version `3` policy are lost. If a policy + // does not include any conditions, operations on that policy may + // specify any valid version or leave the field unset. To learn which + // resources support conditions in their IAM policies, see the IAM + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). + Version int64 `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. "AuditConfigs") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3811,7 +3850,7 @@ type ImageConfig struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "StableImage") to include + // NullFields is a list of field names (e.g. "AuditConfigs") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as @@ -3820,19 +3859,28 @@ type ImageConfig struct { NullFields []string `json:"-"` } -func (s *ImageConfig) MarshalJSON() ([]byte, error) { - type NoMethod ImageConfig +func (s *GoogleIamV1Policy) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamV1Policy raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Ingress: Settings of how to connect to the ClientGateway. One of the -// following options should be set. -type Ingress struct { - // Config: The basic ingress config for ClientGateways. - Config *Config `json:"config,omitempty"` +// GoogleIamV1SetIamPolicyRequest: Request message for `SetIamPolicy` +// method. +type GoogleIamV1SetIamPolicyRequest struct { + // Policy: REQUIRED: The complete policy to be applied to the + // `resource`. The size of the policy is limited to a few 10s of KB. An + // empty policy is a valid policy but certain Google Cloud services + // (such as Projects) might reject them. + Policy *GoogleIamV1Policy `json:"policy,omitempty"` - // ForceSendFields is a list of field names (e.g. "Config") to + // UpdateMask: OPTIONAL: A FieldMask specifying which fields of the + // policy to modify. Only the fields in the mask will be modified. If no + // mask is provided, the following default mask is used: `paths: + // "bindings, etag" + UpdateMask string `json:"updateMask,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Policy") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3840,7 +3888,7 @@ type Ingress struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Config") to include in API + // NullFields is a list of field names (e.g. "Policy") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as @@ -3849,30 +3897,22 @@ type Ingress struct { NullFields []string `json:"-"` } -func (s *Ingress) MarshalJSON() ([]byte, error) { - type NoMethod Ingress +func (s *GoogleIamV1SetIamPolicyRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamV1SetIamPolicyRequest raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ListAppGatewaysResponse: Response message for -// BeyondCorp.ListAppGateways. -type ListAppGatewaysResponse struct { - // AppGateways: A list of BeyondCorp AppGateways in the project. - AppGateways []*AppGateway `json:"appGateways,omitempty"` - - // NextPageToken: A token to retrieve the next page of results, or empty - // if there are no more results in the list. - NextPageToken string `json:"nextPageToken,omitempty"` - - // Unreachable: A list of locations that could not be reached. - Unreachable []string `json:"unreachable,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the - // server. - googleapi.ServerResponse `json:"-"` +// GoogleIamV1TestIamPermissionsRequest: Request message for +// `TestIamPermissions` method. +type GoogleIamV1TestIamPermissionsRequest struct { + // Permissions: The set of permissions to check for the `resource`. + // Permissions with wildcards (such as `*` or `storage.*`) are not + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). + Permissions []string `json:"permissions,omitempty"` - // ForceSendFields is a list of field names (e.g. "AppGateways") to + // ForceSendFields is a list of field names (e.g. "Permissions") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3880,7 +3920,7 @@ type ListAppGatewaysResponse struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AppGateways") to include + // NullFields is a list of field names (e.g. "Permissions") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as @@ -3889,72 +3929,24 @@ type ListAppGatewaysResponse struct { NullFields []string `json:"-"` } -func (s *ListAppGatewaysResponse) MarshalJSON() ([]byte, error) { - type NoMethod ListAppGatewaysResponse +func (s *GoogleIamV1TestIamPermissionsRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamV1TestIamPermissionsRequest raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ListClientConnectorServicesResponse: Message for response to listing -// ClientConnectorServices. -type ListClientConnectorServicesResponse struct { - // ClientConnectorServices: The list of ClientConnectorService. - ClientConnectorServices []*ClientConnectorService `json:"clientConnectorServices,omitempty"` - - // NextPageToken: A token identifying a page of results the server - // should return. - NextPageToken string `json:"nextPageToken,omitempty"` - - // Unreachable: Locations that could not be reached. - 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. - // "ClientConnectorServices") to unconditionally include in API - // requests. By default, fields with empty or default values are omitted - // from API requests. However, any non-pointer, non-interface field - // appearing in ForceSendFields will be sent to the server regardless of - // whether the field is empty or not. This may be used to include empty - // fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "ClientConnectorServices") - // to include in API requests with the JSON null value. By default, - // fields with empty values are omitted from API requests. However, any - // field with an empty value appearing in NullFields will be sent to the - // server as null. It is an error if a field in this list has a - // non-empty value. This may be used to include null fields in Patch - // requests. - NullFields []string `json:"-"` -} - -func (s *ListClientConnectorServicesResponse) MarshalJSON() ([]byte, error) { - type NoMethod ListClientConnectorServicesResponse - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - -// ListClientGatewaysResponse: Message for response to listing -// ClientGateways. -type ListClientGatewaysResponse struct { - // ClientGateways: The list of ClientGateway. - ClientGateways []*ClientGateway `json:"clientGateways,omitempty"` - - // NextPageToken: A token identifying a page of results the server - // should return. - NextPageToken string `json:"nextPageToken,omitempty"` - - // Unreachable: Locations that could not be reached. - Unreachable []string `json:"unreachable,omitempty"` +// GoogleIamV1TestIamPermissionsResponse: Response message for +// `TestIamPermissions` method. +type GoogleIamV1TestIamPermissionsResponse struct { + // Permissions: A subset of `TestPermissionsRequest.permissions` that + // the caller is allowed. + Permissions []string `json:"permissions,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "ClientGateways") to + // ForceSendFields is a list of field names (e.g. "Permissions") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3962,40 +3954,41 @@ type ListClientGatewaysResponse struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ClientGateways") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the - // server as null. It is an error if a field in this list has a - // non-empty value. This may be used to include null fields in Patch - // requests. + // NullFields is a list of field names (e.g. "Permissions") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *ListClientGatewaysResponse) MarshalJSON() ([]byte, error) { - type NoMethod ListClientGatewaysResponse +func (s *GoogleIamV1TestIamPermissionsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamV1TestIamPermissionsResponse raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ListConnectionsResponse: Response message for -// BeyondCorp.ListConnections. -type ListConnectionsResponse struct { - // Connections: A list of BeyondCorp Connections in the project. - Connections []*Connection `json:"connections,omitempty"` +// GoogleLongrunningCancelOperationRequest: The request message for +// Operations.CancelOperation. +type GoogleLongrunningCancelOperationRequest struct { +} - // NextPageToken: A token to retrieve the next page of results, or empty - // if there are no more results in the list. +// GoogleLongrunningListOperationsResponse: The response message for +// Operations.ListOperations. +type GoogleLongrunningListOperationsResponse struct { + // NextPageToken: The standard List next-page token. NextPageToken string `json:"nextPageToken,omitempty"` - // Unreachable: A list of locations that could not be reached. - Unreachable []string `json:"unreachable,omitempty"` + // Operations: A list of operations that matches the specified filter in + // the request. + Operations []*GoogleLongrunningOperation `json:"operations,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "Connections") to + // 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. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -4003,7 +3996,7 @@ type ListConnectionsResponse struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Connections") to include + // 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. However, any field with // an empty value appearing in NullFields will be sent to the server as @@ -4012,30 +4005,52 @@ type ListConnectionsResponse struct { NullFields []string `json:"-"` } -func (s *ListConnectionsResponse) MarshalJSON() ([]byte, error) { - type NoMethod ListConnectionsResponse +func (s *GoogleLongrunningListOperationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleLongrunningListOperationsResponse raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ListConnectorsResponse: Response message for -// BeyondCorp.ListConnectors. -type ListConnectorsResponse struct { - // Connectors: A list of BeyondCorp Connectors in the project. - Connectors []*Connector `json:"connectors,omitempty"` +// GoogleLongrunningOperation: This resource represents a long-running +// operation that is the result of a network API call. +type GoogleLongrunningOperation struct { + // Done: If the value is `false`, it means the operation is still in + // progress. If `true`, the operation is completed, and either `error` + // or `response` is available. + Done bool `json:"done,omitempty"` - // NextPageToken: A token to retrieve the next page of results, or empty - // if there are no more results in the list. - NextPageToken string `json:"nextPageToken,omitempty"` + // Error: The error result of the operation in case of failure or + // cancellation. + Error *GoogleRpcStatus `json:"error,omitempty"` - // Unreachable: A list of locations that could not be reached. - Unreachable []string `json:"unreachable,omitempty"` + // Metadata: Service-specific metadata associated with the operation. It + // typically contains progress information and common metadata such as + // create time. Some services might not provide such metadata. Any + // method that returns a long-running operation should document the + // metadata type, if any. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + + // Name: The server-assigned name, which is only unique within the same + // service that originally returns it. If you use the default HTTP + // mapping, the `name` should be a resource name ending with + // `operations/{unique_id}`. + Name string `json:"name,omitempty"` + + // Response: The normal response of the operation in case of success. If + // the original method returns no data on success, such as `Delete`, the + // response is `google.protobuf.Empty`. If the original method is + // standard `Get`/`Create`/`Update`, the response should be the + // resource. For other methods, the response should have the type + // `XxxResponse`, where `Xxx` is the original method name. For example, + // if the original method name is `TakeSnapshot()`, the inferred + // response type is `TakeSnapshotResponse`. + 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. "Connectors") to + // 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. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -4043,8 +4058,8 @@ type ListConnectorsResponse struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Connectors") to include in - // API requests with the JSON null value. By default, fields with empty + // NullFields is a list of field names (e.g. "Done") to include in API + // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. @@ -4052,50 +4067,94 @@ type ListConnectorsResponse struct { NullFields []string `json:"-"` } -func (s *ListConnectorsResponse) MarshalJSON() ([]byte, error) { - type NoMethod ListConnectorsResponse +func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleLongrunningOperation raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// NotificationConfig: NotificationConfig defines the mechanisms to -// notify instance agent. -type NotificationConfig struct { - // PubsubNotification: Pub/Sub topic for Connector to subscribe and - // receive notifications from `projects/{project}/topics/{pubsub_topic}` - PubsubNotification *CloudPubSubNotificationConfig `json:"pubsubNotification,omitempty"` +// GoogleRpcStatus: 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 GoogleRpcStatus struct { + // Code: The status code, which should be an enum value of + // google.rpc.Code. + Code int64 `json:"code,omitempty"` - // ForceSendFields is a list of field names (e.g. "PubsubNotification") - // to unconditionally include in API requests. By default, fields with + // 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. However, any // non-pointer, non-interface field appearing in ForceSendFields will be // sent to the server regardless of whether the field is empty or not. // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PubsubNotification") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the - // server as null. It is an error if a field in this list has a - // non-empty value. This may be used to include null fields in Patch - // requests. + // NullFields 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. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *NotificationConfig) MarshalJSON() ([]byte, error) { - type NoMethod NotificationConfig +func (s *GoogleRpcStatus) MarshalJSON() ([]byte, error) { + type NoMethod GoogleRpcStatus raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// PeeredVpc: The peered VPC owned by the consumer project. -type PeeredVpc struct { - // NetworkVpc: Required. The name of the peered VPC owned by the - // consumer project. - NetworkVpc string `json:"networkVpc,omitempty"` +// 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"` - // ForceSendFields is a list of field names (e.g. "NetworkVpc") to + // 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. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -4103,79 +4162,61 @@ type PeeredVpc struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "NetworkVpc") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as + // 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. However, any field with + // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *PeeredVpc) MarshalJSON() ([]byte, error) { - type NoMethod PeeredVpc +func (s *GoogleTypeExpr) MarshalJSON() ([]byte, error) { + type NoMethod GoogleTypeExpr raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// PrincipalInfo: PrincipalInfo represents an Identity oneof. -type PrincipalInfo struct { - // ServiceAccount: A GCP service account. - ServiceAccount *ServiceAccount `json:"serviceAccount,omitempty"` - - // ForceSendFields is a list of field names (e.g. "ServiceAccount") to - // unconditionally include in API requests. By default, fields with +// ImageConfig: ImageConfig defines the control plane images to run. +type ImageConfig struct { + // StableImage: The stable image that the remote agent will fallback to + // if the target image fails. + StableImage string `json:"stableImage,omitempty"` + + // TargetImage: The initial image the remote agent will attempt to run + // for the control plane. + TargetImage string `json:"targetImage,omitempty"` + + // ForceSendFields is a list of field names (e.g. "StableImage") to + // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be // sent to the server regardless of whether the field is empty or not. // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ServiceAccount") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the - // server as null. It is an error if a field in this list has a - // non-empty value. This may be used to include null fields in Patch - // requests. + // NullFields is a list of field names (e.g. "StableImage") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *PrincipalInfo) MarshalJSON() ([]byte, error) { - type NoMethod PrincipalInfo +func (s *ImageConfig) MarshalJSON() ([]byte, error) { + type NoMethod ImageConfig raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// RemoteAgentDetails: RemoteAgentDetails reflects the details of a -// remote agent. -type RemoteAgentDetails struct { -} - -// ReportStatusRequest: Request report the connector status. -type ReportStatusRequest struct { - // RequestId: Optional. 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. The server will guarantee that for at least 60 minutes - // since the first request. 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). - RequestId string `json:"requestId,omitempty"` - - // ResourceInfo: Required. Resource info of the connector. - ResourceInfo *ResourceInfo `json:"resourceInfo,omitempty"` - - // ValidateOnly: Optional. If set, validates request by executing a - // dry-run which would not alter the resource in any way. - ValidateOnly bool `json:"validateOnly,omitempty"` +// Ingress: Settings of how to connect to the ClientGateway. One of the +// following options should be set. +type Ingress struct { + // Config: The basic ingress config for ClientGateways. + Config *Config `json:"config,omitempty"` - // ForceSendFields is a list of field names (e.g. "RequestId") to + // 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. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -4183,8 +4224,8 @@ type ReportStatusRequest struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // 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 + // 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. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. @@ -4192,18 +4233,17 @@ type ReportStatusRequest struct { NullFields []string `json:"-"` } -func (s *ReportStatusRequest) MarshalJSON() ([]byte, error) { - type NoMethod ReportStatusRequest +func (s *Ingress) MarshalJSON() ([]byte, error) { + type NoMethod Ingress raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ResolveConnectionsResponse: Response message for -// BeyondCorp.ResolveConnections. -type ResolveConnectionsResponse struct { - // ConnectionDetails: A list of BeyondCorp Connections with details in - // the project. - ConnectionDetails []*ConnectionDetails `json:"connectionDetails,omitempty"` +// ListAppGatewaysResponse: Response message for +// BeyondCorp.ListAppGateways. +type ListAppGatewaysResponse struct { + // AppGateways: A list of BeyondCorp AppGateways in the project. + AppGateways []*AppGateway `json:"appGateways,omitempty"` // NextPageToken: A token to retrieve the next page of results, or empty // if there are no more results in the list. @@ -4216,41 +4256,89 @@ type ResolveConnectionsResponse struct { // server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "ConnectionDetails") - // to unconditionally include in API requests. By default, fields with + // ForceSendFields is a list of field names (e.g. "AppGateways") to + // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be // sent to the server regardless of whether the field is empty or not. // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ConnectionDetails") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the + // NullFields is a list of field names (e.g. "AppGateways") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListAppGatewaysResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListAppGatewaysResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListClientConnectorServicesResponse: Message for response to listing +// ClientConnectorServices. +type ListClientConnectorServicesResponse struct { + // ClientConnectorServices: The list of ClientConnectorService. + ClientConnectorServices []*ClientConnectorService `json:"clientConnectorServices,omitempty"` + + // NextPageToken: A token identifying a page of results the server + // should return. + NextPageToken string `json:"nextPageToken,omitempty"` + + // Unreachable: Locations that could not be reached. + 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. + // "ClientConnectorServices") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted + // from API requests. However, any non-pointer, non-interface field + // appearing in ForceSendFields will be sent to the server regardless of + // whether the field is empty or not. This may be used to include empty + // fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ClientConnectorServices") + // to include in API requests with the JSON null value. By default, + // fields with empty values are omitted from API requests. However, any + // field with an empty value appearing in NullFields will be sent to the // server as null. It is an error if a field in this list has a // non-empty value. This may be used to include null fields in Patch // requests. NullFields []string `json:"-"` } -func (s *ResolveConnectionsResponse) MarshalJSON() ([]byte, error) { - type NoMethod ResolveConnectionsResponse +func (s *ListClientConnectorServicesResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListClientConnectorServicesResponse raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ResolveInstanceConfigResponse: Response message for -// BeyondCorp.ResolveInstanceConfig. -type ResolveInstanceConfigResponse struct { - // InstanceConfig: ConnectorInstanceConfig. - InstanceConfig *ConnectorInstanceConfig `json:"instanceConfig,omitempty"` +// ListClientGatewaysResponse: Message for response to listing +// ClientGateways. +type ListClientGatewaysResponse struct { + // ClientGateways: The list of ClientGateway. + ClientGateways []*ClientGateway `json:"clientGateways,omitempty"` + + // NextPageToken: A token identifying a page of results the server + // should return. + NextPageToken string `json:"nextPageToken,omitempty"` + + // Unreachable: Locations that could not be reached. + 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. "InstanceConfig") to + // ForceSendFields is a list of field names (e.g. "ClientGateways") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -4258,7 +4346,7 @@ type ResolveInstanceConfigResponse struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "InstanceConfig") to + // NullFields is a list of field names (e.g. "ClientGateways") to // include in API requests with the JSON null value. By default, fields // with empty values are omitted from API requests. However, any field // with an empty value appearing in NullFields will be sent to the @@ -4268,41 +4356,30 @@ type ResolveInstanceConfigResponse struct { NullFields []string `json:"-"` } -func (s *ResolveInstanceConfigResponse) MarshalJSON() ([]byte, error) { - type NoMethod ResolveInstanceConfigResponse +func (s *ListClientGatewaysResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListClientGatewaysResponse raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ResourceInfo: ResourceInfo represents the information/status of the -// associated resource. -type ResourceInfo struct { - // Id: Required. Unique Id for the resource. - Id string `json:"id,omitempty"` - - // Resource: Specific details for the resource. - Resource googleapi.RawMessage `json:"resource,omitempty"` +// ListConnectionsResponse: Response message for +// BeyondCorp.ListConnections. +type ListConnectionsResponse struct { + // Connections: A list of BeyondCorp Connections in the project. + Connections []*Connection `json:"connections,omitempty"` - // Status: Overall health status. Overall status is derived based on the - // status of each sub level resources. - // - // Possible values: - // "HEALTH_STATUS_UNSPECIFIED" - Health status is unknown: not - // initialized or failed to retrieve. - // "HEALTHY" - The resource is healthy. - // "UNHEALTHY" - The resource is unhealthy. - // "UNRESPONSIVE" - The resource is unresponsive. - // "DEGRADED" - Some sub-resources are UNHEALTHY. - Status string `json:"status,omitempty"` + // NextPageToken: A token to retrieve the next page of results, or empty + // if there are no more results in the list. + NextPageToken string `json:"nextPageToken,omitempty"` - // Sub: List of Info for the sub level resources. - Sub []*ResourceInfo `json:"sub,omitempty"` + // Unreachable: A list of locations that could not be reached. + Unreachable []string `json:"unreachable,omitempty"` - // Time: The timestamp to collect the info. It is suggested to be set by - // the topmost level resource only. - Time string `json:"time,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 + // ForceSendFields is a list of field names (e.g. "Connections") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -4310,27 +4387,39 @@ type ResourceInfo struct { // This may be used to include empty fields in Patch requests. 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. However, any field with an - // empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "Connections") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *ResourceInfo) MarshalJSON() ([]byte, error) { - type NoMethod ResourceInfo +func (s *ListConnectionsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListConnectionsResponse raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ServiceAccount: ServiceAccount represents a GCP service account. -type ServiceAccount struct { - // Email: Email address of the service account. - Email string `json:"email,omitempty"` +// ListConnectorsResponse: Response message for +// BeyondCorp.ListConnectors. +type ListConnectorsResponse struct { + // Connectors: A list of BeyondCorp Connectors in the project. + Connectors []*Connector `json:"connectors,omitempty"` - // ForceSendFields is a list of field names (e.g. "Email") to + // NextPageToken: A token to retrieve the next page of results, or empty + // if there are no more results in the list. + NextPageToken string `json:"nextPageToken,omitempty"` + + // Unreachable: A list of locations that could not be reached. + 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. "Connectors") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -4338,8 +4427,8 @@ type ServiceAccount struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Email") to include in API - // requests with the JSON null value. By default, fields with empty + // NullFields is a list of field names (e.g. "Connectors") to include in + // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. @@ -4347,23 +4436,50 @@ type ServiceAccount struct { NullFields []string `json:"-"` } -func (s *ServiceAccount) MarshalJSON() ([]byte, error) { - type NoMethod ServiceAccount +func (s *ListConnectorsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListConnectorsResponse raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Tunnelv1ProtoTunnelerError: TunnelerError is an error proto for -// errors returned by the connection manager. -type Tunnelv1ProtoTunnelerError struct { - // Err: Original raw error - Err string `json:"err,omitempty"` +// NotificationConfig: NotificationConfig defines the mechanisms to +// notify instance agent. +type NotificationConfig struct { + // PubsubNotification: Pub/Sub topic for Connector to subscribe and + // receive notifications from `projects/{project}/topics/{pubsub_topic}` + PubsubNotification *CloudPubSubNotificationConfig `json:"pubsubNotification,omitempty"` - // Retryable: retryable isn't used for now, but we may want to reuse it - // in the future. - Retryable bool `json:"retryable,omitempty"` + // ForceSendFields is a list of field names (e.g. "PubsubNotification") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` - // ForceSendFields is a list of field names (e.g. "Err") to + // NullFields is a list of field names (e.g. "PubsubNotification") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *NotificationConfig) MarshalJSON() ([]byte, error) { + type NoMethod NotificationConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// PeeredVpc: The peered VPC owned by the consumer project. +type PeeredVpc struct { + // NetworkVpc: Required. The name of the peered VPC owned by the + // consumer project. + NetworkVpc string `json:"networkVpc,omitempty"` + + // ForceSendFields is a list of field names (e.g. "NetworkVpc") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -4371,8 +4487,8 @@ type Tunnelv1ProtoTunnelerError struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Err") to include in API - // requests with the JSON null value. By default, fields with empty + // NullFields is a list of field names (e.g. "NetworkVpc") to include in + // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. @@ -4380,37 +4496,111 @@ type Tunnelv1ProtoTunnelerError struct { NullFields []string `json:"-"` } -func (s *Tunnelv1ProtoTunnelerError) MarshalJSON() ([]byte, error) { - type NoMethod Tunnelv1ProtoTunnelerError +func (s *PeeredVpc) MarshalJSON() ([]byte, error) { + type NoMethod PeeredVpc raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Tunnelv1ProtoTunnelerInfo: TunnelerInfo contains metadata about -// tunneler launched by connection manager. -type Tunnelv1ProtoTunnelerInfo struct { - // BackoffRetryCount: backoff_retry_count stores the number of times the - // tunneler has been retried by tunManager for current backoff sequence. - // Gets reset to 0 if time difference between 2 consecutive retries - // exceeds backoffRetryResetTime. - BackoffRetryCount int64 `json:"backoffRetryCount,omitempty"` +// PrincipalInfo: PrincipalInfo represents an Identity oneof. +type PrincipalInfo struct { + // ServiceAccount: A GCP service account. + ServiceAccount *ServiceAccount `json:"serviceAccount,omitempty"` - // Id: id is the unique id of a tunneler. - Id string `json:"id,omitempty"` + // ForceSendFields is a list of field names (e.g. "ServiceAccount") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` - // LatestErr: latest_err stores the Error for the latest tunneler - // failure. Gets reset everytime the tunneler is retried by tunManager. - LatestErr *Tunnelv1ProtoTunnelerError `json:"latestErr,omitempty"` + // NullFields is a list of field names (e.g. "ServiceAccount") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} - // LatestRetryTime: latest_retry_time stores the time when the tunneler - // was last restarted. - LatestRetryTime string `json:"latestRetryTime,omitempty"` +func (s *PrincipalInfo) MarshalJSON() ([]byte, error) { + type NoMethod PrincipalInfo + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} - // TotalRetryCount: total_retry_count stores the total number of times - // the tunneler has been retried by tunManager. - TotalRetryCount int64 `json:"totalRetryCount,omitempty"` +// RemoteAgentDetails: RemoteAgentDetails reflects the details of a +// remote agent. +type RemoteAgentDetails struct { +} - // ForceSendFields is a list of field names (e.g. "BackoffRetryCount") +// ReportStatusRequest: Request report the connector status. +type ReportStatusRequest struct { + // RequestId: Optional. 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. The server will guarantee that for at least 60 minutes + // since the first request. 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). + RequestId string `json:"requestId,omitempty"` + + // ResourceInfo: Required. Resource info of the connector. + ResourceInfo *ResourceInfo `json:"resourceInfo,omitempty"` + + // ValidateOnly: Optional. If set, validates request by executing a + // dry-run which would not alter the resource in any way. + ValidateOnly bool `json:"validateOnly,omitempty"` + + // 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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "RequestId") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ReportStatusRequest) MarshalJSON() ([]byte, error) { + type NoMethod ReportStatusRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ResolveConnectionsResponse: Response message for +// BeyondCorp.ResolveConnections. +type ResolveConnectionsResponse struct { + // ConnectionDetails: A list of BeyondCorp Connections with details in + // the project. + ConnectionDetails []*ConnectionDetails `json:"connectionDetails,omitempty"` + + // NextPageToken: A token to retrieve the next page of results, or empty + // if there are no more results in the list. + NextPageToken string `json:"nextPageToken,omitempty"` + + // Unreachable: A list of locations that could not be reached. + 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. "ConnectionDetails") // to unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -4418,7 +4608,7 @@ type Tunnelv1ProtoTunnelerInfo struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BackoffRetryCount") to + // NullFields is a list of field names (e.g. "ConnectionDetails") to // include in API requests with the JSON null value. By default, fields // with empty values are omitted from API requests. However, any field // with an empty value appearing in NullFields will be sent to the @@ -4428,12 +4618,844 @@ type Tunnelv1ProtoTunnelerInfo struct { NullFields []string `json:"-"` } -func (s *Tunnelv1ProtoTunnelerInfo) MarshalJSON() ([]byte, error) { - type NoMethod Tunnelv1ProtoTunnelerInfo +func (s *ResolveConnectionsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ResolveConnectionsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ResolveInstanceConfigResponse: Response message for +// BeyondCorp.ResolveInstanceConfig. +type ResolveInstanceConfigResponse struct { + // InstanceConfig: ConnectorInstanceConfig. + InstanceConfig *ConnectorInstanceConfig `json:"instanceConfig,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "InstanceConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "InstanceConfig") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *ResolveInstanceConfigResponse) MarshalJSON() ([]byte, error) { + type NoMethod ResolveInstanceConfigResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ResourceInfo: ResourceInfo represents the information/status of the +// associated resource. +type ResourceInfo struct { + // Id: Required. Unique Id for the resource. + Id string `json:"id,omitempty"` + + // Resource: Specific details for the resource. + Resource googleapi.RawMessage `json:"resource,omitempty"` + + // Status: Overall health status. Overall status is derived based on the + // status of each sub level resources. + // + // Possible values: + // "HEALTH_STATUS_UNSPECIFIED" - Health status is unknown: not + // initialized or failed to retrieve. + // "HEALTHY" - The resource is healthy. + // "UNHEALTHY" - The resource is unhealthy. + // "UNRESPONSIVE" - The resource is unresponsive. + // "DEGRADED" - Some sub-resources are UNHEALTHY. + Status string `json:"status,omitempty"` + + // Sub: List of Info for the sub level resources. + Sub []*ResourceInfo `json:"sub,omitempty"` + + // Time: The timestamp to collect the info. It is suggested to be set by + // the topmost level resource only. + Time string `json:"time,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Id") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ResourceInfo) MarshalJSON() ([]byte, error) { + type NoMethod ResourceInfo raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ServiceAccount: ServiceAccount represents a GCP service account. +type ServiceAccount struct { + // Email: Email address of the service account. + Email string `json:"email,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Email") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Email") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ServiceAccount) MarshalJSON() ([]byte, error) { + type NoMethod ServiceAccount + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Tunnelv1ProtoTunnelerError: TunnelerError is an error proto for +// errors returned by the connection manager. +type Tunnelv1ProtoTunnelerError struct { + // Err: Original raw error + Err string `json:"err,omitempty"` + + // Retryable: retryable isn't used for now, but we may want to reuse it + // in the future. + Retryable bool `json:"retryable,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Err") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Err") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Tunnelv1ProtoTunnelerError) MarshalJSON() ([]byte, error) { + type NoMethod Tunnelv1ProtoTunnelerError + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Tunnelv1ProtoTunnelerInfo: TunnelerInfo contains metadata about +// tunneler launched by connection manager. +type Tunnelv1ProtoTunnelerInfo struct { + // BackoffRetryCount: backoff_retry_count stores the number of times the + // tunneler has been retried by tunManager for current backoff sequence. + // Gets reset to 0 if time difference between 2 consecutive retries + // exceeds backoffRetryResetTime. + BackoffRetryCount int64 `json:"backoffRetryCount,omitempty"` + + // Id: id is the unique id of a tunneler. + Id string `json:"id,omitempty"` + + // LatestErr: latest_err stores the Error for the latest tunneler + // failure. Gets reset everytime the tunneler is retried by tunManager. + LatestErr *Tunnelv1ProtoTunnelerError `json:"latestErr,omitempty"` + + // LatestRetryTime: latest_retry_time stores the time when the tunneler + // was last restarted. + LatestRetryTime string `json:"latestRetryTime,omitempty"` + + // TotalRetryCount: total_retry_count stores the total number of times + // the tunneler has been retried by tunManager. + TotalRetryCount int64 `json:"totalRetryCount,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BackoffRetryCount") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BackoffRetryCount") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *Tunnelv1ProtoTunnelerInfo) MarshalJSON() ([]byte, error) { + type NoMethod Tunnelv1ProtoTunnelerInfo + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// method id "beyondcorp.organizations.locations.global.tenants.create": + +type OrganizationsLocationsGlobalTenantsCreateCall struct { + s *Service + parent string + googlecloudbeyondcorppartnerservicesv1alphatenant *GoogleCloudBeyondcorpPartnerservicesV1alphaTenant + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new BeyondCorp Enterprise tenant in a given +// organization and can only be called by onboarded BeyondCorp +// Enterprise partner. +// +// - parent: The resource name of the Tenant using the form: +// `organizations/{organization_id}/locations/global`. +func (r *OrganizationsLocationsGlobalTenantsService) Create(parent string, googlecloudbeyondcorppartnerservicesv1alphatenant *GoogleCloudBeyondcorpPartnerservicesV1alphaTenant) *OrganizationsLocationsGlobalTenantsCreateCall { + c := &OrganizationsLocationsGlobalTenantsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudbeyondcorppartnerservicesv1alphatenant = googlecloudbeyondcorppartnerservicesv1alphatenant + 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. The server will guarantee +// that for at least 60 minutes since the first request. 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 *OrganizationsLocationsGlobalTenantsCreateCall) RequestId(requestId string) *OrganizationsLocationsGlobalTenantsCreateCall { + 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 information. +func (c *OrganizationsLocationsGlobalTenantsCreateCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalTenantsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *OrganizationsLocationsGlobalTenantsCreateCall) Context(ctx context.Context) *OrganizationsLocationsGlobalTenantsCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *OrganizationsLocationsGlobalTenantsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsGlobalTenantsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudbeyondcorppartnerservicesv1alphatenant) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/tenants") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.organizations.locations.global.tenants.create" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *OrganizationsLocationsGlobalTenantsCreateCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates a new BeyondCorp Enterprise tenant in a given organization and can only be called by onboarded BeyondCorp Enterprise partner.", + // "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/tenants", + // "httpMethod": "POST", + // "id": "beyondcorp.organizations.locations.global.tenants.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The resource name of the Tenant using the form: `organizations/{organization_id}/locations/global`", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/global$", + // "required": true, + // "type": "string" + // }, + // "requestId": { + // "description": "Optional. 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. The server will guarantee that for at least 60 minutes since the first request. 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).", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1alpha/{+parent}/tenants", + // "request": { + // "$ref": "GoogleCloudBeyondcorpPartnerservicesV1alphaTenant" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "beyondcorp.organizations.locations.global.tenants.get": + +type OrganizationsLocationsGlobalTenantsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of a single Tenant. +// +// - name: The resource name of the Tenant using the form: +// `organizations/{organization_id}/locations/global/tenants/{tenant_id +// }`. +func (r *OrganizationsLocationsGlobalTenantsService) Get(name string) *OrganizationsLocationsGlobalTenantsGetCall { + c := &OrganizationsLocationsGlobalTenantsGetCall{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 information. +func (c *OrganizationsLocationsGlobalTenantsGetCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalTenantsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *OrganizationsLocationsGlobalTenantsGetCall) IfNoneMatch(entityTag string) *OrganizationsLocationsGlobalTenantsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *OrganizationsLocationsGlobalTenantsGetCall) Context(ctx context.Context) *OrganizationsLocationsGlobalTenantsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *OrganizationsLocationsGlobalTenantsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsGlobalTenantsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.organizations.locations.global.tenants.get" call. +// Exactly one of *GoogleCloudBeyondcorpPartnerservicesV1alphaTenant or +// error will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleCloudBeyondcorpPartnerservicesV1alphaTenant.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 *OrganizationsLocationsGlobalTenantsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpPartnerservicesV1alphaTenant, 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 := &GoogleCloudBeyondcorpPartnerservicesV1alphaTenant{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets details of a single Tenant.", + // "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/tenants/{tenantsId}", + // "httpMethod": "GET", + // "id": "beyondcorp.organizations.locations.global.tenants.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The resource name of the Tenant using the form: `organizations/{organization_id}/locations/global/tenants/{tenant_id}`", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}", + // "response": { + // "$ref": "GoogleCloudBeyondcorpPartnerservicesV1alphaTenant" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "beyondcorp.organizations.locations.global.tenants.proxyConfigs.create": + +type OrganizationsLocationsGlobalTenantsProxyConfigsCreateCall struct { + s *Service + parent string + googlecloudbeyondcorppartnerservicesv1alphaproxyconfig *GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new BeyondCorp Enterprise ProxyConfiguration in a +// given organization and tenant. Can only be called by on onboarded +// Beyondcorp Enterprise partner. +// +// - parent: The resource name of the ProxyConfig using the form: +// `organizations/{organization_id}/locations/global/tenants/{tenant_id +// }`. +func (r *OrganizationsLocationsGlobalTenantsProxyConfigsService) Create(parent string, googlecloudbeyondcorppartnerservicesv1alphaproxyconfig *GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig) *OrganizationsLocationsGlobalTenantsProxyConfigsCreateCall { + c := &OrganizationsLocationsGlobalTenantsProxyConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudbeyondcorppartnerservicesv1alphaproxyconfig = googlecloudbeyondcorppartnerservicesv1alphaproxyconfig + 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. The server will guarantee +// that for at least 60 minutes since the first request. 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 *OrganizationsLocationsGlobalTenantsProxyConfigsCreateCall) RequestId(requestId string) *OrganizationsLocationsGlobalTenantsProxyConfigsCreateCall { + 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 information. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsCreateCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalTenantsProxyConfigsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsCreateCall) Context(ctx context.Context) *OrganizationsLocationsGlobalTenantsProxyConfigsCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudbeyondcorppartnerservicesv1alphaproxyconfig) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/proxyConfigs") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.organizations.locations.global.tenants.proxyConfigs.create" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *OrganizationsLocationsGlobalTenantsProxyConfigsCreateCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates a new BeyondCorp Enterprise ProxyConfiguration in a given organization and tenant. Can only be called by on onboarded Beyondcorp Enterprise partner.", + // "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/tenants/{tenantsId}/proxyConfigs", + // "httpMethod": "POST", + // "id": "beyondcorp.organizations.locations.global.tenants.proxyConfigs.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The resource name of the ProxyConfig using the form: `organizations/{organization_id}/locations/global/tenants/{tenant_id}`", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "requestId": { + // "description": "Optional. 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. The server will guarantee that for at least 60 minutes since the first request. 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).", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1alpha/{+parent}/proxyConfigs", + // "request": { + // "$ref": "GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "beyondcorp.organizations.locations.global.tenants.proxyConfigs.get": + +type OrganizationsLocationsGlobalTenantsProxyConfigsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of a single Tenant. +// +// - name: The resource name of the Tenant using the form: +// `organizations/{organization_id}/locations/global/tenants/{tenant_id +// }/proxyConfigs/{proxy_config_id}`. +func (r *OrganizationsLocationsGlobalTenantsProxyConfigsService) Get(name string) *OrganizationsLocationsGlobalTenantsProxyConfigsGetCall { + c := &OrganizationsLocationsGlobalTenantsProxyConfigsGetCall{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 information. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsGetCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalTenantsProxyConfigsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsGetCall) IfNoneMatch(entityTag string) *OrganizationsLocationsGlobalTenantsProxyConfigsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsGetCall) Context(ctx context.Context) *OrganizationsLocationsGlobalTenantsProxyConfigsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsGlobalTenantsProxyConfigsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.organizations.locations.global.tenants.proxyConfigs.get" call. +// Exactly one of +// *GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig or error will +// be non-nil. Any non-2xx status code is an error. Response headers are +// in either +// *GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig.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 *OrganizationsLocationsGlobalTenantsProxyConfigsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig, 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 := &GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets details of a single Tenant.", + // "flatPath": "v1alpha/organizations/{organizationsId}/locations/global/tenants/{tenantsId}/proxyConfigs/{proxyConfigsId}", + // "httpMethod": "GET", + // "id": "beyondcorp.organizations.locations.global.tenants.proxyConfigs.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The resource name of the Tenant using the form: `organizations/{organization_id}/locations/global/tenants/{tenant_id}/proxyConfigs/{proxy_config_id}`", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/global/tenants/[^/]+/proxyConfigs/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}", + // "response": { + // "$ref": "GoogleCloudBeyondcorpPartnerservicesV1alphaProxyConfig" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "beyondcorp.organizations.locations.insights.configuredInsight": type OrganizationsLocationsInsightsConfiguredInsightCall struct { diff --git a/bigquery/v2/bigquery-api.json b/bigquery/v2/bigquery-api.json index 452fcd1a8be..59e7563dd03 100644 --- a/bigquery/v2/bigquery-api.json +++ b/bigquery/v2/bigquery-api.json @@ -1710,7 +1710,7 @@ } } }, - "revision": "20230408", + "revision": "20230422", "rootUrl": "https://bigquery.googleapis.com/", "schemas": { "AggregateClassificationMetrics": { @@ -3642,6 +3642,13 @@ "HivePartitioningOptions": { "id": "HivePartitioningOptions", "properties": { + "fields": { + "description": "[Output-only] For permanent external tables, this field is populated with the hive partition keys in the order they were inferred. The types of the partition keys can be deduced by checking the table schema (which will include the partition keys). Not every API will populate this field in the output. For example, Tables.Get will populate it, but Tables.List will not contain this field.", + "items": { + "type": "string" + }, + "type": "array" + }, "mode": { "description": "[Optional] When set, what mode of hive partitioning to use when reading data. The following modes are supported. (1) AUTO: automatically infer partition key name(s) and type(s). (2) STRINGS: automatically infer partition key name(s). All types are interpreted as strings. (3) CUSTOM: partition key schema is encoded in the source URI prefix. Not all storage formats support hive partitioning. Requesting hive partitioning on an unsupported format will lead to an error. Currently supported types include: AVRO, CSV, JSON, ORC and Parquet.", "type": "string" @@ -5128,6 +5135,7 @@ "DNN_CLASSIFIER", "TENSORFLOW", "DNN_REGRESSOR", + "XGBOOST", "BOOSTED_TREE_REGRESSOR", "BOOSTED_TREE_CLASSIFIER", "ARIMA", @@ -5138,8 +5146,11 @@ "DNN_LINEAR_COMBINED_REGRESSOR", "AUTOENCODER", "ARIMA_PLUS", + "ARIMA_PLUS_XREG", "RANDOM_FOREST_REGRESSOR", - "RANDOM_FOREST_CLASSIFIER" + "RANDOM_FOREST_CLASSIFIER", + "TENSORFLOW_LITE", + "ONNX" ], "enumDescriptions": [ "", @@ -5150,6 +5161,7 @@ "DNN classifier model.", "An imported TensorFlow model.", "DNN regressor model.", + "An imported XGBoost model.", "Boosted tree regressor model.", "Boosted tree classifier model.", "ARIMA model.", @@ -5160,8 +5172,11 @@ "Wide-and-deep regressor model.", "Autoencoder model.", "New name for the ARIMA model.", + "ARIMA with external regressors.", "Random Forest regressor model.", - "Random Forest classifier model." + "Random Forest classifier model.", + "An imported TensorFlow Lite model.", + "An imported ONNX model." ], "readOnly": true, "type": "string" @@ -5175,6 +5190,11 @@ "readOnly": true, "type": "array" }, + "remoteModelInfo": { + "$ref": "RemoteModelInfo", + "description": "Output only. Remote model info", + "readOnly": true + }, "trainingRuns": { "description": "Information for all training runs in increasing order of start_time.", "items": { @@ -5785,6 +5805,46 @@ }, "type": "object" }, + "RemoteModelInfo": { + "description": "Remote Model Info", + "id": "RemoteModelInfo", + "properties": { + "connection": { + "description": "Output only. Fully qualified name of the user-provided connection object of the remote model. Format: ```\"projects/{project_id}/locations/{location_id}/connections/{connection_id}\"```", + "readOnly": true, + "type": "string" + }, + "endpoint": { + "description": "Output only. The endpoint for remote model.", + "readOnly": true, + "type": "string" + }, + "maxBatchingRows": { + "description": "Output only. Max number of rows in each batch sent to the remote service. If unset, the number of rows in each batch is set dynamically.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "remoteServiceType": { + "description": "Output only. The remote service type for remote model.", + "enum": [ + "REMOTE_SERVICE_TYPE_UNSPECIFIED", + "CLOUD_AI_TRANSLATE_V3", + "CLOUD_AI_VISION_V1", + "CLOUD_AI_NATURAL_LANGUAGE_V1" + ], + "enumDescriptions": [ + "Unspecified remote service type.", + "V3 Cloud AI Translation API. See more details at [Cloud Translation API] (https://cloud.google.com/translate/docs/reference/rest).", + "V1 Cloud AI Vision API See more details at [Cloud Vision API] (https://cloud.google.com/vision/docs/reference/rest).", + "V1 Cloud AI Natural Language API. See more details at [REST Resource: documents](https://cloud.google.com/natural-language/docs/reference/rest/v1/documents)." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "Routine": { "description": "A user-defined function or a stored procedure.", "id": "Routine", @@ -7352,6 +7412,10 @@ }, "type": "array" }, + "instanceWeightColumn": { + "description": "Name of the instance weight column for training data. This column isn't be used as a feature.", + "type": "string" + }, "integratedGradientsNumSteps": { "description": "Number of integral steps for the integrated gradients explain method.", "format": "int64", @@ -7528,6 +7592,10 @@ "format": "double", "type": "number" }, + "tfVersion": { + "description": "Based on the selected TF version, the corresponding docker image is used to train external models.", + "type": "string" + }, "timeSeriesDataColumn": { "description": "Column to be designated as time series data for ARIMA model.", "type": "string" @@ -7587,6 +7655,10 @@ "warmStart": { "description": "Whether to train a model from the last checkpoint.", "type": "boolean" + }, + "xgboostVersion": { + "description": "User-selected XGBoost versions for training of XGBoost models.", + "type": "string" } }, "type": "object" diff --git a/bigquery/v2/bigquery-gen.go b/bigquery/v2/bigquery-gen.go index 6eb44fa0f67..fb05224fde0 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -3677,6 +3677,14 @@ func (s *GoogleSheetsOptions) MarshalJSON() ([]byte, error) { } type HivePartitioningOptions struct { + // Fields: [Output-only] For permanent external tables, this field is + // populated with the hive partition keys in the order they were + // inferred. The types of the partition keys can be deduced by checking + // the table schema (which will include the partition keys). Not every + // API will populate this field in the output. For example, Tables.Get + // will populate it, but Tables.List will not contain this field. + Fields []string `json:"fields,omitempty"` + // Mode: [Optional] When set, what mode of hive partitioning to use when // reading data. The following modes are supported. (1) AUTO: // automatically infer partition key name(s) and type(s). (2) STRINGS: @@ -3708,7 +3716,7 @@ type HivePartitioningOptions struct { // slash does not matter). SourceUriPrefix string `json:"sourceUriPrefix,omitempty"` - // ForceSendFields is a list of field names (e.g. "Mode") to + // ForceSendFields is a list of field names (e.g. "Fields") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3716,7 +3724,7 @@ type HivePartitioningOptions struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Mode") to include in API + // NullFields is a list of field names (e.g. "Fields") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as @@ -5860,6 +5868,7 @@ type Model struct { // "DNN_CLASSIFIER" - DNN classifier model. // "TENSORFLOW" - An imported TensorFlow model. // "DNN_REGRESSOR" - DNN regressor model. + // "XGBOOST" - An imported XGBoost model. // "BOOSTED_TREE_REGRESSOR" - Boosted tree regressor model. // "BOOSTED_TREE_CLASSIFIER" - Boosted tree classifier model. // "ARIMA" - ARIMA model. @@ -5870,8 +5879,11 @@ type Model struct { // "DNN_LINEAR_COMBINED_REGRESSOR" - Wide-and-deep regressor model. // "AUTOENCODER" - Autoencoder model. // "ARIMA_PLUS" - New name for the ARIMA model. + // "ARIMA_PLUS_XREG" - ARIMA with external regressors. // "RANDOM_FOREST_REGRESSOR" - Random Forest regressor model. // "RANDOM_FOREST_CLASSIFIER" - Random Forest classifier model. + // "TENSORFLOW_LITE" - An imported TensorFlow Lite model. + // "ONNX" - An imported ONNX model. ModelType string `json:"modelType,omitempty"` // OptimalTrialIds: Output only. For single-objective hyperparameter @@ -5884,6 +5896,9 @@ type Model struct { // trial_id. OptimalTrialIds googleapi.Int64s `json:"optimalTrialIds,omitempty"` + // RemoteModelInfo: Output only. Remote model info + RemoteModelInfo *RemoteModelInfo `json:"remoteModelInfo,omitempty"` + // TrainingRuns: Information for all training runs in increasing order // of start_time. TrainingRuns []*TrainingRun `json:"trainingRuns,omitempty"` @@ -7038,6 +7053,63 @@ func (s *RemoteFunctionOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// RemoteModelInfo: Remote Model Info +type RemoteModelInfo struct { + // Connection: Output only. Fully qualified name of the user-provided + // connection object of the remote model. Format: + // ``"projects/{project_id}/locations/{location_id}/connections/{connect + // ion_id}"`` + Connection string `json:"connection,omitempty"` + + // Endpoint: Output only. The endpoint for remote model. + Endpoint string `json:"endpoint,omitempty"` + + // MaxBatchingRows: Output only. Max number of rows in each batch sent + // to the remote service. If unset, the number of rows in each batch is + // set dynamically. + MaxBatchingRows int64 `json:"maxBatchingRows,omitempty,string"` + + // RemoteServiceType: Output only. The remote service type for remote + // model. + // + // Possible values: + // "REMOTE_SERVICE_TYPE_UNSPECIFIED" - Unspecified remote service + // type. + // "CLOUD_AI_TRANSLATE_V3" - V3 Cloud AI Translation API. See more + // details at [Cloud Translation API] + // (https://cloud.google.com/translate/docs/reference/rest). + // "CLOUD_AI_VISION_V1" - V1 Cloud AI Vision API See more details at + // [Cloud Vision API] + // (https://cloud.google.com/vision/docs/reference/rest). + // "CLOUD_AI_NATURAL_LANGUAGE_V1" - V1 Cloud AI Natural Language API. + // See more details at [REST Resource: + // documents](https://cloud.google.com/natural-language/docs/reference/re + // st/v1/documents). + RemoteServiceType string `json:"remoteServiceType,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Connection") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Connection") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *RemoteModelInfo) MarshalJSON() ([]byte, error) { + type NoMethod RemoteModelInfo + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Routine: A user-defined function or a stored procedure. type Routine struct { // Arguments: Optional. @@ -9170,6 +9242,10 @@ type TrainingOptions struct { // InputLabelColumns: Name of input label columns in training data. InputLabelColumns []string `json:"inputLabelColumns,omitempty"` + // InstanceWeightColumn: Name of the instance weight column for training + // data. This column isn't be used as a feature. + InstanceWeightColumn string `json:"instanceWeightColumn,omitempty"` + // IntegratedGradientsNumSteps: Number of integral steps for the // integrated gradients explain method. IntegratedGradientsNumSteps int64 `json:"integratedGradientsNumSteps,omitempty,string"` @@ -9305,6 +9381,10 @@ type TrainingOptions struct { // prevent overfitting for boosted tree models. Subsample float64 `json:"subsample,omitempty"` + // TfVersion: Based on the selected TF version, the corresponding docker + // image is used to train external models. + TfVersion string `json:"tfVersion,omitempty"` + // TimeSeriesDataColumn: Column to be designated as time series data for // ARIMA model. TimeSeriesDataColumn string `json:"timeSeriesDataColumn,omitempty"` @@ -9350,6 +9430,10 @@ type TrainingOptions struct { // WarmStart: Whether to train a model from the last checkpoint. WarmStart bool `json:"warmStart,omitempty"` + // XgboostVersion: User-selected XGBoost versions for training of + // XGBoost models. + XgboostVersion string `json:"xgboostVersion,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdjustStepChanges") // to unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any diff --git a/bigquerydatatransfer/v1/bigquerydatatransfer-api.json b/bigquerydatatransfer/v1/bigquerydatatransfer-api.json index 13427239cd1..9f824fffa3f 100644 --- a/bigquerydatatransfer/v1/bigquerydatatransfer-api.json +++ b/bigquerydatatransfer/v1/bigquerydatatransfer-api.json @@ -1342,7 +1342,7 @@ } } }, - "revision": "20230414", + "revision": "20230423", "rootUrl": "https://bigquerydatatransfer.googleapis.com/", "schemas": { "CheckValidCredsRequest": { @@ -1709,7 +1709,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go b/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go index b498b0844d7..3b9abee409e 100644 --- a/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go +++ b/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go @@ -810,7 +810,7 @@ func (s *ListTransferRunsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/bigqueryreservation/v1/bigqueryreservation-api.json b/bigqueryreservation/v1/bigqueryreservation-api.json index 44c96110818..5ffff878eb4 100644 --- a/bigqueryreservation/v1/bigqueryreservation-api.json +++ b/bigqueryreservation/v1/bigqueryreservation-api.json @@ -824,7 +824,7 @@ } } }, - "revision": "20230419", + "revision": "20230428", "rootUrl": "https://bigqueryreservation.googleapis.com/", "schemas": { "Assignment": { @@ -1145,7 +1145,7 @@ "properties": { "autoscale": { "$ref": "Autoscale", - "description": "The configuration parameters for the auto scaling feature. Note this is an alpha feature." + "description": "The configuration parameters for the auto scaling feature." }, "concurrency": { "description": "Job concurrency target which sets a soft upper bound on the number of jobs that can run concurrently in this reservation. This is a soft target due to asynchronous nature of the system and various optimizations for small queries. Default value is 0 which means that concurrency target will be automatically computed by the system. NOTE: this field is exposed as `target_job_concurrency` in the Information Schema, DDL and BQ CLI.", diff --git a/bigqueryreservation/v1/bigqueryreservation-gen.go b/bigqueryreservation/v1/bigqueryreservation-gen.go index f3324028472..1fcd5325ca6 100644 --- a/bigqueryreservation/v1/bigqueryreservation-gen.go +++ b/bigqueryreservation/v1/bigqueryreservation-gen.go @@ -716,7 +716,6 @@ func (s *MoveAssignmentRequest) MarshalJSON() ([]byte, error) { // users. type Reservation struct { // Autoscale: The configuration parameters for the auto scaling feature. - // Note this is an alpha feature. Autoscale *Autoscale `json:"autoscale,omitempty"` // Concurrency: Job concurrency target which sets a soft upper bound on diff --git a/bigtableadmin/v2/bigtableadmin-api.json b/bigtableadmin/v2/bigtableadmin-api.json index 253e1302ca0..76073433c49 100644 --- a/bigtableadmin/v2/bigtableadmin-api.json +++ b/bigtableadmin/v2/bigtableadmin-api.json @@ -1966,7 +1966,7 @@ } } }, - "revision": "20230330", + "revision": "20230426", "rootUrl": "https://bigtableadmin.googleapis.com/", "schemas": { "AppProfile": { @@ -2995,7 +2995,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/bigtableadmin/v2/bigtableadmin-gen.go b/bigtableadmin/v2/bigtableadmin-gen.go index 7c95ddc29b2..5701dd5decc 100644 --- a/bigtableadmin/v2/bigtableadmin-gen.go +++ b/bigtableadmin/v2/bigtableadmin-gen.go @@ -2320,7 +2320,7 @@ func (s *ListTablesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/chromemanagement/v1/chromemanagement-api.json b/chromemanagement/v1/chromemanagement-api.json index 32933c95f8b..3ee8e774170 100644 --- a/chromemanagement/v1/chromemanagement-api.json +++ b/chromemanagement/v1/chromemanagement-api.json @@ -794,7 +794,7 @@ } } }, - "revision": "20230413", + "revision": "20230507", "rootUrl": "https://chromemanagement.googleapis.com/", "schemas": { "GoogleChromeManagementV1AndroidAppInfo": { @@ -943,7 +943,7 @@ "type": "object" }, "GoogleChromeManagementV1AudioStatusReport": { - "description": "Status data for storage. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceAudioStatus](https://chromeenterprise.google/policies/#ReportDeviceAudioStatus) * Data Collection Frequency: 10 minutes * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A", + "description": "Status data for storage. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceAudioStatus](https://chromeenterprise.google/policies/#ReportDeviceAudioStatus) * Data Collection Frequency: 10 minutes * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_AUDIO_REPORT", "id": "GoogleChromeManagementV1AudioStatusReport", "properties": { "inputDevice": { @@ -988,7 +988,7 @@ "type": "object" }, "GoogleChromeManagementV1BatteryInfo": { - "description": "Information about the battery. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDevicePowerStatus](https://chromeenterprise.google/policies/#ReportDevicePowerStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A", + "description": "Information about the battery. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDevicePowerStatus](https://chromeenterprise.google/policies/#ReportDevicePowerStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_BATTERY_INFO", "id": "GoogleChromeManagementV1BatteryInfo", "properties": { "designCapacity": { @@ -1081,7 +1081,7 @@ "type": "object" }, "GoogleChromeManagementV1BatteryStatusReport": { - "description": "Status data for battery. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDevicePowerStatus](https://chromeenterprise.google/policies/#ReportDevicePowerStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A", + "description": "Status data for battery. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDevicePowerStatus](https://chromeenterprise.google/policies/#ReportDevicePowerStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_BATTERY_REPORT", "id": "GoogleChromeManagementV1BatteryStatusReport", "properties": { "batteryHealth": { @@ -1136,7 +1136,7 @@ "type": "object" }, "GoogleChromeManagementV1BootPerformanceReport": { - "description": "Boot performance report of a device. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceBootMode](https://chromeenterprise.google/policies/#ReportDeviceBootMode) * Data Collection Frequency: On every boot up event * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A", + "description": "Boot performance report of a device. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceBootMode](https://chromeenterprise.google/policies/#ReportDeviceBootMode) * Data Collection Frequency: On every boot up event * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_OS_REPORT", "id": "GoogleChromeManagementV1BootPerformanceReport", "properties": { "bootUpDuration": { @@ -1582,7 +1582,7 @@ "type": "object" }, "GoogleChromeManagementV1CpuInfo": { - "description": "CPU specifications for the device * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A", + "description": "CPU specifications for the device * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_CPU_INFO", "id": "GoogleChromeManagementV1CpuInfo", "properties": { "architecture": { @@ -1623,7 +1623,7 @@ "type": "object" }, "GoogleChromeManagementV1CpuStatusReport": { - "description": "Provides information about the status of the CPU. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * Data Collection Frequency: Every 10 minutes * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A", + "description": "Provides information about the status of the CPU. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * Data Collection Frequency: Every 10 minutes * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_CPU_REPORT", "id": "GoogleChromeManagementV1CpuStatusReport", "properties": { "cpuTemperatureInfo": { @@ -1981,7 +1981,7 @@ "type": "object" }, "GoogleChromeManagementV1GraphicsInfo": { - "description": "Information of the graphics subsystem. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceGraphicsStatus](https://chromeenterprise.google/policies/#ReportDeviceGraphicsStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A", + "description": "Information of the graphics subsystem. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceGraphicsStatus](https://chromeenterprise.google/policies/#ReportDeviceGraphicsStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_GRAPHICS_INFO", "id": "GoogleChromeManagementV1GraphicsInfo", "properties": { "adapterInfo": { @@ -2011,7 +2011,7 @@ "type": "object" }, "GoogleChromeManagementV1GraphicsStatusReport": { - "description": "Information of the graphics subsystem. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceGraphicsInfo](https://chromeenterprise.google/policies/#ReportDeviceGraphicsInfo) * Data Collection Frequency: 3 hours. * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A", + "description": "Information of the graphics subsystem. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceGraphicsInfo](https://chromeenterprise.google/policies/#ReportDeviceGraphicsInfo) * Data Collection Frequency: 3 hours. * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_GRAPHICS_REPORT", "id": "GoogleChromeManagementV1GraphicsStatusReport", "properties": { "displays": { @@ -2228,7 +2228,7 @@ "type": "object" }, "GoogleChromeManagementV1MemoryInfo": { - "description": "Memory information of a device. * This field has both telemetry and device information: - `totalRamBytes` - Device information - `availableRamBytes` - Telemetry information - `totalMemoryEncryption` - Device information * Data for this field is controlled via policy: [ReportDeviceMemoryInfo](https://chromeenterprise.google/policies/#ReportDeviceMemoryInfo) * Data Collection Frequency: - `totalRamBytes` - Only at upload - `availableRamBytes` - Every 10 minutes - `totalMemoryEncryption` - at device startup * Default Data Reporting Frequency: - `totalRamBytes` - 3 hours - `availableRamBytes` - 3 hours - `totalMemoryEncryption` - at device startup - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: only for `totalMemoryEncryption` * Reported for affiliated users only: N/A", + "description": "Memory information of a device. * This field has both telemetry and device information: - `totalRamBytes` - Device information - `availableRamBytes` - Telemetry information - `totalMemoryEncryption` - Device information * Data for this field is controlled via policy: [ReportDeviceMemoryInfo](https://chromeenterprise.google/policies/#ReportDeviceMemoryInfo) * Data Collection Frequency: - `totalRamBytes` - Only at upload - `availableRamBytes` - Every 10 minutes - `totalMemoryEncryption` - at device startup * Default Data Reporting Frequency: - `totalRamBytes` - 3 hours - `availableRamBytes` - 3 hours - `totalMemoryEncryption` - at device startup - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: only for `totalMemoryEncryption` * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_MEMORY_INFO", "id": "GoogleChromeManagementV1MemoryInfo", "properties": { "availableRamBytes": { @@ -2252,7 +2252,7 @@ "type": "object" }, "GoogleChromeManagementV1MemoryStatusReport": { - "description": "Contains samples of memory status reports. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceMemoryInfo](https://chromeenterprise.google/policies/#ReportDeviceMemoryInfo) * Data Collection Frequency: Only at upload, SystemRamFreeByes is collected every 10 minutes * Default Data Reporting Frequency: Every 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A", + "description": "Contains samples of memory status reports. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceMemoryInfo](https://chromeenterprise.google/policies/#ReportDeviceMemoryInfo) * Data Collection Frequency: Only at upload, SystemRamFreeByes is collected every 10 minutes * Default Data Reporting Frequency: Every 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_MEMORY_REPORT", "id": "GoogleChromeManagementV1MemoryStatusReport", "properties": { "pageFaults": { @@ -2332,7 +2332,7 @@ "type": "object" }, "GoogleChromeManagementV1NetworkDiagnosticsReport": { - "description": "Network testing results to determine the health of the device's network connection, for example whether the HTTPS latency is high or normal.", + "description": "Network testing results to determine the health of the device's network connection, for example whether the HTTPS latency is high or normal. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT", "id": "GoogleChromeManagementV1NetworkDiagnosticsReport", "properties": { "httpsLatencyData": { @@ -2350,7 +2350,7 @@ "type": "object" }, "GoogleChromeManagementV1NetworkInfo": { - "description": "Network device information. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportNetworkDeviceConfiguration](https://chromeenterprise.google/policies/#ReportNetworkDeviceConfiguration) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A", + "description": "Network device information. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportNetworkDeviceConfiguration](https://chromeenterprise.google/policies/#ReportNetworkDeviceConfiguration) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_NETWORK_INFO", "id": "GoogleChromeManagementV1NetworkInfo", "properties": { "networkDevices": { @@ -2365,7 +2365,7 @@ "type": "object" }, "GoogleChromeManagementV1NetworkStatusReport": { - "description": "State of visible/configured networks. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportNetworkStatus](https://chromeenterprise.google/policies/#ReportNetworkStatus) * Data Collection Frequency: 60 minutes * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: Yes", + "description": "State of visible/configured networks. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportNetworkStatus](https://chromeenterprise.google/policies/#ReportNetworkStatus) * Data Collection Frequency: 60 minutes * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: Yes * Granular permission needed: TELEMETRY_API_NETWORK_REPORT", "id": "GoogleChromeManagementV1NetworkStatusReport", "properties": { "connectionState": { @@ -2481,7 +2481,7 @@ "type": "object" }, "GoogleChromeManagementV1OsUpdateStatus": { - "description": "Contains information regarding the current OS update status. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceOsUpdateStatus](https://chromeenterprise.google/policies/#ReportDeviceOsUpdateStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A", + "description": "Contains information regarding the current OS update status. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceOsUpdateStatus](https://chromeenterprise.google/policies/#ReportDeviceOsUpdateStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_OS_REPORT", "id": "GoogleChromeManagementV1OsUpdateStatus", "properties": { "lastRebootTime": { @@ -2533,7 +2533,7 @@ "type": "object" }, "GoogleChromeManagementV1PeripheralsReport": { - "description": "Peripherals report.", + "description": "Peripherals report. * Granular permission needed: TELEMETRY_API_PERIPHERALS_REPORT", "id": "GoogleChromeManagementV1PeripheralsReport", "properties": { "reportTime": { @@ -2553,7 +2553,7 @@ "type": "object" }, "GoogleChromeManagementV1StorageInfo": { - "description": "Status data for storage. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceStorageStatus](https://chromeenterprise.google/policies/#ReportDeviceStorageStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A", + "description": "Status data for storage. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceStorageStatus](https://chromeenterprise.google/policies/#ReportDeviceStorageStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_STORAGE_INFO", "id": "GoogleChromeManagementV1StorageInfo", "properties": { "availableDiskBytes": { @@ -2598,7 +2598,7 @@ "type": "object" }, "GoogleChromeManagementV1StorageStatusReport": { - "description": "Status data for storage. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceStorageStatus](https://chromeenterprise.google/policies/#ReportDeviceStorageStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A", + "description": "Status data for storage. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceStorageStatus](https://chromeenterprise.google/policies/#ReportDeviceStorageStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_STORAGE_REPORT", "id": "GoogleChromeManagementV1StorageStatusReport", "properties": { "disk": { @@ -2619,13 +2619,13 @@ "type": "object" }, "GoogleChromeManagementV1TelemetryAudioSevereUnderrunEvent": { - "description": "`TelemetryAudioSevereUnderrunEvent` is triggered when a audio devices run out of buffer data for more than 5 seconds.", + "description": "`TelemetryAudioSevereUnderrunEvent` is triggered when a audio devices run out of buffer data for more than 5 seconds. * Granular permission needed: TELEMETRY_API_AUDIO_REPORT", "id": "GoogleChromeManagementV1TelemetryAudioSevereUnderrunEvent", "properties": {}, "type": "object" }, "GoogleChromeManagementV1TelemetryDevice": { - "description": "Telemetry data collected from a managed device.", + "description": "Telemetry data collected from a managed device. * Granular permission needed: TELEMETRY_API_DEVICE", "id": "GoogleChromeManagementV1TelemetryDevice", "properties": { "audioStatusReport": { @@ -2789,7 +2789,7 @@ "type": "object" }, "GoogleChromeManagementV1TelemetryDeviceInfo": { - "description": "Information about a device associated with telemetry data.", + "description": "Information about a device associated with telemetry data. * Granular Permission needed: TELEMETRY_API_DEVICE", "id": "GoogleChromeManagementV1TelemetryDeviceInfo", "properties": { "deviceId": { @@ -2866,7 +2866,7 @@ "type": "object" }, "GoogleChromeManagementV1TelemetryHttpsLatencyChangeEvent": { - "description": "Https latency routine is run periodically and `TelemetryHttpsLatencyChangeEvent` is triggered if a latency problem was detected or if the device has recovered from a latency problem..", + "description": "Https latency routine is run periodically and `TelemetryHttpsLatencyChangeEvent` is triggered if a latency problem was detected or if the device has recovered from a latency problem. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT", "id": "GoogleChromeManagementV1TelemetryHttpsLatencyChangeEvent", "properties": { "httpsLatencyRoutineData": { @@ -2891,7 +2891,7 @@ "type": "object" }, "GoogleChromeManagementV1TelemetryUsbPeripheralsEvent": { - "description": "`TelemetryUsbPeripheralsEvent` is triggered USB devices are either added or removed.", + "description": "`TelemetryUsbPeripheralsEvent` is triggered USB devices are either added or removed. * Granular permission needed: TELEMETRY_API_PERIPHERALS_REPORT", "id": "GoogleChromeManagementV1TelemetryUsbPeripheralsEvent", "properties": { "usbPeripheralReport": { @@ -2905,7 +2905,7 @@ "type": "object" }, "GoogleChromeManagementV1TelemetryUser": { - "description": "Telemetry data collected from a managed user.", + "description": "Telemetry data collected from a managed user. * Granular permission needed: TELEMETRY_API_USER", "id": "GoogleChromeManagementV1TelemetryUser", "properties": { "customer": { @@ -2939,7 +2939,7 @@ "type": "object" }, "GoogleChromeManagementV1TelemetryUserDevice": { - "description": "Telemetry data collected for a managed user and device.", + "description": "Telemetry data collected for a managed user and device. * Granular permission needed: TELEMETRY_API_DEVICE", "id": "GoogleChromeManagementV1TelemetryUserDevice", "properties": { "audioStatusReport": { @@ -2966,7 +2966,7 @@ "type": "object" }, "GoogleChromeManagementV1TelemetryUserInfo": { - "description": "Information about a user associated with telemetry data.", + "description": "Information about a user associated with telemetry data. * Granular permission needed: TELEMETRY_API_USER", "id": "GoogleChromeManagementV1TelemetryUserInfo", "properties": { "email": { @@ -2983,7 +2983,7 @@ "type": "object" }, "GoogleChromeManagementV1ThunderboltInfo": { - "description": "Thunderbolt bus info. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceSecurityStatus](https://chromeenterprise.google/policies/#ReportDeviceSecurityStatus) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - Policy Controlled: No * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A", + "description": "Thunderbolt bus info. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceSecurityStatus](https://chromeenterprise.google/policies/#ReportDeviceSecurityStatus) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - Policy Controlled: No * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_BUS_DEVICE_INFO", "id": "GoogleChromeManagementV1ThunderboltInfo", "properties": { "securityLevel": { diff --git a/chromemanagement/v1/chromemanagement-gen.go b/chromemanagement/v1/chromemanagement-gen.go index 8d7a99a77d9..72c73083039 100644 --- a/chromemanagement/v1/chromemanagement-gen.go +++ b/chromemanagement/v1/chromemanagement-gen.go @@ -458,7 +458,7 @@ func (s *GoogleChromeManagementV1AppDetails) UnmarshalJSON(data []byte) error { // Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is // offline, the collected data is stored locally, and will be reported // when the device is next online: No * Reported for affiliated users -// only: N/A +// only: N/A * Granular permission needed: TELEMETRY_API_AUDIO_REPORT type GoogleChromeManagementV1AudioStatusReport struct { // InputDevice: Output only. Active input device's name. InputDevice string `json:"inputDevice,omitempty"` @@ -514,7 +514,7 @@ func (s *GoogleChromeManagementV1AudioStatusReport) MarshalJSON() ([]byte, error // Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is // offline, the collected data is stored locally, and will be reported // when the device is next online: No * Reported for affiliated users -// only: N/A +// only: N/A * Granular permission needed: TELEMETRY_API_BATTERY_INFO type GoogleChromeManagementV1BatteryInfo struct { // DesignCapacity: Output only. Design capacity (mAmpere-hours). DesignCapacity int64 `json:"designCapacity,omitempty,string"` @@ -630,7 +630,7 @@ func (s *GoogleChromeManagementV1BatterySampleReport) MarshalJSON() ([]byte, err // Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is // offline, the collected data is stored locally, and will be reported // when the device is next online: No * Reported for affiliated users -// only: N/A +// only: N/A * Granular permission needed: TELEMETRY_API_BATTERY_REPORT type GoogleChromeManagementV1BatteryStatusReport struct { // BatteryHealth: Output only. Battery health. // @@ -693,7 +693,8 @@ func (s *GoogleChromeManagementV1BatteryStatusReport) MarshalJSON() ([]byte, err // Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the // device is offline, the collected data is stored locally, and will be // reported when the device is next online: Yes * Reported for -// affiliated users only: N/A +// affiliated users only: N/A * Granular permission needed: +// TELEMETRY_API_OS_REPORT type GoogleChromeManagementV1BootPerformanceReport struct { // BootUpDuration: Total time to boot up. BootUpDuration string `json:"bootUpDuration,omitempty"` @@ -1310,7 +1311,7 @@ func (s *GoogleChromeManagementV1CountInstalledAppsResponse) MarshalJSON() ([]by // Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is // offline, the collected data is stored locally, and will be reported // when the device is next online: No * Reported for affiliated users -// only: N/A +// only: N/A * Granular permission needed: TELEMETRY_API_CPU_INFO type GoogleChromeManagementV1CpuInfo struct { // Architecture: Output only. Architecture type for the CPU. * This // field provides device information, which is static and will not @@ -1375,7 +1376,7 @@ func (s *GoogleChromeManagementV1CpuInfo) MarshalJSON() ([]byte, error) { // Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is // offline, the collected data is stored locally, and will be reported // when the device is next online: No * Reported for affiliated users -// only: N/A +// only: N/A * Granular permission needed: TELEMETRY_API_CPU_REPORT type GoogleChromeManagementV1CpuStatusReport struct { // CpuTemperatureInfo: Output only. CPU temperature sample info per CPU // core in Celsius @@ -1836,7 +1837,7 @@ func (s *GoogleChromeManagementV1GraphicsAdapterInfo) MarshalJSON() ([]byte, err // Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is // offline, the collected data is stored locally, and will be reported // when the device is next online: No * Reported for affiliated users -// only: N/A +// only: N/A * Granular permission needed: TELEMETRY_API_GRAPHICS_INFO type GoogleChromeManagementV1GraphicsInfo struct { // AdapterInfo: Output only. Information about the graphics adapter // (GPU). @@ -1885,7 +1886,7 @@ func (s *GoogleChromeManagementV1GraphicsInfo) MarshalJSON() ([]byte, error) { // Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is // offline, the collected data is stored locally, and will be reported // when the device is next online: No * Reported for affiliated users -// only: N/A +// only: N/A * Granular permission needed: TELEMETRY_API_GRAPHICS_REPORT type GoogleChromeManagementV1GraphicsStatusReport struct { // Displays: Output only. Information about the displays for the device. Displays []*GoogleChromeManagementV1DisplayInfo `json:"displays,omitempty"` @@ -2170,7 +2171,8 @@ func (s *GoogleChromeManagementV1ListTelemetryUsersResponse) MarshalJSON() ([]by // at device startup - Policy Controlled: Yes * Cache: If the device is // offline, the collected data is stored locally, and will be reported // when the device is next online: only for `totalMemoryEncryption` * -// Reported for affiliated users only: N/A +// Reported for affiliated users only: N/A * Granular permission needed: +// TELEMETRY_API_MEMORY_INFO type GoogleChromeManagementV1MemoryInfo struct { // AvailableRamBytes: Output only. Amount of available RAM in bytes. AvailableRamBytes int64 `json:"availableRamBytes,omitempty,string"` @@ -2215,7 +2217,8 @@ func (s *GoogleChromeManagementV1MemoryInfo) MarshalJSON() ([]byte, error) { // collected every 10 minutes * Default Data Reporting Frequency: Every // 3 hours - Policy Controlled: Yes * Cache: If the device is offline, // the collected data is stored locally, and will be reported when the -// device is next online: No * Reported for affiliated users only: N/A +// device is next online: No * Reported for affiliated users only: N/A * +// Granular permission needed: TELEMETRY_API_MEMORY_REPORT type GoogleChromeManagementV1MemoryStatusReport struct { // PageFaults: Output only. Number of page faults during this collection PageFaults int64 `json:"pageFaults,omitempty"` @@ -2320,7 +2323,8 @@ func (s *GoogleChromeManagementV1NetworkDevice) MarshalJSON() ([]byte, error) { // GoogleChromeManagementV1NetworkDiagnosticsReport: Network testing // results to determine the health of the device's network connection, -// for example whether the HTTPS latency is high or normal. +// for example whether the HTTPS latency is high or normal. * Granular +// permission needed: TELEMETRY_API_NETWORK_REPORT type GoogleChromeManagementV1NetworkDiagnosticsReport struct { // HttpsLatencyData: Output only. HTTPS latency test data. HttpsLatencyData *GoogleChromeManagementV1HttpsLatencyRoutineData `json:"httpsLatencyData,omitempty"` @@ -2362,7 +2366,8 @@ func (s *GoogleChromeManagementV1NetworkDiagnosticsReport) MarshalJSON() ([]byte // Reporting Frequency: At device startup - Policy Controlled: Yes * // Cache: If the device is offline, the collected data is stored // locally, and will be reported when the device is next online: Yes * -// Reported for affiliated users only: N/A +// Reported for affiliated users only: N/A * Granular permission needed: +// TELEMETRY_API_NETWORK_INFO type GoogleChromeManagementV1NetworkInfo struct { // NetworkDevices: Output only. List of network devices. NetworkDevices []*GoogleChromeManagementV1NetworkDevice `json:"networkDevices,omitempty"` @@ -2400,7 +2405,7 @@ func (s *GoogleChromeManagementV1NetworkInfo) MarshalJSON() ([]byte, error) { // Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is // offline, the collected data is stored locally, and will be reported // when the device is next online: Yes * Reported for affiliated users -// only: Yes +// only: Yes * Granular permission needed: TELEMETRY_API_NETWORK_REPORT type GoogleChromeManagementV1NetworkStatusReport struct { // ConnectionState: Output only. Current connection state of the // network. @@ -2507,7 +2512,7 @@ func (s *GoogleChromeManagementV1NetworkStatusReport) MarshalJSON() ([]byte, err // Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is // offline, the collected data is stored locally, and will be reported // when the device is next online: No * Reported for affiliated users -// only: N/A +// only: N/A * Granular permission needed: TELEMETRY_API_OS_REPORT type GoogleChromeManagementV1OsUpdateStatus struct { // LastRebootTime: Output only. Timestamp of the last reboot. LastRebootTime string `json:"lastRebootTime,omitempty"` @@ -2563,7 +2568,8 @@ func (s *GoogleChromeManagementV1OsUpdateStatus) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleChromeManagementV1PeripheralsReport: Peripherals report. +// GoogleChromeManagementV1PeripheralsReport: Peripherals report. * +// Granular permission needed: TELEMETRY_API_PERIPHERALS_REPORT type GoogleChromeManagementV1PeripheralsReport struct { // ReportTime: Output only. Timestamp of when the report was collected. ReportTime string `json:"reportTime,omitempty"` @@ -2603,7 +2609,7 @@ func (s *GoogleChromeManagementV1PeripheralsReport) MarshalJSON() ([]byte, error // Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is // offline, the collected data is stored locally, and will be reported // when the device is next online: No * Reported for affiliated users -// only: N/A +// only: N/A * Granular permission needed: TELEMETRY_API_STORAGE_INFO type GoogleChromeManagementV1StorageInfo struct { // AvailableDiskBytes: The available space for user data storage in the // device in bytes. @@ -2685,7 +2691,7 @@ func (s *GoogleChromeManagementV1StorageInfoDiskVolume) MarshalJSON() ([]byte, e // Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is // offline, the collected data is stored locally, and will be reported // when the device is next online: No * Reported for affiliated users -// only: N/A +// only: N/A * Granular permission needed: TELEMETRY_API_STORAGE_REPORT type GoogleChromeManagementV1StorageStatusReport struct { // Disk: Output only. Reports on disk. Disk []*GoogleChromeManagementV1DiskInfo `json:"disk,omitempty"` @@ -2719,12 +2725,14 @@ func (s *GoogleChromeManagementV1StorageStatusReport) MarshalJSON() ([]byte, err // GoogleChromeManagementV1TelemetryAudioSevereUnderrunEvent: // `TelemetryAudioSevereUnderrunEvent` is triggered when a audio devices -// run out of buffer data for more than 5 seconds. +// run out of buffer data for more than 5 seconds. * Granular permission +// needed: TELEMETRY_API_AUDIO_REPORT type GoogleChromeManagementV1TelemetryAudioSevereUnderrunEvent struct { } // GoogleChromeManagementV1TelemetryDevice: Telemetry data collected -// from a managed device. +// from a managed device. * Granular permission needed: +// TELEMETRY_API_DEVICE type GoogleChromeManagementV1TelemetryDevice struct { // AudioStatusReport: Output only. Audio reports collected periodically // sorted in a decreasing order of report_time. @@ -2844,7 +2852,8 @@ func (s *GoogleChromeManagementV1TelemetryDevice) MarshalJSON() ([]byte, error) } // GoogleChromeManagementV1TelemetryDeviceInfo: Information about a -// device associated with telemetry data. +// device associated with telemetry data. * Granular Permission needed: +// TELEMETRY_API_DEVICE type GoogleChromeManagementV1TelemetryDeviceInfo struct { // DeviceId: Output only. The unique Directory API ID of the device. // This value is the same as the Admin Console's Directory API ID in the @@ -2950,7 +2959,8 @@ func (s *GoogleChromeManagementV1TelemetryEvent) MarshalJSON() ([]byte, error) { // GoogleChromeManagementV1TelemetryHttpsLatencyChangeEvent: Https // latency routine is run periodically and // `TelemetryHttpsLatencyChangeEvent` is triggered if a latency problem -// was detected or if the device has recovered from a latency problem.. +// was detected or if the device has recovered from a latency problem. * +// Granular permission needed: TELEMETRY_API_NETWORK_REPORT type GoogleChromeManagementV1TelemetryHttpsLatencyChangeEvent struct { // HttpsLatencyRoutineData: HTTPS latency routine data that triggered // the event. @@ -2992,7 +3002,8 @@ func (s *GoogleChromeManagementV1TelemetryHttpsLatencyChangeEvent) MarshalJSON() // GoogleChromeManagementV1TelemetryUsbPeripheralsEvent: // `TelemetryUsbPeripheralsEvent` is triggered USB devices are either -// added or removed. +// added or removed. * Granular permission needed: +// TELEMETRY_API_PERIPHERALS_REPORT type GoogleChromeManagementV1TelemetryUsbPeripheralsEvent struct { // UsbPeripheralReport: List of usb devices that were either added or // removed. @@ -3023,7 +3034,7 @@ func (s *GoogleChromeManagementV1TelemetryUsbPeripheralsEvent) MarshalJSON() ([] } // GoogleChromeManagementV1TelemetryUser: Telemetry data collected from -// a managed user. +// a managed user. * Granular permission needed: TELEMETRY_API_USER type GoogleChromeManagementV1TelemetryUser struct { // Customer: G Suite Customer whose enterprise enrolled the device. Customer string `json:"customer,omitempty"` @@ -3071,7 +3082,8 @@ func (s *GoogleChromeManagementV1TelemetryUser) MarshalJSON() ([]byte, error) { } // GoogleChromeManagementV1TelemetryUserDevice: Telemetry data collected -// for a managed user and device. +// for a managed user and device. * Granular permission needed: +// TELEMETRY_API_DEVICE type GoogleChromeManagementV1TelemetryUserDevice struct { // AudioStatusReport: Output only. Audio reports collected periodically // sorted in a decreasing order of report_time. @@ -3111,7 +3123,8 @@ func (s *GoogleChromeManagementV1TelemetryUserDevice) MarshalJSON() ([]byte, err } // GoogleChromeManagementV1TelemetryUserInfo: Information about a user -// associated with telemetry data. +// associated with telemetry data. * Granular permission needed: +// TELEMETRY_API_USER type GoogleChromeManagementV1TelemetryUserInfo struct { // Email: Output only. User's email. Email string `json:"email,omitempty"` @@ -3151,7 +3164,8 @@ func (s *GoogleChromeManagementV1TelemetryUserInfo) MarshalJSON() ([]byte, error // Reporting Frequency: At device startup - Policy Controlled: No * // Cache: If the device is offline, the collected data is stored // locally, and will be reported when the device is next online: Yes * -// Reported for affiliated users only: N/A +// Reported for affiliated users only: N/A * Granular permission needed: +// TELEMETRY_API_BUS_DEVICE_INFO type GoogleChromeManagementV1ThunderboltInfo struct { // SecurityLevel: Security level of the Thunderbolt bus. // diff --git a/chromepolicy/v1/chromepolicy-api.json b/chromepolicy/v1/chromepolicy-api.json index e64b46b8ef9..b6986c91f34 100644 --- a/chromepolicy/v1/chromepolicy-api.json +++ b/chromepolicy/v1/chromepolicy-api.json @@ -557,7 +557,7 @@ } } }, - "revision": "20230402", + "revision": "20230507", "rootUrl": "https://chromepolicy.googleapis.com/", "schemas": { "ChromeCrosDpanelAutosettingsProtoPolicyApiLifecycle": { @@ -1214,6 +1214,14 @@ "readOnly": true, "type": "string" }, + "fieldDependencies": { + "description": "Output only. Field conditions required for this value to be valid.", + "items": { + "$ref": "GoogleChromePolicyVersionsV1PolicySchemaFieldDependencies" + }, + "readOnly": true, + "type": "array" + }, "value": { "description": "Output only. The string represenstation of the value that can be set for the field.", "readOnly": true, diff --git a/chromepolicy/v1/chromepolicy-gen.go b/chromepolicy/v1/chromepolicy-gen.go index 12468e4eea1..5702c365f53 100644 --- a/chromepolicy/v1/chromepolicy-gen.go +++ b/chromepolicy/v1/chromepolicy-gen.go @@ -1338,6 +1338,10 @@ type GoogleChromePolicyVersionsV1PolicySchemaFieldKnownValueDescription struct { // Description: Output only. Additional description for this value. Description string `json:"description,omitempty"` + // FieldDependencies: Output only. Field conditions required for this + // value to be valid. + FieldDependencies []*GoogleChromePolicyVersionsV1PolicySchemaFieldDependencies `json:"fieldDependencies,omitempty"` + // Value: Output only. The string represenstation of the value that can // be set for the field. Value string `json:"value,omitempty"` diff --git a/cloudasset/v1/cloudasset-api.json b/cloudasset/v1/cloudasset-api.json index 3e747c3ad48..e802fef02b2 100644 --- a/cloudasset/v1/cloudasset-api.json +++ b/cloudasset/v1/cloudasset-api.json @@ -1008,7 +1008,7 @@ "type": "string" }, "pageSize": { - "description": "Optional. The page size for search result pagination. Page size is capped at 500 even if a larger value is given. If set to zero, server will pick an appropriate default. Returned results may be fewer than requested. When this happens, there could be more results as long as `next_page_token` is returned.", + "description": "Optional. The page size for search result pagination. Page size is capped at 500 even if a larger value is given. If set to zero or a negative value, server will pick an appropriate default. Returned results may be fewer than requested. When this happens, there could be more results as long as `next_page_token` is returned.", "format": "int32", "location": "query", "type": "integer" @@ -1060,7 +1060,7 @@ "type": "string" }, "pageSize": { - "description": "Optional. The page size for search result pagination. Page size is capped at 500 even if a larger value is given. If set to zero, server will pick an appropriate default. Returned results may be fewer than requested. When this happens, there could be more results as long as `next_page_token` is returned.", + "description": "Optional. The page size for search result pagination. Page size is capped at 500 even if a larger value is given. If set to zero or a negative value, server will pick an appropriate default. Returned results may be fewer than requested. When this happens, there could be more results as long as `next_page_token` is returned.", "format": "int32", "location": "query", "type": "integer" @@ -1100,7 +1100,7 @@ } } }, - "revision": "20230414", + "revision": "20230429", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AccessSelector": { diff --git a/cloudasset/v1/cloudasset-gen.go b/cloudasset/v1/cloudasset-gen.go index ce83cbdb133..e966deb1ea4 100644 --- a/cloudasset/v1/cloudasset-gen.go +++ b/cloudasset/v1/cloudasset-gen.go @@ -11501,10 +11501,10 @@ func (c *V1SearchAllIamPoliciesCall) OrderBy(orderBy string) *V1SearchAllIamPoli // PageSize sets the optional parameter "pageSize": The page size for // search result pagination. Page size is capped at 500 even if a larger -// value is given. If set to zero, server will pick an appropriate -// default. Returned results may be fewer than requested. When this -// happens, there could be more results as long as `next_page_token` is -// returned. +// value is given. If set to zero or a negative value, server will pick +// an appropriate default. Returned results may be fewer than requested. +// When this happens, there could be more results as long as +// `next_page_token` is returned. func (c *V1SearchAllIamPoliciesCall) PageSize(pageSize int64) *V1SearchAllIamPoliciesCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c @@ -11681,7 +11681,7 @@ func (c *V1SearchAllIamPoliciesCall) Do(opts ...googleapi.CallOption) (*SearchAl // "type": "string" // }, // "pageSize": { - // "description": "Optional. The page size for search result pagination. Page size is capped at 500 even if a larger value is given. If set to zero, server will pick an appropriate default. Returned results may be fewer than requested. When this happens, there could be more results as long as `next_page_token` is returned.", + // "description": "Optional. The page size for search result pagination. Page size is capped at 500 even if a larger value is given. If set to zero or a negative value, server will pick an appropriate default. Returned results may be fewer than requested. When this happens, there could be more results as long as `next_page_token` is returned.", // "format": "int32", // "location": "query", // "type": "integer" @@ -11803,10 +11803,10 @@ func (c *V1SearchAllResourcesCall) OrderBy(orderBy string) *V1SearchAllResources // PageSize sets the optional parameter "pageSize": The page size for // search result pagination. Page size is capped at 500 even if a larger -// value is given. If set to zero, server will pick an appropriate -// default. Returned results may be fewer than requested. When this -// happens, there could be more results as long as `next_page_token` is -// returned. +// value is given. If set to zero or a negative value, server will pick +// an appropriate default. Returned results may be fewer than requested. +// When this happens, there could be more results as long as +// `next_page_token` is returned. func (c *V1SearchAllResourcesCall) PageSize(pageSize int64) *V1SearchAllResourcesCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c @@ -12013,7 +12013,7 @@ func (c *V1SearchAllResourcesCall) Do(opts ...googleapi.CallOption) (*SearchAllR // "type": "string" // }, // "pageSize": { - // "description": "Optional. The page size for search result pagination. Page size is capped at 500 even if a larger value is given. If set to zero, server will pick an appropriate default. Returned results may be fewer than requested. When this happens, there could be more results as long as `next_page_token` is returned.", + // "description": "Optional. The page size for search result pagination. Page size is capped at 500 even if a larger value is given. If set to zero or a negative value, server will pick an appropriate default. Returned results may be fewer than requested. When this happens, there could be more results as long as `next_page_token` is returned.", // "format": "int32", // "location": "query", // "type": "integer" diff --git a/cloudbilling/v1beta/cloudbilling-api.json b/cloudbilling/v1beta/cloudbilling-api.json index 7b39c22460f..8d096ae35a7 100644 --- a/cloudbilling/v1beta/cloudbilling-api.json +++ b/cloudbilling/v1beta/cloudbilling-api.json @@ -123,7 +123,7 @@ ], "parameters": { "billingAccount": { - "description": "Resource name of the billing account for the cost estimate. The resource name has the form `billingAccounts/{billing_acount_id}`. For example, `billingAccounts/012345-567890-ABCDEF` is the resource name for billing account `012345-567890-ABCDEF`. Must be specified.", + "description": "Resource name of the billing account for the cost estimate. The resource name has the form `billingAccounts/{billing_account_id}`. For example, `billingAccounts/012345-567890-ABCDEF` is the resource name for billing account `012345-567890-ABCDEF`. Must be specified.", "location": "path", "pattern": "^billingAccounts/[^/]+$", "required": true, @@ -170,7 +170,7 @@ } } }, - "revision": "20230402", + "revision": "20230507", "rootUrl": "https://cloudbilling.googleapis.com/", "schemas": { "CacheFillRegions": { diff --git a/cloudbilling/v1beta/cloudbilling-gen.go b/cloudbilling/v1beta/cloudbilling-gen.go index afb1cdb8053..2b57596d467 100644 --- a/cloudbilling/v1beta/cloudbilling-gen.go +++ b/cloudbilling/v1beta/cloudbilling-gen.go @@ -2185,7 +2185,7 @@ type BillingAccountsEstimateCostScenarioCall struct { // // - billingAccount: Resource name of the billing account for the cost // estimate. The resource name has the form -// `billingAccounts/{billing_acount_id}`. For example, +// `billingAccounts/{billing_account_id}`. For example, // `billingAccounts/012345-567890-ABCDEF` is the resource name for // billing account `012345-567890-ABCDEF`. Must be specified. func (r *BillingAccountsService) EstimateCostScenario(billingAccount string, estimatecostscenarioforbillingaccountrequest *EstimateCostScenarioForBillingAccountRequest) *BillingAccountsEstimateCostScenarioCall { @@ -2297,7 +2297,7 @@ func (c *BillingAccountsEstimateCostScenarioCall) Do(opts ...googleapi.CallOptio // ], // "parameters": { // "billingAccount": { - // "description": "Resource name of the billing account for the cost estimate. The resource name has the form `billingAccounts/{billing_acount_id}`. For example, `billingAccounts/012345-567890-ABCDEF` is the resource name for billing account `012345-567890-ABCDEF`. Must be specified.", + // "description": "Resource name of the billing account for the cost estimate. The resource name has the form `billingAccounts/{billing_account_id}`. For example, `billingAccounts/012345-567890-ABCDEF` is the resource name for billing account `012345-567890-ABCDEF`. Must be specified.", // "location": "path", // "pattern": "^billingAccounts/[^/]+$", // "required": true, diff --git a/cloudbuild/v1/cloudbuild-api.json b/cloudbuild/v1/cloudbuild-api.json index 48af4e213dc..430f50bbc4b 100644 --- a/cloudbuild/v1/cloudbuild-api.json +++ b/cloudbuild/v1/cloudbuild-api.json @@ -2295,7 +2295,7 @@ } } }, - "revision": "20230417", + "revision": "20230426", "rootUrl": "https://cloudbuild.googleapis.com/", "schemas": { "ApprovalConfig": { @@ -3704,6 +3704,10 @@ ], "type": "string" }, + "repository": { + "description": "The fully qualified resource name of the Repo API repository. Either uri or repository can be specified. If unspecified, the repo from which the trigger invocation originated is assumed to be the repo from which to read the specified path.", + "type": "string" + }, "revision": { "description": "The branch, tag, arbitrary ref, or SHA version of the repo to use when resolving the filename (optional). This field respects the same syntax/resolution as described here: https://git-scm.com/docs/gitrevisions If unspecified, the revision from which the trigger invocation originated is assumed to be the revision from which to read the specified path.", "type": "string" @@ -4041,6 +4045,10 @@ ], "type": "string" }, + "repository": { + "description": "The qualified resource name of the Repo API repository Either uri or repository can be specified and is required.", + "type": "string" + }, "uri": { "description": "The URI of the repo. Either uri or repository can be specified and is required.", "type": "string" diff --git a/cloudbuild/v1/cloudbuild-gen.go b/cloudbuild/v1/cloudbuild-gen.go index 554386fdc73..918e14a5659 100644 --- a/cloudbuild/v1/cloudbuild-gen.go +++ b/cloudbuild/v1/cloudbuild-gen.go @@ -2413,6 +2413,12 @@ type GitFileSource struct { // "GITLAB" - A GitLab-hosted repo. RepoType string `json:"repoType,omitempty"` + // Repository: The fully qualified resource name of the Repo API + // repository. Either uri or repository can be specified. If + // unspecified, the repo from which the trigger invocation originated is + // assumed to be the repo from which to read the specified path. + Repository string `json:"repository,omitempty"` + // Revision: The branch, tag, arbitrary ref, or SHA version of the repo // to use when resolving the filename (optional). This field respects // the same syntax/resolution as described here: @@ -2963,6 +2969,10 @@ type GitRepoSource struct { // "GITLAB" - A GitLab-hosted repo. RepoType string `json:"repoType,omitempty"` + // Repository: The qualified resource name of the Repo API repository + // Either uri or repository can be specified and is required. + Repository string `json:"repository,omitempty"` + // Uri: The URI of the repo. Either uri or repository can be specified // and is required. Uri string `json:"uri,omitempty"` diff --git a/cloudchannel/v1/cloudchannel-api.json b/cloudchannel/v1/cloudchannel-api.json index 4fe391b4fb5..79ef2981776 100644 --- a/cloudchannel/v1/cloudchannel-api.json +++ b/cloudchannel/v1/cloudchannel-api.json @@ -2055,7 +2055,7 @@ } } }, - "revision": "20230329", + "revision": "20230507", "rootUrl": "https://cloudchannel.googleapis.com/", "schemas": { "GoogleCloudChannelV1ActivateEntitlementRequest": { @@ -2672,11 +2672,11 @@ "properties": { "invoiceEndDate": { "$ref": "GoogleTypeDate", - "description": "The latest invoice date (exclusive). If your product uses monthly invoices, and this value is not the beginning of a month, this will adjust the date to the first day of the following month." + "description": "The latest invoice date (inclusive). If this value is not the last day of a month, this will move it forward to the last day of the given month." }, "invoiceStartDate": { "$ref": "GoogleTypeDate", - "description": "The earliest invoice date (inclusive). If your product uses monthly invoices, and this value is not the beginning of a month, this will adjust the date to the first day of the given month." + "description": "The earliest invoice date (inclusive). If this value is not the first day of a month, this will move it back to the first day of the given month." }, "usageEndDateTime": { "$ref": "GoogleTypeDateTime", @@ -2746,6 +2746,10 @@ "$ref": "GoogleCloudChannelV1AssociationInfo", "description": "Association information to other entitlements." }, + "billingAccount": { + "description": "Optional. The billing account resource name that is used to pay for this entitlement.", + "type": "string" + }, "commitmentSettings": { "$ref": "GoogleCloudChannelV1CommitmentSettings", "description": "Commitment settings for a commitment-based Offer. Required for commitment based offers." @@ -2766,7 +2770,7 @@ "type": "string" }, "parameters": { - "description": "Extended entitlement parameters. When creating an entitlement, valid parameter names and values are defined in the Offer.parameter_definitions. For Google Workspace, the following Parameters may be accepted as input: - max_units: The maximum assignable units for a flexible offer OR - num_units: The total commitment for commitment-based offers The response may additionally include the following output-only Parameters: - assigned_units: The number of licenses assigned to users. For GCP billing subaccounts, the following Parameter may be accepted as input: - display_name: The display name of the billing subaccount.", + "description": "Extended entitlement parameters. When creating an entitlement, valid parameter names and values are defined in the Offer.parameter_definitions. For Google Workspace, the following Parameters may be accepted as input: - max_units: The maximum assignable units for a flexible offer OR - num_units: The total commitment for commitment-based offers The response may additionally include the following output-only Parameters: - assigned_units: The number of licenses assigned to users. For Google Cloud billing subaccounts, the following Parameter may be accepted as input: - display_name: The display name of the billing subaccount.", "items": { "$ref": "GoogleCloudChannelV1Parameter" }, @@ -3040,6 +3044,13 @@ "pageToken": { "description": "Optional. A token that specifies a page of results beyond the first page. Obtained through FetchReportResultsResponse.next_page_token of the previous CloudChannelReportsService.FetchReportResults call.", "type": "string" + }, + "partitionKeys": { + "description": "Optional. List of keys specifying which report partitions to return. If empty, returns all partitions.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -3686,7 +3697,7 @@ "id": "GoogleCloudChannelV1Plan", "properties": { "billingAccount": { - "description": "Reseller Billing account to charge after an offer transaction. Only present for Google Cloud Platform offers.", + "description": "Reseller Billing account to charge after an offer transaction. Only present for Google Cloud offers.", "type": "string" }, "paymentCycle": { @@ -3792,8 +3803,8 @@ "GB (used for storage SKUs).", "Active licensed users(for Voice SKUs).", "Voice usage.", - "For IaaS SKUs like Google Cloud Platform, monetization is based on usage accrued on your billing account irrespective of the type of monetizable resource. This enum represents an aggregated resource/container for all usage SKUs on a billing account. Currently, only applicable to Google Cloud Platform.", - "For Google Cloud Platform subscriptions like Anthos or SAP." + "For IaaS SKUs like Google Cloud, monetization is based on usage accrued on your billing account irrespective of the type of monetizable resource. This enum represents an aggregated resource/container for all usage SKUs on a billing account. Currently, only applicable to Google Cloud.", + "For Google Cloud subscriptions like Anthos or SAP." ], "type": "string" } @@ -3909,7 +3920,7 @@ "type": "string" }, "provisioningId": { - "description": "Output only. Provisioning ID of the entitlement. For Google Workspace, this is the underlying Subscription ID. For Google Cloud Platform, this is the Billing Account ID of the billing subaccount.\"", + "description": "Output only. Provisioning ID of the entitlement. For Google Workspace, this is the underlying Subscription ID. For Google Cloud, this is the Billing Account ID of the billing subaccount.\"", "readOnly": true, "type": "string" }, @@ -4005,7 +4016,7 @@ "type": "object" }, "GoogleCloudChannelV1Report": { - "description": "The ID and description of a report that was used to generate report data. For example, \"GCP Daily Spend\", \"Google Workspace License Activity\", etc.", + "description": "The ID and description of a report that was used to generate report data. For example, \"Google Cloud Daily Spend\", \"Google Workspace License Activity\", etc.", "id": "GoogleCloudChannelV1Report", "properties": { "columns": { @@ -4223,6 +4234,10 @@ "description": "A row of report values.", "id": "GoogleCloudChannelV1Row", "properties": { + "partitionKey": { + "description": "The key for the partition this row belongs to. This field is empty if the report is not partitioned.", + "type": "string" + }, "values": { "description": "The list of values in the row.", "items": { @@ -4663,11 +4678,11 @@ "properties": { "invoiceEndDate": { "$ref": "GoogleTypeDate", - "description": "The latest invoice date (exclusive). If your product uses monthly invoices, and this value is not the beginning of a month, this will adjust the date to the first day of the following month." + "description": "The latest invoice date (inclusive). If this value is not the last day of a month, this will move it forward to the last day of the given month." }, "invoiceStartDate": { "$ref": "GoogleTypeDate", - "description": "The earliest invoice date (inclusive). If your product uses monthly invoices, and this value is not the beginning of a month, this will adjust the date to the first day of the given month." + "description": "The earliest invoice date (inclusive). If this value is not the first day of a month, this will move it back to the first day of the given month." }, "usageEndDateTime": { "$ref": "GoogleTypeDateTime", @@ -4693,6 +4708,10 @@ "$ref": "GoogleCloudChannelV1alpha1AssociationInfo", "description": "Association information to other entitlements." }, + "billingAccount": { + "description": "Optional. The billing account resource name that is used to pay for this entitlement.", + "type": "string" + }, "channelPartnerId": { "description": "Cloud Identity ID of a channel partner who will be the direct reseller for the customer's order. This field is generally used in 2-tier ordering, where the order is placed by a top-level distributor on behalf of their channel partner or reseller. Required for distributors. Deprecated: `channel_partner_id` has been moved to the Customer.", "type": "string" @@ -4727,7 +4746,7 @@ "type": "string" }, "parameters": { - "description": "Extended entitlement parameters. When creating an entitlement, valid parameter names and values are defined in the Offer.parameter_definitions. For Google Workspace, the following Parameters may be accepted as input: - max_units: The maximum assignable units for a flexible offer OR - num_units: The total commitment for commitment-based offers The response may additionally include the following output-only Parameters: - assigned_units: The number of licenses assigned to users. For GCP billing subaccounts, the following Parameter may be accepted as input: - display_name: The display name of the billing subaccount.", + "description": "Extended entitlement parameters. When creating an entitlement, valid parameter names and values are defined in the Offer.parameter_definitions. For Google Workspace, the following Parameters may be accepted as input: - max_units: The maximum assignable units for a flexible offer OR - num_units: The total commitment for commitment-based offers The response may additionally include the following output-only Parameters: - assigned_units: The number of licenses assigned to users. For Google Cloud billing subaccounts, the following Parameter may be accepted as input: - display_name: The display name of the billing subaccount.", "items": { "$ref": "GoogleCloudChannelV1alpha1Parameter" }, @@ -4949,7 +4968,7 @@ "type": "string" }, "provisioningId": { - "description": "Output only. Provisioning ID of the entitlement. For Google Workspace, this is the underlying Subscription ID. For Google Cloud Platform, this is the Billing Account ID of the billing subaccount.\"", + "description": "Output only. Provisioning ID of the entitlement. For Google Workspace, this is the underlying Subscription ID. For Google Cloud, this is the Billing Account ID of the billing subaccount.\"", "readOnly": true, "type": "string" }, @@ -5024,7 +5043,7 @@ "type": "object" }, "GoogleCloudChannelV1alpha1Report": { - "description": "The ID and description of a report that was used to generate report data. For example, \"GCP Daily Spend\", \"Google Workspace License Activity\", etc.", + "description": "The ID and description of a report that was used to generate report data. For example, \"Google Cloud Daily Spend\", \"Google Workspace License Activity\", etc.", "id": "GoogleCloudChannelV1alpha1Report", "properties": { "columns": { diff --git a/cloudchannel/v1/cloudchannel-gen.go b/cloudchannel/v1/cloudchannel-gen.go index 3355e0e0236..759411d01f9 100644 --- a/cloudchannel/v1/cloudchannel-gen.go +++ b/cloudchannel/v1/cloudchannel-gen.go @@ -1358,16 +1358,14 @@ func (s *GoogleCloudChannelV1CustomerRepricingConfig) MarshalJSON() ([]byte, err // GoogleCloudChannelV1DateRange: A representation of usage or invoice // date ranges. type GoogleCloudChannelV1DateRange struct { - // InvoiceEndDate: The latest invoice date (exclusive). If your product - // uses monthly invoices, and this value is not the beginning of a - // month, this will adjust the date to the first day of the following - // month. + // InvoiceEndDate: The latest invoice date (inclusive). If this value is + // not the last day of a month, this will move it forward to the last + // day of the given month. InvoiceEndDate *GoogleTypeDate `json:"invoiceEndDate,omitempty"` - // InvoiceStartDate: The earliest invoice date (inclusive). If your - // product uses monthly invoices, and this value is not the beginning of - // a month, this will adjust the date to the first day of the given - // month. + // InvoiceStartDate: The earliest invoice date (inclusive). If this + // value is not the first day of a month, this will move it back to the + // first day of the given month. InvoiceStartDate *GoogleTypeDate `json:"invoiceStartDate,omitempty"` // UsageEndDateTime: The latest usage date time (exclusive). If you use @@ -1463,6 +1461,10 @@ type GoogleCloudChannelV1Entitlement struct { // AssociationInfo: Association information to other entitlements. AssociationInfo *GoogleCloudChannelV1AssociationInfo `json:"associationInfo,omitempty"` + // BillingAccount: Optional. The billing account resource name that is + // used to pay for this entitlement. + BillingAccount string `json:"billingAccount,omitempty"` + // CommitmentSettings: Commitment settings for a commitment-based Offer. // Required for commitment based offers. CommitmentSettings *GoogleCloudChannelV1CommitmentSettings `json:"commitmentSettings,omitempty"` @@ -1488,9 +1490,9 @@ type GoogleCloudChannelV1Entitlement struct { // assignable units for a flexible offer OR - num_units: The total // commitment for commitment-based offers The response may additionally // include the following output-only Parameters: - assigned_units: The - // number of licenses assigned to users. For GCP billing subaccounts, - // the following Parameter may be accepted as input: - display_name: The - // display name of the billing subaccount. + // number of licenses assigned to users. For Google Cloud billing + // subaccounts, the following Parameter may be accepted as input: - + // display_name: The display name of the billing subaccount. Parameters []*GoogleCloudChannelV1Parameter `json:"parameters,omitempty"` // ProvisionedService: Output only. Service provisioning details for the @@ -1772,6 +1774,10 @@ type GoogleCloudChannelV1FetchReportResultsRequest struct { // CloudChannelReportsService.FetchReportResults call. PageToken string `json:"pageToken,omitempty"` + // PartitionKeys: Optional. List of keys specifying which report + // partitions to return. If empty, returns all partitions. + PartitionKeys []string `json:"partitionKeys,omitempty"` + // ForceSendFields is a list of field names (e.g. "PageSize") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -2928,7 +2934,7 @@ func (s *GoogleCloudChannelV1Period) MarshalJSON() ([]byte, error) { // how to make a payment. type GoogleCloudChannelV1Plan struct { // BillingAccount: Reseller Billing account to charge after an offer - // transaction. Only present for Google Cloud Platform offers. + // transaction. Only present for Google Cloud offers. BillingAccount string `json:"billingAccount,omitempty"` // PaymentCycle: Describes how frequently the reseller will be billed, @@ -3058,13 +3064,12 @@ type GoogleCloudChannelV1PriceByResource struct { // "GB" - GB (used for storage SKUs). // "LICENSED_USER" - Active licensed users(for Voice SKUs). // "MINUTES" - Voice usage. - // "IAAS_USAGE" - For IaaS SKUs like Google Cloud Platform, - // monetization is based on usage accrued on your billing account - // irrespective of the type of monetizable resource. This enum - // represents an aggregated resource/container for all usage SKUs on a - // billing account. Currently, only applicable to Google Cloud Platform. - // "SUBSCRIPTION" - For Google Cloud Platform subscriptions like - // Anthos or SAP. + // "IAAS_USAGE" - For IaaS SKUs like Google Cloud, monetization is + // based on usage accrued on your billing account irrespective of the + // type of monetizable resource. This enum represents an aggregated + // resource/container for all usage SKUs on a billing account. + // Currently, only applicable to Google Cloud. + // "SUBSCRIPTION" - For Google Cloud subscriptions like Anthos or SAP. ResourceType string `json:"resourceType,omitempty"` // ForceSendFields is a list of field names (e.g. "Price") to @@ -3256,8 +3261,7 @@ type GoogleCloudChannelV1ProvisionedService struct { // ProvisioningId: Output only. Provisioning ID of the entitlement. For // Google Workspace, this is the underlying Subscription ID. For Google - // Cloud Platform, this is the Billing Account ID of the billing - // subaccount." + // Cloud, this is the Billing Account ID of the billing subaccount." ProvisioningId string `json:"provisioningId,omitempty"` // SkuId: Output only. The SKU pertaining to the provisioning resource @@ -3459,8 +3463,8 @@ func (s *GoogleCloudChannelV1RenewalSettings) MarshalJSON() ([]byte, error) { } // GoogleCloudChannelV1Report: The ID and description of a report that -// was used to generate report data. For example, "GCP Daily Spend", -// "Google Workspace License Activity", etc. +// was used to generate report data. For example, "Google Cloud Daily +// Spend", "Google Workspace License Activity", etc. type GoogleCloudChannelV1Report struct { // Columns: The list of columns included in the report. This defines the // schema of the report results. @@ -3831,10 +3835,14 @@ func (s *GoogleCloudChannelV1RepricingConfigEntitlementGranularity) MarshalJSON( // GoogleCloudChannelV1Row: A row of report values. type GoogleCloudChannelV1Row struct { + // PartitionKey: The key for the partition this row belongs to. This + // field is empty if the report is not partitioned. + PartitionKey string `json:"partitionKey,omitempty"` + // Values: The list of values in the row. Values []*GoogleCloudChannelV1ReportValue `json:"values,omitempty"` - // ForceSendFields is a list of field names (e.g. "Values") to + // ForceSendFields is a list of field names (e.g. "PartitionKey") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3842,10 +3850,10 @@ type GoogleCloudChannelV1Row struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Values") to include in API - // requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "PartitionKey") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` @@ -4735,16 +4743,14 @@ func (s *GoogleCloudChannelV1alpha1CustomerEvent) MarshalJSON() ([]byte, error) // GoogleCloudChannelV1alpha1DateRange: A representation of usage or // invoice date ranges. type GoogleCloudChannelV1alpha1DateRange struct { - // InvoiceEndDate: The latest invoice date (exclusive). If your product - // uses monthly invoices, and this value is not the beginning of a - // month, this will adjust the date to the first day of the following - // month. + // InvoiceEndDate: The latest invoice date (inclusive). If this value is + // not the last day of a month, this will move it forward to the last + // day of the given month. InvoiceEndDate *GoogleTypeDate `json:"invoiceEndDate,omitempty"` - // InvoiceStartDate: The earliest invoice date (inclusive). If your - // product uses monthly invoices, and this value is not the beginning of - // a month, this will adjust the date to the first day of the given - // month. + // InvoiceStartDate: The earliest invoice date (inclusive). If this + // value is not the first day of a month, this will move it back to the + // first day of the given month. InvoiceStartDate *GoogleTypeDate `json:"invoiceStartDate,omitempty"` // UsageEndDateTime: The latest usage date time (exclusive). If you use @@ -4796,6 +4802,10 @@ type GoogleCloudChannelV1alpha1Entitlement struct { // AssociationInfo: Association information to other entitlements. AssociationInfo *GoogleCloudChannelV1alpha1AssociationInfo `json:"associationInfo,omitempty"` + // BillingAccount: Optional. The billing account resource name that is + // used to pay for this entitlement. + BillingAccount string `json:"billingAccount,omitempty"` + // ChannelPartnerId: Cloud Identity ID of a channel partner who will be // the direct reseller for the customer's order. This field is generally // used in 2-tier ordering, where the order is placed by a top-level @@ -4842,9 +4852,9 @@ type GoogleCloudChannelV1alpha1Entitlement struct { // assignable units for a flexible offer OR - num_units: The total // commitment for commitment-based offers The response may additionally // include the following output-only Parameters: - assigned_units: The - // number of licenses assigned to users. For GCP billing subaccounts, - // the following Parameter may be accepted as input: - display_name: The - // display name of the billing subaccount. + // number of licenses assigned to users. For Google Cloud billing + // subaccounts, the following Parameter may be accepted as input: - + // display_name: The display name of the billing subaccount. Parameters []*GoogleCloudChannelV1alpha1Parameter `json:"parameters,omitempty"` // ProvisionedService: Output only. Service provisioning details for the @@ -5124,8 +5134,7 @@ type GoogleCloudChannelV1alpha1ProvisionedService struct { // ProvisioningId: Output only. Provisioning ID of the entitlement. For // Google Workspace, this is the underlying Subscription ID. For Google - // Cloud Platform, this is the Billing Account ID of the billing - // subaccount." + // Cloud, this is the Billing Account ID of the billing subaccount." ProvisioningId string `json:"provisioningId,omitempty"` // SkuId: Output only. The SKU pertaining to the provisioning resource @@ -5225,8 +5234,8 @@ func (s *GoogleCloudChannelV1alpha1RenewalSettings) MarshalJSON() ([]byte, error } // GoogleCloudChannelV1alpha1Report: The ID and description of a report -// that was used to generate report data. For example, "GCP Daily -// Spend", "Google Workspace License Activity", etc. +// that was used to generate report data. For example, "Google Cloud +// Daily Spend", "Google Workspace License Activity", etc. type GoogleCloudChannelV1alpha1Report struct { // Columns: The list of columns included in the report. This defines the // schema of the report results. diff --git a/clouddeploy/v1/clouddeploy-api.json b/clouddeploy/v1/clouddeploy-api.json index f719fcb2f9a..3f70f75d6f2 100644 --- a/clouddeploy/v1/clouddeploy-api.json +++ b/clouddeploy/v1/clouddeploy-api.json @@ -1451,7 +1451,7 @@ } } }, - "revision": "20230315", + "revision": "20230426", "rootUrl": "https://clouddeploy.googleapis.com/", "schemas": { "AbandonReleaseRequest": { @@ -1945,6 +1945,26 @@ }, "type": "object" }, + "DeployArtifact": { + "description": "The artifacts produced by a deploy operation.", + "id": "DeployArtifact", + "properties": { + "artifactUri": { + "description": "Output only. URI of a directory containing the artifacts. All paths are relative to this location.", + "readOnly": true, + "type": "string" + }, + "manifestPaths": { + "description": "Output only. File paths of the manifests applied during the deploy operation relative to the URI.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, "DeployJob": { "description": "A deploy Job.", "id": "DeployJob", @@ -1955,6 +1975,11 @@ "description": "DeployJobRun contains information specific to a deploy `JobRun`.", "id": "DeployJobRun", "properties": { + "artifact": { + "$ref": "DeployArtifact", + "description": "Output only. The artifact of a deploy job run, if available.", + "readOnly": true + }, "build": { "description": "Output only. The resource name of the Cloud Build `Build` object that is used to deploy. Format is projects/{project}/locations/{location}/builds/{build}.", "readOnly": true, @@ -2012,7 +2037,7 @@ "properties": { "deployJob": { "$ref": "Job", - "description": "Output only. The deploy Job. This is the first job run in the phase.", + "description": "Output only. The deploy Job. This is the deploy job in the phase.", "readOnly": true }, "verifyJob": { @@ -2539,7 +2564,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -2731,6 +2756,11 @@ "description": "Contains the paths to the artifacts, relative to the URI, for a phase.", "id": "PhaseArtifact", "properties": { + "jobManifestsPath": { + "description": "Output only. File path of the directory of rendered job manifests relative to the URI. This is only set if it is applicable.", + "readOnly": true, + "type": "string" + }, "manifestPath": { "description": "Output only. File path of the rendered manifest relative to the URI.", "readOnly": true, diff --git a/clouddeploy/v1/clouddeploy-gen.go b/clouddeploy/v1/clouddeploy-gen.go index 12987ca74a4..23e823ad143 100644 --- a/clouddeploy/v1/clouddeploy-gen.go +++ b/clouddeploy/v1/clouddeploy-gen.go @@ -1169,6 +1169,39 @@ func (s *DeliveryPipelineNotificationEvent) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// DeployArtifact: The artifacts produced by a deploy operation. +type DeployArtifact struct { + // ArtifactUri: Output only. URI of a directory containing the + // artifacts. All paths are relative to this location. + ArtifactUri string `json:"artifactUri,omitempty"` + + // ManifestPaths: Output only. File paths of the manifests applied + // during the deploy operation relative to the URI. + ManifestPaths []string `json:"manifestPaths,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ArtifactUri") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ArtifactUri") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *DeployArtifact) MarshalJSON() ([]byte, error) { + type NoMethod DeployArtifact + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // DeployJob: A deploy Job. type DeployJob struct { } @@ -1176,6 +1209,10 @@ type DeployJob struct { // DeployJobRun: DeployJobRun contains information specific to a deploy // `JobRun`. type DeployJobRun struct { + // Artifact: Output only. The artifact of a deploy job run, if + // available. + Artifact *DeployArtifact `json:"artifact,omitempty"` + // Build: Output only. The resource name of the Cloud Build `Build` // object that is used to deploy. Format is // projects/{project}/locations/{location}/builds/{build}. @@ -1211,7 +1248,7 @@ type DeployJobRun struct { // deploy job run. Metadata *DeployJobRunMetadata `json:"metadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "Build") to + // ForceSendFields is a list of field names (e.g. "Artifact") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -1219,8 +1256,8 @@ type DeployJobRun struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Build") to include in API - // requests with the JSON null value. By default, fields with empty + // NullFields is a list of field names (e.g. "Artifact") to include in + // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. @@ -1266,8 +1303,8 @@ func (s *DeployJobRunMetadata) MarshalJSON() ([]byte, error) { // DeploymentJobs: Deployment job composition. type DeploymentJobs struct { - // DeployJob: Output only. The deploy Job. This is the first job run in - // the phase. + // DeployJob: Output only. The deploy Job. This is the deploy job in the + // phase. DeployJob *Job `json:"deployJob,omitempty"` // VerifyJob: Output only. The verify Job. Runs after a deploy if the @@ -2068,7 +2105,7 @@ func (s *ListTargetsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -2345,6 +2382,11 @@ func (s *Phase) MarshalJSON() ([]byte, error) { // PhaseArtifact: Contains the paths to the artifacts, relative to the // URI, for a phase. type PhaseArtifact struct { + // JobManifestsPath: Output only. File path of the directory of rendered + // job manifests relative to the URI. This is only set if it is + // applicable. + JobManifestsPath string `json:"jobManifestsPath,omitempty"` + // ManifestPath: Output only. File path of the rendered manifest // relative to the URI. ManifestPath string `json:"manifestPath,omitempty"` @@ -2353,7 +2395,7 @@ type PhaseArtifact struct { // configuration relative to the URI. SkaffoldConfigPath string `json:"skaffoldConfigPath,omitempty"` - // ForceSendFields is a list of field names (e.g. "ManifestPath") to + // ForceSendFields is a list of field names (e.g. "JobManifestsPath") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -2361,12 +2403,13 @@ type PhaseArtifact struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ManifestPath") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. + // NullFields is a list of field names (e.g. "JobManifestsPath") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. NullFields []string `json:"-"` } diff --git a/cloudkms/v1/cloudkms-api.json b/cloudkms/v1/cloudkms-api.json index fad5b8b7541..e67cbc2aa36 100644 --- a/cloudkms/v1/cloudkms-api.json +++ b/cloudkms/v1/cloudkms-api.json @@ -1763,7 +1763,7 @@ } } }, - "revision": "20230407", + "revision": "20230427", "rootUrl": "https://cloudkms.googleapis.com/", "schemas": { "AsymmetricDecryptRequest": { @@ -3103,7 +3103,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/cloudkms/v1/cloudkms-gen.go b/cloudkms/v1/cloudkms-gen.go index 986914120f6..e495acc49e2 100644 --- a/cloudkms/v1/cloudkms-gen.go +++ b/cloudkms/v1/cloudkms-gen.go @@ -2468,7 +2468,7 @@ func (s *ListLocationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/cloudresourcemanager/v3/cloudresourcemanager-api.json b/cloudresourcemanager/v3/cloudresourcemanager-api.json index af239dcba9d..24f9929ac6b 100644 --- a/cloudresourcemanager/v3/cloudresourcemanager-api.json +++ b/cloudresourcemanager/v3/cloudresourcemanager-api.json @@ -1805,7 +1805,7 @@ } } }, - "revision": "20230416", + "revision": "20230430", "rootUrl": "https://cloudresourcemanager.googleapis.com/", "schemas": { "AuditConfig": { @@ -2872,7 +2872,7 @@ ], "enumDescriptions": [ "Unspecified purpose.", - "Purpose for Compute Engine firewalls. A corresponding purpose_data should be set for the network the tag is intended for. The key should be 'network' and the value should be in either of these two formats: -https://www.googleapis.com/compute/{compute_version}/projects/{project_id}/global/networks/{network_id} -{project_id}/{network_name} Examples: -https://www.googleapis.com/compute/staging_v1/projects/fail-closed-load-testing/global/networks/6992953698831725600 -fail-closed-load-testing/load-testing-network" + "Purpose for Compute Engine firewalls. A corresponding `purpose_data` should be set for the network the tag is intended for. The key should be `network` and the value should be in ## either of these two formats: `https://www.googleapis.com/compute/{compute_version}/projects/{project_id}/global/networks/{network_id}` - `{project_id}/{network_name}` ## Examples: `https://www.googleapis.com/compute/staging_v1/projects/fail-closed-load-testing/global/networks/6992953698831725600` - `fail-closed-load-testing/load-testing-network`" ], "type": "string" }, diff --git a/cloudresourcemanager/v3/cloudresourcemanager-gen.go b/cloudresourcemanager/v3/cloudresourcemanager-gen.go index 4efd6eddd0e..786ff6b8401 100644 --- a/cloudresourcemanager/v3/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v3/cloudresourcemanager-gen.go @@ -2228,15 +2228,15 @@ type TagKey struct { // Possible values: // "PURPOSE_UNSPECIFIED" - Unspecified purpose. // "GCE_FIREWALL" - Purpose for Compute Engine firewalls. A - // corresponding purpose_data should be set for the network the tag is - // intended for. The key should be 'network' and the value should be in - // either of these two formats: - // -https://www.googleapis.com/compute/{compute_version}/projects/{projec - // t_id}/global/networks/{network_id} -{project_id}/{network_name} - // Examples: - // -https://www.googleapis.com/compute/staging_v1/projects/fail-closed-lo - // ad-testing/global/networks/6992953698831725600 - // -fail-closed-load-testing/load-testing-network + // corresponding `purpose_data` should be set for the network the tag is + // intended for. The key should be `network` and the value should be in + // ## either of these two formats: + // `https://www.googleapis.com/compute/{compute_version}/projects/{projec + // t_id}/global/networks/{network_id}` - `{project_id}/{network_name}` + // ## Examples: + // `https://www.googleapis.com/compute/staging_v1/projects/fail-closed-lo + // ad-testing/global/networks/6992953698831725600` - + // `fail-closed-load-testing/load-testing-network` Purpose string `json:"purpose,omitempty"` // PurposeData: Optional. Purpose data corresponds to the policy system diff --git a/cloudscheduler/v1/cloudscheduler-api.json b/cloudscheduler/v1/cloudscheduler-api.json index 7d6b2b11af7..d90afd5e9a3 100644 --- a/cloudscheduler/v1/cloudscheduler-api.json +++ b/cloudscheduler/v1/cloudscheduler-api.json @@ -418,7 +418,7 @@ } } }, - "revision": "20230414", + "revision": "20230421", "rootUrl": "https://cloudscheduler.googleapis.com/", "schemas": { "AppEngineHttpTarget": { @@ -674,7 +674,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/cloudscheduler/v1/cloudscheduler-gen.go b/cloudscheduler/v1/cloudscheduler-gen.go index d4aa78f3da9..aa451bfbb92 100644 --- a/cloudscheduler/v1/cloudscheduler-gen.go +++ b/cloudscheduler/v1/cloudscheduler-gen.go @@ -652,7 +652,7 @@ func (s *ListLocationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/cloudscheduler/v1beta1/cloudscheduler-api.json b/cloudscheduler/v1beta1/cloudscheduler-api.json index 3ac7b3f0c67..df6dcf9379e 100644 --- a/cloudscheduler/v1beta1/cloudscheduler-api.json +++ b/cloudscheduler/v1beta1/cloudscheduler-api.json @@ -433,7 +433,7 @@ } } }, - "revision": "20230414", + "revision": "20230421", "rootUrl": "https://cloudscheduler.googleapis.com/", "schemas": { "AppEngineHttpTarget": { @@ -693,7 +693,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/cloudscheduler/v1beta1/cloudscheduler-gen.go b/cloudscheduler/v1beta1/cloudscheduler-gen.go index ab64be9fc4b..ffea4daf017 100644 --- a/cloudscheduler/v1beta1/cloudscheduler-gen.go +++ b/cloudscheduler/v1beta1/cloudscheduler-gen.go @@ -659,7 +659,7 @@ func (s *ListLocationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/cloudsupport/v2beta/cloudsupport-api.json b/cloudsupport/v2beta/cloudsupport-api.json index 52a5edf60ff..5169a2fdccd 100644 --- a/cloudsupport/v2beta/cloudsupport-api.json +++ b/cloudsupport/v2beta/cloudsupport-api.json @@ -126,7 +126,7 @@ "type": "string" }, "query": { - "description": "An expression written in the Cloud filter language. If non-empty, then only cases whose fields match the filter are returned. If empty, then no messages are filtered out.", + "description": "An expression written in the Google Cloud filter language. If non-empty, then only cases whose fields match the filter are returned. If empty, then no messages are filtered out.", "location": "query", "type": "string" } @@ -172,7 +172,7 @@ ] }, "create": { - "description": "Create a new case and associate it with the given Cloud resource. The case object must have the following fields set: display_name, description, classification, and severity.", + "description": "Create a new case and associate it with the given Google Cloud Resource. The case object must have the following fields set: `display_name`, `description`, `classification`, and `priority`.", "flatPath": "v2beta/{v2betaId}/{v2betaId1}/cases", "httpMethod": "POST", "id": "cloudsupport.cases.create", @@ -181,7 +181,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the Cloud resource under which the case should be created.", + "description": "Required. The name of the Google Cloud Resource under which the case should be created.", "location": "path", "pattern": "^[^/]+/[^/]+$", "required": true, @@ -200,7 +200,7 @@ ] }, "escalate": { - "description": "Escalate a case. Escalating a case will initiate the Cloud Support escalation management process. This operation is only available to certain Customer Care tiers. Go to https://cloud.google.com/support and look for 'Technical support escalations' in the feature list to find out which tiers are able to perform escalations.", + "description": "Escalate a case. Escalating a case will initiate the Google Cloud Support escalation management process. This operation is only available to certain Customer Care tiers. Go to https://cloud.google.com/support and look for 'Technical support escalations' in the feature list to find out which tiers are able to perform escalations.", "flatPath": "v2beta/{v2betaId}/{v2betaId1}/cases/{casesId}:escalate", "httpMethod": "POST", "id": "cloudsupport.cases.escalate", @@ -262,7 +262,7 @@ ], "parameters": { "filter": { - "description": "An expression written in filter language. If non-empty, the query returns the cases that match the filter. Else, the query doesn't filter the cases. Filter expressions use the following fields with the operators equals (`=`) and `AND`: - `state`: The accepted values are `OPEN` or `CLOSED`. - `priority`: The accepted values are `P0`, `P1`, `P2`, `P3`, or `P4`. You can specify multiple values for priority using the `OR` operator. For example, `priority=P1 OR priority=P2`. - [DEPRECATED] `severity`: The accepted values are `S0`, `S1`, `S2`, `S3`, or `S4`. - `creator.email`: The email address of the case creator. Examples: - `state=CLOSED` - `state=OPEN AND creator.email=\"tester@example.com\"` - `state=OPEN AND (priority=P0 OR priority=P1)`", + "description": "An expression written in filter language. If non-empty, the query returns the cases that match the filter. Else, the query doesn't filter the cases. Filter expressions use the following fields with the operators equals (`=`) and `AND`: - `state`: The accepted values are `OPEN` or `CLOSED`. - `priority`: The accepted values are `P0`, `P1`, `P2`, `P3`, or `P4`. You can specify multiple values for priority using the `OR` operator. For example, `priority=P1 OR priority=P2`. - `creator.email`: The email address of the case creator. Examples: - `state=CLOSED` - `state=OPEN AND creator.email=\"tester@example.com\"` - `state=OPEN AND (priority=P0 OR priority=P1)`", "location": "query", "type": "string" }, @@ -310,7 +310,7 @@ "type": "string" }, "updateMask": { - "description": "A list of attributes of the case object that should be updated as part of this request. Supported values are severity, display_name, and subscriber_email_addresses. If no fields are specified, all supported fields are updated. WARNING: If you do not provide a field mask, then you may accidentally clear some fields. For example, if you leave field mask empty and do not provide a value for subscriber_email_addresses, then subscriber_email_addresses is updated to empty.", + "description": "A list of attributes of the case object that should be updated as part of this request. Supported values are `priority`, `display_name`, and `subscriber_email_addresses`. If no fields are specified, all supported fields are updated. WARNING: If you do not provide a field mask, then you might accidentally clear some fields. For example, if you leave the field mask empty and do not provide a value for `subscriber_email_addresses`, then `subscriber_email_addresses` is updated to empty.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -346,7 +346,7 @@ "type": "string" }, "query": { - "description": "An expression written in filter language. A query uses the following fields with the operators equals (`=`) and `AND`: - `organization`: An organization name in the form `organizations/`. - `project`: A project name in the form `projects/`. - `state`: The accepted values are `OPEN` or `CLOSED`. - `priority`: The accepted values are `P0`, `P1`, `P2`, `P3`, or `P4`. You can specify multiple values for priority using the `OR` operator. For example, `priority=P1 OR priority=P2`. - [DEPRECATED] `severity`: The accepted values are `S0`, `S1`, `S2`, `S3`, or `S4`. - `creator.email`: The email address of the case creator. - `billingAccount`: A billing account in the form `billingAccounts/` You must specify eitehr `organization` or `project`. To search across `displayName`, `description`, and comments, use a global restriction with no keyword or operator. For example, `\"my search\"`. To search only cases updated after a certain date, use `update_time` retricted with that particular date, time, and timezone in ISO datetime format. For example, `update_time\u003e\"2020-01-01T00:00:00-05:00\"`. `update_time` only supports the greater than operator (`\u003e`). Examples: - `organization=\"organizations/123456789\"` - `project=\"projects/my-project-id\"` - `project=\"projects/123456789\"` - `billing_account=\"billingAccounts/123456-A0B0C0-CUZ789\"` - `organization=\"organizations/123456789\" AND state=CLOSED` - `project=\"projects/my-project-id\" AND creator.email=\"tester@example.com\"` - `project=\"projects/my-project-id\" AND (priority=P0 OR priority=P1)`", + "description": "An expression written in filter language. A query uses the following fields with the operators equals (`=`) and `AND`: - `organization`: An organization name in the form `organizations/`. - `project`: A project name in the form `projects/`. - `state`: The accepted values are `OPEN` or `CLOSED`. - `priority`: The accepted values are `P0`, `P1`, `P2`, `P3`, or `P4`. You can specify multiple values for priority using the `OR` operator. For example, `priority=P1 OR priority=P2`. - `creator.email`: The email address of the case creator. - `billingAccount`: A billing account in the form `billingAccounts/` You must specify either `organization` or `project`. To search across `displayName`, `description`, and comments, use a global restriction with no keyword or operator. For example, `\"my search\"`. To search only cases updated after a certain date, use `update_time` restricted with that particular date, time, and timezone in ISO datetime format. For example, `update_time\u003e\"2020-01-01T00:00:00-05:00\"`. `update_time` only supports the greater than operator (`\u003e`). Examples: - `organization=\"organizations/123456789\"` - `project=\"projects/my-project-id\"` - `project=\"projects/123456789\"` - `billing_account=\"billingAccounts/123456-A0B0C0-CUZ789\"` - `organization=\"organizations/123456789\" AND state=CLOSED` - `project=\"projects/my-project-id\" AND creator.email=\"tester@example.com\"` - `project=\"projects/my-project-id\" AND (priority=P0 OR priority=P1)`", "location": "query", "type": "string" } @@ -543,7 +543,7 @@ } } }, - "revision": "20230412", + "revision": "20230507", "rootUrl": "https://cloudsupport.googleapis.com/", "schemas": { "Actor": { @@ -677,7 +677,7 @@ "type": "string" }, "priority": { - "description": "The priority of this case. If this is set, do not set severity.", + "description": "The priority of this case.", "enum": [ "PRIORITY_UNSPECIFIED", "P0", @@ -1090,14 +1090,14 @@ "id": "ListCasesResponse", "properties": { "cases": { - "description": "The list of cases associated with the cloud resource, after any filters have been applied.", + "description": "The list of cases associated with the Google Cloud Resource, after any filters have been applied.", "items": { "$ref": "Case" }, "type": "array" }, "nextPageToken": { - "description": "A token to retrieve the next page of results. This should be set in the `page_token` field of subsequent `ListCasesRequest` message that is issued. If unspecified, there are no more results to retrieve.", + "description": "A token to retrieve the next page of results. This should be set in the `page_token` field of the subsequent `ListCasesRequest` message that is issued. If unspecified, there are no more results to retrieve.", "type": "string" } }, @@ -1335,7 +1335,7 @@ "id": "SearchCasesResponse", "properties": { "cases": { - "description": "The list of Case associated with the cloud resource, after any filters have been applied.", + "description": "The list of cases associated with the Google Cloud Resource, after any filters have been applied.", "items": { "$ref": "Case" }, diff --git a/cloudsupport/v2beta/cloudsupport-gen.go b/cloudsupport/v2beta/cloudsupport-gen.go index 03a3d5868b2..86d3bafe7b5 100644 --- a/cloudsupport/v2beta/cloudsupport-gen.go +++ b/cloudsupport/v2beta/cloudsupport-gen.go @@ -372,8 +372,7 @@ type Case struct { // Name: The resource name for the case. Name string `json:"name,omitempty"` - // Priority: The priority of this case. If this is set, do not set - // severity. + // Priority: The priority of this case. // // Possible values: // "PRIORITY_UNSPECIFIED" - Priority is undefined or has not been set @@ -1018,12 +1017,12 @@ func (s *ListAttachmentsResponse) MarshalJSON() ([]byte, error) { // ListCasesResponse: The response message for the ListCases endpoint. type ListCasesResponse struct { - // Cases: The list of cases associated with the cloud resource, after - // any filters have been applied. + // Cases: The list of cases associated with the Google Cloud Resource, + // after any filters have been applied. Cases []*Case `json:"cases,omitempty"` // NextPageToken: A token to retrieve the next page of results. This - // should be set in the `page_token` field of subsequent + // should be set in the `page_token` field of the subsequent // `ListCasesRequest` message that is issued. If unspecified, there are // no more results to retrieve. NextPageToken string `json:"nextPageToken,omitempty"` @@ -1327,8 +1326,8 @@ func (s *SearchCaseClassificationsResponse) MarshalJSON() ([]byte, error) { // SearchCasesResponse: The response message for the SearchCases // endpoint. type SearchCasesResponse struct { - // Cases: The list of Case associated with the cloud resource, after any - // filters have been applied. + // Cases: The list of cases associated with the Google Cloud Resource, + // after any filters have been applied. Cases []*Case `json:"cases,omitempty"` // NextPageToken: A token to retrieve the next page of results. This @@ -1451,8 +1450,8 @@ func (c *CaseClassificationsSearchCall) PageToken(pageToken string) *CaseClassif } // Query sets the optional parameter "query": An expression written in -// the Cloud filter language. If non-empty, then only cases whose fields -// match the filter are returned. If empty, then no messages are +// the Google Cloud filter language. If non-empty, then only cases whose +// fields match the filter are returned. If empty, then no messages are // filtered out. func (c *CaseClassificationsSearchCall) Query(query string) *CaseClassificationsSearchCall { c.urlParams_.Set("query", query) @@ -1574,7 +1573,7 @@ func (c *CaseClassificationsSearchCall) Do(opts ...googleapi.CallOption) (*Searc // "type": "string" // }, // "query": { - // "description": "An expression written in the Cloud filter language. If non-empty, then only cases whose fields match the filter are returned. If empty, then no messages are filtered out.", + // "description": "An expression written in the Google Cloud filter language. If non-empty, then only cases whose fields match the filter are returned. If empty, then no messages are filtered out.", // "location": "query", // "type": "string" // } @@ -1764,12 +1763,12 @@ type CasesCreateCall struct { header_ http.Header } -// Create: Create a new case and associate it with the given Cloud -// resource. The case object must have the following fields set: -// display_name, description, classification, and severity. +// Create: Create a new case and associate it with the given Google +// Cloud Resource. The case object must have the following fields set: +// `display_name`, `description`, `classification`, and `priority`. // -// - parent: The name of the Cloud resource under which the case should -// be created. +// - parent: The name of the Google Cloud Resource under which the case +// should be created. func (r *CasesService) Create(parent string, case_ *Case) *CasesCreateCall { c := &CasesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -1868,7 +1867,7 @@ func (c *CasesCreateCall) Do(opts ...googleapi.CallOption) (*Case, error) { } return ret, nil // { - // "description": "Create a new case and associate it with the given Cloud resource. The case object must have the following fields set: display_name, description, classification, and severity.", + // "description": "Create a new case and associate it with the given Google Cloud Resource. The case object must have the following fields set: `display_name`, `description`, `classification`, and `priority`.", // "flatPath": "v2beta/{v2betaId}/{v2betaId1}/cases", // "httpMethod": "POST", // "id": "cloudsupport.cases.create", @@ -1877,7 +1876,7 @@ func (c *CasesCreateCall) Do(opts ...googleapi.CallOption) (*Case, error) { // ], // "parameters": { // "parent": { - // "description": "Required. The name of the Cloud resource under which the case should be created.", + // "description": "Required. The name of the Google Cloud Resource under which the case should be created.", // "location": "path", // "pattern": "^[^/]+/[^/]+$", // "required": true, @@ -1909,8 +1908,8 @@ type CasesEscalateCall struct { header_ http.Header } -// Escalate: Escalate a case. Escalating a case will initiate the Cloud -// Support escalation management process. This operation is only +// Escalate: Escalate a case. Escalating a case will initiate the Google +// Cloud Support escalation management process. This operation is only // available to certain Customer Care tiers. Go to // https://cloud.google.com/support and look for 'Technical support // escalations' in the feature list to find out which tiers are able to @@ -2016,7 +2015,7 @@ func (c *CasesEscalateCall) Do(opts ...googleapi.CallOption) (*Case, error) { } return ret, nil // { - // "description": "Escalate a case. Escalating a case will initiate the Cloud Support escalation management process. This operation is only available to certain Customer Care tiers. Go to https://cloud.google.com/support and look for 'Technical support escalations' in the feature list to find out which tiers are able to perform escalations.", + // "description": "Escalate a case. Escalating a case will initiate the Google Cloud Support escalation management process. This operation is only available to certain Customer Care tiers. Go to https://cloud.google.com/support and look for 'Technical support escalations' in the feature list to find out which tiers are able to perform escalations.", // "flatPath": "v2beta/{v2betaId}/{v2betaId1}/cases/{casesId}:escalate", // "httpMethod": "POST", // "id": "cloudsupport.cases.escalate", @@ -2224,11 +2223,10 @@ func (r *CasesService) List(parent string) *CasesListCall { // and `AND`: - `state`: The accepted values are `OPEN` or `CLOSED`. - // `priority`: The accepted values are `P0`, `P1`, `P2`, `P3`, or `P4`. // You can specify multiple values for priority using the `OR` operator. -// For example, `priority=P1 OR priority=P2`. - [DEPRECATED] `severity`: -// The accepted values are `S0`, `S1`, `S2`, `S3`, or `S4`. - -// `creator.email`: The email address of the case creator. Examples: - -// `state=CLOSED` - `state=OPEN AND creator.email="tester@example.com" -// - `state=OPEN AND (priority=P0 OR priority=P1)` +// For example, `priority=P1 OR priority=P2`. - `creator.email`: The +// email address of the case creator. Examples: - `state=CLOSED` - +// `state=OPEN AND creator.email="tester@example.com" - `state=OPEN AND +// (priority=P0 OR priority=P1)` func (c *CasesListCall) Filter(filter string) *CasesListCall { c.urlParams_.Set("filter", filter) return c @@ -2357,7 +2355,7 @@ func (c *CasesListCall) Do(opts ...googleapi.CallOption) (*ListCasesResponse, er // ], // "parameters": { // "filter": { - // "description": "An expression written in filter language. If non-empty, the query returns the cases that match the filter. Else, the query doesn't filter the cases. Filter expressions use the following fields with the operators equals (`=`) and `AND`: - `state`: The accepted values are `OPEN` or `CLOSED`. - `priority`: The accepted values are `P0`, `P1`, `P2`, `P3`, or `P4`. You can specify multiple values for priority using the `OR` operator. For example, `priority=P1 OR priority=P2`. - [DEPRECATED] `severity`: The accepted values are `S0`, `S1`, `S2`, `S3`, or `S4`. - `creator.email`: The email address of the case creator. Examples: - `state=CLOSED` - `state=OPEN AND creator.email=\"tester@example.com\"` - `state=OPEN AND (priority=P0 OR priority=P1)`", + // "description": "An expression written in filter language. If non-empty, the query returns the cases that match the filter. Else, the query doesn't filter the cases. Filter expressions use the following fields with the operators equals (`=`) and `AND`: - `state`: The accepted values are `OPEN` or `CLOSED`. - `priority`: The accepted values are `P0`, `P1`, `P2`, `P3`, or `P4`. You can specify multiple values for priority using the `OR` operator. For example, `priority=P1 OR priority=P2`. - `creator.email`: The email address of the case creator. Examples: - `state=CLOSED` - `state=OPEN AND creator.email=\"tester@example.com\"` - `state=OPEN AND (priority=P0 OR priority=P1)`", // "location": "query", // "type": "string" // }, @@ -2436,12 +2434,12 @@ func (r *CasesService) Patch(name string, case_ *Case) *CasesPatchCall { // UpdateMask sets the optional parameter "updateMask": A list of // attributes of the case object that should be updated as part of this -// request. Supported values are severity, display_name, and -// subscriber_email_addresses. If no fields are specified, all supported -// fields are updated. WARNING: If you do not provide a field mask, then -// you may accidentally clear some fields. For example, if you leave -// field mask empty and do not provide a value for -// subscriber_email_addresses, then subscriber_email_addresses is +// request. Supported values are `priority`, `display_name`, and +// `subscriber_email_addresses`. If no fields are specified, all +// supported fields are updated. WARNING: If you do not provide a field +// mask, then you might accidentally clear some fields. For example, if +// you leave the field mask empty and do not provide a value for +// `subscriber_email_addresses`, then `subscriber_email_addresses` is // updated to empty. func (c *CasesPatchCall) UpdateMask(updateMask string) *CasesPatchCall { c.urlParams_.Set("updateMask", updateMask) @@ -2555,7 +2553,7 @@ func (c *CasesPatchCall) Do(opts ...googleapi.CallOption) (*Case, error) { // "type": "string" // }, // "updateMask": { - // "description": "A list of attributes of the case object that should be updated as part of this request. Supported values are severity, display_name, and subscriber_email_addresses. If no fields are specified, all supported fields are updated. WARNING: If you do not provide a field mask, then you may accidentally clear some fields. For example, if you leave field mask empty and do not provide a value for subscriber_email_addresses, then subscriber_email_addresses is updated to empty.", + // "description": "A list of attributes of the case object that should be updated as part of this request. Supported values are `priority`, `display_name`, and `subscriber_email_addresses`. If no fields are specified, all supported fields are updated. WARNING: If you do not provide a field mask, then you might accidentally clear some fields. For example, if you leave the field mask empty and do not provide a value for `subscriber_email_addresses`, then `subscriber_email_addresses` is updated to empty.", // "format": "google-fieldmask", // "location": "query", // "type": "string" @@ -2613,16 +2611,15 @@ func (c *CasesSearchCall) PageToken(pageToken string) *CasesSearchCall { // `projects/`. - `state`: The accepted values are `OPEN` or `CLOSED`. - // `priority`: The accepted values are `P0`, `P1`, `P2`, `P3`, or `P4`. // You can specify multiple values for priority using the `OR` operator. -// For example, `priority=P1 OR priority=P2`. - [DEPRECATED] `severity`: -// The accepted values are `S0`, `S1`, `S2`, `S3`, or `S4`. - -// `creator.email`: The email address of the case creator. - -// `billingAccount`: A billing account in the form `billingAccounts/` -// You must specify eitehr `organization` or `project`. To search across -// `displayName`, `description`, and comments, use a global restriction -// with no keyword or operator. For example, "my search". To search -// only cases updated after a certain date, use `update_time` retricted -// with that particular date, time, and timezone in ISO datetime format. -// For example, `update_time>"2020-01-01T00:00:00-05:00". `update_time` +// For example, `priority=P1 OR priority=P2`. - `creator.email`: The +// email address of the case creator. - `billingAccount`: A billing +// account in the form `billingAccounts/` You must specify either +// `organization` or `project`. To search across `displayName`, +// `description`, and comments, use a global restriction with no keyword +// or operator. For example, "my search". To search only cases updated +// after a certain date, use `update_time` restricted with that +// particular date, time, and timezone in ISO datetime format. For +// example, `update_time>"2020-01-01T00:00:00-05:00". `update_time` // only supports the greater than operator (`>`). Examples: - // `organization="organizations/123456789" - // `project="projects/my-project-id" - `project="projects/123456789" - @@ -2750,7 +2747,7 @@ func (c *CasesSearchCall) Do(opts ...googleapi.CallOption) (*SearchCasesResponse // "type": "string" // }, // "query": { - // "description": "An expression written in filter language. A query uses the following fields with the operators equals (`=`) and `AND`: - `organization`: An organization name in the form `organizations/`. - `project`: A project name in the form `projects/`. - `state`: The accepted values are `OPEN` or `CLOSED`. - `priority`: The accepted values are `P0`, `P1`, `P2`, `P3`, or `P4`. You can specify multiple values for priority using the `OR` operator. For example, `priority=P1 OR priority=P2`. - [DEPRECATED] `severity`: The accepted values are `S0`, `S1`, `S2`, `S3`, or `S4`. - `creator.email`: The email address of the case creator. - `billingAccount`: A billing account in the form `billingAccounts/` You must specify eitehr `organization` or `project`. To search across `displayName`, `description`, and comments, use a global restriction with no keyword or operator. For example, `\"my search\"`. To search only cases updated after a certain date, use `update_time` retricted with that particular date, time, and timezone in ISO datetime format. For example, `update_time\u003e\"2020-01-01T00:00:00-05:00\"`. `update_time` only supports the greater than operator (`\u003e`). Examples: - `organization=\"organizations/123456789\"` - `project=\"projects/my-project-id\"` - `project=\"projects/123456789\"` - `billing_account=\"billingAccounts/123456-A0B0C0-CUZ789\"` - `organization=\"organizations/123456789\" AND state=CLOSED` - `project=\"projects/my-project-id\" AND creator.email=\"tester@example.com\"` - `project=\"projects/my-project-id\" AND (priority=P0 OR priority=P1)`", + // "description": "An expression written in filter language. A query uses the following fields with the operators equals (`=`) and `AND`: - `organization`: An organization name in the form `organizations/`. - `project`: A project name in the form `projects/`. - `state`: The accepted values are `OPEN` or `CLOSED`. - `priority`: The accepted values are `P0`, `P1`, `P2`, `P3`, or `P4`. You can specify multiple values for priority using the `OR` operator. For example, `priority=P1 OR priority=P2`. - `creator.email`: The email address of the case creator. - `billingAccount`: A billing account in the form `billingAccounts/` You must specify either `organization` or `project`. To search across `displayName`, `description`, and comments, use a global restriction with no keyword or operator. For example, `\"my search\"`. To search only cases updated after a certain date, use `update_time` restricted with that particular date, time, and timezone in ISO datetime format. For example, `update_time\u003e\"2020-01-01T00:00:00-05:00\"`. `update_time` only supports the greater than operator (`\u003e`). Examples: - `organization=\"organizations/123456789\"` - `project=\"projects/my-project-id\"` - `project=\"projects/123456789\"` - `billing_account=\"billingAccounts/123456-A0B0C0-CUZ789\"` - `organization=\"organizations/123456789\" AND state=CLOSED` - `project=\"projects/my-project-id\" AND creator.email=\"tester@example.com\"` - `project=\"projects/my-project-id\" AND (priority=P0 OR priority=P1)`", // "location": "query", // "type": "string" // } diff --git a/cloudtasks/v2beta3/cloudtasks-api.json b/cloudtasks/v2beta3/cloudtasks-api.json index 54f7d27796c..561f16ea241 100644 --- a/cloudtasks/v2beta3/cloudtasks-api.json +++ b/cloudtasks/v2beta3/cloudtasks-api.json @@ -732,7 +732,7 @@ } } }, - "revision": "20230224", + "revision": "20230417", "rootUrl": "https://cloudtasks.googleapis.com/", "schemas": { "AppEngineHttpQueue": { @@ -869,7 +869,7 @@ "type": "object" }, "BufferTaskRequest": { - "description": "LINT.IfChange Request message for BufferTask.", + "description": "Request message for BufferTask.", "id": "BufferTaskRequest", "properties": { "body": { @@ -1110,6 +1110,14 @@ ], "type": "string" }, + "oauthToken": { + "$ref": "OAuthToken", + "description": "If specified, an [OAuth token](https://developers.google.com/identity/protocols/OAuth2) will be generated and attached as the `Authorization` header in the HTTP request. This type of authorization should generally only be used when calling Google APIs hosted on *.googleapis.com." + }, + "oidcToken": { + "$ref": "OidcToken", + "description": "If specified, an [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect) token will be generated and attached as an `Authorization` header in the HTTP request. This type of authorization can be used for many scenarios, including calling Cloud Run, or endpoints where you intend to validate the token yourself." + }, "uriOverride": { "$ref": "UriOverride", "description": "URI override. When specified, overrides the execution URI for all the tasks in the queue." diff --git a/cloudtasks/v2beta3/cloudtasks-gen.go b/cloudtasks/v2beta3/cloudtasks-gen.go index 9a44e37aca6..c6d02b34f33 100644 --- a/cloudtasks/v2beta3/cloudtasks-gen.go +++ b/cloudtasks/v2beta3/cloudtasks-gen.go @@ -552,7 +552,7 @@ func (s *Binding) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// BufferTaskRequest: LINT.IfChange Request message for BufferTask. +// BufferTaskRequest: Request message for BufferTask. type BufferTaskRequest struct { // Body: Optional. Body of the HTTP request. The body can take any // generic value. The value is written to the HttpRequest of the [Task]. @@ -1085,6 +1085,21 @@ type HttpTarget struct { // "OPTIONS" - HTTP OPTIONS HttpMethod string `json:"httpMethod,omitempty"` + // OauthToken: If specified, an OAuth token + // (https://developers.google.com/identity/protocols/OAuth2) will be + // generated and attached as the `Authorization` header in the HTTP + // request. This type of authorization should generally only be used + // when calling Google APIs hosted on *.googleapis.com. + OauthToken *OAuthToken `json:"oauthToken,omitempty"` + + // OidcToken: If specified, an OIDC + // (https://developers.google.com/identity/protocols/OpenIDConnect) + // token will be generated and attached as an `Authorization` header in + // the HTTP request. This type of authorization can be used for many + // scenarios, including calling Cloud Run, or endpoints where you intend + // to validate the token yourself. + OidcToken *OidcToken `json:"oidcToken,omitempty"` + // UriOverride: URI override. When specified, overrides the execution // URI for all the tasks in the queue. UriOverride *UriOverride `json:"uriOverride,omitempty"` diff --git a/compute/v0.alpha/compute-api.json b/compute/v0.alpha/compute-api.json index 3180fa70c70..f4fa362c41d 100644 --- a/compute/v0.alpha/compute-api.json +++ b/compute/v0.alpha/compute-api.json @@ -9429,6 +9429,7 @@ ] }, "setAutoHealingPolicies": { + "deprecated": true, "description": "Motifies the autohealing policy for the instances in this managed instance group. [Deprecated] This method is deprecated. Use instanceGroupManagers.patch instead.", "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setAutoHealingPolicies", "httpMethod": "POST", @@ -25828,6 +25829,7 @@ ] }, "setAutoHealingPolicies": { + "deprecated": true, "description": "Modifies the autohealing policy for the instances in this managed instance group. [Deprecated] This method is deprecated. Use regionInstanceGroupManagers.patch instead.", "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/setAutoHealingPolicies", "httpMethod": "POST", @@ -41378,7 +41380,7 @@ } } }, - "revision": "20230403", + "revision": "20230425", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -42970,6 +42972,10 @@ "sourceSnapshotEncryptionKey": { "$ref": "CustomerEncryptionKey", "description": "The customer-supplied encryption key of the source snapshot." + }, + "storagePool": { + "description": "The storage pool in which the new disk is created. 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/zones/zone /storagePools/storagePool - projects/project/zones/zone/storagePools/storagePool - zones/zone/storagePools/storagePool ", + "type": "string" } }, "type": "object" @@ -45593,7 +45599,7 @@ "id": "BulkInsertInstanceResourcePerInstanceProperties", "properties": { "hostname": { - "description": "Specifies the hostname of the instance. More details in: https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention hostname must be uniqe in per_instance_properties map.", + "description": "Specifies the hostname of the instance. More details in: https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention", "type": "string" }, "name": { @@ -45945,7 +45951,7 @@ "type": "string" }, "splitSourceCommitment": { - "description": "Source commitment to be splitted into a new commitment.", + "description": "Source commitment to be split into a new commitment.", "type": "string" }, "startTimestamp": { @@ -45981,6 +45987,7 @@ "COMPUTE_OPTIMIZED", "COMPUTE_OPTIMIZED_C2D", "COMPUTE_OPTIMIZED_C3", + "COMPUTE_OPTIMIZED_C3D", "GENERAL_PURPOSE", "GENERAL_PURPOSE_E2", "GENERAL_PURPOSE_N2", @@ -46004,6 +46011,7 @@ "", "", "", + "", "" ], "type": "string" @@ -46449,12 +46457,14 @@ "enum": [ "CONFIDENTIAL_INSTANCE_TYPE_UNSPECIFIED", "SEV", - "SEV_SNP" + "SEV_SNP", + "TDX" ], "enumDescriptions": [ "No type specified. Do not use this value.", "AMD Secure Encrypted Virtualization.", - "AMD Secure Encrypted Virtualization - Secure Nested Paging." + "AMD Secure Encrypted Virtualization - Secure Nested Paging.", + "Intel Trust Domain eXtension." ], "type": "string" }, @@ -46964,6 +46974,10 @@ ], "type": "string" }, + "storagePool": { + "description": "The storage pool in which the new disk is created. 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/zones/zone /storagePools/storagePool - projects/project/zones/zone/storagePools/storagePool - zones/zone/storagePools/storagePool ", + "type": "string" + }, "storageType": { "description": "[Deprecated] Storage type of the persistent disk.", "enum": [ @@ -50688,6 +50702,7 @@ "SEV_CAPABLE", "SEV_LIVE_MIGRATABLE", "SEV_SNP_CAPABLE", + "TDX_CAPABLE", "UEFI_COMPATIBLE", "VIRTIO_SCSI_MULTIQUEUE", "WINDOWS" @@ -50703,6 +50718,7 @@ "", "", "", + "", "" ], "type": "string" @@ -50912,7 +50928,7 @@ "type": "object" }, "HealthCheck": { - "description": "Represents a Health Check resource. Google Compute Engine has two Health Check resources: * [Global](/compute/docs/reference/rest/alpha/healthChecks) * [Regional](/compute/docs/reference/rest/alpha/regionHealthChecks) Internal HTTP(S) load balancers must use regional health checks (`compute.v1.regionHealthChecks`). Traffic Director must use global health checks (`compute.v1.HealthChecks`). Internal TCP/UDP load balancers can use either regional or global health checks (`compute.v1.regionHealthChecks` or `compute.v1.HealthChecks`). External HTTP(S), TCP proxy, and SSL proxy load balancers as well as managed instance group auto-healing must use global health checks (`compute.v1.HealthChecks`). Backend service-based network load balancers must use regional health checks (`compute.v1.regionHealthChecks`). Target pool-based network load balancers must use legacy HTTP health checks (`compute.v1.httpHealthChecks`). For more information, see Health checks overview.", + "description": "Represents a Health Check resource. Google Compute Engine has two Health Check resources: * [Global](/compute/docs/reference/rest/alpha/healthChecks) * [Regional](/compute/docs/reference/rest/alpha/regionHealthChecks) Internal HTTP(S) load balancers must use regional health checks (`compute.v1.regionHealthChecks`). Traffic Director must use global health checks (`compute.v1.healthChecks`). Internal TCP/UDP load balancers can use either regional or global health checks (`compute.v1.regionHealthChecks` or `compute.v1.healthChecks`). External HTTP(S), TCP proxy, and SSL proxy load balancers as well as managed instance group auto-healing must use global health checks (`compute.v1.healthChecks`). Backend service-based network load balancers must use regional health checks (`compute.v1.regionHealthChecks`). Target pool-based network load balancers must use legacy HTTP health checks (`compute.v1.httpHealthChecks`). For more information, see Health checks overview.", "id": "HealthCheck", "properties": { "checkIntervalSec": { @@ -54052,6 +54068,10 @@ "format": "uint64", "type": "string" }, + "instanceFlexibilityPolicy": { + "$ref": "InstanceGroupManagerInstanceFlexibilityPolicy", + "description": "Instance flexibility allowing MIG to create VMs from multiple types of machines. Instance flexibility configuration on MIG overrides instance template configuration." + }, "instanceGroup": { "description": "[Output Only] The URL of the Instance Group resource.", "type": "string" @@ -54145,6 +54165,18 @@ "format": "int32", "type": "integer" }, + "targetSizeUnit": { + "description": "The unit of measure for the target size.", + "enum": [ + "VCPU", + "VM" + ], + "enumDescriptions": [ + "TargetSize is the target count of vCPUs of VMs.", + "[Default] TargetSize is the target number of VMs." + ], + "type": "string" + }, "targetStoppedSize": { "description": "The target number of stopped instances for this managed instance group. This number changes when you: - Stop instance using the stopInstances method or start instances using the startInstances method. - Manually change the targetStoppedSize using the update method. ", "format": "int32", @@ -54432,6 +54464,37 @@ }, "type": "object" }, + "InstanceGroupManagerInstanceFlexibilityPolicy": { + "id": "InstanceGroupManagerInstanceFlexibilityPolicy", + "properties": { + "instanceSelectionLists": { + "additionalProperties": { + "$ref": "InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection" + }, + "description": "List of instance selection options that the group will use when creating new VMs.", + "type": "object" + } + }, + "type": "object" + }, + "InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection": { + "id": "InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection", + "properties": { + "machineTypes": { + "description": "Full machine-type names, e.g. \"n1-standard-16\".", + "items": { + "type": "string" + }, + "type": "array" + }, + "rank": { + "description": "Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "InstanceGroupManagerInstanceLifecyclePolicy": { "id": "InstanceGroupManagerInstanceLifecyclePolicy", "properties": { @@ -61885,7 +61948,7 @@ "type": "string" }, "network": { - "description": "[Output Only] The URL of the network which the Network Attachment belongs to.", + "description": "[Output Only] The URL of the network which the Network Attachment belongs to. Practically it is inferred by fetching the network of the first subnetwork associated. Because it is required that all the subnetworks must be from the same network, it is assured that the Network Attachment belongs to the same network as all the subnetworks.", "type": "string" }, "producerAcceptLists": { @@ -77279,6 +77342,10 @@ "$ref": "CustomerEncryptionKey", "description": "The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key." }, + "sourceDiskForRecoveryCheckpoint": { + "description": "The source disk whose recovery checkpoint will be used to create this snapshot.", + "type": "string" + }, "sourceDiskId": { "description": "[Output Only] The ID value of the disk used to create this snapshot. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given disk name.", "type": "string" @@ -79157,12 +79224,12 @@ "type": "string" }, "usedBytes": { - "description": "[Output Only] Sum of all the disks' local used bytes. This specifically refers to the amount of bytes used on the disk without any encryption or compression.", + "description": "[Output Only] Space used by data stored in disks within the storage pool (in bytes).", "format": "int64", "type": "string" }, "usedReducedBytes": { - "description": "[Output Only] Sum of all the disks' used reduced bytes. This is the actual storage capacity consumed by all of the disks.", + "description": "[Output Only] Space used by compressed and deduped data stored in disks within the storage pool (in bytes).", "format": "int64", "type": "string" } @@ -80747,7 +80814,7 @@ "id": "TargetHttpsProxiesSetCertificateMapRequest", "properties": { "certificateMap": { - "description": "URL of the Certificate Map to associate with this TargetHttpsProxy.", + "description": "URL of the Certificate Map to associate with this TargetHttpsProxy. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}.", "type": "string" } }, @@ -80803,7 +80870,7 @@ "type": "string" }, "certificateMap": { - "description": "URL of a certificate map that identifies a certificate map associated with the given target proxy. This field can only be set for global target proxies. If set, sslCertificates will be ignored.", + "description": "URL of a certificate map that identifies a certificate map associated with the given target proxy. This field can only be set for global target proxies. If set, sslCertificates will be ignored. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}.", "type": "string" }, "creationTimestamp": { @@ -82092,7 +82159,7 @@ "id": "TargetSslProxiesSetCertificateMapRequest", "properties": { "certificateMap": { - "description": "URL of the Certificate Map to associate with this TargetSslProxy.", + "description": "URL of the Certificate Map to associate with this TargetSslProxy. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}.", "type": "string" } }, @@ -82134,7 +82201,7 @@ "id": "TargetSslProxy", "properties": { "certificateMap": { - "description": "URL of a certificate map that identifies a certificate map associated with the given target proxy. This field can only be set for global target proxies. If set, sslCertificates will be ignored.", + "description": "URL of a certificate map that identifies a certificate map associated with the given target proxy. This field can only be set for global target proxies. If set, sslCertificates will be ignored. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}.", "type": "string" }, "creationTimestamp": { @@ -84593,11 +84660,13 @@ "description": "The stack type for this VPN gateway to identify the IP protocols that are enabled. Possible values are: IPV4_ONLY, IPV4_IPV6. If not specified, IPV4_ONLY will be used.", "enum": [ "IPV4_IPV6", - "IPV4_ONLY" + "IPV4_ONLY", + "IPV6_ONLY" ], "enumDescriptions": [ "Enable VPN gateway with both IPv4 and IPv6 protocols.", - "Enable VPN gateway with only IPv4 protocol." + "Enable VPN gateway with only IPv4 protocol.", + "Enable VPN gateway with only IPv6 protocol." ], "type": "string" }, @@ -84910,7 +84979,7 @@ "type": "integer" }, "peerGatewayInterface": { - "description": "The peer gateway interface this VPN tunnel is connected to, the peer gateway could either be an external VPN gateway or GCP VPN gateway.", + "description": "The peer gateway interface this VPN tunnel is connected to, the peer gateway could either be an external VPN gateway or a Google Cloud VPN gateway.", "format": "uint32", "type": "integer" }, @@ -84922,7 +84991,7 @@ "type": "object" }, "VpnGatewayStatusVpnConnection": { - "description": "A VPN connection contains all VPN tunnels connected from this VpnGateway to the same peer gateway. The peer gateway could either be a external VPN gateway or GCP VPN gateway.", + "description": "A VPN connection contains all VPN tunnels connected from this VpnGateway to the same peer gateway. The peer gateway could either be an external VPN gateway or a Google Cloud VPN gateway.", "id": "VpnGatewayStatusVpnConnection", "properties": { "peerExternalGateway": { diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index 8fcef006183..9839aadcdcf 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -3734,6 +3734,15 @@ type AttachedDiskInitializeParams struct { // the source snapshot. SourceSnapshotEncryptionKey *CustomerEncryptionKey `json:"sourceSnapshotEncryptionKey,omitempty"` + // StoragePool: The storage pool in which the new disk is created. 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/zones/zone + // /storagePools/storagePool - + // projects/project/zones/zone/storagePools/storagePool - + // zones/zone/storagePools/storagePool + StoragePool string `json:"storagePool,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. However, any @@ -8171,7 +8180,6 @@ func (s *BulkInsertInstanceResource) MarshalJSON() ([]byte, error) { type BulkInsertInstanceResourcePerInstanceProperties struct { // Hostname: Specifies the hostname of the instance. More details in: // https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention - // hostname must be uniqe in per_instance_properties map. Hostname string `json:"hostname,omitempty"` // Name: This field is only temporary. It will be removed. Do not use @@ -8673,7 +8681,7 @@ type Commitment struct { // with the resource id. SelfLinkWithId string `json:"selfLinkWithId,omitempty"` - // SplitSourceCommitment: Source commitment to be splitted into a new + // SplitSourceCommitment: Source commitment to be split into a new // commitment. SplitSourceCommitment string `json:"splitSourceCommitment,omitempty"` @@ -8709,6 +8717,7 @@ type Commitment struct { // "COMPUTE_OPTIMIZED" // "COMPUTE_OPTIMIZED_C2D" // "COMPUTE_OPTIMIZED_C3" + // "COMPUTE_OPTIMIZED_C3D" // "GENERAL_PURPOSE" // "GENERAL_PURPOSE_E2" // "GENERAL_PURPOSE_N2" @@ -9376,6 +9385,7 @@ type ConfidentialInstanceConfig struct { // "SEV" - AMD Secure Encrypted Virtualization. // "SEV_SNP" - AMD Secure Encrypted Virtualization - Secure Nested // Paging. + // "TDX" - Intel Trust Domain eXtension. ConfidentialInstanceType string `json:"confidentialInstanceType,omitempty"` // EnableConfidentialCompute: Defines whether the instance should have @@ -10198,6 +10208,15 @@ type Disk struct { // "RESTORING" - Source data is being copied into the disk. Status string `json:"status,omitempty"` + // StoragePool: The storage pool in which the new disk is created. 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/zones/zone + // /storagePools/storagePool - + // projects/project/zones/zone/storagePools/storagePool - + // zones/zone/storagePools/storagePool + StoragePool string `json:"storagePool,omitempty"` + // StorageType: [Deprecated] Storage type of the persistent disk. // // Possible values: @@ -16322,6 +16341,7 @@ type GuestOsFeature struct { // "SEV_CAPABLE" // "SEV_LIVE_MIGRATABLE" // "SEV_SNP_CAPABLE" + // "TDX_CAPABLE" // "UEFI_COMPATIBLE" // "VIRTIO_SCSI_MULTIQUEUE" // "WINDOWS" @@ -16686,12 +16706,12 @@ func (s *HTTPSHealthCheck) MarshalJSON() ([]byte, error) { // (/compute/docs/reference/rest/alpha/regionHealthChecks) Internal // HTTP(S) load balancers must use regional health checks // (`compute.v1.regionHealthChecks`). Traffic Director must use global -// health checks (`compute.v1.HealthChecks`). Internal TCP/UDP load +// health checks (`compute.v1.healthChecks`). Internal TCP/UDP load // balancers can use either regional or global health checks -// (`compute.v1.regionHealthChecks` or `compute.v1.HealthChecks`). +// (`compute.v1.regionHealthChecks` or `compute.v1.healthChecks`). // External HTTP(S), TCP proxy, and SSL proxy load balancers as well as // managed instance group auto-healing must use global health checks -// (`compute.v1.HealthChecks`). Backend service-based network load +// (`compute.v1.healthChecks`). Backend service-based network load // balancers must use regional health checks // (`compute.v1.regionHealthChecks`). Target pool-based network load // balancers must use legacy HTTP health checks @@ -21567,6 +21587,11 @@ type InstanceGroupManager struct { // server generates this identifier. Id uint64 `json:"id,omitempty,string"` + // InstanceFlexibilityPolicy: Instance flexibility allowing MIG to + // create VMs from multiple types of machines. Instance flexibility + // configuration on MIG overrides instance template configuration. + InstanceFlexibilityPolicy *InstanceGroupManagerInstanceFlexibilityPolicy `json:"instanceFlexibilityPolicy,omitempty"` + // InstanceGroup: [Output Only] The URL of the Instance Group resource. InstanceGroup string `json:"instanceGroup,omitempty"` @@ -21647,6 +21672,13 @@ type InstanceGroupManager struct { // Resizing the group also changes this number. TargetSize int64 `json:"targetSize,omitempty"` + // TargetSizeUnit: The unit of measure for the target size. + // + // Possible values: + // "VCPU" - TargetSize is the target count of vCPUs of VMs. + // "VM" - [Default] TargetSize is the target number of VMs. + TargetSizeUnit string `json:"targetSizeUnit,omitempty"` + // TargetStoppedSize: The target number of stopped instances for this // managed instance group. This number changes when you: - Stop instance // using the stopInstances method or start instances using the @@ -22137,6 +22169,70 @@ func (s *InstanceGroupManagerAutoHealingPolicyAutoHealingTriggers) MarshalJSON() return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type InstanceGroupManagerInstanceFlexibilityPolicy struct { + // InstanceSelectionLists: List of instance selection options that the + // group will use when creating new VMs. + InstanceSelectionLists map[string]InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection `json:"instanceSelectionLists,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "InstanceSelectionLists") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "InstanceSelectionLists") + // to include in API requests with the JSON null value. By default, + // fields with empty values are omitted from API requests. However, any + // field with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *InstanceGroupManagerInstanceFlexibilityPolicy) MarshalJSON() ([]byte, error) { + type NoMethod InstanceGroupManagerInstanceFlexibilityPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +type InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection struct { + // MachineTypes: Full machine-type names, e.g. "n1-standard-16". + MachineTypes []string `json:"machineTypes,omitempty"` + + // Rank: Preference of this instance selection. Lower number means + // higher preference. MIG will first try to create a VM based on the + // machine-type with lowest rank and fallback to next rank based on + // availability. Machine types and instance selections with the same + // rank have the same preference. + Rank int64 `json:"rank,omitempty"` + + // ForceSendFields is a list of field names (e.g. "MachineTypes") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "MachineTypes") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection) MarshalJSON() ([]byte, error) { + type NoMethod InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + type InstanceGroupManagerInstanceLifecyclePolicy struct { // DefaultActionOnFailure: Defines behaviour for all instance or // failures @@ -34087,7 +34183,11 @@ type NetworkAttachment struct { Name string `json:"name,omitempty"` // Network: [Output Only] The URL of the network which the Network - // Attachment belongs to. + // Attachment belongs to. Practically it is inferred by fetching the + // network of the first subnetwork associated. Because it is required + // that all the subnetworks must be from the same network, it is assured + // that the Network Attachment belongs to the same network as all the + // subnetworks. Network string `json:"network,omitempty"` // ProducerAcceptLists: Projects that are allowed to connect to this @@ -57792,6 +57892,10 @@ type Snapshot struct { // customer-supplied encryption key. SourceDiskEncryptionKey *CustomerEncryptionKey `json:"sourceDiskEncryptionKey,omitempty"` + // SourceDiskForRecoveryCheckpoint: The source disk whose recovery + // checkpoint will be used to create this snapshot. + SourceDiskForRecoveryCheckpoint string `json:"sourceDiskForRecoveryCheckpoint,omitempty"` + // SourceDiskId: [Output Only] The ID value of the disk used to create // this snapshot. This value may be used to determine whether the // snapshot was taken from the current or a previous instance of a given @@ -60592,14 +60696,12 @@ type StoragePoolResourceStatus struct { // NumberOfDisks: [Output Only] Number of disks used. NumberOfDisks int64 `json:"numberOfDisks,omitempty,string"` - // UsedBytes: [Output Only] Sum of all the disks' local used bytes. This - // specifically refers to the amount of bytes used on the disk without - // any encryption or compression. + // UsedBytes: [Output Only] Space used by data stored in disks within + // the storage pool (in bytes). UsedBytes int64 `json:"usedBytes,omitempty,string"` - // UsedReducedBytes: [Output Only] Sum of all the disks' used reduced - // bytes. This is the actual storage capacity consumed by all of the - // disks. + // UsedReducedBytes: [Output Only] Space used by compressed and deduped + // data stored in disks within the storage pool (in bytes). UsedReducedBytes int64 `json:"usedReducedBytes,omitempty,string"` // ForceSendFields is a list of field names (e.g. @@ -63154,7 +63256,9 @@ func (s *TargetHttpsProxiesScopedListWarningData) MarshalJSON() ([]byte, error) type TargetHttpsProxiesSetCertificateMapRequest struct { // CertificateMap: URL of the Certificate Map to associate with this - // TargetHttpsProxy. + // TargetHttpsProxy. Accepted format is + // //certificatemanager.googleapis.com/projects/{project + // }/locations/{location}/certificateMaps/{resourceName}. CertificateMap string `json:"certificateMap,omitempty"` // ForceSendFields is a list of field names (e.g. "CertificateMap") to @@ -63277,7 +63381,9 @@ type TargetHttpsProxy struct { // CertificateMap: URL of a certificate map that identifies a // certificate map associated with the given target proxy. This field // can only be set for global target proxies. If set, sslCertificates - // will be ignored. + // will be ignored. Accepted format is + // //certificatemanager.googleapis.com/projects/{project + // }/locations/{location}/certificateMaps/{resourceName}. CertificateMap string `json:"certificateMap,omitempty"` // CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text @@ -65389,7 +65495,9 @@ func (s *TargetSslProxiesSetBackendServiceRequest) MarshalJSON() ([]byte, error) type TargetSslProxiesSetCertificateMapRequest struct { // CertificateMap: URL of the Certificate Map to associate with this - // TargetSslProxy. + // TargetSslProxy. Accepted format is + // //certificatemanager.googleapis.com/projects/{project + // }/locations/{location}/certificateMaps/{resourceName}. CertificateMap string `json:"certificateMap,omitempty"` // ForceSendFields is a list of field names (e.g. "CertificateMap") to @@ -65487,7 +65595,9 @@ type TargetSslProxy struct { // CertificateMap: URL of a certificate map that identifies a // certificate map associated with the given target proxy. This field // can only be set for global target proxies. If set, sslCertificates - // will be ignored. + // will be ignored. Accepted format is + // //certificatemanager.googleapis.com/projects/{project + // }/locations/{location}/certificateMaps/{resourceName}. CertificateMap string `json:"certificateMap,omitempty"` // CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text @@ -69392,6 +69502,7 @@ type VpnGateway struct { // Possible values: // "IPV4_IPV6" - Enable VPN gateway with both IPv4 and IPv6 protocols. // "IPV4_ONLY" - Enable VPN gateway with only IPv4 protocol. + // "IPV6_ONLY" - Enable VPN gateway with only IPv6 protocol. StackType string `json:"stackType,omitempty"` // VpnInterfaces: The list of VPN interfaces associated with this VPN @@ -69895,7 +70006,7 @@ type VpnGatewayStatusTunnel struct { // PeerGatewayInterface: The peer gateway interface this VPN tunnel is // connected to, the peer gateway could either be an external VPN - // gateway or GCP VPN gateway. + // gateway or a Google Cloud VPN gateway. PeerGatewayInterface int64 `json:"peerGatewayInterface,omitempty"` // TunnelUrl: URL reference to the VPN tunnel. @@ -69928,8 +70039,8 @@ func (s *VpnGatewayStatusTunnel) MarshalJSON() ([]byte, error) { // VpnGatewayStatusVpnConnection: A VPN connection contains all VPN // tunnels connected from this VpnGateway to the same peer gateway. The -// peer gateway could either be a external VPN gateway or GCP VPN -// gateway. +// peer gateway could either be an external VPN gateway or a Google +// Cloud VPN gateway. type VpnGatewayStatusVpnConnection struct { // PeerExternalGateway: URL reference to the peer external VPN gateways // to which the VPN tunnels in this VPN connection are connected. This @@ -112167,6 +112278,7 @@ func (c *InstanceGroupManagersSetAutoHealingPoliciesCall) Do(opts ...googleapi.C } return ret, nil // { + // "deprecated": true, // "description": "Motifies the autohealing policy for the instances in this managed instance group. [Deprecated] This method is deprecated. Use instanceGroupManagers.patch instead.", // "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setAutoHealingPolicies", // "httpMethod": "POST", @@ -180164,6 +180276,7 @@ func (c *RegionInstanceGroupManagersSetAutoHealingPoliciesCall) Do(opts ...googl } return ret, nil // { + // "deprecated": true, // "description": "Modifies the autohealing policy for the instances in this managed instance group. [Deprecated] This method is deprecated. Use regionInstanceGroupManagers.patch instead.", // "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/setAutoHealingPolicies", // "httpMethod": "POST", diff --git a/compute/v0.beta/compute-api.json b/compute/v0.beta/compute-api.json index 11f0889e576..8ac816b682f 100644 --- a/compute/v0.beta/compute-api.json +++ b/compute/v0.beta/compute-api.json @@ -20273,6 +20273,55 @@ "https://www.googleapis.com/auth/compute" ] }, + "setSecurityPolicy": { + "description": "Sets the Google Cloud Armor security policy for the specified backend service. For more information, see Google Cloud Armor Overview", + "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}/setSecurityPolicy", + "httpMethod": "POST", + "id": "compute.regionBackendServices.setSecurityPolicy", + "parameterOrder": [ + "project", + "region", + "backendService" + ], + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to which the security policy should be set. The name 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" + }, + "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 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).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendServices/{backendService}/setSecurityPolicy", + "request": { + "$ref": "SecurityPolicyReference" + }, + "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}/backendServices/{resource}/testIamPermissions", @@ -36951,7 +37000,7 @@ } } }, - "revision": "20230418", + "revision": "20230425", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -40842,6 +40891,10 @@ "description": "Per-instance properties to be set on individual instances. To be extended in the future.", "id": "BulkInsertInstanceResourcePerInstanceProperties", "properties": { + "hostname": { + "description": "Specifies the hostname of the instance. More details in: https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention", + "type": "string" + }, "name": { "description": "This field is only temporary. It will be removed. Do not use it.", "type": "string" @@ -41057,7 +41110,7 @@ "type": "string" }, "splitSourceCommitment": { - "description": "Source commitment to be splitted into a new commitment.", + "description": "Source commitment to be split into a new commitment.", "type": "string" }, "startTimestamp": { @@ -46110,6 +46163,22 @@ "Health status of the endpoint is unknown." ], "type": "string" + }, + "ipv6HealthState": { + "description": "Health state of the ipv6 network endpoint determined based on the health checks configured.", + "enum": [ + "DRAINING", + "HEALTHY", + "UNHEALTHY", + "UNKNOWN" + ], + "enumDescriptions": [ + "Endpoint is being drained.", + "Endpoint is healthy.", + "Endpoint is unhealthy.", + "Health status of the endpoint is unknown." + ], + "type": "string" } }, "type": "object" @@ -53943,7 +54012,7 @@ "type": "string" }, "network": { - "description": "[Output Only] The URL of the network which the Network Attachment belongs to.", + "description": "[Output Only] The URL of the network which the Network Attachment belongs to. Practically it is inferred by fetching the network of the first subnetwork associated. Because it is required that all the subnetworks must be from the same network, it is assured that the Network Attachment belongs to the same network as all the subnetworks.", "type": "string" }, "producerAcceptLists": { @@ -54674,6 +54743,10 @@ "description": "Optional IPv4 address of network endpoint. The IP address must belong to a VM in Compute Engine (either the primary IP or as part of an aliased IP range). If the IP address is not specified, then the primary IP address for the VM instance in the network that the network endpoint group belongs to will be used.", "type": "string" }, + "ipv6Address": { + "description": "Optional IPv6 address of network endpoint.", + "type": "string" + }, "port": { "description": "Optional port number of network endpoint. If not specified, the defaultPort for the network endpoint group will be used.", "format": "int32", @@ -74137,7 +74210,7 @@ "type": "integer" }, "peerGatewayInterface": { - "description": "The peer gateway interface this VPN tunnel is connected to, the peer gateway could either be an external VPN gateway or GCP VPN gateway.", + "description": "The peer gateway interface this VPN tunnel is connected to, the peer gateway could either be an external VPN gateway or a Google Cloud VPN gateway.", "format": "uint32", "type": "integer" }, @@ -74149,7 +74222,7 @@ "type": "object" }, "VpnGatewayStatusVpnConnection": { - "description": "A VPN connection contains all VPN tunnels connected from this VpnGateway to the same peer gateway. The peer gateway could either be a external VPN gateway or GCP VPN gateway.", + "description": "A VPN connection contains all VPN tunnels connected from this VpnGateway to the same peer gateway. The peer gateway could either be an external VPN gateway or a Google Cloud VPN gateway.", "id": "VpnGatewayStatusVpnConnection", "properties": { "peerExternalGateway": { diff --git a/compute/v0.beta/compute-gen.go b/compute/v0.beta/compute-gen.go index 9b8f92436d1..e6241af9b36 100644 --- a/compute/v0.beta/compute-gen.go +++ b/compute/v0.beta/compute-gen.go @@ -7639,11 +7639,15 @@ func (s *BulkInsertInstanceResource) MarshalJSON() ([]byte, error) { // properties to be set on individual instances. To be extended in the // future. type BulkInsertInstanceResourcePerInstanceProperties struct { + // Hostname: Specifies the hostname of the instance. More details in: + // https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention + Hostname string `json:"hostname,omitempty"` + // Name: This field is only temporary. It will be removed. Do not use // it. Name string `json:"name,omitempty"` - // ForceSendFields is a list of field names (e.g. "Name") to + // ForceSendFields is a list of field names (e.g. "Hostname") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -7651,8 +7655,8 @@ type BulkInsertInstanceResourcePerInstanceProperties struct { // This may be used to include empty fields in Patch requests. 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 + // NullFields is a list of field names (e.g. "Hostname") to include in + // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. @@ -7939,7 +7943,7 @@ type Commitment struct { // SelfLink: [Output Only] Server-defined URL for the resource. SelfLink string `json:"selfLink,omitempty"` - // SplitSourceCommitment: Source commitment to be splitted into a new + // SplitSourceCommitment: Source commitment to be split into a new // commitment. SplitSourceCommitment string `json:"splitSourceCommitment,omitempty"` @@ -16083,6 +16087,16 @@ type HealthStatusForNetworkEndpoint struct { // "UNKNOWN" - Health status of the endpoint is unknown. HealthState string `json:"healthState,omitempty"` + // Ipv6HealthState: Health state of the ipv6 network endpoint determined + // based on the health checks configured. + // + // Possible values: + // "DRAINING" - Endpoint is being drained. + // "HEALTHY" - Endpoint is healthy. + // "UNHEALTHY" - Endpoint is unhealthy. + // "UNKNOWN" - Health status of the endpoint is unknown. + Ipv6HealthState string `json:"ipv6HealthState,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. However, any @@ -28603,7 +28617,11 @@ type NetworkAttachment struct { Name string `json:"name,omitempty"` // Network: [Output Only] The URL of the network which the Network - // Attachment belongs to. + // Attachment belongs to. Practically it is inferred by fetching the + // network of the first subnetwork associated. Because it is required + // that all the subnetworks must be from the same network, it is assured + // that the Network Attachment belongs to the same network as all the + // subnetworks. Network string `json:"network,omitempty"` // ProducerAcceptLists: Projects that are allowed to connect to this @@ -29734,6 +29752,9 @@ type NetworkEndpoint struct { // the network endpoint group belongs to will be used. IpAddress string `json:"ipAddress,omitempty"` + // Ipv6Address: Optional IPv6 address of network endpoint. + Ipv6Address string `json:"ipv6Address,omitempty"` + // Port: Optional port number of network endpoint. If not specified, the // defaultPort for the network endpoint group will be used. Port int64 `json:"port,omitempty"` @@ -60204,7 +60225,7 @@ type VpnGatewayStatusTunnel struct { // PeerGatewayInterface: The peer gateway interface this VPN tunnel is // connected to, the peer gateway could either be an external VPN - // gateway or GCP VPN gateway. + // gateway or a Google Cloud VPN gateway. PeerGatewayInterface int64 `json:"peerGatewayInterface,omitempty"` // TunnelUrl: URL reference to the VPN tunnel. @@ -60237,8 +60258,8 @@ func (s *VpnGatewayStatusTunnel) MarshalJSON() ([]byte, error) { // VpnGatewayStatusVpnConnection: A VPN connection contains all VPN // tunnels connected from this VpnGateway to the same peer gateway. The -// peer gateway could either be a external VPN gateway or GCP VPN -// gateway. +// peer gateway could either be an external VPN gateway or a Google +// Cloud VPN gateway. type VpnGatewayStatusVpnConnection struct { // PeerExternalGateway: URL reference to the peer external VPN gateways // to which the VPN tunnels in this VPN connection are connected. This @@ -147718,6 +147739,196 @@ func (c *RegionBackendServicesSetIamPolicyCall) Do(opts ...googleapi.CallOption) } +// method id "compute.regionBackendServices.setSecurityPolicy": + +type RegionBackendServicesSetSecurityPolicyCall struct { + s *Service + project string + region string + backendService string + securitypolicyreference *SecurityPolicyReference + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetSecurityPolicy: Sets the Google Cloud Armor security policy for +// the specified backend service. For more information, see Google Cloud +// Armor Overview +// +// - backendService: Name of the BackendService resource to which the +// security policy should be set. The name should conform to RFC1035. +// - project: Project ID for this request. +// - region: Name of the region scoping this request. +func (r *RegionBackendServicesService) SetSecurityPolicy(project string, region string, backendService string, securitypolicyreference *SecurityPolicyReference) *RegionBackendServicesSetSecurityPolicyCall { + c := &RegionBackendServicesSetSecurityPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.backendService = backendService + c.securitypolicyreference = securitypolicyreference + 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 *RegionBackendServicesSetSecurityPolicyCall) RequestId(requestId string) *RegionBackendServicesSetSecurityPolicyCall { + 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 information. +func (c *RegionBackendServicesSetSecurityPolicyCall) Fields(s ...googleapi.Field) *RegionBackendServicesSetSecurityPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *RegionBackendServicesSetSecurityPolicyCall) Context(ctx context.Context) *RegionBackendServicesSetSecurityPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *RegionBackendServicesSetSecurityPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionBackendServicesSetSecurityPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.securitypolicyreference) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/backendServices/{backendService}/setSecurityPolicy") + 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, + "backendService": c.backendService, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionBackendServices.setSecurityPolicy" call. +// Exactly one of *Operation or error will be non-nil. 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 *RegionBackendServicesSetSecurityPolicyCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Sets the Google Cloud Armor security policy for the specified backend service. For more information, see Google Cloud Armor Overview", + // "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}/setSecurityPolicy", + // "httpMethod": "POST", + // "id": "compute.regionBackendServices.setSecurityPolicy", + // "parameterOrder": [ + // "project", + // "region", + // "backendService" + // ], + // "parameters": { + // "backendService": { + // "description": "Name of the BackendService resource to which the security policy should be set. The name 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" + // }, + // "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 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).", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "projects/{project}/regions/{region}/backendServices/{backendService}/setSecurityPolicy", + // "request": { + // "$ref": "SecurityPolicyReference" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/compute" + // ] + // } + +} + // method id "compute.regionBackendServices.testIamPermissions": type RegionBackendServicesTestIamPermissionsCall struct { diff --git a/compute/v1/compute-api.json b/compute/v1/compute-api.json index 408f9253b96..2f0b6679b19 100644 --- a/compute/v1/compute-api.json +++ b/compute/v1/compute-api.json @@ -33275,7 +33275,7 @@ } } }, - "revision": "20230418", + "revision": "20230425", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -34611,6 +34611,11 @@ "format": "int64", "type": "string" }, + "provisionedThroughput": { + "description": "Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must be between 1 and 7,124.", + "format": "int64", + "type": "string" + }, "replicaZones": { "description": "Required for each regional disk associated with the instance. Specify the URLs of the zones where the disk should be replicated to. You must provide exactly two replica zones, and one zone must be the same as the instance zone. You can't use this option with boot disks.", "items": { @@ -37265,7 +37270,7 @@ "type": "string" }, "splitSourceCommitment": { - "description": "Source commitment to be splitted into a new commitment.", + "description": "Source commitment to be split into a new commitment.", "type": "string" }, "startTimestamp": { @@ -38081,6 +38086,11 @@ "format": "int64", "type": "string" }, + "provisionedThroughput": { + "description": "Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must be between 1 and 7,124.", + "format": "int64", + "type": "string" + }, "region": { "description": "[Output Only] URL of the region where the disk resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", "type": "string" @@ -49735,7 +49745,7 @@ "type": "string" }, "network": { - "description": "[Output Only] The URL of the network which the Network Attachment belongs to.", + "description": "[Output Only] The URL of the network which the Network Attachment belongs to. Practically it is inferred by fetching the network of the first subnetwork associated. Because it is required that all the subnetworks must be from the same network, it is assured that the Network Attachment belongs to the same network as all the subnetworks.", "type": "string" }, "producerAcceptLists": { @@ -69140,7 +69150,7 @@ "type": "integer" }, "peerGatewayInterface": { - "description": "The peer gateway interface this VPN tunnel is connected to, the peer gateway could either be an external VPN gateway or GCP VPN gateway.", + "description": "The peer gateway interface this VPN tunnel is connected to, the peer gateway could either be an external VPN gateway or a Google Cloud VPN gateway.", "format": "uint32", "type": "integer" }, @@ -69152,7 +69162,7 @@ "type": "object" }, "VpnGatewayStatusVpnConnection": { - "description": "A VPN connection contains all VPN tunnels connected from this VpnGateway to the same peer gateway. The peer gateway could either be a external VPN gateway or GCP VPN gateway.", + "description": "A VPN connection contains all VPN tunnels connected from this VpnGateway to the same peer gateway. The peer gateway could either be an external VPN gateway or a Google Cloud VPN gateway.", "id": "VpnGatewayStatusVpnConnection", "properties": { "peerExternalGateway": { diff --git a/compute/v1/compute-gen.go b/compute/v1/compute-gen.go index 125af4f68dc..e7137d8da6b 100644 --- a/compute/v1/compute-gen.go +++ b/compute/v1/compute-gen.go @@ -3283,6 +3283,11 @@ type AttachedDiskInitializeParams struct { // see the Extreme persistent disk documentation. ProvisionedIops int64 `json:"provisionedIops,omitempty,string"` + // ProvisionedThroughput: Indicates how much throughput to provision for + // the disk. This sets the number of throughput mb per second that the + // disk can handle. Values must be between 1 and 7,124. + ProvisionedThroughput int64 `json:"provisionedThroughput,omitempty,string"` + // ReplicaZones: Required for each regional disk associated with the // instance. Specify the URLs of the zones where the disk should be // replicated to. You must provide exactly two replica zones, and one @@ -7712,7 +7717,7 @@ type Commitment struct { // SelfLink: [Output Only] Server-defined URL for the resource. SelfLink string `json:"selfLink,omitempty"` - // SplitSourceCommitment: Source commitment to be splitted into a new + // SplitSourceCommitment: Source commitment to be split into a new // commitment. SplitSourceCommitment string `json:"splitSourceCommitment,omitempty"` @@ -8912,6 +8917,11 @@ type Disk struct { // see the Extreme persistent disk documentation. ProvisionedIops int64 `json:"provisionedIops,omitempty,string"` + // ProvisionedThroughput: Indicates how much throughput to provision for + // the disk. This sets the number of throughput mb per second that the + // disk can handle. Values must be between 1 and 7,124. + ProvisionedThroughput int64 `json:"provisionedThroughput,omitempty,string"` + // Region: [Output Only] URL of the region where the disk resides. Only // applicable for regional resources. You must specify this field as // part of the HTTP request URL. It is not settable as a field in the @@ -27571,7 +27581,11 @@ type NetworkAttachment struct { Name string `json:"name,omitempty"` // Network: [Output Only] The URL of the network which the Network - // Attachment belongs to. + // Attachment belongs to. Practically it is inferred by fetching the + // network of the first subnetwork associated. Because it is required + // that all the subnetworks must be from the same network, it is assured + // that the Network Attachment belongs to the same network as all the + // subnetworks. Network string `json:"network,omitempty"` // ProducerAcceptLists: Projects that are allowed to connect to this @@ -57802,7 +57816,7 @@ type VpnGatewayStatusTunnel struct { // PeerGatewayInterface: The peer gateway interface this VPN tunnel is // connected to, the peer gateway could either be an external VPN - // gateway or GCP VPN gateway. + // gateway or a Google Cloud VPN gateway. PeerGatewayInterface int64 `json:"peerGatewayInterface,omitempty"` // TunnelUrl: URL reference to the VPN tunnel. @@ -57835,8 +57849,8 @@ func (s *VpnGatewayStatusTunnel) MarshalJSON() ([]byte, error) { // VpnGatewayStatusVpnConnection: A VPN connection contains all VPN // tunnels connected from this VpnGateway to the same peer gateway. The -// peer gateway could either be a external VPN gateway or GCP VPN -// gateway. +// peer gateway could either be an external VPN gateway or a Google +// Cloud VPN gateway. type VpnGatewayStatusVpnConnection struct { // PeerExternalGateway: URL reference to the peer external VPN gateways // to which the VPN tunnels in this VPN connection are connected. This diff --git a/connectors/v1/connectors-api.json b/connectors/v1/connectors-api.json index b60b330c24a..649d59860d9 100644 --- a/connectors/v1/connectors-api.json +++ b/connectors/v1/connectors-api.json @@ -635,6 +635,173 @@ } } }, + "endpointAttachments": { + "methods": { + "create": { + "description": "Creates a new EndpointAttachment in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/endpointAttachments", + "httpMethod": "POST", + "id": "connectors.projects.locations.endpointAttachments.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "endpointAttachmentId": { + "description": "Required. Identifier to assign to the EndpointAttachment. Must be unique within scope of the parent resource.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Parent resource of the EndpointAttachment, of the form: `projects/*/locations/*`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/endpointAttachments", + "request": { + "$ref": "EndpointAttachment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single EndpointAttachment.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/endpointAttachments/{endpointAttachmentsId}", + "httpMethod": "DELETE", + "id": "connectors.projects.locations.endpointAttachments.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Resource name of the form: `projects/*/locations/*/endpointAttachments/*`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/endpointAttachments/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single EndpointAttachment.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/endpointAttachments/{endpointAttachmentsId}", + "httpMethod": "GET", + "id": "connectors.projects.locations.endpointAttachments.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Resource name of the form: `projects/*/locations/*/endpointAttachments/*`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/endpointAttachments/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "EndpointAttachment" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "List EndpointAttachments in a given project", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/endpointAttachments", + "httpMethod": "GET", + "id": "connectors.projects.locations.endpointAttachments.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Filter. https://g3doc.corp.google.com/cloud/control2/g3doc/dev/apihosting/list_filtering.md#filtering.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Order by parameters.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Parent resource od the EndpointAttachment, of the form: `projects/*/locations/*`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/endpointAttachments", + "response": { + "$ref": "ListEndpointAttachmentsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single EndpointAttachment.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/endpointAttachments/{endpointAttachmentsId}", + "httpMethod": "PATCH", + "id": "connectors.projects.locations.endpointAttachments.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. Resource name of the Endpoint Attachment. Format: projects/{project}/locations/{location}/endpointAttachments/{endpoint_attachment}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/endpointAttachments/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. The list of fields to update. Fields are specified relative to the endpointAttachment. A field will be overwritten if it is in the mask. You can modify only the fields listed below. To update the endpointAttachment details: * `description` * `labels`", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "EndpointAttachment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "global": { "methods": { "getSettings": { @@ -662,6 +829,175 @@ "https://www.googleapis.com/auth/cloud-platform" ] } + }, + "resources": { + "managedZones": { + "methods": { + "create": { + "description": "Creates a new ManagedZone in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/global/managedZones", + "httpMethod": "POST", + "id": "connectors.projects.locations.global.managedZones.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "managedZoneId": { + "description": "Required. Identifier to assign to the ManagedZone. Must be unique within scope of the parent resource.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Parent resource of the ManagedZone, of the form: `projects/*/locations/global`", + "location": "path", + "pattern": "^projects/[^/]+/locations/global$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/managedZones", + "request": { + "$ref": "ManagedZone" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single ManagedZone.", + "flatPath": "v1/projects/{projectsId}/locations/global/managedZones/{managedZonesId}", + "httpMethod": "DELETE", + "id": "connectors.projects.locations.global.managedZones.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Resource name of the form: `projects/*/locations/global/managedZones/*`", + "location": "path", + "pattern": "^projects/[^/]+/locations/global/managedZones/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single ManagedZone.", + "flatPath": "v1/projects/{projectsId}/locations/global/managedZones/{managedZonesId}", + "httpMethod": "GET", + "id": "connectors.projects.locations.global.managedZones.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Resource name of the form: `projects/*/locations/global/managedZones/*`", + "location": "path", + "pattern": "^projects/[^/]+/locations/global/managedZones/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "ManagedZone" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "List ManagedZones in a given project", + "flatPath": "v1/projects/{projectsId}/locations/global/managedZones", + "httpMethod": "GET", + "id": "connectors.projects.locations.global.managedZones.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Filter. https://g3doc.corp.google.com/cloud/control2/g3doc/dev/apihosting/list_filtering.md#filtering.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Order by parameters.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Parent resource of the Managed Zone, of the form: `projects/*/locations/global`", + "location": "path", + "pattern": "^projects/[^/]+/locations/global$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/managedZones", + "response": { + "$ref": "ListManagedZonesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single ManagedZone.", + "flatPath": "v1/projects/{projectsId}/locations/global/managedZones/{managedZonesId}", + "httpMethod": "PATCH", + "id": "connectors.projects.locations.global.managedZones.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. Resource name of the Managed Zone. Format: projects/{project}/locations/global/managedZones/{managed_zone}", + "location": "path", + "pattern": "^projects/[^/]+/locations/global/managedZones/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. The list of fields to update. Fields are specified relative to the managedZone. A field will be overwritten if it is in the mask. You can modify only the fields listed below. To update the managedZone details: * `description` * `labels` * `target_project` * `target_network`", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "ManagedZone" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } } }, "operations": { @@ -1108,7 +1444,7 @@ } } }, - "revision": "20230403", + "revision": "20230501", "rootUrl": "https://connectors.googleapis.com/", "schemas": { "AuditConfig": { @@ -1170,6 +1506,10 @@ }, "type": "array" }, + "authKey": { + "description": "Identifier key for auth config", + "type": "string" + }, "authType": { "description": "The type of authentication configured.", "enum": [ @@ -1217,6 +1557,10 @@ "description": "AuthConfigTemplate defines required field over an authentication type.", "id": "AuthConfigTemplate", "properties": { + "authKey": { + "description": "Identifier key for auth config", + "type": "string" + }, "authType": { "description": "The type of authentication configured.", "enum": [ @@ -1507,6 +1851,21 @@ "description": "Output only. Current status of the connection.", "readOnly": true }, + "subscriptionType": { + "description": "Output only. This subscription type enum value states if the metrics should be sent for billing or not.", + "enum": [ + "SUBSCRIPTION_TYPE_UNSPECIFIED", + "PAY_G", + "PAID" + ], + "enumDescriptions": [ + "Unspecified subscription type.", + "Metrics should be sent for billing for PayG type.", + "Metrics should not be sent for billing for Paid Subscription type." + ], + "readOnly": true, + "type": "string" + }, "suspended": { "description": "Optional. Suspended indicates if a user has suspended a connection or not.", "type": "boolean" @@ -1930,6 +2289,50 @@ "properties": {}, "type": "object" }, + "EndpointAttachment": { + "description": "represents the Connector's Endpoint Attachment resource", + "id": "EndpointAttachment", + "properties": { + "createTime": { + "description": "Output only. Created time.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. Description of the resource.", + "type": "string" + }, + "endpointIp": { + "description": "Output only. The Private Service Connect connection endpoint ip", + "readOnly": true, + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Resource labels to represent user-provided metadata. Refer to cloud documentation on labels for more details. https://cloud.google.com/compute/docs/labeling-resources", + "type": "object" + }, + "name": { + "description": "Output only. Resource name of the Endpoint Attachment. Format: projects/{project}/locations/{location}/endpointAttachments/{endpoint_attachment}", + "readOnly": true, + "type": "string" + }, + "serviceAttachment": { + "description": "Required. The path of the service attachment", + "type": "string" + }, + "updateTime": { + "description": "Output only. Updated time.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "EnumOption": { "description": "EnumOption definition", "id": "EnumOption", @@ -2349,6 +2752,31 @@ }, "type": "object" }, + "ListEndpointAttachmentsResponse": { + "description": "Response message for ConnectorsService.ListEndpointAttachments", + "id": "ListEndpointAttachmentsResponse", + "properties": { + "endpointAttachments": { + "description": "EndpointAttachments.", + "items": { + "$ref": "EndpointAttachment" + }, + "type": "array" + }, + "nextPageToken": { + "description": "Next page token.", + "type": "string" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "ListLocationsResponse": { "description": "The response message for Locations.ListLocations.", "id": "ListLocationsResponse", @@ -2367,6 +2795,24 @@ }, "type": "object" }, + "ListManagedZonesResponse": { + "description": "Response message for ConnectorsService.ListManagedZones", + "id": "ListManagedZonesResponse", + "properties": { + "managedZones": { + "description": "ManagedZones.", + "items": { + "$ref": "ManagedZone" + }, + "type": "array" + }, + "nextPageToken": { + "description": "Next page token.", + "type": "string" + } + }, + "type": "object" + }, "ListOperationsResponse": { "description": "The response message for Operations.ListOperations.", "id": "ListOperationsResponse", @@ -2447,7 +2893,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -2495,6 +2941,53 @@ }, "type": "object" }, + "ManagedZone": { + "description": "represents the Connector's Managed Zone resource", + "id": "ManagedZone", + "properties": { + "createTime": { + "description": "Output only. Created time.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. Description of the resource.", + "type": "string" + }, + "dns": { + "description": "Required. DNS Name of the resource", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Resource labels to represent user-provided metadata. Refer to cloud documentation on labels for more details. https://cloud.google.com/compute/docs/labeling-resources", + "type": "object" + }, + "name": { + "description": "Output only. Resource name of the Managed Zone. Format: projects/{project}/locations/global/managedZones/{managed_zone}", + "readOnly": true, + "type": "string" + }, + "targetProject": { + "description": "Required. The name of the Target Project", + "type": "string" + }, + "targetVpc": { + "description": "Required. The name of the Target Project VPC Network", + "type": "string" + }, + "updateTime": { + "description": "Output only. Updated time.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "NodeConfig": { "description": "Node configuration for the connection.", "id": "NodeConfig", diff --git a/connectors/v1/connectors-gen.go b/connectors/v1/connectors-gen.go index b337a06173d..66a74f250c7 100644 --- a/connectors/v1/connectors-gen.go +++ b/connectors/v1/connectors-gen.go @@ -153,6 +153,7 @@ type ProjectsService struct { func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs := &ProjectsLocationsService{s: s} rs.Connections = NewProjectsLocationsConnectionsService(s) + rs.EndpointAttachments = NewProjectsLocationsEndpointAttachmentsService(s) rs.Global = NewProjectsLocationsGlobalService(s) rs.Operations = NewProjectsLocationsOperationsService(s) rs.Providers = NewProjectsLocationsProvidersService(s) @@ -164,6 +165,8 @@ type ProjectsLocationsService struct { Connections *ProjectsLocationsConnectionsService + EndpointAttachments *ProjectsLocationsEndpointAttachmentsService + Global *ProjectsLocationsGlobalService Operations *ProjectsLocationsOperationsService @@ -216,13 +219,34 @@ type ProjectsLocationsConnectionsRuntimeEntitySchemasService struct { s *Service } +func NewProjectsLocationsEndpointAttachmentsService(s *Service) *ProjectsLocationsEndpointAttachmentsService { + rs := &ProjectsLocationsEndpointAttachmentsService{s: s} + return rs +} + +type ProjectsLocationsEndpointAttachmentsService struct { + s *Service +} + func NewProjectsLocationsGlobalService(s *Service) *ProjectsLocationsGlobalService { rs := &ProjectsLocationsGlobalService{s: s} + rs.ManagedZones = NewProjectsLocationsGlobalManagedZonesService(s) return rs } type ProjectsLocationsGlobalService struct { s *Service + + ManagedZones *ProjectsLocationsGlobalManagedZonesService +} + +func NewProjectsLocationsGlobalManagedZonesService(s *Service) *ProjectsLocationsGlobalManagedZonesService { + rs := &ProjectsLocationsGlobalManagedZonesService{s: s} + return rs +} + +type ProjectsLocationsGlobalManagedZonesService struct { + s *Service } func NewProjectsLocationsOperationsService(s *Service) *ProjectsLocationsOperationsService { @@ -369,6 +393,9 @@ type AuthConfig struct { // AdditionalVariables: List containing additional auth configs. AdditionalVariables []*ConfigVariable `json:"additionalVariables,omitempty"` + // AuthKey: Identifier key for auth config + AuthKey string `json:"authKey,omitempty"` + // AuthType: The type of authentication configured. // // Possible values: @@ -424,6 +451,9 @@ func (s *AuthConfig) MarshalJSON() ([]byte, error) { // AuthConfigTemplate: AuthConfigTemplate defines required field over an // authentication type. type AuthConfigTemplate struct { + // AuthKey: Identifier key for auth config + AuthKey string `json:"authKey,omitempty"` + // AuthType: The type of authentication configured. // // Possible values: @@ -448,7 +478,7 @@ type AuthConfigTemplate struct { // DisplayName: Display name for authentication template. DisplayName string `json:"displayName,omitempty"` - // ForceSendFields is a list of field names (e.g. "AuthType") to + // ForceSendFields is a list of field names (e.g. "AuthKey") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -456,7 +486,7 @@ type AuthConfigTemplate struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AuthType") to include in + // NullFields is a list of field names (e.g. "AuthKey") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as @@ -788,6 +818,16 @@ type Connection struct { // Status: Output only. Current status of the connection. Status *ConnectionStatus `json:"status,omitempty"` + // SubscriptionType: Output only. This subscription type enum value + // states if the metrics should be sent for billing or not. + // + // Possible values: + // "SUBSCRIPTION_TYPE_UNSPECIFIED" - Unspecified subscription type. + // "PAY_G" - Metrics should be sent for billing for PayG type. + // "PAID" - Metrics should not be sent for billing for Paid + // Subscription type. + SubscriptionType string `json:"subscriptionType,omitempty"` + // Suspended: Optional. Suspended indicates if a user has suspended a // connection or not. Suspended bool `json:"suspended,omitempty"` @@ -1302,6 +1342,62 @@ type Empty struct { googleapi.ServerResponse `json:"-"` } +// EndpointAttachment: represents the Connector's Endpoint Attachment +// resource +type EndpointAttachment struct { + // CreateTime: Output only. Created time. + CreateTime string `json:"createTime,omitempty"` + + // Description: Optional. Description of the resource. + Description string `json:"description,omitempty"` + + // EndpointIp: Output only. The Private Service Connect connection + // endpoint ip + EndpointIp string `json:"endpointIp,omitempty"` + + // Labels: Optional. Resource labels to represent user-provided + // metadata. Refer to cloud documentation on labels for more details. + // https://cloud.google.com/compute/docs/labeling-resources + Labels map[string]string `json:"labels,omitempty"` + + // Name: Output only. Resource name of the Endpoint Attachment. Format: + // projects/{project}/locations/{location}/endpointAttachments/{endpoint_ + // attachment} + Name string `json:"name,omitempty"` + + // ServiceAttachment: Required. The path of the service attachment + ServiceAttachment string `json:"serviceAttachment,omitempty"` + + // UpdateTime: Output only. Updated time. + UpdateTime string `json:"updateTime,omitempty"` + + // 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 + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CreateTime") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *EndpointAttachment) MarshalJSON() ([]byte, error) { + type NoMethod EndpointAttachment + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // EnumOption: EnumOption definition type EnumOption struct { // DisplayName: Display name of the option. @@ -1807,6 +1903,46 @@ func (s *ListConnectorsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ListEndpointAttachmentsResponse: Response message for +// ConnectorsService.ListEndpointAttachments +type ListEndpointAttachmentsResponse struct { + // EndpointAttachments: EndpointAttachments. + EndpointAttachments []*EndpointAttachment `json:"endpointAttachments,omitempty"` + + // NextPageToken: Next page token. + NextPageToken string `json:"nextPageToken,omitempty"` + + // Unreachable: Locations that could not be reached. + 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. "EndpointAttachments") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "EndpointAttachments") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *ListEndpointAttachmentsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListEndpointAttachmentsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ListLocationsResponse: The response message for // Locations.ListLocations. type ListLocationsResponse struct { @@ -1844,6 +1980,42 @@ func (s *ListLocationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ListManagedZonesResponse: Response message for +// ConnectorsService.ListManagedZones +type ListManagedZonesResponse struct { + // ManagedZones: ManagedZones. + ManagedZones []*ManagedZone `json:"managedZones,omitempty"` + + // NextPageToken: Next page token. + 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. "ManagedZones") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ManagedZones") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListManagedZonesResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListManagedZonesResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ListOperationsResponse: The response message for // Operations.ListOperations. type ListOperationsResponse struct { @@ -1991,7 +2163,7 @@ func (s *ListRuntimeEntitySchemasResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -2073,6 +2245,62 @@ func (s *LockConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ManagedZone: represents the Connector's Managed Zone resource +type ManagedZone struct { + // CreateTime: Output only. Created time. + CreateTime string `json:"createTime,omitempty"` + + // Description: Optional. Description of the resource. + Description string `json:"description,omitempty"` + + // Dns: Required. DNS Name of the resource + Dns string `json:"dns,omitempty"` + + // Labels: Optional. Resource labels to represent user-provided + // metadata. Refer to cloud documentation on labels for more details. + // https://cloud.google.com/compute/docs/labeling-resources + Labels map[string]string `json:"labels,omitempty"` + + // Name: Output only. Resource name of the Managed Zone. Format: + // projects/{project}/locations/global/managedZones/{managed_zone} + Name string `json:"name,omitempty"` + + // TargetProject: Required. The name of the Target Project + TargetProject string `json:"targetProject,omitempty"` + + // TargetVpc: Required. The name of the Target Project VPC Network + TargetVpc string `json:"targetVpc,omitempty"` + + // UpdateTime: Output only. Updated time. + UpdateTime string `json:"updateTime,omitempty"` + + // 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 + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CreateTime") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ManagedZone) MarshalJSON() ([]byte, error) { + type NoMethod ManagedZone + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // NodeConfig: Node configuration for the connection. type NodeConfig struct { // MaxNodeCount: Maximum number of nodes in the runtime nodes. @@ -5892,96 +6120,99 @@ func (c *ProjectsLocationsConnectionsRuntimeEntitySchemasListCall) Pages(ctx con } } -// method id "connectors.projects.locations.global.getSettings": +// method id "connectors.projects.locations.endpointAttachments.create": -type ProjectsLocationsGlobalGetSettingsCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsEndpointAttachmentsCreateCall struct { + s *Service + parent string + endpointattachment *EndpointAttachment + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// GetSettings: GetGlobalSettings gets settings of a project. -// GlobalSettings is a singleton resource. +// Create: Creates a new EndpointAttachment in a given project and +// location. // -// - name: The resource name of the Settings. -func (r *ProjectsLocationsGlobalService) GetSettings(name string) *ProjectsLocationsGlobalGetSettingsCall { - c := &ProjectsLocationsGlobalGetSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: Parent resource of the EndpointAttachment, of the form: +// `projects/*/locations/*`. +func (r *ProjectsLocationsEndpointAttachmentsService) Create(parent string, endpointattachment *EndpointAttachment) *ProjectsLocationsEndpointAttachmentsCreateCall { + c := &ProjectsLocationsEndpointAttachmentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.endpointattachment = endpointattachment + return c +} + +// EndpointAttachmentId sets the optional parameter +// "endpointAttachmentId": Required. Identifier to assign to the +// EndpointAttachment. Must be unique within scope of the parent +// resource. +func (c *ProjectsLocationsEndpointAttachmentsCreateCall) EndpointAttachmentId(endpointAttachmentId string) *ProjectsLocationsEndpointAttachmentsCreateCall { + c.urlParams_.Set("endpointAttachmentId", endpointAttachmentId) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsGlobalGetSettingsCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalGetSettingsCall { +func (c *ProjectsLocationsEndpointAttachmentsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsEndpointAttachmentsCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response -// error from Do is the result of In-None-Match. -func (c *ProjectsLocationsGlobalGetSettingsCall) IfNoneMatch(entityTag string) *ProjectsLocationsGlobalGetSettingsCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsGlobalGetSettingsCall) Context(ctx context.Context) *ProjectsLocationsGlobalGetSettingsCall { +func (c *ProjectsLocationsEndpointAttachmentsCreateCall) Context(ctx context.Context) *ProjectsLocationsEndpointAttachmentsCreateCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsGlobalGetSettingsCall) Header() http.Header { +func (c *ProjectsLocationsEndpointAttachmentsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsGlobalGetSettingsCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsEndpointAttachmentsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.endpointattachment) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") 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}/endpointAttachments") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", 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, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "connectors.projects.locations.global.getSettings" call. -// Exactly one of *Settings or error will be non-nil. Any non-2xx status -// code is an error. Response headers are in either -// *Settings.ServerResponse.Header or (if a response was returned at +// Do executes the "connectors.projects.locations.endpointAttachments.create" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsGlobalGetSettingsCall) Do(opts ...googleapi.CallOption) (*Settings, error) { +func (c *ProjectsLocationsEndpointAttachmentsCreateCall) Do(opts ...googleapi.CallOption) (*Operation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -6000,7 +6231,7 @@ func (c *ProjectsLocationsGlobalGetSettingsCall) Do(opts ...googleapi.CallOption if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Settings{ + ret := &Operation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -6012,25 +6243,1645 @@ func (c *ProjectsLocationsGlobalGetSettingsCall) Do(opts ...googleapi.CallOption } return ret, nil // { - // "description": "GetGlobalSettings gets settings of a project. GlobalSettings is a singleton resource.", - // "flatPath": "v1/projects/{projectsId}/locations/global/settings", - // "httpMethod": "GET", - // "id": "connectors.projects.locations.global.getSettings", + // "description": "Creates a new EndpointAttachment in a given project and location.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/endpointAttachments", + // "httpMethod": "POST", + // "id": "connectors.projects.locations.endpointAttachments.create", // "parameterOrder": [ - // "name" + // "parent" // ], // "parameters": { - // "name": { - // "description": "Required. The resource name of the Settings.", + // "endpointAttachmentId": { + // "description": "Required. Identifier to assign to the EndpointAttachment. Must be unique within scope of the parent resource.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. Parent resource of the EndpointAttachment, of the form: `projects/*/locations/*`", // "location": "path", - // "pattern": "^projects/[^/]+/locations/global/settings$", + // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+name}", + // "path": "v1/{+parent}/endpointAttachments", + // "request": { + // "$ref": "EndpointAttachment" + // }, // "response": { - // "$ref": "Settings" + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "connectors.projects.locations.endpointAttachments.delete": + +type ProjectsLocationsEndpointAttachmentsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a single EndpointAttachment. +// +// - name: Resource name of the form: +// `projects/*/locations/*/endpointAttachments/*`. +func (r *ProjectsLocationsEndpointAttachmentsService) Delete(name string) *ProjectsLocationsEndpointAttachmentsDeleteCall { + c := &ProjectsLocationsEndpointAttachmentsDeleteCall{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 information. +func (c *ProjectsLocationsEndpointAttachmentsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsEndpointAttachmentsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsEndpointAttachmentsDeleteCall) Context(ctx context.Context) *ProjectsLocationsEndpointAttachmentsDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsEndpointAttachmentsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsEndpointAttachmentsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "connectors.projects.locations.endpointAttachments.delete" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsEndpointAttachmentsDeleteCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Deletes a single EndpointAttachment.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/endpointAttachments/{endpointAttachmentsId}", + // "httpMethod": "DELETE", + // "id": "connectors.projects.locations.endpointAttachments.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Resource name of the form: `projects/*/locations/*/endpointAttachments/*`", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/endpointAttachments/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "connectors.projects.locations.endpointAttachments.get": + +type ProjectsLocationsEndpointAttachmentsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of a single EndpointAttachment. +// +// - name: Resource name of the form: +// `projects/*/locations/*/endpointAttachments/*`. +func (r *ProjectsLocationsEndpointAttachmentsService) Get(name string) *ProjectsLocationsEndpointAttachmentsGetCall { + c := &ProjectsLocationsEndpointAttachmentsGetCall{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 information. +func (c *ProjectsLocationsEndpointAttachmentsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsEndpointAttachmentsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsEndpointAttachmentsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsEndpointAttachmentsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsEndpointAttachmentsGetCall) Context(ctx context.Context) *ProjectsLocationsEndpointAttachmentsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsEndpointAttachmentsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsEndpointAttachmentsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "connectors.projects.locations.endpointAttachments.get" call. +// Exactly one of *EndpointAttachment or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *EndpointAttachment.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 *ProjectsLocationsEndpointAttachmentsGetCall) Do(opts ...googleapi.CallOption) (*EndpointAttachment, 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 := &EndpointAttachment{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets details of a single EndpointAttachment.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/endpointAttachments/{endpointAttachmentsId}", + // "httpMethod": "GET", + // "id": "connectors.projects.locations.endpointAttachments.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Resource name of the form: `projects/*/locations/*/endpointAttachments/*`", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/endpointAttachments/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "EndpointAttachment" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "connectors.projects.locations.endpointAttachments.list": + +type ProjectsLocationsEndpointAttachmentsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: List EndpointAttachments in a given project +// +// - parent: Parent resource od the EndpointAttachment, of the form: +// `projects/*/locations/*`. +func (r *ProjectsLocationsEndpointAttachmentsService) List(parent string) *ProjectsLocationsEndpointAttachmentsListCall { + c := &ProjectsLocationsEndpointAttachmentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Filter. +// https://g3doc.corp.google.com/cloud/control2/g3doc/dev/apihosting/list_filtering.md#filtering. +func (c *ProjectsLocationsEndpointAttachmentsListCall) Filter(filter string) *ProjectsLocationsEndpointAttachmentsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Order by parameters. +func (c *ProjectsLocationsEndpointAttachmentsListCall) OrderBy(orderBy string) *ProjectsLocationsEndpointAttachmentsListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": Page size. +func (c *ProjectsLocationsEndpointAttachmentsListCall) PageSize(pageSize int64) *ProjectsLocationsEndpointAttachmentsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Page token. +func (c *ProjectsLocationsEndpointAttachmentsListCall) PageToken(pageToken string) *ProjectsLocationsEndpointAttachmentsListCall { + 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 information. +func (c *ProjectsLocationsEndpointAttachmentsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsEndpointAttachmentsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsEndpointAttachmentsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsEndpointAttachmentsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsEndpointAttachmentsListCall) Context(ctx context.Context) *ProjectsLocationsEndpointAttachmentsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsEndpointAttachmentsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsEndpointAttachmentsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/endpointAttachments") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "connectors.projects.locations.endpointAttachments.list" call. +// Exactly one of *ListEndpointAttachmentsResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *ListEndpointAttachmentsResponse.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 *ProjectsLocationsEndpointAttachmentsListCall) Do(opts ...googleapi.CallOption) (*ListEndpointAttachmentsResponse, 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 := &ListEndpointAttachmentsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "List EndpointAttachments in a given project", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/endpointAttachments", + // "httpMethod": "GET", + // "id": "connectors.projects.locations.endpointAttachments.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "filter": { + // "description": "Filter. https://g3doc.corp.google.com/cloud/control2/g3doc/dev/apihosting/list_filtering.md#filtering.", + // "location": "query", + // "type": "string" + // }, + // "orderBy": { + // "description": "Order by parameters.", + // "location": "query", + // "type": "string" + // }, + // "pageSize": { + // "description": "Page size.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "Page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. Parent resource od the EndpointAttachment, of the form: `projects/*/locations/*`", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/endpointAttachments", + // "response": { + // "$ref": "ListEndpointAttachmentsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsEndpointAttachmentsListCall) Pages(ctx context.Context, f func(*ListEndpointAttachmentsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "connectors.projects.locations.endpointAttachments.patch": + +type ProjectsLocationsEndpointAttachmentsPatchCall struct { + s *Service + name string + endpointattachment *EndpointAttachment + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the parameters of a single EndpointAttachment. +// +// - name: Output only. Resource name of the Endpoint Attachment. +// Format: +// projects/{project}/locations/{location}/endpointAttachments/{endpoin +// t_attachment}. +func (r *ProjectsLocationsEndpointAttachmentsService) Patch(name string, endpointattachment *EndpointAttachment) *ProjectsLocationsEndpointAttachmentsPatchCall { + c := &ProjectsLocationsEndpointAttachmentsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.endpointattachment = endpointattachment + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. The +// list of fields to update. Fields are specified relative to the +// endpointAttachment. A field will be overwritten if it is in the mask. +// You can modify only the fields listed below. To update the +// endpointAttachment details: * `description` * `labels` +func (c *ProjectsLocationsEndpointAttachmentsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsEndpointAttachmentsPatchCall { + 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 information. +func (c *ProjectsLocationsEndpointAttachmentsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsEndpointAttachmentsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsEndpointAttachmentsPatchCall) Context(ctx context.Context) *ProjectsLocationsEndpointAttachmentsPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsEndpointAttachmentsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsEndpointAttachmentsPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.endpointattachment) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "connectors.projects.locations.endpointAttachments.patch" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsEndpointAttachmentsPatchCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates the parameters of a single EndpointAttachment.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/endpointAttachments/{endpointAttachmentsId}", + // "httpMethod": "PATCH", + // "id": "connectors.projects.locations.endpointAttachments.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Output only. Resource name of the Endpoint Attachment. Format: projects/{project}/locations/{location}/endpointAttachments/{endpoint_attachment}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/endpointAttachments/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Required. The list of fields to update. Fields are specified relative to the endpointAttachment. A field will be overwritten if it is in the mask. You can modify only the fields listed below. To update the endpointAttachment details: * `description` * `labels`", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "EndpointAttachment" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "connectors.projects.locations.global.getSettings": + +type ProjectsLocationsGlobalGetSettingsCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetSettings: GetGlobalSettings gets settings of a project. +// GlobalSettings is a singleton resource. +// +// - name: The resource name of the Settings. +func (r *ProjectsLocationsGlobalService) GetSettings(name string) *ProjectsLocationsGlobalGetSettingsCall { + c := &ProjectsLocationsGlobalGetSettingsCall{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 information. +func (c *ProjectsLocationsGlobalGetSettingsCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalGetSettingsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsGlobalGetSettingsCall) IfNoneMatch(entityTag string) *ProjectsLocationsGlobalGetSettingsCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsGlobalGetSettingsCall) Context(ctx context.Context) *ProjectsLocationsGlobalGetSettingsCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsGlobalGetSettingsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalGetSettingsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "connectors.projects.locations.global.getSettings" call. +// Exactly one of *Settings or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Settings.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 *ProjectsLocationsGlobalGetSettingsCall) Do(opts ...googleapi.CallOption) (*Settings, 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 := &Settings{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "GetGlobalSettings gets settings of a project. GlobalSettings is a singleton resource.", + // "flatPath": "v1/projects/{projectsId}/locations/global/settings", + // "httpMethod": "GET", + // "id": "connectors.projects.locations.global.getSettings", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The resource name of the Settings.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/global/settings$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Settings" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "connectors.projects.locations.global.managedZones.create": + +type ProjectsLocationsGlobalManagedZonesCreateCall struct { + s *Service + parent string + managedzone *ManagedZone + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new ManagedZone in a given project and location. +// +// - parent: Parent resource of the ManagedZone, of the form: +// `projects/*/locations/global`. +func (r *ProjectsLocationsGlobalManagedZonesService) Create(parent string, managedzone *ManagedZone) *ProjectsLocationsGlobalManagedZonesCreateCall { + c := &ProjectsLocationsGlobalManagedZonesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.managedzone = managedzone + return c +} + +// ManagedZoneId sets the optional parameter "managedZoneId": Required. +// Identifier to assign to the ManagedZone. Must be unique within scope +// of the parent resource. +func (c *ProjectsLocationsGlobalManagedZonesCreateCall) ManagedZoneId(managedZoneId string) *ProjectsLocationsGlobalManagedZonesCreateCall { + c.urlParams_.Set("managedZoneId", managedZoneId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsGlobalManagedZonesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalManagedZonesCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsGlobalManagedZonesCreateCall) Context(ctx context.Context) *ProjectsLocationsGlobalManagedZonesCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsGlobalManagedZonesCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalManagedZonesCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.managedzone) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/managedZones") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "connectors.projects.locations.global.managedZones.create" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsGlobalManagedZonesCreateCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates a new ManagedZone in a given project and location.", + // "flatPath": "v1/projects/{projectsId}/locations/global/managedZones", + // "httpMethod": "POST", + // "id": "connectors.projects.locations.global.managedZones.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "managedZoneId": { + // "description": "Required. Identifier to assign to the ManagedZone. Must be unique within scope of the parent resource.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. Parent resource of the ManagedZone, of the form: `projects/*/locations/global`", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/global$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/managedZones", + // "request": { + // "$ref": "ManagedZone" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "connectors.projects.locations.global.managedZones.delete": + +type ProjectsLocationsGlobalManagedZonesDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a single ManagedZone. +// +// - name: Resource name of the form: +// `projects/*/locations/global/managedZones/*`. +func (r *ProjectsLocationsGlobalManagedZonesService) Delete(name string) *ProjectsLocationsGlobalManagedZonesDeleteCall { + c := &ProjectsLocationsGlobalManagedZonesDeleteCall{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 information. +func (c *ProjectsLocationsGlobalManagedZonesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalManagedZonesDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsGlobalManagedZonesDeleteCall) Context(ctx context.Context) *ProjectsLocationsGlobalManagedZonesDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsGlobalManagedZonesDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalManagedZonesDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "connectors.projects.locations.global.managedZones.delete" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsGlobalManagedZonesDeleteCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Deletes a single ManagedZone.", + // "flatPath": "v1/projects/{projectsId}/locations/global/managedZones/{managedZonesId}", + // "httpMethod": "DELETE", + // "id": "connectors.projects.locations.global.managedZones.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Resource name of the form: `projects/*/locations/global/managedZones/*`", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/global/managedZones/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "connectors.projects.locations.global.managedZones.get": + +type ProjectsLocationsGlobalManagedZonesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of a single ManagedZone. +// +// - name: Resource name of the form: +// `projects/*/locations/global/managedZones/*`. +func (r *ProjectsLocationsGlobalManagedZonesService) Get(name string) *ProjectsLocationsGlobalManagedZonesGetCall { + c := &ProjectsLocationsGlobalManagedZonesGetCall{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 information. +func (c *ProjectsLocationsGlobalManagedZonesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalManagedZonesGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsGlobalManagedZonesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsGlobalManagedZonesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsGlobalManagedZonesGetCall) Context(ctx context.Context) *ProjectsLocationsGlobalManagedZonesGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsGlobalManagedZonesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalManagedZonesGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "connectors.projects.locations.global.managedZones.get" call. +// Exactly one of *ManagedZone or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *ManagedZone.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 *ProjectsLocationsGlobalManagedZonesGetCall) Do(opts ...googleapi.CallOption) (*ManagedZone, 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 := &ManagedZone{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets details of a single ManagedZone.", + // "flatPath": "v1/projects/{projectsId}/locations/global/managedZones/{managedZonesId}", + // "httpMethod": "GET", + // "id": "connectors.projects.locations.global.managedZones.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Resource name of the form: `projects/*/locations/global/managedZones/*`", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/global/managedZones/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "ManagedZone" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "connectors.projects.locations.global.managedZones.list": + +type ProjectsLocationsGlobalManagedZonesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: List ManagedZones in a given project +// +// - parent: Parent resource of the Managed Zone, of the form: +// `projects/*/locations/global`. +func (r *ProjectsLocationsGlobalManagedZonesService) List(parent string) *ProjectsLocationsGlobalManagedZonesListCall { + c := &ProjectsLocationsGlobalManagedZonesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Filter. +// https://g3doc.corp.google.com/cloud/control2/g3doc/dev/apihosting/list_filtering.md#filtering. +func (c *ProjectsLocationsGlobalManagedZonesListCall) Filter(filter string) *ProjectsLocationsGlobalManagedZonesListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Order by parameters. +func (c *ProjectsLocationsGlobalManagedZonesListCall) OrderBy(orderBy string) *ProjectsLocationsGlobalManagedZonesListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": Page size. +func (c *ProjectsLocationsGlobalManagedZonesListCall) PageSize(pageSize int64) *ProjectsLocationsGlobalManagedZonesListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Page token. +func (c *ProjectsLocationsGlobalManagedZonesListCall) PageToken(pageToken string) *ProjectsLocationsGlobalManagedZonesListCall { + 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 information. +func (c *ProjectsLocationsGlobalManagedZonesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalManagedZonesListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsGlobalManagedZonesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsGlobalManagedZonesListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsGlobalManagedZonesListCall) Context(ctx context.Context) *ProjectsLocationsGlobalManagedZonesListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsGlobalManagedZonesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalManagedZonesListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/managedZones") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "connectors.projects.locations.global.managedZones.list" call. +// Exactly one of *ListManagedZonesResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *ListManagedZonesResponse.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 *ProjectsLocationsGlobalManagedZonesListCall) Do(opts ...googleapi.CallOption) (*ListManagedZonesResponse, 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 := &ListManagedZonesResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "List ManagedZones in a given project", + // "flatPath": "v1/projects/{projectsId}/locations/global/managedZones", + // "httpMethod": "GET", + // "id": "connectors.projects.locations.global.managedZones.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "filter": { + // "description": "Filter. https://g3doc.corp.google.com/cloud/control2/g3doc/dev/apihosting/list_filtering.md#filtering.", + // "location": "query", + // "type": "string" + // }, + // "orderBy": { + // "description": "Order by parameters.", + // "location": "query", + // "type": "string" + // }, + // "pageSize": { + // "description": "Page size.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "Page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. Parent resource of the Managed Zone, of the form: `projects/*/locations/global`", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/global$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/managedZones", + // "response": { + // "$ref": "ListManagedZonesResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsGlobalManagedZonesListCall) Pages(ctx context.Context, f func(*ListManagedZonesResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "connectors.projects.locations.global.managedZones.patch": + +type ProjectsLocationsGlobalManagedZonesPatchCall struct { + s *Service + name string + managedzone *ManagedZone + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the parameters of a single ManagedZone. +// +// - name: Output only. Resource name of the Managed Zone. Format: +// projects/{project}/locations/global/managedZones/{managed_zone}. +func (r *ProjectsLocationsGlobalManagedZonesService) Patch(name string, managedzone *ManagedZone) *ProjectsLocationsGlobalManagedZonesPatchCall { + c := &ProjectsLocationsGlobalManagedZonesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.managedzone = managedzone + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. The +// list of fields to update. Fields are specified relative to the +// managedZone. A field will be overwritten if it is in the mask. You +// can modify only the fields listed below. To update the managedZone +// details: * `description` * `labels` * `target_project` * +// `target_network` +func (c *ProjectsLocationsGlobalManagedZonesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsGlobalManagedZonesPatchCall { + 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 information. +func (c *ProjectsLocationsGlobalManagedZonesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalManagedZonesPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsGlobalManagedZonesPatchCall) Context(ctx context.Context) *ProjectsLocationsGlobalManagedZonesPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsGlobalManagedZonesPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalManagedZonesPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.managedzone) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "connectors.projects.locations.global.managedZones.patch" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsGlobalManagedZonesPatchCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates the parameters of a single ManagedZone.", + // "flatPath": "v1/projects/{projectsId}/locations/global/managedZones/{managedZonesId}", + // "httpMethod": "PATCH", + // "id": "connectors.projects.locations.global.managedZones.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Output only. Resource name of the Managed Zone. Format: projects/{project}/locations/global/managedZones/{managed_zone}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/global/managedZones/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Required. The list of fields to update. Fields are specified relative to the managedZone. A field will be overwritten if it is in the mask. You can modify only the fields listed below. To update the managedZone details: * `description` * `labels` * `target_project` * `target_network`", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "ManagedZone" + // }, + // "response": { + // "$ref": "Operation" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" diff --git a/contactcenteraiplatform/v1alpha1/contactcenteraiplatform-api.json b/contactcenteraiplatform/v1alpha1/contactcenteraiplatform-api.json index b180312b152..b683e538d9d 100644 --- a/contactcenteraiplatform/v1alpha1/contactcenteraiplatform-api.json +++ b/contactcenteraiplatform/v1alpha1/contactcenteraiplatform-api.json @@ -512,7 +512,7 @@ } } }, - "revision": "20230418", + "revision": "20230424", "rootUrl": "https://contactcenteraiplatform.googleapis.com/", "schemas": { "AdminUser": { @@ -627,14 +627,21 @@ "id": "ContactCenterQuota", "properties": { "contactCenterCountLimit": { - "description": "Reflects the count limit of contact centers on a billing account.", + "description": "Deprecated: Use the Quota fields instead. Reflects the count limit of contact centers on a billing account.", "format": "int32", "type": "integer" }, "contactCenterCountSum": { - "description": "Reflects the count sum of contact centers on a billing account.", + "description": "Deprecated: Use the Quota fields instead. Reflects the count sum of contact centers on a billing account.", "format": "int32", "type": "integer" + }, + "quotas": { + "description": "Quota details per contact center instance type.", + "items": { + "$ref": "Quota" + }, + "type": "array" } }, "type": "object" @@ -736,7 +743,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -852,6 +859,45 @@ }, "type": "object" }, + "Quota": { + "description": "Quota details.", + "id": "Quota", + "properties": { + "contactCenterCountLimit": { + "description": "Reflects the count limit of contact centers on a billing account.", + "format": "int32", + "type": "integer" + }, + "contactCenterCountSum": { + "description": "Reflects the count sum of contact centers on a billing account.", + "format": "int32", + "type": "integer" + }, + "contactCenterInstanceSize": { + "description": "Contact center instance type.", + "enum": [ + "INSTANCE_SIZE_UNSPECIFIED", + "STANDARD_SMALL", + "STANDARD_MEDIUM", + "STANDARD_LARGE", + "STANDARD_XLARGE", + "STANDARD_2XLARGE", + "STANDARD_3XLARGE" + ], + "enumDescriptions": [ + "The default value. This value is used if the state is omitted.", + "Instance Size STANDARD_SMALL.", + "Instance Size STANDARD_MEDIUM.", + "Instance Size STANDARD_LARGE.", + "Instance Size STANDARD_XLARGE.", + "Instance Size STANDARD_2XLARGE.", + "Instance Size STANDARD_3XLARGE." + ], + "type": "string" + } + }, + "type": "object" + }, "SAMLParams": { "description": "Message storing SAML params to enable Google as IDP.", "id": "SAMLParams", diff --git a/contactcenteraiplatform/v1alpha1/contactcenteraiplatform-gen.go b/contactcenteraiplatform/v1alpha1/contactcenteraiplatform-gen.go index 38f41a7770e..4378ed1ceb5 100644 --- a/contactcenteraiplatform/v1alpha1/contactcenteraiplatform-gen.go +++ b/contactcenteraiplatform/v1alpha1/contactcenteraiplatform-gen.go @@ -305,14 +305,17 @@ func (s *ContactCenter) MarshalJSON() ([]byte, error) { // ContactCenterQuota: Represents a quota for contact centers. type ContactCenterQuota struct { - // ContactCenterCountLimit: Reflects the count limit of contact centers - // on a billing account. + // ContactCenterCountLimit: Deprecated: Use the Quota fields instead. + // Reflects the count limit of contact centers on a billing account. ContactCenterCountLimit int64 `json:"contactCenterCountLimit,omitempty"` - // ContactCenterCountSum: Reflects the count sum of contact centers on a - // billing account. + // ContactCenterCountSum: Deprecated: Use the Quota fields instead. + // Reflects the count sum of contact centers on a billing account. ContactCenterCountSum int64 `json:"contactCenterCountSum,omitempty"` + // Quotas: Quota details per contact center instance type. + Quotas []*Quota `json:"quotas,omitempty"` + // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` @@ -506,7 +509,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -673,6 +676,54 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// Quota: Quota details. +type Quota struct { + // ContactCenterCountLimit: Reflects the count limit of contact centers + // on a billing account. + ContactCenterCountLimit int64 `json:"contactCenterCountLimit,omitempty"` + + // ContactCenterCountSum: Reflects the count sum of contact centers on a + // billing account. + ContactCenterCountSum int64 `json:"contactCenterCountSum,omitempty"` + + // ContactCenterInstanceSize: Contact center instance type. + // + // Possible values: + // "INSTANCE_SIZE_UNSPECIFIED" - The default value. This value is used + // if the state is omitted. + // "STANDARD_SMALL" - Instance Size STANDARD_SMALL. + // "STANDARD_MEDIUM" - Instance Size STANDARD_MEDIUM. + // "STANDARD_LARGE" - Instance Size STANDARD_LARGE. + // "STANDARD_XLARGE" - Instance Size STANDARD_XLARGE. + // "STANDARD_2XLARGE" - Instance Size STANDARD_2XLARGE. + // "STANDARD_3XLARGE" - Instance Size STANDARD_3XLARGE. + ContactCenterInstanceSize string `json:"contactCenterInstanceSize,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "ContactCenterCountLimit") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted + // from API requests. However, any non-pointer, non-interface field + // appearing in ForceSendFields will be sent to the server regardless of + // whether the field is empty or not. This may be used to include empty + // fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ContactCenterCountLimit") + // to include in API requests with the JSON null value. By default, + // fields with empty values are omitted from API requests. However, any + // field with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *Quota) MarshalJSON() ([]byte, error) { + type NoMethod Quota + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SAMLParams: Message storing SAML params to enable Google as IDP. type SAMLParams struct { // Certificate: SAML certificate diff --git a/container/v1/container-api.json b/container/v1/container-api.json index fadd190980c..c405dc58a9e 100644 --- a/container/v1/container-api.json +++ b/container/v1/container-api.json @@ -447,6 +447,7 @@ ] }, "setLocations": { + "deprecated": true, "description": "Sets the locations for a specific cluster. Deprecated. Use [projects.locations.clusters.update](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters/update) instead.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}:setLocations", "httpMethod": "POST", @@ -1517,6 +1518,7 @@ ] }, "locations": { + "deprecated": true, "description": "Sets the locations for a specific cluster. Deprecated. Use [projects.locations.clusters.update](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters/update) instead.", "flatPath": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/locations", "httpMethod": "POST", @@ -2487,7 +2489,7 @@ } } }, - "revision": "20230404", + "revision": "20230420", "rootUrl": "https://container.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -3259,6 +3261,10 @@ "description": "Enable/Disable private endpoint for the cluster's master.", "type": "boolean" }, + "desiredFleet": { + "$ref": "Fleet", + "description": "The desired fleet configuration for the cluster." + }, "desiredGatewayApiConfig": { "$ref": "GatewayAPIConfig", "description": "The desired config of Gateway API on this cluster." diff --git a/container/v1/container-gen.go b/container/v1/container-gen.go index 900a7dba005..8c472bc5d61 100644 --- a/container/v1/container-gen.go +++ b/container/v1/container-gen.go @@ -1439,6 +1439,9 @@ type ClusterUpdate struct { // cluster's master. DesiredEnablePrivateEndpoint bool `json:"desiredEnablePrivateEndpoint,omitempty"` + // DesiredFleet: The desired fleet configuration for the cluster. + DesiredFleet *Fleet `json:"desiredFleet,omitempty"` + // DesiredGatewayApiConfig: The desired config of Gateway API on this // cluster. DesiredGatewayApiConfig *GatewayAPIConfig `json:"desiredGatewayApiConfig,omitempty"` @@ -9359,6 +9362,7 @@ func (c *ProjectsLocationsClustersSetLocationsCall) Do(opts ...googleapi.CallOpt } return ret, nil // { + // "deprecated": true, // "description": "Sets the locations for a specific cluster. Deprecated. Use [projects.locations.clusters.update](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters/update) instead.", // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}:setLocations", // "httpMethod": "POST", @@ -14468,6 +14472,7 @@ func (c *ProjectsZonesClustersLocationsCall) Do(opts ...googleapi.CallOption) (* } return ret, nil // { + // "deprecated": true, // "description": "Sets the locations for a specific cluster. Deprecated. Use [projects.locations.clusters.update](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters/update) instead.", // "flatPath": "v1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/locations", // "httpMethod": "POST", diff --git a/container/v1beta1/container-api.json b/container/v1beta1/container-api.json index 7b78a9e2638..0cd761a30bc 100644 --- a/container/v1beta1/container-api.json +++ b/container/v1beta1/container-api.json @@ -472,6 +472,7 @@ ] }, "setLocations": { + "deprecated": true, "description": "Sets the locations for a specific cluster. Deprecated. Use [projects.locations.clusters.update](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters/update) instead.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}:setLocations", "httpMethod": "POST", @@ -1542,6 +1543,7 @@ ] }, "locations": { + "deprecated": true, "description": "Sets the locations for a specific cluster. Deprecated. Use [projects.locations.clusters.update](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters/update) instead.", "flatPath": "v1beta1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/locations", "httpMethod": "POST", @@ -2512,7 +2514,7 @@ } } }, - "revision": "20230406", + "revision": "20230420", "rootUrl": "https://container.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -3379,6 +3381,10 @@ "description": "Enable/Disable private endpoint for the cluster's master.", "type": "boolean" }, + "desiredFleet": { + "$ref": "Fleet", + "description": "The desired fleet configuration for the cluster." + }, "desiredGatewayApiConfig": { "$ref": "GatewayAPIConfig", "description": "The desired config of Gateway API on this cluster." diff --git a/container/v1beta1/container-gen.go b/container/v1beta1/container-gen.go index 11d0993bdb4..aa21b4b7167 100644 --- a/container/v1beta1/container-gen.go +++ b/container/v1beta1/container-gen.go @@ -1576,6 +1576,9 @@ type ClusterUpdate struct { // cluster's master. DesiredEnablePrivateEndpoint bool `json:"desiredEnablePrivateEndpoint,omitempty"` + // DesiredFleet: The desired fleet configuration for the cluster. + DesiredFleet *Fleet `json:"desiredFleet,omitempty"` + // DesiredGatewayApiConfig: The desired config of Gateway API on this // cluster. DesiredGatewayApiConfig *GatewayAPIConfig `json:"desiredGatewayApiConfig,omitempty"` @@ -10278,6 +10281,7 @@ func (c *ProjectsLocationsClustersSetLocationsCall) Do(opts ...googleapi.CallOpt } return ret, nil // { + // "deprecated": true, // "description": "Sets the locations for a specific cluster. Deprecated. Use [projects.locations.clusters.update](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters/update) instead.", // "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}:setLocations", // "httpMethod": "POST", @@ -15392,6 +15396,7 @@ func (c *ProjectsZonesClustersLocationsCall) Do(opts ...googleapi.CallOption) (* } return ret, nil // { + // "deprecated": true, // "description": "Sets the locations for a specific cluster. Deprecated. Use [projects.locations.clusters.update](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters/update) instead.", // "flatPath": "v1beta1/projects/{projectId}/zones/{zone}/clusters/{clusterId}/locations", // "httpMethod": "POST", diff --git a/containeranalysis/v1/containeranalysis-api.json b/containeranalysis/v1/containeranalysis-api.json index 748ebdcf802..3f252eeb42b 100644 --- a/containeranalysis/v1/containeranalysis-api.json +++ b/containeranalysis/v1/containeranalysis-api.json @@ -751,43 +751,11 @@ ] } } - }, - "resources": { - "methods": { - "generatePackagesSummary": { - "description": "Gets a summary of the packages within a given resource.", - "flatPath": "v1/projects/{projectsId}/resources/{resourcesId}:generatePackagesSummary", - "httpMethod": "POST", - "id": "containeranalysis.projects.resources.generatePackagesSummary", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. The name of the resource to get a packages summary for in the form of `projects/[PROJECT_ID]/resources/[RESOURCE_URL]`.", - "location": "path", - "pattern": "^projects/[^/]+/resources/.*$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+name}:generatePackagesSummary", - "request": { - "$ref": "GeneratePackagesSummaryRequest" - }, - "response": { - "$ref": "PackagesSummaryResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - } - } } } } }, - "revision": "20230414", + "revision": "20230505", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AliasContext": { @@ -3149,7 +3117,8 @@ "UPGRADE", "COMPLIANCE", "DSSE_ATTESTATION", - "VULNERABILITY_ASSESSMENT" + "VULNERABILITY_ASSESSMENT", + "SBOM_REFERENCE" ], "enumDescriptions": [ "Default value. This value is unused.", @@ -3163,7 +3132,8 @@ "This represents an available package upgrade.", "This represents a Compliance Note", "This represents a DSSE attestation Note", - "This represents a Vulnerability Assessment." + "This represents a Vulnerability Assessment.", + "This represents an SBOM Reference." ], "type": "string" } @@ -3422,12 +3392,6 @@ }, "type": "object" }, - "GeneratePackagesSummaryRequest": { - "description": "GeneratePackagesSummaryRequest is the request body for the GeneratePackagesSummary API method. It just takes a single name argument, referring to the resource.", - "id": "GeneratePackagesSummaryRequest", - "properties": {}, - "type": "object" - }, "GerritSourceContext": { "description": "A SourceContext referring to a Gerrit project.", "id": "GerritSourceContext", @@ -3850,22 +3814,6 @@ }, "type": "object" }, - "LicensesSummary": { - "description": "Per license count", - "id": "LicensesSummary", - "properties": { - "count": { - "description": "The number of fixable vulnerabilities associated with this resource.", - "format": "int64", - "type": "string" - }, - "license": { - "description": "The license of the package. Note that the format of this value is not guaranteed. It may be nil, an empty string, a boolean value (A | B), a differently formed boolean value (A OR B), etc...", - "type": "string" - } - }, - "type": "object" - }, "ListNoteOccurrencesResponse": { "description": "Response for listing occurrences for a note.", "id": "ListNoteOccurrencesResponse", @@ -4058,7 +4006,8 @@ "UPGRADE", "COMPLIANCE", "DSSE_ATTESTATION", - "VULNERABILITY_ASSESSMENT" + "VULNERABILITY_ASSESSMENT", + "SBOM_REFERENCE" ], "enumDescriptions": [ "Default value. This value is unused.", @@ -4072,7 +4021,8 @@ "This represents an available package upgrade.", "This represents a Compliance Note", "This represents a DSSE attestation Note", - "This represents a Vulnerability Assessment." + "This represents a Vulnerability Assessment.", + "This represents an SBOM Reference." ], "type": "string" }, @@ -4102,6 +4052,10 @@ }, "type": "array" }, + "sbomReference": { + "$ref": "SBOMReferenceNote", + "description": "A note describing an SBOM reference." + }, "shortDescription": { "description": "A one sentence description of this note.", "type": "string" @@ -4181,7 +4135,8 @@ "UPGRADE", "COMPLIANCE", "DSSE_ATTESTATION", - "VULNERABILITY_ASSESSMENT" + "VULNERABILITY_ASSESSMENT", + "SBOM_REFERENCE" ], "enumDescriptions": [ "Default value. This value is unused.", @@ -4195,7 +4150,8 @@ "This represents an available package upgrade.", "This represents a Compliance Note", "This represents a DSSE attestation Note", - "This represents a Vulnerability Assessment." + "This represents a Vulnerability Assessment.", + "This represents an SBOM Reference." ], "type": "string" }, @@ -4219,6 +4175,10 @@ "description": "Required. Immutable. A URI that represents the resource for which the occurrence applies. For example, `https://gcr.io/project/image@sha256:123abc` for a Docker image.", "type": "string" }, + "sbomReference": { + "$ref": "SBOMReferenceOccurrence", + "description": "Describes a specific SBOM reference occurrences." + }, "updateTime": { "description": "Output only. The time this occurrence was last updated.", "format": "google-datetime", @@ -4422,24 +4382,6 @@ }, "type": "object" }, - "PackagesSummaryResponse": { - "description": "A summary of the packages found within the given resource.", - "id": "PackagesSummaryResponse", - "properties": { - "licensesSummary": { - "description": "A listing by license name of each of the licenses and their counts.", - "items": { - "$ref": "LicensesSummary" - }, - "type": "array" - }, - "resourceUrl": { - "description": "The unique URL of the image or the container for which this summary applies.", - "type": "string" - } - }, - "type": "object" - }, "Policy": { "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time \u003c timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time \u003c timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).", "id": "Policy", @@ -4624,6 +4566,95 @@ }, "type": "object" }, + "SBOMReferenceNote": { + "description": "The note representing an SBOM reference.", + "id": "SBOMReferenceNote", + "properties": { + "format": { + "description": "The format that SBOM takes. E.g. may be spdx, cyclonedx, etc...", + "type": "string" + }, + "version": { + "description": "The version of the format that the SBOM takes. E.g. if the format is spdx, the version may be 2.3.", + "type": "string" + } + }, + "type": "object" + }, + "SBOMReferenceOccurrence": { + "description": "The occurrence representing an SBOM reference as applied to a specific resource. The occurrence follows the DSSE specification. See https://github.com/secure-systems-lab/dsse/blob/master/envelope.md for more details.", + "id": "SBOMReferenceOccurrence", + "properties": { + "payload": { + "$ref": "SbomReferenceIntotoPayload", + "description": "The actual payload that contains the SBOM reference data." + }, + "payloadType": { + "description": "The kind of payload that SbomReferenceIntotoPayload takes. Since it's in the intoto format, this value is expected to be 'application/vnd.in-toto+json'.", + "type": "string" + }, + "signatures": { + "description": "The signatures over the payload.", + "items": { + "$ref": "EnvelopeSignature" + }, + "type": "array" + } + }, + "type": "object" + }, + "SbomReferenceIntotoPayload": { + "description": "The actual payload that contains the SBOM Reference data. The payload follows the intoto statement specification. See https://github.com/in-toto/attestation/blob/main/spec/v1.0/statement.md for more details.", + "id": "SbomReferenceIntotoPayload", + "properties": { + "_type": { + "description": "Identifier for the schema of the Statement.", + "type": "string" + }, + "predicate": { + "$ref": "SbomReferenceIntotoPredicate", + "description": "Additional parameters of the Predicate. Includes the actual data about the SBOM." + }, + "predicateType": { + "description": "URI identifying the type of the Predicate.", + "type": "string" + }, + "subject": { + "description": "Set of software artifacts that the attestation applies to. Each element represents a single software artifact.", + "items": { + "$ref": "Subject" + }, + "type": "array" + } + }, + "type": "object" + }, + "SbomReferenceIntotoPredicate": { + "description": "A predicate which describes the SBOM being referenced.", + "id": "SbomReferenceIntotoPredicate", + "properties": { + "digest": { + "additionalProperties": { + "type": "string" + }, + "description": "A map of algorithm to digest of the contents of the SBOM.", + "type": "object" + }, + "location": { + "description": "The location of the SBOM.", + "type": "string" + }, + "mimeType": { + "description": "The mime type of the SBOM.", + "type": "string" + }, + "referrerId": { + "description": "The person or system referring this predicate to the consumer.", + "type": "string" + } + }, + "type": "object" + }, "SetIamPolicyRequest": { "description": "Request message for `SetIamPolicy` method.", "id": "SetIamPolicyRequest", diff --git a/containeranalysis/v1/containeranalysis-gen.go b/containeranalysis/v1/containeranalysis-gen.go index 1b516f00660..2adc5edbdbb 100644 --- a/containeranalysis/v1/containeranalysis-gen.go +++ b/containeranalysis/v1/containeranalysis-gen.go @@ -142,7 +142,6 @@ func NewProjectsService(s *Service) *ProjectsService { rs := &ProjectsService{s: s} rs.Notes = NewProjectsNotesService(s) rs.Occurrences = NewProjectsOccurrencesService(s) - rs.Resources = NewProjectsResourcesService(s) return rs } @@ -152,8 +151,6 @@ type ProjectsService struct { Notes *ProjectsNotesService Occurrences *ProjectsOccurrencesService - - Resources *ProjectsResourcesService } func NewProjectsNotesService(s *Service) *ProjectsNotesService { @@ -186,15 +183,6 @@ type ProjectsOccurrencesService struct { s *Service } -func NewProjectsResourcesService(s *Service) *ProjectsResourcesService { - rs := &ProjectsResourcesService{s: s} - return rs -} - -type ProjectsResourcesService struct { - s *Service -} - // AliasContext: An alias to a repo revision. type AliasContext struct { // Kind: The alias kind. @@ -3587,6 +3575,7 @@ type DiscoveryNote struct { // "DSSE_ATTESTATION" - This represents a DSSE attestation Note // "VULNERABILITY_ASSESSMENT" - This represents a Vulnerability // Assessment. + // "SBOM_REFERENCE" - This represents an SBOM Reference. AnalysisKind string `json:"analysisKind,omitempty"` // ForceSendFields is a list of field names (e.g. "AnalysisKind") to @@ -3986,12 +3975,6 @@ func (s *FixableTotalByDigest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GeneratePackagesSummaryRequest: GeneratePackagesSummaryRequest is the -// request body for the GeneratePackagesSummary API method. It just -// takes a single name argument, referring to the resource. -type GeneratePackagesSummaryRequest struct { -} - // GerritSourceContext: A SourceContext referring to a Gerrit project. type GerritSourceContext struct { // AliasContext: An alias, which may be a branch or tag. @@ -4834,40 +4817,6 @@ func (s *License) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// LicensesSummary: Per license count -type LicensesSummary struct { - // Count: The number of fixable vulnerabilities associated with this - // resource. - Count int64 `json:"count,omitempty,string"` - - // License: The license of the package. Note that the format of this - // value is not guaranteed. It may be nil, an empty string, a boolean - // value (A | B), a differently formed boolean value (A OR B), etc... - License string `json:"license,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Count") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Count") to include in API - // requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *LicensesSummary) MarshalJSON() ([]byte, error) { - type NoMethod LicensesSummary - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // ListNoteOccurrencesResponse: Response for listing occurrences for a // note. type ListNoteOccurrencesResponse struct { @@ -5180,6 +5129,7 @@ type Note struct { // "DSSE_ATTESTATION" - This represents a DSSE attestation Note // "VULNERABILITY_ASSESSMENT" - This represents a Vulnerability // Assessment. + // "SBOM_REFERENCE" - This represents an SBOM Reference. Kind string `json:"kind,omitempty"` // LongDescription: A detailed description of this note. @@ -5199,6 +5149,9 @@ type Note struct { // RelatedUrl: URLs associated with this note. RelatedUrl []*RelatedUrl `json:"relatedUrl,omitempty"` + // SbomReference: A note describing an SBOM reference. + SbomReference *SBOMReferenceNote `json:"sbomReference,omitempty"` + // ShortDescription: A one sentence description of this note. ShortDescription string `json:"shortDescription,omitempty"` @@ -5296,6 +5249,7 @@ type Occurrence struct { // "DSSE_ATTESTATION" - This represents a DSSE attestation Note // "VULNERABILITY_ASSESSMENT" - This represents a Vulnerability // Assessment. + // "SBOM_REFERENCE" - This represents an SBOM Reference. Kind string `json:"kind,omitempty"` // Name: Output only. The name of the occurrence in the form of @@ -5320,6 +5274,9 @@ type Occurrence struct { // `https://gcr.io/project/image@sha256:123abc` for a Docker image. ResourceUri string `json:"resourceUri,omitempty"` + // SbomReference: Describes a specific SBOM reference occurrences. + SbomReference *SBOMReferenceOccurrence `json:"sbomReference,omitempty"` + // UpdateTime: Output only. The time this occurrence was last updated. UpdateTime string `json:"updateTime,omitempty"` @@ -5566,45 +5523,6 @@ func (s *PackageOccurrence) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// PackagesSummaryResponse: A summary of the packages found within the -// given resource. -type PackagesSummaryResponse struct { - // LicensesSummary: A listing by license name of each of the licenses - // and their counts. - LicensesSummary []*LicensesSummary `json:"licensesSummary,omitempty"` - - // ResourceUrl: The unique URL of the image or the container for which - // this summary applies. - ResourceUrl string `json:"resourceUrl,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the - // server. - googleapi.ServerResponse `json:"-"` - - // ForceSendFields is a list of field names (e.g. "LicensesSummary") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "LicensesSummary") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the - // server as null. It is an error if a field in this list has a - // non-empty value. This may be used to include null fields in Patch - // requests. - NullFields []string `json:"-"` -} - -func (s *PackagesSummaryResponse) MarshalJSON() ([]byte, error) { - type NoMethod PackagesSummaryResponse - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // Policy: An Identity and Access Management (IAM) policy, which // specifies access controls for Google Cloud resources. A `Policy` is a // collection of `bindings`. A `binding` binds one or more `members`, or @@ -5991,6 +5909,161 @@ func (s *RepoId) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// SBOMReferenceNote: The note representing an SBOM reference. +type SBOMReferenceNote struct { + // Format: The format that SBOM takes. E.g. may be spdx, cyclonedx, + // etc... + Format string `json:"format,omitempty"` + + // Version: The version of the format that the SBOM takes. E.g. if the + // format is spdx, the version may be 2.3. + Version string `json:"version,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Format") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Format") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *SBOMReferenceNote) MarshalJSON() ([]byte, error) { + type NoMethod SBOMReferenceNote + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// SBOMReferenceOccurrence: The occurrence representing an SBOM +// reference as applied to a specific resource. The occurrence follows +// the DSSE specification. See +// https://github.com/secure-systems-lab/dsse/blob/master/envelope.md +// for more details. +type SBOMReferenceOccurrence struct { + // Payload: The actual payload that contains the SBOM reference data. + Payload *SbomReferenceIntotoPayload `json:"payload,omitempty"` + + // PayloadType: The kind of payload that SbomReferenceIntotoPayload + // takes. Since it's in the intoto format, this value is expected to be + // 'application/vnd.in-toto+json'. + PayloadType string `json:"payloadType,omitempty"` + + // Signatures: The signatures over the payload. + Signatures []*EnvelopeSignature `json:"signatures,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Payload") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Payload") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *SBOMReferenceOccurrence) MarshalJSON() ([]byte, error) { + type NoMethod SBOMReferenceOccurrence + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// SbomReferenceIntotoPayload: The actual payload that contains the SBOM +// Reference data. The payload follows the intoto statement +// specification. See +// https://github.com/in-toto/attestation/blob/main/spec/v1.0/statement.md +// for more details. +type SbomReferenceIntotoPayload struct { + // Type: Identifier for the schema of the Statement. + Type string `json:"_type,omitempty"` + + // Predicate: Additional parameters of the Predicate. Includes the + // actual data about the SBOM. + Predicate *SbomReferenceIntotoPredicate `json:"predicate,omitempty"` + + // PredicateType: URI identifying the type of the Predicate. + PredicateType string `json:"predicateType,omitempty"` + + // Subject: Set of software artifacts that the attestation applies to. + // Each element represents a single software artifact. + Subject []*Subject `json:"subject,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Type") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *SbomReferenceIntotoPayload) MarshalJSON() ([]byte, error) { + type NoMethod SbomReferenceIntotoPayload + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// SbomReferenceIntotoPredicate: A predicate which describes the SBOM +// being referenced. +type SbomReferenceIntotoPredicate struct { + // Digest: A map of algorithm to digest of the contents of the SBOM. + Digest map[string]string `json:"digest,omitempty"` + + // Location: The location of the SBOM. + Location string `json:"location,omitempty"` + + // MimeType: The mime type of the SBOM. + MimeType string `json:"mimeType,omitempty"` + + // ReferrerId: The person or system referring this predicate to the + // consumer. + ReferrerId string `json:"referrerId,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Digest") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Digest") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *SbomReferenceIntotoPredicate) MarshalJSON() ([]byte, error) { + type NoMethod SbomReferenceIntotoPredicate + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SetIamPolicyRequest: Request message for `SetIamPolicy` method. type SetIamPolicyRequest struct { // Policy: REQUIRED: The complete policy to be applied to the @@ -10556,147 +10629,3 @@ func (c *ProjectsOccurrencesTestIamPermissionsCall) Do(opts ...googleapi.CallOpt // } } - -// method id "containeranalysis.projects.resources.generatePackagesSummary": - -type ProjectsResourcesGeneratePackagesSummaryCall struct { - s *Service - name string - generatepackagessummaryrequest *GeneratePackagesSummaryRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// GeneratePackagesSummary: Gets a summary of the packages within a -// given resource. -// -// - name: The name of the resource to get a packages summary for in the -// form of `projects/[PROJECT_ID]/resources/[RESOURCE_URL]`. -func (r *ProjectsResourcesService) GeneratePackagesSummary(name string, generatepackagessummaryrequest *GeneratePackagesSummaryRequest) *ProjectsResourcesGeneratePackagesSummaryCall { - c := &ProjectsResourcesGeneratePackagesSummaryCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.generatepackagessummaryrequest = generatepackagessummaryrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse -// for more information. -func (c *ProjectsResourcesGeneratePackagesSummaryCall) Fields(s ...googleapi.Field) *ProjectsResourcesGeneratePackagesSummaryCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. Any -// pending HTTP request will be aborted if the provided context is -// canceled. -func (c *ProjectsResourcesGeneratePackagesSummaryCall) Context(ctx context.Context) *ProjectsResourcesGeneratePackagesSummaryCall { - c.ctx_ = ctx - return c -} - -// Header returns an http.Header that can be modified by the caller to -// add HTTP headers to the request. -func (c *ProjectsResourcesGeneratePackagesSummaryCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsResourcesGeneratePackagesSummaryCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) - for k, v := range c.header_ { - reqHeaders[k] = v - } - reqHeaders.Set("User-Agent", c.s.userAgent()) - var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.generatepackagessummaryrequest) - if err != nil { - return nil, err - } - reqHeaders.Set("Content-Type", "application/json") - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:generatePackagesSummary") - 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, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "containeranalysis.projects.resources.generatePackagesSummary" call. -// Exactly one of *PackagesSummaryResponse or error will be non-nil. Any -// non-2xx status code is an error. Response headers are in either -// *PackagesSummaryResponse.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 *ProjectsResourcesGeneratePackagesSummaryCall) Do(opts ...googleapi.CallOption) (*PackagesSummaryResponse, 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 := &PackagesSummaryResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - if err := gensupport.DecodeResponse(target, res); err != nil { - return nil, err - } - return ret, nil - // { - // "description": "Gets a summary of the packages within a given resource.", - // "flatPath": "v1/projects/{projectsId}/resources/{resourcesId}:generatePackagesSummary", - // "httpMethod": "POST", - // "id": "containeranalysis.projects.resources.generatePackagesSummary", - // "parameterOrder": [ - // "name" - // ], - // "parameters": { - // "name": { - // "description": "Required. The name of the resource to get a packages summary for in the form of `projects/[PROJECT_ID]/resources/[RESOURCE_URL]`.", - // "location": "path", - // "pattern": "^projects/[^/]+/resources/.*$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v1/{+name}:generatePackagesSummary", - // "request": { - // "$ref": "GeneratePackagesSummaryRequest" - // }, - // "response": { - // "$ref": "PackagesSummaryResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} diff --git a/containeranalysis/v1beta1/containeranalysis-api.json b/containeranalysis/v1beta1/containeranalysis-api.json index 274aa30ff80..367e200c684 100644 --- a/containeranalysis/v1beta1/containeranalysis-api.json +++ b/containeranalysis/v1beta1/containeranalysis-api.json @@ -751,11 +751,43 @@ ] } } + }, + "resources": { + "methods": { + "generatePackagesSummary": { + "description": "Gets a summary of the packages within a given resource.", + "flatPath": "v1beta1/projects/{projectsId}/resources/{resourcesId}:generatePackagesSummary", + "httpMethod": "POST", + "id": "containeranalysis.projects.resources.generatePackagesSummary", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the resource to get a packages summary for in the form of `projects/[PROJECT_ID]/resources/[RESOURCE_URL]`.", + "location": "path", + "pattern": "^projects/[^/]+/resources/.*$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}:generatePackagesSummary", + "request": { + "$ref": "GeneratePackagesSummaryRequest" + }, + "response": { + "$ref": "PackagesSummaryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } } } } }, - "revision": "20230414", + "revision": "20230505", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AliasContext": { @@ -3511,6 +3543,12 @@ }, "type": "object" }, + "GeneratePackagesSummaryRequest": { + "description": "GeneratePackagesSummaryRequest is the request body for the GeneratePackagesSummary API method. It just takes a single name argument, referring to the resource.", + "id": "GeneratePackagesSummaryRequest", + "properties": {}, + "type": "object" + }, "GenericSignedAttestation": { "description": "An attestation wrapper that uses the Grafeas `Signature` message. This attestation must define the `serialized_payload` that the `signatures` verify and any metadata necessary to interpret that plaintext. The signatures should always be over the `serialized_payload` bytestring.", "id": "GenericSignedAttestation", @@ -4073,6 +4111,22 @@ }, "type": "object" }, + "LicensesSummary": { + "description": "Per license count", + "id": "LicensesSummary", + "properties": { + "count": { + "description": "The number of fixable vulnerabilities associated with this resource.", + "format": "int64", + "type": "string" + }, + "license": { + "description": "The license of the package. Note that the format of this value is not guaranteed. It may be nil, an empty string, a boolean value (A | B), a differently formed boolean value (A OR B), etc...", + "type": "string" + } + }, + "type": "object" + }, "Link": { "description": "This corresponds to an in-toto link.", "id": "Link", @@ -4695,6 +4749,24 @@ }, "type": "object" }, + "PackagesSummaryResponse": { + "description": "A summary of the packages found within the given resource.", + "id": "PackagesSummaryResponse", + "properties": { + "licensesSummary": { + "description": "A listing by license name of each of the licenses and their counts.", + "items": { + "$ref": "LicensesSummary" + }, + "type": "array" + }, + "resourceUrl": { + "description": "The unique URL of the image or the container for which this summary applies.", + "type": "string" + } + }, + "type": "object" + }, "PgpSignedAttestation": { "description": "An attestation wrapper with a PGP-compatible signature. This message only supports `ATTACHED` signatures, where the payload that is signed is included alongside the signature itself in the same file.", "id": "PgpSignedAttestation", diff --git a/containeranalysis/v1beta1/containeranalysis-gen.go b/containeranalysis/v1beta1/containeranalysis-gen.go index 83789040919..c582cfc537d 100644 --- a/containeranalysis/v1beta1/containeranalysis-gen.go +++ b/containeranalysis/v1beta1/containeranalysis-gen.go @@ -142,6 +142,7 @@ func NewProjectsService(s *Service) *ProjectsService { rs := &ProjectsService{s: s} rs.Notes = NewProjectsNotesService(s) rs.Occurrences = NewProjectsOccurrencesService(s) + rs.Resources = NewProjectsResourcesService(s) return rs } @@ -151,6 +152,8 @@ type ProjectsService struct { Notes *ProjectsNotesService Occurrences *ProjectsOccurrencesService + + Resources *ProjectsResourcesService } func NewProjectsNotesService(s *Service) *ProjectsNotesService { @@ -183,6 +186,15 @@ type ProjectsOccurrencesService struct { s *Service } +func NewProjectsResourcesService(s *Service) *ProjectsResourcesService { + rs := &ProjectsResourcesService{s: s} + return rs +} + +type ProjectsResourcesService struct { + s *Service +} + // AliasContext: An alias to a repo revision. type AliasContext struct { // Kind: The alias kind. @@ -4117,6 +4129,12 @@ func (s *FixableTotalByDigest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GeneratePackagesSummaryRequest: GeneratePackagesSummaryRequest is the +// request body for the GeneratePackagesSummary API method. It just +// takes a single name argument, referring to the resource. +type GeneratePackagesSummaryRequest struct { +} + // GenericSignedAttestation: An attestation wrapper that uses the // Grafeas `Signature` message. This attestation must define the // `serialized_payload` that the `signatures` verify and any metadata @@ -5061,6 +5079,40 @@ func (s *License) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// LicensesSummary: Per license count +type LicensesSummary struct { + // Count: The number of fixable vulnerabilities associated with this + // resource. + Count int64 `json:"count,omitempty,string"` + + // License: The license of the package. Note that the format of this + // value is not guaranteed. It may be nil, an empty string, a boolean + // value (A | B), a differently formed boolean value (A OR B), etc... + License string `json:"license,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Count") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Count") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *LicensesSummary) MarshalJSON() ([]byte, error) { + type NoMethod LicensesSummary + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Link: This corresponds to an in-toto link. type Link struct { // Byproducts: ByProducts are data generated as part of a software @@ -5813,6 +5865,45 @@ func (s *PackageIssue) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// PackagesSummaryResponse: A summary of the packages found within the +// given resource. +type PackagesSummaryResponse struct { + // LicensesSummary: A listing by license name of each of the licenses + // and their counts. + LicensesSummary []*LicensesSummary `json:"licensesSummary,omitempty"` + + // ResourceUrl: The unique URL of the image or the container for which + // this summary applies. + ResourceUrl string `json:"resourceUrl,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "LicensesSummary") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "LicensesSummary") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *PackagesSummaryResponse) MarshalJSON() ([]byte, error) { + type NoMethod PackagesSummaryResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // PgpSignedAttestation: An attestation wrapper with a PGP-compatible // signature. This message only supports `ATTACHED` signatures, where // the payload that is signed is included alongside the signature itself @@ -10747,3 +10838,147 @@ func (c *ProjectsOccurrencesTestIamPermissionsCall) Do(opts ...googleapi.CallOpt // } } + +// method id "containeranalysis.projects.resources.generatePackagesSummary": + +type ProjectsResourcesGeneratePackagesSummaryCall struct { + s *Service + name string + generatepackagessummaryrequest *GeneratePackagesSummaryRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// GeneratePackagesSummary: Gets a summary of the packages within a +// given resource. +// +// - name: The name of the resource to get a packages summary for in the +// form of `projects/[PROJECT_ID]/resources/[RESOURCE_URL]`. +func (r *ProjectsResourcesService) GeneratePackagesSummary(name string, generatepackagessummaryrequest *GeneratePackagesSummaryRequest) *ProjectsResourcesGeneratePackagesSummaryCall { + c := &ProjectsResourcesGeneratePackagesSummaryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.generatepackagessummaryrequest = generatepackagessummaryrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsResourcesGeneratePackagesSummaryCall) Fields(s ...googleapi.Field) *ProjectsResourcesGeneratePackagesSummaryCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsResourcesGeneratePackagesSummaryCall) Context(ctx context.Context) *ProjectsResourcesGeneratePackagesSummaryCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsResourcesGeneratePackagesSummaryCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsResourcesGeneratePackagesSummaryCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.generatepackagessummaryrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:generatePackagesSummary") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "containeranalysis.projects.resources.generatePackagesSummary" call. +// Exactly one of *PackagesSummaryResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *PackagesSummaryResponse.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 *ProjectsResourcesGeneratePackagesSummaryCall) Do(opts ...googleapi.CallOption) (*PackagesSummaryResponse, 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 := &PackagesSummaryResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets a summary of the packages within a given resource.", + // "flatPath": "v1beta1/projects/{projectsId}/resources/{resourcesId}:generatePackagesSummary", + // "httpMethod": "POST", + // "id": "containeranalysis.projects.resources.generatePackagesSummary", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The name of the resource to get a packages summary for in the form of `projects/[PROJECT_ID]/resources/[RESOURCE_URL]`.", + // "location": "path", + // "pattern": "^projects/[^/]+/resources/.*$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta1/{+name}:generatePackagesSummary", + // "request": { + // "$ref": "GeneratePackagesSummaryRequest" + // }, + // "response": { + // "$ref": "PackagesSummaryResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} diff --git a/content/v2.1/content-api.json b/content/v2.1/content-api.json index 0145024ef9f..4c45eb92b49 100644 --- a/content/v2.1/content-api.json +++ b/content/v2.1/content-api.json @@ -6225,7 +6225,7 @@ } } }, - "revision": "20230328", + "revision": "20230503", "rootUrl": "https://shoppingcontent.googleapis.com/", "schemas": { "Account": { @@ -8747,7 +8747,7 @@ "properties": { "cutoffTime": { "$ref": "CutoffTime", - "description": "Business days cutoff time definition. If not configured the cutoff time will be defaulted to 8AM PST." + "description": "Business days cutoff time definition. If not configured the cutoff time will be defaulted to 8AM PST. If local delivery, use Service.StoreConfig.CutoffConfig." }, "handlingBusinessDayConfig": { "$ref": "BusinessDayConfig", @@ -8798,6 +8798,22 @@ }, "type": "object" }, + "Distance": { + "description": "Distance represented by an integer and unit.", + "id": "Distance", + "properties": { + "unit": { + "description": "The distance unit. Acceptable values are `None`, `Miles`, and `Kilometers`.", + "type": "string" + }, + "value": { + "description": "The distance represented as a number.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "ECommercePlatformLinkInfo": { "description": "Additional information required for E_COMMERCE_PLATFORM link type.", "id": "ECommercePlatformLinkInfo", @@ -10154,7 +10170,7 @@ "type": "object" }, "MethodQuota": { - "description": "The quota information per method in the Content API. Includes only methods with current usage greater than zero for your account.", + "description": "The quota information per method in the Content API.", "id": "MethodQuota", "properties": { "method": { @@ -13315,6 +13331,10 @@ "description": "Description of the item.", "type": "string" }, + "disclosureDate": { + "description": "The date time when an offer becomes visible in search results across Google’s YouTube surfaces, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. See [Disclosure date]( https://support.google.com/merchants/answer/13034208) for more information.", + "type": "string" + }, "displayAdsId": { "description": "An identifier for an item for dynamic remarketing campaigns.", "type": "string" @@ -13998,7 +14018,7 @@ "type": "array" }, "status": { - "description": "Destination approval status in `targetCountry` of the offer.", + "description": "Deprecated. Destination approval status in `targetCountry` of the offer.", "type": "string" } }, @@ -14368,6 +14388,10 @@ "canonicalAttribute": { "description": "Canonical attribute name for attribute-specific issues.", "type": "string" + }, + "code": { + "description": "Error code of the issue.", + "type": "string" } }, "type": "object" @@ -16753,7 +16777,70 @@ "type": "array" }, "shipmentType": { - "description": "Type of locations this service ships orders to. Acceptable values are: - \"`delivery`\" - \"`pickup`\" ", + "description": "Type of locations this service ships orders to. Acceptable values are: - \"`delivery`\" - \"`pickup`\" - \"`local_delivery`\" ", + "type": "string" + }, + "storeConfig": { + "$ref": "ServiceStoreConfig", + "description": "A list of stores your products are delivered from. This is only available for the local delivery shipment type." + } + }, + "type": "object" + }, + "ServiceStoreConfig": { + "description": "Stores that provide local delivery. Only valid with local delivery fulfillment.", + "id": "ServiceStoreConfig", + "properties": { + "cutoffConfig": { + "$ref": "ServiceStoreConfigCutoffConfig", + "description": "Time local delivery ends for the day. This can be either `local_cutoff_time` or `store_close_offset_hours`, if both are provided an error is thrown." + }, + "serviceRadius": { + "$ref": "Distance", + "description": "Maximum delivery radius. Only needed for local delivery fulfillment type." + }, + "storeCodes": { + "description": "A list of store codes that provide local delivery. If empty, then `store_service_type` must be `all_stores`, or an error is thrown. If not empty, then `store_service_type` must be `selected_stores`, or an error is thrown.", + "items": { + "type": "string" + }, + "type": "array" + }, + "storeServiceType": { + "description": "Indicates whether all stores listed by this merchant provide local delivery or not. Acceptable values are `all stores` and `selected stores`", + "type": "string" + } + }, + "type": "object" + }, + "ServiceStoreConfigCutoffConfig": { + "description": "Time local delivery ends for the day based on the local timezone of the store. `local_cutoff_time` and `store_close_offset_hours` are mutually exclusive.", + "id": "ServiceStoreConfigCutoffConfig", + "properties": { + "localCutoffTime": { + "$ref": "ServiceStoreConfigCutoffConfigLocalCutoffTime", + "description": "Time in hours and minutes in the local timezone when local delivery ends." + }, + "storeCloseOffsetHours": { + "description": "Represents cutoff time as the number of hours before store closing. Mutually exclusive with other fields (hour and minute).", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "ServiceStoreConfigCutoffConfigLocalCutoffTime": { + "description": "Time in hours and minutes in the local timezone when local delivery ends.", + "id": "ServiceStoreConfigCutoffConfigLocalCutoffTime", + "properties": { + "hour": { + "description": "Hour local delivery orders must be placed by to process the same day.", + "format": "int64", + "type": "string" + }, + "minute": { + "description": "Minute local delivery orders must be placed by to process the same day.", + "format": "int64", "type": "string" } }, diff --git a/content/v2.1/content-gen.go b/content/v2.1/content-gen.go index 24c9e3df202..13c9d4798d2 100644 --- a/content/v2.1/content-gen.go +++ b/content/v2.1/content-gen.go @@ -4820,7 +4820,8 @@ func (s *DeliveryAreaPostalCodeRange) MarshalJSON() ([]byte, error) { type DeliveryTime struct { // CutoffTime: Business days cutoff time definition. If not configured - // the cutoff time will be defaulted to 8AM PST. + // the cutoff time will be defaulted to 8AM PST. If local delivery, use + // Service.StoreConfig.CutoffConfig. CutoffTime *CutoffTime `json:"cutoffTime,omitempty"` // HandlingBusinessDayConfig: The business days during which orders can @@ -4893,6 +4894,38 @@ func (s *DeliveryTime) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// Distance: Distance represented by an integer and unit. +type Distance struct { + // Unit: The distance unit. Acceptable values are `None`, `Miles`, and + // `Kilometers`. + Unit string `json:"unit,omitempty"` + + // Value: The distance represented as a number. + Value int64 `json:"value,omitempty,string"` + + // ForceSendFields is a list of field names (e.g. "Unit") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Unit") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Distance) MarshalJSON() ([]byte, error) { + type NoMethod Distance + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ECommercePlatformLinkInfo: Additional information required for // E_COMMERCE_PLATFORM link type. type ECommercePlatformLinkInfo struct { @@ -7305,8 +7338,6 @@ func (s *MerchantRejectionReason) MarshalJSON() ([]byte, error) { } // MethodQuota: The quota information per method in the Content API. -// Includes only methods with current usage greater than zero for your -// account. type MethodQuota struct { // Method: The method name, for example `products.list`. Method name // does not contain version because quota can be shared between @@ -12823,6 +12854,13 @@ type Product struct { // Description: Description of the item. Description string `json:"description,omitempty"` + // DisclosureDate: The date time when an offer becomes visible in search + // results across Google’s YouTube surfaces, in ISO 8601 + // (http://en.wikipedia.org/wiki/ISO_8601) format. See Disclosure date ( + // https://support.google.com/merchants/answer/13034208) for more + // information. + DisclosureDate string `json:"disclosureDate,omitempty"` + // DisplayAdsId: An identifier for an item for dynamic remarketing // campaigns. DisplayAdsId string `json:"displayAdsId,omitempty"` @@ -13750,7 +13788,8 @@ type ProductStatusDestinationStatus struct { // the offer is pending approval. PendingCountries []string `json:"pendingCountries,omitempty"` - // Status: Destination approval status in `targetCountry` of the offer. + // Status: Deprecated. Destination approval status in `targetCountry` of + // the offer. Status string `json:"status,omitempty"` // ForceSendFields is a list of field names (e.g. "ApprovedCountries") @@ -14275,6 +14314,9 @@ type ProductViewItemIssueItemIssueType struct { // issues. CanonicalAttribute string `json:"canonicalAttribute,omitempty"` + // Code: Error code of the issue. + Code string `json:"code,omitempty"` + // ForceSendFields is a list of field names (e.g. "CanonicalAttribute") // to unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -18021,9 +18063,14 @@ type Service struct { RateGroups []*RateGroup `json:"rateGroups,omitempty"` // ShipmentType: Type of locations this service ships orders to. - // Acceptable values are: - "delivery" - "pickup" + // Acceptable values are: - "delivery" - "pickup" - + // "local_delivery" ShipmentType string `json:"shipmentType,omitempty"` + // StoreConfig: A list of stores your products are delivered from. This + // is only available for the local delivery shipment type. + StoreConfig *ServiceStoreConfig `json:"storeConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "Active") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -18047,6 +18094,123 @@ func (s *Service) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ServiceStoreConfig: Stores that provide local delivery. Only valid +// with local delivery fulfillment. +type ServiceStoreConfig struct { + // CutoffConfig: Time local delivery ends for the day. This can be + // either `local_cutoff_time` or `store_close_offset_hours`, if both are + // provided an error is thrown. + CutoffConfig *ServiceStoreConfigCutoffConfig `json:"cutoffConfig,omitempty"` + + // ServiceRadius: Maximum delivery radius. Only needed for local + // delivery fulfillment type. + ServiceRadius *Distance `json:"serviceRadius,omitempty"` + + // StoreCodes: A list of store codes that provide local delivery. If + // empty, then `store_service_type` must be `all_stores`, or an error is + // thrown. If not empty, then `store_service_type` must be + // `selected_stores`, or an error is thrown. + StoreCodes []string `json:"storeCodes,omitempty"` + + // StoreServiceType: Indicates whether all stores listed by this + // merchant provide local delivery or not. Acceptable values are `all + // stores` and `selected stores` + StoreServiceType string `json:"storeServiceType,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CutoffConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CutoffConfig") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ServiceStoreConfig) MarshalJSON() ([]byte, error) { + type NoMethod ServiceStoreConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ServiceStoreConfigCutoffConfig: Time local delivery ends for the day +// based on the local timezone of the store. `local_cutoff_time` and +// `store_close_offset_hours` are mutually exclusive. +type ServiceStoreConfigCutoffConfig struct { + // LocalCutoffTime: Time in hours and minutes in the local timezone when + // local delivery ends. + LocalCutoffTime *ServiceStoreConfigCutoffConfigLocalCutoffTime `json:"localCutoffTime,omitempty"` + + // StoreCloseOffsetHours: Represents cutoff time as the number of hours + // before store closing. Mutually exclusive with other fields (hour and + // minute). + StoreCloseOffsetHours int64 `json:"storeCloseOffsetHours,omitempty,string"` + + // ForceSendFields is a list of field names (e.g. "LocalCutoffTime") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "LocalCutoffTime") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *ServiceStoreConfigCutoffConfig) MarshalJSON() ([]byte, error) { + type NoMethod ServiceStoreConfigCutoffConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ServiceStoreConfigCutoffConfigLocalCutoffTime: Time in hours and +// minutes in the local timezone when local delivery ends. +type ServiceStoreConfigCutoffConfigLocalCutoffTime struct { + // Hour: Hour local delivery orders must be placed by to process the + // same day. + Hour int64 `json:"hour,omitempty,string"` + + // Minute: Minute local delivery orders must be placed by to process the + // same day. + Minute int64 `json:"minute,omitempty,string"` + + // ForceSendFields is a list of field names (e.g. "Hour") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Hour") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ServiceStoreConfigCutoffConfigLocalCutoffTime) MarshalJSON() ([]byte, error) { + type NoMethod ServiceStoreConfigCutoffConfigLocalCutoffTime + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SettlementReport: Settlement reports detail order-level and // item-level credits and debits between you and Google. type SettlementReport struct { diff --git a/contentwarehouse/v1/contentwarehouse-api.json b/contentwarehouse/v1/contentwarehouse-api.json index 7b7ee255c1f..eb4e882a7fb 100644 --- a/contentwarehouse/v1/contentwarehouse-api.json +++ b/contentwarehouse/v1/contentwarehouse-api.json @@ -1103,7 +1103,7 @@ } } }, - "revision": "20230415", + "revision": "20230503", "rootUrl": "https://contentwarehouse.googleapis.com/", "schemas": { "AbuseiamAbuseType": { @@ -1190,7 +1190,7 @@ "Other misc country-specific laws", "Local privacy laws", "Internal type to check es content against", - "the ocelot blacklist. Internal type.", + "the ocelot blocklist. Internal type.", "Consistent harassing behaviour directed", "towards a person. Hijacked or Compromised profile.", "Low quality/Annoying content.", @@ -2937,6 +2937,60 @@ }, "type": "object" }, + "AppsDynamiteSharedSegmentedMembershipCount": { + "description": "Contains info on membership count for member types: HUMAN_USER, APP_USER \u0026 ROSTER_MEMBER different states: INVITED, JOINED", + "id": "AppsDynamiteSharedSegmentedMembershipCount", + "properties": { + "memberType": { + "enum": [ + "MEMBER_TYPE_UNSPECIFIED", + "HUMAN_USER", + "ROSTER_MEMBER" + ], + "enumDescriptions": [ + "default value", + "member is a human user", + "member is a roster" + ], + "type": "string" + }, + "membershipCount": { + "description": "count of members with given type and state", + "format": "int32", + "type": "integer" + }, + "membershipState": { + "enum": [ + "MEMBER_UNKNOWN", + "MEMBER_INVITED", + "MEMBER_JOINED", + "MEMBER_NOT_A_MEMBER", + "MEMBER_FAILED" + ], + "enumDescriptions": [ + "Default state, do not use", + "An invitation to the space has been sent", + "User has joined the space", + "User is not a member", + "This state should never be stored in Spanner. It is a state for responses to the clients to indicate that membership mutations have failed and the member is in its previous state." + ], + "type": "string" + } + }, + "type": "object" + }, + "AppsDynamiteSharedSegmentedMembershipCounts": { + "id": "AppsDynamiteSharedSegmentedMembershipCounts", + "properties": { + "value": { + "items": { + "$ref": "AppsDynamiteSharedSegmentedMembershipCount" + }, + "type": "array" + } + }, + "type": "object" + }, "AppsPeopleActivityBackendDestinationStream": { "description": "A DestinationStream is a /namespace/id[0]/id[1]/.../id[n] that represents a collection of Activities. Example destinations: -The Profile Stream on http://plus.google.com/+JohnDoe/posts -A Square Stream on http://plus.google.com/squares/123 -A \"comment Stream\" (Fountain) on http://www.youtube.com/watch?id=123 It's possible for a single Activity to show in each of these destinations - and it might behave/look slightly differently for each one. Destinations can have their own business logic associated with them at both write-time and read-time server-side (these are documented below). Each DestinationStream is indexed and can be retrieved using the GetDestinationStreamRequest. For the repeated ID space indexing happens at all levels, e.g. if you have: /square/123/abc /square/123/efd /square/456 You can fetch /square/123/abc directly or /square/123 (which includes all Activities in both /square/123/abc and /square/123/efd), or even /square which retrieves all Activities in the Square namespace (visible for that user). On the storage layer, we represent DestinationStream as Channel (http://cs/#google3/social/common/channel/channel.proto), since the storage does not have the concept of a Stream. Both terms are used interchangeably within the service layer, but client of Social Infrastructure should use the term DestinationStream. Next ID: 3", "id": "AppsPeopleActivityBackendDestinationStream", @@ -3570,7 +3624,10 @@ "LEGAL_CONTRACTS_EXTERNAL_AFFINITY", "CONTACTS_TO_STAR_AFFINITY", "DECS_AFFINITY", - "GSOX_MOCHI_AFFINITY" + "GSOX_MOCHI_AFFINITY", + "MEET_AFFINITY", + "PMW_TI_AFFINITY", + "DRIVE_SEARCH_FILTER_PERSON_ONLY" ], "enumDescriptions": [ "", @@ -3819,6 +3876,9 @@ "", "", "", + "", + "", + "", "" ], "type": "string" @@ -5531,7 +5591,7 @@ "type": "object" }, "AppsPeopleOzExternalMergedpeopleapiInAppReachability": { - "description": "This is deprecated in PEOPLE_API/SHARPEN, and should only be used for PROFILES. Which apps the person has indicated they are reachable at for the requester. See go/d13y and com.google.focus.proto.InAppReachability.", + "description": "This is deprecated in PEOPLE_API/SHARPEN, and should only be used for PROFILES. Clients should use InAppNotificationTarget field instead. Which apps the person has indicated they are reachable at for the requester. See go/d13y and com.google.focus.proto.InAppReachability.", "id": "AppsPeopleOzExternalMergedpeopleapiInAppReachability", "properties": { "appType": { @@ -9681,6 +9741,64 @@ "WIFI_ADD_NETWORK_QR_CODE", "WIFI_CALLING", "WIFI_HOTSPOT", + "ACCESSIBILITY_SELECT_TO_SPEAK", + "CRISIS_ALERTS", + "REGULATORY_LABELS", + "SEND_FEEDBACK", + "OS_BUILD_NUMBER", + "ACCESSIBILITY_SHORTCUTS", + "ACCESSIBILITY_MENU", + "ACCESSIBILITY_SOUND_AMPLIFIER", + "ACCESSIBILITY_LIVE_TRANSCRIBE", + "ACCESSIBILITY_SOUND_NOTIFICATIONS", + "ACCESSIBILITY_TALKBACK", + "ACCESSIBILITY_TIMEOUT", + "CAMERA_SETTINGS", + "BATTERY_SAVER_TOGGLE", + "COVID_NOTIFICATIONS", + "APP_LOCATION", + "LOCATION_SERVICES", + "PRIVATE_DNS", + "UNRESTRICTED_DATA", + "PREFERRED_NETWORK", + "NETWORK_PREFERENCES", + "PASSWORDS_AND_ACCOUNTS", + "PRIVACY_DASHBOARD", + "MORE_SECURITY", + "APP_PINNING", + "CONFIRM_SIM_DELETION", + "ENCRYPT_PHONE", + "FACE_UNLOCK", + "INSTALL_UNKNOWN_APPS", + "NOW_PLAYING", + "STAY_AWAKE", + "ASSISTANT_VOICE", + "RESET_BLUETOOTH_WIFI", + "DEFAULT_PHONE_APP", + "GOOGLE_ACCOUNT", + "ACCESSIBILITY_CAPTION_SIZE_AND_STYLE", + "ACCESSIBILITY_CAPTION_STYLE", + "ACCESSIBILITY_CAPTION_TEXT", + "ACCESSIBILITY_CAPTION_PREFERENCES", + "ACCESSIBILITY_COLOR_AND_MOTION", + "ACCESSIBILITY_BOLD_TEXT", + "LIVE_CAPTION", + "POWER_BUTTON_ENDS_CALL", + "TOUCH_AND_HOLD_DELAY", + "ACCESSIBILITY_VOICE_ACCESS", + "SMS_PERMISSIONS", + "SPECIAL_APP_ACCESS", + "DARK_THEME_SCHEDULE", + "LOCK_SCREEN_TEXT", + "NIGHT_LIGHT_SCHEDULE", + "AUTOFILL", + "USAGE_AND_DIAGNOSTICS", + "SENSITIVE_NOTIFICATIONS", + "ENCRYPTION_AND_CREDENTIALS", + "SPACIAL_AUDIO", + "RESET_OPTIONS", + "QUICK_TAP", + "TIPS_AND_SUPPORT", "ABOUT_PHONE", "ACCOUNTS", "APPLICATION", @@ -9923,7 +10041,7 @@ "Deprecated, use VIBRATION instead.", "Vibration master toggle - controls all vibration functions. Corresponds to \"Vibration \u0026 haptics\" toggle in the Android settings app.", "Controls whether the ringer mode will be silent or will vibrate. Details in https://developer.android.com/reference/android/media/AudioManager#RINGER_MODE_VIBRATE Different from VIBRATION from above.", - "", + "deprecated, use ASSISTANT_VOICE", "", "", "", @@ -9933,6 +10051,64 @@ "", "", "Duplicate, use HOT_SPOT instead", + "Accessibility \u003e Select to Speak", + "Safety \u003e Crisis alerts", + "Settings \u003e About phone \u003e Regulatory labels", + "Settings \u003e About phone \u003e Send feedback about this device", + "", + "", + "", + "Settings \u003e Accessibility \u003e Hearing \u003e Sound Amplifier", + "", + "", + "Settings \u003e Accessibility \u003e TalkBack", + "Settings \u003e Accessibility \u003e Time to take action (Accessibility timeout)", + "", + "", + "Settings \u003e Google \u003e COVID-19 Exposure Notifications", + "", + "", + "", + "Settings \u003e Network \u0026 Internet \u003e Data Saver \u003e Unrestricted data", + "", + "", + "", + "", + "", + "", + "", + "Settings \u003e Security \u003e Encrypt phone", + "", + "", + "", + "", + "", + "", + "", + "", + "Settings \u003e Accessibility \u003e Caption preferences \u003e Caption size and style", + "Settings \u003e Accessibility \u003e Caption preferences \u003e Caption size and style \u003e Caption Style", + "Settings \u003e Accessibility \u003e Caption preferences \u003e Caption size and style \u003e Text size", + "Settings \u003e Accessibility \u003e Caption preferences", + "Settings \u003e Accessibility \u003e Color and motion", + "Settings \u003e Accessibility \u003e Display size and text \u003e Bold text", + "", + "Settings \u003e Accessibility \u003e Power button ends call", + "", + "", + "", + "Settings \u003e Apps \u0026 notifications \u003e Advanced \u003e Special app access", + "", + "Settings \u003e Display \u003e Lock screen \u003e Add text on lock screen", + "", + "", + "", + "", + "Settings \u003e Security \u003e Advanced settings \u003e Encryption \u0026 credentials", + "Settings \u003e Sound \u0026 vibration \u003e Spatial Audio", + "Settings \u003e System \u003e Advanced \u003e Reset options", + "Settings \u003e System \u003e Gestures \u003e Quick tap", + "Settings \u003e Tips \u0026 support", "Begin of NGA proto consistence", "", "", @@ -16374,10 +16550,6 @@ "description": "The MID of the provider. A MID is a unique identifier issued by Knowledge Graph for all entities contained in its graph.", "type": "string" }, - "naturalProviderId": { - "$ref": "AssistantContextProviderIdNaturalProviderId", - "description": "Natural Provider Id returned from Provider Corpus. Note that feature teams should almost always use provider_corpus_id which is the canonical representation for provider. Surface-specific identiers should only be used in final surface rendering." - }, "providerCorpusId": { "description": "ID issued by the Provider Corpus to uniquely identify a provider entity e.g. an Android app, a Cast app or a Cloud provider. In practice, a single partner can have multiple providers entities. For more detail, see go/se-storage-provider-id. This is the preferred/ standardized ID to use for ProviderId that all use-cases should eventually migrate to.", "format": "int64", @@ -16390,45 +16562,6 @@ }, "type": "object" }, - "AssistantContextProviderIdNaturalProviderId": { - "description": "Represents how to naturally identify a provider. A copy of google3/assistant/serviceengine/proto/serving/natural_provider_id.proto.", - "id": "AssistantContextProviderIdNaturalProviderId", - "properties": { - "providerType": { - "description": "ProviderType is an enum to represent the category of where this id is from.", - "enum": [ - "UNKNOWN", - "CLOUD_PROJECT", - "APP_ACTIONS", - "WEBSITE", - "NARRATIVE_NEWS", - "IOS_BUNDLE", - "CAST_APP", - "ZEROTH_PARTY", - "ANDROID_SYSTEM_API", - "LLM_ACTIONS" - ], - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "LLM_ACTIONS is for prototyping and development only. Do not use unless instructed." - ], - "type": "string" - }, - "value": { - "description": "String of provider_id_value is the actual value of the id.", - "type": "string" - } - }, - "type": "object" - }, "AssistantContextProviderVariant": { "description": "Note: As of May 2021, multiple providers use the same mids (e.g. YouTube Main, YouTube Go, and YouTube Music all have the same mids). However, quite often we end up using surface specific identifiers (e.g. Android package names, iOS bundle identifiers, etc.) to differentiate amongst them. This field allows us to move away from surface specific identifiers towards a surface-agnostic enum representing the same information.", "id": "AssistantContextProviderVariant", @@ -17452,6 +17585,19 @@ }, "type": "object" }, + "AssistantGroundingRankerLaaFeature": { + "id": "AssistantGroundingRankerLaaFeature", + "properties": { + "name": { + "type": "string" + }, + "value": { + "format": "float", + "type": "number" + } + }, + "type": "object" + }, "AssistantGroundingRankerLaaFeatures": { "id": "AssistantGroundingRankerLaaFeatures", "properties": { @@ -17464,6 +17610,12 @@ "contact": { "$ref": "AssistantGroundingRankerLaaFeaturesContact" }, + "features": { + "items": { + "$ref": "AssistantGroundingRankerLaaFeature" + }, + "type": "array" + }, "provider": { "$ref": "AssistantGroundingRankerLaaFeaturesProvider" } @@ -17736,12 +17888,22 @@ "type": "object" }, "AssistantGroundingRankerPodcastGroundingProviderFeatures": { - "description": "Features to be extracted from Podcast GP for ranking in HGR. Next ID: 2", + "description": "Features to be extracted from Podcast GP for ranking in HGR. Next ID: 4", "id": "AssistantGroundingRankerPodcastGroundingProviderFeatures", "properties": { "isExclusive": { "description": "Whether the podcast is exclusive to a provider a not.", "type": "boolean" + }, + "scubedNg3ModelScore": { + "description": "The relevance score from Scubed.", + "format": "float", + "type": "number" + }, + "scubedTstarScore": { + "description": "Tstar score is a signal that indicates the quality of the entity.", + "format": "double", + "type": "number" } }, "type": "object" @@ -19579,7 +19741,7 @@ "type": "object" }, "AssistantPrefulfillmentRankerPrefulfillmentSignals": { - "description": "Signals to be used by the Prefulfillment Ranker. Derived from the ParsingSignals and GroundingSignals carried by the FunctionCall. LINT.IfChange Next ID: 48", + "description": "Signals to be used by the Prefulfillment Ranker. Derived from the ParsingSignals and GroundingSignals carried by the FunctionCall. LINT.IfChange Next ID: 51", "id": "AssistantPrefulfillmentRankerPrefulfillmentSignals", "properties": { "bindingSetAuis": { @@ -19646,6 +19808,11 @@ "format": "double", "type": "number" }, + "intentNamePauis": { + "description": "Intent level Pauis User Interaction Score.", + "format": "float", + "type": "number" + }, "isFeasible": { "description": "Feasibility of fulfilling the binding set. Eg: For PlayMedia, this is equivalent to playability. More details: go/hgr-feasibility-feature.", "type": "boolean" @@ -19666,6 +19833,10 @@ "description": "Whether the intent is a podcast intent.", "type": "boolean" }, + "isVideoIntent": { + "description": "Whether the intent is a media object video intent.", + "type": "boolean" + }, "kscorerRank": { "description": "The rank order of the interpretation as determined by kscorer. The kscorer-determined dominant interpretation, if any, gets a rank of 0. The remaining N interpretations get a rank of 1 through N.", "format": "int32", @@ -19729,6 +19900,38 @@ "format": "int32", "type": "integer" }, + "phase": { + "description": "Query understanding phase the intent was produced in.", + "enum": [ + "QU_PHASE_UNSPECIFIED", + "QU_PHASE_REQUEST", + "QU_PHASE_QREWRITE", + "QU_PHASE_QBT", + "QU_PHASE_PROBE_QUERY", + "QU_PHASE_MULTI_ACCOUNT", + "QU_PHASE_CQBT", + "QU_PHASE_QBT_RESOLUTION", + "QU_PHASE_HIGH_PRECISION", + "QU_PHASE_COMBINED_RBT_RESOLUTION", + "QU_PHASE_ANALYZER_INPUT", + "QU_PHASE_NAGE" + ], + "enumDescriptions": [ + "Invalid value to use as a default.", + "Phase in which the QueryUnderstandingRequest for a non-identity Candidate is generated. Produces QueryCandidateInfo.", + "Phase in which QUS calls QRewrite. Produces QRewrite's reply.", + "Phase in which QBT interpretations are ranked. Produces ranked QBT interpretations.", + "Phase in which QUS does a probe query for incomplete search results and produces ranked RBT interpretations on the basis of these. Only runs if understand_mode is PRE_RESULT_AND_PROBE_QUERY.", + "Phase in which QUS does cross-account understanding. Produces AnalyzerResponse whose interpretations contain personal data from multiple accounts.", + "Deprecated, but see go/qus-contextual-ig for original purpose.", + "Phase in which QUS calls resolution service to perform slow intent resolution. Produces resolved intents.", + "Phase in which QUS calls the fast HighPrecision workflow. Only runs if understand_mode is PRE_RESULT_AND_HIGH_PRECISION.", + "Phase in which QUS combines the RBT result and Slow Resolution result. Only runs if understand_mode is PRE_RESULT_AND_PROBE_QUERY_AND_RESOLUTION.", + "Phase in which QUS returns the AnalyzerInput as a separate Phase. It copies the AnalyzerInput from QU_PHASE_QREWRITE and returns it as a QueryUnderstandingStreamingResult for the purpose of logging in ACE. See go/analyzerinput-new-qus-phase.", + "Phase in which QUS runs NSP in the QUS." + ], + "type": "string" + }, "pq2tVsAssistantIbstCosine": { "description": "Cosine similarity between predicted query-to-term model and assistant intent-type-based salient terms. This is intended to be only used for ACE ranking and only populated for assistant traffic.", "format": "double", @@ -19758,7 +19961,9 @@ "RANKER_NAME_CONSOLIDATED_PFR_HGR", "RANKER_NAME_CONSOLIDATED_PFR_HGR_V2", "RANKER_NAME_GROUNDING_RANKER_COMMS_EXP_CALIBRATED", - "RANKER_NAME_CONSOLIDATED_PFR_HGR_V2_COMMS_CALIBRATED" + "RANKER_NAME_CONSOLIDATED_PFR_HGR_V2_COMMS_CALIBRATED", + "RANKER_NAME_EXPERIMENTAL_PFR_SAGE_NEW_DOMAINS", + "RANKER_NAME_BUCKETED_PARSING_SCORE_FOR_SMARTHOME" ], "enumDescriptions": [ "Default value, when there is no ranker specified.", @@ -19772,7 +19977,9 @@ "Name for consolidated PFR and HGR ranker.", "Name for consolidated PFR and HGRv2 ranker.", "Name for experimental calibrated HGR model for Comms.", - "Name for consolidated PFR, HGRv2 and comms ranker." + "Name for consolidated PFR, HGRv2 and comms ranker.", + "Name for experimental PFR ranker for Sage and new domains.", + "Name for PFR ranker with bucketed parsing scores for SmartHome." ], "type": "string" }, @@ -21513,7 +21720,7 @@ "type": "object" }, "ClassifierPornSiteData": { - "description": "Next ID: 52", + "description": "Next ID: 53", "id": "ClassifierPornSiteData", "properties": { "avgPedoPageScore": { @@ -21554,6 +21761,11 @@ }, "type": "array" }, + "violenceScore": { + "description": "The cubic mean aggregation of violence page scores in the site.", + "format": "float", + "type": "number" + }, "violenceStats": { "$ref": "ClassifierPornSiteViolenceStats" } @@ -41317,7 +41529,7 @@ "type": "boolean" }, "lane": { - "description": "Detailed information about each lane in this direction, if available. Lanes are numbered from inside of the road outward, i.e. the lane next to the center line is lane 0. Note that lanes that are valid for travel in both directions appear in both segments of a segment pair (left turn lanes, one-lane roads, some passing lanes, reversing lanes). Some lanes may not be usable by cars, such as bike lanes. Also, some lanes may not exist along the entire segment, e.g. left- or right-turn lanes that appear just before the intersection.", + "description": "Detailed information about each lane in this direction, if available. Lanes are numbered from inside of the road outward, i.e. the lane next to the center line has lane_number 0. Note that lanes that are valid for travel in both directions appear in both segments of a segment pair (left turn lanes, one-lane roads, some passing lanes, reversing lanes). Some lanes may not be usable by cars, such as bike lanes. Also, some lanes may not exist along the entire segment, e.g. left- or right-turn lanes that appear just before the intersection.", "items": { "$ref": "GeostoreLaneProto" }, @@ -44507,7 +44719,7 @@ "type": "object" }, "GoogleAssistantAccessoryV1DeviceState": { - "description": "Information about the state of the device. This contains any state that Assistant may need to know about in order to fulfill requests, for example which timers and alarms are set. Next ID: 9", + "description": "Information about the state of the device. This contains any state that Assistant may need to know about in order to fulfill requests, for example which timers and alarms are set. Next ID: 10", "id": "GoogleAssistantAccessoryV1DeviceState", "properties": { "alarmState": { @@ -45464,6 +45676,12 @@ "description": "Uri to display the document, for example, in the UI.", "type": "string" }, + "dispositionTime": { + "description": "Output only. If linked to a Collection with RetentionPolicy, the date when the document becomes mutable.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, "documentSchemaName": { "description": "The Document schema name. Format: projects/{project_number}/locations/{location}/documentSchemas/{document_schema_id}.", "type": "string" @@ -46722,6 +46940,10 @@ "type": "string" }, "type": "array" + }, + "outputPath": { + "description": "The output Cloud Storage folder in this pipeline.", + "type": "string" } }, "type": "object" @@ -47366,7 +47588,7 @@ "type": "array" }, "uri": { - "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. See [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris) for more info.", + "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. For more information, refer to [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris).", "type": "string" } }, @@ -48106,11 +48328,11 @@ "description": "Color of the background." }, "bold": { - "description": "Whether the text is bold (equivalent to font weight \u003e= 700).", + "description": "Whether the text is bold (equivalent to font_weight is at least `700`).", "type": "boolean" }, "fontSize": { - "description": "Font size in points (1 point is 1/72\").", + "description": "Font size in points (`1` point is `¹⁄₇₂` inches).", "format": "int32", "type": "integer" }, @@ -48119,7 +48341,7 @@ "type": "string" }, "fontWeight": { - "description": "TrueType weight on a scale 100 (Thin) to 1000 (Ultra-heavy). Normal is 400, Bold is 700.", + "description": "TrueType weight on a scale `100` (thin) to `1000` (ultra-heavy). Normal is `400`, bold is `700`.", "format": "int32", "type": "integer" }, @@ -48137,12 +48359,12 @@ "type": "number" }, "pixelFontSize": { - "description": "Font size in pixels, equal to unrounded_fontsize * resolution / 72.0.", + "description": "Font size in pixels, equal to _unrounded font_size_ * _resolution_ ÷ `72.0`.", "format": "double", "type": "number" }, "smallcaps": { - "description": "Whether the text are small caps.", + "description": "Whether the text is in small caps.", "type": "boolean" }, "strikeout": { @@ -60647,7 +60869,7 @@ "type": "object" }, "KnowledgeAnswersIntentQueryArgumentSignals": { - "description": "A message representing the signals associated with an argument. NEXT ID TO USE: 57 For //depot/google3/logs/proto/knowledge/interpretation/intent_query.proto in the \"ThenChange\", fields under Argument.signals in the serving proto are stored directly under Argument on the logging side. For example, see http://google3/nlp/semantic_parsing/data_management/logs/web_logs/semantic_logging_converters/semantic_logging_request_argument_converter.cc?l=58\u0026rcl=322925428. LINT.IfChange", + "description": "A message representing the signals associated with an argument. NEXT ID TO USE: 58 For //depot/google3/logs/proto/knowledge/interpretation/intent_query.proto in the \"ThenChange\", fields under Argument.signals in the serving proto are stored directly under Argument on the logging side. For example, see http://google3/nlp/semantic_parsing/data_management/logs/web_logs/semantic_logging_converters/semantic_logging_request_argument_converter.cc?l=58\u0026rcl=322925428. LINT.IfChange", "id": "KnowledgeAnswersIntentQueryArgumentSignals", "properties": { "addedByCloseAnswers": { @@ -60872,6 +61094,9 @@ "description": "Whether this argument was resolved from a pronoun mention in the query. Eg: [how old was obama when *he* became president]", "type": "boolean" }, + "responseMeaningSignals": { + "$ref": "KnowledgeAnswersIntentQueryResponseMeaningSignalsResponseMeaningSignals" + }, "resultSupport": { "description": "The list of result supports for this Argument.", "items": { @@ -61950,15 +62175,58 @@ }, "type": "object" }, + "KnowledgeAnswersIntentQueryResponseMeaningSignalsAnswersHeaderSignals": { + "id": "KnowledgeAnswersIntentQueryResponseMeaningSignalsAnswersHeaderSignals", + "properties": { + "answersValueGender": { + "enum": [ + "UNKNOWN", + "FEMALE", + "MALE" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" + }, + "numAnswers": { + "format": "uint64", + "type": "string" + } + }, + "type": "object" + }, "KnowledgeAnswersIntentQueryResponseMeaningSignalsResponseMeaningSignals": { "description": "SRM signal data. Properties here should be nonsemantic. Semantic properties should be modeled directly in the SRM.", "id": "KnowledgeAnswersIntentQueryResponseMeaningSignalsResponseMeaningSignals", "properties": { + "answersHeaderSignals": { + "$ref": "KnowledgeAnswersIntentQueryResponseMeaningSignalsAnswersHeaderSignals", + "description": "Signals that are used to generate answers header." + }, "propertyValue": { "items": { "$ref": "FreebasePropertyValue" }, "type": "array" + }, + "responseMeaningApplication": { + "description": "The intended application this response meaning is used for. It is intended for downstream dispatching.", + "enum": [ + "DEFAULT", + "HEADER", + "VOICE_ANSWERS", + "DISPLAY_ANSWERS" + ], + "enumDescriptions": [ + "", + "", + "", + "" + ], + "type": "string" } }, "type": "object" @@ -78293,6 +78561,7 @@ "NUDGEIT_CAMPAIGN_MANAGER", "DECS", "GSOX_MOCHI", + "PMW_TI", "DEPRECATED_QUICKSTART_FLUME", "DUO_CLIENT", "ALBERT", @@ -78934,6 +79203,7 @@ "Nudgeit Campaign Manager Team contact: nudges-campaign-manager-team@google.com", "Decs Team contact: decs-eng@google.com", "Gsox Mochi Team contact: fintechops-eng@google.com", + "Pmw Ti Team contact: pmw-ti", "", "Duo Client Team contact: duo-eng@google.com", "Project albert (go/albert-frontend) Team contact: albert-eng@google.com", @@ -85803,7 +86073,7 @@ "type": "object" }, "QualityFringeFringeQueryPriorPerDocData": { - "description": "PerDocData for fringe-query-prior (built into the shards for eventual consumption at Fringe classification time). Not stored in DocJoins. NEXT ID: 11", + "description": "PerDocData for fringe-query-prior (built into the shards for eventual consumption at Fringe classification time). Not stored in DocJoins. NEXT ID: 12", "id": "QualityFringeFringeQueryPriorPerDocData", "properties": { "encodedCalibratedFringeSitePriorScore": { @@ -85854,6 +86124,14 @@ "description": "A score in [0, 1] representing the similarity of this doc to known fringe-vulnerable 'seeds'. See go/fringe-proximity for more information. Encoded for compactness and to restrict visibility.", "format": "uint32", "type": "integer" + }, + "sensitiveEntitiesIndices": { + "description": "Indices on the repository_webref::WebrefEntities::entity field of entities that represent a person or a group of people (aka sensitive entities).", + "items": { + "format": "int32", + "type": "integer" + }, + "type": "array" } }, "type": "object" @@ -86712,13 +86990,6 @@ "url": { "type": "string" }, - "versionedAsrData": { - "description": "Versioned map of ASR (authenticity) values.", - "items": { - "$ref": "QualityNsrVersionedFloatSignal" - }, - "type": "array" - }, "versionedData": { "description": "Versioned map of NSR values for experimenting with the next release.", "items": { @@ -90100,9 +90371,9 @@ "V5", "V5_1", "V5_2", + "V5_3", "V1_BODYONLY", "V2_BODYONLY", - "RENAME_ME_TO_ADD_NEW_ENUM_16", "RENAME_ME_TO_ADD_NEW_ENUM_17", "RENAME_ME_TO_ADD_NEW_ENUM_18", "RENAME_ME_TO_ADD_NEW_ENUM_19", @@ -90111,7 +90382,8 @@ "RENAME_ME_TO_ADD_NEW_ENUM_22", "RENAME_ME_TO_ADD_NEW_ENUM_23", "RENAME_ME_TO_ADD_NEW_ENUM_24", - "RENAME_ME_TO_ADD_NEW_ENUM_25" + "RENAME_ME_TO_ADD_NEW_ENUM_25", + "RENAME_ME_TO_ADD_NEW_ENUM_26" ], "enumDescriptions": [ "In case an old binary doesn't know a recently added version.", @@ -90128,6 +90400,7 @@ "Lyrebird V5: Salient Terms V5 (ariane/4076831)", "Lyrebird V5.1: Salient Terms V5.1 (ariane/4144754)", "Lyrebird V5.2: Salient Terms V5.2 (ariane/4218250)", + "Lyrebird V5.3: Salient Terms V5.3 (ariane/4246904)", "Lyrebird BodyOnly V1.", "Experimental version of Lyrebird BodyOnly V2.", "Dummy enum values to be renamed when a new enum value is needed. Note that this is a requirement from go/cds-schema-council. If you rename one of these enum values, be sure to add (at least one) more below.", @@ -94186,10 +94459,6 @@ }, "type": "array" }, - "entity": { - "$ref": "RepositoryWebrefEntityJoin", - "description": "Sparse metadata about the entity, usage should be moved back to individual fields, this avoids having cyclic dependencies." - }, "extendedScoreRatio": { "description": "Stores region specific score ratios for the entity when it is significantly different from the language version above.", "items": { @@ -98890,7 +99159,7 @@ }, "entityJoin": { "$ref": "RepositoryWebrefEntityJoin", - "description": "Metadata and raw signals used by the annotator." + "description": "Metadata and raw signals used by the annotator. Intended for internal use. Steer clear of adding new dependencies on fields in this proto, especially external dependencies. If you are a Refx client and would like to consume entity metadata, consider querying TopicServer instead." }, "id": { "$ref": "RepositoryWebrefWebrefEntityId", @@ -104702,6 +104971,26 @@ }, "type": "object" }, + "SocialCommonSearchLinkData": { + "description": "SearchLink metadata, for SEARCH_LINK segments. For a search link, the \"text\" field should contain the display text. This is currently not indexed.", + "id": "SocialCommonSearchLinkData", + "properties": { + "kgEntityConfidence": { + "description": "For lightweight scoring in serving time.", + "format": "float", + "type": "number" + }, + "mid": { + "description": "MID of the KG entity being linked.", + "type": "string" + }, + "queryBroadnessScore": { + "format": "float", + "type": "number" + } + }, + "type": "object" + }, "SocialCommonSegment": { "id": "SocialCommonSegment", "properties": { @@ -104717,6 +105006,10 @@ "$ref": "SocialCommonLinkData", "description": "Type-specific metadata. At most one of these should be populated, and the one that is populated should correspond to the type of the Segment. For LINK type:" }, + "searchLinkData": { + "$ref": "SocialCommonSearchLinkData", + "description": "For SEARCH_LINK type:" + }, "text": { "description": "Text content of the Segment. As a general rule, this field should contain the actual text that should be rendered in the UI. Thus, for a hashtag, it should be \"#Foo\", and for a link, it should be the display text. Clients that do not understand a particular segment type may use this text, along with the Formatting info below, as a fallback for display. The field is not required -- if all relevant information is carried in other metadata fields and there is no need for a fallback, or it is not practical for a fallback to be provided for any other reason, the field may be left blank. A standard example would be a user reference being transmitted between server layers, where a gaia-ID representation may be sufficient and there is no need for a textual fallback. In such a case, it would be valid and useful - though not required - for servers to compute and populate a fallback on the serving path.", "type": "string" @@ -104729,7 +105022,8 @@ "LINK", "USER_MENTION", "ALL_USER_MENTION", - "HASHTAG" + "HASHTAG", + "SEARCH_LINK" ], "enumDescriptions": [ "A TEXT segment represents plain-text subject to particular formatting constraints (as represented in the \"formatting\" field of the Segment).", @@ -104737,7 +105031,8 @@ "A LINK segment represents a link to a web entity. The \"text\" field should be used for anchor text. Additional link data should be put in the link_data protobuf.", "A USER_MENTION segment represents a reference to a (possibly non-Gaia, possibly off-network) user. The \"text\" field may be populated as a fallback, but information identifying the user should be contained in the user_mention_data protobuf. (The set of fields that are populated in user_mention_data may differ depending on the context in which the segment is viewed, but the interpretation of the fields is uniform. See comments over UserMentionData).", "An ALL_USER_MENTION segment represents a reference to all users in the context, that is, the conversation, discussion, or other context containing the segment. For example, an ALL_USER_MENTION segment (\"@all\") can be useful to ping all participants in a conversation if the notification setting of the conversation is not set to ping on normal messages. An ALL_USER_MENTION should be treated as a USER_MENTION for all users who receives the segment.", - "A HASHTAG segment represents a structured reference to a topic. The \"text\" field should represent display text (e.g. \"#Google\"), and additional metadata should be put in the Segment's hashtag_data field." + "A HASHTAG segment represents a structured reference to a topic. The \"text\" field should represent display text (e.g. \"#Google\"), and additional metadata should be put in the Segment's hashtag_data field.", + "A SEARCH_LINK segment respresents a link to search results for a KG entity. The \"text\" field should represent the part of the comment where the KG entity is extracted from, and additional metadata of the entity should be put in the Segment's search_link_data field." ], "type": "string" }, @@ -106324,14 +106619,17 @@ ], "type": "string" }, + "isMembershipVisibleToCaller": { + "description": "Whether caller has visibility into the direct members of the roster. NEXT TAG: 11", + "type": "boolean" + }, "memberCount": { - "description": "Number of members (direct or indirect) in a Google Group. Only an estimate for large groups (currently \u003e 1K direct / indirect members).", + "description": "DEPRECATED: use segmented_membership_counts instead. Number of members (direct or indirect) in a Google Group. Only an estimate for large groups (currently \u003e 1K direct / indirect members).", "format": "int64", "type": "string" }, "organizationInfo": { - "$ref": "AppsDynamiteSharedOrganizationInfo", - "description": "NEXT TAG: 9" + "$ref": "AppsDynamiteSharedOrganizationInfo" }, "presence": { "enum": [ @@ -106349,6 +106647,10 @@ "The user has disabled presence sharing. This is currently only possible via the Classic setting to disable sharing your last active time (see external docs here: https://support.google.com/hangouts/answer/6083257?hl=en)." ], "type": "string" + }, + "segmentedMembershipCounts": { + "$ref": "AppsDynamiteSharedSegmentedMembershipCounts", + "description": "Represents the direct membership counts of a Google Group. May contain counts based on member type and membership state." } }, "type": "object" @@ -107163,6 +107465,7 @@ "ISOLATION_PKG_YOUTUBE_PUBLIC_AND_PRIVATE_PLAYLISTS", "ISOLATION_S3_CREATOR_PRESENCE", "ISOLATION_S12Y_RECIPE_INGREDIENT_INSIGHTS", + "ISOLATION_SCOUTS_SOCIETAL_CONTEXT_ENTITIES", "UMP_TESTING_ONLY", "INTENTJOINS_NB_SIGNALS", "ADS_INTEGRITY_ANNOTATION", @@ -107346,6 +107649,7 @@ "For data from YouTube's PlaylistService that has either public or private visibility (i.e. the combination of ISOLATION_PKG_YOUTUBE_PLAYLISTS and ISOLATION_PKG_YOUTUBE_PRIVATE_PLAYLISTS). PWG-YouTube approval required for all usecases involving this data.", "Access controls for Creator Channel's S-Cubed corpus data. See more in go/uro-access-required. YOU MUST CONTACT milk-tea@ before reading or writing this data", "For Search sustainability's food choice feature, Recipe Ingredient Insights. Assign existing KG entities feature types to classify triggering behavior and insights. Owned by salehh@ and s12y-eng@ See go/rii-kg-triggering-migration for more information.", + "Access controls for SCOUTS Societal Context Repository entities. Please contact johnhenry-eng@ before reading or writing this data. DD: go/scouts-kg-integration-dd", "This access control is used to guard data used by the Unified Media Platform team (ke-media-actions-serving@) for testing new features. It should never be used for purposes other than testing. More context at go/fake-media-provider.", "Access controls for the IntentJoins Navboost data. YOU MUST CONTACT intentjoins-eng@ before reading or writing this data.", "Access controls for Ads Integrity annotation data. Ads Integrity annotations are only available for Ads Integrity policy enforcement. See go/ai-political-km for more details. YOU MUST CONTACT ai-pacg@ before reading or writing this data.", @@ -110548,6 +110852,7 @@ "GEARHEAD_WORK_PROFILE_DETECTED_AND_COMPATIBLE", "GEARHEAD_WORK_PROFILE_QUERYING_ALLOWED", "PLAY_ADS_REENGAGEMENT_COUNTERFACTUAL", + "PLAY_ADS_THIRD_LIST_VIEW_ADS_COUNTERFACTUAL", "GEARHEAD_TOOLTIP_ASSISTANT_LAUNCHER_OPEN", "GEARHEAD_MULTIPLE_CALLABLE_PHONE_ACCOUNTS_DETECTED", "GEARHEAD_USER_HAS_SELECTED_OUTGOING_PHONE_ACCOUNT", @@ -110672,6 +110977,13 @@ "RAM_3GB_TO_4GB_EVENT_LEVEL", "RAM_4GB_TO_6GB_EVENT_LEVEL", "RAM_6GB_AND_MORE_EVENT_LEVEL", + "LOW_STORAGE_AT_INSTALL_PREPROCESSING_EVENT_LEVEL", + "DSA_P13N_OPTED_IN_AT_EVENT_LEVEL", + "DSA_P13N_OPTED_OUT_AT_EVENT_LEVEL", + "USER_P13N_SETTING_UNSPECIFIED_AT_EVENT_LEVEL", + "USER_P13N_SETTING_ON_AT_EVENT_LEVEL", + "USER_P13N_SETTING_OFF_AT_EVENT_LEVEL", + "BATTLESTAR_GAME_IN_MDP_EVENT_LEVEL", "EVENT_LEVEL_TEST_CODE_LIMIT", "ENTERTAINMENT_CLUSTER_TRIGGERING_AT_SESSION_LEVEL", "BEST_SELLER_CART_TAG_AT_SESSION_LEVEL", @@ -111238,6 +111550,15 @@ "BOOKS_LOYALTY_PROMO_BANNER_WEEKLY_PRIZE_SESSION_LEVEL", "MDP_WITH_LIVE_OPS_EVER_INSTALLED_USERS_SESSION_LEVEL", "MDP_WITH_LIVE_OPS_NEVER_INSTALLED_USERS_SESSION_LEVEL", + "LOW_STORAGE_AT_INSTALL_PREPROCESSING_SESSION_LEVEL", + "DSA_P13N_OPTED_IN_AT_SESSION_LEVEL", + "DSA_P13N_OPTED_OUT_AT_SESSION_LEVEL", + "LANGUAGE_SWITCHER_SERVED_SESSION_LEVEL", + "HAS_INSUFFICIENT_STORED_VALUE_BALANCE_BEFORE_RENEWAL_SESSION_LEVEL", + "USER_P13N_SETTING_UNSPECIFIED_AT_SESSION_LEVEL", + "USER_P13N_SETTING_ON_AT_SESSION_LEVEL", + "USER_P13N_SETTING_OFF_AT_SESSION_LEVEL", + "BATTLESTAR_GAME_IN_MDP_SESSION_LEVEL", "SESSION_LEVEL_TEST_CODE_LIMIT", "CART_ABANDONMENT_USER_LEVEL", "IN_APP_PRODUCTS_IN_DETAILS_PAGE_USER_LEVEL", @@ -111374,6 +111695,7 @@ "GE_IS_SCHEDULED_COFFEE_CARD", "GE_IS_SCHEDULED_QUEST", "GE_IS_SCHEDULED_LOYALTY_MULTIPLIER", + "GE_IS_USER_OPT_IN_P13N", "IAP_SKU_DEALS_LIVE_OP_DEALS_HOME_USER_LEVEL", "IAP_SKU_DEALS_LIVE_OP_GAMES_HOME_USER_LEVEL", "FEATURING_AHC_OR_FHR_TRIGGERED_USER_LEVEL", @@ -111492,6 +111814,13 @@ "DMA_PRE_CONSENT_PROMPT_SHOWN_USER_LEVEL", "DMA_PRE_CONSENT_DECISION_MADE_USER_LEVEL", "DMA_PRE_CONSENT_FLOW_DISMISSED_USER_LEVEL", + "DSA_P13N_OPTED_IN_AT_USER_LEVEL", + "DSA_P13N_OPTED_OUT_AT_USER_LEVEL", + "LIVEOPS_INSTALL_NOTIFICATION_USER_LEVEL", + "USER_P13N_SETTING_UNSPECIFIED_AT_USER_LEVEL", + "USER_P13N_SETTING_ON_AT_USER_LEVEL", + "USER_P13N_SETTING_OFF_AT_USER_LEVEL", + "LIVEOPS_CLUSTER_SERP_TRIGGERING_USER_LEVEL", "USER_LEVEL_TEST_CODE_LIMIT" ], "enumDescriptions": [ @@ -111610,6 +111939,7 @@ "Indicates Android Auto has permission to query work data, and show it to the user", "", "", + "", "Indicates that Android Auto has detected multiple phone accounts, which are capable of placing/receiving calls. VOIP accounts are not included.", "Indicates that a phone with multiple callable accounts has a default account specified for placing outgoing calls. This means account disambiguation generally won't be needed when placing a call from Android Auto.", "", @@ -111733,6 +112063,13 @@ "Event level test code for RAM between 3GB and 4GB.", "Event level test code for RAM between 4GB and 6GB.", "Event level test code for RAM between 6GB and more.", + "Low storage at install preprocessing stage.", + "Event-level test code for DSA p13n opt in.", + "Event-level test code for DSA p13n opt out.", + "Event-level test code corresponding to com.google.play.consent.proto.Setting.SETTING_UNSPECIFIED.", + "Event-level test code corresponding to com.google.play.consent.proto.Setting.SETTING_ON.", + "Event-level test code corresponding to com.google.play.consent.proto.Setting.SETTING_OFF.", + "Event-level test code corresponding to an MDP showing for a game also available on Battlestar.", "", "", "", @@ -112299,6 +112636,15 @@ "", "Session level test codes for logging MDP with LiveOps shown to users who have installed the app on SERP.", "Session level test codes for logging MDP with LiveOps shown to users who have never installed the app on SERP.", + "Low storage at install preprocessing stage.", + "Session-level test code for DSA p13n opt in.", + "Session-level test code for DSA p13n opt out.", + "Session level test code for Language Switcher indicating that the user was served with the module on cart screen.", + "Session level test code that indicates the stored value balance is insufficient for next renewal.", + "Session-level test code corresponding to com.google.play.consent.proto.Setting.SETTING_UNSPECIFIED.", + "Session-level test code corresponding to com.google.play.consent.proto.Setting.SETTING_ON.", + "Session-level test code corresponding to com.google.play.consent.proto.Setting.SETTING_OFF.", + "Session-level test code corresponding to an MDP showing for a game also available on Battlestar.", "", "Cart abandonment flow for purchase flow.", "User saw/would have seen the in app products section in App", @@ -112435,6 +112781,7 @@ "", "", "", + "Test codes for GE DSA opt-in users.", "User level test code for tracking users who should see the IAP Sku Deals liveops card.", "User level test code for tracking users who should see the IAP Sku Games Home liveops card.", "User level test code for tracking users who should see the featuring AHC or FHR.", @@ -112553,6 +112900,13 @@ "User-level test codes for DMA PreConsent experiment. go/playpreconsent", "", "", + "User-level test code for DSA p13n opt in.", + "User-level test code for DSA p13n opt out.", + "User level test code for live-ops install notification experiments. If GE decision changed after enabling ranking using the notification install model prediction, log test code.", + "User-level test code corresponding to com.google.play.consent.proto.Setting.SETTING_UNSPECIFIED.", + "User-level test code corresponding to com.google.play.consent.proto.Setting.SETTING_ON.", + "User-level test code corresponding to com.google.play.consent.proto.Setting.SETTING_OFF.", + "User level test code for cat search live ops cluster triggering. Add new user-level TestCode here.", "" ], "type": "string" @@ -117635,6 +117989,24 @@ }, "type": "object" }, + "VideoGoogleVideoClipInfo": { + "description": "YT app video information. (go/yt-create-vsi-data)", + "id": "VideoGoogleVideoClipInfo", + "properties": { + "appVersion": { + "description": "YT app version (ie. YT Create app version).", + "type": "string" + }, + "assetLoggingId": { + "description": "List of YT media asset logging ids.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "VideoLegosLegosAnnotationsSet": { "id": "VideoLegosLegosAnnotationsSet", "properties": { @@ -118370,7 +118742,7 @@ "type": "object" }, "VideoThumbnailsThumbnailScore": { - "description": "LINT.IfChange Score calculated from a thumbnail. NextID: 15", + "description": "LINT.IfChange Score calculated from a thumbnail. NextID: 16", "id": "VideoThumbnailsThumbnailScore", "properties": { "checksum": { @@ -118395,6 +118767,10 @@ "$ref": "DrishtiFeatureExtra", "description": "FeatureExtra extension for dense features." }, + "externalImageId": { + "description": "A unique identifier for the image that is independent of the resolution. The Image ID accompanies the image bytes through its lifecycle, from creation till vanishing. Image ID is not based on image content; it is different than checksum (e.g. two different images with the same bytes may not have the same image ID). This ID is used as a unique identifier for clients such as T\u0026S and classifiers. For more info refer to go/thumbnail-id-ts-ab-testing Note: Image ID's are still in development and are currently not exposed externally (may be done in the future). Please contact yt-thumbnails-core@ before using it. Do not use externally or in logs before contacting yt-thumbnails-core@", + "type": "string" + }, "isAssigned": { "description": "If true, score is manually assigned.", "type": "boolean" @@ -118933,7 +119309,7 @@ "type": "object" }, "VideoVideoStreamInfo": { - "description": "Note that when a VSI is from a user video, the information reflects the info in that source. Fields like lengths, fps, etc. are not guaranteed to be the same as those of transcodes. If the relevant info in source is too broken, the corresponding fields (e.g., lengths) could be unset or with the default value, meaning VSI cannot compute them from the given info. Next id: 82", + "description": "Note that when a VSI is from a user video, the information reflects the info in that source. Fields like lengths, fps, etc. are not guaranteed to be the same as those of transcodes. If the relevant info in source is too broken, the corresponding fields (e.g., lengths) could be unset or with the default value, meaning VSI cannot compute them from the given info. Next id: 83", "id": "VideoVideoStreamInfo", "properties": { "audioBitrate": { @@ -119915,8 +120291,8 @@ }, "avDistance": { "description": "Audio-Video interleaving distance between packets (in bytes)", - "format": "int32", - "type": "integer" + "format": "int64", + "type": "string" }, "avLength": { "description": "Audio and video length in seconds. It's the max of the audio and video length. Note that when the VSI is from users videos, it is not guaranteed to be the same as transcode lengths and it could be 0 when the full VSI cannot compute the length from the source header and timestamps (for example when header and timestamps are too broken).", @@ -120567,6 +120943,10 @@ "format": "int32", "type": "integer" }, + "googleVideoClipInfo": { + "$ref": "VideoGoogleVideoClipInfo", + "description": "YT app created video information," + }, "imageStream": { "items": { "$ref": "VideoVideoStreamInfoVideoStream" @@ -129457,7 +129837,8 @@ "GEO_LEGOS_TEST_SET_V2_POLITICAL", "GEO_LEGOS_TEST_SET_V2_TRAVEL_DESTINATIONS", "GEO_LEGOS_TEST_SET_V2_DINING", - "GEO_LEGOS_TEST_SET_V2_HOTEL" + "GEO_LEGOS_TEST_SET_V2_HOTEL", + "TRAVEL_INTEREST" ], "enumDescriptions": [ "", @@ -129547,7 +129928,8 @@ "To use in Geo Legos launch report. Each context defines a slice of docs to subsample in a test.", "", "", - "" + "", + "A broad travel lego context stands for travel experiences, activities etc. This is not about a geo location but more of a reason why people want to visit a place. For example, \"amusement park\", \"surfing\", \"honeymoon\"." ], "type": "string" } diff --git a/contentwarehouse/v1/contentwarehouse-gen.go b/contentwarehouse/v1/contentwarehouse-gen.go index d807733ea48..7f490496663 100644 --- a/contentwarehouse/v1/contentwarehouse-gen.go +++ b/contentwarehouse/v1/contentwarehouse-gen.go @@ -279,7 +279,7 @@ type AbuseiamAbuseType struct { // "LOCAL_LAWS" - Other misc country-specific laws // "PRIVACY" - Local privacy laws // "ES_BLACKLIST" - Internal type to check es content against - // "ES_COMMENTS_BLACKLIST" - the ocelot blacklist. Internal type. + // "ES_COMMENTS_BLACKLIST" - the ocelot blocklist. Internal type. // "HARASSMENT" - Consistent harassing behaviour directed // "COMPROMISED" - towards a person. Hijacked or Compromised profile. // "LOW_QUALITY" - Low quality/Annoying content. @@ -2268,6 +2268,78 @@ func (s *AppsDynamiteSharedOrganizationInfoCustomerInfo) MarshalJSON() ([]byte, return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// AppsDynamiteSharedSegmentedMembershipCount: Contains info on +// membership count for member types: HUMAN_USER, APP_USER & +// ROSTER_MEMBER different states: INVITED, JOINED +type AppsDynamiteSharedSegmentedMembershipCount struct { + // Possible values: + // "MEMBER_TYPE_UNSPECIFIED" - default value + // "HUMAN_USER" - member is a human user + // "ROSTER_MEMBER" - member is a roster + MemberType string `json:"memberType,omitempty"` + + // MembershipCount: count of members with given type and state + MembershipCount int64 `json:"membershipCount,omitempty"` + + // Possible values: + // "MEMBER_UNKNOWN" - Default state, do not use + // "MEMBER_INVITED" - An invitation to the space has been sent + // "MEMBER_JOINED" - User has joined the space + // "MEMBER_NOT_A_MEMBER" - User is not a member + // "MEMBER_FAILED" - This state should never be stored in Spanner. It + // is a state for responses to the clients to indicate that membership + // mutations have failed and the member is in its previous state. + MembershipState string `json:"membershipState,omitempty"` + + // ForceSendFields is a list of field names (e.g. "MemberType") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "MemberType") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *AppsDynamiteSharedSegmentedMembershipCount) MarshalJSON() ([]byte, error) { + type NoMethod AppsDynamiteSharedSegmentedMembershipCount + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +type AppsDynamiteSharedSegmentedMembershipCounts struct { + Value []*AppsDynamiteSharedSegmentedMembershipCount `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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Value") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *AppsDynamiteSharedSegmentedMembershipCounts) MarshalJSON() ([]byte, error) { + type NoMethod AppsDynamiteSharedSegmentedMembershipCounts + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // AppsPeopleActivityBackendDestinationStream: A DestinationStream is a // /namespace/id[0]/id[1]/.../id[n] that represents a collection of // Activities. Example destinations: -The Profile Stream on @@ -3141,6 +3213,9 @@ type AppsPeopleOzExternalMergedpeopleapiAffinity struct { // "CONTACTS_TO_STAR_AFFINITY" // "DECS_AFFINITY" // "GSOX_MOCHI_AFFINITY" + // "MEET_AFFINITY" + // "PMW_TI_AFFINITY" + // "DRIVE_SEARCH_FILTER_PERSON_ONLY" AffinityType string `json:"affinityType,omitempty"` // ContainerId: The ID of the container @@ -5966,9 +6041,9 @@ func (s *AppsPeopleOzExternalMergedpeopleapiInAppNotificationTargetOriginatingFi // AppsPeopleOzExternalMergedpeopleapiInAppReachability: This is // deprecated in PEOPLE_API/SHARPEN, and should only be used for -// PROFILES. Which apps the person has indicated they are reachable at -// for the requester. See go/d13y and -// com.google.focus.proto.InAppReachability. +// PROFILES. Clients should use InAppNotificationTarget field instead. +// Which apps the person has indicated they are reachable at for the +// requester. See go/d13y and com.google.focus.proto.InAppReachability. type AppsPeopleOzExternalMergedpeopleapiInAppReachability struct { // Possible values: // "UNKNOWN" - should never be stored in practice @@ -11597,7 +11672,7 @@ type AssistantApiClientOpPropertiesDeviceModifySettingClientOpProperty struct { // or will vibrate. Details in // https://developer.android.com/reference/android/media/AudioManager#RINGER_MODE_VIBRATE // Different from VIBRATION from above. - // "VOICE" + // "VOICE" - deprecated, use ASSISTANT_VOICE // "VOLUME_LEVEL" // "WAKE_SCREEN_FOR_NOTIFICATIONS" // "WALLPAPERS" @@ -11607,6 +11682,79 @@ type AssistantApiClientOpPropertiesDeviceModifySettingClientOpProperty struct { // "WIFI_ADD_NETWORK_QR_CODE" // "WIFI_CALLING" // "WIFI_HOTSPOT" - Duplicate, use HOT_SPOT instead + // "ACCESSIBILITY_SELECT_TO_SPEAK" - Accessibility > Select to Speak + // "CRISIS_ALERTS" - Safety > Crisis alerts + // "REGULATORY_LABELS" - Settings > About phone > Regulatory labels + // "SEND_FEEDBACK" - Settings > About phone > Send feedback about this + // device + // "OS_BUILD_NUMBER" + // "ACCESSIBILITY_SHORTCUTS" + // "ACCESSIBILITY_MENU" + // "ACCESSIBILITY_SOUND_AMPLIFIER" - Settings > Accessibility > + // Hearing > Sound Amplifier + // "ACCESSIBILITY_LIVE_TRANSCRIBE" + // "ACCESSIBILITY_SOUND_NOTIFICATIONS" + // "ACCESSIBILITY_TALKBACK" - Settings > Accessibility > TalkBack + // "ACCESSIBILITY_TIMEOUT" - Settings > Accessibility > Time to take + // action (Accessibility timeout) + // "CAMERA_SETTINGS" + // "BATTERY_SAVER_TOGGLE" + // "COVID_NOTIFICATIONS" - Settings > Google > COVID-19 Exposure + // Notifications + // "APP_LOCATION" + // "LOCATION_SERVICES" + // "PRIVATE_DNS" + // "UNRESTRICTED_DATA" - Settings > Network & Internet > Data Saver > + // Unrestricted data + // "PREFERRED_NETWORK" + // "NETWORK_PREFERENCES" + // "PASSWORDS_AND_ACCOUNTS" + // "PRIVACY_DASHBOARD" + // "MORE_SECURITY" + // "APP_PINNING" + // "CONFIRM_SIM_DELETION" + // "ENCRYPT_PHONE" - Settings > Security > Encrypt phone + // "FACE_UNLOCK" + // "INSTALL_UNKNOWN_APPS" + // "NOW_PLAYING" + // "STAY_AWAKE" + // "ASSISTANT_VOICE" + // "RESET_BLUETOOTH_WIFI" + // "DEFAULT_PHONE_APP" + // "GOOGLE_ACCOUNT" + // "ACCESSIBILITY_CAPTION_SIZE_AND_STYLE" - Settings > Accessibility > + // Caption preferences > Caption size and style + // "ACCESSIBILITY_CAPTION_STYLE" - Settings > Accessibility > Caption + // preferences > Caption size and style > Caption Style + // "ACCESSIBILITY_CAPTION_TEXT" - Settings > Accessibility > Caption + // preferences > Caption size and style > Text size + // "ACCESSIBILITY_CAPTION_PREFERENCES" - Settings > Accessibility > + // Caption preferences + // "ACCESSIBILITY_COLOR_AND_MOTION" - Settings > Accessibility > Color + // and motion + // "ACCESSIBILITY_BOLD_TEXT" - Settings > Accessibility > Display size + // and text > Bold text + // "LIVE_CAPTION" + // "POWER_BUTTON_ENDS_CALL" - Settings > Accessibility > Power button + // ends call + // "TOUCH_AND_HOLD_DELAY" + // "ACCESSIBILITY_VOICE_ACCESS" + // "SMS_PERMISSIONS" + // "SPECIAL_APP_ACCESS" - Settings > Apps & notifications > Advanced > + // Special app access + // "DARK_THEME_SCHEDULE" + // "LOCK_SCREEN_TEXT" - Settings > Display > Lock screen > Add text on + // lock screen + // "NIGHT_LIGHT_SCHEDULE" + // "AUTOFILL" + // "USAGE_AND_DIAGNOSTICS" + // "SENSITIVE_NOTIFICATIONS" + // "ENCRYPTION_AND_CREDENTIALS" - Settings > Security > Advanced + // settings > Encryption & credentials + // "SPACIAL_AUDIO" - Settings > Sound & vibration > Spatial Audio + // "RESET_OPTIONS" - Settings > System > Advanced > Reset options + // "QUICK_TAP" - Settings > System > Gestures > Quick tap + // "TIPS_AND_SUPPORT" - Settings > Tips & support // "ABOUT_PHONE" - Begin of NGA proto consistence // "ACCOUNTS" // "APPLICATION" @@ -20973,12 +21121,6 @@ type AssistantContextProviderId struct { // Knowledge Graph for all entities contained in its graph. Mid string `json:"mid,omitempty"` - // NaturalProviderId: Natural Provider Id returned from Provider Corpus. - // Note that feature teams should almost always use provider_corpus_id - // which is the canonical representation for provider. Surface-specific - // identiers should only be used in final surface rendering. - NaturalProviderId *AssistantContextProviderIdNaturalProviderId `json:"naturalProviderId,omitempty"` - // ProviderCorpusId: ID issued by the Provider Corpus to uniquely // identify a provider entity e.g. an Android app, a Cast app or a Cloud // provider. In practice, a single partner can have multiple providers @@ -21014,54 +21156,6 @@ func (s *AssistantContextProviderId) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// AssistantContextProviderIdNaturalProviderId: Represents how to -// naturally identify a provider. A copy of -// google3/assistant/serviceengine/proto/serving/natural_provider_id.prot -// o. -type AssistantContextProviderIdNaturalProviderId struct { - // ProviderType: ProviderType is an enum to represent the category of - // where this id is from. - // - // Possible values: - // "UNKNOWN" - // "CLOUD_PROJECT" - // "APP_ACTIONS" - // "WEBSITE" - // "NARRATIVE_NEWS" - // "IOS_BUNDLE" - // "CAST_APP" - // "ZEROTH_PARTY" - // "ANDROID_SYSTEM_API" - // "LLM_ACTIONS" - LLM_ACTIONS is for prototyping and development - // only. Do not use unless instructed. - ProviderType string `json:"providerType,omitempty"` - - // Value: String of provider_id_value is the actual value of the id. - Value string `json:"value,omitempty"` - - // ForceSendFields is a list of field names (e.g. "ProviderType") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "ProviderType") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *AssistantContextProviderIdNaturalProviderId) MarshalJSON() ([]byte, error) { - type NoMethod AssistantContextProviderIdNaturalProviderId - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // AssistantContextProviderVariant: Note: As of May 2021, multiple // providers use the same mids (e.g. YouTube Main, YouTube Go, and // YouTube Music all have the same mids). However, quite often we end up @@ -22666,6 +22760,48 @@ func (s *AssistantGroundingRankerGroundingProviderFeatures) MarshalJSON() ([]byt return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type AssistantGroundingRankerLaaFeature struct { + Name string `json:"name,omitempty"` + + Value float64 `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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Name") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *AssistantGroundingRankerLaaFeature) MarshalJSON() ([]byte, error) { + type NoMethod AssistantGroundingRankerLaaFeature + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +func (s *AssistantGroundingRankerLaaFeature) UnmarshalJSON(data []byte) error { + type NoMethod AssistantGroundingRankerLaaFeature + 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 +} + type AssistantGroundingRankerLaaFeatures struct { BindingSet *AssistantGroundingRankerLaaFeaturesBindingSet `json:"bindingSet,omitempty"` @@ -22673,6 +22809,8 @@ type AssistantGroundingRankerLaaFeatures struct { Contact *AssistantGroundingRankerLaaFeaturesContact `json:"contact,omitempty"` + Features []*AssistantGroundingRankerLaaFeature `json:"features,omitempty"` + Provider *AssistantGroundingRankerLaaFeaturesProvider `json:"provider,omitempty"` // ForceSendFields is a list of field names (e.g. "BindingSet") to @@ -23047,11 +23185,18 @@ func (s *AssistantGroundingRankerMediaGroundingProviderFeatures) UnmarshalJSON(d } // AssistantGroundingRankerPodcastGroundingProviderFeatures: Features to -// be extracted from Podcast GP for ranking in HGR. Next ID: 2 +// be extracted from Podcast GP for ranking in HGR. Next ID: 4 type AssistantGroundingRankerPodcastGroundingProviderFeatures struct { // IsExclusive: Whether the podcast is exclusive to a provider a not. IsExclusive bool `json:"isExclusive,omitempty"` + // ScubedNg3ModelScore: The relevance score from Scubed. + ScubedNg3ModelScore float64 `json:"scubedNg3ModelScore,omitempty"` + + // ScubedTstarScore: Tstar score is a signal that indicates the quality + // of the entity. + ScubedTstarScore float64 `json:"scubedTstarScore,omitempty"` + // ForceSendFields is a list of field names (e.g. "IsExclusive") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -23075,6 +23220,22 @@ func (s *AssistantGroundingRankerPodcastGroundingProviderFeatures) MarshalJSON() return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +func (s *AssistantGroundingRankerPodcastGroundingProviderFeatures) UnmarshalJSON(data []byte) error { + type NoMethod AssistantGroundingRankerPodcastGroundingProviderFeatures + var s1 struct { + ScubedNg3ModelScore gensupport.JSONFloat64 `json:"scubedNg3ModelScore"` + ScubedTstarScore gensupport.JSONFloat64 `json:"scubedTstarScore"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.ScubedNg3ModelScore = float64(s1.ScubedNg3ModelScore) + s.ScubedTstarScore = float64(s1.ScubedTstarScore) + return nil +} + // AssistantGroundingRankerProviderGroundingProviderFeatures: Features // to be extracted from Provider GP for ranking in HGR. Next ID: 5 type AssistantGroundingRankerProviderGroundingProviderFeatures struct { @@ -25356,7 +25517,7 @@ func (s *AssistantLogsTargetDeviceLog) MarshalJSON() ([]byte, error) { // AssistantPrefulfillmentRankerPrefulfillmentSignals: Signals to be // used by the Prefulfillment Ranker. Derived from the ParsingSignals // and GroundingSignals carried by the FunctionCall. LINT.IfChange Next -// ID: 48 +// ID: 51 type AssistantPrefulfillmentRankerPrefulfillmentSignals struct { // BindingSetAuis: Assistant User Interaction Score for binding set. BindingSetAuis float64 `json:"bindingSetAuis,omitempty"` @@ -25419,6 +25580,9 @@ type AssistantPrefulfillmentRankerPrefulfillmentSignals struct { // aggregated using intent name from exp laelaps. IntentNameAuisScoreExp float64 `json:"intentNameAuisScoreExp,omitempty"` + // IntentNamePauis: Intent level Pauis User Interaction Score. + IntentNamePauis float64 `json:"intentNamePauis,omitempty"` + // IsFeasible: Feasibility of fulfilling the binding set. Eg: For // PlayMedia, this is equivalent to playability. More details: // go/hgr-feasibility-feature. @@ -25437,6 +25601,9 @@ type AssistantPrefulfillmentRankerPrefulfillmentSignals struct { // IsPodcastIntent: Whether the intent is a podcast intent. IsPodcastIntent bool `json:"isPodcastIntent,omitempty"` + // IsVideoIntent: Whether the intent is a media object video intent. + IsVideoIntent bool `json:"isVideoIntent,omitempty"` + // KscorerRank: The rank order of the interpretation as determined by // kscorer. The kscorer-determined dominant interpretation, if any, gets // a rank of 0. The remaining N interpretations get a rank of 1 through @@ -25498,6 +25665,42 @@ type AssistantPrefulfillmentRankerPrefulfillmentSignals struct { // parsing score belongs in. ParsingScoreMse8BucketId int64 `json:"parsingScoreMse8BucketId,omitempty"` + // Phase: Query understanding phase the intent was produced in. + // + // Possible values: + // "QU_PHASE_UNSPECIFIED" - Invalid value to use as a default. + // "QU_PHASE_REQUEST" - Phase in which the QueryUnderstandingRequest + // for a non-identity Candidate is generated. Produces + // QueryCandidateInfo. + // "QU_PHASE_QREWRITE" - Phase in which QUS calls QRewrite. Produces + // QRewrite's reply. + // "QU_PHASE_QBT" - Phase in which QBT interpretations are ranked. + // Produces ranked QBT interpretations. + // "QU_PHASE_PROBE_QUERY" - Phase in which QUS does a probe query for + // incomplete search results and produces ranked RBT interpretations on + // the basis of these. Only runs if understand_mode is + // PRE_RESULT_AND_PROBE_QUERY. + // "QU_PHASE_MULTI_ACCOUNT" - Phase in which QUS does cross-account + // understanding. Produces AnalyzerResponse whose interpretations + // contain personal data from multiple accounts. + // "QU_PHASE_CQBT" - Deprecated, but see go/qus-contextual-ig for + // original purpose. + // "QU_PHASE_QBT_RESOLUTION" - Phase in which QUS calls resolution + // service to perform slow intent resolution. Produces resolved intents. + // "QU_PHASE_HIGH_PRECISION" - Phase in which QUS calls the fast + // HighPrecision workflow. Only runs if understand_mode is + // PRE_RESULT_AND_HIGH_PRECISION. + // "QU_PHASE_COMBINED_RBT_RESOLUTION" - Phase in which QUS combines + // the RBT result and Slow Resolution result. Only runs if + // understand_mode is PRE_RESULT_AND_PROBE_QUERY_AND_RESOLUTION. + // "QU_PHASE_ANALYZER_INPUT" - Phase in which QUS returns the + // AnalyzerInput as a separate Phase. It copies the AnalyzerInput from + // QU_PHASE_QREWRITE and returns it as a + // QueryUnderstandingStreamingResult for the purpose of logging in ACE. + // See go/analyzerinput-new-qus-phase. + // "QU_PHASE_NAGE" - Phase in which QUS runs NSP in the QUS. + Phase string `json:"phase,omitempty"` + // Pq2tVsAssistantIbstCosine: Cosine similarity between predicted // query-to-term model and assistant intent-type-based salient terms. // This is intended to be only used for ACE ranking and only populated @@ -25540,6 +25743,10 @@ type AssistantPrefulfillmentRankerPrefulfillmentSignals struct { // experimental calibrated HGR model for Comms. // "RANKER_NAME_CONSOLIDATED_PFR_HGR_V2_COMMS_CALIBRATED" - Name for // consolidated PFR, HGRv2 and comms ranker. + // "RANKER_NAME_EXPERIMENTAL_PFR_SAGE_NEW_DOMAINS" - Name for + // experimental PFR ranker for Sage and new domains. + // "RANKER_NAME_BUCKETED_PARSING_SCORE_FOR_SMARTHOME" - Name for PFR + // ranker with bucketed parsing scores for SmartHome. RankerName string `json:"rankerName,omitempty"` // SearchDispatch: The determination made by the SearchDispatchingConfig @@ -25616,6 +25823,7 @@ func (s *AssistantPrefulfillmentRankerPrefulfillmentSignals) UnmarshalJSON(data InQueryMaxEffectiveArgSpanLength gensupport.JSONFloat64 `json:"inQueryMaxEffectiveArgSpanLength"` IntentNameAuisScore gensupport.JSONFloat64 `json:"intentNameAuisScore"` IntentNameAuisScoreExp gensupport.JSONFloat64 `json:"intentNameAuisScoreExp"` + IntentNamePauis gensupport.JSONFloat64 `json:"intentNamePauis"` MaxHgrScoreAcrossBindingSets gensupport.JSONFloat64 `json:"maxHgrScoreAcrossBindingSets"` NumAlternativeHypothesis gensupport.JSONFloat64 `json:"numAlternativeHypothesis"` NumConstraints gensupport.JSONFloat64 `json:"numConstraints"` @@ -25643,6 +25851,7 @@ func (s *AssistantPrefulfillmentRankerPrefulfillmentSignals) UnmarshalJSON(data s.InQueryMaxEffectiveArgSpanLength = float64(s1.InQueryMaxEffectiveArgSpanLength) s.IntentNameAuisScore = float64(s1.IntentNameAuisScore) s.IntentNameAuisScoreExp = float64(s1.IntentNameAuisScoreExp) + s.IntentNamePauis = float64(s1.IntentNamePauis) s.MaxHgrScoreAcrossBindingSets = float64(s1.MaxHgrScoreAcrossBindingSets) s.NumAlternativeHypothesis = float64(s1.NumAlternativeHypothesis) s.NumConstraints = float64(s1.NumConstraints) @@ -28393,7 +28602,7 @@ func (s *ClassifierPornReferrerCounts) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ClassifierPornSiteData: Next ID: 52 +// ClassifierPornSiteData: Next ID: 53 type ClassifierPornSiteData struct { // AvgPedoPageScore: The average pedo page score for the site. AvgPedoPageScore float64 `json:"avgPedoPageScore,omitempty"` @@ -28419,6 +28628,10 @@ type ClassifierPornSiteData struct { Versionedscore []*ClassifierPornSiteDataVersionedScore `json:"versionedscore,omitempty"` + // ViolenceScore: The cubic mean aggregation of violence page scores in + // the site. + ViolenceScore float64 `json:"violenceScore,omitempty"` + ViolenceStats *ClassifierPornSiteViolenceStats `json:"violenceStats,omitempty"` // ForceSendFields is a list of field names (e.g. "AvgPedoPageScore") to @@ -28452,6 +28665,7 @@ func (s *ClassifierPornSiteData) UnmarshalJSON(data []byte) error { FinalPedoSiteScore gensupport.JSONFloat64 `json:"finalPedoSiteScore"` SitePornRatio gensupport.JSONFloat64 `json:"sitePornRatio"` SiteSoftpornRatio gensupport.JSONFloat64 `json:"siteSoftpornRatio"` + ViolenceScore gensupport.JSONFloat64 `json:"violenceScore"` *NoMethod } s1.NoMethod = (*NoMethod)(s) @@ -28462,6 +28676,7 @@ func (s *ClassifierPornSiteData) UnmarshalJSON(data []byte) error { s.FinalPedoSiteScore = float64(s1.FinalPedoSiteScore) s.SitePornRatio = float64(s1.SitePornRatio) s.SiteSoftpornRatio = float64(s1.SiteSoftpornRatio) + s.ViolenceScore = float64(s1.ViolenceScore) return nil } @@ -50160,12 +50375,13 @@ type GeostoreSegmentProto struct { // Lane: Detailed information about each lane in this direction, if // available. Lanes are numbered from inside of the road outward, i.e. - // the lane next to the center line is lane 0. Note that lanes that are - // valid for travel in both directions appear in both segments of a - // segment pair (left turn lanes, one-lane roads, some passing lanes, - // reversing lanes). Some lanes may not be usable by cars, such as bike - // lanes. Also, some lanes may not exist along the entire segment, e.g. - // left- or right-turn lanes that appear just before the intersection. + // the lane next to the center line has lane_number 0. Note that lanes + // that are valid for travel in both directions appear in both segments + // of a segment pair (left turn lanes, one-lane roads, some passing + // lanes, reversing lanes). Some lanes may not be usable by cars, such + // as bike lanes. Also, some lanes may not exist along the entire + // segment, e.g. left- or right-turn lanes that appear just before the + // intersection. Lane []*GeostoreLaneProto `json:"lane,omitempty"` // LegalMaximumSpeed: The legal maximum, legal minimum, and advisory @@ -54899,7 +55115,7 @@ func (s *GoogleAssistantAccessoryV1DeviceConfig) MarshalJSON() ([]byte, error) { // GoogleAssistantAccessoryV1DeviceState: Information about the state of // the device. This contains any state that Assistant may need to know // about in order to fulfill requests, for example which timers and -// alarms are set. Next ID: 9 +// alarms are set. Next ID: 10 type GoogleAssistantAccessoryV1DeviceState struct { // AlarmState: *Optional* Information about on-device alarms. For // devices that support alarms, all on-device alarms must be sent up @@ -56344,6 +56560,10 @@ type GoogleCloudContentwarehouseV1Document struct { // DisplayUri: Uri to display the document, for example, in the UI. DisplayUri string `json:"displayUri,omitempty"` + // DispositionTime: Output only. If linked to a Collection with + // RetentionPolicy, the date when the document becomes mutable. + DispositionTime string `json:"dispositionTime,omitempty"` + // DocumentSchemaName: The Document schema name. Format: // projects/{project_number}/locations/{location}/documentSchemas/{docume // nt_schema_id}. @@ -58530,6 +58750,9 @@ type GoogleCloudContentwarehouseV1RunPipelineMetadataExportToCdwPipelineMetadata // to be exported. Documents []string `json:"documents,omitempty"` + // OutputPath: The output Cloud Storage folder in this pipeline. + OutputPath string `json:"outputPath,omitempty"` + // ForceSendFields is a list of field names (e.g. "DocAiDataset") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -59682,8 +59905,8 @@ type GoogleCloudDocumentaiV1Document struct { // Uri: Optional. Currently supports Google Cloud Storage URI of the // form `gs://bucket_name/object_name`. Object versioning is not - // supported. See Google Cloud Storage Request URIs - // (https://cloud.google.com/storage/docs/reference-uris) for more info. + // supported. For more information, refer to Google Cloud Storage + // Request URIs (https://cloud.google.com/storage/docs/reference-uris). Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -60868,17 +61091,18 @@ type GoogleCloudDocumentaiV1DocumentPageTokenStyleInfo struct { // BackgroundColor: Color of the background. BackgroundColor *GoogleTypeColor `json:"backgroundColor,omitempty"` - // Bold: Whether the text is bold (equivalent to font weight >= 700). + // Bold: Whether the text is bold (equivalent to font_weight is at least + // `700`). Bold bool `json:"bold,omitempty"` - // FontSize: Font size in points (1 point is 1/72"). + // FontSize: Font size in points (`1` point is `¹⁄₇₂` inches). FontSize int64 `json:"fontSize,omitempty"` // FontType: Name or style of the font. FontType string `json:"fontType,omitempty"` - // FontWeight: TrueType weight on a scale 100 (Thin) to 1000 - // (Ultra-heavy). Normal is 400, Bold is 700. + // FontWeight: TrueType weight on a scale `100` (thin) to `1000` + // (ultra-heavy). Normal is `400`, bold is `700`. FontWeight int64 `json:"fontWeight,omitempty"` // Handwritten: Whether the text is handwritten. @@ -60890,11 +61114,11 @@ type GoogleCloudDocumentaiV1DocumentPageTokenStyleInfo struct { // LetterSpacing: Letter spacing in points. LetterSpacing float64 `json:"letterSpacing,omitempty"` - // PixelFontSize: Font size in pixels, equal to unrounded_fontsize * - // resolution / 72.0. + // PixelFontSize: Font size in pixels, equal to _unrounded font_size_ * + // _resolution_ ÷ `72.0`. PixelFontSize float64 `json:"pixelFontSize,omitempty"` - // Smallcaps: Whether the text are small caps. + // Smallcaps: Whether the text is in small caps. Smallcaps bool `json:"smallcaps,omitempty"` // Strikeout: Whether the text is strikethrough. @@ -77409,7 +77633,7 @@ func (s *KnowledgeAnswersIntentQueryArgumentProvenanceSearchAnswerValue) Marshal } // KnowledgeAnswersIntentQueryArgumentSignals: A message representing -// the signals associated with an argument. NEXT ID TO USE: 57 For +// the signals associated with an argument. NEXT ID TO USE: 58 For // //depot/google3/logs/proto/knowledge/interpretation/intent_query.proto // // in the "ThenChange", fields under Argument.signals in the serving @@ -77628,6 +77852,8 @@ type KnowledgeAnswersIntentQueryArgumentSignals struct { // president] ResolvedFromPronoun bool `json:"resolvedFromPronoun,omitempty"` + ResponseMeaningSignals *KnowledgeAnswersIntentQueryResponseMeaningSignalsResponseMeaningSignals `json:"responseMeaningSignals,omitempty"` + // ResultSupport: The list of result supports for this Argument. ResultSupport []*UniversalsearchNewPackerKnowledgeResultSupport `json:"resultSupport,omitempty"` @@ -79318,26 +79544,75 @@ func (s *KnowledgeAnswersIntentQueryRelatednessSignals) UnmarshalJSON(data []byt return nil } +type KnowledgeAnswersIntentQueryResponseMeaningSignalsAnswersHeaderSignals struct { + // Possible values: + // "UNKNOWN" + // "FEMALE" + // "MALE" + AnswersValueGender string `json:"answersValueGender,omitempty"` + + NumAnswers uint64 `json:"numAnswers,omitempty,string"` + + // ForceSendFields is a list of field names (e.g. "AnswersValueGender") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AnswersValueGender") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *KnowledgeAnswersIntentQueryResponseMeaningSignalsAnswersHeaderSignals) MarshalJSON() ([]byte, error) { + type NoMethod KnowledgeAnswersIntentQueryResponseMeaningSignalsAnswersHeaderSignals + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // KnowledgeAnswersIntentQueryResponseMeaningSignalsResponseMeaningSignal // s: SRM signal data. Properties here should be nonsemantic. Semantic // properties should be modeled directly in the SRM. type KnowledgeAnswersIntentQueryResponseMeaningSignalsResponseMeaningSignals struct { + // AnswersHeaderSignals: Signals that are used to generate answers + // header. + AnswersHeaderSignals *KnowledgeAnswersIntentQueryResponseMeaningSignalsAnswersHeaderSignals `json:"answersHeaderSignals,omitempty"` + PropertyValue []*FreebasePropertyValue `json:"propertyValue,omitempty"` - // ForceSendFields is a list of field names (e.g. "PropertyValue") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. + // ResponseMeaningApplication: The intended application this response + // meaning is used for. It is intended for downstream dispatching. + // + // Possible values: + // "DEFAULT" + // "HEADER" + // "VOICE_ANSWERS" + // "DISPLAY_ANSWERS" + ResponseMeaningApplication string `json:"responseMeaningApplication,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "AnswersHeaderSignals") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PropertyValue") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. + // NullFields is a list of field names (e.g. "AnswersHeaderSignals") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. NullFields []string `json:"-"` } @@ -100989,6 +101264,7 @@ type PeoplestackFlexorgsProtoInternalExternal struct { // nudges-campaign-manager-team@google.com // "DECS" - Decs Team contact: decs-eng@google.com // "GSOX_MOCHI" - Gsox Mochi Team contact: fintechops-eng@google.com + // "PMW_TI" - Pmw Ti Team contact: pmw-ti // "DEPRECATED_QUICKSTART_FLUME" // "DUO_CLIENT" - Duo Client Team contact: duo-eng@google.com // "ALBERT" - Project albert (go/albert-frontend) Team contact: @@ -108128,7 +108404,7 @@ func (s *QualityDniExtendedNewsPreviews) MarshalJSON() ([]byte, error) { // QualityFringeFringeQueryPriorPerDocData: PerDocData for // fringe-query-prior (built into the shards for eventual consumption at -// Fringe classification time). Not stored in DocJoins. NEXT ID: 11 +// Fringe classification time). Not stored in DocJoins. NEXT ID: 12 type QualityFringeFringeQueryPriorPerDocData struct { EncodedCalibratedFringeSitePriorScore int64 `json:"encodedCalibratedFringeSitePriorScore,omitempty"` @@ -108190,6 +108466,11 @@ type QualityFringeFringeQueryPriorPerDocData struct { // to restrict visibility. EncodedProximityScore int64 `json:"encodedProximityScore,omitempty"` + // SensitiveEntitiesIndices: Indices on the + // repository_webref::WebrefEntities::entity field of entities that + // represent a person or a group of people (aka sensitive entities). + SensitiveEntitiesIndices []int64 `json:"sensitiveEntitiesIndices,omitempty"` + // ForceSendFields is a list of field names (e.g. // "EncodedCalibratedFringeSitePriorScore") to unconditionally include // in API requests. By default, fields with empty or default values are @@ -109391,9 +109672,6 @@ type QualityNsrNsrData struct { Url string `json:"url,omitempty"` - // VersionedAsrData: Versioned map of ASR (authenticity) values. - VersionedAsrData []*QualityNsrVersionedFloatSignal `json:"versionedAsrData,omitempty"` - // VersionedData: Versioned map of NSR values for experimenting with the // next release. VersionedData []*QualityNsrNSRVersionedData `json:"versionedData,omitempty"` @@ -112996,13 +113274,13 @@ type QualitySalientTermsSalientTermSet struct { // "V5" - Lyrebird V5: Salient Terms V5 (ariane/4076831) // "V5_1" - Lyrebird V5.1: Salient Terms V5.1 (ariane/4144754) // "V5_2" - Lyrebird V5.2: Salient Terms V5.2 (ariane/4218250) + // "V5_3" - Lyrebird V5.3: Salient Terms V5.3 (ariane/4246904) // "V1_BODYONLY" - Lyrebird BodyOnly V1. // "V2_BODYONLY" - Experimental version of Lyrebird BodyOnly V2. - // "RENAME_ME_TO_ADD_NEW_ENUM_16" - Dummy enum values to be renamed + // "RENAME_ME_TO_ADD_NEW_ENUM_17" - Dummy enum values to be renamed // when a new enum value is needed. Note that this is a requirement from // go/cds-schema-council. If you rename one of these enum values, be // sure to add (at least one) more below. - // "RENAME_ME_TO_ADD_NEW_ENUM_17" // "RENAME_ME_TO_ADD_NEW_ENUM_18" // "RENAME_ME_TO_ADD_NEW_ENUM_19" // "RENAME_ME_TO_ADD_NEW_ENUM_20" @@ -113011,6 +113289,7 @@ type QualitySalientTermsSalientTermSet struct { // "RENAME_ME_TO_ADD_NEW_ENUM_23" // "RENAME_ME_TO_ADD_NEW_ENUM_24" // "RENAME_ME_TO_ADD_NEW_ENUM_25" + // "RENAME_ME_TO_ADD_NEW_ENUM_26" Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "DocData") to @@ -118524,10 +118803,6 @@ type RepositoryWebrefEntityNameScore struct { // (e.g. for demo/debug). DebugVariantSignals []*RepositoryWebrefPreprocessingNameVariantSignals `json:"debugVariantSignals,omitempty"` - // Entity: Sparse metadata about the entity, usage should be moved back - // to individual fields, this avoids having cyclic dependencies. - Entity *RepositoryWebrefEntityJoin `json:"entity,omitempty"` - // ExtendedScoreRatio: Stores region specific score ratios for the // entity when it is significantly different from the language version // above. @@ -124744,7 +125019,11 @@ type RepositoryWebrefWebrefEntity struct { // Collections: Information about the collections of this entity. Collections *RepositoryWebrefWebrefEntityCollections `json:"collections,omitempty"` - // EntityJoin: Metadata and raw signals used by the annotator. + // EntityJoin: Metadata and raw signals used by the annotator. Intended + // for internal use. Steer clear of adding new dependencies on fields in + // this proto, especially external dependencies. If you are a Refx + // client and would like to consume entity metadata, consider querying + // TopicServer instead. EntityJoin *RepositoryWebrefEntityJoin `json:"entityJoin,omitempty"` // Id: An identifier (usually a MID) for the entity. Consider using @@ -132760,6 +133039,58 @@ func (s *SocialCommonLinkData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// SocialCommonSearchLinkData: SearchLink metadata, for SEARCH_LINK +// segments. For a search link, the "text" field should contain the +// display text. This is currently not indexed. +type SocialCommonSearchLinkData struct { + // KgEntityConfidence: For lightweight scoring in serving time. + KgEntityConfidence float64 `json:"kgEntityConfidence,omitempty"` + + // Mid: MID of the KG entity being linked. + Mid string `json:"mid,omitempty"` + + QueryBroadnessScore float64 `json:"queryBroadnessScore,omitempty"` + + // ForceSendFields is a list of field names (e.g. "KgEntityConfidence") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "KgEntityConfidence") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *SocialCommonSearchLinkData) MarshalJSON() ([]byte, error) { + type NoMethod SocialCommonSearchLinkData + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +func (s *SocialCommonSearchLinkData) UnmarshalJSON(data []byte) error { + type NoMethod SocialCommonSearchLinkData + var s1 struct { + KgEntityConfidence gensupport.JSONFloat64 `json:"kgEntityConfidence"` + QueryBroadnessScore gensupport.JSONFloat64 `json:"queryBroadnessScore"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.KgEntityConfidence = float64(s1.KgEntityConfidence) + s.QueryBroadnessScore = float64(s1.QueryBroadnessScore) + return nil +} + type SocialCommonSegment struct { // Formatting: Formatting to be applied when rendering the Segment. For // all segment types, this is the standard way of representing that the @@ -132774,6 +133105,9 @@ type SocialCommonSegment struct { // type of the Segment. For LINK type: LinkData *SocialCommonLinkData `json:"linkData,omitempty"` + // SearchLinkData: For SEARCH_LINK type: + SearchLinkData *SocialCommonSearchLinkData `json:"searchLinkData,omitempty"` + // Text: Text content of the Segment. As a general rule, this field // should contain the actual text that should be rendered in the UI. // Thus, for a hashtag, it should be "#Foo", and for a link, it should @@ -132823,6 +133157,11 @@ type SocialCommonSegment struct { // a topic. The "text" field should represent display text (e.g. // "#Google"), and additional metadata should be put in the Segment's // hashtag_data field. + // "SEARCH_LINK" - A SEARCH_LINK segment respresents a link to search + // results for a KG entity. The "text" field should represent the part + // of the comment where the KG entity is extracted from, and additional + // metadata of the entity should be put in the Segment's + // search_link_data field. Type string `json:"type,omitempty"` // UserMentionData: For USER_MENTION type: @@ -135500,12 +135839,15 @@ type SocialGraphWireProtoPeopleapiExtensionDynamiteExtendedData struct { // "BOT" - Dynamite bot. EntityType string `json:"entityType,omitempty"` - // MemberCount: Number of members (direct or indirect) in a Google - // Group. Only an estimate for large groups (currently > 1K direct / - // indirect members). + // IsMembershipVisibleToCaller: Whether caller has visibility into the + // direct members of the roster. NEXT TAG: 11 + IsMembershipVisibleToCaller bool `json:"isMembershipVisibleToCaller,omitempty"` + + // MemberCount: DEPRECATED: use segmented_membership_counts instead. + // Number of members (direct or indirect) in a Google Group. Only an + // estimate for large groups (currently > 1K direct / indirect members). MemberCount int64 `json:"memberCount,omitempty,string"` - // OrganizationInfo: NEXT TAG: 9 OrganizationInfo *AppsDynamiteSharedOrganizationInfo `json:"organizationInfo,omitempty"` // Possible values: @@ -135520,6 +135862,11 @@ type SocialGraphWireProtoPeopleapiExtensionDynamiteExtendedData struct { // https://support.google.com/hangouts/answer/6083257?hl=en). Presence string `json:"presence,omitempty"` + // SegmentedMembershipCounts: Represents the direct membership counts of + // a Google Group. May contain counts based on member type and + // membership state. + SegmentedMembershipCounts *AppsDynamiteSharedSegmentedMembershipCounts `json:"segmentedMembershipCounts,omitempty"` + // ForceSendFields is a list of field names (e.g. "AvatarUrl") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -137164,6 +137511,10 @@ type StorageGraphBfgTripleProvenance struct { // Assign existing KG entities feature types to classify triggering // behavior and insights. Owned by salehh@ and s12y-eng@ See // go/rii-kg-triggering-migration for more information. + // "ISOLATION_SCOUTS_SOCIETAL_CONTEXT_ENTITIES" - Access controls for + // SCOUTS Societal Context Repository entities. Please contact + // johnhenry-eng@ before reading or writing this data. DD: + // go/scouts-kg-integration-dd // "UMP_TESTING_ONLY" - This access control is used to guard data used // by the Unified Media Platform team (ke-media-actions-serving@) for // testing new features. It should never be used for purposes other than @@ -141221,6 +141572,7 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // "GEARHEAD_WORK_PROFILE_QUERYING_ALLOWED" - Indicates Android Auto // has permission to query work data, and show it to the user // "PLAY_ADS_REENGAGEMENT_COUNTERFACTUAL" + // "PLAY_ADS_THIRD_LIST_VIEW_ADS_COUNTERFACTUAL" // "GEARHEAD_TOOLTIP_ASSISTANT_LAUNCHER_OPEN" // "GEARHEAD_MULTIPLE_CALLABLE_PHONE_ACCOUNTS_DETECTED" - Indicates // that Android Auto has detected multiple phone accounts, which are @@ -141444,6 +141796,22 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // between 4GB and 6GB. // "RAM_6GB_AND_MORE_EVENT_LEVEL" - Event level test code for RAM // between 6GB and more. + // "LOW_STORAGE_AT_INSTALL_PREPROCESSING_EVENT_LEVEL" - Low storage at + // install preprocessing stage. + // "DSA_P13N_OPTED_IN_AT_EVENT_LEVEL" - Event-level test code for DSA + // p13n opt in. + // "DSA_P13N_OPTED_OUT_AT_EVENT_LEVEL" - Event-level test code for DSA + // p13n opt out. + // "USER_P13N_SETTING_UNSPECIFIED_AT_EVENT_LEVEL" - Event-level test + // code corresponding to + // com.google.play.consent.proto.Setting.SETTING_UNSPECIFIED. + // "USER_P13N_SETTING_ON_AT_EVENT_LEVEL" - Event-level test code + // corresponding to com.google.play.consent.proto.Setting.SETTING_ON. + // "USER_P13N_SETTING_OFF_AT_EVENT_LEVEL" - Event-level test code + // corresponding to com.google.play.consent.proto.Setting.SETTING_OFF. + // "BATTLESTAR_GAME_IN_MDP_EVENT_LEVEL" - Event-level test code + // corresponding to an MDP showing for a game also available on + // Battlestar. // "EVENT_LEVEL_TEST_CODE_LIMIT" // "ENTERTAINMENT_CLUSTER_TRIGGERING_AT_SESSION_LEVEL" // "BEST_SELLER_CART_TAG_AT_SESSION_LEVEL" @@ -142317,6 +142685,29 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // "MDP_WITH_LIVE_OPS_NEVER_INSTALLED_USERS_SESSION_LEVEL" - Session // level test codes for logging MDP with LiveOps shown to users who have // never installed the app on SERP. + // "LOW_STORAGE_AT_INSTALL_PREPROCESSING_SESSION_LEVEL" - Low storage + // at install preprocessing stage. + // "DSA_P13N_OPTED_IN_AT_SESSION_LEVEL" - Session-level test code for + // DSA p13n opt in. + // "DSA_P13N_OPTED_OUT_AT_SESSION_LEVEL" - Session-level test code for + // DSA p13n opt out. + // "LANGUAGE_SWITCHER_SERVED_SESSION_LEVEL" - Session level test code + // for Language Switcher indicating that the user was served with the + // module on cart screen. + // + // "HAS_INSUFFICIENT_STORED_VALUE_BALANCE_BEFORE_RENEWAL_SESSION_LEVEL" + // - Session level test code that indicates the stored value balance is + // insufficient for next renewal. + // "USER_P13N_SETTING_UNSPECIFIED_AT_SESSION_LEVEL" - Session-level + // test code corresponding to + // com.google.play.consent.proto.Setting.SETTING_UNSPECIFIED. + // "USER_P13N_SETTING_ON_AT_SESSION_LEVEL" - Session-level test code + // corresponding to com.google.play.consent.proto.Setting.SETTING_ON. + // "USER_P13N_SETTING_OFF_AT_SESSION_LEVEL" - Session-level test code + // corresponding to com.google.play.consent.proto.Setting.SETTING_OFF. + // "BATTLESTAR_GAME_IN_MDP_SESSION_LEVEL" - Session-level test code + // corresponding to an MDP showing for a game also available on + // Battlestar. // "SESSION_LEVEL_TEST_CODE_LIMIT" // "CART_ABANDONMENT_USER_LEVEL" - Cart abandonment flow for purchase // flow. @@ -142509,6 +142900,7 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // "GE_IS_SCHEDULED_COFFEE_CARD" // "GE_IS_SCHEDULED_QUEST" // "GE_IS_SCHEDULED_LOYALTY_MULTIPLIER" + // "GE_IS_USER_OPT_IN_P13N" - Test codes for GE DSA opt-in users. // "IAP_SKU_DEALS_LIVE_OP_DEALS_HOME_USER_LEVEL" - User level test // code for tracking users who should see the IAP Sku Deals liveops // card. @@ -142775,6 +143167,24 @@ type VendingConsumerProtoTrustedGenomeAnnotation struct { // for DMA PreConsent experiment. go/playpreconsent // "DMA_PRE_CONSENT_DECISION_MADE_USER_LEVEL" // "DMA_PRE_CONSENT_FLOW_DISMISSED_USER_LEVEL" + // "DSA_P13N_OPTED_IN_AT_USER_LEVEL" - User-level test code for DSA + // p13n opt in. + // "DSA_P13N_OPTED_OUT_AT_USER_LEVEL" - User-level test code for DSA + // p13n opt out. + // "LIVEOPS_INSTALL_NOTIFICATION_USER_LEVEL" - User level test code + // for live-ops install notification experiments. If GE decision changed + // after enabling ranking using the notification install model + // prediction, log test code. + // "USER_P13N_SETTING_UNSPECIFIED_AT_USER_LEVEL" - User-level test + // code corresponding to + // com.google.play.consent.proto.Setting.SETTING_UNSPECIFIED. + // "USER_P13N_SETTING_ON_AT_USER_LEVEL" - User-level test code + // corresponding to com.google.play.consent.proto.Setting.SETTING_ON. + // "USER_P13N_SETTING_OFF_AT_USER_LEVEL" - User-level test code + // corresponding to com.google.play.consent.proto.Setting.SETTING_OFF. + // "LIVEOPS_CLUSTER_SERP_TRIGGERING_USER_LEVEL" - User level test code + // for cat search live ops cluster triggering. Add new user-level + // TestCode here. // "USER_LEVEL_TEST_CODE_LIMIT" TestCode []string `json:"testCode,omitempty"` @@ -150183,6 +150593,38 @@ func (s *VideoFileSphericalMetadataViewDirection) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// VideoGoogleVideoClipInfo: YT app video information. +// (go/yt-create-vsi-data) +type VideoGoogleVideoClipInfo struct { + // AppVersion: YT app version (ie. YT Create app version). + AppVersion string `json:"appVersion,omitempty"` + + // AssetLoggingId: List of YT media asset logging ids. + AssetLoggingId []string `json:"assetLoggingId,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AppVersion") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AppVersion") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VideoGoogleVideoClipInfo) MarshalJSON() ([]byte, error) { + type NoMethod VideoGoogleVideoClipInfo + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + type VideoLegosLegosAnnotationsSet struct { FeatureSetName string `json:"featureSetName,omitempty"` @@ -151117,7 +151559,7 @@ func (s *VideoThumbnailsFrameFileList) MarshalJSON() ([]byte, error) { } // VideoThumbnailsThumbnailScore: LINT.IfChange Score calculated from a -// thumbnail. NextID: 15 +// thumbnail. NextID: 16 type VideoThumbnailsThumbnailScore struct { // Checksum: Checksum of the thumbnail bytes used to identify which // image the score belongs to. Only filled when thumbnail version is 0. @@ -151134,6 +151576,19 @@ type VideoThumbnailsThumbnailScore struct { // DenseGeneralExtraFeatures: FeatureExtra extension for dense features. DenseGeneralExtraFeatures *DrishtiFeatureExtra `json:"denseGeneralExtraFeatures,omitempty"` + // ExternalImageId: A unique identifier for the image that is + // independent of the resolution. The Image ID accompanies the image + // bytes through its lifecycle, from creation till vanishing. Image ID + // is not based on image content; it is different than checksum (e.g. + // two different images with the same bytes may not have the same image + // ID). This ID is used as a unique identifier for clients such as T&S + // and classifiers. For more info refer to go/thumbnail-id-ts-ab-testing + // Note: Image ID's are still in development and are currently not + // exposed externally (may be done in the future). Please contact + // yt-thumbnails-core@ before using it. Do not use externally or in logs + // before contacting yt-thumbnails-core@ + ExternalImageId string `json:"externalImageId,omitempty"` + // IsAssigned: If true, score is manually assigned. IsAssigned bool `json:"isAssigned,omitempty"` @@ -151754,7 +152209,7 @@ func (s *VideoVideoStream) UnmarshalJSON(data []byte) error { // fps, etc. are not guaranteed to be the same as those of transcodes. // If the relevant info in source is too broken, the corresponding // fields (e.g., lengths) could be unset or with the default value, -// meaning VSI cannot compute them from the given info. Next id: 82 +// meaning VSI cannot compute them from the given info. Next id: 83 type VideoVideoStreamInfo struct { // AudioBitrate: audio bitrate in bits/s AudioBitrate float64 `json:"audioBitrate,omitempty"` @@ -152269,7 +152724,7 @@ type VideoVideoStreamInfo struct { // AvDistance: Audio-Video interleaving distance between packets (in // bytes) - AvDistance int64 `json:"avDistance,omitempty"` + AvDistance int64 `json:"avDistance,omitempty,string"` // AvLength: Audio and video length in seconds. It's the max of the // audio and video length. Note that when the VSI is from users videos, @@ -152628,6 +153083,9 @@ type VideoVideoStreamInfo struct { // and libmagic. FileType int64 `json:"fileType,omitempty"` + // GoogleVideoClipInfo: YT app created video information, + GoogleVideoClipInfo *VideoGoogleVideoClipInfo `json:"googleVideoClipInfo,omitempty"` + ImageStream []*VideoVideoStreamInfoVideoStream `json:"imageStream,omitempty"` // IsAsf: True if the video is likely to be an ASF file. @@ -159395,6 +159853,10 @@ type YoutubeDiscoveryLegosLegosSemanticRelationshipContext struct { // "GEO_LEGOS_TEST_SET_V2_TRAVEL_DESTINATIONS" // "GEO_LEGOS_TEST_SET_V2_DINING" // "GEO_LEGOS_TEST_SET_V2_HOTEL" + // "TRAVEL_INTEREST" - A broad travel lego context stands for travel + // experiences, activities etc. This is not about a geo location but + // more of a reason why people want to visit a place. For example, + // "amusement park", "surfing", "honeymoon". Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Subject") to diff --git a/dataflow/v1b3/dataflow-api.json b/dataflow/v1b3/dataflow-api.json index 15a32bb546f..772abaa9e0d 100644 --- a/dataflow/v1b3/dataflow-api.json +++ b/dataflow/v1b3/dataflow-api.json @@ -2211,7 +2211,7 @@ } } }, - "revision": "20230327", + "revision": "20230427", "rootUrl": "https://dataflow.googleapis.com/", "schemas": { "ApproximateProgress": { @@ -3838,6 +3838,10 @@ ], "type": "string" }, + "runtimeUpdatableParams": { + "$ref": "RuntimeUpdatableParams", + "description": "This field may ONLY be modified at runtime using the projects.jobs.update method to adjust job behavior. This field has no effect when specified at job creation." + }, "satisfiesPzs": { "description": "Reserved for future use. This field is set only in responses from the server; it is ignored if it is set in any requests.", "type": "boolean" @@ -4727,7 +4731,10 @@ "PUBSUB_TOPIC", "PUBSUB_SUBSCRIPTION", "BIGQUERY_TABLE", - "JAVASCRIPT_UDF_FILE" + "JAVASCRIPT_UDF_FILE", + "SERVICE_ACCOUNT", + "MACHINE_TYPE", + "KMS_KEY_NAME" ], "enumDescriptions": [ "Default input type.", @@ -4741,7 +4748,10 @@ "The parameter specifies a Pub/Sub Topic.", "The parameter specifies a Pub/Sub Subscription.", "The parameter specifies a BigQuery table.", - "The parameter specifies a JavaScript UDF in Cloud Storage." + "The parameter specifies a JavaScript UDF in Cloud Storage.", + "The parameter specifies a Service Account email.", + "The parameter specifies a Machine Type.", + "The parameter specifies a KMS Key name." ], "type": "string" }, @@ -5204,6 +5214,23 @@ }, "type": "object" }, + "RuntimeUpdatableParams": { + "description": "Additional job parameters that can only be updated during runtime using the projects.jobs.update method. These fields have no effect when specified during job creation.", + "id": "RuntimeUpdatableParams", + "properties": { + "maxNumWorkers": { + "description": "The maximum number of workers to cap autoscaling at. This field is currently only supported for Streaming Engine jobs.", + "format": "int32", + "type": "integer" + }, + "minNumWorkers": { + "description": "The minimum number of workers to scale down to. This field is currently only supported for Streaming Engine jobs.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "SDKInfo": { "description": "SDK Information.", "id": "SDKInfo", diff --git a/dataflow/v1b3/dataflow-gen.go b/dataflow/v1b3/dataflow-gen.go index 7fa1e174a8d..363d3e42e53 100644 --- a/dataflow/v1b3/dataflow-gen.go +++ b/dataflow/v1b3/dataflow-gen.go @@ -2977,6 +2977,11 @@ type Job struct { // interested. RequestedState string `json:"requestedState,omitempty"` + // RuntimeUpdatableParams: This field may ONLY be modified at runtime + // using the projects.jobs.update method to adjust job behavior. This + // field has no effect when specified at job creation. + RuntimeUpdatableParams *RuntimeUpdatableParams `json:"runtimeUpdatableParams,omitempty"` + // SatisfiesPzs: Reserved for future use. This field is set only in // responses from the server; it is ignored if it is set in any // requests. @@ -4386,6 +4391,10 @@ type ParameterMetadata struct { // "BIGQUERY_TABLE" - The parameter specifies a BigQuery table. // "JAVASCRIPT_UDF_FILE" - The parameter specifies a JavaScript UDF in // Cloud Storage. + // "SERVICE_ACCOUNT" - The parameter specifies a Service Account + // email. + // "MACHINE_TYPE" - The parameter specifies a Machine Type. + // "KMS_KEY_NAME" - The parameter specifies a KMS Key name. ParamType string `json:"paramType,omitempty"` // ParentName: Optional. Specifies the name of the parent parameter. @@ -5142,6 +5151,41 @@ func (s *RuntimeMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// RuntimeUpdatableParams: Additional job parameters that can only be +// updated during runtime using the projects.jobs.update method. These +// fields have no effect when specified during job creation. +type RuntimeUpdatableParams struct { + // MaxNumWorkers: The maximum number of workers to cap autoscaling at. + // This field is currently only supported for Streaming Engine jobs. + MaxNumWorkers int64 `json:"maxNumWorkers,omitempty"` + + // MinNumWorkers: The minimum number of workers to scale down to. This + // field is currently only supported for Streaming Engine jobs. + MinNumWorkers int64 `json:"minNumWorkers,omitempty"` + + // ForceSendFields is a list of field names (e.g. "MaxNumWorkers") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "MaxNumWorkers") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *RuntimeUpdatableParams) MarshalJSON() ([]byte, error) { + type NoMethod RuntimeUpdatableParams + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SDKInfo: SDK Information. type SDKInfo struct { // Language: Required. The SDK Language. diff --git a/datalabeling/v1beta1/datalabeling-api.json b/datalabeling/v1beta1/datalabeling-api.json index f0ff7b924a5..b17b94453d1 100644 --- a/datalabeling/v1beta1/datalabeling-api.json +++ b/datalabeling/v1beta1/datalabeling-api.json @@ -1551,7 +1551,7 @@ ] }, "list": { - "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/*/operations`. To override the binding, API services can add a binding such as `\"/v1/{name=users/*}/operations\"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.", + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "flatPath": "v1beta1/projects/{projectsId}/operations", "httpMethod": "GET", "id": "datalabeling.projects.operations.list", @@ -1596,7 +1596,7 @@ } } }, - "revision": "20220319", + "revision": "20230429", "rootUrl": "https://datalabeling.googleapis.com/", "schemas": { "GoogleCloudDatalabelingV1alpha1CreateInstructionMetadata": { diff --git a/datalabeling/v1beta1/datalabeling-gen.go b/datalabeling/v1beta1/datalabeling-gen.go index 06019ab4344..51eecfe66bb 100644 --- a/datalabeling/v1beta1/datalabeling-gen.go +++ b/datalabeling/v1beta1/datalabeling-gen.go @@ -15433,14 +15433,7 @@ type ProjectsOperationsListCall struct { // List: Lists operations that match the specified filter in the // request. If the server doesn't support this method, it returns -// `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to -// override the binding to use different resource name schemes, such as -// `users/*/operations`. To override the binding, API services can add a -// binding such as "/v1/{name=users/*}/operations" to their service -// configuration. For backwards compatibility, the default name includes -// the operations collection id, however overriding users must ensure -// the name binding is the parent resource, without the operations -// collection id. +// `UNIMPLEMENTED`. // // - name: The name of the operation's parent resource. func (r *ProjectsOperationsService) List(name string) *ProjectsOperationsListCall { @@ -15570,7 +15563,7 @@ func (c *ProjectsOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLo } return ret, nil // { - // "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/*/operations`. To override the binding, API services can add a binding such as `\"/v1/{name=users/*}/operations\"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.", + // "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", // "flatPath": "v1beta1/projects/{projectsId}/operations", // "httpMethod": "GET", // "id": "datalabeling.projects.operations.list", diff --git a/datamigration/v1/datamigration-api.json b/datamigration/v1/datamigration-api.json index 4c25a504314..04b1e68fca1 100644 --- a/datamigration/v1/datamigration-api.json +++ b/datamigration/v1/datamigration-api.json @@ -1778,6 +1778,37 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateConnections/{privateConnectionsId}:getIamPolicy", + "httpMethod": "GET", + "id": "datamigration.projects.locations.privateConnections.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. 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).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/privateConnections/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "list": { "description": "Retrieves a list of private connections in a given project and location.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateConnections", @@ -1823,6 +1854,62 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateConnections/{privateConnectionsId}:setIamPolicy", + "httpMethod": "POST", + "id": "datamigration.projects.locations.privateConnections.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/privateConnections/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateConnections/{privateConnectionsId}:testIamPermissions", + "httpMethod": "POST", + "id": "datamigration.projects.locations.privateConnections.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/privateConnections/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } } @@ -1831,7 +1918,7 @@ } } }, - "revision": "20230405", + "revision": "20230426", "rootUrl": "https://datamigration.googleapis.com/", "schemas": { "AlloyDbConnectionProfile": { @@ -3346,7 +3433,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -3591,7 +3678,8 @@ "TABLES_WITH_LIMITED_SUPPORT", "UNSUPPORTED_DATABASE_LOCALE", "UNSUPPORTED_DATABASE_FDW_CONFIG", - "ERROR_RDBMS" + "ERROR_RDBMS", + "SOURCE_SIZE_EXCEEDS_THRESHOLD" ], "enumDescriptions": [ "An unknown error occurred", @@ -3617,7 +3705,8 @@ "The source has tables with limited support. E.g. PostgreSQL tables without primary keys.", "The source uses an unsupported locale.", "The source uses an unsupported Foreign Data Wrapper configuration.", - "There was an underlying RDBMS error." + "There was an underlying RDBMS error.", + "The source DB size in Bytes exceeds a certain threshold. The migration might require an increase of quota, or might not be supported." ], "readOnly": true, "type": "string" @@ -4199,6 +4288,10 @@ "description": "IP Management configuration.", "id": "SqlIpConfig", "properties": { + "allocatedIpRange": { + "description": "Optional. The name of the allocated IP address range for the private IP Cloud SQL instance. This name refers to an already allocated IP range address. If set, the instance IP address will be created in the allocated range. Note that this IP address range can't be modified after the instance is created. If you change the VPC when configuring connectivity settings for the migration job, this field is not relevant.", + "type": "string" + }, "authorizedNetworks": { "description": "The list of external networks that are allowed to connect to the instance using the IP. See https://en.wikipedia.org/wiki/CIDR_notation#CIDR_notation, also known as 'slash' notation (e.g. `192.168.100.0/24`).", "items": { diff --git a/datamigration/v1/datamigration-gen.go b/datamigration/v1/datamigration-gen.go index 966562a54b1..38f214b3f58 100644 --- a/datamigration/v1/datamigration-gen.go +++ b/datamigration/v1/datamigration-gen.go @@ -2375,7 +2375,7 @@ func (s *ListPrivateConnectionsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -2661,6 +2661,9 @@ type MigrationJobVerificationError struct { // "UNSUPPORTED_DATABASE_FDW_CONFIG" - The source uses an unsupported // Foreign Data Wrapper configuration. // "ERROR_RDBMS" - There was an underlying RDBMS error. + // "SOURCE_SIZE_EXCEEDS_THRESHOLD" - The source DB size in Bytes + // exceeds a certain threshold. The migration might require an increase + // of quota, or might not be supported. ErrorCode string `json:"errorCode,omitempty"` // ErrorDetailMessage: Output only. A specific detailed error message, @@ -3635,6 +3638,15 @@ func (s *SqlAclEntry) MarshalJSON() ([]byte, error) { // SqlIpConfig: IP Management configuration. type SqlIpConfig struct { + // AllocatedIpRange: Optional. The name of the allocated IP address + // range for the private IP Cloud SQL instance. This name refers to an + // already allocated IP range address. If set, the instance IP address + // will be created in the allocated range. Note that this IP address + // range can't be modified after the instance is created. If you change + // the VPC when configuring connectivity settings for the migration job, + // this field is not relevant. + AllocatedIpRange string `json:"allocatedIpRange,omitempty"` + // AuthorizedNetworks: The list of external networks that are allowed to // connect to the instance using the IP. See // https://en.wikipedia.org/wiki/CIDR_notation#CIDR_notation, also known @@ -3655,15 +3667,15 @@ type SqlIpConfig struct { // not. RequireSsl bool `json:"requireSsl,omitempty"` - // ForceSendFields is a list of field names (e.g. "AuthorizedNetworks") - // to unconditionally include in API requests. By default, fields with + // ForceSendFields is a list of field names (e.g. "AllocatedIpRange") to + // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be // sent to the server regardless of whether the field is empty or not. // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AuthorizedNetworks") to + // NullFields is a list of field names (e.g. "AllocatedIpRange") to // include in API requests with the JSON null value. By default, fields // with empty values are omitted from API requests. However, any field // with an empty value appearing in NullFields will be sent to the @@ -12540,6 +12552,181 @@ func (c *ProjectsLocationsPrivateConnectionsGetCall) Do(opts ...googleapi.CallOp } +// method id "datamigration.projects.locations.privateConnections.getIamPolicy": + +type ProjectsLocationsPrivateConnectionsGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - 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 *ProjectsLocationsPrivateConnectionsService) GetIamPolicy(resource string) *ProjectsLocationsPrivateConnectionsGetIamPolicyCall { + c := &ProjectsLocationsPrivateConnectionsGetIamPolicyCall{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 *ProjectsLocationsPrivateConnectionsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsPrivateConnectionsGetIamPolicyCall { + 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 information. +func (c *ProjectsLocationsPrivateConnectionsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsPrivateConnectionsGetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsPrivateConnectionsGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsPrivateConnectionsGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsPrivateConnectionsGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsPrivateConnectionsGetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsPrivateConnectionsGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsPrivateConnectionsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamigration.projects.locations.privateConnections.getIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. 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 *ProjectsLocationsPrivateConnectionsGetIamPolicyCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateConnections/{privateConnectionsId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "datamigration.projects.locations.privateConnections.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. 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).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/privateConnections/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "datamigration.projects.locations.privateConnections.list": type ProjectsLocationsPrivateConnectionsListCall struct { @@ -12766,3 +12953,300 @@ func (c *ProjectsLocationsPrivateConnectionsListCall) Pages(ctx context.Context, c.PageToken(x.NextPageToken) } } + +// method id "datamigration.projects.locations.privateConnections.setIamPolicy": + +type ProjectsLocationsPrivateConnectionsSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - 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 *ProjectsLocationsPrivateConnectionsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsPrivateConnectionsSetIamPolicyCall { + c := &ProjectsLocationsPrivateConnectionsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsPrivateConnectionsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsPrivateConnectionsSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsPrivateConnectionsSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsPrivateConnectionsSetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsPrivateConnectionsSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsPrivateConnectionsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamigration.projects.locations.privateConnections.setIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. 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 *ProjectsLocationsPrivateConnectionsSetIamPolicyCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateConnections/{privateConnectionsId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "datamigration.projects.locations.privateConnections.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/privateConnections/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "datamigration.projects.locations.privateConnections.testIamPermissions": + +type ProjectsLocationsPrivateConnectionsTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. +func (r *ProjectsLocationsPrivateConnectionsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsPrivateConnectionsTestIamPermissionsCall { + c := &ProjectsLocationsPrivateConnectionsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsPrivateConnectionsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsPrivateConnectionsTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsPrivateConnectionsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsPrivateConnectionsTestIamPermissionsCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsPrivateConnectionsTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsPrivateConnectionsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamigration.projects.locations.privateConnections.testIamPermissions" call. +// Exactly one of *TestIamPermissionsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.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 *ProjectsLocationsPrivateConnectionsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, 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 := &TestIamPermissionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateConnections/{privateConnectionsId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "datamigration.projects.locations.privateConnections.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/privateConnections/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} diff --git a/datamigration/v1beta1/datamigration-api.json b/datamigration/v1beta1/datamigration-api.json index f3e46aa5e17..5846ba96610 100644 --- a/datamigration/v1beta1/datamigration-api.json +++ b/datamigration/v1beta1/datamigration-api.json @@ -1049,7 +1049,7 @@ } } }, - "revision": "20230405", + "revision": "20230426", "rootUrl": "https://datamigration.googleapis.com/", "schemas": { "AuditConfig": { @@ -1560,7 +1560,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -1770,7 +1770,8 @@ "TABLES_WITH_LIMITED_SUPPORT", "UNSUPPORTED_DATABASE_LOCALE", "UNSUPPORTED_DATABASE_FDW_CONFIG", - "ERROR_RDBMS" + "ERROR_RDBMS", + "SOURCE_SIZE_EXCEEDS_THRESHOLD" ], "enumDescriptions": [ "An unknown error occurred", @@ -1785,7 +1786,8 @@ "The source has tables with limited support. E.g. PostgreSQL tables without primary keys.", "The source uses an unsupported locale.", "The source uses an unsupported Foreign Data Wrapper configuration.", - "There was an underlying RDBMS error." + "There was an underlying RDBMS error.", + "The source DB size in Bytes exceeds a certain threshold. The migration might require an increase of quota, or might not be supported." ], "readOnly": true, "type": "string" diff --git a/datamigration/v1beta1/datamigration-gen.go b/datamigration/v1beta1/datamigration-gen.go index 3474d386b7a..034a15069c9 100644 --- a/datamigration/v1beta1/datamigration-gen.go +++ b/datamigration/v1beta1/datamigration-gen.go @@ -973,7 +973,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -1193,6 +1193,9 @@ type MigrationJobVerificationError struct { // "UNSUPPORTED_DATABASE_FDW_CONFIG" - The source uses an unsupported // Foreign Data Wrapper configuration. // "ERROR_RDBMS" - There was an underlying RDBMS error. + // "SOURCE_SIZE_EXCEEDS_THRESHOLD" - The source DB size in Bytes + // exceeds a certain threshold. The migration might require an increase + // of quota, or might not be supported. ErrorCode string `json:"errorCode,omitempty"` // ErrorDetailMessage: Output only. A specific detailed error message, diff --git a/dataplex/v1/dataplex-api.json b/dataplex/v1/dataplex-api.json index 1eb6adb46f5..44d7e0cc4f7 100644 --- a/dataplex/v1/dataplex-api.json +++ b/dataplex/v1/dataplex-api.json @@ -177,6 +177,97 @@ } }, "resources": { + "aspectTypes": { + "methods": { + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aspectTypes/{aspectTypesId}:getIamPolicy", + "httpMethod": "GET", + "id": "dataplex.projects.locations.aspectTypes.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. 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).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aspectTypes/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "GoogleIamV1Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aspectTypes/{aspectTypesId}:setIamPolicy", + "httpMethod": "POST", + "id": "dataplex.projects.locations.aspectTypes.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aspectTypes/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "GoogleIamV1SetIamPolicyRequest" + }, + "response": { + "$ref": "GoogleIamV1Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND error.Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aspectTypes/{aspectTypesId}:testIamPermissions", + "httpMethod": "POST", + "id": "dataplex.projects.locations.aspectTypes.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See Resource names (https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aspectTypes/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "GoogleIamV1TestIamPermissionsRequest" + }, + "response": { + "$ref": "GoogleIamV1TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "dataAttributeBindings": { "methods": { "create": { @@ -1375,6 +1466,188 @@ } } }, + "entryGroups": { + "methods": { + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}:getIamPolicy", + "httpMethod": "GET", + "id": "dataplex.projects.locations.entryGroups.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. 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).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/entryGroups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "GoogleIamV1Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}:setIamPolicy", + "httpMethod": "POST", + "id": "dataplex.projects.locations.entryGroups.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/entryGroups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "GoogleIamV1SetIamPolicyRequest" + }, + "response": { + "$ref": "GoogleIamV1Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND error.Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}:testIamPermissions", + "httpMethod": "POST", + "id": "dataplex.projects.locations.entryGroups.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See Resource names (https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/entryGroups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "GoogleIamV1TestIamPermissionsRequest" + }, + "response": { + "$ref": "GoogleIamV1TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, + "entryTypes": { + "methods": { + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryTypes/{entryTypesId}:getIamPolicy", + "httpMethod": "GET", + "id": "dataplex.projects.locations.entryTypes.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. 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).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/entryTypes/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "GoogleIamV1Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryTypes/{entryTypesId}:setIamPolicy", + "httpMethod": "POST", + "id": "dataplex.projects.locations.entryTypes.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/entryTypes/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "GoogleIamV1SetIamPolicyRequest" + }, + "response": { + "$ref": "GoogleIamV1Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND error.Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryTypes/{entryTypesId}:testIamPermissions", + "httpMethod": "POST", + "id": "dataplex.projects.locations.entryTypes.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See Resource names (https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/entryTypes/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "GoogleIamV1TestIamPermissionsRequest" + }, + "response": { + "$ref": "GoogleIamV1TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "lakes": { "methods": { "create": { @@ -3990,7 +4263,7 @@ } } }, - "revision": "20230412", + "revision": "20230501", "rootUrl": "https://dataplex.googleapis.com/", "schemas": { "Empty": { @@ -5041,7 +5314,17 @@ "GoogleCloudDataplexV1DataProfileSpec": { "description": "DataProfileScan related setting.", "id": "GoogleCloudDataplexV1DataProfileSpec", - "properties": {}, + "properties": { + "rowFilter": { + "description": "Optional. A filter applied to all rows in a single DataScan job. The filter needs to be a valid SQL expression for a WHERE clause in BigQuery standard SQL syntax. Example: col1 \u003e= 0 AND col2 \u003c 10", + "type": "string" + }, + "samplingPercent": { + "description": "Optional. The percentage of the records to be selected from the dataset for DataScan. Value can range between 0.0 and 100.0 with up to 3 significant decimal digits. Sampling is not applied if sampling_percent is not specified, 0 or 100.", + "format": "float", + "type": "number" + } + }, "type": "object" }, "GoogleCloudDataplexV1DataQualityDimensionResult": { @@ -5309,12 +5592,21 @@ "description": "DataQualityScan related setting.", "id": "GoogleCloudDataplexV1DataQualitySpec", "properties": { + "rowFilter": { + "description": "Optional. A filter applied to all rows in a single DataScan job. The filter needs to be a valid SQL expression for a WHERE clause in BigQuery standard SQL syntax. Example: col1 \u003e= 0 AND col2 \u003c 10", + "type": "string" + }, "rules": { "description": "The list of rules to evaluate against a data source. At least one rule is required.", "items": { "$ref": "GoogleCloudDataplexV1DataQualityRule" }, "type": "array" + }, + "samplingPercent": { + "description": "Optional. The percentage of the records to be selected from the dataset for DataScan. Value can range between 0.0 and 100.0 with up to 3 significant decimal digits. Sampling is not applied if sampling_percent is not specified, 0 or 100.", + "format": "float", + "type": "number" } }, "type": "object" @@ -5436,10 +5728,18 @@ "$ref": "GoogleCloudDataplexV1DataScanEventDataProfileResult", "description": "Data profile result for data profile type data scan." }, + "dataProfileConfigs": { + "$ref": "GoogleCloudDataplexV1DataScanEventDataProfileAppliedConfigs", + "description": "Applied configs for data profile type data scan." + }, "dataQuality": { "$ref": "GoogleCloudDataplexV1DataScanEventDataQualityResult", "description": "Data quality result for data quality type data scan." }, + "dataQualityConfigs": { + "$ref": "GoogleCloudDataplexV1DataScanEventDataQualityAppliedConfigs", + "description": "Applied configs for data quality type data scan." + }, "dataSource": { "description": "The data source of the data scan", "type": "string" @@ -5529,6 +5829,18 @@ }, "type": "object" }, + "GoogleCloudDataplexV1DataScanEventDataProfileAppliedConfigs": { + "description": "Applied configs for data profile type data scan job.", + "id": "GoogleCloudDataplexV1DataScanEventDataProfileAppliedConfigs", + "properties": { + "samplingPercent": { + "description": "The percentage of the records selected from the dataset for DataScan. Value ranges between 0.0 and 100.0. Value 0.0 or 100.0 imply that sampling was not applied.", + "format": "float", + "type": "number" + } + }, + "type": "object" + }, "GoogleCloudDataplexV1DataScanEventDataProfileResult": { "description": "Data profile result for data scan job.", "id": "GoogleCloudDataplexV1DataScanEventDataProfileResult", @@ -5541,6 +5853,18 @@ }, "type": "object" }, + "GoogleCloudDataplexV1DataScanEventDataQualityAppliedConfigs": { + "description": "Applied configs for data quality type data scan job.", + "id": "GoogleCloudDataplexV1DataScanEventDataQualityAppliedConfigs", + "properties": { + "samplingPercent": { + "description": "The percentage of the records selected from the dataset for DataScan. Value ranges between 0.0 and 100.0. Value 0.0 or 100.0 imply that sampling was not applied.", + "format": "float", + "type": "number" + } + }, + "type": "object" + }, "GoogleCloudDataplexV1DataScanEventDataQualityResult": { "description": "Data quality result for data scan job.", "id": "GoogleCloudDataplexV1DataScanEventDataQualityResult", @@ -8048,7 +8372,7 @@ "type": "object" }, "GoogleCloudLocationLocation": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "GoogleCloudLocationLocation", "properties": { "displayName": { diff --git a/dataplex/v1/dataplex-gen.go b/dataplex/v1/dataplex-gen.go index 0fd7518526e..d523d04a2c5 100644 --- a/dataplex/v1/dataplex-gen.go +++ b/dataplex/v1/dataplex-gen.go @@ -152,9 +152,12 @@ type ProjectsService struct { func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs := &ProjectsLocationsService{s: s} + rs.AspectTypes = NewProjectsLocationsAspectTypesService(s) rs.DataAttributeBindings = NewProjectsLocationsDataAttributeBindingsService(s) rs.DataScans = NewProjectsLocationsDataScansService(s) rs.DataTaxonomies = NewProjectsLocationsDataTaxonomiesService(s) + rs.EntryGroups = NewProjectsLocationsEntryGroupsService(s) + rs.EntryTypes = NewProjectsLocationsEntryTypesService(s) rs.Lakes = NewProjectsLocationsLakesService(s) rs.Operations = NewProjectsLocationsOperationsService(s) return rs @@ -163,17 +166,32 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { type ProjectsLocationsService struct { s *Service + AspectTypes *ProjectsLocationsAspectTypesService + DataAttributeBindings *ProjectsLocationsDataAttributeBindingsService DataScans *ProjectsLocationsDataScansService DataTaxonomies *ProjectsLocationsDataTaxonomiesService + EntryGroups *ProjectsLocationsEntryGroupsService + + EntryTypes *ProjectsLocationsEntryTypesService + Lakes *ProjectsLocationsLakesService Operations *ProjectsLocationsOperationsService } +func NewProjectsLocationsAspectTypesService(s *Service) *ProjectsLocationsAspectTypesService { + rs := &ProjectsLocationsAspectTypesService{s: s} + return rs +} + +type ProjectsLocationsAspectTypesService struct { + s *Service +} + func NewProjectsLocationsDataAttributeBindingsService(s *Service) *ProjectsLocationsDataAttributeBindingsService { rs := &ProjectsLocationsDataAttributeBindingsService{s: s} return rs @@ -225,6 +243,24 @@ type ProjectsLocationsDataTaxonomiesAttributesService struct { s *Service } +func NewProjectsLocationsEntryGroupsService(s *Service) *ProjectsLocationsEntryGroupsService { + rs := &ProjectsLocationsEntryGroupsService{s: s} + return rs +} + +type ProjectsLocationsEntryGroupsService struct { + s *Service +} + +func NewProjectsLocationsEntryTypesService(s *Service) *ProjectsLocationsEntryTypesService { + rs := &ProjectsLocationsEntryTypesService{s: s} + return rs +} + +type ProjectsLocationsEntryTypesService struct { + s *Service +} + func NewProjectsLocationsLakesService(s *Service) *ProjectsLocationsLakesService { rs := &ProjectsLocationsLakesService{s: s} rs.Actions = NewProjectsLocationsLakesActionsService(s) @@ -1993,6 +2029,53 @@ func (s *GoogleCloudDataplexV1DataProfileResultProfileFieldProfileInfoTopNValue) // GoogleCloudDataplexV1DataProfileSpec: DataProfileScan related // setting. type GoogleCloudDataplexV1DataProfileSpec struct { + // RowFilter: Optional. A filter applied to all rows in a single + // DataScan job. The filter needs to be a valid SQL expression for a + // WHERE clause in BigQuery standard SQL syntax. Example: col1 >= 0 AND + // col2 < 10 + RowFilter string `json:"rowFilter,omitempty"` + + // SamplingPercent: Optional. The percentage of the records to be + // selected from the dataset for DataScan. Value can range between 0.0 + // and 100.0 with up to 3 significant decimal digits. Sampling is not + // applied if sampling_percent is not specified, 0 or 100. + SamplingPercent float64 `json:"samplingPercent,omitempty"` + + // ForceSendFields is a list of field names (e.g. "RowFilter") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "RowFilter") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDataplexV1DataProfileSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDataplexV1DataProfileSpec + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDataplexV1DataProfileSpec) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDataplexV1DataProfileSpec + var s1 struct { + SamplingPercent gensupport.JSONFloat64 `json:"samplingPercent"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.SamplingPercent = float64(s1.SamplingPercent) + return nil } // GoogleCloudDataplexV1DataQualityDimensionResult: @@ -2465,11 +2548,23 @@ type GoogleCloudDataplexV1DataQualityRuleUniquenessExpectation struct { // GoogleCloudDataplexV1DataQualitySpec: DataQualityScan related // setting. type GoogleCloudDataplexV1DataQualitySpec struct { + // RowFilter: Optional. A filter applied to all rows in a single + // DataScan job. The filter needs to be a valid SQL expression for a + // WHERE clause in BigQuery standard SQL syntax. Example: col1 >= 0 AND + // col2 < 10 + RowFilter string `json:"rowFilter,omitempty"` + // Rules: The list of rules to evaluate against a data source. At least // one rule is required. Rules []*GoogleCloudDataplexV1DataQualityRule `json:"rules,omitempty"` - // ForceSendFields is a list of field names (e.g. "Rules") to + // SamplingPercent: Optional. The percentage of the records to be + // selected from the dataset for DataScan. Value can range between 0.0 + // and 100.0 with up to 3 significant decimal digits. Sampling is not + // applied if sampling_percent is not specified, 0 or 100. + SamplingPercent float64 `json:"samplingPercent,omitempty"` + + // ForceSendFields is a list of field names (e.g. "RowFilter") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -2477,8 +2572,8 @@ type GoogleCloudDataplexV1DataQualitySpec struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Rules") to include in API - // requests with the JSON null value. By default, fields with empty + // NullFields is a list of field names (e.g. "RowFilter") to include in + // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. @@ -2492,6 +2587,20 @@ func (s *GoogleCloudDataplexV1DataQualitySpec) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +func (s *GoogleCloudDataplexV1DataQualitySpec) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDataplexV1DataQualitySpec + var s1 struct { + SamplingPercent gensupport.JSONFloat64 `json:"samplingPercent"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.SamplingPercent = float64(s1.SamplingPercent) + return nil +} + // GoogleCloudDataplexV1DataScan: Represents a user-visible job which // provides the insights for the related data source.For example: Data // Quality: generates queries based on the rules and runs against the @@ -2603,9 +2712,15 @@ type GoogleCloudDataplexV1DataScanEvent struct { // DataProfile: Data profile result for data profile type data scan. DataProfile *GoogleCloudDataplexV1DataScanEventDataProfileResult `json:"dataProfile,omitempty"` + // DataProfileConfigs: Applied configs for data profile type data scan. + DataProfileConfigs *GoogleCloudDataplexV1DataScanEventDataProfileAppliedConfigs `json:"dataProfileConfigs,omitempty"` + // DataQuality: Data quality result for data quality type data scan. DataQuality *GoogleCloudDataplexV1DataScanEventDataQualityResult `json:"dataQuality,omitempty"` + // DataQualityConfigs: Applied configs for data quality type data scan. + DataQualityConfigs *GoogleCloudDataplexV1DataScanEventDataQualityAppliedConfigs `json:"dataQualityConfigs,omitempty"` + // DataSource: The data source of the data scan DataSource string `json:"dataSource,omitempty"` @@ -2683,6 +2798,52 @@ func (s *GoogleCloudDataplexV1DataScanEvent) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDataplexV1DataScanEventDataProfileAppliedConfigs: Applied +// configs for data profile type data scan job. +type GoogleCloudDataplexV1DataScanEventDataProfileAppliedConfigs struct { + // SamplingPercent: The percentage of the records selected from the + // dataset for DataScan. Value ranges between 0.0 and 100.0. Value 0.0 + // or 100.0 imply that sampling was not applied. + SamplingPercent float64 `json:"samplingPercent,omitempty"` + + // ForceSendFields is a list of field names (e.g. "SamplingPercent") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "SamplingPercent") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDataplexV1DataScanEventDataProfileAppliedConfigs) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDataplexV1DataScanEventDataProfileAppliedConfigs + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDataplexV1DataScanEventDataProfileAppliedConfigs) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDataplexV1DataScanEventDataProfileAppliedConfigs + var s1 struct { + SamplingPercent gensupport.JSONFloat64 `json:"samplingPercent"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.SamplingPercent = float64(s1.SamplingPercent) + return nil +} + // GoogleCloudDataplexV1DataScanEventDataProfileResult: Data profile // result for data scan job. type GoogleCloudDataplexV1DataScanEventDataProfileResult struct { @@ -2712,6 +2873,52 @@ func (s *GoogleCloudDataplexV1DataScanEventDataProfileResult) MarshalJSON() ([]b return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDataplexV1DataScanEventDataQualityAppliedConfigs: Applied +// configs for data quality type data scan job. +type GoogleCloudDataplexV1DataScanEventDataQualityAppliedConfigs struct { + // SamplingPercent: The percentage of the records selected from the + // dataset for DataScan. Value ranges between 0.0 and 100.0. Value 0.0 + // or 100.0 imply that sampling was not applied. + SamplingPercent float64 `json:"samplingPercent,omitempty"` + + // ForceSendFields is a list of field names (e.g. "SamplingPercent") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "SamplingPercent") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDataplexV1DataScanEventDataQualityAppliedConfigs) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDataplexV1DataScanEventDataQualityAppliedConfigs + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDataplexV1DataScanEventDataQualityAppliedConfigs) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDataplexV1DataScanEventDataQualityAppliedConfigs + var s1 struct { + SamplingPercent gensupport.JSONFloat64 `json:"samplingPercent"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.SamplingPercent = float64(s1.SamplingPercent) + return nil +} + // GoogleCloudDataplexV1DataScanEventDataQualityResult: Data quality // result for data scan job. type GoogleCloudDataplexV1DataScanEventDataQualityResult struct { @@ -6364,8 +6571,8 @@ func (s *GoogleCloudLocationListLocationsResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudLocationLocation: A resource that represents Google Cloud -// Platform location. +// GoogleCloudLocationLocation: A resource that represents a Google +// Cloud location. type GoogleCloudLocationLocation struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -7366,107 +7573,118 @@ func (c *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*GoogleClo } } -// method id "dataplex.projects.locations.dataAttributeBindings.create": +// method id "dataplex.projects.locations.aspectTypes.getIamPolicy": -type ProjectsLocationsDataAttributeBindingsCreateCall struct { - s *Service - parent string - googleclouddataplexv1dataattributebinding *GoogleCloudDataplexV1DataAttributeBinding - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsAspectTypesGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Create: Create a DataAttributeBinding resource. +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. // -// - parent: The resource name of the parent data taxonomy -// projects/{project_number}/locations/{location_id}. -func (r *ProjectsLocationsDataAttributeBindingsService) Create(parent string, googleclouddataplexv1dataattributebinding *GoogleCloudDataplexV1DataAttributeBinding) *ProjectsLocationsDataAttributeBindingsCreateCall { - c := &ProjectsLocationsDataAttributeBindingsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.googleclouddataplexv1dataattributebinding = googleclouddataplexv1dataattributebinding - return c -} - -// DataAttributeBindingId sets the optional parameter -// "dataAttributeBindingId": Required. DataAttributeBinding identifier. -// * Must contain only lowercase letters, numbers and hyphens. * Must -// start with a letter. * Must be between 1-63 characters. * Must end -// with a number or a letter. * Must be unique within the Location. -func (c *ProjectsLocationsDataAttributeBindingsCreateCall) DataAttributeBindingId(dataAttributeBindingId string) *ProjectsLocationsDataAttributeBindingsCreateCall { - c.urlParams_.Set("dataAttributeBindingId", dataAttributeBindingId) +// - 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 *ProjectsLocationsAspectTypesService) GetIamPolicy(resource string) *ProjectsLocationsAspectTypesGetIamPolicyCall { + c := &ProjectsLocationsAspectTypesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource return c } -// ValidateOnly sets the optional parameter "validateOnly": Only -// validate the request, but do not perform mutations. The default is -// false. -func (c *ProjectsLocationsDataAttributeBindingsCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsDataAttributeBindingsCreateCall { - c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) +// 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 *ProjectsLocationsAspectTypesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsAspectTypesGetIamPolicyCall { + 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 information. -func (c *ProjectsLocationsDataAttributeBindingsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataAttributeBindingsCreateCall { +func (c *ProjectsLocationsAspectTypesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsAspectTypesGetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsAspectTypesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsAspectTypesGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataAttributeBindingsCreateCall) Context(ctx context.Context) *ProjectsLocationsDataAttributeBindingsCreateCall { +func (c *ProjectsLocationsAspectTypesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsAspectTypesGetIamPolicyCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataAttributeBindingsCreateCall) Header() http.Header { +func (c *ProjectsLocationsAspectTypesGetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataAttributeBindingsCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsAspectTypesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1dataattributebinding) - if err != nil { - return nil, err + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } - reqHeaders.Set("Content-Type", "application/json") + var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dataAttributeBindings") + 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, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataAttributeBindings.create" call. -// Exactly one of *GoogleLongrunningOperation or error will be non-nil. -// 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 +// Do executes the "dataplex.projects.locations.aspectTypes.getIamPolicy" call. +// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *ProjectsLocationsDataAttributeBindingsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsAspectTypesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -7485,7 +7703,7 @@ func (c *ProjectsLocationsDataAttributeBindingsCreateCall) Do(opts ...googleapi. 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, @@ -7497,38 +7715,31 @@ func (c *ProjectsLocationsDataAttributeBindingsCreateCall) Do(opts ...googleapi. } return ret, nil // { - // "description": "Create a DataAttributeBinding resource.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataAttributeBindings", - // "httpMethod": "POST", - // "id": "dataplex.projects.locations.dataAttributeBindings.create", + // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aspectTypes/{aspectTypesId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "dataplex.projects.locations.aspectTypes.getIamPolicy", // "parameterOrder": [ - // "parent" + // "resource" // ], // "parameters": { - // "dataAttributeBindingId": { - // "description": "Required. DataAttributeBinding identifier. * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the Location.", + // "options.requestedPolicyVersion": { + // "description": "Optional. 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).", + // "format": "int32", // "location": "query", - // "type": "string" + // "type": "integer" // }, - // "parent": { - // "description": "Required. The resource name of the parent data taxonomy projects/{project_number}/locations/{location_id}", + // "resource": { + // "description": "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.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/aspectTypes/[^/]+$", // "required": true, // "type": "string" - // }, - // "validateOnly": { - // "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", - // "location": "query", - // "type": "boolean" // } // }, - // "path": "v1/{+parent}/dataAttributeBindings", - // "request": { - // "$ref": "GoogleCloudDataplexV1DataAttributeBinding" - // }, + // "path": "v1/{+resource}:getIamPolicy", // "response": { - // "$ref": "GoogleLongrunningOperation" + // "$ref": "GoogleIamV1Policy" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -7537,43 +7748,36 @@ func (c *ProjectsLocationsDataAttributeBindingsCreateCall) Do(opts ...googleapi. } -// method id "dataplex.projects.locations.dataAttributeBindings.delete": +// method id "dataplex.projects.locations.aspectTypes.setIamPolicy": -type ProjectsLocationsDataAttributeBindingsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsAspectTypesSetIamPolicyCall struct { + s *Service + resource string + googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Delete: Deletes a DataAttributeBinding resource. All attributes -// within the DataAttributeBinding must be deleted before the -// DataAttributeBinding can be deleted. +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy.Can return NOT_FOUND, +// INVALID_ARGUMENT, and PERMISSION_DENIED errors. // -// - name: The resource name of the DataAttributeBinding: -// projects/{project_number}/locations/{location_id}/dataAttributeBindi -// ngs/{data_attribute_binding_id}. -func (r *ProjectsLocationsDataAttributeBindingsService) Delete(name string) *ProjectsLocationsDataAttributeBindingsDeleteCall { - c := &ProjectsLocationsDataAttributeBindingsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Etag sets the optional parameter "etag": Required. If the client -// provided etag value does not match the current etag value, the -// DeleteDataAttributeBindingRequest method returns an ABORTED error -// response. Etags must be used when calling the -// DeleteDataAttributeBinding. -func (c *ProjectsLocationsDataAttributeBindingsDeleteCall) Etag(etag string) *ProjectsLocationsDataAttributeBindingsDeleteCall { - c.urlParams_.Set("etag", etag) +// - 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 *ProjectsLocationsAspectTypesService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsAspectTypesSetIamPolicyCall { + c := &ProjectsLocationsAspectTypesSetIamPolicyCall{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 information. -func (c *ProjectsLocationsDataAttributeBindingsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataAttributeBindingsDeleteCall { +func (c *ProjectsLocationsAspectTypesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsAspectTypesSetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -7581,21 +7785,21 @@ func (c *ProjectsLocationsDataAttributeBindingsDeleteCall) Fields(s ...googleapi // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataAttributeBindingsDeleteCall) Context(ctx context.Context) *ProjectsLocationsDataAttributeBindingsDeleteCall { +func (c *ProjectsLocationsAspectTypesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsAspectTypesSetIamPolicyCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataAttributeBindingsDeleteCall) Header() http.Header { +func (c *ProjectsLocationsAspectTypesSetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataAttributeBindingsDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsAspectTypesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -7603,29 +7807,34 @@ func (c *ProjectsLocationsDataAttributeBindingsDeleteCall) doRequest(alt string) } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") 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/{+resource}:setIamPolicy") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", 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, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataAttributeBindings.delete" call. -// Exactly one of *GoogleLongrunningOperation or error will be non-nil. -// 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 +// Do executes the "dataplex.projects.locations.aspectTypes.setIamPolicy" call. +// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *ProjectsLocationsDataAttributeBindingsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsAspectTypesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -7644,7 +7853,7 @@ func (c *ProjectsLocationsDataAttributeBindingsDeleteCall) Do(opts ...googleapi. 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, @@ -7656,30 +7865,28 @@ func (c *ProjectsLocationsDataAttributeBindingsDeleteCall) Do(opts ...googleapi. } return ret, nil // { - // "description": "Deletes a DataAttributeBinding resource. All attributes within the DataAttributeBinding must be deleted before the DataAttributeBinding can be deleted.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataAttributeBindings/{dataAttributeBindingsId}", - // "httpMethod": "DELETE", - // "id": "dataplex.projects.locations.dataAttributeBindings.delete", + // "description": "Sets the access control policy on the specified resource. Replaces any existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aspectTypes/{aspectTypesId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "dataplex.projects.locations.aspectTypes.setIamPolicy", // "parameterOrder": [ - // "name" + // "resource" // ], // "parameters": { - // "etag": { - // "description": "Required. If the client provided etag value does not match the current etag value, the DeleteDataAttributeBindingRequest method returns an ABORTED error response. Etags must be used when calling the DeleteDataAttributeBinding.", - // "location": "query", - // "type": "string" - // }, - // "name": { - // "description": "Required. The resource name of the DataAttributeBinding: projects/{project_number}/locations/{location_id}/dataAttributeBindings/{data_attribute_binding_id}", + // "resource": { + // "description": "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.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataAttributeBindings/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/aspectTypes/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+name}", + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "GoogleIamV1SetIamPolicyRequest" + // }, // "response": { - // "$ref": "GoogleLongrunningOperation" + // "$ref": "GoogleIamV1Policy" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -7688,99 +7895,97 @@ func (c *ProjectsLocationsDataAttributeBindingsDeleteCall) Do(opts ...googleapi. } -// method id "dataplex.projects.locations.dataAttributeBindings.get": +// method id "dataplex.projects.locations.aspectTypes.testIamPermissions": -type ProjectsLocationsDataAttributeBindingsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsAspectTypesTestIamPermissionsCall struct { + s *Service + resource string + googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Get: Retrieves a DataAttributeBinding resource. +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a NOT_FOUND error.Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. // -// - name: The resource name of the DataAttributeBinding: -// projects/{project_number}/locations/{location_id}/dataAttributeBindi -// ngs/{data_attribute_binding_id}. -func (r *ProjectsLocationsDataAttributeBindingsService) Get(name string) *ProjectsLocationsDataAttributeBindingsGetCall { - c := &ProjectsLocationsDataAttributeBindingsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. +func (r *ProjectsLocationsAspectTypesService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsAspectTypesTestIamPermissionsCall { + c := &ProjectsLocationsAspectTypesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsDataAttributeBindingsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataAttributeBindingsGetCall { +func (c *ProjectsLocationsAspectTypesTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsAspectTypesTestIamPermissionsCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response -// error from Do is the result of In-None-Match. -func (c *ProjectsLocationsDataAttributeBindingsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataAttributeBindingsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataAttributeBindingsGetCall) Context(ctx context.Context) *ProjectsLocationsDataAttributeBindingsGetCall { +func (c *ProjectsLocationsAspectTypesTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsAspectTypesTestIamPermissionsCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataAttributeBindingsGetCall) Header() http.Header { +func (c *ProjectsLocationsAspectTypesTestIamPermissionsCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataAttributeBindingsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsAspectTypesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") 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/{+resource}:testIamPermissions") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", 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, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataAttributeBindings.get" call. -// Exactly one of *GoogleCloudDataplexV1DataAttributeBinding or error -// will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleCloudDataplexV1DataAttributeBinding.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 *ProjectsLocationsDataAttributeBindingsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1DataAttributeBinding, error) { +// Do executes the "dataplex.projects.locations.aspectTypes.testIamPermissions" call. +// Exactly one of *GoogleIamV1TestIamPermissionsResponse or error will +// be non-nil. Any non-2xx status code is an error. Response headers are +// in either +// *GoogleIamV1TestIamPermissionsResponse.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 *ProjectsLocationsAspectTypesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -7799,7 +8004,7 @@ func (c *ProjectsLocationsDataAttributeBindingsGetCall) Do(opts ...googleapi.Cal if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDataplexV1DataAttributeBinding{ + ret := &GoogleIamV1TestIamPermissionsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -7811,25 +8016,28 @@ func (c *ProjectsLocationsDataAttributeBindingsGetCall) Do(opts ...googleapi.Cal } return ret, nil // { - // "description": "Retrieves a DataAttributeBinding resource.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataAttributeBindings/{dataAttributeBindingsId}", - // "httpMethod": "GET", - // "id": "dataplex.projects.locations.dataAttributeBindings.get", + // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND error.Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aspectTypes/{aspectTypesId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "dataplex.projects.locations.aspectTypes.testIamPermissions", // "parameterOrder": [ - // "name" + // "resource" // ], // "parameters": { - // "name": { - // "description": "Required. The resource name of the DataAttributeBinding: projects/{project_number}/locations/{location_id}/dataAttributeBindings/{data_attribute_binding_id}", + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See Resource names (https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataAttributeBindings/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/aspectTypes/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+name}", + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "GoogleIamV1TestIamPermissionsRequest" + // }, // "response": { - // "$ref": "GoogleCloudDataplexV1DataAttributeBinding" + // "$ref": "GoogleIamV1TestIamPermissionsResponse" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -7838,118 +8046,107 @@ func (c *ProjectsLocationsDataAttributeBindingsGetCall) Do(opts ...googleapi.Cal } -// method id "dataplex.projects.locations.dataAttributeBindings.getIamPolicy": +// method id "dataplex.projects.locations.dataAttributeBindings.create": -type ProjectsLocationsDataAttributeBindingsGetIamPolicyCall struct { - s *Service - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataAttributeBindingsCreateCall struct { + s *Service + parent string + googleclouddataplexv1dataattributebinding *GoogleCloudDataplexV1DataAttributeBinding + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// GetIamPolicy: Gets the access control policy for a resource. Returns -// an empty policy if the resource exists and does not have a policy -// set. +// Create: Create a DataAttributeBinding resource. // -// - 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 *ProjectsLocationsDataAttributeBindingsService) GetIamPolicy(resource string) *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall { - c := &ProjectsLocationsDataAttributeBindingsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource +// - parent: The resource name of the parent data taxonomy +// projects/{project_number}/locations/{location_id}. +func (r *ProjectsLocationsDataAttributeBindingsService) Create(parent string, googleclouddataplexv1dataattributebinding *GoogleCloudDataplexV1DataAttributeBinding) *ProjectsLocationsDataAttributeBindingsCreateCall { + c := &ProjectsLocationsDataAttributeBindingsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddataplexv1dataattributebinding = googleclouddataplexv1dataattributebinding 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 *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) +// DataAttributeBindingId sets the optional parameter +// "dataAttributeBindingId": Required. DataAttributeBinding identifier. +// * Must contain only lowercase letters, numbers and hyphens. * Must +// start with a letter. * Must be between 1-63 characters. * Must end +// with a number or a letter. * Must be unique within the Location. +func (c *ProjectsLocationsDataAttributeBindingsCreateCall) DataAttributeBindingId(dataAttributeBindingId string) *ProjectsLocationsDataAttributeBindingsCreateCall { + c.urlParams_.Set("dataAttributeBindingId", dataAttributeBindingId) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Only +// validate the request, but do not perform mutations. The default is +// false. +func (c *ProjectsLocationsDataAttributeBindingsCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsDataAttributeBindingsCreateCall { + 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 information. -func (c *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall { +func (c *ProjectsLocationsDataAttributeBindingsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataAttributeBindingsCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response -// error from Do is the result of In-None-Match. -func (c *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall { +func (c *ProjectsLocationsDataAttributeBindingsCreateCall) Context(ctx context.Context) *ProjectsLocationsDataAttributeBindingsCreateCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsDataAttributeBindingsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataAttributeBindingsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1dataattributebinding) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") 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, "v1/{+parent}/dataAttributeBindings") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", 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{ - "resource": c.resource, + "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataAttributeBindings.getIamPolicy" call. -// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 +// Do executes the "dataplex.projects.locations.dataAttributeBindings.create" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +func (c *ProjectsLocationsDataAttributeBindingsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -7968,7 +8165,7 @@ func (c *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) Do(opts ...goog 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, @@ -7980,31 +8177,38 @@ func (c *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) Do(opts ...goog } return ret, nil // { - // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataAttributeBindings/{dataAttributeBindingsId}:getIamPolicy", - // "httpMethod": "GET", - // "id": "dataplex.projects.locations.dataAttributeBindings.getIamPolicy", + // "description": "Create a DataAttributeBinding resource.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataAttributeBindings", + // "httpMethod": "POST", + // "id": "dataplex.projects.locations.dataAttributeBindings.create", // "parameterOrder": [ - // "resource" + // "parent" // ], // "parameters": { - // "options.requestedPolicyVersion": { - // "description": "Optional. 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).", - // "format": "int32", + // "dataAttributeBindingId": { + // "description": "Required. DataAttributeBinding identifier. * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the Location.", // "location": "query", - // "type": "integer" + // "type": "string" // }, - // "resource": { - // "description": "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.", + // "parent": { + // "description": "Required. The resource name of the parent data taxonomy projects/{project_number}/locations/{location_id}", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataAttributeBindings/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, // "type": "string" + // }, + // "validateOnly": { + // "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", + // "location": "query", + // "type": "boolean" // } // }, - // "path": "v1/{+resource}:getIamPolicy", + // "path": "v1/{+parent}/dataAttributeBindings", + // "request": { + // "$ref": "GoogleCloudDataplexV1DataAttributeBinding" + // }, // "response": { - // "$ref": "GoogleIamV1Policy" + // "$ref": "GoogleLongrunningOperation" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -8013,135 +8217,95 @@ func (c *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) Do(opts ...goog } -// method id "dataplex.projects.locations.dataAttributeBindings.list": +// method id "dataplex.projects.locations.dataAttributeBindings.delete": -type ProjectsLocationsDataAttributeBindingsListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataAttributeBindingsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// List: Lists DataAttributeBinding resources in a project and location. +// Delete: Deletes a DataAttributeBinding resource. All attributes +// within the DataAttributeBinding must be deleted before the +// DataAttributeBinding can be deleted. // -// - parent: The resource name of the Location: -// projects/{project_number}/locations/{location_id}. -func (r *ProjectsLocationsDataAttributeBindingsService) List(parent string) *ProjectsLocationsDataAttributeBindingsListCall { - c := &ProjectsLocationsDataAttributeBindingsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// Filter sets the optional parameter "filter": Filter request. Filter -// using resource: filter=resource:"resource-name" Filter using -// attribute: filter=attributes:"attribute-name" Filter using attribute -// in paths list: filter=paths.attributes:"attribute-name" -func (c *ProjectsLocationsDataAttributeBindingsListCall) Filter(filter string) *ProjectsLocationsDataAttributeBindingsListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// OrderBy sets the optional parameter "orderBy": Order by fields for -// the result. -func (c *ProjectsLocationsDataAttributeBindingsListCall) OrderBy(orderBy string) *ProjectsLocationsDataAttributeBindingsListCall { - c.urlParams_.Set("orderBy", orderBy) - return c -} - -// PageSize sets the optional parameter "pageSize": Maximum number of -// DataAttributeBindings to return. The service may return fewer than -// this value. If unspecified, at most 10 DataAttributeBindings will be -// returned. The maximum value is 1000; values above 1000 will be -// coerced to 1000. -func (c *ProjectsLocationsDataAttributeBindingsListCall) PageSize(pageSize int64) *ProjectsLocationsDataAttributeBindingsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) +// - name: The resource name of the DataAttributeBinding: +// projects/{project_number}/locations/{location_id}/dataAttributeBindi +// ngs/{data_attribute_binding_id}. +func (r *ProjectsLocationsDataAttributeBindingsService) Delete(name string) *ProjectsLocationsDataAttributeBindingsDeleteCall { + c := &ProjectsLocationsDataAttributeBindingsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name return c } -// PageToken sets the optional parameter "pageToken": Page token -// received from a previous ListDataAttributeBindings call. Provide this -// to retrieve the subsequent page. When paginating, all other -// parameters provided to ListDataAttributeBindings must match the call -// that provided the page token. -func (c *ProjectsLocationsDataAttributeBindingsListCall) PageToken(pageToken string) *ProjectsLocationsDataAttributeBindingsListCall { - c.urlParams_.Set("pageToken", pageToken) +// Etag sets the optional parameter "etag": Required. If the client +// provided etag value does not match the current etag value, the +// DeleteDataAttributeBindingRequest method returns an ABORTED error +// response. Etags must be used when calling the +// DeleteDataAttributeBinding. +func (c *ProjectsLocationsDataAttributeBindingsDeleteCall) Etag(etag string) *ProjectsLocationsDataAttributeBindingsDeleteCall { + c.urlParams_.Set("etag", etag) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsDataAttributeBindingsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataAttributeBindingsListCall { +func (c *ProjectsLocationsDataAttributeBindingsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataAttributeBindingsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response -// error from Do is the result of In-None-Match. -func (c *ProjectsLocationsDataAttributeBindingsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataAttributeBindingsListCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataAttributeBindingsListCall) Context(ctx context.Context) *ProjectsLocationsDataAttributeBindingsListCall { +func (c *ProjectsLocationsDataAttributeBindingsDeleteCall) Context(ctx context.Context) *ProjectsLocationsDataAttributeBindingsDeleteCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataAttributeBindingsListCall) Header() http.Header { +func (c *ProjectsLocationsDataAttributeBindingsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataAttributeBindingsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataAttributeBindingsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dataAttributeBindings") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, body) + req, err := http.NewRequest("DELETE", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataAttributeBindings.list" call. -// Exactly one of -// *GoogleCloudDataplexV1ListDataAttributeBindingsResponse or error will -// be non-nil. Any non-2xx status code is an error. Response headers are -// in either -// *GoogleCloudDataplexV1ListDataAttributeBindingsResponse.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 *ProjectsLocationsDataAttributeBindingsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1ListDataAttributeBindingsResponse, error) { +// Do executes the "dataplex.projects.locations.dataAttributeBindings.delete" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *ProjectsLocationsDataAttributeBindingsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -8160,7 +8324,7 @@ func (c *ProjectsLocationsDataAttributeBindingsListCall) Do(opts ...googleapi.Ca if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDataplexV1ListDataAttributeBindingsResponse{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -8172,46 +8336,30 @@ func (c *ProjectsLocationsDataAttributeBindingsListCall) Do(opts ...googleapi.Ca } return ret, nil // { - // "description": "Lists DataAttributeBinding resources in a project and location.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataAttributeBindings", - // "httpMethod": "GET", - // "id": "dataplex.projects.locations.dataAttributeBindings.list", + // "description": "Deletes a DataAttributeBinding resource. All attributes within the DataAttributeBinding must be deleted before the DataAttributeBinding can be deleted.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataAttributeBindings/{dataAttributeBindingsId}", + // "httpMethod": "DELETE", + // "id": "dataplex.projects.locations.dataAttributeBindings.delete", // "parameterOrder": [ - // "parent" + // "name" // ], // "parameters": { - // "filter": { - // "description": "Optional. Filter request. Filter using resource: filter=resource:\"resource-name\" Filter using attribute: filter=attributes:\"attribute-name\" Filter using attribute in paths list: filter=paths.attributes:\"attribute-name\"", - // "location": "query", - // "type": "string" - // }, - // "orderBy": { - // "description": "Optional. Order by fields for the result.", - // "location": "query", - // "type": "string" - // }, - // "pageSize": { - // "description": "Optional. Maximum number of DataAttributeBindings to return. The service may return fewer than this value. If unspecified, at most 10 DataAttributeBindings 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. Page token received from a previous ListDataAttributeBindings call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListDataAttributeBindings must match the call that provided the page token.", + // "etag": { + // "description": "Required. If the client provided etag value does not match the current etag value, the DeleteDataAttributeBindingRequest method returns an ABORTED error response. Etags must be used when calling the DeleteDataAttributeBinding.", // "location": "query", // "type": "string" // }, - // "parent": { - // "description": "Required. The resource name of the Location: projects/{project_number}/locations/{location_id}", + // "name": { + // "description": "Required. The resource name of the DataAttributeBinding: projects/{project_number}/locations/{location_id}/dataAttributeBindings/{data_attribute_binding_id}", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataAttributeBindings/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+parent}/dataAttributeBindings", + // "path": "v1/{+name}", // "response": { - // "$ref": "GoogleCloudDataplexV1ListDataAttributeBindingsResponse" + // "$ref": "GoogleLongrunningOperation" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -8220,109 +8368,79 @@ func (c *ProjectsLocationsDataAttributeBindingsListCall) Do(opts ...googleapi.Ca } -// 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 *ProjectsLocationsDataAttributeBindingsListCall) Pages(ctx context.Context, f func(*GoogleCloudDataplexV1ListDataAttributeBindingsResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point - 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) - } -} - -// method id "dataplex.projects.locations.dataAttributeBindings.patch": +// method id "dataplex.projects.locations.dataAttributeBindings.get": -type ProjectsLocationsDataAttributeBindingsPatchCall struct { - s *Service - name string - googleclouddataplexv1dataattributebinding *GoogleCloudDataplexV1DataAttributeBinding - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataAttributeBindingsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Patch: Updates a DataAttributeBinding resource. +// Get: Retrieves a DataAttributeBinding resource. // -// - name: Output only. The relative resource name of the Data Attribute -// Binding, of the form: -// projects/{project_number}/locations/{location}/dataAttributeBindings -// /{data_attribute_binding_id}. -func (r *ProjectsLocationsDataAttributeBindingsService) Patch(name string, googleclouddataplexv1dataattributebinding *GoogleCloudDataplexV1DataAttributeBinding) *ProjectsLocationsDataAttributeBindingsPatchCall { - c := &ProjectsLocationsDataAttributeBindingsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The resource name of the DataAttributeBinding: +// projects/{project_number}/locations/{location_id}/dataAttributeBindi +// ngs/{data_attribute_binding_id}. +func (r *ProjectsLocationsDataAttributeBindingsService) Get(name string) *ProjectsLocationsDataAttributeBindingsGetCall { + c := &ProjectsLocationsDataAttributeBindingsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googleclouddataplexv1dataattributebinding = googleclouddataplexv1dataattributebinding - return c -} - -// UpdateMask sets the optional parameter "updateMask": Required. Mask -// of fields to update. -func (c *ProjectsLocationsDataAttributeBindingsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsDataAttributeBindingsPatchCall { - c.urlParams_.Set("updateMask", updateMask) - return c -} - -// ValidateOnly sets the optional parameter "validateOnly": Only -// validate the request, but do not perform mutations. The default is -// false. -func (c *ProjectsLocationsDataAttributeBindingsPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsDataAttributeBindingsPatchCall { - 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 information. -func (c *ProjectsLocationsDataAttributeBindingsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataAttributeBindingsPatchCall { +func (c *ProjectsLocationsDataAttributeBindingsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataAttributeBindingsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsDataAttributeBindingsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataAttributeBindingsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataAttributeBindingsPatchCall) Context(ctx context.Context) *ProjectsLocationsDataAttributeBindingsPatchCall { +func (c *ProjectsLocationsDataAttributeBindingsGetCall) Context(ctx context.Context) *ProjectsLocationsDataAttributeBindingsGetCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataAttributeBindingsPatchCall) Header() http.Header { +func (c *ProjectsLocationsDataAttributeBindingsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataAttributeBindingsPatchCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataAttributeBindingsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1dataattributebinding) - if err != nil { - return nil, err + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } - reqHeaders.Set("Content-Type", "application/json") + var body io.Reader = nil 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, body) if err != nil { return nil, err } @@ -8333,14 +8451,16 @@ func (c *ProjectsLocationsDataAttributeBindingsPatchCall) doRequest(alt string) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataAttributeBindings.patch" call. -// Exactly one of *GoogleLongrunningOperation or error will be non-nil. -// 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 *ProjectsLocationsDataAttributeBindingsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +// Do executes the "dataplex.projects.locations.dataAttributeBindings.get" call. +// Exactly one of *GoogleCloudDataplexV1DataAttributeBinding or error +// will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleCloudDataplexV1DataAttributeBinding.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 *ProjectsLocationsDataAttributeBindingsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1DataAttributeBinding, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -8359,7 +8479,7 @@ func (c *ProjectsLocationsDataAttributeBindingsPatchCall) Do(opts ...googleapi.C if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDataplexV1DataAttributeBinding{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -8371,39 +8491,25 @@ func (c *ProjectsLocationsDataAttributeBindingsPatchCall) Do(opts ...googleapi.C } return ret, nil // { - // "description": "Updates a DataAttributeBinding resource.", + // "description": "Retrieves a DataAttributeBinding resource.", // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataAttributeBindings/{dataAttributeBindingsId}", - // "httpMethod": "PATCH", - // "id": "dataplex.projects.locations.dataAttributeBindings.patch", + // "httpMethod": "GET", + // "id": "dataplex.projects.locations.dataAttributeBindings.get", // "parameterOrder": [ // "name" // ], // "parameters": { // "name": { - // "description": "Output only. The relative resource name of the Data Attribute Binding, of the form: projects/{project_number}/locations/{location}/dataAttributeBindings/{data_attribute_binding_id}", + // "description": "Required. The resource name of the DataAttributeBinding: projects/{project_number}/locations/{location_id}/dataAttributeBindings/{data_attribute_binding_id}", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/dataAttributeBindings/[^/]+$", // "required": true, // "type": "string" - // }, - // "updateMask": { - // "description": "Required. Mask of fields to update.", - // "format": "google-fieldmask", - // "location": "query", - // "type": "string" - // }, - // "validateOnly": { - // "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", - // "location": "query", - // "type": "boolean" // } // }, // "path": "v1/{+name}", - // "request": { - // "$ref": "GoogleCloudDataplexV1DataAttributeBinding" - // }, // "response": { - // "$ref": "GoogleLongrunningOperation" + // "$ref": "GoogleCloudDataplexV1DataAttributeBinding" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -8412,75 +8518,100 @@ func (c *ProjectsLocationsDataAttributeBindingsPatchCall) Do(opts ...googleapi.C } -// method id "dataplex.projects.locations.dataAttributeBindings.setIamPolicy": +// method id "dataplex.projects.locations.dataAttributeBindings.getIamPolicy": -type ProjectsLocationsDataAttributeBindingsSetIamPolicyCall struct { - s *Service - resource string - googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataAttributeBindingsGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// SetIamPolicy: Sets the access control policy on the specified -// resource. Replaces any existing policy.Can return NOT_FOUND, -// INVALID_ARGUMENT, and PERMISSION_DENIED errors. +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. // // - resource: REQUIRED: The resource for which the policy is being -// specified. See Resource names +// requested. See Resource names // (https://cloud.google.com/apis/design/resource_names) for the // appropriate value for this field. -func (r *ProjectsLocationsDataAttributeBindingsService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall { - c := &ProjectsLocationsDataAttributeBindingsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsDataAttributeBindingsService) GetIamPolicy(resource string) *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall { + c := &ProjectsLocationsDataAttributeBindingsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource - c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest + 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 *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall { + 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 information. -func (c *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall { +func (c *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall { +func (c *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1setiampolicyrequest) - if err != nil { - return nil, err + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } - reqHeaders.Set("Content-Type", "application/json") + var body io.Reader = nil 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/{+resource}:getIamPolicy") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } @@ -8491,14 +8622,14 @@ func (c *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall) doRequest(alt s return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataAttributeBindings.setIamPolicy" call. +// Do executes the "dataplex.projects.locations.dataAttributeBindings.getIamPolicy" call. // Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +func (c *ProjectsLocationsDataAttributeBindingsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -8529,26 +8660,29 @@ func (c *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall) Do(opts ...goog } return ret, nil // { - // "description": "Sets the access control policy on the specified resource. Replaces any existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataAttributeBindings/{dataAttributeBindingsId}:setIamPolicy", - // "httpMethod": "POST", - // "id": "dataplex.projects.locations.dataAttributeBindings.setIamPolicy", + // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataAttributeBindings/{dataAttributeBindingsId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "dataplex.projects.locations.dataAttributeBindings.getIamPolicy", // "parameterOrder": [ // "resource" // ], // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. 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).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, // "resource": { - // "description": "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.", + // "description": "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.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/dataAttributeBindings/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+resource}:setIamPolicy", - // "request": { - // "$ref": "GoogleIamV1SetIamPolicyRequest" - // }, + // "path": "v1/{+resource}:getIamPolicy", // "response": { // "$ref": "GoogleIamV1Policy" // }, @@ -8559,97 +8693,135 @@ func (c *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall) Do(opts ...goog } -// method id "dataplex.projects.locations.dataAttributeBindings.testIamPermissions": +// method id "dataplex.projects.locations.dataAttributeBindings.list": -type ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall struct { - s *Service - resource string - googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataAttributeBindingsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// TestIamPermissions: Returns permissions that a caller has on the -// specified resource. If the resource does not exist, this will return -// an empty set of permissions, not a NOT_FOUND error.Note: This -// operation is designed to be used for building permission-aware UIs -// and command-line tools, not for authorization checking. This -// operation may "fail open" without warning. +// List: Lists DataAttributeBinding resources in a project and location. // -// - resource: REQUIRED: The resource for which the policy detail is -// being requested. See Resource names -// (https://cloud.google.com/apis/design/resource_names) for the -// appropriate value for this field. -func (r *ProjectsLocationsDataAttributeBindingsService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall { - c := &ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest - return c -} +// - parent: The resource name of the Location: +// projects/{project_number}/locations/{location_id}. +func (r *ProjectsLocationsDataAttributeBindingsService) List(parent string) *ProjectsLocationsDataAttributeBindingsListCall { + c := &ProjectsLocationsDataAttributeBindingsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Filter request. Filter +// using resource: filter=resource:"resource-name" Filter using +// attribute: filter=attributes:"attribute-name" Filter using attribute +// in paths list: filter=paths.attributes:"attribute-name" +func (c *ProjectsLocationsDataAttributeBindingsListCall) Filter(filter string) *ProjectsLocationsDataAttributeBindingsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Order by fields for +// the result. +func (c *ProjectsLocationsDataAttributeBindingsListCall) OrderBy(orderBy string) *ProjectsLocationsDataAttributeBindingsListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// DataAttributeBindings to return. The service may return fewer than +// this value. If unspecified, at most 10 DataAttributeBindings will be +// returned. The maximum value is 1000; values above 1000 will be +// coerced to 1000. +func (c *ProjectsLocationsDataAttributeBindingsListCall) PageSize(pageSize int64) *ProjectsLocationsDataAttributeBindingsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Page token +// received from a previous ListDataAttributeBindings call. Provide this +// to retrieve the subsequent page. When paginating, all other +// parameters provided to ListDataAttributeBindings must match the call +// that provided the page token. +func (c *ProjectsLocationsDataAttributeBindingsListCall) PageToken(pageToken string) *ProjectsLocationsDataAttributeBindingsListCall { + 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 information. -func (c *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall { +func (c *ProjectsLocationsDataAttributeBindingsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataAttributeBindingsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsDataAttributeBindingsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataAttributeBindingsListCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall { +func (c *ProjectsLocationsDataAttributeBindingsListCall) Context(ctx context.Context) *ProjectsLocationsDataAttributeBindingsListCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall) Header() http.Header { +func (c *ProjectsLocationsDataAttributeBindingsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataAttributeBindingsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1testiampermissionsrequest) - if err != nil { - return nil, err + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } - reqHeaders.Set("Content-Type", "application/json") + var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dataAttributeBindings") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataAttributeBindings.testIamPermissions" call. -// Exactly one of *GoogleIamV1TestIamPermissionsResponse or error will +// Do executes the "dataplex.projects.locations.dataAttributeBindings.list" call. +// Exactly one of +// *GoogleCloudDataplexV1ListDataAttributeBindingsResponse or error will // be non-nil. Any non-2xx status code is an error. Response headers are // in either -// *GoogleIamV1TestIamPermissionsResponse.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 *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { +// *GoogleCloudDataplexV1ListDataAttributeBindingsResponse.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 *ProjectsLocationsDataAttributeBindingsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1ListDataAttributeBindingsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -8668,7 +8840,7 @@ func (c *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall) Do(opts . if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleIamV1TestIamPermissionsResponse{ + ret := &GoogleCloudDataplexV1ListDataAttributeBindingsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -8680,28 +8852,46 @@ func (c *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall) Do(opts . } return ret, nil // { - // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND error.Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataAttributeBindings/{dataAttributeBindingsId}:testIamPermissions", - // "httpMethod": "POST", - // "id": "dataplex.projects.locations.dataAttributeBindings.testIamPermissions", + // "description": "Lists DataAttributeBinding resources in a project and location.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataAttributeBindings", + // "httpMethod": "GET", + // "id": "dataplex.projects.locations.dataAttributeBindings.list", // "parameterOrder": [ - // "resource" + // "parent" // ], // "parameters": { - // "resource": { - // "description": "REQUIRED: The resource for which the policy detail is being requested. See Resource names (https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + // "filter": { + // "description": "Optional. Filter request. Filter using resource: filter=resource:\"resource-name\" Filter using attribute: filter=attributes:\"attribute-name\" Filter using attribute in paths list: filter=paths.attributes:\"attribute-name\"", + // "location": "query", + // "type": "string" + // }, + // "orderBy": { + // "description": "Optional. Order by fields for the result.", + // "location": "query", + // "type": "string" + // }, + // "pageSize": { + // "description": "Optional. Maximum number of DataAttributeBindings to return. The service may return fewer than this value. If unspecified, at most 10 DataAttributeBindings 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. Page token received from a previous ListDataAttributeBindings call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListDataAttributeBindings must match the call that provided the page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The resource name of the Location: projects/{project_number}/locations/{location_id}", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataAttributeBindings/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+resource}:testIamPermissions", - // "request": { - // "$ref": "GoogleIamV1TestIamPermissionsRequest" - // }, + // "path": "v1/{+parent}/dataAttributeBindings", // "response": { - // "$ref": "GoogleIamV1TestIamPermissionsResponse" + // "$ref": "GoogleCloudDataplexV1ListDataAttributeBindingsResponse" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -8710,44 +8900,62 @@ func (c *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall) Do(opts . } -// method id "dataplex.projects.locations.dataScans.create": +// 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 *ProjectsLocationsDataAttributeBindingsListCall) Pages(ctx context.Context, f func(*GoogleCloudDataplexV1ListDataAttributeBindingsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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 ProjectsLocationsDataScansCreateCall struct { - s *Service - parent string - googleclouddataplexv1datascan *GoogleCloudDataplexV1DataScan - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +// method id "dataplex.projects.locations.dataAttributeBindings.patch": + +type ProjectsLocationsDataAttributeBindingsPatchCall struct { + s *Service + name string + googleclouddataplexv1dataattributebinding *GoogleCloudDataplexV1DataAttributeBinding + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Create: Creates a DataScan resource. +// Patch: Updates a DataAttributeBinding resource. // -// - parent: The resource name of the parent location: -// projects/{project}/locations/{location_id} where project refers to -// a project_id or project_number and location_id refers to a GCP -// region. -func (r *ProjectsLocationsDataScansService) Create(parent string, googleclouddataplexv1datascan *GoogleCloudDataplexV1DataScan) *ProjectsLocationsDataScansCreateCall { - c := &ProjectsLocationsDataScansCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.googleclouddataplexv1datascan = googleclouddataplexv1datascan +// - name: Output only. The relative resource name of the Data Attribute +// Binding, of the form: +// projects/{project_number}/locations/{location}/dataAttributeBindings +// /{data_attribute_binding_id}. +func (r *ProjectsLocationsDataAttributeBindingsService) Patch(name string, googleclouddataplexv1dataattributebinding *GoogleCloudDataplexV1DataAttributeBinding) *ProjectsLocationsDataAttributeBindingsPatchCall { + c := &ProjectsLocationsDataAttributeBindingsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleclouddataplexv1dataattributebinding = googleclouddataplexv1dataattributebinding return c } -// DataScanId sets the optional parameter "dataScanId": Required. -// DataScan identifier. Must contain only lowercase letters, numbers and -// hyphens. Must start with a letter. Must end with a number or a -// letter. Must be between 1-63 characters. Must be unique within the -// customer project / location. -func (c *ProjectsLocationsDataScansCreateCall) DataScanId(dataScanId string) *ProjectsLocationsDataScansCreateCall { - c.urlParams_.Set("dataScanId", dataScanId) +// UpdateMask sets the optional parameter "updateMask": Required. Mask +// of fields to update. +func (c *ProjectsLocationsDataAttributeBindingsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsDataAttributeBindingsPatchCall { + c.urlParams_.Set("updateMask", updateMask) return c } // ValidateOnly sets the optional parameter "validateOnly": Only // validate the request, but do not perform mutations. The default is // false. -func (c *ProjectsLocationsDataScansCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsDataScansCreateCall { +func (c *ProjectsLocationsDataAttributeBindingsPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsDataAttributeBindingsPatchCall { c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) return c } @@ -8755,7 +8963,7 @@ func (c *ProjectsLocationsDataScansCreateCall) ValidateOnly(validateOnly bool) * // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsDataScansCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansCreateCall { +func (c *ProjectsLocationsDataAttributeBindingsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataAttributeBindingsPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -8763,21 +8971,21 @@ func (c *ProjectsLocationsDataScansCreateCall) Fields(s ...googleapi.Field) *Pro // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataScansCreateCall) Context(ctx context.Context) *ProjectsLocationsDataScansCreateCall { +func (c *ProjectsLocationsDataAttributeBindingsPatchCall) Context(ctx context.Context) *ProjectsLocationsDataAttributeBindingsPatchCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataScansCreateCall) Header() http.Header { +func (c *ProjectsLocationsDataAttributeBindingsPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataScansCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataAttributeBindingsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -8785,34 +8993,34 @@ func (c *ProjectsLocationsDataScansCreateCall) doRequest(alt string) (*http.Resp } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1datascan) + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1dataattributebinding) if err != nil { return nil, err } reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dataScans") + 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, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataScans.create" call. +// Do executes the "dataplex.projects.locations.dataAttributeBindings.patch" call. // Exactly one of *GoogleLongrunningOperation or error will be non-nil. // 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 *ProjectsLocationsDataScansCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsDataAttributeBindingsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -8843,35 +9051,36 @@ func (c *ProjectsLocationsDataScansCreateCall) Do(opts ...googleapi.CallOption) } return ret, nil // { - // "description": "Creates a DataScan resource.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans", - // "httpMethod": "POST", - // "id": "dataplex.projects.locations.dataScans.create", + // "description": "Updates a DataAttributeBinding resource.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataAttributeBindings/{dataAttributeBindingsId}", + // "httpMethod": "PATCH", + // "id": "dataplex.projects.locations.dataAttributeBindings.patch", // "parameterOrder": [ - // "parent" + // "name" // ], // "parameters": { - // "dataScanId": { - // "description": "Required. DataScan identifier. Must contain only lowercase letters, numbers and hyphens. Must start with a letter. Must end with a number or a letter. Must be between 1-63 characters. Must be unique within the customer project / location.", - // "location": "query", - // "type": "string" - // }, - // "parent": { - // "description": "Required. The resource name of the parent location: projects/{project}/locations/{location_id} where project refers to a project_id or project_number and location_id refers to a GCP region.", + // "name": { + // "description": "Output only. The relative resource name of the Data Attribute Binding, of the form: projects/{project_number}/locations/{location}/dataAttributeBindings/{data_attribute_binding_id}", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataAttributeBindings/[^/]+$", // "required": true, // "type": "string" // }, + // "updateMask": { + // "description": "Required. Mask of fields to update.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // }, // "validateOnly": { // "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", // "location": "query", // "type": "boolean" // } // }, - // "path": "v1/{+parent}/dataScans", + // "path": "v1/{+name}", // "request": { - // "$ref": "GoogleCloudDataplexV1DataScan" + // "$ref": "GoogleCloudDataplexV1DataAttributeBinding" // }, // "response": { // "$ref": "GoogleLongrunningOperation" @@ -8883,32 +9092,36 @@ func (c *ProjectsLocationsDataScansCreateCall) Do(opts ...googleapi.CallOption) } -// method id "dataplex.projects.locations.dataScans.delete": +// method id "dataplex.projects.locations.dataAttributeBindings.setIamPolicy": -type ProjectsLocationsDataScansDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataAttributeBindingsSetIamPolicyCall struct { + s *Service + resource string + googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Delete: Deletes a DataScan resource. +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy.Can return NOT_FOUND, +// INVALID_ARGUMENT, and PERMISSION_DENIED errors. // -// - name: The resource name of the dataScan: -// projects/{project}/locations/{location_id}/dataScans/{data_scan_id} -// where project refers to a project_id or project_number and -// location_id refers to a GCP region. -func (r *ProjectsLocationsDataScansService) Delete(name string) *ProjectsLocationsDataScansDeleteCall { - c := &ProjectsLocationsDataScansDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - 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 *ProjectsLocationsDataAttributeBindingsService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall { + c := &ProjectsLocationsDataAttributeBindingsSetIamPolicyCall{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 information. -func (c *ProjectsLocationsDataScansDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansDeleteCall { +func (c *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -8916,21 +9129,21 @@ func (c *ProjectsLocationsDataScansDeleteCall) Fields(s ...googleapi.Field) *Pro // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataScansDeleteCall) Context(ctx context.Context) *ProjectsLocationsDataScansDeleteCall { +func (c *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataScansDeleteCall) Header() http.Header { +func (c *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataScansDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -8938,29 +9151,34 @@ func (c *ProjectsLocationsDataScansDeleteCall) doRequest(alt string) (*http.Resp } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") 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/{+resource}:setIamPolicy") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", 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, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataScans.delete" call. -// Exactly one of *GoogleLongrunningOperation or error will be non-nil. -// 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 +// Do executes the "dataplex.projects.locations.dataAttributeBindings.setIamPolicy" call. +// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *ProjectsLocationsDataScansDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsDataAttributeBindingsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -8979,7 +9197,7 @@ func (c *ProjectsLocationsDataScansDeleteCall) Do(opts ...googleapi.CallOption) 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, @@ -8991,25 +9209,28 @@ func (c *ProjectsLocationsDataScansDeleteCall) Do(opts ...googleapi.CallOption) } return ret, nil // { - // "description": "Deletes a DataScan resource.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}", - // "httpMethod": "DELETE", - // "id": "dataplex.projects.locations.dataScans.delete", + // "description": "Sets the access control policy on the specified resource. Replaces any existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataAttributeBindings/{dataAttributeBindingsId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "dataplex.projects.locations.dataAttributeBindings.setIamPolicy", // "parameterOrder": [ - // "name" + // "resource" // ], // "parameters": { - // "name": { - // "description": "Required. The resource name of the dataScan: projects/{project}/locations/{location_id}/dataScans/{data_scan_id} where project refers to a project_id or project_number and location_id refers to a GCP region.", + // "resource": { + // "description": "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.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataAttributeBindings/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+name}", + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "GoogleIamV1SetIamPolicyRequest" + // }, // "response": { - // "$ref": "GoogleLongrunningOperation" + // "$ref": "GoogleIamV1Policy" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -9018,114 +9239,97 @@ func (c *ProjectsLocationsDataScansDeleteCall) Do(opts ...googleapi.CallOption) } -// method id "dataplex.projects.locations.dataScans.get": - -type ProjectsLocationsDataScansGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} +// method id "dataplex.projects.locations.dataAttributeBindings.testIamPermissions": -// Get: Gets a DataScan resource. -// -// - name: The resource name of the dataScan: -// projects/{project}/locations/{location_id}/dataScans/{data_scan_id} -// where project refers to a project_id or project_number and -// location_id refers to a GCP region. -func (r *ProjectsLocationsDataScansService) Get(name string) *ProjectsLocationsDataScansGetCall { - c := &ProjectsLocationsDataScansGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c +type ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall struct { + s *Service + resource string + googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// View sets the optional parameter "view": Select the DataScan view to -// return. Defaults to BASIC. -// -// Possible values: -// -// "DATA_SCAN_VIEW_UNSPECIFIED" - The API will default to the BASIC -// -// view. +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a NOT_FOUND error.Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. // -// "BASIC" - Basic view that does not include spec and result. -// "FULL" - Include everything. -func (c *ProjectsLocationsDataScansGetCall) View(view string) *ProjectsLocationsDataScansGetCall { - c.urlParams_.Set("view", view) +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. +func (r *ProjectsLocationsDataAttributeBindingsService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall { + c := &ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsDataScansGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansGetCall { +func (c *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response -// error from Do is the result of In-None-Match. -func (c *ProjectsLocationsDataScansGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataScansGetCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataScansGetCall) Context(ctx context.Context) *ProjectsLocationsDataScansGetCall { +func (c *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataScansGetCall) Header() http.Header { +func (c *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataScansGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") 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/{+resource}:testIamPermissions") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", 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, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataScans.get" call. -// Exactly one of *GoogleCloudDataplexV1DataScan or error will be -// non-nil. Any non-2xx status code is an error. Response headers are in -// either *GoogleCloudDataplexV1DataScan.ServerResponse.Header or (if a +// Do executes the "dataplex.projects.locations.dataAttributeBindings.testIamPermissions" call. +// Exactly one of *GoogleIamV1TestIamPermissionsResponse or error will +// be non-nil. Any non-2xx status code is an error. Response headers are +// in either +// *GoogleIamV1TestIamPermissionsResponse.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 *ProjectsLocationsDataScansGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1DataScan, error) { +func (c *ProjectsLocationsDataAttributeBindingsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -9144,7 +9348,7 @@ func (c *ProjectsLocationsDataScansGetCall) Do(opts ...googleapi.CallOption) (*G if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDataplexV1DataScan{ + ret := &GoogleIamV1TestIamPermissionsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -9156,40 +9360,28 @@ func (c *ProjectsLocationsDataScansGetCall) Do(opts ...googleapi.CallOption) (*G } return ret, nil // { - // "description": "Gets a DataScan resource.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}", - // "httpMethod": "GET", - // "id": "dataplex.projects.locations.dataScans.get", + // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND error.Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataAttributeBindings/{dataAttributeBindingsId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "dataplex.projects.locations.dataAttributeBindings.testIamPermissions", // "parameterOrder": [ - // "name" + // "resource" // ], // "parameters": { - // "name": { - // "description": "Required. The resource name of the dataScan: projects/{project}/locations/{location_id}/dataScans/{data_scan_id} where project refers to a project_id or project_number and location_id refers to a GCP region.", + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See Resource names (https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataAttributeBindings/[^/]+$", // "required": true, // "type": "string" - // }, - // "view": { - // "description": "Optional. Select the DataScan view to return. Defaults to BASIC.", - // "enum": [ - // "DATA_SCAN_VIEW_UNSPECIFIED", - // "BASIC", - // "FULL" - // ], - // "enumDescriptions": [ - // "The API will default to the BASIC view.", - // "Basic view that does not include spec and result.", - // "Include everything." - // ], - // "location": "query", - // "type": "string" // } // }, - // "path": "v1/{+name}", + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "GoogleIamV1TestIamPermissionsRequest" + // }, // "response": { - // "$ref": "GoogleCloudDataplexV1DataScan" + // "$ref": "GoogleIamV1TestIamPermissionsResponse" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -9198,118 +9390,109 @@ func (c *ProjectsLocationsDataScansGetCall) Do(opts ...googleapi.CallOption) (*G } -// method id "dataplex.projects.locations.dataScans.getIamPolicy": +// method id "dataplex.projects.locations.dataScans.create": -type ProjectsLocationsDataScansGetIamPolicyCall struct { - s *Service - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataScansCreateCall struct { + s *Service + parent string + googleclouddataplexv1datascan *GoogleCloudDataplexV1DataScan + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// GetIamPolicy: Gets the access control policy for a resource. Returns -// an empty policy if the resource exists and does not have a policy -// set. +// Create: Creates a DataScan resource. // -// - 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 *ProjectsLocationsDataScansService) GetIamPolicy(resource string) *ProjectsLocationsDataScansGetIamPolicyCall { - c := &ProjectsLocationsDataScansGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - return c -} +// - parent: The resource name of the parent location: +// projects/{project}/locations/{location_id} where project refers to +// a project_id or project_number and location_id refers to a GCP +// region. +func (r *ProjectsLocationsDataScansService) Create(parent string, googleclouddataplexv1datascan *GoogleCloudDataplexV1DataScan) *ProjectsLocationsDataScansCreateCall { + c := &ProjectsLocationsDataScansCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddataplexv1datascan = googleclouddataplexv1datascan + 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 *ProjectsLocationsDataScansGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDataScansGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) +// DataScanId sets the optional parameter "dataScanId": Required. +// DataScan identifier. Must contain only lowercase letters, numbers and +// hyphens. Must start with a letter. Must end with a number or a +// letter. Must be between 1-63 characters. Must be unique within the +// customer project / location. +func (c *ProjectsLocationsDataScansCreateCall) DataScanId(dataScanId string) *ProjectsLocationsDataScansCreateCall { + c.urlParams_.Set("dataScanId", dataScanId) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Only +// validate the request, but do not perform mutations. The default is +// false. +func (c *ProjectsLocationsDataScansCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsDataScansCreateCall { + 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 information. -func (c *ProjectsLocationsDataScansGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansGetIamPolicyCall { +func (c *ProjectsLocationsDataScansCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response -// error from Do is the result of In-None-Match. -func (c *ProjectsLocationsDataScansGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataScansGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataScansGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsDataScansGetIamPolicyCall { +func (c *ProjectsLocationsDataScansCreateCall) Context(ctx context.Context) *ProjectsLocationsDataScansCreateCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataScansGetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsDataScansCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataScansGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataScansCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1datascan) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") 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, "v1/{+parent}/dataScans") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", 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{ - "resource": c.resource, + "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataScans.getIamPolicy" call. -// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 +// Do executes the "dataplex.projects.locations.dataScans.create" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *ProjectsLocationsDataScansGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +func (c *ProjectsLocationsDataScansCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -9328,7 +9511,7 @@ func (c *ProjectsLocationsDataScansGetIamPolicyCall) Do(opts ...googleapi.CallOp 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, @@ -9340,31 +9523,38 @@ func (c *ProjectsLocationsDataScansGetIamPolicyCall) Do(opts ...googleapi.CallOp } return ret, nil // { - // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}:getIamPolicy", - // "httpMethod": "GET", - // "id": "dataplex.projects.locations.dataScans.getIamPolicy", + // "description": "Creates a DataScan resource.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans", + // "httpMethod": "POST", + // "id": "dataplex.projects.locations.dataScans.create", // "parameterOrder": [ - // "resource" + // "parent" // ], // "parameters": { - // "options.requestedPolicyVersion": { - // "description": "Optional. 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).", - // "format": "int32", + // "dataScanId": { + // "description": "Required. DataScan identifier. Must contain only lowercase letters, numbers and hyphens. Must start with a letter. Must end with a number or a letter. Must be between 1-63 characters. Must be unique within the customer project / location.", // "location": "query", - // "type": "integer" + // "type": "string" // }, - // "resource": { - // "description": "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.", + // "parent": { + // "description": "Required. The resource name of the parent location: projects/{project}/locations/{location_id} where project refers to a project_id or project_number and location_id refers to a GCP region.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, // "type": "string" + // }, + // "validateOnly": { + // "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", + // "location": "query", + // "type": "boolean" // } // }, - // "path": "v1/{+resource}:getIamPolicy", + // "path": "v1/{+parent}/dataScans", + // "request": { + // "$ref": "GoogleCloudDataplexV1DataScan" + // }, // "response": { - // "$ref": "GoogleIamV1Policy" + // "$ref": "GoogleLongrunningOperation" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -9373,132 +9563,84 @@ func (c *ProjectsLocationsDataScansGetIamPolicyCall) Do(opts ...googleapi.CallOp } -// method id "dataplex.projects.locations.dataScans.list": +// method id "dataplex.projects.locations.dataScans.delete": -type ProjectsLocationsDataScansListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataScansDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// List: Lists DataScans. +// Delete: Deletes a DataScan resource. // -// - parent: The resource name of the parent location: -// projects/{project}/locations/{location_id} where project refers to -// a project_id or project_number and location_id refers to a GCP -// region. -func (r *ProjectsLocationsDataScansService) List(parent string) *ProjectsLocationsDataScansListCall { - c := &ProjectsLocationsDataScansListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// Filter sets the optional parameter "filter": Filter request. -func (c *ProjectsLocationsDataScansListCall) Filter(filter string) *ProjectsLocationsDataScansListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// OrderBy sets the optional parameter "orderBy": Order by fields (name -// or create_time) for the result. If not specified, the ordering is -// undefined. -func (c *ProjectsLocationsDataScansListCall) OrderBy(orderBy string) *ProjectsLocationsDataScansListCall { - c.urlParams_.Set("orderBy", orderBy) - return c -} - -// PageSize sets the optional parameter "pageSize": Maximum number of -// dataScans to return. The service may return fewer than this value. If -// unspecified, at most 500 scans will be returned. The maximum value is -// 1000; values above 1000 will be coerced to 1000. -func (c *ProjectsLocationsDataScansListCall) PageSize(pageSize int64) *ProjectsLocationsDataScansListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": Page token -// received from a previous ListDataScans call. Provide this to retrieve -// the subsequent page. When paginating, all other parameters provided -// to ListDataScans must match the call that provided the page token. -func (c *ProjectsLocationsDataScansListCall) PageToken(pageToken string) *ProjectsLocationsDataScansListCall { - c.urlParams_.Set("pageToken", pageToken) +// - name: The resource name of the dataScan: +// projects/{project}/locations/{location_id}/dataScans/{data_scan_id} +// where project refers to a project_id or project_number and +// location_id refers to a GCP region. +func (r *ProjectsLocationsDataScansService) Delete(name string) *ProjectsLocationsDataScansDeleteCall { + c := &ProjectsLocationsDataScansDeleteCall{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 information. -func (c *ProjectsLocationsDataScansListCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansListCall { +func (c *ProjectsLocationsDataScansDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response -// error from Do is the result of In-None-Match. -func (c *ProjectsLocationsDataScansListCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataScansListCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataScansListCall) Context(ctx context.Context) *ProjectsLocationsDataScansListCall { +func (c *ProjectsLocationsDataScansDeleteCall) Context(ctx context.Context) *ProjectsLocationsDataScansDeleteCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataScansListCall) Header() http.Header { +func (c *ProjectsLocationsDataScansDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataScansListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataScansDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dataScans") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, body) + req, err := http.NewRequest("DELETE", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataScans.list" call. -// Exactly one of *GoogleCloudDataplexV1ListDataScansResponse or error -// will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleCloudDataplexV1ListDataScansResponse.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 *ProjectsLocationsDataScansListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1ListDataScansResponse, error) { +// Do executes the "dataplex.projects.locations.dataScans.delete" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *ProjectsLocationsDataScansDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -9517,7 +9659,7 @@ func (c *ProjectsLocationsDataScansListCall) Do(opts ...googleapi.CallOption) (* if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDataplexV1ListDataScansResponse{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -9529,46 +9671,25 @@ func (c *ProjectsLocationsDataScansListCall) Do(opts ...googleapi.CallOption) (* } return ret, nil // { - // "description": "Lists DataScans.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans", - // "httpMethod": "GET", - // "id": "dataplex.projects.locations.dataScans.list", + // "description": "Deletes a DataScan resource.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}", + // "httpMethod": "DELETE", + // "id": "dataplex.projects.locations.dataScans.delete", // "parameterOrder": [ - // "parent" + // "name" // ], // "parameters": { - // "filter": { - // "description": "Optional. Filter request.", - // "location": "query", - // "type": "string" - // }, - // "orderBy": { - // "description": "Optional. Order by fields (name or create_time) for the result. If not specified, the ordering is undefined.", - // "location": "query", - // "type": "string" - // }, - // "pageSize": { - // "description": "Optional. Maximum number of dataScans to return. The service may return fewer than this value. If unspecified, at most 500 scans 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. Page token received from a previous ListDataScans call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListDataScans must match the call that provided the page token.", - // "location": "query", - // "type": "string" - // }, - // "parent": { - // "description": "Required. The resource name of the parent location: projects/{project}/locations/{location_id} where project refers to a project_id or project_number and location_id refers to a GCP region.", - // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+$", - // "required": true, + // "name": { + // "description": "Required. The resource name of the dataScan: projects/{project}/locations/{location_id}/dataScans/{data_scan_id} where project refers to a project_id or project_number and location_id refers to a GCP region.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+$", + // "required": true, // "type": "string" // } // }, - // "path": "v1/{+parent}/dataScans", + // "path": "v1/{+name}", // "response": { - // "$ref": "GoogleCloudDataplexV1ListDataScansResponse" + // "$ref": "GoogleLongrunningOperation" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -9577,110 +9698,96 @@ func (c *ProjectsLocationsDataScansListCall) Do(opts ...googleapi.CallOption) (* } -// 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 *ProjectsLocationsDataScansListCall) Pages(ctx context.Context, f func(*GoogleCloudDataplexV1ListDataScansResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point - 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) - } -} - -// method id "dataplex.projects.locations.dataScans.patch": +// method id "dataplex.projects.locations.dataScans.get": -type ProjectsLocationsDataScansPatchCall struct { - s *Service - name string - googleclouddataplexv1datascan *GoogleCloudDataplexV1DataScan - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataScansGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Patch: Updates a DataScan resource. +// Get: Gets a DataScan resource. // -// - name: Output only. The relative resource name of the scan, of the -// form: -// projects/{project}/locations/{location_id}/dataScans/{datascan_id}, +// - name: The resource name of the dataScan: +// projects/{project}/locations/{location_id}/dataScans/{data_scan_id} // where project refers to a project_id or project_number and // location_id refers to a GCP region. -func (r *ProjectsLocationsDataScansService) Patch(name string, googleclouddataplexv1datascan *GoogleCloudDataplexV1DataScan) *ProjectsLocationsDataScansPatchCall { - c := &ProjectsLocationsDataScansPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsDataScansService) Get(name string) *ProjectsLocationsDataScansGetCall { + c := &ProjectsLocationsDataScansGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googleclouddataplexv1datascan = googleclouddataplexv1datascan - return c -} - -// UpdateMask sets the optional parameter "updateMask": Required. Mask -// of fields to update. -func (c *ProjectsLocationsDataScansPatchCall) UpdateMask(updateMask string) *ProjectsLocationsDataScansPatchCall { - c.urlParams_.Set("updateMask", updateMask) return c } -// ValidateOnly sets the optional parameter "validateOnly": Only -// validate the request, but do not perform mutations. The default is -// false. -func (c *ProjectsLocationsDataScansPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsDataScansPatchCall { - c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) +// View sets the optional parameter "view": Select the DataScan view to +// return. Defaults to BASIC. +// +// Possible values: +// +// "DATA_SCAN_VIEW_UNSPECIFIED" - The API will default to the BASIC +// +// view. +// +// "BASIC" - Basic view that does not include spec and result. +// "FULL" - Include everything. +func (c *ProjectsLocationsDataScansGetCall) View(view string) *ProjectsLocationsDataScansGetCall { + c.urlParams_.Set("view", view) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsDataScansPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansPatchCall { +func (c *ProjectsLocationsDataScansGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsDataScansGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataScansGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataScansPatchCall) Context(ctx context.Context) *ProjectsLocationsDataScansPatchCall { +func (c *ProjectsLocationsDataScansGetCall) Context(ctx context.Context) *ProjectsLocationsDataScansGetCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataScansPatchCall) Header() http.Header { +func (c *ProjectsLocationsDataScansGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataScansPatchCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataScansGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1datascan) - if err != nil { - return nil, err + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } - reqHeaders.Set("Content-Type", "application/json") + var body io.Reader = nil 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, body) if err != nil { return nil, err } @@ -9691,14 +9798,14 @@ func (c *ProjectsLocationsDataScansPatchCall) doRequest(alt string) (*http.Respo return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataScans.patch" call. -// Exactly one of *GoogleLongrunningOperation or error will be non-nil. -// 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 +// Do executes the "dataplex.projects.locations.dataScans.get" call. +// Exactly one of *GoogleCloudDataplexV1DataScan or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *GoogleCloudDataplexV1DataScan.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 *ProjectsLocationsDataScansPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsDataScansGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1DataScan, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -9717,7 +9824,7 @@ func (c *ProjectsLocationsDataScansPatchCall) Do(opts ...googleapi.CallOption) ( if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDataplexV1DataScan{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -9729,39 +9836,40 @@ func (c *ProjectsLocationsDataScansPatchCall) Do(opts ...googleapi.CallOption) ( } return ret, nil // { - // "description": "Updates a DataScan resource.", + // "description": "Gets a DataScan resource.", // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}", - // "httpMethod": "PATCH", - // "id": "dataplex.projects.locations.dataScans.patch", + // "httpMethod": "GET", + // "id": "dataplex.projects.locations.dataScans.get", // "parameterOrder": [ // "name" // ], // "parameters": { // "name": { - // "description": "Output only. The relative resource name of the scan, of the form: projects/{project}/locations/{location_id}/dataScans/{datascan_id}, where project refers to a project_id or project_number and location_id refers to a GCP region.", + // "description": "Required. The resource name of the dataScan: projects/{project}/locations/{location_id}/dataScans/{data_scan_id} where project refers to a project_id or project_number and location_id refers to a GCP region.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+$", // "required": true, // "type": "string" // }, - // "updateMask": { - // "description": "Required. Mask of fields to update.", - // "format": "google-fieldmask", + // "view": { + // "description": "Optional. Select the DataScan view to return. Defaults to BASIC.", + // "enum": [ + // "DATA_SCAN_VIEW_UNSPECIFIED", + // "BASIC", + // "FULL" + // ], + // "enumDescriptions": [ + // "The API will default to the BASIC view.", + // "Basic view that does not include spec and result.", + // "Include everything." + // ], // "location": "query", // "type": "string" - // }, - // "validateOnly": { - // "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", - // "location": "query", - // "type": "boolean" // } // }, // "path": "v1/{+name}", - // "request": { - // "$ref": "GoogleCloudDataplexV1DataScan" - // }, // "response": { - // "$ref": "GoogleLongrunningOperation" + // "$ref": "GoogleCloudDataplexV1DataScan" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -9770,94 +9878,1508 @@ func (c *ProjectsLocationsDataScansPatchCall) Do(opts ...googleapi.CallOption) ( } -// method id "dataplex.projects.locations.dataScans.run": +// method id "dataplex.projects.locations.dataScans.getIamPolicy": -type ProjectsLocationsDataScansRunCall struct { - s *Service - name string - googleclouddataplexv1rundatascanrequest *GoogleCloudDataplexV1RunDataScanRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataScansGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Run: Runs an on-demand execution of a DataScan +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. // -// - name: The resource name of the DataScan: -// projects/{project}/locations/{location_id}/dataScans/{data_scan_id}. -// where project refers to a project_id or project_number and -// location_id refers to a GCP region.Only OnDemand data scans are -// allowed. -func (r *ProjectsLocationsDataScansService) Run(name string, googleclouddataplexv1rundatascanrequest *GoogleCloudDataplexV1RunDataScanRequest) *ProjectsLocationsDataScansRunCall { - c := &ProjectsLocationsDataScansRunCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.googleclouddataplexv1rundatascanrequest = googleclouddataplexv1rundatascanrequest +// - 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 *ProjectsLocationsDataScansService) GetIamPolicy(resource string) *ProjectsLocationsDataScansGetIamPolicyCall { + c := &ProjectsLocationsDataScansGetIamPolicyCall{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 *ProjectsLocationsDataScansGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDataScansGetIamPolicyCall { + 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 information. -func (c *ProjectsLocationsDataScansRunCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansRunCall { +func (c *ProjectsLocationsDataScansGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansGetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsDataScansGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataScansGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataScansRunCall) Context(ctx context.Context) *ProjectsLocationsDataScansRunCall { +func (c *ProjectsLocationsDataScansGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsDataScansGetIamPolicyCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataScansRunCall) Header() http.Header { +func (c *ProjectsLocationsDataScansGetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataScansRunCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataScansGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1rundatascanrequest) - if err != nil { - return nil, err + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } - reqHeaders.Set("Content-Type", "application/json") + var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:run") + 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, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataScans.run" call. -// Exactly one of *GoogleCloudDataplexV1RunDataScanResponse or error +// Do executes the "dataplex.projects.locations.dataScans.getIamPolicy" call. +// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *ProjectsLocationsDataScansGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, 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 := &GoogleIamV1Policy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "dataplex.projects.locations.dataScans.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. 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).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "GoogleIamV1Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "dataplex.projects.locations.dataScans.list": + +type ProjectsLocationsDataScansListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists DataScans. +// +// - parent: The resource name of the parent location: +// projects/{project}/locations/{location_id} where project refers to +// a project_id or project_number and location_id refers to a GCP +// region. +func (r *ProjectsLocationsDataScansService) List(parent string) *ProjectsLocationsDataScansListCall { + c := &ProjectsLocationsDataScansListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Filter request. +func (c *ProjectsLocationsDataScansListCall) Filter(filter string) *ProjectsLocationsDataScansListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Order by fields (name +// or create_time) for the result. If not specified, the ordering is +// undefined. +func (c *ProjectsLocationsDataScansListCall) OrderBy(orderBy string) *ProjectsLocationsDataScansListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// dataScans to return. The service may return fewer than this value. If +// unspecified, at most 500 scans will be returned. The maximum value is +// 1000; values above 1000 will be coerced to 1000. +func (c *ProjectsLocationsDataScansListCall) PageSize(pageSize int64) *ProjectsLocationsDataScansListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Page token +// received from a previous ListDataScans call. Provide this to retrieve +// the subsequent page. When paginating, all other parameters provided +// to ListDataScans must match the call that provided the page token. +func (c *ProjectsLocationsDataScansListCall) PageToken(pageToken string) *ProjectsLocationsDataScansListCall { + 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 information. +func (c *ProjectsLocationsDataScansListCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsDataScansListCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataScansListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsDataScansListCall) Context(ctx context.Context) *ProjectsLocationsDataScansListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsDataScansListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataScansListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dataScans") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataplex.projects.locations.dataScans.list" call. +// Exactly one of *GoogleCloudDataplexV1ListDataScansResponse or error // will be non-nil. Any non-2xx status code is an error. Response // headers are in either -// *GoogleCloudDataplexV1RunDataScanResponse.ServerResponse.Header or +// *GoogleCloudDataplexV1ListDataScansResponse.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 *ProjectsLocationsDataScansRunCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1RunDataScanResponse, error) { +func (c *ProjectsLocationsDataScansListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1ListDataScansResponse, 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 := &GoogleCloudDataplexV1ListDataScansResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists DataScans.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans", + // "httpMethod": "GET", + // "id": "dataplex.projects.locations.dataScans.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "filter": { + // "description": "Optional. Filter request.", + // "location": "query", + // "type": "string" + // }, + // "orderBy": { + // "description": "Optional. Order by fields (name or create_time) for the result. If not specified, the ordering is undefined.", + // "location": "query", + // "type": "string" + // }, + // "pageSize": { + // "description": "Optional. Maximum number of dataScans to return. The service may return fewer than this value. If unspecified, at most 500 scans 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. Page token received from a previous ListDataScans call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListDataScans must match the call that provided the page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The resource name of the parent location: projects/{project}/locations/{location_id} where project refers to a project_id or project_number and location_id refers to a GCP region.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/dataScans", + // "response": { + // "$ref": "GoogleCloudDataplexV1ListDataScansResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsDataScansListCall) Pages(ctx context.Context, f func(*GoogleCloudDataplexV1ListDataScansResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "dataplex.projects.locations.dataScans.patch": + +type ProjectsLocationsDataScansPatchCall struct { + s *Service + name string + googleclouddataplexv1datascan *GoogleCloudDataplexV1DataScan + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates a DataScan resource. +// +// - name: Output only. The relative resource name of the scan, of the +// form: +// projects/{project}/locations/{location_id}/dataScans/{datascan_id}, +// where project refers to a project_id or project_number and +// location_id refers to a GCP region. +func (r *ProjectsLocationsDataScansService) Patch(name string, googleclouddataplexv1datascan *GoogleCloudDataplexV1DataScan) *ProjectsLocationsDataScansPatchCall { + c := &ProjectsLocationsDataScansPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleclouddataplexv1datascan = googleclouddataplexv1datascan + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Mask +// of fields to update. +func (c *ProjectsLocationsDataScansPatchCall) UpdateMask(updateMask string) *ProjectsLocationsDataScansPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Only +// validate the request, but do not perform mutations. The default is +// false. +func (c *ProjectsLocationsDataScansPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsDataScansPatchCall { + 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 information. +func (c *ProjectsLocationsDataScansPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsDataScansPatchCall) Context(ctx context.Context) *ProjectsLocationsDataScansPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsDataScansPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataScansPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1datascan) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataplex.projects.locations.dataScans.patch" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *ProjectsLocationsDataScansPatchCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates a DataScan resource.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}", + // "httpMethod": "PATCH", + // "id": "dataplex.projects.locations.dataScans.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Output only. The relative resource name of the scan, of the form: projects/{project}/locations/{location_id}/dataScans/{datascan_id}, where project refers to a project_id or project_number and location_id refers to a GCP region.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Required. Mask of fields to update.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // }, + // "validateOnly": { + // "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "GoogleCloudDataplexV1DataScan" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "dataplex.projects.locations.dataScans.run": + +type ProjectsLocationsDataScansRunCall struct { + s *Service + name string + googleclouddataplexv1rundatascanrequest *GoogleCloudDataplexV1RunDataScanRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Run: Runs an on-demand execution of a DataScan +// +// - name: The resource name of the DataScan: +// projects/{project}/locations/{location_id}/dataScans/{data_scan_id}. +// where project refers to a project_id or project_number and +// location_id refers to a GCP region.Only OnDemand data scans are +// allowed. +func (r *ProjectsLocationsDataScansService) Run(name string, googleclouddataplexv1rundatascanrequest *GoogleCloudDataplexV1RunDataScanRequest) *ProjectsLocationsDataScansRunCall { + c := &ProjectsLocationsDataScansRunCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleclouddataplexv1rundatascanrequest = googleclouddataplexv1rundatascanrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsDataScansRunCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansRunCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsDataScansRunCall) Context(ctx context.Context) *ProjectsLocationsDataScansRunCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsDataScansRunCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataScansRunCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1rundatascanrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:run") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataplex.projects.locations.dataScans.run" call. +// Exactly one of *GoogleCloudDataplexV1RunDataScanResponse or error +// will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleCloudDataplexV1RunDataScanResponse.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 *ProjectsLocationsDataScansRunCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1RunDataScanResponse, 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 := &GoogleCloudDataplexV1RunDataScanResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Runs an on-demand execution of a DataScan", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}:run", + // "httpMethod": "POST", + // "id": "dataplex.projects.locations.dataScans.run", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The resource name of the DataScan: projects/{project}/locations/{location_id}/dataScans/{data_scan_id}. where project refers to a project_id or project_number and location_id refers to a GCP region.Only OnDemand data scans are allowed.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}:run", + // "request": { + // "$ref": "GoogleCloudDataplexV1RunDataScanRequest" + // }, + // "response": { + // "$ref": "GoogleCloudDataplexV1RunDataScanResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "dataplex.projects.locations.dataScans.setIamPolicy": + +type ProjectsLocationsDataScansSetIamPolicyCall struct { + s *Service + resource string + googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy.Can return NOT_FOUND, +// INVALID_ARGUMENT, and PERMISSION_DENIED errors. +// +// - 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 *ProjectsLocationsDataScansService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsDataScansSetIamPolicyCall { + c := &ProjectsLocationsDataScansSetIamPolicyCall{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 information. +func (c *ProjectsLocationsDataScansSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsDataScansSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsDataScansSetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsDataScansSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataScansSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataplex.projects.locations.dataScans.setIamPolicy" call. +// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *ProjectsLocationsDataScansSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, 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 := &GoogleIamV1Policy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Sets the access control policy on the specified resource. Replaces any existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "dataplex.projects.locations.dataScans.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "GoogleIamV1SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "GoogleIamV1Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "dataplex.projects.locations.dataScans.testIamPermissions": + +type ProjectsLocationsDataScansTestIamPermissionsCall struct { + s *Service + resource string + googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a NOT_FOUND error.Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. +func (r *ProjectsLocationsDataScansService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsDataScansTestIamPermissionsCall { + c := &ProjectsLocationsDataScansTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsDataScansTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsDataScansTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsDataScansTestIamPermissionsCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsDataScansTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataScansTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataplex.projects.locations.dataScans.testIamPermissions" call. +// Exactly one of *GoogleIamV1TestIamPermissionsResponse or error will +// be non-nil. Any non-2xx status code is an error. Response headers are +// in either +// *GoogleIamV1TestIamPermissionsResponse.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 *ProjectsLocationsDataScansTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, 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 := &GoogleIamV1TestIamPermissionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND error.Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "dataplex.projects.locations.dataScans.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See Resource names (https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "GoogleIamV1TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "GoogleIamV1TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "dataplex.projects.locations.dataScans.jobs.get": + +type ProjectsLocationsDataScansJobsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets a DataScanJob resource. +// +// - name: The resource name of the DataScanJob: +// projects/{project}/locations/{location_id}/dataScans/{data_scan_id}/ +// jobs/{data_scan_job_id} where project refers to a project_id or +// project_number and location_id refers to a GCP region. +func (r *ProjectsLocationsDataScansJobsService) Get(name string) *ProjectsLocationsDataScansJobsGetCall { + c := &ProjectsLocationsDataScansJobsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// View sets the optional parameter "view": Select the DataScanJob view +// to return. Defaults to BASIC. +// +// Possible values: +// +// "DATA_SCAN_JOB_VIEW_UNSPECIFIED" - The API will default to the +// +// BASIC view. +// +// "BASIC" - Basic view that does not include spec and result. +// "FULL" - Include everything. +func (c *ProjectsLocationsDataScansJobsGetCall) View(view string) *ProjectsLocationsDataScansJobsGetCall { + c.urlParams_.Set("view", view) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsDataScansJobsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansJobsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsDataScansJobsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataScansJobsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsDataScansJobsGetCall) Context(ctx context.Context) *ProjectsLocationsDataScansJobsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsDataScansJobsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataScansJobsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataplex.projects.locations.dataScans.jobs.get" call. +// Exactly one of *GoogleCloudDataplexV1DataScanJob or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *GoogleCloudDataplexV1DataScanJob.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 *ProjectsLocationsDataScansJobsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1DataScanJob, 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 := &GoogleCloudDataplexV1DataScanJob{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets a DataScanJob resource.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}/jobs/{jobsId}", + // "httpMethod": "GET", + // "id": "dataplex.projects.locations.dataScans.jobs.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The resource name of the DataScanJob: projects/{project}/locations/{location_id}/dataScans/{data_scan_id}/jobs/{data_scan_job_id} where project refers to a project_id or project_number and location_id refers to a GCP region.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+/jobs/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "view": { + // "description": "Optional. Select the DataScanJob view to return. Defaults to BASIC.", + // "enum": [ + // "DATA_SCAN_JOB_VIEW_UNSPECIFIED", + // "BASIC", + // "FULL" + // ], + // "enumDescriptions": [ + // "The API will default to the BASIC view.", + // "Basic view that does not include spec and result.", + // "Include everything." + // ], + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "GoogleCloudDataplexV1DataScanJob" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "dataplex.projects.locations.dataScans.jobs.list": + +type ProjectsLocationsDataScansJobsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists DataScanJobs under the given DataScan. +// +// - parent: The resource name of the parent environment: +// projects/{project}/locations/{location_id}/dataScans/{data_scan_id} +// where project refers to a project_id or project_number and +// location_id refers to a GCP region. +func (r *ProjectsLocationsDataScansJobsService) List(parent string) *ProjectsLocationsDataScansJobsListCall { + c := &ProjectsLocationsDataScansJobsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// DataScanJobs to return. The service may return fewer than this value. +// If unspecified, at most 10 DataScanJobs will be returned. The maximum +// value is 1000; values above 1000 will be coerced to 1000. +func (c *ProjectsLocationsDataScansJobsListCall) PageSize(pageSize int64) *ProjectsLocationsDataScansJobsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Page token +// received from a previous ListDataScanJobs call. Provide this to +// retrieve the subsequent page. When paginating, all other parameters +// provided to ListDataScanJobs must match the call that provided the +// page token. +func (c *ProjectsLocationsDataScansJobsListCall) PageToken(pageToken string) *ProjectsLocationsDataScansJobsListCall { + 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 information. +func (c *ProjectsLocationsDataScansJobsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansJobsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsDataScansJobsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataScansJobsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsDataScansJobsListCall) Context(ctx context.Context) *ProjectsLocationsDataScansJobsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsDataScansJobsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataScansJobsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/jobs") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataplex.projects.locations.dataScans.jobs.list" call. +// Exactly one of *GoogleCloudDataplexV1ListDataScanJobsResponse or +// error will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleCloudDataplexV1ListDataScanJobsResponse.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 *ProjectsLocationsDataScansJobsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1ListDataScanJobsResponse, 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 := &GoogleCloudDataplexV1ListDataScanJobsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists DataScanJobs under the given DataScan.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}/jobs", + // "httpMethod": "GET", + // "id": "dataplex.projects.locations.dataScans.jobs.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "Optional. Maximum number of DataScanJobs to return. The service may return fewer than this value. If unspecified, at most 10 DataScanJobs 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. Page token received from a previous ListDataScanJobs call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListDataScanJobs must match the call that provided the page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The resource name of the parent environment: projects/{project}/locations/{location_id}/dataScans/{data_scan_id} where project refers to a project_id or project_number and location_id refers to a GCP region.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/jobs", + // "response": { + // "$ref": "GoogleCloudDataplexV1ListDataScanJobsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsDataScansJobsListCall) Pages(ctx context.Context, f func(*GoogleCloudDataplexV1ListDataScanJobsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "dataplex.projects.locations.dataTaxonomies.create": + +type ProjectsLocationsDataTaxonomiesCreateCall struct { + s *Service + parent string + googleclouddataplexv1datataxonomy *GoogleCloudDataplexV1DataTaxonomy + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Create a DataTaxonomy resource. +// +// - parent: The resource name of the data taxonomy location, of the +// form: projects/{project_number}/locations/{location_id} where +// location_id refers to a GCP region. +func (r *ProjectsLocationsDataTaxonomiesService) Create(parent string, googleclouddataplexv1datataxonomy *GoogleCloudDataplexV1DataTaxonomy) *ProjectsLocationsDataTaxonomiesCreateCall { + c := &ProjectsLocationsDataTaxonomiesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddataplexv1datataxonomy = googleclouddataplexv1datataxonomy + return c +} + +// DataTaxonomyId sets the optional parameter "dataTaxonomyId": +// Required. DataTaxonomy identifier. * Must contain only lowercase +// letters, numbers and hyphens. * Must start with a letter. * Must be +// between 1-63 characters. * Must end with a number or a letter. * Must +// be unique within the Project. +func (c *ProjectsLocationsDataTaxonomiesCreateCall) DataTaxonomyId(dataTaxonomyId string) *ProjectsLocationsDataTaxonomiesCreateCall { + c.urlParams_.Set("dataTaxonomyId", dataTaxonomyId) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Only +// validate the request, but do not perform mutations. The default is +// false. +func (c *ProjectsLocationsDataTaxonomiesCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsDataTaxonomiesCreateCall { + 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 information. +func (c *ProjectsLocationsDataTaxonomiesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsDataTaxonomiesCreateCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsDataTaxonomiesCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataTaxonomiesCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1datataxonomy) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dataTaxonomies") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataplex.projects.locations.dataTaxonomies.create" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *ProjectsLocationsDataTaxonomiesCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -9876,7 +11398,7 @@ func (c *ProjectsLocationsDataScansRunCall) Do(opts ...googleapi.CallOption) (*G if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDataplexV1RunDataScanResponse{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -9888,28 +11410,38 @@ func (c *ProjectsLocationsDataScansRunCall) Do(opts ...googleapi.CallOption) (*G } return ret, nil // { - // "description": "Runs an on-demand execution of a DataScan", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}:run", + // "description": "Create a DataTaxonomy resource.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies", // "httpMethod": "POST", - // "id": "dataplex.projects.locations.dataScans.run", + // "id": "dataplex.projects.locations.dataTaxonomies.create", // "parameterOrder": [ - // "name" + // "parent" // ], // "parameters": { - // "name": { - // "description": "Required. The resource name of the DataScan: projects/{project}/locations/{location_id}/dataScans/{data_scan_id}. where project refers to a project_id or project_number and location_id refers to a GCP region.Only OnDemand data scans are allowed.", + // "dataTaxonomyId": { + // "description": "Required. DataTaxonomy identifier. * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the Project.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The resource name of the data taxonomy location, of the form: projects/{project_number}/locations/{location_id} where location_id refers to a GCP region.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, // "type": "string" + // }, + // "validateOnly": { + // "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", + // "location": "query", + // "type": "boolean" // } // }, - // "path": "v1/{+name}:run", + // "path": "v1/{+parent}/dataTaxonomies", // "request": { - // "$ref": "GoogleCloudDataplexV1RunDataScanRequest" + // "$ref": "GoogleCloudDataplexV1DataTaxonomy" // }, // "response": { - // "$ref": "GoogleCloudDataplexV1RunDataScanResponse" + // "$ref": "GoogleLongrunningOperation" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -9918,36 +11450,40 @@ func (c *ProjectsLocationsDataScansRunCall) Do(opts ...googleapi.CallOption) (*G } -// method id "dataplex.projects.locations.dataScans.setIamPolicy": +// method id "dataplex.projects.locations.dataTaxonomies.delete": -type ProjectsLocationsDataScansSetIamPolicyCall struct { - s *Service - resource string - googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataTaxonomiesDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// SetIamPolicy: Sets the access control policy on the specified -// resource. Replaces any existing policy.Can return NOT_FOUND, -// INVALID_ARGUMENT, and PERMISSION_DENIED errors. +// Delete: Deletes a DataTaxonomy resource. All attributes within the +// DataTaxonomy must be deleted before the DataTaxonomy can be deleted. // -// - 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 *ProjectsLocationsDataScansService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsDataScansSetIamPolicyCall { - c := &ProjectsLocationsDataScansSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest +// - name: The resource name of the DataTaxonomy: +// projects/{project_number}/locations/{location_id}/dataTaxonomies/{da +// ta_taxonomy_id}. +func (r *ProjectsLocationsDataTaxonomiesService) Delete(name string) *ProjectsLocationsDataTaxonomiesDeleteCall { + c := &ProjectsLocationsDataTaxonomiesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Etag sets the optional parameter "etag": If the client provided etag +// value does not match the current etag value,the DeleteDataTaxonomy +// method returns an ABORTED error. +func (c *ProjectsLocationsDataTaxonomiesDeleteCall) Etag(etag string) *ProjectsLocationsDataTaxonomiesDeleteCall { + c.urlParams_.Set("etag", etag) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsDataScansSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansSetIamPolicyCall { +func (c *ProjectsLocationsDataTaxonomiesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -9955,21 +11491,21 @@ func (c *ProjectsLocationsDataScansSetIamPolicyCall) Fields(s ...googleapi.Field // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataScansSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsDataScansSetIamPolicyCall { +func (c *ProjectsLocationsDataTaxonomiesDeleteCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesDeleteCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataScansSetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsDataTaxonomiesDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataScansSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataTaxonomiesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -9977,34 +11513,29 @@ func (c *ProjectsLocationsDataScansSetIamPolicyCall) doRequest(alt string) (*htt } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1setiampolicyrequest) - if err != nil { - return nil, err - } - reqHeaders.Set("Content-Type", "application/json") 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("DELETE", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataScans.setIamPolicy" call. -// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 +// Do executes the "dataplex.projects.locations.dataTaxonomies.delete" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *ProjectsLocationsDataScansSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +func (c *ProjectsLocationsDataTaxonomiesDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -10023,7 +11554,7 @@ func (c *ProjectsLocationsDataScansSetIamPolicyCall) Do(opts ...googleapi.CallOp 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, @@ -10035,28 +11566,30 @@ func (c *ProjectsLocationsDataScansSetIamPolicyCall) Do(opts ...googleapi.CallOp } return ret, nil // { - // "description": "Sets the access control policy on the specified resource. Replaces any existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}:setIamPolicy", - // "httpMethod": "POST", - // "id": "dataplex.projects.locations.dataScans.setIamPolicy", + // "description": "Deletes a DataTaxonomy resource. All attributes within the DataTaxonomy must be deleted before the DataTaxonomy can be deleted.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}", + // "httpMethod": "DELETE", + // "id": "dataplex.projects.locations.dataTaxonomies.delete", // "parameterOrder": [ - // "resource" + // "name" // ], // "parameters": { - // "resource": { - // "description": "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.", + // "etag": { + // "description": "Optional. If the client provided etag value does not match the current etag value,the DeleteDataTaxonomy method returns an ABORTED error.", + // "location": "query", + // "type": "string" + // }, + // "name": { + // "description": "Required. The resource name of the DataTaxonomy: projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+resource}:setIamPolicy", - // "request": { - // "$ref": "GoogleIamV1SetIamPolicyRequest" - // }, + // "path": "v1/{+name}", // "response": { - // "$ref": "GoogleIamV1Policy" + // "$ref": "GoogleLongrunningOperation" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -10065,97 +11598,98 @@ func (c *ProjectsLocationsDataScansSetIamPolicyCall) Do(opts ...googleapi.CallOp } -// method id "dataplex.projects.locations.dataScans.testIamPermissions": +// method id "dataplex.projects.locations.dataTaxonomies.get": -type ProjectsLocationsDataScansTestIamPermissionsCall struct { - s *Service - resource string - googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataTaxonomiesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// TestIamPermissions: Returns permissions that a caller has on the -// specified resource. If the resource does not exist, this will return -// an empty set of permissions, not a NOT_FOUND error.Note: This -// operation is designed to be used for building permission-aware UIs -// and command-line tools, not for authorization checking. This -// operation may "fail open" without warning. +// Get: Retrieves a DataTaxonomy resource. // -// - resource: REQUIRED: The resource for which the policy detail is -// being requested. See Resource names -// (https://cloud.google.com/apis/design/resource_names) for the -// appropriate value for this field. -func (r *ProjectsLocationsDataScansService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsDataScansTestIamPermissionsCall { - c := &ProjectsLocationsDataScansTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest +// - name: The resource name of the DataTaxonomy: +// projects/{project_number}/locations/{location_id}/dataTaxonomies/{da +// ta_taxonomy_id}. +func (r *ProjectsLocationsDataTaxonomiesService) Get(name string) *ProjectsLocationsDataTaxonomiesGetCall { + c := &ProjectsLocationsDataTaxonomiesGetCall{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 information. -func (c *ProjectsLocationsDataScansTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansTestIamPermissionsCall { +func (c *ProjectsLocationsDataTaxonomiesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsDataTaxonomiesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataTaxonomiesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataScansTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsDataScansTestIamPermissionsCall { +func (c *ProjectsLocationsDataTaxonomiesGetCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesGetCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataScansTestIamPermissionsCall) Header() http.Header { +func (c *ProjectsLocationsDataTaxonomiesGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataScansTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataTaxonomiesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1testiampermissionsrequest) - if err != nil { - return nil, err + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } - reqHeaders.Set("Content-Type", "application/json") + var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") + 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, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataScans.testIamPermissions" call. -// Exactly one of *GoogleIamV1TestIamPermissionsResponse or error will -// be non-nil. Any non-2xx status code is an error. Response headers are -// in either -// *GoogleIamV1TestIamPermissionsResponse.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 *ProjectsLocationsDataScansTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { +// Do executes the "dataplex.projects.locations.dataTaxonomies.get" call. +// Exactly one of *GoogleCloudDataplexV1DataTaxonomy or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *GoogleCloudDataplexV1DataTaxonomy.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 *ProjectsLocationsDataTaxonomiesGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1DataTaxonomy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -10174,7 +11708,7 @@ func (c *ProjectsLocationsDataScansTestIamPermissionsCall) Do(opts ...googleapi. if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleIamV1TestIamPermissionsResponse{ + ret := &GoogleCloudDataplexV1DataTaxonomy{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -10186,28 +11720,25 @@ func (c *ProjectsLocationsDataScansTestIamPermissionsCall) Do(opts ...googleapi. } return ret, nil // { - // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND error.Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}:testIamPermissions", - // "httpMethod": "POST", - // "id": "dataplex.projects.locations.dataScans.testIamPermissions", + // "description": "Retrieves a DataTaxonomy resource.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}", + // "httpMethod": "GET", + // "id": "dataplex.projects.locations.dataTaxonomies.get", // "parameterOrder": [ - // "resource" + // "name" // ], // "parameters": { - // "resource": { - // "description": "REQUIRED: The resource for which the policy detail is being requested. See Resource names (https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + // "name": { + // "description": "Required. The resource name of the DataTaxonomy: projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+resource}:testIamPermissions", - // "request": { - // "$ref": "GoogleIamV1TestIamPermissionsRequest" - // }, + // "path": "v1/{+name}", // "response": { - // "$ref": "GoogleIamV1TestIamPermissionsResponse" + // "$ref": "GoogleCloudDataplexV1DataTaxonomy" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -10216,49 +11747,53 @@ func (c *ProjectsLocationsDataScansTestIamPermissionsCall) Do(opts ...googleapi. } -// method id "dataplex.projects.locations.dataScans.jobs.get": +// method id "dataplex.projects.locations.dataTaxonomies.getIamPolicy": -type ProjectsLocationsDataScansJobsGetCall struct { +type ProjectsLocationsDataTaxonomiesGetIamPolicyCall struct { s *Service - name string + resource string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// Get: Gets a DataScanJob resource. +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. // -// - name: The resource name of the DataScanJob: -// projects/{project}/locations/{location_id}/dataScans/{data_scan_id}/ -// jobs/{data_scan_job_id} where project refers to a project_id or -// project_number and location_id refers to a GCP region. -func (r *ProjectsLocationsDataScansJobsService) Get(name string) *ProjectsLocationsDataScansJobsGetCall { - c := &ProjectsLocationsDataScansJobsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - 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 *ProjectsLocationsDataTaxonomiesService) GetIamPolicy(resource string) *ProjectsLocationsDataTaxonomiesGetIamPolicyCall { + c := &ProjectsLocationsDataTaxonomiesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource return c } -// View sets the optional parameter "view": Select the DataScanJob view -// to return. Defaults to BASIC. -// -// Possible values: -// -// "DATA_SCAN_JOB_VIEW_UNSPECIFIED" - The API will default to the -// -// BASIC view. -// -// "BASIC" - Basic view that does not include spec and result. -// "FULL" - Include everything. -func (c *ProjectsLocationsDataScansJobsGetCall) View(view string) *ProjectsLocationsDataScansJobsGetCall { - c.urlParams_.Set("view", view) +// 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 *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDataTaxonomiesGetIamPolicyCall { + 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 information. -func (c *ProjectsLocationsDataScansJobsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansJobsGetCall { +func (c *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesGetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -10268,7 +11803,7 @@ func (c *ProjectsLocationsDataScansJobsGetCall) Fields(s ...googleapi.Field) *Pr // getting updates only after the object has changed since the last // request. Use googleapi.IsNotModified to check whether the response // error from Do is the result of In-None-Match. -func (c *ProjectsLocationsDataScansJobsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataScansJobsGetCall { +func (c *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataTaxonomiesGetIamPolicyCall { c.ifNoneMatch_ = entityTag return c } @@ -10276,21 +11811,21 @@ func (c *ProjectsLocationsDataScansJobsGetCall) IfNoneMatch(entityTag string) *P // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataScansJobsGetCall) Context(ctx context.Context) *ProjectsLocationsDataScansJobsGetCall { +func (c *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesGetIamPolicyCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataScansJobsGetCall) Header() http.Header { +func (c *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataScansJobsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -10303,7 +11838,7 @@ func (c *ProjectsLocationsDataScansJobsGetCall) doRequest(alt string) (*http.Res var body io.Reader = nil 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/{+resource}:getIamPolicy") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -10311,19 +11846,19 @@ func (c *ProjectsLocationsDataScansJobsGetCall) doRequest(alt string) (*http.Res } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataScans.jobs.get" call. -// Exactly one of *GoogleCloudDataplexV1DataScanJob or error will be -// non-nil. Any non-2xx status code is an error. Response headers are in -// either *GoogleCloudDataplexV1DataScanJob.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 +// Do executes the "dataplex.projects.locations.dataTaxonomies.getIamPolicy" call. +// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *ProjectsLocationsDataScansJobsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1DataScanJob, error) { +func (c *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -10342,7 +11877,7 @@ func (c *ProjectsLocationsDataScansJobsGetCall) Do(opts ...googleapi.CallOption) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDataplexV1DataScanJob{ + ret := &GoogleIamV1Policy{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -10354,40 +11889,31 @@ func (c *ProjectsLocationsDataScansJobsGetCall) Do(opts ...googleapi.CallOption) } return ret, nil // { - // "description": "Gets a DataScanJob resource.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}/jobs/{jobsId}", + // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}:getIamPolicy", // "httpMethod": "GET", - // "id": "dataplex.projects.locations.dataScans.jobs.get", + // "id": "dataplex.projects.locations.dataTaxonomies.getIamPolicy", // "parameterOrder": [ - // "name" + // "resource" // ], // "parameters": { - // "name": { - // "description": "Required. The resource name of the DataScanJob: projects/{project}/locations/{location_id}/dataScans/{data_scan_id}/jobs/{data_scan_job_id} where project refers to a project_id or project_number and location_id refers to a GCP region.", + // "options.requestedPolicyVersion": { + // "description": "Optional. 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).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "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.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+/jobs/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+$", // "required": true, // "type": "string" - // }, - // "view": { - // "description": "Optional. Select the DataScanJob view to return. Defaults to BASIC.", - // "enum": [ - // "DATA_SCAN_JOB_VIEW_UNSPECIFIED", - // "BASIC", - // "FULL" - // ], - // "enumDescriptions": [ - // "The API will default to the BASIC view.", - // "Basic view that does not include spec and result.", - // "Include everything." - // ], - // "location": "query", - // "type": "string" // } // }, - // "path": "v1/{+name}", + // "path": "v1/{+resource}:getIamPolicy", // "response": { - // "$ref": "GoogleCloudDataplexV1DataScanJob" + // "$ref": "GoogleIamV1Policy" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -10396,9 +11922,9 @@ func (c *ProjectsLocationsDataScansJobsGetCall) Do(opts ...googleapi.CallOption) } -// method id "dataplex.projects.locations.dataScans.jobs.list": +// method id "dataplex.projects.locations.dataTaxonomies.list": -type ProjectsLocationsDataScansJobsListCall struct { +type ProjectsLocationsDataTaxonomiesListCall struct { s *Service parent string urlParams_ gensupport.URLParams @@ -10407,33 +11933,45 @@ type ProjectsLocationsDataScansJobsListCall struct { header_ http.Header } -// List: Lists DataScanJobs under the given DataScan. -// -// - parent: The resource name of the parent environment: -// projects/{project}/locations/{location_id}/dataScans/{data_scan_id} -// where project refers to a project_id or project_number and +// List: Lists DataTaxonomy resources in a project and location. +// +// - parent: The resource name of the DataTaxonomy location, of the +// form: projects/{project_number}/locations/{location_id} where // location_id refers to a GCP region. -func (r *ProjectsLocationsDataScansJobsService) List(parent string) *ProjectsLocationsDataScansJobsListCall { - c := &ProjectsLocationsDataScansJobsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsDataTaxonomiesService) List(parent string) *ProjectsLocationsDataTaxonomiesListCall { + c := &ProjectsLocationsDataTaxonomiesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } +// Filter sets the optional parameter "filter": Filter request. +func (c *ProjectsLocationsDataTaxonomiesListCall) Filter(filter string) *ProjectsLocationsDataTaxonomiesListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Order by fields for +// the result. +func (c *ProjectsLocationsDataTaxonomiesListCall) OrderBy(orderBy string) *ProjectsLocationsDataTaxonomiesListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + // PageSize sets the optional parameter "pageSize": Maximum number of -// DataScanJobs to return. The service may return fewer than this value. -// If unspecified, at most 10 DataScanJobs will be returned. The maximum -// value is 1000; values above 1000 will be coerced to 1000. -func (c *ProjectsLocationsDataScansJobsListCall) PageSize(pageSize int64) *ProjectsLocationsDataScansJobsListCall { +// DataTaxonomies to return. The service may return fewer than this +// value. If unspecified, at most 10 DataTaxonomies will be returned. +// The maximum value is 1000; values above 1000 will be coerced to 1000. +func (c *ProjectsLocationsDataTaxonomiesListCall) PageSize(pageSize int64) *ProjectsLocationsDataTaxonomiesListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": Page token -// received from a previous ListDataScanJobs call. Provide this to +// received from a previous ListDataTaxonomies call. Provide this to // retrieve the subsequent page. When paginating, all other parameters -// provided to ListDataScanJobs must match the call that provided the +// provided to ListDataTaxonomies must match the call that provided the // page token. -func (c *ProjectsLocationsDataScansJobsListCall) PageToken(pageToken string) *ProjectsLocationsDataScansJobsListCall { +func (c *ProjectsLocationsDataTaxonomiesListCall) PageToken(pageToken string) *ProjectsLocationsDataTaxonomiesListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -10441,7 +11979,7 @@ func (c *ProjectsLocationsDataScansJobsListCall) PageToken(pageToken string) *Pr // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsDataScansJobsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataScansJobsListCall { +func (c *ProjectsLocationsDataTaxonomiesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -10451,7 +11989,7 @@ func (c *ProjectsLocationsDataScansJobsListCall) Fields(s ...googleapi.Field) *P // getting updates only after the object has changed since the last // request. Use googleapi.IsNotModified to check whether the response // error from Do is the result of In-None-Match. -func (c *ProjectsLocationsDataScansJobsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataScansJobsListCall { +func (c *ProjectsLocationsDataTaxonomiesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataTaxonomiesListCall { c.ifNoneMatch_ = entityTag return c } @@ -10459,21 +11997,21 @@ func (c *ProjectsLocationsDataScansJobsListCall) IfNoneMatch(entityTag string) * // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataScansJobsListCall) Context(ctx context.Context) *ProjectsLocationsDataScansJobsListCall { +func (c *ProjectsLocationsDataTaxonomiesListCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesListCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataScansJobsListCall) Header() http.Header { +func (c *ProjectsLocationsDataTaxonomiesListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataScansJobsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataTaxonomiesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -10486,7 +12024,7 @@ func (c *ProjectsLocationsDataScansJobsListCall) doRequest(alt string) (*http.Re var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/jobs") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dataTaxonomies") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -10499,16 +12037,18 @@ func (c *ProjectsLocationsDataScansJobsListCall) doRequest(alt string) (*http.Re return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataScans.jobs.list" call. -// Exactly one of *GoogleCloudDataplexV1ListDataScanJobsResponse or +// Do executes the "dataplex.projects.locations.dataTaxonomies.list" call. +// Exactly one of *GoogleCloudDataplexV1ListDataTaxonomiesResponse or // error will be non-nil. Any non-2xx status code is an error. Response // headers are in either -// *GoogleCloudDataplexV1ListDataScanJobsResponse.ServerResponse.Header -// or (if a response was returned at all) in +// *GoogleCloudDataplexV1ListDataTaxonomiesResponse.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 *ProjectsLocationsDataScansJobsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1ListDataScanJobsResponse, error) { +func (c *ProjectsLocationsDataTaxonomiesListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1ListDataTaxonomiesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -10527,7 +12067,7 @@ func (c *ProjectsLocationsDataScansJobsListCall) Do(opts ...googleapi.CallOption if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDataplexV1ListDataScanJobsResponse{ + ret := &GoogleCloudDataplexV1ListDataTaxonomiesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -10539,36 +12079,46 @@ func (c *ProjectsLocationsDataScansJobsListCall) Do(opts ...googleapi.CallOption } return ret, nil // { - // "description": "Lists DataScanJobs under the given DataScan.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataScans/{dataScansId}/jobs", + // "description": "Lists DataTaxonomy resources in a project and location.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies", // "httpMethod": "GET", - // "id": "dataplex.projects.locations.dataScans.jobs.list", + // "id": "dataplex.projects.locations.dataTaxonomies.list", // "parameterOrder": [ // "parent" // ], // "parameters": { + // "filter": { + // "description": "Optional. Filter request.", + // "location": "query", + // "type": "string" + // }, + // "orderBy": { + // "description": "Optional. Order by fields for the result.", + // "location": "query", + // "type": "string" + // }, // "pageSize": { - // "description": "Optional. Maximum number of DataScanJobs to return. The service may return fewer than this value. If unspecified, at most 10 DataScanJobs will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + // "description": "Optional. Maximum number of DataTaxonomies to return. The service may return fewer than this value. If unspecified, at most 10 DataTaxonomies 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. Page token received from a previous ListDataScanJobs call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListDataScanJobs must match the call that provided the page token.", + // "description": "Optional. Page token received from a previous ListDataTaxonomies call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListDataTaxonomies must match the call that provided the page token.", // "location": "query", // "type": "string" // }, // "parent": { - // "description": "Required. The resource name of the parent environment: projects/{project}/locations/{location_id}/dataScans/{data_scan_id} where project refers to a project_id or project_number and location_id refers to a GCP region.", + // "description": "Required. The resource name of the DataTaxonomy location, of the form: projects/{project_number}/locations/{location_id} where location_id refers to a GCP region.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataScans/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+parent}/jobs", + // "path": "v1/{+parent}/dataTaxonomies", // "response": { - // "$ref": "GoogleCloudDataplexV1ListDataScanJobsResponse" + // "$ref": "GoogleCloudDataplexV1ListDataTaxonomiesResponse" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -10580,7 +12130,7 @@ func (c *ProjectsLocationsDataScansJobsListCall) Do(opts ...googleapi.CallOption // 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 *ProjectsLocationsDataScansJobsListCall) Pages(ctx context.Context, f func(*GoogleCloudDataplexV1ListDataScanJobsResponse) error) error { +func (c *ProjectsLocationsDataTaxonomiesListCall) Pages(ctx context.Context, f func(*GoogleCloudDataplexV1ListDataTaxonomiesResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point for { @@ -10598,51 +12148,207 @@ func (c *ProjectsLocationsDataScansJobsListCall) Pages(ctx context.Context, f fu } } -// method id "dataplex.projects.locations.dataTaxonomies.create": +// method id "dataplex.projects.locations.dataTaxonomies.patch": + +type ProjectsLocationsDataTaxonomiesPatchCall struct { + s *Service + name string + googleclouddataplexv1datataxonomy *GoogleCloudDataplexV1DataTaxonomy + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates a DataTaxonomy resource. +// +// - name: Output only. The relative resource name of the DataTaxonomy, +// of the form: +// projects/{project_number}/locations/{location_id}/dataTaxonomies/{da +// ta_taxonomy_id}. +func (r *ProjectsLocationsDataTaxonomiesService) Patch(name string, googleclouddataplexv1datataxonomy *GoogleCloudDataplexV1DataTaxonomy) *ProjectsLocationsDataTaxonomiesPatchCall { + c := &ProjectsLocationsDataTaxonomiesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleclouddataplexv1datataxonomy = googleclouddataplexv1datataxonomy + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Mask +// of fields to update. +func (c *ProjectsLocationsDataTaxonomiesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsDataTaxonomiesPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Only +// validate the request, but do not perform mutations. The default is +// false. +func (c *ProjectsLocationsDataTaxonomiesPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsDataTaxonomiesPatchCall { + 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 information. +func (c *ProjectsLocationsDataTaxonomiesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsDataTaxonomiesPatchCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsDataTaxonomiesPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataTaxonomiesPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1datataxonomy) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataplex.projects.locations.dataTaxonomies.patch" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *ProjectsLocationsDataTaxonomiesPatchCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates a DataTaxonomy resource.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}", + // "httpMethod": "PATCH", + // "id": "dataplex.projects.locations.dataTaxonomies.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Output only. The relative resource name of the DataTaxonomy, of the form: projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Required. Mask of fields to update.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // }, + // "validateOnly": { + // "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "GoogleCloudDataplexV1DataTaxonomy" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } -type ProjectsLocationsDataTaxonomiesCreateCall struct { - s *Service - parent string - googleclouddataplexv1datataxonomy *GoogleCloudDataplexV1DataTaxonomy - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header } -// Create: Create a DataTaxonomy resource. -// -// - parent: The resource name of the data taxonomy location, of the -// form: projects/{project_number}/locations/{location_id} where -// location_id refers to a GCP region. -func (r *ProjectsLocationsDataTaxonomiesService) Create(parent string, googleclouddataplexv1datataxonomy *GoogleCloudDataplexV1DataTaxonomy) *ProjectsLocationsDataTaxonomiesCreateCall { - c := &ProjectsLocationsDataTaxonomiesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.googleclouddataplexv1datataxonomy = googleclouddataplexv1datataxonomy - return c -} +// method id "dataplex.projects.locations.dataTaxonomies.setIamPolicy": -// DataTaxonomyId sets the optional parameter "dataTaxonomyId": -// Required. DataTaxonomy identifier. * Must contain only lowercase -// letters, numbers and hyphens. * Must start with a letter. * Must be -// between 1-63 characters. * Must end with a number or a letter. * Must -// be unique within the Project. -func (c *ProjectsLocationsDataTaxonomiesCreateCall) DataTaxonomyId(dataTaxonomyId string) *ProjectsLocationsDataTaxonomiesCreateCall { - c.urlParams_.Set("dataTaxonomyId", dataTaxonomyId) - return c +type ProjectsLocationsDataTaxonomiesSetIamPolicyCall struct { + s *Service + resource string + googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// ValidateOnly sets the optional parameter "validateOnly": Only -// validate the request, but do not perform mutations. The default is -// false. -func (c *ProjectsLocationsDataTaxonomiesCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsDataTaxonomiesCreateCall { - c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy.Can return NOT_FOUND, +// INVALID_ARGUMENT, and PERMISSION_DENIED errors. +// +// - 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 *ProjectsLocationsDataTaxonomiesService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsDataTaxonomiesSetIamPolicyCall { + c := &ProjectsLocationsDataTaxonomiesSetIamPolicyCall{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 information. -func (c *ProjectsLocationsDataTaxonomiesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesCreateCall { +func (c *ProjectsLocationsDataTaxonomiesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesSetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -10650,21 +12356,21 @@ func (c *ProjectsLocationsDataTaxonomiesCreateCall) Fields(s ...googleapi.Field) // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataTaxonomiesCreateCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesCreateCall { +func (c *ProjectsLocationsDataTaxonomiesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesSetIamPolicyCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataTaxonomiesCreateCall) Header() http.Header { +func (c *ProjectsLocationsDataTaxonomiesSetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataTaxonomiesCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataTaxonomiesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -10672,14 +12378,14 @@ func (c *ProjectsLocationsDataTaxonomiesCreateCall) doRequest(alt string) (*http } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1datataxonomy) + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1setiampolicyrequest) if err != nil { return nil, err } reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dataTaxonomies") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -10687,19 +12393,19 @@ func (c *ProjectsLocationsDataTaxonomiesCreateCall) doRequest(alt string) (*http } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataTaxonomies.create" call. -// Exactly one of *GoogleLongrunningOperation or error will be non-nil. -// 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 +// Do executes the "dataplex.projects.locations.dataTaxonomies.setIamPolicy" call. +// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *ProjectsLocationsDataTaxonomiesCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsDataTaxonomiesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -10718,7 +12424,7 @@ func (c *ProjectsLocationsDataTaxonomiesCreateCall) Do(opts ...googleapi.CallOpt 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, @@ -10730,38 +12436,28 @@ func (c *ProjectsLocationsDataTaxonomiesCreateCall) Do(opts ...googleapi.CallOpt } return ret, nil // { - // "description": "Create a DataTaxonomy resource.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies", + // "description": "Sets the access control policy on the specified resource. Replaces any existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}:setIamPolicy", // "httpMethod": "POST", - // "id": "dataplex.projects.locations.dataTaxonomies.create", + // "id": "dataplex.projects.locations.dataTaxonomies.setIamPolicy", // "parameterOrder": [ - // "parent" + // "resource" // ], // "parameters": { - // "dataTaxonomyId": { - // "description": "Required. DataTaxonomy identifier. * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the Project.", - // "location": "query", - // "type": "string" - // }, - // "parent": { - // "description": "Required. The resource name of the data taxonomy location, of the form: projects/{project_number}/locations/{location_id} where location_id refers to a GCP region.", + // "resource": { + // "description": "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.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+$", // "required": true, // "type": "string" - // }, - // "validateOnly": { - // "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", - // "location": "query", - // "type": "boolean" // } // }, - // "path": "v1/{+parent}/dataTaxonomies", + // "path": "v1/{+resource}:setIamPolicy", // "request": { - // "$ref": "GoogleCloudDataplexV1DataTaxonomy" + // "$ref": "GoogleIamV1SetIamPolicyRequest" // }, // "response": { - // "$ref": "GoogleLongrunningOperation" + // "$ref": "GoogleIamV1Policy" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -10770,40 +12466,39 @@ func (c *ProjectsLocationsDataTaxonomiesCreateCall) Do(opts ...googleapi.CallOpt } -// method id "dataplex.projects.locations.dataTaxonomies.delete": +// method id "dataplex.projects.locations.dataTaxonomies.testIamPermissions": -type ProjectsLocationsDataTaxonomiesDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataTaxonomiesTestIamPermissionsCall struct { + s *Service + resource string + googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Delete: Deletes a DataTaxonomy resource. All attributes within the -// DataTaxonomy must be deleted before the DataTaxonomy can be deleted. +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a NOT_FOUND error.Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. // -// - name: The resource name of the DataTaxonomy: -// projects/{project_number}/locations/{location_id}/dataTaxonomies/{da -// ta_taxonomy_id}. -func (r *ProjectsLocationsDataTaxonomiesService) Delete(name string) *ProjectsLocationsDataTaxonomiesDeleteCall { - c := &ProjectsLocationsDataTaxonomiesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Etag sets the optional parameter "etag": If the client provided etag -// value does not match the current etag value,the DeleteDataTaxonomy -// method returns an ABORTED error. -func (c *ProjectsLocationsDataTaxonomiesDeleteCall) Etag(etag string) *ProjectsLocationsDataTaxonomiesDeleteCall { - c.urlParams_.Set("etag", etag) +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. +func (r *ProjectsLocationsDataTaxonomiesService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall { + c := &ProjectsLocationsDataTaxonomiesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsDataTaxonomiesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesDeleteCall { +func (c *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -10811,21 +12506,21 @@ func (c *ProjectsLocationsDataTaxonomiesDeleteCall) Fields(s ...googleapi.Field) // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataTaxonomiesDeleteCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesDeleteCall { +func (c *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataTaxonomiesDeleteCall) Header() http.Header { +func (c *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataTaxonomiesDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -10833,29 +12528,35 @@ func (c *ProjectsLocationsDataTaxonomiesDeleteCall) doRequest(alt string) (*http } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") 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/{+resource}:testIamPermissions") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", 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, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataTaxonomies.delete" call. -// Exactly one of *GoogleLongrunningOperation or error will be non-nil. -// 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 +// Do executes the "dataplex.projects.locations.dataTaxonomies.testIamPermissions" call. +// Exactly one of *GoogleIamV1TestIamPermissionsResponse or error will +// be non-nil. Any non-2xx status code is an error. Response headers are +// in either +// *GoogleIamV1TestIamPermissionsResponse.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 *ProjectsLocationsDataTaxonomiesDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -10874,7 +12575,7 @@ func (c *ProjectsLocationsDataTaxonomiesDeleteCall) Do(opts ...googleapi.CallOpt if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleIamV1TestIamPermissionsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -10886,30 +12587,28 @@ func (c *ProjectsLocationsDataTaxonomiesDeleteCall) Do(opts ...googleapi.CallOpt } return ret, nil // { - // "description": "Deletes a DataTaxonomy resource. All attributes within the DataTaxonomy must be deleted before the DataTaxonomy can be deleted.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}", - // "httpMethod": "DELETE", - // "id": "dataplex.projects.locations.dataTaxonomies.delete", + // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND error.Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "dataplex.projects.locations.dataTaxonomies.testIamPermissions", // "parameterOrder": [ - // "name" + // "resource" // ], // "parameters": { - // "etag": { - // "description": "Optional. If the client provided etag value does not match the current etag value,the DeleteDataTaxonomy method returns an ABORTED error.", - // "location": "query", - // "type": "string" - // }, - // "name": { - // "description": "Required. The resource name of the DataTaxonomy: projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}", + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See Resource names (https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+name}", + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "GoogleIamV1TestIamPermissionsRequest" + // }, // "response": { - // "$ref": "GoogleLongrunningOperation" + // "$ref": "GoogleIamV1TestIamPermissionsResponse" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -10918,98 +12617,108 @@ func (c *ProjectsLocationsDataTaxonomiesDeleteCall) Do(opts ...googleapi.CallOpt } -// method id "dataplex.projects.locations.dataTaxonomies.get": +// method id "dataplex.projects.locations.dataTaxonomies.attributes.create": -type ProjectsLocationsDataTaxonomiesGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataTaxonomiesAttributesCreateCall struct { + s *Service + parent string + googleclouddataplexv1dataattribute *GoogleCloudDataplexV1DataAttribute + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Get: Retrieves a DataTaxonomy resource. +// Create: Create a DataAttribute resource. // -// - name: The resource name of the DataTaxonomy: +// - parent: The resource name of the parent data taxonomy // projects/{project_number}/locations/{location_id}/dataTaxonomies/{da // ta_taxonomy_id}. -func (r *ProjectsLocationsDataTaxonomiesService) Get(name string) *ProjectsLocationsDataTaxonomiesGetCall { - c := &ProjectsLocationsDataTaxonomiesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +func (r *ProjectsLocationsDataTaxonomiesAttributesService) Create(parent string, googleclouddataplexv1dataattribute *GoogleCloudDataplexV1DataAttribute) *ProjectsLocationsDataTaxonomiesAttributesCreateCall { + c := &ProjectsLocationsDataTaxonomiesAttributesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddataplexv1dataattribute = googleclouddataplexv1dataattribute + return c +} + +// DataAttributeId sets the optional parameter "dataAttributeId": +// Required. DataAttribute identifier. * Must contain only lowercase +// letters, numbers and hyphens. * Must start with a letter. * Must be +// between 1-63 characters. * Must end with a number or a letter. * Must +// be unique within the DataTaxonomy. +func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) DataAttributeId(dataAttributeId string) *ProjectsLocationsDataTaxonomiesAttributesCreateCall { + c.urlParams_.Set("dataAttributeId", dataAttributeId) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Only +// validate the request, but do not perform mutations. The default is +// false. +func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsDataTaxonomiesAttributesCreateCall { + 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 information. -func (c *ProjectsLocationsDataTaxonomiesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesGetCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesAttributesCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response -// error from Do is the result of In-None-Match. -func (c *ProjectsLocationsDataTaxonomiesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataTaxonomiesGetCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataTaxonomiesGetCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesGetCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesAttributesCreateCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataTaxonomiesGetCall) Header() http.Header { +func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataTaxonomiesGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1dataattribute) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") 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}/attributes") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", 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, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataTaxonomies.get" call. -// Exactly one of *GoogleCloudDataplexV1DataTaxonomy or error will be -// non-nil. Any non-2xx status code is an error. Response headers are in -// either *GoogleCloudDataplexV1DataTaxonomy.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 *ProjectsLocationsDataTaxonomiesGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1DataTaxonomy, error) { +// Do executes the "dataplex.projects.locations.dataTaxonomies.attributes.create" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *ProjectsLocationsDataTaxonomiesAttributesCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -11028,7 +12737,7 @@ func (c *ProjectsLocationsDataTaxonomiesGetCall) Do(opts ...googleapi.CallOption if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDataplexV1DataTaxonomy{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -11040,25 +12749,38 @@ func (c *ProjectsLocationsDataTaxonomiesGetCall) Do(opts ...googleapi.CallOption } return ret, nil // { - // "description": "Retrieves a DataTaxonomy resource.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}", - // "httpMethod": "GET", - // "id": "dataplex.projects.locations.dataTaxonomies.get", + // "description": "Create a DataAttribute resource.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}/attributes", + // "httpMethod": "POST", + // "id": "dataplex.projects.locations.dataTaxonomies.attributes.create", // "parameterOrder": [ - // "name" + // "parent" // ], // "parameters": { - // "name": { - // "description": "Required. The resource name of the DataTaxonomy: projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}", + // "dataAttributeId": { + // "description": "Required. DataAttribute identifier. * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the DataTaxonomy.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The resource name of the parent data taxonomy projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+$", // "required": true, // "type": "string" + // }, + // "validateOnly": { + // "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", + // "location": "query", + // "type": "boolean" // } // }, - // "path": "v1/{+name}", + // "path": "v1/{+parent}/attributes", + // "request": { + // "$ref": "GoogleCloudDataplexV1DataAttribute" + // }, // "response": { - // "$ref": "GoogleCloudDataplexV1DataTaxonomy" + // "$ref": "GoogleLongrunningOperation" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -11067,118 +12789,91 @@ func (c *ProjectsLocationsDataTaxonomiesGetCall) Do(opts ...googleapi.CallOption } -// method id "dataplex.projects.locations.dataTaxonomies.getIamPolicy": +// method id "dataplex.projects.locations.dataTaxonomies.attributes.delete": -type ProjectsLocationsDataTaxonomiesGetIamPolicyCall struct { - s *Service - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataTaxonomiesAttributesDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// GetIamPolicy: Gets the access control policy for a resource. Returns -// an empty policy if the resource exists and does not have a policy -// set. +// Delete: Deletes a Data Attribute resource. // -// - 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 *ProjectsLocationsDataTaxonomiesService) GetIamPolicy(resource string) *ProjectsLocationsDataTaxonomiesGetIamPolicyCall { - c := &ProjectsLocationsDataTaxonomiesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource +// - name: The resource name of the DataAttribute: +// projects/{project_number}/locations/{location_id}/dataTaxonomies/{da +// taTaxonomy}/attributes/{data_attribute_id}. +func (r *ProjectsLocationsDataTaxonomiesAttributesService) Delete(name string) *ProjectsLocationsDataTaxonomiesAttributesDeleteCall { + c := &ProjectsLocationsDataTaxonomiesAttributesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name 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 *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDataTaxonomiesGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) +// Etag sets the optional parameter "etag": If the client provided etag +// value does not match the current etag value, the DeleteDataAttribute +// method returns an ABORTED error response. +func (c *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) Etag(etag string) *ProjectsLocationsDataTaxonomiesAttributesDeleteCall { + c.urlParams_.Set("etag", etag) return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesGetIamPolicyCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesAttributesDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response -// error from Do is the result of In-None-Match. -func (c *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataTaxonomiesGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesGetIamPolicyCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesAttributesDeleteCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } var body io.Reader = nil 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, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, body) + req, err := http.NewRequest("DELETE", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataTaxonomies.getIamPolicy" call. -// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 +// Do executes the "dataplex.projects.locations.dataTaxonomies.attributes.delete" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +func (c *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -11197,7 +12892,7 @@ func (c *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) Do(opts ...googleapi.C 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, @@ -11209,31 +12904,30 @@ func (c *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) Do(opts ...googleapi.C } return ret, nil // { - // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}:getIamPolicy", - // "httpMethod": "GET", - // "id": "dataplex.projects.locations.dataTaxonomies.getIamPolicy", + // "description": "Deletes a Data Attribute resource.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}/attributes/{attributesId}", + // "httpMethod": "DELETE", + // "id": "dataplex.projects.locations.dataTaxonomies.attributes.delete", // "parameterOrder": [ - // "resource" + // "name" // ], // "parameters": { - // "options.requestedPolicyVersion": { - // "description": "Optional. 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).", - // "format": "int32", + // "etag": { + // "description": "Optional. If the client provided etag value does not match the current etag value, the DeleteDataAttribute method returns an ABORTED error response.", // "location": "query", - // "type": "integer" + // "type": "string" // }, - // "resource": { - // "description": "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.", + // "name": { + // "description": "Required. The resource name of the DataAttribute: projects/{project_number}/locations/{location_id}/dataTaxonomies/{dataTaxonomy}/attributes/{data_attribute_id}", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+/attributes/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+resource}:getIamPolicy", + // "path": "v1/{+name}", // "response": { - // "$ref": "GoogleIamV1Policy" + // "$ref": "GoogleLongrunningOperation" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -11242,64 +12936,32 @@ func (c *ProjectsLocationsDataTaxonomiesGetIamPolicyCall) Do(opts ...googleapi.C } -// method id "dataplex.projects.locations.dataTaxonomies.list": +// method id "dataplex.projects.locations.dataTaxonomies.attributes.get": -type ProjectsLocationsDataTaxonomiesListCall struct { +type ProjectsLocationsDataTaxonomiesAttributesGetCall struct { s *Service - parent string + name string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header -} - -// List: Lists DataTaxonomy resources in a project and location. -// -// - parent: The resource name of the DataTaxonomy location, of the -// form: projects/{project_number}/locations/{location_id} where -// location_id refers to a GCP region. -func (r *ProjectsLocationsDataTaxonomiesService) List(parent string) *ProjectsLocationsDataTaxonomiesListCall { - c := &ProjectsLocationsDataTaxonomiesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// Filter sets the optional parameter "filter": Filter request. -func (c *ProjectsLocationsDataTaxonomiesListCall) Filter(filter string) *ProjectsLocationsDataTaxonomiesListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// OrderBy sets the optional parameter "orderBy": Order by fields for -// the result. -func (c *ProjectsLocationsDataTaxonomiesListCall) OrderBy(orderBy string) *ProjectsLocationsDataTaxonomiesListCall { - c.urlParams_.Set("orderBy", orderBy) - return c -} - -// PageSize sets the optional parameter "pageSize": Maximum number of -// DataTaxonomies to return. The service may return fewer than this -// value. If unspecified, at most 10 DataTaxonomies will be returned. -// The maximum value is 1000; values above 1000 will be coerced to 1000. -func (c *ProjectsLocationsDataTaxonomiesListCall) PageSize(pageSize int64) *ProjectsLocationsDataTaxonomiesListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": Page token -// received from a previous ListDataTaxonomies call. Provide this to -// retrieve the subsequent page. When paginating, all other parameters -// provided to ListDataTaxonomies must match the call that provided the -// page token. -func (c *ProjectsLocationsDataTaxonomiesListCall) PageToken(pageToken string) *ProjectsLocationsDataTaxonomiesListCall { - c.urlParams_.Set("pageToken", pageToken) +} + +// Get: Retrieves a Data Attribute resource. +// +// - name: The resource name of the dataAttribute: +// projects/{project_number}/locations/{location_id}/dataTaxonomies/{da +// taTaxonomy}/attributes/{data_attribute_id}. +func (r *ProjectsLocationsDataTaxonomiesAttributesService) Get(name string) *ProjectsLocationsDataTaxonomiesAttributesGetCall { + c := &ProjectsLocationsDataTaxonomiesAttributesGetCall{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 information. -func (c *ProjectsLocationsDataTaxonomiesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesListCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesAttributesGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -11309,7 +12971,7 @@ func (c *ProjectsLocationsDataTaxonomiesListCall) Fields(s ...googleapi.Field) * // getting updates only after the object has changed since the last // request. Use googleapi.IsNotModified to check whether the response // error from Do is the result of In-None-Match. -func (c *ProjectsLocationsDataTaxonomiesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataTaxonomiesListCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataTaxonomiesAttributesGetCall { c.ifNoneMatch_ = entityTag return c } @@ -11317,21 +12979,21 @@ func (c *ProjectsLocationsDataTaxonomiesListCall) IfNoneMatch(entityTag string) // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataTaxonomiesListCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesListCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesAttributesGetCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataTaxonomiesListCall) Header() http.Header { +func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataTaxonomiesListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -11344,7 +13006,7 @@ func (c *ProjectsLocationsDataTaxonomiesListCall) doRequest(alt string) (*http.R var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dataTaxonomies") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -11352,23 +13014,20 @@ func (c *ProjectsLocationsDataTaxonomiesListCall) doRequest(alt string) (*http.R } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataTaxonomies.list" call. -// Exactly one of *GoogleCloudDataplexV1ListDataTaxonomiesResponse or -// error will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleCloudDataplexV1ListDataTaxonomiesResponse.ServerResponse.Header -// -// or (if a response was returned at all) in -// +// Do executes the "dataplex.projects.locations.dataTaxonomies.attributes.get" call. +// Exactly one of *GoogleCloudDataplexV1DataAttribute or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *GoogleCloudDataplexV1DataAttribute.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 *ProjectsLocationsDataTaxonomiesListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1ListDataTaxonomiesResponse, error) { +func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1DataAttribute, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -11387,7 +13046,7 @@ func (c *ProjectsLocationsDataTaxonomiesListCall) Do(opts ...googleapi.CallOptio if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDataplexV1ListDataTaxonomiesResponse{ + ret := &GoogleCloudDataplexV1DataAttribute{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -11399,46 +13058,25 @@ func (c *ProjectsLocationsDataTaxonomiesListCall) Do(opts ...googleapi.CallOptio } return ret, nil // { - // "description": "Lists DataTaxonomy resources in a project and location.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies", + // "description": "Retrieves a Data Attribute resource.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}/attributes/{attributesId}", // "httpMethod": "GET", - // "id": "dataplex.projects.locations.dataTaxonomies.list", + // "id": "dataplex.projects.locations.dataTaxonomies.attributes.get", // "parameterOrder": [ - // "parent" + // "name" // ], // "parameters": { - // "filter": { - // "description": "Optional. Filter request.", - // "location": "query", - // "type": "string" - // }, - // "orderBy": { - // "description": "Optional. Order by fields for the result.", - // "location": "query", - // "type": "string" - // }, - // "pageSize": { - // "description": "Optional. Maximum number of DataTaxonomies to return. The service may return fewer than this value. If unspecified, at most 10 DataTaxonomies 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. Page token received from a previous ListDataTaxonomies call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListDataTaxonomies must match the call that provided the page token.", - // "location": "query", - // "type": "string" - // }, - // "parent": { - // "description": "Required. The resource name of the DataTaxonomy location, of the form: projects/{project_number}/locations/{location_id} where location_id refers to a GCP region.", + // "name": { + // "description": "Required. The resource name of the dataAttribute: projects/{project_number}/locations/{location_id}/dataTaxonomies/{dataTaxonomy}/attributes/{data_attribute_id}", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+/attributes/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+parent}/dataTaxonomies", + // "path": "v1/{+name}", // "response": { - // "$ref": "GoogleCloudDataplexV1ListDataTaxonomiesResponse" + // "$ref": "GoogleCloudDataplexV1DataAttribute" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -11447,127 +13085,118 @@ func (c *ProjectsLocationsDataTaxonomiesListCall) Do(opts ...googleapi.CallOptio } -// 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 *ProjectsLocationsDataTaxonomiesListCall) Pages(ctx context.Context, f func(*GoogleCloudDataplexV1ListDataTaxonomiesResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point - 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) - } -} - -// method id "dataplex.projects.locations.dataTaxonomies.patch": +// method id "dataplex.projects.locations.dataTaxonomies.attributes.getIamPolicy": -type ProjectsLocationsDataTaxonomiesPatchCall struct { - s *Service - name string - googleclouddataplexv1datataxonomy *GoogleCloudDataplexV1DataTaxonomy - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Patch: Updates a DataTaxonomy resource. +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. // -// - name: Output only. The relative resource name of the DataTaxonomy, -// of the form: -// projects/{project_number}/locations/{location_id}/dataTaxonomies/{da -// ta_taxonomy_id}. -func (r *ProjectsLocationsDataTaxonomiesService) Patch(name string, googleclouddataplexv1datataxonomy *GoogleCloudDataplexV1DataTaxonomy) *ProjectsLocationsDataTaxonomiesPatchCall { - c := &ProjectsLocationsDataTaxonomiesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.googleclouddataplexv1datataxonomy = googleclouddataplexv1datataxonomy - return c -} - -// UpdateMask sets the optional parameter "updateMask": Required. Mask -// of fields to update. -func (c *ProjectsLocationsDataTaxonomiesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsDataTaxonomiesPatchCall { - c.urlParams_.Set("updateMask", updateMask) +// - 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 *ProjectsLocationsDataTaxonomiesAttributesService) GetIamPolicy(resource string) *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall { + c := &ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource return c } -// ValidateOnly sets the optional parameter "validateOnly": Only -// validate the request, but do not perform mutations. The default is -// false. -func (c *ProjectsLocationsDataTaxonomiesPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsDataTaxonomiesPatchCall { - c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) +// 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 *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall { + 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 information. -func (c *ProjectsLocationsDataTaxonomiesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesPatchCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataTaxonomiesPatchCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesPatchCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataTaxonomiesPatchCall) Header() http.Header { +func (c *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataTaxonomiesPatchCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1datataxonomy) - if err != nil { - return nil, err + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } - reqHeaders.Set("Content-Type", "application/json") + var body io.Reader = nil 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/{+resource}:getIamPolicy") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataTaxonomies.patch" call. -// Exactly one of *GoogleLongrunningOperation or error will be non-nil. -// 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 +// Do executes the "dataplex.projects.locations.dataTaxonomies.attributes.getIamPolicy" call. +// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *ProjectsLocationsDataTaxonomiesPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -11586,7 +13215,7 @@ func (c *ProjectsLocationsDataTaxonomiesPatchCall) Do(opts ...googleapi.CallOpti 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, @@ -11598,39 +13227,31 @@ func (c *ProjectsLocationsDataTaxonomiesPatchCall) Do(opts ...googleapi.CallOpti } return ret, nil // { - // "description": "Updates a DataTaxonomy resource.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}", - // "httpMethod": "PATCH", - // "id": "dataplex.projects.locations.dataTaxonomies.patch", + // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}/attributes/{attributesId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "dataplex.projects.locations.dataTaxonomies.attributes.getIamPolicy", // "parameterOrder": [ - // "name" + // "resource" // ], // "parameters": { - // "name": { - // "description": "Output only. The relative resource name of the DataTaxonomy, of the form: projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}.", + // "options.requestedPolicyVersion": { + // "description": "Optional. 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).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "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.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+/attributes/[^/]+$", // "required": true, // "type": "string" - // }, - // "updateMask": { - // "description": "Required. Mask of fields to update.", - // "format": "google-fieldmask", - // "location": "query", - // "type": "string" - // }, - // "validateOnly": { - // "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", - // "location": "query", - // "type": "boolean" // } // }, - // "path": "v1/{+name}", - // "request": { - // "$ref": "GoogleCloudDataplexV1DataTaxonomy" - // }, + // "path": "v1/{+resource}:getIamPolicy", // "response": { - // "$ref": "GoogleLongrunningOperation" + // "$ref": "GoogleIamV1Policy" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -11639,93 +13260,133 @@ func (c *ProjectsLocationsDataTaxonomiesPatchCall) Do(opts ...googleapi.CallOpti } -// method id "dataplex.projects.locations.dataTaxonomies.setIamPolicy": +// method id "dataplex.projects.locations.dataTaxonomies.attributes.list": + +type ProjectsLocationsDataTaxonomiesAttributesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists Data Attribute resources in a DataTaxonomy. +// +// - parent: The resource name of the DataTaxonomy: +// projects/{project_number}/locations/{location_id}/dataTaxonomies/{da +// ta_taxonomy_id}. +func (r *ProjectsLocationsDataTaxonomiesAttributesService) List(parent string) *ProjectsLocationsDataTaxonomiesAttributesListCall { + c := &ProjectsLocationsDataTaxonomiesAttributesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Filter request. +func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) Filter(filter string) *ProjectsLocationsDataTaxonomiesAttributesListCall { + c.urlParams_.Set("filter", filter) + return c +} -type ProjectsLocationsDataTaxonomiesSetIamPolicyCall struct { - s *Service - resource string - googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +// OrderBy sets the optional parameter "orderBy": Order by fields for +// the result. +func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) OrderBy(orderBy string) *ProjectsLocationsDataTaxonomiesAttributesListCall { + c.urlParams_.Set("orderBy", orderBy) + return c } -// SetIamPolicy: Sets the access control policy on the specified -// resource. Replaces any existing policy.Can return NOT_FOUND, -// INVALID_ARGUMENT, and PERMISSION_DENIED errors. -// -// - 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 *ProjectsLocationsDataTaxonomiesService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsDataTaxonomiesSetIamPolicyCall { - c := &ProjectsLocationsDataTaxonomiesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest +// PageSize sets the optional parameter "pageSize": Maximum number of +// DataAttributes to return. The service may return fewer than this +// value. If unspecified, at most 10 dataAttributes will be returned. +// The maximum value is 1000; values above 1000 will be coerced to 1000. +func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) PageSize(pageSize int64) *ProjectsLocationsDataTaxonomiesAttributesListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Page token +// received from a previous ListDataAttributes call. Provide this to +// retrieve the subsequent page. When paginating, all other parameters +// provided to ListDataAttributes must match the call that provided the +// page token. +func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) PageToken(pageToken string) *ProjectsLocationsDataTaxonomiesAttributesListCall { + 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 information. -func (c *ProjectsLocationsDataTaxonomiesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesSetIamPolicyCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesAttributesListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataTaxonomiesAttributesListCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataTaxonomiesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesSetIamPolicyCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesAttributesListCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataTaxonomiesSetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataTaxonomiesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1setiampolicyrequest) - if err != nil { - return nil, err + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } - reqHeaders.Set("Content-Type", "application/json") + var body io.Reader = nil 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/{+parent}/attributes") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataTaxonomies.setIamPolicy" call. -// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *ProjectsLocationsDataTaxonomiesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +// Do executes the "dataplex.projects.locations.dataTaxonomies.attributes.list" call. +// Exactly one of *GoogleCloudDataplexV1ListDataAttributesResponse or +// error will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleCloudDataplexV1ListDataAttributesResponse.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 *ProjectsLocationsDataTaxonomiesAttributesListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1ListDataAttributesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -11744,7 +13405,7 @@ func (c *ProjectsLocationsDataTaxonomiesSetIamPolicyCall) Do(opts ...googleapi.C if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleIamV1Policy{ + ret := &GoogleCloudDataplexV1ListDataAttributesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -11756,28 +13417,46 @@ func (c *ProjectsLocationsDataTaxonomiesSetIamPolicyCall) Do(opts ...googleapi.C } return ret, nil // { - // "description": "Sets the access control policy on the specified resource. Replaces any existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}:setIamPolicy", - // "httpMethod": "POST", - // "id": "dataplex.projects.locations.dataTaxonomies.setIamPolicy", + // "description": "Lists Data Attribute resources in a DataTaxonomy.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}/attributes", + // "httpMethod": "GET", + // "id": "dataplex.projects.locations.dataTaxonomies.attributes.list", // "parameterOrder": [ - // "resource" + // "parent" // ], // "parameters": { - // "resource": { - // "description": "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.", + // "filter": { + // "description": "Optional. Filter request.", + // "location": "query", + // "type": "string" + // }, + // "orderBy": { + // "description": "Optional. Order by fields for the result.", + // "location": "query", + // "type": "string" + // }, + // "pageSize": { + // "description": "Optional. Maximum number of DataAttributes to return. The service may return fewer than this value. If unspecified, at most 10 dataAttributes 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. Page token received from a previous ListDataAttributes call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListDataAttributes must match the call that provided the page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The resource name of the DataTaxonomy: projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+resource}:setIamPolicy", - // "request": { - // "$ref": "GoogleIamV1SetIamPolicyRequest" - // }, + // "path": "v1/{+parent}/attributes", // "response": { - // "$ref": "GoogleIamV1Policy" + // "$ref": "GoogleCloudDataplexV1ListDataAttributesResponse" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -11786,39 +13465,70 @@ func (c *ProjectsLocationsDataTaxonomiesSetIamPolicyCall) Do(opts ...googleapi.C } -// method id "dataplex.projects.locations.dataTaxonomies.testIamPermissions": +// 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 *ProjectsLocationsDataTaxonomiesAttributesListCall) Pages(ctx context.Context, f func(*GoogleCloudDataplexV1ListDataAttributesResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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 ProjectsLocationsDataTaxonomiesTestIamPermissionsCall struct { - s *Service - resource string - googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +// method id "dataplex.projects.locations.dataTaxonomies.attributes.patch": + +type ProjectsLocationsDataTaxonomiesAttributesPatchCall struct { + s *Service + name string + googleclouddataplexv1dataattribute *GoogleCloudDataplexV1DataAttribute + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// TestIamPermissions: Returns permissions that a caller has on the -// specified resource. If the resource does not exist, this will return -// an empty set of permissions, not a NOT_FOUND error.Note: This -// operation is designed to be used for building permission-aware UIs -// and command-line tools, not for authorization checking. This -// operation may "fail open" without warning. +// Patch: Updates a DataAttribute resource. // -// - resource: REQUIRED: The resource for which the policy detail is -// being requested. See Resource names -// (https://cloud.google.com/apis/design/resource_names) for the -// appropriate value for this field. -func (r *ProjectsLocationsDataTaxonomiesService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall { - c := &ProjectsLocationsDataTaxonomiesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest +// - name: Output only. The relative resource name of the dataAttribute, +// of the form: +// projects/{project_number}/locations/{location_id}/dataTaxonomies/{da +// taTaxonomy}/attributes/{data_attribute_id}. +func (r *ProjectsLocationsDataTaxonomiesAttributesService) Patch(name string, googleclouddataplexv1dataattribute *GoogleCloudDataplexV1DataAttribute) *ProjectsLocationsDataTaxonomiesAttributesPatchCall { + c := &ProjectsLocationsDataTaxonomiesAttributesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleclouddataplexv1dataattribute = googleclouddataplexv1dataattribute + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Mask +// of fields to update. +func (c *ProjectsLocationsDataTaxonomiesAttributesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsDataTaxonomiesAttributesPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Only +// validate the request, but do not perform mutations. The default is +// false. +func (c *ProjectsLocationsDataTaxonomiesAttributesPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsDataTaxonomiesAttributesPatchCall { + 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 information. -func (c *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesAttributesPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -11826,21 +13536,21 @@ func (c *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall) Fields(s ...goog // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesPatchCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesAttributesPatchCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall) Header() http.Header { +func (c *ProjectsLocationsDataTaxonomiesAttributesPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataTaxonomiesAttributesPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -11848,35 +13558,34 @@ func (c *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall) doRequest(alt st } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1testiampermissionsrequest) + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1dataattribute) if err != nil { return nil, err } reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") + 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{ - "resource": c.resource, + "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "dataplex.projects.locations.dataTaxonomies.testIamPermissions" call. -// Exactly one of *GoogleIamV1TestIamPermissionsResponse or error will -// be non-nil. Any non-2xx status code is an error. Response headers are -// in either -// *GoogleIamV1TestIamPermissionsResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +} + +// Do executes the "dataplex.projects.locations.dataTaxonomies.attributes.patch" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { +func (c *ProjectsLocationsDataTaxonomiesAttributesPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -11895,7 +13604,7 @@ func (c *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall) Do(opts ...googl if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleIamV1TestIamPermissionsResponse{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -11907,28 +13616,39 @@ func (c *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall) Do(opts ...googl } return ret, nil // { - // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND error.Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}:testIamPermissions", - // "httpMethod": "POST", - // "id": "dataplex.projects.locations.dataTaxonomies.testIamPermissions", + // "description": "Updates a DataAttribute resource.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}/attributes/{attributesId}", + // "httpMethod": "PATCH", + // "id": "dataplex.projects.locations.dataTaxonomies.attributes.patch", // "parameterOrder": [ - // "resource" + // "name" // ], // "parameters": { - // "resource": { - // "description": "REQUIRED: The resource for which the policy detail is being requested. See Resource names (https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + // "name": { + // "description": "Output only. The relative resource name of the dataAttribute, of the form: projects/{project_number}/locations/{location_id}/dataTaxonomies/{dataTaxonomy}/attributes/{data_attribute_id}.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+/attributes/[^/]+$", // "required": true, // "type": "string" + // }, + // "updateMask": { + // "description": "Required. Mask of fields to update.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // }, + // "validateOnly": { + // "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", + // "location": "query", + // "type": "boolean" // } // }, - // "path": "v1/{+resource}:testIamPermissions", + // "path": "v1/{+name}", // "request": { - // "$ref": "GoogleIamV1TestIamPermissionsRequest" + // "$ref": "GoogleCloudDataplexV1DataAttribute" // }, // "response": { - // "$ref": "GoogleIamV1TestIamPermissionsResponse" + // "$ref": "GoogleLongrunningOperation" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -11937,51 +13657,36 @@ func (c *ProjectsLocationsDataTaxonomiesTestIamPermissionsCall) Do(opts ...googl } -// method id "dataplex.projects.locations.dataTaxonomies.attributes.create": +// method id "dataplex.projects.locations.dataTaxonomies.attributes.setIamPolicy": -type ProjectsLocationsDataTaxonomiesAttributesCreateCall struct { - s *Service - parent string - googleclouddataplexv1dataattribute *GoogleCloudDataplexV1DataAttribute - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall struct { + s *Service + resource string + googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Create: Create a DataAttribute resource. +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy.Can return NOT_FOUND, +// INVALID_ARGUMENT, and PERMISSION_DENIED errors. // -// - parent: The resource name of the parent data taxonomy -// projects/{project_number}/locations/{location_id}/dataTaxonomies/{da -// ta_taxonomy_id}. -func (r *ProjectsLocationsDataTaxonomiesAttributesService) Create(parent string, googleclouddataplexv1dataattribute *GoogleCloudDataplexV1DataAttribute) *ProjectsLocationsDataTaxonomiesAttributesCreateCall { - c := &ProjectsLocationsDataTaxonomiesAttributesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.googleclouddataplexv1dataattribute = googleclouddataplexv1dataattribute - return c -} - -// DataAttributeId sets the optional parameter "dataAttributeId": -// Required. DataAttribute identifier. * Must contain only lowercase -// letters, numbers and hyphens. * Must start with a letter. * Must be -// between 1-63 characters. * Must end with a number or a letter. * Must -// be unique within the DataTaxonomy. -func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) DataAttributeId(dataAttributeId string) *ProjectsLocationsDataTaxonomiesAttributesCreateCall { - c.urlParams_.Set("dataAttributeId", dataAttributeId) - return c -} - -// ValidateOnly sets the optional parameter "validateOnly": Only -// validate the request, but do not perform mutations. The default is -// false. -func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsDataTaxonomiesAttributesCreateCall { - c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) +// - 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 *ProjectsLocationsDataTaxonomiesAttributesService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall { + c := &ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall{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 information. -func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesAttributesCreateCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -11989,21 +13694,21 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) Fields(s ...google // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesAttributesCreateCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) Header() http.Header { +func (c *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -12011,14 +13716,14 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) doRequest(alt stri } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1dataattribute) + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1setiampolicyrequest) if err != nil { return nil, err } reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/attributes") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -12026,19 +13731,19 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) doRequest(alt stri } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataTaxonomies.attributes.create" call. -// Exactly one of *GoogleLongrunningOperation or error will be non-nil. -// 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 +// Do executes the "dataplex.projects.locations.dataTaxonomies.attributes.setIamPolicy" call. +// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *ProjectsLocationsDataTaxonomiesAttributesCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -12057,7 +13762,7 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) Do(opts ...googlea 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, @@ -12069,38 +13774,28 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) Do(opts ...googlea } return ret, nil // { - // "description": "Create a DataAttribute resource.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}/attributes", + // "description": "Sets the access control policy on the specified resource. Replaces any existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}/attributes/{attributesId}:setIamPolicy", // "httpMethod": "POST", - // "id": "dataplex.projects.locations.dataTaxonomies.attributes.create", + // "id": "dataplex.projects.locations.dataTaxonomies.attributes.setIamPolicy", // "parameterOrder": [ - // "parent" + // "resource" // ], // "parameters": { - // "dataAttributeId": { - // "description": "Required. DataAttribute identifier. * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the DataTaxonomy.", - // "location": "query", - // "type": "string" - // }, - // "parent": { - // "description": "Required. The resource name of the parent data taxonomy projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}", + // "resource": { + // "description": "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.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+/attributes/[^/]+$", // "required": true, // "type": "string" - // }, - // "validateOnly": { - // "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", - // "location": "query", - // "type": "boolean" // } // }, - // "path": "v1/{+parent}/attributes", + // "path": "v1/{+resource}:setIamPolicy", // "request": { - // "$ref": "GoogleCloudDataplexV1DataAttribute" + // "$ref": "GoogleIamV1SetIamPolicyRequest" // }, // "response": { - // "$ref": "GoogleLongrunningOperation" + // "$ref": "GoogleIamV1Policy" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -12109,39 +13804,39 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesCreateCall) Do(opts ...googlea } -// method id "dataplex.projects.locations.dataTaxonomies.attributes.delete": +// method id "dataplex.projects.locations.dataTaxonomies.attributes.testIamPermissions": -type ProjectsLocationsDataTaxonomiesAttributesDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall struct { + s *Service + resource string + googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Delete: Deletes a Data Attribute resource. +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a NOT_FOUND error.Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. // -// - name: The resource name of the DataAttribute: -// projects/{project_number}/locations/{location_id}/dataTaxonomies/{da -// taTaxonomy}/attributes/{data_attribute_id}. -func (r *ProjectsLocationsDataTaxonomiesAttributesService) Delete(name string) *ProjectsLocationsDataTaxonomiesAttributesDeleteCall { - c := &ProjectsLocationsDataTaxonomiesAttributesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Etag sets the optional parameter "etag": If the client provided etag -// value does not match the current etag value, the DeleteDataAttribute -// method returns an ABORTED error response. -func (c *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) Etag(etag string) *ProjectsLocationsDataTaxonomiesAttributesDeleteCall { - c.urlParams_.Set("etag", etag) +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. +func (r *ProjectsLocationsDataTaxonomiesAttributesService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall { + c := &ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesAttributesDeleteCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -12149,21 +13844,21 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) Fields(s ...google // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesAttributesDeleteCall { +func (c *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) Header() http.Header { +func (c *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -12171,29 +13866,35 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) doRequest(alt stri } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") 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/{+resource}:testIamPermissions") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", 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, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataTaxonomies.attributes.delete" call. -// Exactly one of *GoogleLongrunningOperation or error will be non-nil. -// 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 +// Do executes the "dataplex.projects.locations.dataTaxonomies.attributes.testIamPermissions" call. +// Exactly one of *GoogleIamV1TestIamPermissionsResponse or error will +// be non-nil. Any non-2xx status code is an error. Response headers are +// in either +// *GoogleIamV1TestIamPermissionsResponse.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 *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -12212,7 +13913,7 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) Do(opts ...googlea if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleIamV1TestIamPermissionsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -12224,30 +13925,28 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) Do(opts ...googlea } return ret, nil // { - // "description": "Deletes a Data Attribute resource.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}/attributes/{attributesId}", - // "httpMethod": "DELETE", - // "id": "dataplex.projects.locations.dataTaxonomies.attributes.delete", + // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND error.Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}/attributes/{attributesId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "dataplex.projects.locations.dataTaxonomies.attributes.testIamPermissions", // "parameterOrder": [ - // "name" + // "resource" // ], // "parameters": { - // "etag": { - // "description": "Optional. If the client provided etag value does not match the current etag value, the DeleteDataAttribute method returns an ABORTED error response.", - // "location": "query", - // "type": "string" - // }, - // "name": { - // "description": "Required. The resource name of the DataAttribute: projects/{project_number}/locations/{location_id}/dataTaxonomies/{dataTaxonomy}/attributes/{data_attribute_id}", + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See Resource names (https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+/attributes/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+name}", + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "GoogleIamV1TestIamPermissionsRequest" + // }, // "response": { - // "$ref": "GoogleLongrunningOperation" + // "$ref": "GoogleIamV1TestIamPermissionsResponse" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -12256,32 +13955,53 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesDeleteCall) Do(opts ...googlea } -// method id "dataplex.projects.locations.dataTaxonomies.attributes.get": +// method id "dataplex.projects.locations.entryGroups.getIamPolicy": -type ProjectsLocationsDataTaxonomiesAttributesGetCall struct { +type ProjectsLocationsEntryGroupsGetIamPolicyCall struct { s *Service - name string + resource string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// Get: Retrieves a Data Attribute resource. +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. // -// - name: The resource name of the dataAttribute: -// projects/{project_number}/locations/{location_id}/dataTaxonomies/{da -// taTaxonomy}/attributes/{data_attribute_id}. -func (r *ProjectsLocationsDataTaxonomiesAttributesService) Get(name string) *ProjectsLocationsDataTaxonomiesAttributesGetCall { - c := &ProjectsLocationsDataTaxonomiesAttributesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - 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 *ProjectsLocationsEntryGroupsService) GetIamPolicy(resource string) *ProjectsLocationsEntryGroupsGetIamPolicyCall { + c := &ProjectsLocationsEntryGroupsGetIamPolicyCall{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 *ProjectsLocationsEntryGroupsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsEntryGroupsGetIamPolicyCall { + 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 information. -func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesAttributesGetCall { +func (c *ProjectsLocationsEntryGroupsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsEntryGroupsGetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -12291,7 +14011,7 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) Fields(s ...googleapi // getting updates only after the object has changed since the last // request. Use googleapi.IsNotModified to check whether the response // error from Do is the result of In-None-Match. -func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataTaxonomiesAttributesGetCall { +func (c *ProjectsLocationsEntryGroupsGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsEntryGroupsGetIamPolicyCall { c.ifNoneMatch_ = entityTag return c } @@ -12299,21 +14019,21 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) IfNoneMatch(entityTag // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesAttributesGetCall { +func (c *ProjectsLocationsEntryGroupsGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsEntryGroupsGetIamPolicyCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) Header() http.Header { +func (c *ProjectsLocationsEntryGroupsGetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsEntryGroupsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -12326,7 +14046,7 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) doRequest(alt string) var body io.Reader = nil 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/{+resource}:getIamPolicy") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -12334,20 +14054,19 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) doRequest(alt string) } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataTaxonomies.attributes.get" call. -// Exactly one of *GoogleCloudDataplexV1DataAttribute or error will be -// non-nil. Any non-2xx status code is an error. Response headers are in -// either *GoogleCloudDataplexV1DataAttribute.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 *ProjectsLocationsDataTaxonomiesAttributesGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1DataAttribute, error) { +// Do executes the "dataplex.projects.locations.entryGroups.getIamPolicy" call. +// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *ProjectsLocationsEntryGroupsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -12366,7 +14085,7 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) Do(opts ...googleapi. if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDataplexV1DataAttribute{ + ret := &GoogleIamV1Policy{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -12378,25 +14097,31 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) Do(opts ...googleapi. } return ret, nil // { - // "description": "Retrieves a Data Attribute resource.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}/attributes/{attributesId}", + // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}:getIamPolicy", // "httpMethod": "GET", - // "id": "dataplex.projects.locations.dataTaxonomies.attributes.get", + // "id": "dataplex.projects.locations.entryGroups.getIamPolicy", // "parameterOrder": [ - // "name" + // "resource" // ], // "parameters": { - // "name": { - // "description": "Required. The resource name of the dataAttribute: projects/{project_number}/locations/{location_id}/dataTaxonomies/{dataTaxonomy}/attributes/{data_attribute_id}", + // "options.requestedPolicyVersion": { + // "description": "Optional. 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).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "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.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+/attributes/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/entryGroups/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+name}", + // "path": "v1/{+resource}:getIamPolicy", // "response": { - // "$ref": "GoogleCloudDataplexV1DataAttribute" + // "$ref": "GoogleIamV1Policy" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -12405,100 +14130,75 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesGetCall) Do(opts ...googleapi. } -// method id "dataplex.projects.locations.dataTaxonomies.attributes.getIamPolicy": +// method id "dataplex.projects.locations.entryGroups.setIamPolicy": -type ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall struct { - s *Service - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsEntryGroupsSetIamPolicyCall struct { + s *Service + resource string + googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// GetIamPolicy: Gets the access control policy for a resource. Returns -// an empty policy if the resource exists and does not have a policy -// set. +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy.Can return NOT_FOUND, +// INVALID_ARGUMENT, and PERMISSION_DENIED errors. // // - resource: REQUIRED: The resource for which the policy is being -// requested. See Resource names +// specified. See Resource names // (https://cloud.google.com/apis/design/resource_names) for the // appropriate value for this field. -func (r *ProjectsLocationsDataTaxonomiesAttributesService) GetIamPolicy(resource string) *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall { - c := &ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsEntryGroupsService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsEntryGroupsSetIamPolicyCall { + c := &ProjectsLocationsEntryGroupsSetIamPolicyCall{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 *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + 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 information. -func (c *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall { +func (c *ProjectsLocationsEntryGroupsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsEntryGroupsSetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response -// error from Do is the result of In-None-Match. -func (c *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall { +func (c *ProjectsLocationsEntryGroupsSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsEntryGroupsSetIamPolicyCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsEntryGroupsSetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsEntryGroupsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") 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, "v1/{+resource}:setIamPolicy") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, body) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } @@ -12509,14 +14209,14 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) doRequest(al return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataTaxonomies.attributes.getIamPolicy" call. +// Do executes the "dataplex.projects.locations.entryGroups.setIamPolicy" call. // Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +func (c *ProjectsLocationsEntryGroupsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -12547,29 +14247,26 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) Do(opts ...g } return ret, nil // { - // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}/attributes/{attributesId}:getIamPolicy", - // "httpMethod": "GET", - // "id": "dataplex.projects.locations.dataTaxonomies.attributes.getIamPolicy", + // "description": "Sets the access control policy on the specified resource. Replaces any existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "dataplex.projects.locations.entryGroups.setIamPolicy", // "parameterOrder": [ // "resource" // ], // "parameters": { - // "options.requestedPolicyVersion": { - // "description": "Optional. 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).", - // "format": "int32", - // "location": "query", - // "type": "integer" - // }, // "resource": { - // "description": "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.", + // "description": "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.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+/attributes/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/entryGroups/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+resource}:getIamPolicy", + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "GoogleIamV1SetIamPolicyRequest" + // }, // "response": { // "$ref": "GoogleIamV1Policy" // }, @@ -12580,133 +14277,97 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesGetIamPolicyCall) Do(opts ...g } -// method id "dataplex.projects.locations.dataTaxonomies.attributes.list": +// method id "dataplex.projects.locations.entryGroups.testIamPermissions": -type ProjectsLocationsDataTaxonomiesAttributesListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsEntryGroupsTestIamPermissionsCall struct { + s *Service + resource string + googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// List: Lists Data Attribute resources in a DataTaxonomy. +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a NOT_FOUND error.Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. // -// - parent: The resource name of the DataTaxonomy: -// projects/{project_number}/locations/{location_id}/dataTaxonomies/{da -// ta_taxonomy_id}. -func (r *ProjectsLocationsDataTaxonomiesAttributesService) List(parent string) *ProjectsLocationsDataTaxonomiesAttributesListCall { - c := &ProjectsLocationsDataTaxonomiesAttributesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// Filter sets the optional parameter "filter": Filter request. -func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) Filter(filter string) *ProjectsLocationsDataTaxonomiesAttributesListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// OrderBy sets the optional parameter "orderBy": Order by fields for -// the result. -func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) OrderBy(orderBy string) *ProjectsLocationsDataTaxonomiesAttributesListCall { - c.urlParams_.Set("orderBy", orderBy) - return c -} - -// PageSize sets the optional parameter "pageSize": Maximum number of -// DataAttributes to return. The service may return fewer than this -// value. If unspecified, at most 10 dataAttributes will be returned. -// The maximum value is 1000; values above 1000 will be coerced to 1000. -func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) PageSize(pageSize int64) *ProjectsLocationsDataTaxonomiesAttributesListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": Page token -// received from a previous ListDataAttributes call. Provide this to -// retrieve the subsequent page. When paginating, all other parameters -// provided to ListDataAttributes must match the call that provided the -// page token. -func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) PageToken(pageToken string) *ProjectsLocationsDataTaxonomiesAttributesListCall { - c.urlParams_.Set("pageToken", pageToken) +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. +func (r *ProjectsLocationsEntryGroupsService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsEntryGroupsTestIamPermissionsCall { + c := &ProjectsLocationsEntryGroupsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesAttributesListCall { +func (c *ProjectsLocationsEntryGroupsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsEntryGroupsTestIamPermissionsCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response -// error from Do is the result of In-None-Match. -func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataTaxonomiesAttributesListCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesAttributesListCall { +func (c *ProjectsLocationsEntryGroupsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsEntryGroupsTestIamPermissionsCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) Header() http.Header { +func (c *ProjectsLocationsEntryGroupsTestIamPermissionsCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsEntryGroupsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/attributes") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", 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{ - "parent": c.parent, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataTaxonomies.attributes.list" call. -// Exactly one of *GoogleCloudDataplexV1ListDataAttributesResponse or -// error will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleCloudDataplexV1ListDataAttributesResponse.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 *ProjectsLocationsDataTaxonomiesAttributesListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataplexV1ListDataAttributesResponse, error) { +// Do executes the "dataplex.projects.locations.entryGroups.testIamPermissions" call. +// Exactly one of *GoogleIamV1TestIamPermissionsResponse or error will +// be non-nil. Any non-2xx status code is an error. Response headers are +// in either +// *GoogleIamV1TestIamPermissionsResponse.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 *ProjectsLocationsEntryGroupsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -12725,7 +14386,7 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) Do(opts ...googleapi if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDataplexV1ListDataAttributesResponse{ + ret := &GoogleIamV1TestIamPermissionsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -12737,46 +14398,28 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) Do(opts ...googleapi } return ret, nil // { - // "description": "Lists Data Attribute resources in a DataTaxonomy.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}/attributes", - // "httpMethod": "GET", - // "id": "dataplex.projects.locations.dataTaxonomies.attributes.list", + // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND error.Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "dataplex.projects.locations.entryGroups.testIamPermissions", // "parameterOrder": [ - // "parent" + // "resource" // ], // "parameters": { - // "filter": { - // "description": "Optional. Filter request.", - // "location": "query", - // "type": "string" - // }, - // "orderBy": { - // "description": "Optional. Order by fields for the result.", - // "location": "query", - // "type": "string" - // }, - // "pageSize": { - // "description": "Optional. Maximum number of DataAttributes to return. The service may return fewer than this value. If unspecified, at most 10 dataAttributes 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. Page token received from a previous ListDataAttributes call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListDataAttributes must match the call that provided the page token.", - // "location": "query", - // "type": "string" - // }, - // "parent": { - // "description": "Required. The resource name of the DataTaxonomy: projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}", + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See Resource names (https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/entryGroups/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+parent}/attributes", + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "GoogleIamV1TestIamPermissionsRequest" + // }, // "response": { - // "$ref": "GoogleCloudDataplexV1ListDataAttributesResponse" + // "$ref": "GoogleIamV1TestIamPermissionsResponse" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -12785,127 +14428,118 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesListCall) Do(opts ...googleapi } -// 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 *ProjectsLocationsDataTaxonomiesAttributesListCall) Pages(ctx context.Context, f func(*GoogleCloudDataplexV1ListDataAttributesResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point - 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) - } -} - -// method id "dataplex.projects.locations.dataTaxonomies.attributes.patch": +// method id "dataplex.projects.locations.entryTypes.getIamPolicy": -type ProjectsLocationsDataTaxonomiesAttributesPatchCall struct { - s *Service - name string - googleclouddataplexv1dataattribute *GoogleCloudDataplexV1DataAttribute - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsEntryTypesGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Patch: Updates a DataAttribute resource. +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. // -// - name: Output only. The relative resource name of the dataAttribute, -// of the form: -// projects/{project_number}/locations/{location_id}/dataTaxonomies/{da -// taTaxonomy}/attributes/{data_attribute_id}. -func (r *ProjectsLocationsDataTaxonomiesAttributesService) Patch(name string, googleclouddataplexv1dataattribute *GoogleCloudDataplexV1DataAttribute) *ProjectsLocationsDataTaxonomiesAttributesPatchCall { - c := &ProjectsLocationsDataTaxonomiesAttributesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.googleclouddataplexv1dataattribute = googleclouddataplexv1dataattribute - return c -} - -// UpdateMask sets the optional parameter "updateMask": Required. Mask -// of fields to update. -func (c *ProjectsLocationsDataTaxonomiesAttributesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsDataTaxonomiesAttributesPatchCall { - c.urlParams_.Set("updateMask", updateMask) +// - 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 *ProjectsLocationsEntryTypesService) GetIamPolicy(resource string) *ProjectsLocationsEntryTypesGetIamPolicyCall { + c := &ProjectsLocationsEntryTypesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource return c } -// ValidateOnly sets the optional parameter "validateOnly": Only -// validate the request, but do not perform mutations. The default is -// false. -func (c *ProjectsLocationsDataTaxonomiesAttributesPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsDataTaxonomiesAttributesPatchCall { - c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) +// 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 *ProjectsLocationsEntryTypesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsEntryTypesGetIamPolicyCall { + 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 information. -func (c *ProjectsLocationsDataTaxonomiesAttributesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesAttributesPatchCall { +func (c *ProjectsLocationsEntryTypesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsEntryTypesGetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsEntryTypesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsEntryTypesGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataTaxonomiesAttributesPatchCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesAttributesPatchCall { +func (c *ProjectsLocationsEntryTypesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsEntryTypesGetIamPolicyCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataTaxonomiesAttributesPatchCall) Header() http.Header { +func (c *ProjectsLocationsEntryTypesGetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataTaxonomiesAttributesPatchCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsEntryTypesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddataplexv1dataattribute) - if err != nil { - return nil, err + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } - reqHeaders.Set("Content-Type", "application/json") + var body io.Reader = nil 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/{+resource}:getIamPolicy") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataTaxonomies.attributes.patch" call. -// Exactly one of *GoogleLongrunningOperation or error will be non-nil. -// 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 +// Do executes the "dataplex.projects.locations.entryTypes.getIamPolicy" call. +// Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *ProjectsLocationsDataTaxonomiesAttributesPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsEntryTypesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -12924,7 +14558,7 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesPatchCall) Do(opts ...googleap 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, @@ -12936,39 +14570,31 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesPatchCall) Do(opts ...googleap } return ret, nil // { - // "description": "Updates a DataAttribute resource.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}/attributes/{attributesId}", - // "httpMethod": "PATCH", - // "id": "dataplex.projects.locations.dataTaxonomies.attributes.patch", + // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryTypes/{entryTypesId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "dataplex.projects.locations.entryTypes.getIamPolicy", // "parameterOrder": [ - // "name" + // "resource" // ], // "parameters": { - // "name": { - // "description": "Output only. The relative resource name of the dataAttribute, of the form: projects/{project_number}/locations/{location_id}/dataTaxonomies/{dataTaxonomy}/attributes/{data_attribute_id}.", + // "options.requestedPolicyVersion": { + // "description": "Optional. 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).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "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.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+/attributes/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/entryTypes/[^/]+$", // "required": true, // "type": "string" - // }, - // "updateMask": { - // "description": "Required. Mask of fields to update.", - // "format": "google-fieldmask", - // "location": "query", - // "type": "string" - // }, - // "validateOnly": { - // "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", - // "location": "query", - // "type": "boolean" // } // }, - // "path": "v1/{+name}", - // "request": { - // "$ref": "GoogleCloudDataplexV1DataAttribute" - // }, + // "path": "v1/{+resource}:getIamPolicy", // "response": { - // "$ref": "GoogleLongrunningOperation" + // "$ref": "GoogleIamV1Policy" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -12977,9 +14603,9 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesPatchCall) Do(opts ...googleap } -// method id "dataplex.projects.locations.dataTaxonomies.attributes.setIamPolicy": +// method id "dataplex.projects.locations.entryTypes.setIamPolicy": -type ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall struct { +type ProjectsLocationsEntryTypesSetIamPolicyCall struct { s *Service resource string googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest @@ -12996,8 +14622,8 @@ type ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall struct { // specified. See Resource names // (https://cloud.google.com/apis/design/resource_names) for the // appropriate value for this field. -func (r *ProjectsLocationsDataTaxonomiesAttributesService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall { - c := &ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsEntryTypesService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsEntryTypesSetIamPolicyCall { + c := &ProjectsLocationsEntryTypesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest return c @@ -13006,7 +14632,7 @@ func (r *ProjectsLocationsDataTaxonomiesAttributesService) SetIamPolicy(resource // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall { +func (c *ProjectsLocationsEntryTypesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsEntryTypesSetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -13014,21 +14640,21 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall) Fields(s ... // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall { +func (c *ProjectsLocationsEntryTypesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsEntryTypesSetIamPolicyCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsEntryTypesSetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsEntryTypesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -13056,14 +14682,14 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall) doRequest(al return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataTaxonomies.attributes.setIamPolicy" call. +// Do executes the "dataplex.projects.locations.entryTypes.setIamPolicy" call. // Exactly one of *GoogleIamV1Policy or error will be non-nil. 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 *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +func (c *ProjectsLocationsEntryTypesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -13095,9 +14721,9 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall) Do(opts ...g return ret, nil // { // "description": "Sets the access control policy on the specified resource. Replaces any existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}/attributes/{attributesId}:setIamPolicy", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryTypes/{entryTypesId}:setIamPolicy", // "httpMethod": "POST", - // "id": "dataplex.projects.locations.dataTaxonomies.attributes.setIamPolicy", + // "id": "dataplex.projects.locations.entryTypes.setIamPolicy", // "parameterOrder": [ // "resource" // ], @@ -13105,7 +14731,7 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall) Do(opts ...g // "resource": { // "description": "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.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+/attributes/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/entryTypes/[^/]+$", // "required": true, // "type": "string" // } @@ -13124,9 +14750,9 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesSetIamPolicyCall) Do(opts ...g } -// method id "dataplex.projects.locations.dataTaxonomies.attributes.testIamPermissions": +// method id "dataplex.projects.locations.entryTypes.testIamPermissions": -type ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall struct { +type ProjectsLocationsEntryTypesTestIamPermissionsCall struct { s *Service resource string googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest @@ -13146,8 +14772,8 @@ type ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall struct { // being requested. See Resource names // (https://cloud.google.com/apis/design/resource_names) for the // appropriate value for this field. -func (r *ProjectsLocationsDataTaxonomiesAttributesService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall { - c := &ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsEntryTypesService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsEntryTypesTestIamPermissionsCall { + c := &ProjectsLocationsEntryTypesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest return c @@ -13156,7 +14782,7 @@ func (r *ProjectsLocationsDataTaxonomiesAttributesService) TestIamPermissions(re // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall { +func (c *ProjectsLocationsEntryTypesTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsEntryTypesTestIamPermissionsCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -13164,21 +14790,21 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall) Fields // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall { +func (c *ProjectsLocationsEntryTypesTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsEntryTypesTestIamPermissionsCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall) Header() http.Header { +func (c *ProjectsLocationsEntryTypesTestIamPermissionsCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsEntryTypesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -13206,7 +14832,7 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall) doRequ return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataplex.projects.locations.dataTaxonomies.attributes.testIamPermissions" call. +// Do executes the "dataplex.projects.locations.entryTypes.testIamPermissions" call. // Exactly one of *GoogleIamV1TestIamPermissionsResponse or error will // be non-nil. Any non-2xx status code is an error. Response headers are // in either @@ -13214,7 +14840,7 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall) doRequ // 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 *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { +func (c *ProjectsLocationsEntryTypesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -13246,9 +14872,9 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall) Do(opt return ret, nil // { // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND error.Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataTaxonomies/{dataTaxonomiesId}/attributes/{attributesId}:testIamPermissions", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryTypes/{entryTypesId}:testIamPermissions", // "httpMethod": "POST", - // "id": "dataplex.projects.locations.dataTaxonomies.attributes.testIamPermissions", + // "id": "dataplex.projects.locations.entryTypes.testIamPermissions", // "parameterOrder": [ // "resource" // ], @@ -13256,7 +14882,7 @@ func (c *ProjectsLocationsDataTaxonomiesAttributesTestIamPermissionsCall) Do(opt // "resource": { // "description": "REQUIRED: The resource for which the policy detail is being requested. See Resource names (https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/dataTaxonomies/[^/]+/attributes/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/entryTypes/[^/]+$", // "required": true, // "type": "string" // } diff --git a/dataproc/v1/dataproc-api.json b/dataproc/v1/dataproc-api.json index 9a38505bd07..484e146e626 100644 --- a/dataproc/v1/dataproc-api.json +++ b/dataproc/v1/dataproc-api.json @@ -2671,7 +2671,7 @@ } } }, - "revision": "20230410", + "revision": "20230427", "rootUrl": "https://dataproc.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -4689,7 +4689,7 @@ ], "type": "string" }, - "description": "The per-package log levels for the driver. This may include \"root\" package name to configure rootLogger. Examples: 'com.google = FATAL', 'root = INFO', 'org.apache = DEBUG'", + "description": "The per-package log levels for the driver. This may include \"root\" package name to configure rootLogger. Examples: - 'com.google = FATAL' - 'root = INFO' - 'org.apache = DEBUG'", "type": "object" } }, @@ -4746,18 +4746,18 @@ "type": "object" }, "Metric": { - "description": "A Dataproc OSS metric.", + "description": "A Dataproc custom metric.", "id": "Metric", "properties": { "metricOverrides": { - "description": "Optional. Specify one or more available OSS metrics (https://cloud.google.com/dataproc/docs/guides/monitoring#available_oss_metrics) to collect for the metric course (for the SPARK metric source, any Spark metric (https://spark.apache.org/docs/latest/monitoring.html#metrics) can be specified).Provide metrics in the following format: METRIC_SOURCE: INSTANCE:GROUP:METRIC Use camelcase as appropriate.Examples: yarn:ResourceManager:QueueMetrics:AppsCompleted spark:driver:DAGScheduler:job.allJobs sparkHistoryServer:JVM:Memory:NonHeapMemoryUsage.committed hiveserver2:JVM:Memory:NonHeapMemoryUsage.used Notes: Only the specified overridden metrics will be collected for the metric source. For example, if one or more spark:executive metrics are listed as metric overrides, other SPARK metrics will not be collected. The collection of the default metrics for other OSS metric sources is unaffected. For example, if both SPARK andd YARN metric sources are enabled, and overrides are provided for Spark metrics only, all default YARN metrics will be collected.", + "description": "Optional. Specify one or more Custom metrics (https://cloud.google.com/dataproc/docs/guides/dataproc-metrics#custom_metrics) to collect for the metric course (for the SPARK metric source (any Spark metric (https://spark.apache.org/docs/latest/monitoring.html#metrics) can be specified).Provide metrics in the following format: METRIC_SOURCE: INSTANCE:GROUP:METRIC Use camelcase as appropriate.Examples: yarn:ResourceManager:QueueMetrics:AppsCompleted spark:driver:DAGScheduler:job.allJobs sparkHistoryServer:JVM:Memory:NonHeapMemoryUsage.committed hiveserver2:JVM:Memory:NonHeapMemoryUsage.used Notes: Only the specified overridden metrics are collected for the metric source. For example, if one or more spark:executive metrics are listed as metric overrides, other SPARK metrics are not collected. The collection of the metrics for other enabled custom metric sources is unaffected. For example, if both SPARK andd YARN metric sources are enabled, and overrides are provided for Spark metrics only, all YARN metrics are collected.", "items": { "type": "string" }, "type": "array" }, "metricSource": { - "description": "Required. Default metrics are collected unless metricOverrides are specified for the metric source (see Available OSS metrics (https://cloud.google.com/dataproc/docs/guides/monitoring#available_oss_metrics) for more information).", + "description": "Required. A standard set of metrics is collected unless metricOverrides are specified for the metric source (see Custom metrics (https://cloud.google.com/dataproc/docs/guides/dataproc-metrics#custom_metrics) for more information).", "enum": [ "METRIC_SOURCE_UNSPECIFIED", "MONITORING_AGENT_DEFAULTS", @@ -4770,7 +4770,7 @@ ], "enumDescriptions": [ "Required unspecified metric source.", - "Default monitoring agent metrics. If this source is enabled, Dataproc enables the monitoring agent in Compute Engine, and collects default monitoring agent metrics, which are published with an agent.googleapis.com prefix.", + "Monitoring agent metrics. If this source is enabled, Dataproc enables the monitoring agent in Compute Engine, and collects monitoring agent metrics, which are published with an agent.googleapis.com prefix.", "HDFS metric source.", "Spark metric source.", "YARN metric source.", diff --git a/dataproc/v1/dataproc-gen.go b/dataproc/v1/dataproc-gen.go index 91037e4a361..19c924dbc7f 100644 --- a/dataproc/v1/dataproc-gen.go +++ b/dataproc/v1/dataproc-gen.go @@ -3597,8 +3597,8 @@ func (s *ListWorkflowTemplatesResponse) MarshalJSON() ([]byte, error) { // LoggingConfig: The runtime logging config of the job. type LoggingConfig struct { // DriverLogLevels: The per-package log levels for the driver. This may - // include "root" package name to configure rootLogger. Examples: - // 'com.google = FATAL', 'root = INFO', 'org.apache = DEBUG' + // include "root" package name to configure rootLogger. Examples: - + // 'com.google = FATAL' - 'root = INFO' - 'org.apache = DEBUG' DriverLogLevels map[string]string `json:"driverLogLevels,omitempty"` // ForceSendFields is a list of field names (e.g. "DriverLogLevels") to @@ -3737,11 +3737,11 @@ func (s *MetastoreConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Metric: A Dataproc OSS metric. +// Metric: A Dataproc custom metric. type Metric struct { - // MetricOverrides: Optional. Specify one or more available OSS metrics - // (https://cloud.google.com/dataproc/docs/guides/monitoring#available_oss_metrics) - // to collect for the metric course (for the SPARK metric source, any + // MetricOverrides: Optional. Specify one or more Custom metrics + // (https://cloud.google.com/dataproc/docs/guides/dataproc-metrics#custom_metrics) + // to collect for the metric course (for the SPARK metric source (any // Spark metric // (https://spark.apache.org/docs/latest/monitoring.html#metrics) can be // specified).Provide metrics in the following format: METRIC_SOURCE: @@ -3750,27 +3750,27 @@ type Metric struct { // spark:driver:DAGScheduler:job.allJobs // sparkHistoryServer:JVM:Memory:NonHeapMemoryUsage.committed // hiveserver2:JVM:Memory:NonHeapMemoryUsage.used Notes: Only the - // specified overridden metrics will be collected for the metric source. - // For example, if one or more spark:executive metrics are listed as - // metric overrides, other SPARK metrics will not be collected. The - // collection of the default metrics for other OSS metric sources is - // unaffected. For example, if both SPARK andd YARN metric sources are - // enabled, and overrides are provided for Spark metrics only, all - // default YARN metrics will be collected. + // specified overridden metrics are collected for the metric source. For + // example, if one or more spark:executive metrics are listed as metric + // overrides, other SPARK metrics are not collected. The collection of + // the metrics for other enabled custom metric sources is unaffected. + // For example, if both SPARK andd YARN metric sources are enabled, and + // overrides are provided for Spark metrics only, all YARN metrics are + // collected. MetricOverrides []string `json:"metricOverrides,omitempty"` - // MetricSource: Required. Default metrics are collected unless - // metricOverrides are specified for the metric source (see Available - // OSS metrics - // (https://cloud.google.com/dataproc/docs/guides/monitoring#available_oss_metrics) + // MetricSource: Required. A standard set of metrics is collected unless + // metricOverrides are specified for the metric source (see Custom + // metrics + // (https://cloud.google.com/dataproc/docs/guides/dataproc-metrics#custom_metrics) // for more information). // // Possible values: // "METRIC_SOURCE_UNSPECIFIED" - Required unspecified metric source. - // "MONITORING_AGENT_DEFAULTS" - Default monitoring agent metrics. If - // this source is enabled, Dataproc enables the monitoring agent in - // Compute Engine, and collects default monitoring agent metrics, which - // are published with an agent.googleapis.com prefix. + // "MONITORING_AGENT_DEFAULTS" - Monitoring agent metrics. If this + // source is enabled, Dataproc enables the monitoring agent in Compute + // Engine, and collects monitoring agent metrics, which are published + // with an agent.googleapis.com prefix. // "HDFS" - HDFS metric source. // "SPARK" - Spark metric source. // "YARN" - YARN metric source. diff --git a/datastream/v1/datastream-api.json b/datastream/v1/datastream-api.json index eaf6f222f6e..0394e3fbc37 100644 --- a/datastream/v1/datastream-api.json +++ b/datastream/v1/datastream-api.json @@ -1222,7 +1222,7 @@ } } }, - "revision": "20230308", + "revision": "20230425", "rootUrl": "https://datastream.googleapis.com/", "schemas": { "AvroFileFormat": { @@ -1611,7 +1611,7 @@ "description": "AVRO file format configuration." }, "fileRotationInterval": { - "description": "The maximum duration for which new events are added before a file is closed and a new file is created.", + "description": "The maximum duration for which new events are added before a file is closed and a new file is created. Values within the range of 15-60 seconds are allowed.", "format": "google-duration", "type": "string" }, @@ -1836,7 +1836,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/datastream/v1/datastream-gen.go b/datastream/v1/datastream-gen.go index a931603e595..42d7e220b99 100644 --- a/datastream/v1/datastream-gen.go +++ b/datastream/v1/datastream-gen.go @@ -774,7 +774,8 @@ type GcsDestinationConfig struct { AvroFileFormat *AvroFileFormat `json:"avroFileFormat,omitempty"` // FileRotationInterval: The maximum duration for which new events are - // added before a file is closed and a new file is created. + // added before a file is closed and a new file is created. Values + // within the range of 15-60 seconds are allowed. FileRotationInterval string `json:"fileRotationInterval,omitempty"` // FileRotationMb: The maximum file size to be saved in the bucket. @@ -1156,7 +1157,7 @@ func (s *ListStreamsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/datastream/v1alpha1/datastream-api.json b/datastream/v1alpha1/datastream-api.json index cdca9bca03d..cd6a2bf3c4d 100644 --- a/datastream/v1alpha1/datastream-api.json +++ b/datastream/v1alpha1/datastream-api.json @@ -1221,7 +1221,7 @@ } } }, - "revision": "20230410", + "revision": "20230425", "rootUrl": "https://datastream.googleapis.com/", "schemas": { "AvroFileFormat": { @@ -1797,7 +1797,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/datastream/v1alpha1/datastream-gen.go b/datastream/v1alpha1/datastream-gen.go index e222d14f4b3..b0736ecab5d 100644 --- a/datastream/v1alpha1/datastream-gen.go +++ b/datastream/v1alpha1/datastream-gen.go @@ -1082,7 +1082,7 @@ func (s *ListStreamsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/dialogflow/v2/dialogflow-api.json b/dialogflow/v2/dialogflow-api.json index fea170bdbc7..6c315289eb4 100644 --- a/dialogflow/v2/dialogflow-api.json +++ b/dialogflow/v2/dialogflow-api.json @@ -8143,7 +8143,7 @@ } } }, - "revision": "20230418", + "revision": "20230505", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { @@ -9153,7 +9153,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3QueryInput": { - "description": "Represents the query input. It can contain one of: 1. A conversational query in the form of text. 2. An intent query that specifies which intent to trigger. 3. Natural language speech audio to be processed. 4. An event to be triggered. ", + "description": "Represents the query input. It can contain one of: 1. A conversational query in the form of text. 2. An intent query that specifies which intent to trigger. 3. Natural language speech audio to be processed. 4. An event to be triggered. 5. DTMF digits to invoke an intent and fill in parameter value.", "id": "GoogleCloudDialogflowCxV3QueryInput", "properties": { "audio": { @@ -9604,14 +9604,16 @@ "INTENT", "PAGE", "PARAMETERS", - "UTTERANCE" + "UTTERANCE", + "FLOW" ], "enumDescriptions": [ "Should never be used.", "The intent.", "The page.", "The parameters.", - "The message utterance." + "The message utterance.", + "The flow." ], "type": "string" } @@ -11018,7 +11020,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3beta1QueryInput": { - "description": "Represents the query input. It can contain one of: 1. A conversational query in the form of text. 2. An intent query that specifies which intent to trigger. 3. Natural language speech audio to be processed. 4. An event to be triggered. ", + "description": "Represents the query input. It can contain one of: 1. A conversational query in the form of text. 2. An intent query that specifies which intent to trigger. 3. Natural language speech audio to be processed. 4. An event to be triggered. 5. DTMF digits to invoke an intent and fill in parameter value.", "id": "GoogleCloudDialogflowCxV3beta1QueryInput", "properties": { "audio": { @@ -11469,14 +11471,16 @@ "INTENT", "PAGE", "PARAMETERS", - "UTTERANCE" + "UTTERANCE", + "FLOW" ], "enumDescriptions": [ "Should never be used.", "The intent.", "The page.", "The parameters.", - "The message utterance." + "The message utterance.", + "The flow." ], "type": "string" } @@ -12173,7 +12177,7 @@ "type": "string" }, "clicked": { - "description": "Indicates whether the answer/item was clicked by the human agent or not. Default to false.", + "description": "Indicates whether the answer/item was clicked by the human agent or not. Default to false. For knowledge search, the answer record is considered to be clicked if the answer was copied or any URI was clicked.", "type": "boolean" }, "correctnessLevel": { @@ -19189,7 +19193,7 @@ "type": "object" }, "GoogleCloudLocationLocation": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "GoogleCloudLocationLocation", "properties": { "displayName": { diff --git a/dialogflow/v2/dialogflow-gen.go b/dialogflow/v2/dialogflow-gen.go index 9a1506f3333..04e4066cc0d 100644 --- a/dialogflow/v2/dialogflow-gen.go +++ b/dialogflow/v2/dialogflow-gen.go @@ -2806,6 +2806,7 @@ func (s *GoogleCloudDialogflowCxV3PageInfoFormInfoParameterInfo) MarshalJSON() ( // can contain one of: 1. A conversational query in the form of text. 2. // An intent query that specifies which intent to trigger. 3. Natural // language speech audio to be processed. 4. An event to be triggered. +// 5. DTMF digits to invoke an intent and fill in parameter value. type GoogleCloudDialogflowCxV3QueryInput struct { // Audio: The natural language speech audio to be processed. Audio *GoogleCloudDialogflowCxV3AudioInput `json:"audio,omitempty"` @@ -3642,6 +3643,7 @@ type GoogleCloudDialogflowCxV3TestRunDifference struct { // "PAGE" - The page. // "PARAMETERS" - The parameters. // "UTTERANCE" - The message utterance. + // "FLOW" - The flow. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to @@ -6319,6 +6321,7 @@ func (s *GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo) MarshalJSO // It can contain one of: 1. A conversational query in the form of text. // 2. An intent query that specifies which intent to trigger. 3. Natural // language speech audio to be processed. 4. An event to be triggered. +// 5. DTMF digits to invoke an intent and fill in parameter value. type GoogleCloudDialogflowCxV3beta1QueryInput struct { // Audio: The natural language speech audio to be processed. Audio *GoogleCloudDialogflowCxV3beta1AudioInput `json:"audio,omitempty"` @@ -7157,6 +7160,7 @@ type GoogleCloudDialogflowCxV3beta1TestRunDifference struct { // "PAGE" - The page. // "PARAMETERS" - The parameters. // "UTTERANCE" - The message utterance. + // "FLOW" - The flow. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to @@ -8328,7 +8332,9 @@ type GoogleCloudDialogflowV2AnswerFeedback struct { ClickTime string `json:"clickTime,omitempty"` // Clicked: Indicates whether the answer/item was clicked by the human - // agent or not. Default to false. + // agent or not. Default to false. For knowledge search, the answer + // record is considered to be clicked if the answer was copied or any + // URI was clicked. Clicked bool `json:"clicked,omitempty"` // CorrectnessLevel: The correctness level of the specific answer. @@ -20896,8 +20902,8 @@ func (s *GoogleCloudLocationListLocationsResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudLocationLocation: A resource that represents Google Cloud -// Platform location. +// GoogleCloudLocationLocation: A resource that represents a Google +// Cloud location. type GoogleCloudLocationLocation struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/dialogflow/v2beta1/dialogflow-api.json b/dialogflow/v2beta1/dialogflow-api.json index 676b8c72f65..1c926cecab8 100644 --- a/dialogflow/v2beta1/dialogflow-api.json +++ b/dialogflow/v2beta1/dialogflow-api.json @@ -2609,6 +2609,7 @@ "answerRecords": { "methods": { "get": { + "deprecated": true, "description": "Deprecated. Retrieves a specific answer record.", "flatPath": "v2beta1/projects/{projectsId}/answerRecords/{answerRecordsId}", "httpMethod": "GET", @@ -3301,6 +3302,7 @@ "suggestions": { "methods": { "compile": { + "deprecated": true, "description": "Deprecated. use SuggestArticles and SuggestFaqAnswers instead. Gets suggestions for a participant based on specific historical messages. Note that ListSuggestions will only list the auto-generated suggestions, while CompileSuggestion will try to compile suggestion based on the provided conversation context in the real time.", "flatPath": "v2beta1/projects/{projectsId}/conversations/{conversationsId}/participants/{participantsId}/suggestions:compile", "httpMethod": "POST", @@ -3330,6 +3332,7 @@ ] }, "list": { + "deprecated": true, "description": "Deprecated: Use inline suggestion, event based suggestion or Suggestion* API instead. See HumanAgentAssistantConfig.name for more details. Removal Date: 2020-09-01. Retrieves suggestions for live agents. This method should be used by human agent client software to fetch auto generated suggestions in real-time, while the conversation with an end user is in progress. The functionality is implemented in terms of the [list pagination](https://cloud.google.com/apis/design/design_patterns#list_pagination) design pattern. The client app should use the `next_page_token` field to fetch the next batch of suggestions. `suggestions` are sorted by `create_time` in descending order. To fetch latest suggestion, just set `page_size` to 1. To fetch new suggestions without duplication, send request with filter `create_time_epoch_microseconds \u003e [first item's create_time of previous request]` and empty page_token.", "flatPath": "v2beta1/projects/{projectsId}/conversations/{conversationsId}/participants/{participantsId}/suggestions", "httpMethod": "GET", @@ -6095,6 +6098,7 @@ "answerRecords": { "methods": { "get": { + "deprecated": true, "description": "Deprecated. Retrieves a specific answer record.", "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/answerRecords/{answerRecordsId}", "httpMethod": "GET", @@ -7507,7 +7511,7 @@ } } }, - "revision": "20230418", + "revision": "20230505", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { @@ -8517,7 +8521,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3QueryInput": { - "description": "Represents the query input. It can contain one of: 1. A conversational query in the form of text. 2. An intent query that specifies which intent to trigger. 3. Natural language speech audio to be processed. 4. An event to be triggered. ", + "description": "Represents the query input. It can contain one of: 1. A conversational query in the form of text. 2. An intent query that specifies which intent to trigger. 3. Natural language speech audio to be processed. 4. An event to be triggered. 5. DTMF digits to invoke an intent and fill in parameter value.", "id": "GoogleCloudDialogflowCxV3QueryInput", "properties": { "audio": { @@ -8968,14 +8972,16 @@ "INTENT", "PAGE", "PARAMETERS", - "UTTERANCE" + "UTTERANCE", + "FLOW" ], "enumDescriptions": [ "Should never be used.", "The intent.", "The page.", "The parameters.", - "The message utterance." + "The message utterance.", + "The flow." ], "type": "string" } @@ -10382,7 +10388,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3beta1QueryInput": { - "description": "Represents the query input. It can contain one of: 1. A conversational query in the form of text. 2. An intent query that specifies which intent to trigger. 3. Natural language speech audio to be processed. 4. An event to be triggered. ", + "description": "Represents the query input. It can contain one of: 1. A conversational query in the form of text. 2. An intent query that specifies which intent to trigger. 3. Natural language speech audio to be processed. 4. An event to be triggered. 5. DTMF digits to invoke an intent and fill in parameter value.", "id": "GoogleCloudDialogflowCxV3beta1QueryInput", "properties": { "audio": { @@ -10833,14 +10839,16 @@ "INTENT", "PAGE", "PARAMETERS", - "UTTERANCE" + "UTTERANCE", + "FLOW" ], "enumDescriptions": [ "Should never be used.", "The intent.", "The page.", "The parameters.", - "The message utterance." + "The message utterance.", + "The flow." ], "type": "string" } @@ -13680,7 +13688,7 @@ "type": "string" }, "clicked": { - "description": "Indicates whether the answer/item was clicked by the human agent or not. Default to false.", + "description": "Indicates whether the answer/item was clicked by the human agent or not. Default to false. For knowledge search, the answer record is considered to be clicked if the answer was copied or any URI was clicked.", "type": "boolean" }, "correctnessLevel": { @@ -18763,7 +18771,7 @@ "type": "object" }, "GoogleCloudLocationLocation": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "GoogleCloudLocationLocation", "properties": { "displayName": { diff --git a/dialogflow/v2beta1/dialogflow-gen.go b/dialogflow/v2beta1/dialogflow-gen.go index 407721f762e..5107e7b5bae 100644 --- a/dialogflow/v2beta1/dialogflow-gen.go +++ b/dialogflow/v2beta1/dialogflow-gen.go @@ -2734,6 +2734,7 @@ func (s *GoogleCloudDialogflowCxV3PageInfoFormInfoParameterInfo) MarshalJSON() ( // can contain one of: 1. A conversational query in the form of text. 2. // An intent query that specifies which intent to trigger. 3. Natural // language speech audio to be processed. 4. An event to be triggered. +// 5. DTMF digits to invoke an intent and fill in parameter value. type GoogleCloudDialogflowCxV3QueryInput struct { // Audio: The natural language speech audio to be processed. Audio *GoogleCloudDialogflowCxV3AudioInput `json:"audio,omitempty"` @@ -3570,6 +3571,7 @@ type GoogleCloudDialogflowCxV3TestRunDifference struct { // "PAGE" - The page. // "PARAMETERS" - The parameters. // "UTTERANCE" - The message utterance. + // "FLOW" - The flow. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to @@ -6247,6 +6249,7 @@ func (s *GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo) MarshalJSO // It can contain one of: 1. A conversational query in the form of text. // 2. An intent query that specifies which intent to trigger. 3. Natural // language speech audio to be processed. 4. An event to be triggered. +// 5. DTMF digits to invoke an intent and fill in parameter value. type GoogleCloudDialogflowCxV3beta1QueryInput struct { // Audio: The natural language speech audio to be processed. Audio *GoogleCloudDialogflowCxV3beta1AudioInput `json:"audio,omitempty"` @@ -7085,6 +7088,7 @@ type GoogleCloudDialogflowCxV3beta1TestRunDifference struct { // "PAGE" - The page. // "PARAMETERS" - The parameters. // "UTTERANCE" - The message utterance. + // "FLOW" - The flow. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to @@ -11851,7 +11855,9 @@ type GoogleCloudDialogflowV2beta1AnswerFeedback struct { ClickTime string `json:"clickTime,omitempty"` // Clicked: Indicates whether the answer/item was clicked by the human - // agent or not. Default to false. + // agent or not. Default to false. For knowledge search, the answer + // record is considered to be clicked if the answer was copied or any + // URI was clicked. Clicked bool `json:"clicked,omitempty"` // CorrectnessLevel: The correctness level of the specific answer. @@ -21107,8 +21113,8 @@ func (s *GoogleCloudLocationListLocationsResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudLocationLocation: A resource that represents Google Cloud -// Platform location. +// GoogleCloudLocationLocation: A resource that represents a Google +// Cloud location. type GoogleCloudLocationLocation struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -33977,6 +33983,7 @@ func (c *ProjectsAnswerRecordsGetCall) Do(opts ...googleapi.CallOption) (*Google } return ret, nil // { + // "deprecated": true, // "description": "Deprecated. Retrieves a specific answer record.", // "flatPath": "v2beta1/projects/{projectsId}/answerRecords/{answerRecordsId}", // "httpMethod": "GET", @@ -37459,6 +37466,7 @@ func (c *ProjectsConversationsParticipantsSuggestionsCompileCall) Do(opts ...goo } return ret, nil // { + // "deprecated": true, // "description": "Deprecated. use SuggestArticles and SuggestFaqAnswers instead. Gets suggestions for a participant based on specific historical messages. Note that ListSuggestions will only list the auto-generated suggestions, while CompileSuggestion will try to compile suggestion based on the provided conversation context in the real time.", // "flatPath": "v2beta1/projects/{projectsId}/conversations/{conversationsId}/participants/{participantsId}/suggestions:compile", // "httpMethod": "POST", @@ -37652,6 +37660,7 @@ func (c *ProjectsConversationsParticipantsSuggestionsListCall) Do(opts ...google } return ret, nil // { + // "deprecated": true, // "description": "Deprecated: Use inline suggestion, event based suggestion or Suggestion* API instead. See HumanAgentAssistantConfig.name for more details. Removal Date: 2020-09-01. Retrieves suggestions for live agents. This method should be used by human agent client software to fetch auto generated suggestions in real-time, while the conversation with an end user is in progress. The functionality is implemented in terms of the [list pagination](https://cloud.google.com/apis/design/design_patterns#list_pagination) design pattern. The client app should use the `next_page_token` field to fetch the next batch of suggestions. `suggestions` are sorted by `create_time` in descending order. To fetch latest suggestion, just set `page_size` to 1. To fetch new suggestions without duplication, send request with filter `create_time_epoch_microseconds \u003e [first item's create_time of previous request]` and empty page_token.", // "flatPath": "v2beta1/projects/{projectsId}/conversations/{conversationsId}/participants/{participantsId}/suggestions", // "httpMethod": "GET", @@ -51433,6 +51442,7 @@ func (c *ProjectsLocationsAnswerRecordsGetCall) Do(opts ...googleapi.CallOption) } return ret, nil // { + // "deprecated": true, // "description": "Deprecated. Retrieves a specific answer record.", // "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/answerRecords/{answerRecordsId}", // "httpMethod": "GET", diff --git a/dialogflow/v3/dialogflow-api.json b/dialogflow/v3/dialogflow-api.json index 2f3b4a7176d..c7fbe15ea29 100644 --- a/dialogflow/v3/dialogflow-api.json +++ b/dialogflow/v3/dialogflow-api.json @@ -3820,7 +3820,7 @@ } } }, - "revision": "20230418", + "revision": "20230505", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -5324,7 +5324,7 @@ "id": "GoogleCloudDialogflowCxV3GcsDestination", "properties": { "uri": { - "description": "Required. The Google Cloud Storage URI for the exported objects. A URI is of the form: gs://bucket/object-name-or-prefix Whether a full object name, or just a prefix, its usage depends on the Dialogflow operation.", + "description": "Required. The Google Cloud Storage URI for the exported objects. A URI is of the form: `gs://bucket/object-name-or-prefix` Whether a full object name, or just a prefix, its usage depends on the Dialogflow operation.", "type": "string" } }, @@ -5608,7 +5608,7 @@ "id": "GoogleCloudDialogflowCxV3IntentCoverageIntent", "properties": { "covered": { - "description": "Whether or not the intent is covered by at least one of the agent's test cases.", + "description": "Whether the intent is covered by at least one of the agent's test cases.", "type": "boolean" }, "intent": { @@ -6325,7 +6325,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3QueryInput": { - "description": "Represents the query input. It can contain one of: 1. A conversational query in the form of text. 2. An intent query that specifies which intent to trigger. 3. Natural language speech audio to be processed. 4. An event to be triggered. ", + "description": "Represents the query input. It can contain one of: 1. A conversational query in the form of text. 2. An intent query that specifies which intent to trigger. 3. Natural language speech audio to be processed. 4. An event to be triggered. 5. DTMF digits to invoke an intent and fill in parameter value.", "id": "GoogleCloudDialogflowCxV3QueryInput", "properties": { "audio": { @@ -7289,14 +7289,16 @@ "INTENT", "PAGE", "PARAMETERS", - "UTTERANCE" + "UTTERANCE", + "FLOW" ], "enumDescriptions": [ "Should never be used.", "The intent.", "The page.", "The parameters.", - "The message utterance." + "The message utterance.", + "The flow." ], "type": "string" } @@ -7315,14 +7317,14 @@ "type": "object" }, "GoogleCloudDialogflowCxV3TextToSpeechSettings": { - "description": "Settings related to speech generating.", + "description": "Settings related to speech synthesizing.", "id": "GoogleCloudDialogflowCxV3TextToSpeechSettings", "properties": { "synthesizeSpeechConfigs": { "additionalProperties": { "$ref": "GoogleCloudDialogflowCxV3SynthesizeSpeechConfig" }, - "description": "Configuration of how speech should be synthesized, mapping from language (https://dialogflow.com/docs/reference/language) to SynthesizeSpeechConfig.", + "description": "Configuration of how speech should be synthesized, mapping from language (https://cloud.google.com/dialogflow/cx/docs/reference/language) to SynthesizeSpeechConfig. These settings affect: - The synthesize configuration used in [phone gateway](https://cloud.google.com/dialogflow/cx/docs/concept/integration/phone-gateway). - You no longer need to specify OutputAudioConfig.synthesize_speech_config when invoking API calls. Your agent will use the pre-configured options for speech synthesizing.", "type": "object" } }, @@ -7358,7 +7360,7 @@ "id": "GoogleCloudDialogflowCxV3TransitionCoverageTransition", "properties": { "covered": { - "description": "Whether or not the transition is covered by at least one of the agent's test cases.", + "description": "Whether the transition is covered by at least one of the agent's test cases.", "type": "boolean" }, "eventHandler": { @@ -7501,7 +7503,7 @@ "id": "GoogleCloudDialogflowCxV3TransitionRouteGroupCoverageCoverageTransition", "properties": { "covered": { - "description": "Whether or not the transition route is covered by at least one of the agent's test cases.", + "description": "Whether the transition route is covered by at least one of the agent's test cases.", "type": "boolean" }, "transitionRoute": { @@ -9091,7 +9093,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3beta1QueryInput": { - "description": "Represents the query input. It can contain one of: 1. A conversational query in the form of text. 2. An intent query that specifies which intent to trigger. 3. Natural language speech audio to be processed. 4. An event to be triggered. ", + "description": "Represents the query input. It can contain one of: 1. A conversational query in the form of text. 2. An intent query that specifies which intent to trigger. 3. Natural language speech audio to be processed. 4. An event to be triggered. 5. DTMF digits to invoke an intent and fill in parameter value.", "id": "GoogleCloudDialogflowCxV3beta1QueryInput", "properties": { "audio": { @@ -9542,14 +9544,16 @@ "INTENT", "PAGE", "PARAMETERS", - "UTTERANCE" + "UTTERANCE", + "FLOW" ], "enumDescriptions": [ "Should never be used.", "The intent.", "The page.", "The parameters.", - "The message utterance." + "The message utterance.", + "The flow." ], "type": "string" } @@ -14456,7 +14460,7 @@ "type": "object" }, "GoogleCloudLocationLocation": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "GoogleCloudLocationLocation", "properties": { "displayName": { diff --git a/dialogflow/v3/dialogflow-gen.go b/dialogflow/v3/dialogflow-gen.go index 563bd17adc0..c8f93441c39 100644 --- a/dialogflow/v3/dialogflow-gen.go +++ b/dialogflow/v3/dialogflow-gen.go @@ -3215,7 +3215,7 @@ func (s *GoogleCloudDialogflowCxV3FulfillmentSetParameterAction) MarshalJSON() ( // (e.g. exported agent or transcripts) outside of Dialogflow. type GoogleCloudDialogflowCxV3GcsDestination struct { // Uri: Required. The Google Cloud Storage URI for the exported objects. - // A URI is of the form: gs://bucket/object-name-or-prefix Whether a + // A URI is of the form: `gs://bucket/object-name-or-prefix` Whether a // full object name, or just a prefix, its usage depends on the // Dialogflow operation. Uri string `json:"uri,omitempty"` @@ -3778,8 +3778,8 @@ func (s *GoogleCloudDialogflowCxV3IntentCoverage) UnmarshalJSON(data []byte) err // GoogleCloudDialogflowCxV3IntentCoverageIntent: The agent's intent. type GoogleCloudDialogflowCxV3IntentCoverageIntent struct { - // Covered: Whether or not the intent is covered by at least one of the - // agent's test cases. + // Covered: Whether the intent is covered by at least one of the agent's + // test cases. Covered bool `json:"covered,omitempty"` // Intent: The intent full resource name @@ -5230,6 +5230,7 @@ func (s *GoogleCloudDialogflowCxV3PageInfoFormInfoParameterInfo) MarshalJSON() ( // can contain one of: 1. A conversational query in the form of text. 2. // An intent query that specifies which intent to trigger. 3. Natural // language speech audio to be processed. 4. An event to be triggered. +// 5. DTMF digits to invoke an intent and fill in parameter value. type GoogleCloudDialogflowCxV3QueryInput struct { // Audio: The natural language speech audio to be processed. Audio *GoogleCloudDialogflowCxV3AudioInput `json:"audio,omitempty"` @@ -6999,6 +7000,7 @@ type GoogleCloudDialogflowCxV3TestRunDifference struct { // "PAGE" - The page. // "PARAMETERS" - The parameters. // "UTTERANCE" - The message utterance. + // "FLOW" - The flow. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to @@ -7055,12 +7057,18 @@ func (s *GoogleCloudDialogflowCxV3TextInput) MarshalJSON() ([]byte, error) { } // GoogleCloudDialogflowCxV3TextToSpeechSettings: Settings related to -// speech generating. +// speech synthesizing. type GoogleCloudDialogflowCxV3TextToSpeechSettings struct { // SynthesizeSpeechConfigs: Configuration of how speech should be // synthesized, mapping from language - // (https://dialogflow.com/docs/reference/language) to - // SynthesizeSpeechConfig. + // (https://cloud.google.com/dialogflow/cx/docs/reference/language) to + // SynthesizeSpeechConfig. These settings affect: - The synthesize + // configuration used in phone gateway + // (https://cloud.google.com/dialogflow/cx/docs/concept/integration/phone-gateway). + // - You no longer need to specify + // OutputAudioConfig.synthesize_speech_config when invoking API calls. + // Your agent will use the pre-configured options for speech + // synthesizing. SynthesizeSpeechConfigs map[string]GoogleCloudDialogflowCxV3SynthesizeSpeechConfig `json:"synthesizeSpeechConfigs,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -7145,8 +7153,8 @@ func (s *GoogleCloudDialogflowCxV3TransitionCoverage) UnmarshalJSON(data []byte) // GoogleCloudDialogflowCxV3TransitionCoverageTransition: A transition // in a page. type GoogleCloudDialogflowCxV3TransitionCoverageTransition struct { - // Covered: Whether or not the transition is covered by at least one of - // the agent's test cases. + // Covered: Whether the transition is covered by at least one of the + // agent's test cases. Covered bool `json:"covered,omitempty"` // EventHandler: Event handler. @@ -7438,8 +7446,8 @@ func (s *GoogleCloudDialogflowCxV3TransitionRouteGroupCoverageCoverage) Unmarsha // GoogleCloudDialogflowCxV3TransitionRouteGroupCoverageCoverageTransitio // n: A transition coverage in a transition route group. type GoogleCloudDialogflowCxV3TransitionRouteGroupCoverageCoverageTransition struct { - // Covered: Whether or not the transition route is covered by at least - // one of the agent's test cases. + // Covered: Whether the transition route is covered by at least one of + // the agent's test cases. Covered bool `json:"covered,omitempty"` // TransitionRoute: Intent route or condition route. @@ -10374,6 +10382,7 @@ func (s *GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo) MarshalJSO // It can contain one of: 1. A conversational query in the form of text. // 2. An intent query that specifies which intent to trigger. 3. Natural // language speech audio to be processed. 4. An event to be triggered. +// 5. DTMF digits to invoke an intent and fill in parameter value. type GoogleCloudDialogflowCxV3beta1QueryInput struct { // Audio: The natural language speech audio to be processed. Audio *GoogleCloudDialogflowCxV3beta1AudioInput `json:"audio,omitempty"` @@ -11212,6 +11221,7 @@ type GoogleCloudDialogflowCxV3beta1TestRunDifference struct { // "PAGE" - The page. // "PARAMETERS" - The parameters. // "UTTERANCE" - The message utterance. + // "FLOW" - The flow. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to @@ -19575,8 +19585,8 @@ func (s *GoogleCloudLocationListLocationsResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudLocationLocation: A resource that represents Google Cloud -// Platform location. +// GoogleCloudLocationLocation: A resource that represents a Google +// Cloud location. type GoogleCloudLocationLocation struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/dialogflow/v3beta1/dialogflow-api.json b/dialogflow/v3beta1/dialogflow-api.json index 051e754cb74..5d906b0d991 100644 --- a/dialogflow/v3beta1/dialogflow-api.json +++ b/dialogflow/v3beta1/dialogflow-api.json @@ -3820,7 +3820,7 @@ } } }, - "revision": "20230418", + "revision": "20230505", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { @@ -4830,7 +4830,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3QueryInput": { - "description": "Represents the query input. It can contain one of: 1. A conversational query in the form of text. 2. An intent query that specifies which intent to trigger. 3. Natural language speech audio to be processed. 4. An event to be triggered. ", + "description": "Represents the query input. It can contain one of: 1. A conversational query in the form of text. 2. An intent query that specifies which intent to trigger. 3. Natural language speech audio to be processed. 4. An event to be triggered. 5. DTMF digits to invoke an intent and fill in parameter value.", "id": "GoogleCloudDialogflowCxV3QueryInput", "properties": { "audio": { @@ -5281,14 +5281,16 @@ "INTENT", "PAGE", "PARAMETERS", - "UTTERANCE" + "UTTERANCE", + "FLOW" ], "enumDescriptions": [ "Should never be used.", "The intent.", "The page.", "The parameters.", - "The message utterance." + "The message utterance.", + "The flow." ], "type": "string" } @@ -7189,7 +7191,7 @@ "id": "GoogleCloudDialogflowCxV3beta1GcsDestination", "properties": { "uri": { - "description": "Required. The Google Cloud Storage URI for the exported objects. A URI is of the form: gs://bucket/object-name-or-prefix Whether a full object name, or just a prefix, its usage depends on the Dialogflow operation.", + "description": "Required. The Google Cloud Storage URI for the exported objects. A URI is of the form: `gs://bucket/object-name-or-prefix` Whether a full object name, or just a prefix, its usage depends on the Dialogflow operation.", "type": "string" } }, @@ -7473,7 +7475,7 @@ "id": "GoogleCloudDialogflowCxV3beta1IntentCoverageIntent", "properties": { "covered": { - "description": "Whether or not the intent is covered by at least one of the agent's test cases.", + "description": "Whether the intent is covered by at least one of the agent's test cases.", "type": "boolean" }, "intent": { @@ -8190,7 +8192,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3beta1QueryInput": { - "description": "Represents the query input. It can contain one of: 1. A conversational query in the form of text. 2. An intent query that specifies which intent to trigger. 3. Natural language speech audio to be processed. 4. An event to be triggered. ", + "description": "Represents the query input. It can contain one of: 1. A conversational query in the form of text. 2. An intent query that specifies which intent to trigger. 3. Natural language speech audio to be processed. 4. An event to be triggered. 5. DTMF digits to invoke an intent and fill in parameter value.", "id": "GoogleCloudDialogflowCxV3beta1QueryInput", "properties": { "audio": { @@ -9154,14 +9156,16 @@ "INTENT", "PAGE", "PARAMETERS", - "UTTERANCE" + "UTTERANCE", + "FLOW" ], "enumDescriptions": [ "Should never be used.", "The intent.", "The page.", "The parameters.", - "The message utterance." + "The message utterance.", + "The flow." ], "type": "string" } @@ -9180,14 +9184,14 @@ "type": "object" }, "GoogleCloudDialogflowCxV3beta1TextToSpeechSettings": { - "description": "Settings related to speech generating.", + "description": "Settings related to speech synthesizing.", "id": "GoogleCloudDialogflowCxV3beta1TextToSpeechSettings", "properties": { "synthesizeSpeechConfigs": { "additionalProperties": { "$ref": "GoogleCloudDialogflowCxV3beta1SynthesizeSpeechConfig" }, - "description": "Configuration of how speech should be synthesized, mapping from language (https://dialogflow.com/docs/reference/language) to SynthesizeSpeechConfig.", + "description": "Configuration of how speech should be synthesized, mapping from language (https://cloud.google.com/dialogflow/cx/docs/reference/language) to SynthesizeSpeechConfig. These settings affect: - The synthesize configuration used in [phone gateway](https://cloud.google.com/dialogflow/cx/docs/concept/integration/phone-gateway). - You no longer need to specify OutputAudioConfig.synthesize_speech_config when invoking API calls. Your agent will use the pre-configured options for speech synthesizing.", "type": "object" } }, @@ -9223,7 +9227,7 @@ "id": "GoogleCloudDialogflowCxV3beta1TransitionCoverageTransition", "properties": { "covered": { - "description": "Whether or not the transition is covered by at least one of the agent's test cases.", + "description": "Whether the transition is covered by at least one of the agent's test cases.", "type": "boolean" }, "eventHandler": { @@ -9366,7 +9370,7 @@ "id": "GoogleCloudDialogflowCxV3beta1TransitionRouteGroupCoverageCoverageTransition", "properties": { "covered": { - "description": "Whether or not the transition route is covered by at least one of the agent's test cases.", + "description": "Whether the transition route is covered by at least one of the agent's test cases.", "type": "boolean" }, "transitionRoute": { @@ -14456,7 +14460,7 @@ "type": "object" }, "GoogleCloudLocationLocation": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "GoogleCloudLocationLocation", "properties": { "displayName": { diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index 36be887f474..ec48aea858b 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -2398,6 +2398,7 @@ func (s *GoogleCloudDialogflowCxV3PageInfoFormInfoParameterInfo) MarshalJSON() ( // can contain one of: 1. A conversational query in the form of text. 2. // An intent query that specifies which intent to trigger. 3. Natural // language speech audio to be processed. 4. An event to be triggered. +// 5. DTMF digits to invoke an intent and fill in parameter value. type GoogleCloudDialogflowCxV3QueryInput struct { // Audio: The natural language speech audio to be processed. Audio *GoogleCloudDialogflowCxV3AudioInput `json:"audio,omitempty"` @@ -3234,6 +3235,7 @@ type GoogleCloudDialogflowCxV3TestRunDifference struct { // "PAGE" - The page. // "PARAMETERS" - The parameters. // "UTTERANCE" - The message utterance. + // "FLOW" - The flow. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to @@ -6729,7 +6731,7 @@ func (s *GoogleCloudDialogflowCxV3beta1FulfillmentSetParameterAction) MarshalJSO // (e.g. exported agent or transcripts) outside of Dialogflow. type GoogleCloudDialogflowCxV3beta1GcsDestination struct { // Uri: Required. The Google Cloud Storage URI for the exported objects. - // A URI is of the form: gs://bucket/object-name-or-prefix Whether a + // A URI is of the form: `gs://bucket/object-name-or-prefix` Whether a // full object name, or just a prefix, its usage depends on the // Dialogflow operation. Uri string `json:"uri,omitempty"` @@ -7293,8 +7295,8 @@ func (s *GoogleCloudDialogflowCxV3beta1IntentCoverage) UnmarshalJSON(data []byte // GoogleCloudDialogflowCxV3beta1IntentCoverageIntent: The agent's // intent. type GoogleCloudDialogflowCxV3beta1IntentCoverageIntent struct { - // Covered: Whether or not the intent is covered by at least one of the - // agent's test cases. + // Covered: Whether the intent is covered by at least one of the agent's + // test cases. Covered bool `json:"covered,omitempty"` // Intent: The intent full resource name @@ -8747,6 +8749,7 @@ func (s *GoogleCloudDialogflowCxV3beta1PageInfoFormInfoParameterInfo) MarshalJSO // It can contain one of: 1. A conversational query in the form of text. // 2. An intent query that specifies which intent to trigger. 3. Natural // language speech audio to be processed. 4. An event to be triggered. +// 5. DTMF digits to invoke an intent and fill in parameter value. type GoogleCloudDialogflowCxV3beta1QueryInput struct { // Audio: The natural language speech audio to be processed. Audio *GoogleCloudDialogflowCxV3beta1AudioInput `json:"audio,omitempty"` @@ -10520,6 +10523,7 @@ type GoogleCloudDialogflowCxV3beta1TestRunDifference struct { // "PAGE" - The page. // "PARAMETERS" - The parameters. // "UTTERANCE" - The message utterance. + // "FLOW" - The flow. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to @@ -10576,12 +10580,18 @@ func (s *GoogleCloudDialogflowCxV3beta1TextInput) MarshalJSON() ([]byte, error) } // GoogleCloudDialogflowCxV3beta1TextToSpeechSettings: Settings related -// to speech generating. +// to speech synthesizing. type GoogleCloudDialogflowCxV3beta1TextToSpeechSettings struct { // SynthesizeSpeechConfigs: Configuration of how speech should be // synthesized, mapping from language - // (https://dialogflow.com/docs/reference/language) to - // SynthesizeSpeechConfig. + // (https://cloud.google.com/dialogflow/cx/docs/reference/language) to + // SynthesizeSpeechConfig. These settings affect: - The synthesize + // configuration used in phone gateway + // (https://cloud.google.com/dialogflow/cx/docs/concept/integration/phone-gateway). + // - You no longer need to specify + // OutputAudioConfig.synthesize_speech_config when invoking API calls. + // Your agent will use the pre-configured options for speech + // synthesizing. SynthesizeSpeechConfigs map[string]GoogleCloudDialogflowCxV3beta1SynthesizeSpeechConfig `json:"synthesizeSpeechConfigs,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -10666,8 +10676,8 @@ func (s *GoogleCloudDialogflowCxV3beta1TransitionCoverage) UnmarshalJSON(data [] // GoogleCloudDialogflowCxV3beta1TransitionCoverageTransition: A // transition in a page. type GoogleCloudDialogflowCxV3beta1TransitionCoverageTransition struct { - // Covered: Whether or not the transition is covered by at least one of - // the agent's test cases. + // Covered: Whether the transition is covered by at least one of the + // agent's test cases. Covered bool `json:"covered,omitempty"` // EventHandler: Event handler. @@ -10959,8 +10969,8 @@ func (s *GoogleCloudDialogflowCxV3beta1TransitionRouteGroupCoverageCoverage) Unm // GoogleCloudDialogflowCxV3beta1TransitionRouteGroupCoverageCoverageTran // sition: A transition coverage in a transition route group. type GoogleCloudDialogflowCxV3beta1TransitionRouteGroupCoverageCoverageTransition struct { - // Covered: Whether or not the transition route is covered by at least - // one of the agent's test cases. + // Covered: Whether the transition route is covered by at least one of + // the agent's test cases. Covered bool `json:"covered,omitempty"` // TransitionRoute: Intent route or condition route. @@ -19582,8 +19592,8 @@ func (s *GoogleCloudLocationListLocationsResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudLocationLocation: A resource that represents Google Cloud -// Platform location. +// GoogleCloudLocationLocation: A resource that represents a Google +// Cloud location. type GoogleCloudLocationLocation struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/discoveryengine/v1alpha/discoveryengine-api.json b/discoveryengine/v1alpha/discoveryengine-api.json index aeb55a7def5..ed9fc082d14 100644 --- a/discoveryengine/v1alpha/discoveryengine-api.json +++ b/discoveryengine/v1alpha/discoveryengine-api.json @@ -296,6 +296,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "purge": { + "description": "Permanently deletes all selected Documents under a branch. This process is asynchronous. If the request is valid, the removal will be enquired and processed offlines. Depending on the number of Documents, this operation could take hours to complete. Before the operation completes, some Documents may still be returned by DocumentService.GetDocument or DocumentService.ListDocuments. To get a sample of Documents that would be deleted, set PurgeDocumentsRequest.force to false.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/branches/{branchesId}/documents:purge", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.dataStores.branches.documents.purge", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/branches/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/documents:purge", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaPurgeDocumentsRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -678,6 +706,47 @@ "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": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/operations", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.engines.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/[^/]+/collections/[^/]+/engines/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+name}/operations", + "response": { + "$ref": "GoogleLongrunningListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } } @@ -940,6 +1009,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "purge": { + "description": "Permanently deletes all selected Documents under a branch. This process is asynchronous. If the request is valid, the removal will be enquired and processed offlines. Depending on the number of Documents, this operation could take hours to complete. Before the operation completes, some Documents may still be returned by DocumentService.GetDocument or DocumentService.ListDocuments. To get a sample of Documents that would be deleted, set PurgeDocumentsRequest.force to false.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/branches/{branchesId}/documents:purge", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.dataStores.branches.documents.purge", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/branches/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/documents:purge", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaPurgeDocumentsRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -1439,7 +1536,7 @@ } } }, - "revision": "20230424", + "revision": "20230503", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -2019,6 +2116,67 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaPurgeDocumentsMetadata": { + "description": "Metadata related to the progress of the PurgeDocuments operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1alphaPurgeDocumentsMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "failureCount": { + "description": "Count of entries that encountered errors while processing.", + "format": "int64", + "type": "string" + }, + "successCount": { + "description": "Count of entries that were deleted successfully.", + "format": "int64", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaPurgeDocumentsRequest": { + "description": "Request message for DocumentService.PurgeDocuments method.", + "id": "GoogleCloudDiscoveryengineV1alphaPurgeDocumentsRequest", + "properties": { + "filter": { + "description": "Required. Filter matching documents to purge. Only currently supported value is “*” (all items).", + "type": "string" + }, + "force": { + "description": "Actually performs the purge. If `force` is set to false, return the expected purge count without deleting any documents.", + "type": "boolean" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaPurgeDocumentsResponse": { + "description": "Response message for DocumentService.PurgeDocuments method. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.", + "id": "GoogleCloudDiscoveryengineV1alphaPurgeDocumentsResponse", + "properties": { + "purgeCount": { + "description": "The total count of documents purged as a result of the operation.", + "format": "int64", + "type": "string" + }, + "purgeSample": { + "description": "A sample of document names that will be deleted. Only populated if `force` is set to false. A max of 100 names will be returned and the names are chosen at random.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaRecommendRequest": { "description": "Request message for Recommend method.", "id": "GoogleCloudDiscoveryengineV1alphaRecommendRequest", @@ -2145,7 +2303,7 @@ "type": "string" }, "searchQuery": { - "description": "The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. At least one of search_query or page_categories is required for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.", + "description": "The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.", "type": "string" } }, @@ -2198,7 +2356,7 @@ "type": "object" }, "attributionToken": { - "description": "Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of PredictionService.Predict. This field enables accurate attribution of recommendation model performance. The value must be one of: * PredictResponse.attribution_token for events that are the result of PredictionService.Predict. * SearchResponse.attribution_token for events that are the result of SearchService.Search. * CompleteQueryResponse.attribution_token for events that are the result of SearchService.CompleteQuery. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass PredictResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the PredictResponse.attribution_token to this field.", + "description": "Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * PredictResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. * CompleteQueryResponse.attribution_token for events that are the result of CompletionService.CompleteQuery. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass PredictResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the PredictResponse.attribution_token to this field.", "type": "string" }, "completionInfo": { @@ -2226,7 +2384,7 @@ "type": "string" }, "filter": { - "description": "The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. One example is for `search` events, the associated SearchService.SearchRequest may contain a filter expression in SearchService.SearchRequest.filter conforming to https://google.aip.dev/160#filtering. Similarly, for `view-item-list` events that are generated from a PredictionService.PredictRequest, this field may be populated directly from PredictionService.PredictRequest.filter conforming to https://google.aip.dev/160#filtering. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "description": "The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. One example is for `search` events, the associated SearchRequest may contain a filter expression in SearchRequest.filter conforming to https://google.aip.dev/160#filtering. Similarly, for `view-item-list` events that are generated from a RecommendationService.RecommendRequest, this field may be populated directly from RecommendationService.RecommendRequest.filter conforming to https://google.aip.dev/160#filtering. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.", "type": "string" }, "mediaInfo": { @@ -2283,7 +2441,7 @@ "id": "GoogleCloudDiscoveryengineV1alphaUserInfo", "properties": { "userAgent": { - "description": "User agent as included in the HTTP header. Required for getting SearchResponse.sponsored_results. The field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This should not be set when using the client side event reporting with GTM or JavaScript tag in UserEventService.CollectUserEvent or if direct_user_request is set.", + "description": "User agent as included in the HTTP header. Required for getting SearchResponse.sponsored_results. The field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This should not be set when using the client side event reporting with GTM or JavaScript tag in UserEventService.CollectUserEvent or if UserEvent.direct_user_request is set.", "type": "string" }, "userId": { @@ -2404,6 +2562,52 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata": { + "description": "Metadata related to the progress of the PurgeDocuments operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "failureCount": { + "description": "Count of entries that encountered errors while processing.", + "format": "int64", + "type": "string" + }, + "successCount": { + "description": "Count of entries that were deleted successfully.", + "format": "int64", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaPurgeDocumentsResponse": { + "description": "Response message for DocumentService.PurgeDocuments method. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.", + "id": "GoogleCloudDiscoveryengineV1betaPurgeDocumentsResponse", + "properties": { + "purgeCount": { + "description": "The total count of documents purged as a result of the operation.", + "format": "int64", + "type": "string" + }, + "purgeSample": { + "description": "A sample of document names that will be deleted. Only populated if `force` is set to false. A max of 100 names will be returned and the names are chosen at random.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaSchema": { "description": "Defines the structure and layout of a type of document data.", "id": "GoogleCloudDiscoveryengineV1betaSchema", diff --git a/discoveryengine/v1alpha/discoveryengine-gen.go b/discoveryengine/v1alpha/discoveryengine-gen.go index ad769174c03..e0ee693c0f9 100644 --- a/discoveryengine/v1alpha/discoveryengine-gen.go +++ b/discoveryengine/v1alpha/discoveryengine-gen.go @@ -1592,6 +1592,118 @@ func (s *GoogleCloudDiscoveryengineV1alphaPanelInfo) MarshalJSON() ([]byte, erro return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaPurgeDocumentsMetadata: Metadata +// related to the progress of the PurgeDocuments operation. This will be +// returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1alphaPurgeDocumentsMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + + // FailureCount: Count of entries that encountered errors while + // processing. + FailureCount int64 `json:"failureCount,omitempty,string"` + + // SuccessCount: Count of entries that were deleted successfully. + SuccessCount int64 `json:"successCount,omitempty,string"` + + // UpdateTime: Operation last update time. If the operation is done, + // this is also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CreateTime") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDiscoveryengineV1alphaPurgeDocumentsMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaPurgeDocumentsMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaPurgeDocumentsRequest: Request +// message for DocumentService.PurgeDocuments method. +type GoogleCloudDiscoveryengineV1alphaPurgeDocumentsRequest struct { + // Filter: Required. Filter matching documents to purge. Only currently + // supported value is “*” (all items). + Filter string `json:"filter,omitempty"` + + // Force: Actually performs the purge. If `force` is set to false, + // return the expected purge count without deleting any documents. + Force bool `json:"force,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Filter") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Filter") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDiscoveryengineV1alphaPurgeDocumentsRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaPurgeDocumentsRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaPurgeDocumentsResponse: Response +// message for DocumentService.PurgeDocuments method. If the long +// running operation is successfully done, then this message is returned +// by the google.longrunning.Operations.response field. +type GoogleCloudDiscoveryengineV1alphaPurgeDocumentsResponse struct { + // PurgeCount: The total count of documents purged as a result of the + // operation. + PurgeCount int64 `json:"purgeCount,omitempty,string"` + + // PurgeSample: A sample of document names that will be deleted. Only + // populated if `force` is set to false. A max of 100 names will be + // returned and the names are chosen at random. + PurgeSample []string `json:"purgeSample,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PurgeCount") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "PurgeCount") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDiscoveryengineV1alphaPurgeDocumentsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaPurgeDocumentsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaRecommendRequest: Request message // for Recommend method. type GoogleCloudDiscoveryengineV1alphaRecommendRequest struct { @@ -1836,9 +1948,9 @@ type GoogleCloudDiscoveryengineV1alphaSearchInfo struct { // SearchQuery: The user's search query. See SearchRequest.query for // definition. The value must be a UTF-8 encoded string with a length // limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is - // returned. At least one of search_query or page_categories is required - // for `search` events. Other event types should not set this field. - // Otherwise, an INVALID_ARGUMENT error is returned. + // returned. At least one of search_query or PageInfo.page_category is + // required for `search` events. Other event types should not set this + // field. Otherwise, an INVALID_ARGUMENT error is returned. SearchQuery string `json:"searchQuery,omitempty"` // ForceSendFields is a list of field names (e.g. "Offset") to @@ -1968,19 +2080,20 @@ type GoogleCloudDiscoveryengineV1alphaUserEvent struct { // AttributionToken: Token to attribute an API response to user // action(s) to trigger the event. Highly recommended for user events - // that are the result of PredictionService.Predict. This field enables - // accurate attribution of recommendation model performance. The value - // must be one of: * PredictResponse.attribution_token for events that - // are the result of PredictionService.Predict. * + // that are the result of RecommendationService.Recommend. This field + // enables accurate attribution of recommendation model performance. The + // value must be one of: * PredictResponse.attribution_token for events + // that are the result of RecommendationService.Recommend. * // SearchResponse.attribution_token for events that are the result of // SearchService.Search. * CompleteQueryResponse.attribution_token for - // events that are the result of SearchService.CompleteQuery. This token - // enables us to accurately attribute page view or conversion completion - // back to the event and the particular predict response containing this - // clicked/purchased product. If user clicks on product K in the - // recommendation results, pass PredictResponse.attribution_token as a - // URL parameter to product K's page. When recording events on product - // K's page, log the PredictResponse.attribution_token to this field. + // events that are the result of CompletionService.CompleteQuery. This + // token enables us to accurately attribute page view or conversion + // completion back to the event and the particular predict response + // containing this clicked/purchased product. If user clicks on product + // K in the recommendation results, pass + // PredictResponse.attribution_token as a URL parameter to product K's + // page. When recording events on product K's page, log the + // PredictResponse.attribution_token to this field. AttributionToken string `json:"attributionToken,omitempty"` // CompletionInfo: CompleteQuery API details related to the event. This @@ -2026,15 +2139,14 @@ type GoogleCloudDiscoveryengineV1alphaUserEvent struct { // Filter: The filter syntax consists of an expression language for // constructing a predicate from one or more fields of the documents // being filtered. One example is for `search` events, the associated - // SearchService.SearchRequest may contain a filter expression in - // SearchService.SearchRequest.filter conforming to - // https://google.aip.dev/160#filtering. Similarly, for `view-item-list` - // events that are generated from a PredictionService.PredictRequest, - // this field may be populated directly from - // PredictionService.PredictRequest.filter conforming to - // https://google.aip.dev/160#filtering. The value must be a UTF-8 - // encoded string with a length limit of 1,000 characters. Otherwise, an - // INVALID_ARGUMENT error is returned. + // SearchRequest may contain a filter expression in SearchRequest.filter + // conforming to https://google.aip.dev/160#filtering. Similarly, for + // `view-item-list` events that are generated from a + // RecommendationService.RecommendRequest, this field may be populated + // directly from RecommendationService.RecommendRequest.filter + // conforming to https://google.aip.dev/160#filtering. The value must be + // a UTF-8 encoded string with a length limit of 1,000 characters. + // Otherwise, an INVALID_ARGUMENT error is returned. Filter string `json:"filter,omitempty"` // MediaInfo: Media-specific info. @@ -2125,7 +2237,8 @@ type GoogleCloudDiscoveryengineV1alphaUserInfo struct { // encoded string with a length limit of 1,000 characters. Otherwise, an // `INVALID_ARGUMENT` error is returned. This should not be set when // using the client side event reporting with GTM or JavaScript tag in - // UserEventService.CollectUserEvent or if direct_user_request is set. + // UserEventService.CollectUserEvent or if UserEvent.direct_user_request + // is set. UserAgent string `json:"userAgent,omitempty"` // UserId: Highly recommended for logged-in users. Unique identifier for @@ -2356,6 +2469,84 @@ func (s *GoogleCloudDiscoveryengineV1betaImportUserEventsResponse) MarshalJSON() return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata: Metadata +// related to the progress of the PurgeDocuments operation. This will be +// returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + + // FailureCount: Count of entries that encountered errors while + // processing. + FailureCount int64 `json:"failureCount,omitempty,string"` + + // SuccessCount: Count of entries that were deleted successfully. + SuccessCount int64 `json:"successCount,omitempty,string"` + + // UpdateTime: Operation last update time. If the operation is done, + // this is also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CreateTime") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaPurgeDocumentsResponse: Response +// message for DocumentService.PurgeDocuments method. If the long +// running operation is successfully done, then this message is returned +// by the google.longrunning.Operations.response field. +type GoogleCloudDiscoveryengineV1betaPurgeDocumentsResponse struct { + // PurgeCount: The total count of documents purged as a result of the + // operation. + PurgeCount int64 `json:"purgeCount,omitempty,string"` + + // PurgeSample: A sample of document names that will be deleted. Only + // populated if `force` is set to false. A max of 100 names will be + // returned and the names are chosen at random. + PurgeSample []string `json:"purgeSample,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PurgeCount") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "PurgeCount") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDiscoveryengineV1betaPurgeDocumentsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaPurgeDocumentsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaSchema: Defines the structure and // layout of a type of document data. type GoogleCloudDiscoveryengineV1betaSchema struct { @@ -3568,97 +3759,97 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) Do(op } -// method id "discoveryengine.projects.locations.collections.dataStores.branches.operations.get": +// method id "discoveryengine.projects.locations.collections.dataStores.branches.documents.purge": -type ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall struct { + s *Service + parent string + googleclouddiscoveryenginev1alphapurgedocumentsrequest *GoogleCloudDiscoveryengineV1alphaPurgeDocumentsRequest + 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. +// Purge: Permanently deletes all selected Documents under a branch. +// This process is asynchronous. If the request is valid, the removal +// will be enquired and processed offlines. Depending on the number of +// Documents, this operation could take hours to complete. Before the +// operation completes, some Documents may still be returned by +// DocumentService.GetDocument or DocumentService.ListDocuments. To get +// a sample of Documents that would be deleted, set +// PurgeDocumentsRequest.force to false. // -// - 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 +// - parent: The parent resource name, such as +// `projects/{project}/locations/{location}/collections/{collection}/da +// taStores/{data_store}/branches/{branch}`. +func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Purge(parent string, googleclouddiscoveryenginev1alphapurgedocumentsrequest *GoogleCloudDiscoveryengineV1alphaPurgeDocumentsRequest) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1alphapurgedocumentsrequest = googleclouddiscoveryenginev1alphapurgedocumentsrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response -// error from Do is the result of In-None-Match. -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. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) 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 *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddiscoveryenginev1alphapurgedocumentsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/documents:purge") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", 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, }) 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.branches.documents.purge" call. // Exactly one of *GoogleLongrunningOperation or error will be non-nil. // 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) { +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 { @@ -3689,23 +3880,26 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Do(opt } return ret, nil // { - // "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": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/branches/{branchesId}/operations/{operationsId}", - // "httpMethod": "GET", - // "id": "discoveryengine.projects.locations.collections.dataStores.branches.operations.get", + // "description": "Permanently deletes all selected Documents under a branch. This process is asynchronous. If the request is valid, the removal will be enquired and processed offlines. Depending on the number of Documents, this operation could take hours to complete. Before the operation completes, some Documents may still be returned by DocumentService.GetDocument or DocumentService.ListDocuments. To get a sample of Documents that would be deleted, set PurgeDocumentsRequest.force to false.", + // "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/branches/{branchesId}/documents:purge", + // "httpMethod": "POST", + // "id": "discoveryengine.projects.locations.collections.dataStores.branches.documents.purge", // "parameterOrder": [ - // "name" + // "parent" // ], // "parameters": { - // "name": { - // "description": "The name of the operation resource.", + // "parent": { + // "description": "Required. The parent resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/branches/[^/]+/operations/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/branches/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1alpha/{+name}", + // "path": "v1alpha/{+parent}/documents:purge", + // "request": { + // "$ref": "GoogleCloudDiscoveryengineV1alphaPurgeDocumentsRequest" + // }, // "response": { // "$ref": "GoogleLongrunningOperation" // }, @@ -3716,9 +3910,9 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Do(opt } -// method id "discoveryengine.projects.locations.collections.dataStores.branches.operations.list": +// method id "discoveryengine.projects.locations.collections.dataStores.branches.operations.get": -type ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall struct { +type ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -3727,42 +3921,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`. +// 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's parent resource. -func (r *ProjectsLocationsCollectionsDataStoresBranchesOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { - c := &ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - 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 } -// 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 -} - // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -3772,7 +3945,7 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Field // getting updates only after the object has changed since the last // request. Use googleapi.IsNotModified to check whether the response // error from Do is the result of In-None-Match. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { c.ifNoneMatch_ = entityTag return c } @@ -3780,21 +3953,21 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) IfNon // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) 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 *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -3807,7 +3980,7 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) doReq var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}/operations") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -3820,11 +3993,180 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) doReq return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.operations.list" call. -// Exactly one of *GoogleLongrunningListOperationsResponse or error will -// be non-nil. Any non-2xx status code is an error. Response headers are -// in either -// *GoogleLongrunningListOperationsResponse.ServerResponse.Header or (if +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.operations.get" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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) { + 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/branches/{branchesId}/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "discoveryengine.projects.locations.collections.dataStores.branches.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/branches/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}", + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "discoveryengine.projects.locations.collections.dataStores.branches.operations.list": + +type ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall 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 *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 +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +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. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}/operations") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.operations.list" call. +// Exactly one of *GoogleLongrunningListOperationsResponse or error will +// be non-nil. 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. @@ -5416,6 +5758,213 @@ func (c *ProjectsLocationsCollectionsEnginesOperationsGetCall) Do(opts ...google } +// method id "discoveryengine.projects.locations.collections.engines.operations.list": + +type ProjectsLocationsCollectionsEnginesOperationsListCall 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 *ProjectsLocationsCollectionsEnginesOperationsService) List(name string) *ProjectsLocationsCollectionsEnginesOperationsListCall { + c := &ProjectsLocationsCollectionsEnginesOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsEnginesOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsEnginesOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsEnginesOperationsListCall { + 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 information. +func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesOperationsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesOperationsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}/operations") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.engines.operations.list" call. +// Exactly one of *GoogleLongrunningListOperationsResponse or error will +// be non-nil. 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 *ProjectsLocationsCollectionsEnginesOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, 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 := &GoogleLongrunningListOperationsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", + // "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/operations", + // "httpMethod": "GET", + // "id": "discoveryengine.projects.locations.collections.engines.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/[^/]+/collections/[^/]+/engines/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "pageSize": { + // "description": "The standard list page size.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The standard list page token.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}/operations", + // "response": { + // "$ref": "GoogleLongrunningListOperationsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsCollectionsEnginesOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + // method id "discoveryengine.projects.locations.collections.operations.get": type ProjectsLocationsCollectionsOperationsGetCall struct { @@ -6743,6 +7292,157 @@ func (c *ProjectsLocationsDataStoresBranchesDocumentsPatchCall) Do(opts ...googl } +// method id "discoveryengine.projects.locations.dataStores.branches.documents.purge": + +type ProjectsLocationsDataStoresBranchesDocumentsPurgeCall struct { + s *Service + parent string + googleclouddiscoveryenginev1alphapurgedocumentsrequest *GoogleCloudDiscoveryengineV1alphaPurgeDocumentsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Purge: Permanently deletes all selected Documents under a branch. +// This process is asynchronous. If the request is valid, the removal +// will be enquired and processed offlines. Depending on the number of +// Documents, this operation could take hours to complete. Before the +// operation completes, some Documents may still be returned by +// DocumentService.GetDocument or DocumentService.ListDocuments. To get +// a sample of Documents that would be deleted, set +// PurgeDocumentsRequest.force to false. +// +// - parent: The parent resource name, such as +// `projects/{project}/locations/{location}/collections/{collection}/da +// taStores/{data_store}/branches/{branch}`. +func (r *ProjectsLocationsDataStoresBranchesDocumentsService) Purge(parent string, googleclouddiscoveryenginev1alphapurgedocumentsrequest *GoogleCloudDiscoveryengineV1alphaPurgeDocumentsRequest) *ProjectsLocationsDataStoresBranchesDocumentsPurgeCall { + c := &ProjectsLocationsDataStoresBranchesDocumentsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1alphapurgedocumentsrequest = googleclouddiscoveryenginev1alphapurgedocumentsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsDataStoresBranchesDocumentsPurgeCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataStoresBranchesDocumentsPurgeCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsDataStoresBranchesDocumentsPurgeCall) Context(ctx context.Context) *ProjectsLocationsDataStoresBranchesDocumentsPurgeCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsDataStoresBranchesDocumentsPurgeCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataStoresBranchesDocumentsPurgeCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddiscoveryenginev1alphapurgedocumentsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/documents:purge") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.dataStores.branches.documents.purge" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *ProjectsLocationsDataStoresBranchesDocumentsPurgeCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Permanently deletes all selected Documents under a branch. This process is asynchronous. If the request is valid, the removal will be enquired and processed offlines. Depending on the number of Documents, this operation could take hours to complete. Before the operation completes, some Documents may still be returned by DocumentService.GetDocument or DocumentService.ListDocuments. To get a sample of Documents that would be deleted, set PurgeDocumentsRequest.force to false.", + // "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/branches/{branchesId}/documents:purge", + // "httpMethod": "POST", + // "id": "discoveryengine.projects.locations.dataStores.branches.documents.purge", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The parent resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/branches/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+parent}/documents:purge", + // "request": { + // "$ref": "GoogleCloudDiscoveryengineV1alphaPurgeDocumentsRequest" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "discoveryengine.projects.locations.dataStores.branches.operations.get": type ProjectsLocationsDataStoresBranchesOperationsGetCall struct { diff --git a/discoveryengine/v1beta/discoveryengine-api.json b/discoveryengine/v1beta/discoveryengine-api.json index b8504a7f4a3..8a03d3b41c9 100644 --- a/discoveryengine/v1beta/discoveryengine-api.json +++ b/discoveryengine/v1beta/discoveryengine-api.json @@ -296,6 +296,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "purge": { + "description": "Permanently deletes all selected Documents under a branch. This process is asynchronous. If the request is valid, the removal will be enquired and processed offlines. Depending on the number of Documents, this operation could take hours to complete. Before the operation completes, some Documents may still be returned by DocumentService.GetDocument or DocumentService.ListDocuments. To get a sample of Documents that would be deleted, set PurgeDocumentsRequest.force to false.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/branches/{branchesId}/documents:purge", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.dataStores.branches.documents.purge", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/branches/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+parent}/documents:purge", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaPurgeDocumentsRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -678,6 +706,47 @@ "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": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/operations", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.engines.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/[^/]+/collections/[^/]+/engines/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1beta/{+name}/operations", + "response": { + "$ref": "GoogleLongrunningListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } } @@ -940,6 +1009,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "purge": { + "description": "Permanently deletes all selected Documents under a branch. This process is asynchronous. If the request is valid, the removal will be enquired and processed offlines. Depending on the number of Documents, this operation could take hours to complete. Before the operation completes, some Documents may still be returned by DocumentService.GetDocument or DocumentService.ListDocuments. To get a sample of Documents that would be deleted, set PurgeDocumentsRequest.force to false.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/branches/{branchesId}/documents:purge", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.dataStores.branches.documents.purge", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/branches/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+parent}/documents:purge", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaPurgeDocumentsRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -1439,7 +1536,7 @@ } } }, - "revision": "20230424", + "revision": "20230503", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -1699,6 +1796,52 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaPurgeDocumentsMetadata": { + "description": "Metadata related to the progress of the PurgeDocuments operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1alphaPurgeDocumentsMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "failureCount": { + "description": "Count of entries that encountered errors while processing.", + "format": "int64", + "type": "string" + }, + "successCount": { + "description": "Count of entries that were deleted successfully.", + "format": "int64", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaPurgeDocumentsResponse": { + "description": "Response message for DocumentService.PurgeDocuments method. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.", + "id": "GoogleCloudDiscoveryengineV1alphaPurgeDocumentsResponse", + "properties": { + "purgeCount": { + "description": "The total count of documents purged as a result of the operation.", + "format": "int64", + "type": "string" + }, + "purgeSample": { + "description": "A sample of document names that will be deleted. Only populated if `force` is set to false. A max of 100 names will be returned and the names are chosen at random.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSchema": { "description": "Defines the structure and layout of a type of document data.", "id": "GoogleCloudDiscoveryengineV1alphaSchema", @@ -2153,6 +2296,67 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata": { + "description": "Metadata related to the progress of the PurgeDocuments operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "failureCount": { + "description": "Count of entries that encountered errors while processing.", + "format": "int64", + "type": "string" + }, + "successCount": { + "description": "Count of entries that were deleted successfully.", + "format": "int64", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaPurgeDocumentsRequest": { + "description": "Request message for DocumentService.PurgeDocuments method.", + "id": "GoogleCloudDiscoveryengineV1betaPurgeDocumentsRequest", + "properties": { + "filter": { + "description": "Required. Filter matching documents to purge. Only currently supported value is “*” (all items).", + "type": "string" + }, + "force": { + "description": "Actually performs the purge. If `force` is set to false, return the expected purge count without deleting any documents.", + "type": "boolean" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaPurgeDocumentsResponse": { + "description": "Response message for DocumentService.PurgeDocuments method. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.", + "id": "GoogleCloudDiscoveryengineV1betaPurgeDocumentsResponse", + "properties": { + "purgeCount": { + "description": "The total count of documents purged as a result of the operation.", + "format": "int64", + "type": "string" + }, + "purgeSample": { + "description": "A sample of document names that will be deleted. Only populated if `force` is set to false. A max of 100 names will be returned and the names are chosen at random.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaRecommendRequest": { "description": "Request message for Recommend method.", "id": "GoogleCloudDiscoveryengineV1betaRecommendRequest", @@ -2279,7 +2483,7 @@ "type": "string" }, "searchQuery": { - "description": "The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. At least one of search_query or page_categories is required for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.", + "description": "The user's search query. See SearchRequest.query for definition. The value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. At least one of search_query or PageInfo.page_category is required for `search` events. Other event types should not set this field. Otherwise, an INVALID_ARGUMENT error is returned.", "type": "string" } }, @@ -2332,7 +2536,7 @@ "type": "object" }, "attributionToken": { - "description": "Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of PredictionService.Predict. This field enables accurate attribution of recommendation model performance. The value must be one of: * PredictResponse.attribution_token for events that are the result of PredictionService.Predict. * SearchResponse.attribution_token for events that are the result of SearchService.Search. * CompleteQueryResponse.attribution_token for events that are the result of SearchService.CompleteQuery. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass PredictResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the PredictResponse.attribution_token to this field.", + "description": "Token to attribute an API response to user action(s) to trigger the event. Highly recommended for user events that are the result of RecommendationService.Recommend. This field enables accurate attribution of recommendation model performance. The value must be one of: * PredictResponse.attribution_token for events that are the result of RecommendationService.Recommend. * SearchResponse.attribution_token for events that are the result of SearchService.Search. * CompleteQueryResponse.attribution_token for events that are the result of CompletionService.CompleteQuery. This token enables us to accurately attribute page view or conversion completion back to the event and the particular predict response containing this clicked/purchased product. If user clicks on product K in the recommendation results, pass PredictResponse.attribution_token as a URL parameter to product K's page. When recording events on product K's page, log the PredictResponse.attribution_token to this field.", "type": "string" }, "completionInfo": { @@ -2360,7 +2564,7 @@ "type": "string" }, "filter": { - "description": "The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. One example is for `search` events, the associated SearchService.SearchRequest may contain a filter expression in SearchService.SearchRequest.filter conforming to https://google.aip.dev/160#filtering. Similarly, for `view-item-list` events that are generated from a PredictionService.PredictRequest, this field may be populated directly from PredictionService.PredictRequest.filter conforming to https://google.aip.dev/160#filtering. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "description": "The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. One example is for `search` events, the associated SearchRequest may contain a filter expression in SearchRequest.filter conforming to https://google.aip.dev/160#filtering. Similarly, for `view-item-list` events that are generated from a RecommendationService.RecommendRequest, this field may be populated directly from RecommendationService.RecommendRequest.filter conforming to https://google.aip.dev/160#filtering. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.", "type": "string" }, "mediaInfo": { @@ -2417,7 +2621,7 @@ "id": "GoogleCloudDiscoveryengineV1betaUserInfo", "properties": { "userAgent": { - "description": "User agent as included in the HTTP header. Required for getting SearchResponse.sponsored_results. The field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This should not be set when using the client side event reporting with GTM or JavaScript tag in UserEventService.CollectUserEvent or if direct_user_request is set.", + "description": "User agent as included in the HTTP header. Required for getting SearchResponse.sponsored_results. The field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned. This should not be set when using the client side event reporting with GTM or JavaScript tag in UserEventService.CollectUserEvent or if UserEvent.direct_user_request is set.", "type": "string" }, "userId": { diff --git a/discoveryengine/v1beta/discoveryengine-gen.go b/discoveryengine/v1beta/discoveryengine-gen.go index ab877e6d66a..b8470738412 100644 --- a/discoveryengine/v1beta/discoveryengine-gen.go +++ b/discoveryengine/v1beta/discoveryengine-gen.go @@ -941,6 +941,84 @@ func (s *GoogleCloudDiscoveryengineV1alphaImportUserEventsResponse) MarshalJSON( return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaPurgeDocumentsMetadata: Metadata +// related to the progress of the PurgeDocuments operation. This will be +// returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1alphaPurgeDocumentsMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + + // FailureCount: Count of entries that encountered errors while + // processing. + FailureCount int64 `json:"failureCount,omitempty,string"` + + // SuccessCount: Count of entries that were deleted successfully. + SuccessCount int64 `json:"successCount,omitempty,string"` + + // UpdateTime: Operation last update time. If the operation is done, + // this is also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CreateTime") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDiscoveryengineV1alphaPurgeDocumentsMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaPurgeDocumentsMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaPurgeDocumentsResponse: Response +// message for DocumentService.PurgeDocuments method. If the long +// running operation is successfully done, then this message is returned +// by the google.longrunning.Operations.response field. +type GoogleCloudDiscoveryengineV1alphaPurgeDocumentsResponse struct { + // PurgeCount: The total count of documents purged as a result of the + // operation. + PurgeCount int64 `json:"purgeCount,omitempty,string"` + + // PurgeSample: A sample of document names that will be deleted. Only + // populated if `force` is set to false. A max of 100 names will be + // returned and the names are chosen at random. + PurgeSample []string `json:"purgeSample,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PurgeCount") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "PurgeCount") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDiscoveryengineV1alphaPurgeDocumentsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaPurgeDocumentsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaSchema: Defines the structure and // layout of a type of document data. type GoogleCloudDiscoveryengineV1alphaSchema struct { @@ -1827,6 +1905,118 @@ func (s *GoogleCloudDiscoveryengineV1betaPanelInfo) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata: Metadata +// related to the progress of the PurgeDocuments operation. This will be +// returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + + // FailureCount: Count of entries that encountered errors while + // processing. + FailureCount int64 `json:"failureCount,omitempty,string"` + + // SuccessCount: Count of entries that were deleted successfully. + SuccessCount int64 `json:"successCount,omitempty,string"` + + // UpdateTime: Operation last update time. If the operation is done, + // this is also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CreateTime") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaPurgeDocumentsRequest: Request +// message for DocumentService.PurgeDocuments method. +type GoogleCloudDiscoveryengineV1betaPurgeDocumentsRequest struct { + // Filter: Required. Filter matching documents to purge. Only currently + // supported value is “*” (all items). + Filter string `json:"filter,omitempty"` + + // Force: Actually performs the purge. If `force` is set to false, + // return the expected purge count without deleting any documents. + Force bool `json:"force,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Filter") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Filter") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDiscoveryengineV1betaPurgeDocumentsRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaPurgeDocumentsRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaPurgeDocumentsResponse: Response +// message for DocumentService.PurgeDocuments method. If the long +// running operation is successfully done, then this message is returned +// by the google.longrunning.Operations.response field. +type GoogleCloudDiscoveryengineV1betaPurgeDocumentsResponse struct { + // PurgeCount: The total count of documents purged as a result of the + // operation. + PurgeCount int64 `json:"purgeCount,omitempty,string"` + + // PurgeSample: A sample of document names that will be deleted. Only + // populated if `force` is set to false. A max of 100 names will be + // returned and the names are chosen at random. + PurgeSample []string `json:"purgeSample,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PurgeCount") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "PurgeCount") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDiscoveryengineV1betaPurgeDocumentsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaPurgeDocumentsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaRecommendRequest: Request message for // Recommend method. type GoogleCloudDiscoveryengineV1betaRecommendRequest struct { @@ -2073,9 +2263,9 @@ type GoogleCloudDiscoveryengineV1betaSearchInfo struct { // SearchQuery: The user's search query. See SearchRequest.query for // definition. The value must be a UTF-8 encoded string with a length // limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is - // returned. At least one of search_query or page_categories is required - // for `search` events. Other event types should not set this field. - // Otherwise, an INVALID_ARGUMENT error is returned. + // returned. At least one of search_query or PageInfo.page_category is + // required for `search` events. Other event types should not set this + // field. Otherwise, an INVALID_ARGUMENT error is returned. SearchQuery string `json:"searchQuery,omitempty"` // ForceSendFields is a list of field names (e.g. "Offset") to @@ -2205,19 +2395,20 @@ type GoogleCloudDiscoveryengineV1betaUserEvent struct { // AttributionToken: Token to attribute an API response to user // action(s) to trigger the event. Highly recommended for user events - // that are the result of PredictionService.Predict. This field enables - // accurate attribution of recommendation model performance. The value - // must be one of: * PredictResponse.attribution_token for events that - // are the result of PredictionService.Predict. * + // that are the result of RecommendationService.Recommend. This field + // enables accurate attribution of recommendation model performance. The + // value must be one of: * PredictResponse.attribution_token for events + // that are the result of RecommendationService.Recommend. * // SearchResponse.attribution_token for events that are the result of // SearchService.Search. * CompleteQueryResponse.attribution_token for - // events that are the result of SearchService.CompleteQuery. This token - // enables us to accurately attribute page view or conversion completion - // back to the event and the particular predict response containing this - // clicked/purchased product. If user clicks on product K in the - // recommendation results, pass PredictResponse.attribution_token as a - // URL parameter to product K's page. When recording events on product - // K's page, log the PredictResponse.attribution_token to this field. + // events that are the result of CompletionService.CompleteQuery. This + // token enables us to accurately attribute page view or conversion + // completion back to the event and the particular predict response + // containing this clicked/purchased product. If user clicks on product + // K in the recommendation results, pass + // PredictResponse.attribution_token as a URL parameter to product K's + // page. When recording events on product K's page, log the + // PredictResponse.attribution_token to this field. AttributionToken string `json:"attributionToken,omitempty"` // CompletionInfo: CompleteQuery API details related to the event. This @@ -2263,15 +2454,14 @@ type GoogleCloudDiscoveryengineV1betaUserEvent struct { // Filter: The filter syntax consists of an expression language for // constructing a predicate from one or more fields of the documents // being filtered. One example is for `search` events, the associated - // SearchService.SearchRequest may contain a filter expression in - // SearchService.SearchRequest.filter conforming to - // https://google.aip.dev/160#filtering. Similarly, for `view-item-list` - // events that are generated from a PredictionService.PredictRequest, - // this field may be populated directly from - // PredictionService.PredictRequest.filter conforming to - // https://google.aip.dev/160#filtering. The value must be a UTF-8 - // encoded string with a length limit of 1,000 characters. Otherwise, an - // INVALID_ARGUMENT error is returned. + // SearchRequest may contain a filter expression in SearchRequest.filter + // conforming to https://google.aip.dev/160#filtering. Similarly, for + // `view-item-list` events that are generated from a + // RecommendationService.RecommendRequest, this field may be populated + // directly from RecommendationService.RecommendRequest.filter + // conforming to https://google.aip.dev/160#filtering. The value must be + // a UTF-8 encoded string with a length limit of 1,000 characters. + // Otherwise, an INVALID_ARGUMENT error is returned. Filter string `json:"filter,omitempty"` // MediaInfo: Media-specific info. @@ -2361,7 +2551,8 @@ type GoogleCloudDiscoveryengineV1betaUserInfo struct { // encoded string with a length limit of 1,000 characters. Otherwise, an // `INVALID_ARGUMENT` error is returned. This should not be set when // using the client side event reporting with GTM or JavaScript tag in - // UserEventService.CollectUserEvent or if direct_user_request is set. + // UserEventService.CollectUserEvent or if UserEvent.direct_user_request + // is set. UserAgent string `json:"userAgent,omitempty"` // UserId: Highly recommended for logged-in users. Unique identifier for @@ -3568,97 +3759,97 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPatchCall) Do(op } -// method id "discoveryengine.projects.locations.collections.dataStores.branches.operations.get": +// method id "discoveryengine.projects.locations.collections.dataStores.branches.documents.purge": -type ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall struct { + s *Service + parent string + googleclouddiscoveryenginev1betapurgedocumentsrequest *GoogleCloudDiscoveryengineV1betaPurgeDocumentsRequest + 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. +// Purge: Permanently deletes all selected Documents under a branch. +// This process is asynchronous. If the request is valid, the removal +// will be enquired and processed offlines. Depending on the number of +// Documents, this operation could take hours to complete. Before the +// operation completes, some Documents may still be returned by +// DocumentService.GetDocument or DocumentService.ListDocuments. To get +// a sample of Documents that would be deleted, set +// PurgeDocumentsRequest.force to false. // -// - 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 +// - parent: The parent resource name, such as +// `projects/{project}/locations/{location}/collections/{collection}/da +// taStores/{data_store}/branches/{branch}`. +func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Purge(parent string, googleclouddiscoveryenginev1betapurgedocumentsrequest *GoogleCloudDiscoveryengineV1betaPurgeDocumentsRequest) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1betapurgedocumentsrequest = googleclouddiscoveryenginev1betapurgedocumentsrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response -// error from Do is the result of In-None-Match. -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. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) 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 *ProjectsLocationsCollectionsDataStoresBranchesDocumentsPurgeCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddiscoveryenginev1betapurgedocumentsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+parent}/documents:purge") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", 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, }) 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.branches.documents.purge" call. // Exactly one of *GoogleLongrunningOperation or error will be non-nil. // 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) { +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 { @@ -3689,23 +3880,26 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Do(opt } return ret, nil // { - // "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": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/branches/{branchesId}/operations/{operationsId}", - // "httpMethod": "GET", - // "id": "discoveryengine.projects.locations.collections.dataStores.branches.operations.get", + // "description": "Permanently deletes all selected Documents under a branch. This process is asynchronous. If the request is valid, the removal will be enquired and processed offlines. Depending on the number of Documents, this operation could take hours to complete. Before the operation completes, some Documents may still be returned by DocumentService.GetDocument or DocumentService.ListDocuments. To get a sample of Documents that would be deleted, set PurgeDocumentsRequest.force to false.", + // "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/branches/{branchesId}/documents:purge", + // "httpMethod": "POST", + // "id": "discoveryengine.projects.locations.collections.dataStores.branches.documents.purge", // "parameterOrder": [ - // "name" + // "parent" // ], // "parameters": { - // "name": { - // "description": "The name of the operation resource.", + // "parent": { + // "description": "Required. The parent resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.", // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/branches/[^/]+/operations/[^/]+$", + // "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/branches/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1beta/{+name}", + // "path": "v1beta/{+parent}/documents:purge", + // "request": { + // "$ref": "GoogleCloudDiscoveryengineV1betaPurgeDocumentsRequest" + // }, // "response": { // "$ref": "GoogleLongrunningOperation" // }, @@ -3716,9 +3910,9 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Do(opt } -// method id "discoveryengine.projects.locations.collections.dataStores.branches.operations.list": +// method id "discoveryengine.projects.locations.collections.dataStores.branches.operations.get": -type ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall struct { +type ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -3727,42 +3921,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`. +// 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's parent resource. -func (r *ProjectsLocationsCollectionsDataStoresBranchesOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { - c := &ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - 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 } -// 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 -} - // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -3772,7 +3945,7 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Field // getting updates only after the object has changed since the last // request. Use googleapi.IsNotModified to check whether the response // error from Do is the result of In-None-Match. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { c.ifNoneMatch_ = entityTag return c } @@ -3780,21 +3953,21 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) IfNon // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall { c.ctx_ = ctx return c } // Header returns an http.Header that can be modified by the caller to // add HTTP headers to the request. -func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) 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 *ProjectsLocationsCollectionsDataStoresBranchesOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { @@ -3807,7 +3980,7 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) doReq var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+name}/operations") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -3820,11 +3993,180 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) doReq return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.operations.list" call. -// Exactly one of *GoogleLongrunningListOperationsResponse or error will -// be non-nil. Any non-2xx status code is an error. Response headers are -// in either -// *GoogleLongrunningListOperationsResponse.ServerResponse.Header or (if +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.operations.get" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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) { + 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/branches/{branchesId}/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "discoveryengine.projects.locations.collections.dataStores.branches.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/branches/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta/{+name}", + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "discoveryengine.projects.locations.collections.dataStores.branches.operations.list": + +type ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall 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 *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 +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +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. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+name}/operations") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.operations.list" call. +// Exactly one of *GoogleLongrunningListOperationsResponse or error will +// be non-nil. 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. @@ -5416,6 +5758,213 @@ func (c *ProjectsLocationsCollectionsEnginesOperationsGetCall) Do(opts ...google } +// method id "discoveryengine.projects.locations.collections.engines.operations.list": + +type ProjectsLocationsCollectionsEnginesOperationsListCall 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 *ProjectsLocationsCollectionsEnginesOperationsService) List(name string) *ProjectsLocationsCollectionsEnginesOperationsListCall { + c := &ProjectsLocationsCollectionsEnginesOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsEnginesOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsEnginesOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsEnginesOperationsListCall { + 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 information. +func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesOperationsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsEnginesOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesOperationsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsEnginesOperationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+name}/operations") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.engines.operations.list" call. +// Exactly one of *GoogleLongrunningListOperationsResponse or error will +// be non-nil. 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 *ProjectsLocationsCollectionsEnginesOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, 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 := &GoogleLongrunningListOperationsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", + // "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/operations", + // "httpMethod": "GET", + // "id": "discoveryengine.projects.locations.collections.engines.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/[^/]+/collections/[^/]+/engines/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "pageSize": { + // "description": "The standard list page size.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The standard list page token.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1beta/{+name}/operations", + // "response": { + // "$ref": "GoogleLongrunningListOperationsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsCollectionsEnginesOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + // method id "discoveryengine.projects.locations.collections.operations.get": type ProjectsLocationsCollectionsOperationsGetCall struct { @@ -6742,6 +7291,157 @@ func (c *ProjectsLocationsDataStoresBranchesDocumentsPatchCall) Do(opts ...googl } +// method id "discoveryengine.projects.locations.dataStores.branches.documents.purge": + +type ProjectsLocationsDataStoresBranchesDocumentsPurgeCall struct { + s *Service + parent string + googleclouddiscoveryenginev1betapurgedocumentsrequest *GoogleCloudDiscoveryengineV1betaPurgeDocumentsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Purge: Permanently deletes all selected Documents under a branch. +// This process is asynchronous. If the request is valid, the removal +// will be enquired and processed offlines. Depending on the number of +// Documents, this operation could take hours to complete. Before the +// operation completes, some Documents may still be returned by +// DocumentService.GetDocument or DocumentService.ListDocuments. To get +// a sample of Documents that would be deleted, set +// PurgeDocumentsRequest.force to false. +// +// - parent: The parent resource name, such as +// `projects/{project}/locations/{location}/collections/{collection}/da +// taStores/{data_store}/branches/{branch}`. +func (r *ProjectsLocationsDataStoresBranchesDocumentsService) Purge(parent string, googleclouddiscoveryenginev1betapurgedocumentsrequest *GoogleCloudDiscoveryengineV1betaPurgeDocumentsRequest) *ProjectsLocationsDataStoresBranchesDocumentsPurgeCall { + c := &ProjectsLocationsDataStoresBranchesDocumentsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1betapurgedocumentsrequest = googleclouddiscoveryenginev1betapurgedocumentsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsDataStoresBranchesDocumentsPurgeCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataStoresBranchesDocumentsPurgeCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsDataStoresBranchesDocumentsPurgeCall) Context(ctx context.Context) *ProjectsLocationsDataStoresBranchesDocumentsPurgeCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsDataStoresBranchesDocumentsPurgeCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataStoresBranchesDocumentsPurgeCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleclouddiscoveryenginev1betapurgedocumentsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+parent}/documents:purge") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.dataStores.branches.documents.purge" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *ProjectsLocationsDataStoresBranchesDocumentsPurgeCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Permanently deletes all selected Documents under a branch. This process is asynchronous. If the request is valid, the removal will be enquired and processed offlines. Depending on the number of Documents, this operation could take hours to complete. Before the operation completes, some Documents may still be returned by DocumentService.GetDocument or DocumentService.ListDocuments. To get a sample of Documents that would be deleted, set PurgeDocumentsRequest.force to false.", + // "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/branches/{branchesId}/documents:purge", + // "httpMethod": "POST", + // "id": "discoveryengine.projects.locations.dataStores.branches.documents.purge", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The parent resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/branches/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta/{+parent}/documents:purge", + // "request": { + // "$ref": "GoogleCloudDiscoveryengineV1betaPurgeDocumentsRequest" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "discoveryengine.projects.locations.dataStores.branches.operations.get": type ProjectsLocationsDataStoresBranchesOperationsGetCall struct { diff --git a/displayvideo/v1/displayvideo-api.json b/displayvideo/v1/displayvideo-api.json index 1c893956b45..a326fa9692e 100644 --- a/displayvideo/v1/displayvideo-api.json +++ b/displayvideo/v1/displayvideo-api.json @@ -195,7 +195,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`.. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` Examples: * targetingType with value TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_CHANNEL\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=) operator`. Supported fields: * `targetingType` Examples: * targetingType with value TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_CHANNEL\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -302,7 +302,7 @@ "parameterOrder": [], "parameters": { "filter": { - "description": "Allows filtering by advertiser properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)`. * The operator must be `EQUALS (=)`. * Supported fields: - `advertiserId` - `displayName` - `entityStatus` - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All active advertisers under a partner: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` * All advertisers with an update time less than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All advertisers with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by advertiser fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. * A restriction has the form of `{field} {operator} {value}`. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `advertiserId` * `displayName` * `entityStatus` * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * All active advertisers under a partner: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` * All advertisers with an update time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All advertisers with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -448,7 +448,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` - `inheritance` Examples: * AssignedTargetingOptions of targeting type TARGETING_TYPE_LANGUAGE or TARGETING_TYPE_GENDER `targetingType=\"TARGETING_TYPE_LANGUAGE\" OR targetingType=\"TARGETING_TYPE_GENDER\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `targetingType` * `inheritance` Examples: * `AssignedTargetingOption` resources of targeting type `TARGETING_TYPE_LANGUAGE` or `TARGETING_TYPE_GENDER`: `targetingType=\"TARGETING_TYPE_LANGUAGE\" OR targetingType=\"TARGETING_TYPE_GENDER\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -597,7 +597,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by campaign properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)`. * The operator must be `EQUALS (=)`. * Supported fields: - `campaignId` - `displayName` - `entityStatus` - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` campaigns under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\")` * All campaigns with an update time less than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All campaigns with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by campaign fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `campaignId` * `displayName` * `entityStatus` * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` campaigns under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\")` * All campaigns with an update time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All campaigns with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -797,7 +797,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -853,7 +853,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` - `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` * `inheritance` Examples: * `AssignedTargetingOption` resources with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER` `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -957,7 +957,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -1087,7 +1087,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by channel fields. Supported syntax: * Filter expressions for channel currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All channels for which the display name contains \"google\": `displayName : \"google\"`. The length of this field should be no more than 500 characters.", + "description": "Allows filtering by channel fields. Supported syntax: * Filter expressions for channel can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All channels for which the display name contains \"google\": `displayName : \"google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -1330,7 +1330,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by site fields. Supported syntax: * Filter expressions for site currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `urlOrAppId` Examples: * All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"`", + "description": "Allows filtering by site fields. Supported syntax: * Filter expressions for site retrieval can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `urlOrAppId` Examples: * All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -1525,7 +1525,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by creative properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restriction for the same field must be combined by `OR`. * Restriction for different fields must be combined by `AND`. * Between `(` and `)` there can only be restrictions combined by `OR` for the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)` for the following fields: - `entityStatus` - `creativeType`. - `dimensions` - `minDuration` - `maxDuration` - `approvalStatus` - `exchangeReviewStatus` - `dynamic` - `creativeId` * The operator must be `HAS (:)` for the following fields: - `lineItemIds` * The operator must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` for the following fields: - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) * For `entityStatus`, `minDuration`, `maxDuration`, `updateTime`, and `dynamic`, there may be at most one restriction. * For `dimensions`, the value is in the form of `\"{width}x{height}\"`. * For `exchangeReviewStatus`, the value is in the form of `{exchange}-{reviewStatus}`. * For `minDuration` and `maxDuration`, the value is in the form of `\"{duration}s\"`. Only seconds are supported with millisecond granularity. * For `updateTime`, a creative resource's field value reflects the last time that a creative has been updated, which includes updates made by the system (e.g. creative review updates). * There may be multiple `lineItemIds` restrictions in order to search against multiple possible line item IDs. * There may be multiple `creativeId` restrictions in order to search against multiple possible creative IDs. Examples: * All native creatives: `creativeType=\"CREATIVE_TYPE_NATIVE\"` * All active creatives with 300x400 or 50x100 dimensions: `entityStatus=\"ENTITY_STATUS_ACTIVE\" AND (dimensions=\"300x400\" OR dimensions=\"50x100\")` * All dynamic creatives that are approved by AdX or AppNexus, with a minimum duration of 5 seconds and 200ms. `dynamic=\"true\" AND minDuration=\"5.2s\" AND (exchangeReviewStatus=\"EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED\" OR exchangeReviewStatus=\"EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED\")` * All video creatives that are associated with line item ID 1 or 2: `creativeType=\"CREATIVE_TYPE_VIDEO\" AND (lineItemIds:1 OR lineItemIds:2)` * Find creatives by multiple creative IDs: `creativeId=1 OR creativeId=2` * All creatives with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by creative fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `lineItemIds` field must use the `HAS (:)` operator. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * All other fields must use the `EQUALS (=)` operator. * For `entityStatus`, `minDuration`, `maxDuration`, `updateTime`, and `dynamic` fields, there may be at most one restriction. Supported Fields: * `approvalStatus` * `creativeId` * `creativeType` * `dimensions` (input in the form of `{width}x{height}`) * `dynamic` * `entityStatus` * `exchangeReviewStatus` (input in the form of `{exchange}-{reviewStatus}`) * `lineItemIds` * `maxDuration` (input in the form of `{duration}s`. Only seconds are supported) * `minDuration` (input in the form of `{duration}s`. Only seconds are supported) * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Notes: * For `updateTime`, a creative resource's field value reflects the last time that a creative has been updated, which includes updates made by the system (e.g. creative review updates). Examples: * All native creatives: `creativeType=\"CREATIVE_TYPE_NATIVE\"` * All active creatives with 300x400 or 50x100 dimensions: `entityStatus=\"ENTITY_STATUS_ACTIVE\" AND (dimensions=\"300x400\" OR dimensions=\"50x100\")` * All dynamic creatives that are approved by AdX or AppNexus, with a minimum duration of 5 seconds and 200ms: `dynamic=\"true\" AND minDuration=\"5.2s\" AND (exchangeReviewStatus=\"EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED\" OR exchangeReviewStatus=\"EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED\")` * All video creatives that are associated with line item ID 1 or 2: `creativeType=\"CREATIVE_TYPE_VIDEO\" AND (lineItemIds:1 OR lineItemIds:2)` * Find creatives by multiple creative IDs: `creativeId=1 OR creativeId=2` * All creatives with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -1621,7 +1621,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` - `inheritance` Examples: * AssignedTargetingOptions of targeting type TARGETING_TYPE_PROXIMITY_LOCATION_LIST or TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_PROXIMITY_LOCATION_LIST\" OR targetingType=\"TARGETING_TYPE_CHANNEL\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `targetingType` * `inheritance` Examples: * `AssignedTargetingOption` resources of targeting type `TARGETING_TYPE_PROXIMITY_LOCATION_LIST` or `TARGETING_TYPE_CHANNEL`: `targetingType=\"TARGETING_TYPE_PROXIMITY_LOCATION_LIST\" OR targetingType=\"TARGETING_TYPE_CHANNEL\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -1775,7 +1775,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by insertion order properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator used on `budget.budget_segments.date_range.end_date` must be LESS THAN (\u003c). * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)`. * The operators used on all other fields must be `EQUALS (=)`. * Supported fields: - `campaignId` - `displayName` - `entityStatus` - `budget.budget_segments.date_range.end_date` (input as YYYY-MM-DD) - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All insertion orders under a campaign: `campaignId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` insertion orders under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\")` * All insertion orders whose budget segments' dates end before March 28, 2019: `budget.budget_segments.date_range.end_date\u003c\"2019-03-28\"` * All insertion orders with an update time less than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All insertion orders with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by insertion order fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `budget.budget_segments.date_range.end_date` field must use the `LESS THAN (\u003c)` operator. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `campaignId` * `displayName` * `entityStatus` * `budget.budget_segments.date_range.end_date` (input in the form of `YYYY-MM-DD`) **Deprecated. Not available after June 8, 2023** * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * All insertion orders under a campaign: `campaignId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` insertion orders under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\")` * All insertion orders with an update time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All insertion orders with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -1973,7 +1973,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -2021,7 +2021,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` - `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` * `inheritance` Examples: * `AssignedTargetingOption` resources with ID 1 or 2: `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -2133,7 +2133,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -2320,7 +2320,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` - `inheritance` Examples: * AssignedTargetingOptions of targeting type TARGETING_TYPE_PROXIMITY_LOCATION_LIST or TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_PROXIMITY_LOCATION_LIST\" OR targetingType=\"TARGETING_TYPE_CHANNEL\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `targetingType` * `inheritance` Examples: * `AssignedTargetingOption` resources of targeting type `TARGETING_TYPE_PROXIMITY_LOCATION_LIST` or `TARGETING_TYPE_CHANNEL`: `targetingType=\"TARGETING_TYPE_PROXIMITY_LOCATION_LIST\" OR targetingType=\"TARGETING_TYPE_CHANNEL\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -2503,12 +2503,12 @@ "type": "string" }, "filter": { - "description": "Allows filtering by line item properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator used on `flight.dateRange.endDate` must be LESS THAN (\u003c). * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)`. * The operator used on `warningMessages` must be `HAS (:)`. * The operators used on all other fields must be `EQUALS (=)`. * Supported properties: - `campaignId` - `displayName` - `insertionOrderId` - `entityStatus` - `lineItemId` - `lineItemType` - `flight.dateRange.endDate` (input formatted as YYYY-MM-DD) - `warningMessages` - `flight.triggerId` - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) - `targetedChannelId` - `targetedNegativeKeywordListId` Examples: * All line items under an insertion order: `insertionOrderId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` and `LINE_ITEM_TYPE_DISPLAY_DEFAULT` line items under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\") AND lineItemType=\"LINE_ITEM_TYPE_DISPLAY_DEFAULT\"` * All line items whose flight dates end before March 28, 2019: `flight.dateRange.endDate\u003c\"2019-03-28\"` * All line items that have `NO_VALID_CREATIVE` in `warningMessages`: `warningMessages:\"NO_VALID_CREATIVE\"` * All line items with an update time less than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All line items with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` * All line items that are using both the specified channel and specified negative keyword list in their targeting: `targetedNegativeKeywordListId=789 AND targetedChannelId=12345` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by line item fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `flight.dateRange.endDate` field must use the `LESS THAN (\u003c)` operator. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * The `warningMessages` field must use the `HAS (:)` operator. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `campaignId` * `displayName` * `entityStatus` * `flight.dateRange.endDate` (input formatted as `YYYY-MM-DD`) **Deprecated. Not available after June 8, 2023** * `flight.triggerId` * `insertionOrderId` * `lineItemId` * `lineItemType` * `targetedChannelId` * `targetedNegativeKeywordListId` * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) * `warningMessages` Examples: * All line items under an insertion order: `insertionOrderId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` and `LINE_ITEM_TYPE_DISPLAY_DEFAULT` line items under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\") AND lineItemType=\"LINE_ITEM_TYPE_DISPLAY_DEFAULT\"` * All line items whose flight dates end before March 28, 2019: `flight.dateRange.endDate\u003c\"2019-03-28\"` * All line items that have `NO_VALID_CREATIVE` in `warningMessages`: `warningMessages:\"NO_VALID_CREATIVE\"` * All line items with an update time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All line items with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` * All line items that are using both the specified channel and specified negative keyword list in their targeting: `targetedNegativeKeywordListId=789 AND targetedChannelId=12345` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, "orderBy": { - "description": "Field by which to sort the list. Acceptable values are: * `displayName` (default) * `entityStatus` * `flight.dateRange.endDate` * `updateTime` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `displayName desc`.", + "description": "Field by which to sort the list. Acceptable values are: * `displayName` (default) * `entityStatus` * `flight.dateRange.endDate` **Deprecated. Not available after June 8, 2023** * `updateTime` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `displayName desc`.", "location": "query", "type": "string" }, @@ -2693,7 +2693,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -2843,7 +2843,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -2990,7 +2990,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -3038,7 +3038,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` - `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` * `inheritance` Examples: * `AssignedTargetingOption` resources with ID 1 or 2: `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -3150,7 +3150,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -3268,7 +3268,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by location list fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `locationType` Examples: * All regional location list: `locationType=\"TARGETING_LOCATION_TYPE_REGIONAL\"` * All proximity location list: `locationType=\"TARGETING_LOCATION_TYPE_PROXIMITY\"`", + "description": "Allows filtering by location list fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `locationType` Examples: * All regional location list: `locationType=\"TARGETING_LOCATION_TYPE_REGIONAL\"` * All proximity location list: `locationType=\"TARGETING_LOCATION_TYPE_PROXIMITY\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -3477,7 +3477,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by location list assignment fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedLocationId` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by location list assignment fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedLocationId` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -3520,7 +3520,7 @@ "manualTriggers": { "methods": { "activate": { - "description": "Activates a manual trigger. Each activation of the manual trigger must be at least 5 minutes apart, otherwise an error will be returned.", + "description": "Activates a manual trigger. Each activation of the manual trigger must be at least 5 minutes apart, otherwise an error will be returned. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", "flatPath": "v1/advertisers/{advertisersId}/manualTriggers/{manualTriggersId}:activate", "httpMethod": "POST", "id": "displayvideo.advertisers.manualTriggers.activate", @@ -3558,7 +3558,7 @@ ] }, "create": { - "description": "Creates a new manual trigger. Returns the newly created manual trigger if successful.", + "description": "Creates a new manual trigger. Returns the newly created manual trigger if successful. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", "flatPath": "v1/advertisers/{advertisersId}/manualTriggers", "httpMethod": "POST", "id": "displayvideo.advertisers.manualTriggers.create", @@ -3587,7 +3587,7 @@ ] }, "deactivate": { - "description": "Deactivates a manual trigger.", + "description": "Deactivates a manual trigger. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", "flatPath": "v1/advertisers/{advertisersId}/manualTriggers/{manualTriggersId}:deactivate", "httpMethod": "POST", "id": "displayvideo.advertisers.manualTriggers.deactivate", @@ -3625,7 +3625,7 @@ ] }, "get": { - "description": "Gets a manual trigger.", + "description": "Gets a manual trigger. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", "flatPath": "v1/advertisers/{advertisersId}/manualTriggers/{manualTriggersId}", "httpMethod": "GET", "id": "displayvideo.advertisers.manualTriggers.get", @@ -3660,7 +3660,7 @@ ] }, "list": { - "description": "Lists manual triggers that are accessible to the current user for a given advertiser ID. The order is defined by the order_by parameter. A single advertiser_id is required.", + "description": "Lists manual triggers that are accessible to the current user for a given advertiser ID. The order is defined by the order_by parameter. A single advertiser_id is required. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", "flatPath": "v1/advertisers/{advertisersId}/manualTriggers", "httpMethod": "GET", "id": "displayvideo.advertisers.manualTriggers.list", @@ -3677,7 +3677,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by manual trigger properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `displayName` - `state` Examples: * All active manual triggers under an advertiser: `state=\"ACTIVE\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by manual trigger fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `displayName` * `state` Examples: * All active manual triggers under an advertiser: `state=\"ACTIVE\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -3707,7 +3707,7 @@ ] }, "patch": { - "description": "Updates a manual trigger. Returns the updated manual trigger if successful.", + "description": "Updates a manual trigger. Returns the updated manual trigger if successful. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", "flatPath": "v1/advertisers/{advertisersId}/manualTriggers/{manualTriggersId}", "httpMethod": "PATCH", "id": "displayvideo.advertisers.manualTriggers.patch", @@ -4072,7 +4072,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by negative keyword fields. Supported syntax: * Filter expressions for negative keyword currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `keywordValue` Examples: * All negative keywords for which the keyword value contains \"google\": `keywordValue : \"google\"`", + "description": "Allows filtering by negative keyword fields. Supported syntax: * Filter expressions for negative keywords can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `keywordValue` Examples: * All negative keywords for which the keyword value contains \"google\": `keywordValue : \"google\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -4256,7 +4256,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -4397,7 +4397,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -4535,7 +4535,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -4582,7 +4582,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` Examples: * AssignedTargetingOption with ID 123456 `assignedTargetingOptionId=\"123456\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` Examples: * `AssignedTargetingOption` with ID 123456: `assignedTargetingOptionId=\"123456\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -4686,7 +4686,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -4774,7 +4774,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by combined audience fields. Supported syntax: * Filter expressions for combined audiences currently can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All combined audiences for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters.", + "description": "Allows filtering by combined audience fields. Supported syntax: * Filter expressions for combined audiences can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All combined audiences for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -4883,7 +4883,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by custom bidding algorithm fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND`. A sequence of restrictions * implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)` or `EQUALS (=)`. * The operator must be `CONTAINS (:)` for the following field: - `displayName` * The operator must be `EQUALS (=)` for the following field: - `customBiddingAlgorithmType` * For `displayName`, the value is a string. We return all custom bidding algorithms whose display_name contains such string. * For `customBiddingAlgorithmType`, the value is a string. We return all algorithms whose custom_bidding_algorithm_type is equal to the given type. Examples: * All custom bidding algorithms for which the display name contains \"politics\": `displayName:politics`. * All custom bidding algorithms for which the type is \"SCRIPT_BASED\": `customBiddingAlgorithmType=SCRIPT_BASED` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by custom bidding algorithm fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND`. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `customBiddingAlgorithmType` field must use the `EQUALS (=)` operator. * The `displayName` field must use the `HAS (:)` operator. Supported fields: * `customBiddingAlgorithmType` * `displayName` Examples: * All custom bidding algorithms for which the display name contains \"politics\": `displayName:\"politics\"`. * All custom bidding algorithms for which the type is \"SCRIPT_BASED\": `customBiddingAlgorithmType=SCRIPT_BASED` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -5189,7 +5189,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by custom list fields. Supported syntax: * Filter expressions for custom lists currently can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All custom lists for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters.", + "description": "Allows filtering by custom list fields. Supported syntax: * Filter expressions for custom lists can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All custom lists for which the display name contains \"Google\": `displayName:\"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -5328,7 +5328,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by first and third party audience fields. Supported syntax: * Filter expressions for first and third party audiences currently can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All first and third party audiences for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters.", + "description": "Allows filtering by first and third party audience fields. Supported syntax: * Filter expressions for first and third party audiences can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All first and third party audiences for which the display name contains \"Google\": `displayName:\"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -5536,7 +5536,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by Google audience fields. Supported syntax: * Filter expressions for Google audiences currently can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All Google audiences for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters.", + "description": "Allows filtering by Google audience fields. Supported syntax: * Filter expressions for Google audiences can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All Google audiences for which the display name contains \"Google\": `displayName:\"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -5685,7 +5685,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by guaranteed order properties. * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `guaranteed_order_id` - `exchange` - `display_name` - `status.entityStatus` Examples: * All active guaranteed orders: `status.entityStatus=\"ENTITY_STATUS_ACTIVE\"` * Guaranteed orders belonging to Google Ad Manager or Rubicon exchanges: `exchange=\"EXCHANGE_GOOGLE_AD_MANAGER\" OR exchange=\"EXCHANGE_RUBICON\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by guaranteed order fields. * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `guaranteed_order_id` * `exchange` * `display_name` * `status.entityStatus` Examples: * All active guaranteed orders: `status.entityStatus=\"ENTITY_STATUS_ACTIVE\"` * Guaranteed orders belonging to Google Ad Manager or Rubicon exchanges: `exchange=\"EXCHANGE_GOOGLE_AD_MANAGER\" OR exchange=\"EXCHANGE_RUBICON\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -5891,7 +5891,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by inventory source group properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `inventorySourceGroupId` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by inventory source group fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `inventorySourceGroupId` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -6109,7 +6109,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned inventory source fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedInventorySourceId` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned inventory source fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedInventorySourceId` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -6264,7 +6264,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by inventory source properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `status.entityStatus` - `commitment` - `deliveryMethod` - `rateDetails.rateType` - `exchange` Examples: * All active inventory sources: `status.entityStatus=\"ENTITY_STATUS_ACTIVE\"` * Inventory sources belonging to Google Ad Manager or Rubicon exchanges: `exchange=\"EXCHANGE_GOOGLE_AD_MANAGER\" OR exchange=\"EXCHANGE_RUBICON\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by inventory source fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `status.entityStatus` * `commitment` * `deliveryMethod` * `rateDetails.rateType` * `exchange` Examples: * All active inventory sources: `status.entityStatus=\"ENTITY_STATUS_ACTIVE\"` * Inventory sources belonging to Google Ad Manager or Rubicon exchanges: `exchange=\"EXCHANGE_GOOGLE_AD_MANAGER\" OR exchange=\"EXCHANGE_RUBICON\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -6485,7 +6485,7 @@ "parameterOrder": [], "parameters": { "filter": { - "description": "Allows filtering by partner properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `entityStatus` Examples: * All active partners: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by partner fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `entityStatus` Examples: * All active partners: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -6610,7 +6610,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by channel fields. Supported syntax: * Filter expressions for channel currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All channels for which the display name contains \"google\": `displayName : \"google\"`. The length of this field should be no more than 500 characters.", + "description": "Allows filtering by channel fields. Supported syntax: * Filter expressions for channel can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All channels for which the display name contains \"google\": `displayName : \"google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -6853,7 +6853,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by site fields. Supported syntax: * Filter expressions for site currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `urlOrAppId` Examples: * All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"`", + "description": "Allows filtering by site fields. Supported syntax: * Filter expressions for site retrieval can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `urlOrAppId` Examples: * All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -7037,7 +7037,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -7178,7 +7178,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -7316,7 +7316,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -7355,7 +7355,7 @@ ], "parameters": { "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` Examples: * AssignedTargetingOption with ID 123456 `assignedTargetingOptionId=\"123456\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` Examples: * `AssignedTargetingOption` resource with ID 123456: `assignedTargetingOptionId=\"123456\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -7467,7 +7467,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -7666,7 +7666,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -7710,7 +7710,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `OR` logical operators. * A restriction has the form of `{field} {operator} {value}`. * The operator must be \"=\" (equal sign). * Supported fields: - `carrierAndIspDetails.type` - `geoRegionDetails.geoRegionType` - `targetingOptionId` Examples: * All `GEO REGION` targeting options that belong to sub type `GEO_REGION_TYPE_COUNTRY` or `GEO_REGION_TYPE_STATE`: `geoRegionDetails.geoRegionType=\"GEO_REGION_TYPE_COUNTRY\" OR geoRegionDetails.geoRegionType=\"GEO_REGION_TYPE_STATE\"` * All `CARRIER AND ISP` targeting options that belong to sub type `CARRIER_AND_ISP_TYPE_CARRIER`: `carrierAndIspDetails.type=\"CARRIER_AND_ISP_TYPE_CARRIER\"`. The length of this field should be no more than 500 characters.", + "description": "Allows filtering by targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `OR` logical operators. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `carrierAndIspDetails.type` * `geoRegionDetails.geoRegionType` * `targetingOptionId` Examples: * All `GEO REGION` targeting options that belong to sub type `GEO_REGION_TYPE_COUNTRY` or `GEO_REGION_TYPE_STATE`: `geoRegionDetails.geoRegionType=\"GEO_REGION_TYPE_COUNTRY\" OR geoRegionDetails.geoRegionType=\"GEO_REGION_TYPE_STATE\"` * All `CARRIER AND ISP` targeting options that belong to sub type `CARRIER_AND_ISP_TYPE_CARRIER`: `carrierAndIspDetails.type=\"CARRIER_AND_ISP_TYPE_CARRIER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -7814,7 +7814,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -7935,7 +7935,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -7973,7 +7973,7 @@ "users": { "methods": { "bulkEditAssignedUserRoles": { - "description": "Bulk edits user roles for a user. The operation will delete the assigned user roles provided in BulkEditAssignedUserRolesRequest.deletedAssignedUserRoles and then assign the user roles provided in BulkEditAssignedUserRolesRequest.createdAssignedUserRoles.", + "description": "Bulk edits user roles for a user. The operation will delete the assigned user roles provided in BulkEditAssignedUserRolesRequest.deletedAssignedUserRoles and then assign the user roles provided in BulkEditAssignedUserRolesRequest.createdAssignedUserRoles. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", "flatPath": "v1/users/{usersId}:bulkEditAssignedUserRoles", "httpMethod": "POST", "id": "displayvideo.users.bulkEditAssignedUserRoles", @@ -8002,7 +8002,7 @@ ] }, "create": { - "description": "Creates a new user. Returns the newly created user if successful.", + "description": "Creates a new user. Returns the newly created user if successful. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", "flatPath": "v1/users", "httpMethod": "POST", "id": "displayvideo.users.create", @@ -8020,7 +8020,7 @@ ] }, "delete": { - "description": "Deletes a user.", + "description": "Deletes a user. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", "flatPath": "v1/users/{usersId}", "httpMethod": "DELETE", "id": "displayvideo.users.delete", @@ -8046,7 +8046,7 @@ ] }, "get": { - "description": "Gets a user.", + "description": "Gets a user. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", "flatPath": "v1/users/{usersId}", "httpMethod": "GET", "id": "displayvideo.users.get", @@ -8072,14 +8072,14 @@ ] }, "list": { - "description": "Lists users that are accessible to the current user. If two users have user roles on the same partner or advertiser, they can access each other.", + "description": "Lists users that are accessible to the current user. If two users have user roles on the same partner or advertiser, they can access each other. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", "flatPath": "v1/users", "httpMethod": "GET", "id": "displayvideo.users.list", "parameterOrder": [], "parameters": { "filter": { - "description": "Allows filtering by user properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)` or `EQUALS (=)`. * The operator must be `CONTAINS (:)` for the following fields: - `displayName` - `email` * The operator must be `EQUALS (=)` for the following fields: - `assignedUserRole.userRole` - `assignedUserRole.partnerId` - `assignedUserRole.advertiserId` - `assignedUserRole.entityType`: A synthetic field of AssignedUserRole used for filtering. Identifies the type of entity to which the user role is assigned. Valid values are `Partner` and `Advertiser`. - `assignedUserRole.parentPartnerId`: A synthetic field of AssignedUserRole used for filtering. Identifies the parent partner of the entity to which the user role is assigned.\" Examples: * The user with displayName containing `foo`: `displayName:\"foo\"` * The user with email containing `bar`: `email:\"bar\"` * All users with standard user roles: `assignedUserRole.userRole=\"STANDARD\"` * All users with user roles for partner 123: `assignedUserRole.partnerId=\"123\"` * All users with user roles for advertiser 123: `assignedUserRole.advertiserId=\"123\"` * All users with partner level user roles: `entityType=\"PARTNER\"` * All users with user roles for partner 123 and advertisers under partner 123: `parentPartnerId=\"123\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by user fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `budget.budget_segments.date_range.end_date` field must use the `LESS THAN (\u003c)` operator. * The `displayName and `email` field must use the `HAS (:)` operator. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `assignedUserRole.advertiserId` * `assignedUserRole.entityType` * This is synthetic field of `AssignedUserRole` used for filtering. Identifies the type of entity to which the user role is assigned. Valid values are `Partner` and `Advertiser`. * `assignedUserRole.parentPartnerId` * This is a synthetic field of `AssignedUserRole` used for filtering. Identifies the parent partner of the entity to which the user role is assigned. * `assignedUserRole.partnerId` * `assignedUserRole.userRole` * `displayName` * `email` Examples: * The user with `displayName` containing \"foo\": `displayName:\"foo\"` * The user with `email` containing \"bar\": `email:\"bar\"` * All users with standard user roles: `assignedUserRole.userRole=\"STANDARD\"` * All users with user roles for partner 123: `assignedUserRole.partnerId=\"123\"` * All users with user roles for advertiser 123: `assignedUserRole.advertiserId=\"123\"` * All users with partner level user roles: `entityType=\"PARTNER\"` * All users with user roles for partner 123 and advertisers under partner 123: `parentPartnerId=\"123\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -8109,7 +8109,7 @@ ] }, "patch": { - "description": "Updates an existing user. Returns the updated user if successful.", + "description": "Updates an existing user. Returns the updated user if successful. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", "flatPath": "v1/users/{usersId}", "httpMethod": "PATCH", "id": "displayvideo.users.patch", @@ -8146,7 +8146,7 @@ } } }, - "revision": "20230420", + "revision": "20230504", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActivateManualTriggerRequest": { @@ -9020,7 +9020,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -9120,11 +9120,11 @@ "properties": { "excludedFirstAndThirdPartyAudienceGroup": { "$ref": "FirstAndThirdPartyAudienceGroup", - "description": "The first and third party audience ids and recencies of the excluded first and third party audience group. Used for negative targeting. The COMPLEMENT of the UNION of this group and other excluded audience groups is used as an INTERSECTION to any positive audience targeting. All items are logically ‘OR’ of each other." + "description": "The first and third party audience ids and recencies of the excluded first and third party audience group. Used for negative targeting. The COMPLEMENT of the UNION of this group and other excluded audience groups is used as an INTERSECTION to any positive audience targeting. All items are logically ‘OR’ of each other. **Warning:** `ACTIVITY_BASED` and `FREQUENCY_CAP` audience types will be deprecated on **May 20, 2023**. After this date, these audiences will not be able to be added to resource targeting. Read our [feature deprecation announcement](/display-video/api/deprecations#features.first_and_third_party_audience_types) for more information." }, "excludedGoogleAudienceGroup": { "$ref": "GoogleAudienceGroup", - "description": "The Google audience ids of the excluded Google audience group. Used for negative targeting. The COMPLEMENT of the UNION of this group and other excluded audience groups is used as an INTERSECTION to any positive audience targeting. Only contains Affinity, In-market and Installed-apps type Google audiences. All items are logically ‘OR’ of each other." + "description": "The Google audience ids of the excluded Google audience group. Used for negative targeting. The COMPLEMENT of the UNION of this group and other excluded audience groups is used as an INTERSECTION to any positive audience targeting. Only contains Affinity, In-market and Installed-apps type Google audiences. All items are logically ‘OR’ of each other. **Warning:** `GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS` and `GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES` audience types will be deprecated on **May 20, 2023**. After this date, these audiences will not be able to be added to resource targeting. Read our [feature deprecation announcement](/display-video/api/deprecations#features.google_audience_types) for more information." }, "includedCombinedAudienceGroup": { "$ref": "CombinedAudienceGroup", @@ -9135,7 +9135,7 @@ "description": "The custom list ids of the included custom list group. Contains custom list ids only." }, "includedFirstAndThirdPartyAudienceGroups": { - "description": "The first and third party audience ids and recencies of included first and third party audience groups. Each first and third party audience group contains first and third party audience ids only. The relation between each first and third party audience group is INTERSECTION, and the result is UNION'ed with other audience groups. Repeated groups with same settings will be ignored.", + "description": "The first and third party audience ids and recencies of included first and third party audience groups. Each first and third party audience group contains first and third party audience ids only. The relation between each first and third party audience group is INTERSECTION, and the result is UNION'ed with other audience groups. Repeated groups with same settings will be ignored. **Warning:** `ACTIVITY_BASED` and `FREQUENCY_CAP` audience types will be deprecated on **May 20, 2023**. After this date, these audiences will not be able to be added to resource targeting. Read our [feature deprecation announcement](/display-video/api/deprecations#features.first_and_third_party_audience_types) for more information.", "items": { "$ref": "FirstAndThirdPartyAudienceGroup" }, @@ -9143,7 +9143,7 @@ }, "includedGoogleAudienceGroup": { "$ref": "GoogleAudienceGroup", - "description": "The Google audience ids of the included Google audience group. Contains Google audience ids only." + "description": "The Google audience ids of the included Google audience group. Contains Google audience ids only. **Warning:** `GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS` and `GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES` audience types will be deprecated on **May 20, 2023**. After this date, these audiences will not be able to be added to resource targeting. Read our [feature deprecation announcement](/display-video/api/deprecations#features.google_audience_types) for more information." } }, "type": "object" @@ -9268,7 +9268,7 @@ "type": "object" }, "AuthorizedSellerStatusAssignedTargetingOptionDetails": { - "description": "Represents an assigned authorized seller status. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`.", + "description": "Represents an assigned authorized seller status. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`. If a resource does not have an `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS` assigned targeting option, it is using the \"Authorized Direct Sellers and Resellers\" option.", "id": "AuthorizedSellerStatusAssignedTargetingOptionDetails", "properties": { "authorizedSellerStatus": { @@ -9279,9 +9279,9 @@ "AUTHORIZED_SELLER_STATUS_AUTHORIZED_AND_NON_PARTICIPATING_PUBLISHERS" ], "enumDescriptions": [ - "Default value when authorized seller status is not specified in this version. This enum is a placeholder for default value and does not represent a real authorized seller status option.", - "Only authorized sellers that directly own the inventory being monetized, as indicated by a DIRECT declaration in the ads.txt file.", - "All authorized sellers, including publishers that have not posted an ads.txt file. Display \u0026 Video 360 automatically disallows unauthorized sellers." + "Default value when authorized seller status is not specified in this version. This enum is a placeholder for the default value, or \"Authorized Direct Sellers and Resellers\" in the UI.", + "Only authorized sellers that directly own the inventory being monetized, as indicated by a DIRECT declaration in the ads.txt file. This value is equivalent to \"Authorized Direct Sellers\" in the UI.", + "All authorized sellers, including publishers that have not posted an ads.txt file. Display \u0026 Video 360 automatically disallows unauthorized sellers. This value is equivalent to \"Authorized and Non-Participating Publishers\" in the UI." ], "readOnly": true, "type": "string" @@ -9305,9 +9305,9 @@ "AUTHORIZED_SELLER_STATUS_AUTHORIZED_AND_NON_PARTICIPATING_PUBLISHERS" ], "enumDescriptions": [ - "Default value when authorized seller status is not specified in this version. This enum is a placeholder for default value and does not represent a real authorized seller status option.", - "Only authorized sellers that directly own the inventory being monetized, as indicated by a DIRECT declaration in the ads.txt file.", - "All authorized sellers, including publishers that have not posted an ads.txt file. Display \u0026 Video 360 automatically disallows unauthorized sellers." + "Default value when authorized seller status is not specified in this version. This enum is a placeholder for the default value, or \"Authorized Direct Sellers and Resellers\" in the UI.", + "Only authorized sellers that directly own the inventory being monetized, as indicated by a DIRECT declaration in the ads.txt file. This value is equivalent to \"Authorized Direct Sellers\" in the UI.", + "All authorized sellers, including publishers that have not posted an ads.txt file. Display \u0026 Video 360 automatically disallows unauthorized sellers. This value is equivalent to \"Authorized and Non-Participating Publishers\" in the UI." ], "readOnly": true, "type": "string" @@ -10829,7 +10829,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -11766,7 +11766,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -13117,8 +13117,8 @@ "Audience was generated through matching customers to known contact information.", "Audience was generated through matching customers to known Mobile device IDs.", "Audience was generated through matching customers to known User IDs.", - "Audience was created based on campaign activity.", - "Audience was created based on excluding the number of impressions they were served.", + "Audience was created based on campaign activity. **Warning:** This audience type will be deprecated on **May 20, 2023**. After this date, these audiences will not be able to be added to resource targeting. Read our [feature deprecation announcement](/display-video/api/deprecations#features.first_and_third_party_audience_types) for more information.", + "Audience was created based on excluding the number of impressions they were served. **Warning:** This audience type will be deprecated on **May 20, 2023**. After this date, these audiences will not be able to be added to resource targeting. Read our [feature deprecation announcement](/display-video/api/deprecations#features.first_and_third_party_audience_types) for more information.", "Audience was created based on custom variables attached to pixel.", "Audience was created based on past interactions with videos, YouTube ads, or YouTube channel.", "Subtype of third party audience type." @@ -13717,8 +13717,8 @@ "Default value when type is not specified or is unknown.", "Affinity type Google audience.", "In-Market type Google audience.", - "Installed-Apps type Google audience.", - "New-Mobile-Devices type Google audience.", + "Installed-Apps type Google audience. **Warning:** This audience type will be deprecated on **May 20, 2023**. After this date, these audiences will not be able to be added to resource targeting. Read our [feature deprecation announcement](/display-video/api/deprecations#features.google_audience_types) for more information.", + "New-Mobile-Devices type Google audience. **Warning:** This audience type will be deprecated on **May 20, 2023**. After this date, these audiences will not be able to be added to resource targeting. Read our [feature deprecation announcement](/display-video/api/deprecations#features.google_audience_types) for more information.", "Life-Event type Google audience.", "Extended-Demographic type Google audience." ], @@ -15550,12 +15550,12 @@ "Type value is not specified or is unknown in this version.", "The line item's flight dates are inherited from its parent insertion order.", "The line item uses its own custom flight dates.", - "The line item uses a trigger." + "The line item uses a trigger. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information." ], "type": "string" }, "triggerId": { - "description": "The ID of the manual trigger associated with the line item. * Required when flight_date_type is `LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER`. Must not be set otherwise. * When set, the line item's flight dates are inherited from its parent insertion order. * Active line items will spend when the selected trigger is activated within the parent insertion order's flight dates.", + "description": "The ID of the manual trigger associated with the line item. * Required when flight_date_type is `LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER`. Must not be set otherwise. * When set, the line item's flight dates are inherited from its parent insertion order. * Active line items will spend when the selected trigger is activated within the parent insertion order's flight dates. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", "format": "int64", "type": "string" } @@ -16169,7 +16169,7 @@ "type": "object" }, "ManualTrigger": { - "description": "A single manual trigger in Display \u0026 Video 360.", + "description": "A single manual trigger in Display \u0026 Video 360. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", "id": "ManualTrigger", "properties": { "activationDurationMinutes": { @@ -18210,7 +18210,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", diff --git a/displayvideo/v1/displayvideo-gen.go b/displayvideo/v1/displayvideo-gen.go index 44ed0092b83..079e6d28a43 100644 --- a/displayvideo/v1/displayvideo-gen.go +++ b/displayvideo/v1/displayvideo-gen.go @@ -1939,7 +1939,9 @@ type AssignedTargetingOption struct { // "TARGETING_TYPE_LANGUAGE" - Target ads to a specific language (for // example, English or Japanese). // "TARGETING_TYPE_AUTHORIZED_SELLER_STATUS" - Target ads to ads.txt - // authorized sellers. + // authorized sellers. If no targeting option of this type is assigned, + // the resource uses the "Authorized Direct Sellers and Resellers" + // option by default. // "TARGETING_TYPE_GEO_REGION" - Target ads to a specific regional // location (for example, a city or state). // "TARGETING_TYPE_INVENTORY_SOURCE_GROUP" - Purchase impressions from @@ -2118,7 +2120,12 @@ type AudienceGroupAssignedTargetingOptionDetails struct { // audience group. Used for negative targeting. The COMPLEMENT of the // UNION of this group and other excluded audience groups is used as an // INTERSECTION to any positive audience targeting. All items are - // logically ‘OR’ of each other. + // logically ‘OR’ of each other. **Warning:** `ACTIVITY_BASED` and + // `FREQUENCY_CAP` audience types will be deprecated on **May 20, + // 2023**. After this date, these audiences will not be able to be added + // to resource targeting. Read our feature deprecation announcement + // (/display-video/api/deprecations#features.first_and_third_party_audien + // ce_types) for more information. ExcludedFirstAndThirdPartyAudienceGroup *FirstAndThirdPartyAudienceGroup `json:"excludedFirstAndThirdPartyAudienceGroup,omitempty"` // ExcludedGoogleAudienceGroup: The Google audience ids of the excluded @@ -2126,7 +2133,14 @@ type AudienceGroupAssignedTargetingOptionDetails struct { // the UNION of this group and other excluded audience groups is used as // an INTERSECTION to any positive audience targeting. Only contains // Affinity, In-market and Installed-apps type Google audiences. All - // items are logically ‘OR’ of each other. + // items are logically ‘OR’ of each other. **Warning:** + // `GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS` and + // `GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES` audience types will be + // deprecated on **May 20, 2023**. After this date, these audiences will + // not be able to be added to resource targeting. Read our feature + // deprecation announcement + // (/display-video/api/deprecations#features.google_audience_types) for + // more information. ExcludedGoogleAudienceGroup *GoogleAudienceGroup `json:"excludedGoogleAudienceGroup,omitempty"` // IncludedCombinedAudienceGroup: The combined audience ids of the @@ -2144,11 +2158,23 @@ type AudienceGroupAssignedTargetingOptionDetails struct { // third party audience ids only. The relation between each first and // third party audience group is INTERSECTION, and the result is // UNION'ed with other audience groups. Repeated groups with same - // settings will be ignored. + // settings will be ignored. **Warning:** `ACTIVITY_BASED` and + // `FREQUENCY_CAP` audience types will be deprecated on **May 20, + // 2023**. After this date, these audiences will not be able to be added + // to resource targeting. Read our feature deprecation announcement + // (/display-video/api/deprecations#features.first_and_third_party_audien + // ce_types) for more information. IncludedFirstAndThirdPartyAudienceGroups []*FirstAndThirdPartyAudienceGroup `json:"includedFirstAndThirdPartyAudienceGroups,omitempty"` // IncludedGoogleAudienceGroup: The Google audience ids of the included // Google audience group. Contains Google audience ids only. + // **Warning:** `GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS` and + // `GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES` audience types will be + // deprecated on **May 20, 2023**. After this date, these audiences will + // not be able to be added to resource targeting. Read our feature + // deprecation announcement + // (/display-video/api/deprecations#features.google_audience_types) for + // more information. IncludedGoogleAudienceGroup *GoogleAudienceGroup `json:"includedGoogleAudienceGroup,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -2385,7 +2411,10 @@ func (s *AuditAdvertiserResponse) MarshalJSON() ([]byte, error) { // AuthorizedSellerStatusAssignedTargetingOptionDetails: Represents an // assigned authorized seller status. This will be populated in the // details field of an AssignedTargetingOption when targeting_type is -// `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`. +// `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`. If a resource does not +// have an `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS` assigned targeting +// option, it is using the "Authorized Direct Sellers and Resellers" +// option. type AuthorizedSellerStatusAssignedTargetingOptionDetails struct { // AuthorizedSellerStatus: Output only. The authorized seller status to // target. @@ -2393,16 +2422,18 @@ type AuthorizedSellerStatusAssignedTargetingOptionDetails struct { // Possible values: // "AUTHORIZED_SELLER_STATUS_UNSPECIFIED" - Default value when // authorized seller status is not specified in this version. This enum - // is a placeholder for default value and does not represent a real - // authorized seller status option. + // is a placeholder for the default value, or "Authorized Direct Sellers + // and Resellers" in the UI. // "AUTHORIZED_SELLER_STATUS_AUTHORIZED_DIRECT_SELLERS_ONLY" - Only // authorized sellers that directly own the inventory being monetized, - // as indicated by a DIRECT declaration in the ads.txt file. + // as indicated by a DIRECT declaration in the ads.txt file. This value + // is equivalent to "Authorized Direct Sellers" in the UI. // // "AUTHORIZED_SELLER_STATUS_AUTHORIZED_AND_NON_PARTICIPATING_PUBLISHERS" // - All authorized sellers, including publishers that have not posted // an ads.txt file. Display & Video 360 automatically disallows - // unauthorized sellers. + // unauthorized sellers. This value is equivalent to "Authorized and + // Non-Participating Publishers" in the UI. AuthorizedSellerStatus string `json:"authorizedSellerStatus,omitempty"` // TargetingOptionId: Required. The targeting_option_id of a @@ -2444,16 +2475,18 @@ type AuthorizedSellerStatusTargetingOptionDetails struct { // Possible values: // "AUTHORIZED_SELLER_STATUS_UNSPECIFIED" - Default value when // authorized seller status is not specified in this version. This enum - // is a placeholder for default value and does not represent a real - // authorized seller status option. + // is a placeholder for the default value, or "Authorized Direct Sellers + // and Resellers" in the UI. // "AUTHORIZED_SELLER_STATUS_AUTHORIZED_DIRECT_SELLERS_ONLY" - Only // authorized sellers that directly own the inventory being monetized, - // as indicated by a DIRECT declaration in the ads.txt file. + // as indicated by a DIRECT declaration in the ads.txt file. This value + // is equivalent to "Authorized Direct Sellers" in the UI. // // "AUTHORIZED_SELLER_STATUS_AUTHORIZED_AND_NON_PARTICIPATING_PUBLISHERS" // - All authorized sellers, including publishers that have not posted // an ads.txt file. Display & Video 360 automatically disallows - // unauthorized sellers. + // unauthorized sellers. This value is equivalent to "Authorized and + // Non-Participating Publishers" in the UI. AuthorizedSellerStatus string `json:"authorizedSellerStatus,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -5093,7 +5126,9 @@ type CreateAssignedTargetingOptionsRequest struct { // "TARGETING_TYPE_LANGUAGE" - Target ads to a specific language (for // example, English or Japanese). // "TARGETING_TYPE_AUTHORIZED_SELLER_STATUS" - Target ads to ads.txt - // authorized sellers. + // authorized sellers. If no targeting option of this type is assigned, + // the resource uses the "Authorized Direct Sellers and Resellers" + // option by default. // "TARGETING_TYPE_GEO_REGION" - Target ads to a specific regional // location (for example, a city or state). // "TARGETING_TYPE_INVENTORY_SOURCE_GROUP" - Purchase impressions from @@ -6338,7 +6373,9 @@ type DeleteAssignedTargetingOptionsRequest struct { // "TARGETING_TYPE_LANGUAGE" - Target ads to a specific language (for // example, English or Japanese). // "TARGETING_TYPE_AUTHORIZED_SELLER_STATUS" - Target ads to ads.txt - // authorized sellers. + // authorized sellers. If no targeting option of this type is assigned, + // the resource uses the "Authorized Direct Sellers and Resellers" + // option by default. // "TARGETING_TYPE_GEO_REGION" - Target ads to a specific regional // location (for example, a city or state). // "TARGETING_TYPE_INVENTORY_SOURCE_GROUP" - Purchase impressions from @@ -7907,8 +7944,18 @@ type FirstAndThirdPartyAudience struct { // "CUSTOMER_MATCH_USER_ID" - Audience was generated through matching // customers to known User IDs. // "ACTIVITY_BASED" - Audience was created based on campaign activity. + // **Warning:** This audience type will be deprecated on **May 20, + // 2023**. After this date, these audiences will not be able to be added + // to resource targeting. Read our [feature deprecation + // announcement](/display-video/api/deprecations#features.first_and_third + // _party_audience_types) for more information. // "FREQUENCY_CAP" - Audience was created based on excluding the - // number of impressions they were served. + // number of impressions they were served. **Warning:** This audience + // type will be deprecated on **May 20, 2023**. After this date, these + // audiences will not be able to be added to resource targeting. Read + // our [feature deprecation + // announcement](/display-video/api/deprecations#features.first_and_third + // _party_audience_types) for more information. // "TAG_BASED" - Audience was created based on custom variables // attached to pixel. // "YOUTUBE_USERS" - Audience was created based on past interactions @@ -8678,9 +8725,17 @@ type GoogleAudience struct { // "GOOGLE_AUDIENCE_TYPE_AFFINITY" - Affinity type Google audience. // "GOOGLE_AUDIENCE_TYPE_IN_MARKET" - In-Market type Google audience. // "GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS" - Installed-Apps type Google - // audience. + // audience. **Warning:** This audience type will be deprecated on **May + // 20, 2023**. After this date, these audiences will not be able to be + // added to resource targeting. Read our [feature deprecation + // announcement](/display-video/api/deprecations#features.google_audience + // _types) for more information. // "GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES" - New-Mobile-Devices type - // Google audience. + // Google audience. **Warning:** This audience type will be deprecated + // on **May 20, 2023**. After this date, these audiences will not be + // able to be added to resource targeting. Read our [feature deprecation + // announcement](/display-video/api/deprecations#features.google_audience + // _types) for more information. // "GOOGLE_AUDIENCE_TYPE_LIFE_EVENT" - Life-Event type Google // audience. // "GOOGLE_AUDIENCE_TYPE_EXTENDED_DEMOGRAPHIC" - Extended-Demographic @@ -10864,7 +10919,11 @@ type LineItemFlight struct { // "LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM" - The line item uses its own // custom flight dates. // "LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER" - The line item uses a - // trigger. + // trigger. **Warning:** Line Items using manual triggers will stop + // serving in Display & Video 360 on **May 17, 2023**. Read our [feature + // deprecation + // announcement](/display-video/api/deprecations#features.manual_triggers + // ) for more information. FlightDateType string `json:"flightDateType,omitempty"` // TriggerId: The ID of the manual trigger associated with the line @@ -10873,7 +10932,11 @@ type LineItemFlight struct { // When set, the line item's flight dates are inherited from its parent // insertion order. * Active line items will spend when the selected // trigger is activated within the parent insertion order's flight - // dates. + // dates. **Warning:** Line Items using manual triggers will stop + // serving in Display & Video 360 on **May 17, 2023**. Read our feature + // deprecation announcement + // (/display-video/api/deprecations#features.manual_triggers) for more + // information. TriggerId int64 `json:"triggerId,omitempty,string"` // ForceSendFields is a list of field names (e.g. "DateRange") to @@ -12231,6 +12294,11 @@ func (s *LookupInvoiceCurrencyResponse) MarshalJSON() ([]byte, error) { } // ManualTrigger: A single manual trigger in Display & Video 360. +// **Warning:** Line Items using manual triggers will stop serving in +// Display & Video 360 on **May 17, 2023**. Read our feature deprecation +// announcement +// (/display-video/api/deprecations#features.manual_triggers) for more +// information. type ManualTrigger struct { // ActivationDurationMinutes: Required. The maximum duration of each // activation in minutes. Must be between 1 and 360 inclusive. After @@ -15388,7 +15456,9 @@ type TargetingOption struct { // "TARGETING_TYPE_LANGUAGE" - Target ads to a specific language (for // example, English or Japanese). // "TARGETING_TYPE_AUTHORIZED_SELLER_STATUS" - Target ads to ads.txt - // authorized sellers. + // authorized sellers. If no targeting option of this type is assigned, + // the resource uses the "Authorized Direct Sellers and Resellers" + // option by default. // "TARGETING_TYPE_GEO_REGION" - Target ads to a specific regional // location (for example, a city or state). // "TARGETING_TYPE_INVENTORY_SOURCE_GROUP" - Purchase impressions from @@ -16545,14 +16615,16 @@ func (r *AdvertisersService) BulkListAdvertiserAssignedTargetingOptions(advertis } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR`.. * A restriction has -// the form of `{field} {operator} {value}`. * The operator must be -// `EQUALS (=)`. * Supported fields: - `targetingType` Examples: * -// targetingType with value TARGETING_TYPE_CHANNEL +// can be combined by the `OR` logical operator. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=) operator`. Supported fields: * `targetingType` Examples: +// * targetingType with value TARGETING_TYPE_CHANNEL // `targetingType="TARGETING_TYPE_CHANNEL" The length of this field -// should be no more than 500 characters. +// should be no more than 500 characters. Reference our filter `LIST` +// requests (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersBulkListAdvertiserAssignedTargetingOptionsCall) Filter(filter string) *AdvertisersBulkListAdvertiserAssignedTargetingOptionsCall { c.urlParams_.Set("filter", filter) return c @@ -16705,7 +16777,7 @@ func (c *AdvertisersBulkListAdvertiserAssignedTargetingOptionsCall) Do(opts ...g // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`.. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` Examples: * targetingType with value TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_CHANNEL\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=) operator`. Supported fields: * `targetingType` Examples: * targetingType with value TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_CHANNEL\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -17186,22 +17258,23 @@ func (r *AdvertisersService) List() *AdvertisersListCall { } // Filter sets the optional parameter "filter": Allows filtering by -// advertiser properties. Supported syntax: * Filter expressions are -// made up of one or more restrictions. * Restrictions can be combined -// by `AND` or `OR` logical operators. A sequence of restrictions -// implicitly uses `AND`. * A restriction has the form of `{field} -// {operator} {value}`. * The operator used on `updateTime` must be -// `GREATER THAN OR EQUAL TO (>=)` or `LESS THAN OR EQUAL TO (<=)`. * -// The operator must be `EQUALS (=)`. * Supported fields: - -// `advertiserId` - `displayName` - `entityStatus` - `updateTime` (input -// in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All active -// advertisers under a partner: `entityStatus="ENTITY_STATUS_ACTIVE" * -// All advertisers with an update time less than or equal to -// `2020-11-04T18:54:47Z (format of ISO 8601)`: -// `updateTime<="2020-11-04T18:54:47Z" * All advertisers with an update -// time greater than or equal to `2020-11-04T18:54:47Z (format of ISO -// 8601)`: `updateTime>="2020-11-04T18:54:47Z" The length of this field -// should be no more than 500 characters. +// advertiser fields. Supported syntax: * Filter expressions are made up +// of one or more restrictions. * Restrictions can be combined by `AND` +// or `OR` logical operators. * A restriction has the form of `{field} +// {operator} {value}`. * The `updateTime` field must use the `GREATER +// THAN OR EQUAL TO (>=)` or `LESS THAN OR EQUAL TO (<=)` operators. * +// All other fields must use the `EQUALS (=)` operator. Supported +// fields: * `advertiserId` * `displayName` * `entityStatus` * +// `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) +// Examples: * All active advertisers under a partner: +// `entityStatus="ENTITY_STATUS_ACTIVE" * All advertisers with an +// update time less than or equal to 2020-11-04T18:54:47Z (format of ISO +// 8601): `updateTime<="2020-11-04T18:54:47Z" * All advertisers with an +// update time greater than or equal to 2020-11-04T18:54:47Z (format of +// ISO 8601): `updateTime>="2020-11-04T18:54:47Z" The length of this +// field should be no more than 500 characters. Reference our filter +// `LIST` requests (/display-video/api/guides/how-tos/filters) guide for +// more information. func (c *AdvertisersListCall) Filter(filter string) *AdvertisersListCall { c.urlParams_.Set("filter", filter) return c @@ -17345,7 +17418,7 @@ func (c *AdvertisersListCall) Do(opts ...googleapi.CallOption) (*ListAdvertisers // "parameterOrder": [], // "parameters": { // "filter": { - // "description": "Allows filtering by advertiser properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)`. * The operator must be `EQUALS (=)`. * Supported fields: - `advertiserId` - `displayName` - `entityStatus` - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All active advertisers under a partner: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` * All advertisers with an update time less than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All advertisers with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by advertiser fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. * A restriction has the form of `{field} {operator} {value}`. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `advertiserId` * `displayName` * `entityStatus` * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * All active advertisers under a partner: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` * All advertisers with an update time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All advertisers with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -17819,18 +17892,21 @@ func (r *AdvertisersCampaignsService) BulkListCampaignAssignedTargetingOptions(a } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR` on the same field. * A -// restriction has the form of `{field} {operator} {value}`. * The -// operator must be `EQUALS (=)`. * Supported fields: - `targetingType` -// - `inheritance` Examples: * AssignedTargetingOptions of targeting -// type TARGETING_TYPE_LANGUAGE or TARGETING_TYPE_GENDER +// can be combined by the `OR` logical operator. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * `targetingType` * +// `inheritance` Examples: * `AssignedTargetingOption` resources of +// targeting type `TARGETING_TYPE_LANGUAGE` or `TARGETING_TYPE_GENDER`: // `targetingType="TARGETING_TYPE_LANGUAGE" OR -// targetingType="TARGETING_TYPE_GENDER" * AssignedTargetingOptions -// with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER -// `inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER" -// The length of this field should be no more than 500 characters. +// targetingType="TARGETING_TYPE_GENDER" * `AssignedTargetingOption` +// resources with inheritance status of `NOT_INHERITED` or +// `INHERITED_FROM_PARTNER`: `inheritance="NOT_INHERITED" OR +// inheritance="INHERITED_FROM_PARTNER" The length of this field should +// be no more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersCampaignsBulkListCampaignAssignedTargetingOptionsCall) Filter(filter string) *AdvertisersCampaignsBulkListCampaignAssignedTargetingOptionsCall { c.urlParams_.Set("filter", filter) return c @@ -17993,7 +18069,7 @@ func (c *AdvertisersCampaignsBulkListCampaignAssignedTargetingOptionsCall) Do(op // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` - `inheritance` Examples: * AssignedTargetingOptions of targeting type TARGETING_TYPE_LANGUAGE or TARGETING_TYPE_GENDER `targetingType=\"TARGETING_TYPE_LANGUAGE\" OR targetingType=\"TARGETING_TYPE_GENDER\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `targetingType` * `inheritance` Examples: * `AssignedTargetingOption` resources of targeting type `TARGETING_TYPE_LANGUAGE` or `TARGETING_TYPE_GENDER`: `targetingType=\"TARGETING_TYPE_LANGUAGE\" OR targetingType=\"TARGETING_TYPE_GENDER\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -18526,23 +18602,25 @@ func (r *AdvertisersCampaignsService) List(advertiserId int64) *AdvertisersCampa } // Filter sets the optional parameter "filter": Allows filtering by -// campaign properties. Supported syntax: * Filter expressions are made -// up of one or more restrictions. * Restrictions can be combined by -// `AND` or `OR` logical operators. A sequence of restrictions -// implicitly uses `AND`. * A restriction has the form of `{field} -// {operator} {value}`. * The operator used on `updateTime` must be -// `GREATER THAN OR EQUAL TO (>=)` or `LESS THAN OR EQUAL TO (<=)`. * -// The operator must be `EQUALS (=)`. * Supported fields: - `campaignId` -// - `displayName` - `entityStatus` - `updateTime` (input in ISO 8601 -// format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All +// campaign fields. Supported syntax: * Filter expressions are made up +// of one or more restrictions. * Restrictions can be combined by `AND` +// or `OR` logical operators. A sequence of restrictions implicitly uses +// `AND`. * A restriction has the form of `{field} {operator} {value}`. +// * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (>=)` +// or `LESS THAN OR EQUAL TO (<=)` operators. * All other fields must +// use the `EQUALS (=)` operator. Supported fields: * `campaignId` * +// `displayName` * `entityStatus` * `updateTime` (input in ISO 8601 +// format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * All // `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` campaigns under an // advertiser: `(entityStatus="ENTITY_STATUS_ACTIVE" OR // entityStatus="ENTITY_STATUS_PAUSED")` * All campaigns with an update -// time less than or equal to `2020-11-04T18:54:47Z (format of ISO -// 8601)`: `updateTime<="2020-11-04T18:54:47Z" * All campaigns with an -// update time greater than or equal to `2020-11-04T18:54:47Z (format of -// ISO 8601)`: `updateTime>="2020-11-04T18:54:47Z" The length of this -// field should be no more than 500 characters. +// time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): +// `updateTime<="2020-11-04T18:54:47Z" * All campaigns with an update +// time greater than or equal to 2020-11-04T18:54:47Z (format of ISO +// 8601): `updateTime>="2020-11-04T18:54:47Z" The length of this field +// should be no more than 500 characters. Reference our filter `LIST` +// requests (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersCampaignsListCall) Filter(filter string) *AdvertisersCampaignsListCall { c.urlParams_.Set("filter", filter) return c @@ -18691,7 +18769,7 @@ func (c *AdvertisersCampaignsListCall) Do(opts ...googleapi.CallOption) (*ListCa // "type": "string" // }, // "filter": { - // "description": "Allows filtering by campaign properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)`. * The operator must be `EQUALS (=)`. * Supported fields: - `campaignId` - `displayName` - `entityStatus` - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` campaigns under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\")` * All campaigns with an update time less than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All campaigns with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by campaign fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `campaignId` * `displayName` * `entityStatus` * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` campaigns under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\")` * All campaigns with an update time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All campaigns with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -19186,7 +19264,7 @@ func (c *AdvertisersCampaignsTargetingTypesAssignedTargetingOptionsGetCall) Do(o // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -19262,17 +19340,21 @@ func (r *AdvertisersCampaignsTargetingTypesAssignedTargetingOptionsService) List } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `assignedTargetingOptionId` - -// `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 +// can be combined by the `OR` logical operator. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * +// `assignedTargetingOptionId` * `inheritance` Examples: * +// `AssignedTargetingOption` resources with ID 1 or 2 // `assignedTargetingOptionId="1" OR assignedTargetingOptionId="2" * -// AssignedTargetingOptions with inheritance status of NOT_INHERITED or -// INHERITED_FROM_PARTNER `inheritance="NOT_INHERITED" OR -// inheritance="INHERITED_FROM_PARTNER" The length of this field should -// be no more than 500 characters. +// `AssignedTargetingOption` resources with inheritance status of +// `NOT_INHERITED` or `INHERITED_FROM_PARTNER` +// `inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER" +// The length of this field should be no more than 500 characters. +// Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersCampaignsTargetingTypesAssignedTargetingOptionsListCall) Filter(filter string) *AdvertisersCampaignsTargetingTypesAssignedTargetingOptionsListCall { c.urlParams_.Set("filter", filter) return c @@ -19437,7 +19519,7 @@ func (c *AdvertisersCampaignsTargetingTypesAssignedTargetingOptionsListCall) Do( // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` - `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` * `inheritance` Examples: * `AssignedTargetingOption` resources with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER` `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -19541,7 +19623,7 @@ func (c *AdvertisersCampaignsTargetingTypesAssignedTargetingOptionsListCall) Do( // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -19947,12 +20029,14 @@ func (r *AdvertisersChannelsService) List(advertiserId int64) *AdvertisersChanne // Filter sets the optional parameter "filter": Allows filtering by // channel fields. Supported syntax: * Filter expressions for channel -// currently can only contain at most one * restriction. * A restriction -// has the form of `{field} {operator} {value}`. * The operator must be -// `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All +// can only contain at most one restriction. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the `HAS +// (:)` operator. Supported fields: * `displayName` Examples: * All // channels for which the display name contains "google": `displayName : // "google". The length of this field should be no more than 500 -// characters. +// characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersChannelsListCall) Filter(filter string) *AdvertisersChannelsListCall { c.urlParams_.Set("filter", filter) return c @@ -20110,7 +20194,7 @@ func (c *AdvertisersChannelsListCall) Do(opts ...googleapi.CallOption) (*ListCha // "type": "string" // }, // "filter": { - // "description": "Allows filtering by channel fields. Supported syntax: * Filter expressions for channel currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All channels for which the display name contains \"google\": `displayName : \"google\"`. The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by channel fields. Supported syntax: * Filter expressions for channel can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All channels for which the display name contains \"google\": `displayName : \"google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -20877,11 +20961,15 @@ func (r *AdvertisersChannelsSitesService) List(advertiserId int64, channelId int } // Filter sets the optional parameter "filter": Allows filtering by site -// fields. Supported syntax: * Filter expressions for site currently can -// only contain at most one * restriction. * A restriction has the form -// of `{field} {operator} {value}`. * The operator must be `CONTAINS -// (:)`. * Supported fields: - `urlOrAppId` Examples: * All sites for +// fields. Supported syntax: * Filter expressions for site retrieval can +// only contain at most one restriction. * A restriction has the form of +// `{field} {operator} {value}`. * All fields must use the `HAS (:)` +// operator. Supported fields: * `urlOrAppId` Examples: * All sites for // which the URL or app ID contains "google": `urlOrAppId : "google" +// The length of this field should be no more than 500 characters. +// Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersChannelsSitesListCall) Filter(filter string) *AdvertisersChannelsSitesListCall { c.urlParams_.Set("filter", filter) return c @@ -21049,7 +21137,7 @@ func (c *AdvertisersChannelsSitesListCall) Do(opts ...googleapi.CallOption) (*Li // "type": "string" // }, // "filter": { - // "description": "Allows filtering by site fields. Supported syntax: * Filter expressions for site currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `urlOrAppId` Examples: * All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"`", + // "description": "Allows filtering by site fields. Supported syntax: * Filter expressions for site retrieval can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `urlOrAppId` Examples: * All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -21745,38 +21833,33 @@ func (r *AdvertisersCreativesService) List(advertiserId int64) *AdvertisersCreat } // Filter sets the optional parameter "filter": Allows filtering by -// creative properties. Supported syntax: * Filter expressions are made -// up of one or more restrictions. * Restriction for the same field must -// be combined by `OR`. * Restriction for different fields must be -// combined by `AND`. * Between `(` and `)` there can only be -// restrictions combined by `OR` for the same field. * A restriction has -// the form of `{field} {operator} {value}`. * The operator must be -// `EQUALS (=)` for the following fields: - `entityStatus` - -// `creativeType`. - `dimensions` - `minDuration` - `maxDuration` - -// `approvalStatus` - `exchangeReviewStatus` - `dynamic` - `creativeId` -// * The operator must be `HAS (:)` for the following fields: - -// `lineItemIds` * The operator must be `GREATER THAN OR EQUAL TO (>=)` -// or `LESS THAN OR EQUAL TO (<=)` for the following fields: - -// `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) * -// For `entityStatus`, `minDuration`, `maxDuration`, `updateTime`, and -// `dynamic`, there may be at most one restriction. * For `dimensions`, -// the value is in the form of "{width}x{height}". * For -// `exchangeReviewStatus`, the value is in the form of -// `{exchange}-{reviewStatus}`. * For `minDuration` and `maxDuration`, -// the value is in the form of "{duration}s". Only seconds are -// supported with millisecond granularity. * For `updateTime`, a -// creative resource's field value reflects the last time that a -// creative has been updated, which includes updates made by the system -// (e.g. creative review updates). * There may be multiple `lineItemIds` -// restrictions in order to search against multiple possible line item -// IDs. * There may be multiple `creativeId` restrictions in order to -// search against multiple possible creative IDs. Examples: * All native -// creatives: `creativeType="CREATIVE_TYPE_NATIVE" * All active -// creatives with 300x400 or 50x100 dimensions: -// `entityStatus="ENTITY_STATUS_ACTIVE" AND (dimensions="300x400" OR -// dimensions="50x100")` * All dynamic creatives that are approved by -// AdX or AppNexus, with a minimum duration of 5 seconds and 200ms. -// `dynamic="true" AND minDuration="5.2s" AND +// creative fields. Supported syntax: * Filter expressions are made up +// of one or more restrictions. * Restrictions can be combined by `AND` +// or `OR` logical operators. A sequence of restrictions implicitly uses +// `AND`. * A restriction has the form of `{field} {operator} {value}`. +// * The `lineItemIds` field must use the `HAS (:)` operator. * The +// `updateTime` field must use the `GREATER THAN OR EQUAL TO (>=)` or +// `LESS THAN OR EQUAL TO (<=)` operators. * All other fields must use +// the `EQUALS (=)` operator. * For `entityStatus`, `minDuration`, +// `maxDuration`, `updateTime`, and `dynamic` fields, there may be at +// most one restriction. Supported Fields: * `approvalStatus` * +// `creativeId` * `creativeType` * `dimensions` (input in the form of +// `{width}x{height}`) * `dynamic` * `entityStatus` * +// `exchangeReviewStatus` (input in the form of +// `{exchange}-{reviewStatus}`) * `lineItemIds` * `maxDuration` (input +// in the form of `{duration}s`. Only seconds are supported) * +// `minDuration` (input in the form of `{duration}s`. Only seconds are +// supported) * `updateTime` (input in ISO 8601 format, or +// `YYYY-MM-DDTHH:MM:SSZ`) Notes: * For `updateTime`, a creative +// resource's field value reflects the last time that a creative has +// been updated, which includes updates made by the system (e.g. +// creative review updates). Examples: * All native creatives: +// `creativeType="CREATIVE_TYPE_NATIVE" * All active creatives with +// 300x400 or 50x100 dimensions: `entityStatus="ENTITY_STATUS_ACTIVE" +// AND (dimensions="300x400" OR dimensions="50x100")` * All dynamic +// creatives that are approved by AdX or AppNexus, with a minimum +// duration of 5 seconds and 200ms: `dynamic="true" AND +// minDuration="5.2s" AND // (exchangeReviewStatus="EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROV // ED" OR // exchangeReviewStatus="EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED")` * @@ -21784,9 +21867,11 @@ func (r *AdvertisersCreativesService) List(advertiserId int64) *AdvertisersCreat // `creativeType="CREATIVE_TYPE_VIDEO" AND (lineItemIds:1 OR // lineItemIds:2)` * Find creatives by multiple creative IDs: // `creativeId=1 OR creativeId=2` * All creatives with an update time -// greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: +// greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): // `updateTime>="2020-11-04T18:54:47Z" The length of this field should -// be no more than 500 characters. +// be no more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersCreativesListCall) Filter(filter string) *AdvertisersCreativesListCall { c.urlParams_.Set("filter", filter) return c @@ -21938,7 +22023,7 @@ func (c *AdvertisersCreativesListCall) Do(opts ...googleapi.CallOption) (*ListCr // "type": "string" // }, // "filter": { - // "description": "Allows filtering by creative properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restriction for the same field must be combined by `OR`. * Restriction for different fields must be combined by `AND`. * Between `(` and `)` there can only be restrictions combined by `OR` for the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)` for the following fields: - `entityStatus` - `creativeType`. - `dimensions` - `minDuration` - `maxDuration` - `approvalStatus` - `exchangeReviewStatus` - `dynamic` - `creativeId` * The operator must be `HAS (:)` for the following fields: - `lineItemIds` * The operator must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` for the following fields: - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) * For `entityStatus`, `minDuration`, `maxDuration`, `updateTime`, and `dynamic`, there may be at most one restriction. * For `dimensions`, the value is in the form of `\"{width}x{height}\"`. * For `exchangeReviewStatus`, the value is in the form of `{exchange}-{reviewStatus}`. * For `minDuration` and `maxDuration`, the value is in the form of `\"{duration}s\"`. Only seconds are supported with millisecond granularity. * For `updateTime`, a creative resource's field value reflects the last time that a creative has been updated, which includes updates made by the system (e.g. creative review updates). * There may be multiple `lineItemIds` restrictions in order to search against multiple possible line item IDs. * There may be multiple `creativeId` restrictions in order to search against multiple possible creative IDs. Examples: * All native creatives: `creativeType=\"CREATIVE_TYPE_NATIVE\"` * All active creatives with 300x400 or 50x100 dimensions: `entityStatus=\"ENTITY_STATUS_ACTIVE\" AND (dimensions=\"300x400\" OR dimensions=\"50x100\")` * All dynamic creatives that are approved by AdX or AppNexus, with a minimum duration of 5 seconds and 200ms. `dynamic=\"true\" AND minDuration=\"5.2s\" AND (exchangeReviewStatus=\"EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED\" OR exchangeReviewStatus=\"EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED\")` * All video creatives that are associated with line item ID 1 or 2: `creativeType=\"CREATIVE_TYPE_VIDEO\" AND (lineItemIds:1 OR lineItemIds:2)` * Find creatives by multiple creative IDs: `creativeId=1 OR creativeId=2` * All creatives with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by creative fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `lineItemIds` field must use the `HAS (:)` operator. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * All other fields must use the `EQUALS (=)` operator. * For `entityStatus`, `minDuration`, `maxDuration`, `updateTime`, and `dynamic` fields, there may be at most one restriction. Supported Fields: * `approvalStatus` * `creativeId` * `creativeType` * `dimensions` (input in the form of `{width}x{height}`) * `dynamic` * `entityStatus` * `exchangeReviewStatus` (input in the form of `{exchange}-{reviewStatus}`) * `lineItemIds` * `maxDuration` (input in the form of `{duration}s`. Only seconds are supported) * `minDuration` (input in the form of `{duration}s`. Only seconds are supported) * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Notes: * For `updateTime`, a creative resource's field value reflects the last time that a creative has been updated, which includes updates made by the system (e.g. creative review updates). Examples: * All native creatives: `creativeType=\"CREATIVE_TYPE_NATIVE\"` * All active creatives with 300x400 or 50x100 dimensions: `entityStatus=\"ENTITY_STATUS_ACTIVE\" AND (dimensions=\"300x400\" OR dimensions=\"50x100\")` * All dynamic creatives that are approved by AdX or AppNexus, with a minimum duration of 5 seconds and 200ms: `dynamic=\"true\" AND minDuration=\"5.2s\" AND (exchangeReviewStatus=\"EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED\" OR exchangeReviewStatus=\"EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED\")` * All video creatives that are associated with line item ID 1 or 2: `creativeType=\"CREATIVE_TYPE_VIDEO\" AND (lineItemIds:1 OR lineItemIds:2)` * Find creatives by multiple creative IDs: `creativeId=1 OR creativeId=2` * All creatives with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -22190,18 +22275,22 @@ func (r *AdvertisersInsertionOrdersService) BulkListInsertionOrderAssignedTarget } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR` on the same field. * A -// restriction has the form of `{field} {operator} {value}`. * The -// operator must be `EQUALS (=)`. * Supported fields: - `targetingType` -// - `inheritance` Examples: * AssignedTargetingOptions of targeting -// type TARGETING_TYPE_PROXIMITY_LOCATION_LIST or TARGETING_TYPE_CHANNEL +// can be combined by the logical operator `OR`. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * `targetingType` * +// `inheritance` Examples: * `AssignedTargetingOption` resources of +// targeting type `TARGETING_TYPE_PROXIMITY_LOCATION_LIST` or +// `TARGETING_TYPE_CHANNEL`: // `targetingType="TARGETING_TYPE_PROXIMITY_LOCATION_LIST" OR -// targetingType="TARGETING_TYPE_CHANNEL" * AssignedTargetingOptions -// with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER -// `inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER" -// The length of this field should be no more than 500 characters. +// targetingType="TARGETING_TYPE_CHANNEL" * `AssignedTargetingOption` +// resources with inheritance status of `NOT_INHERITED` or +// `INHERITED_FROM_PARTNER`: `inheritance="NOT_INHERITED" OR +// inheritance="INHERITED_FROM_PARTNER" The length of this field should +// be no more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersInsertionOrdersBulkListInsertionOrderAssignedTargetingOptionsCall) Filter(filter string) *AdvertisersInsertionOrdersBulkListInsertionOrderAssignedTargetingOptionsCall { c.urlParams_.Set("filter", filter) return c @@ -22357,7 +22446,7 @@ func (c *AdvertisersInsertionOrdersBulkListInsertionOrderAssignedTargetingOption // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` - `inheritance` Examples: * AssignedTargetingOptions of targeting type TARGETING_TYPE_PROXIMITY_LOCATION_LIST or TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_PROXIMITY_LOCATION_LIST\" OR targetingType=\"TARGETING_TYPE_CHANNEL\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `targetingType` * `inheritance` Examples: * `AssignedTargetingOption` resources of targeting type `TARGETING_TYPE_PROXIMITY_LOCATION_LIST` or `TARGETING_TYPE_CHANNEL`: `targetingType=\"TARGETING_TYPE_PROXIMITY_LOCATION_LIST\" OR targetingType=\"TARGETING_TYPE_CHANNEL\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -22900,31 +22989,31 @@ func (r *AdvertisersInsertionOrdersService) List(advertiserId int64) *Advertiser } // Filter sets the optional parameter "filter": Allows filtering by -// insertion order properties. Supported syntax: * Filter expressions -// are made up of one or more restrictions. * Restrictions can be -// combined by `AND` or `OR` logical operators. A sequence of -// restrictions implicitly uses `AND`. * A restriction has the form of -// `{field} {operator} {value}`. * The operator used on -// `budget.budget_segments.date_range.end_date` must be LESS THAN (<). * -// The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO -// (>=)` or `LESS THAN OR EQUAL TO (<=)`. * The operators used on all -// other fields must be `EQUALS (=)`. * Supported fields: - `campaignId` -// - `displayName` - `entityStatus` - -// `budget.budget_segments.date_range.end_date` (input as YYYY-MM-DD) - -// `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) +// insertion order fields. Supported syntax: * Filter expressions are +// made up of one or more restrictions. * Restrictions can be combined +// by `AND` or `OR` logical operators. A sequence of restrictions +// implicitly uses `AND`. * A restriction has the form of `{field} +// {operator} {value}`. * The +// `budget.budget_segments.date_range.end_date` field must use the `LESS +// THAN (<)` operator. * The `updateTime` field must use the `GREATER +// THAN OR EQUAL TO (>=)` or `LESS THAN OR EQUAL TO (<=)` operators. * +// All other fields must use the `EQUALS (=)` operator. Supported +// fields: * `campaignId` * `displayName` * `entityStatus` * +// `budget.budget_segments.date_range.end_date` (input in the form of +// `YYYY-MM-DD`) **Deprecated. Not available after June 8, 2023** * +// `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) // Examples: * All insertion orders under a campaign: // `campaignId="1234" * All `ENTITY_STATUS_ACTIVE` or // `ENTITY_STATUS_PAUSED` insertion orders under an advertiser: // `(entityStatus="ENTITY_STATUS_ACTIVE" OR -// entityStatus="ENTITY_STATUS_PAUSED")` * All insertion orders whose -// budget segments' dates end before March 28, 2019: -// `budget.budget_segments.date_range.end_date<"2019-03-28" * All -// insertion orders with an update time less than or equal to -// `2020-11-04T18:54:47Z (format of ISO 8601)`: -// `updateTime<="2020-11-04T18:54:47Z" * All insertion orders with an -// update time greater than or equal to `2020-11-04T18:54:47Z (format of -// ISO 8601)`: `updateTime>="2020-11-04T18:54:47Z" The length of this -// field should be no more than 500 characters. +// entityStatus="ENTITY_STATUS_PAUSED")` * All insertion orders with an +// update time less than or equal to 2020-11-04T18:54:47Z (format of ISO +// 8601): `updateTime<="2020-11-04T18:54:47Z" * All insertion orders +// with an update time greater than or equal to 2020-11-04T18:54:47Z +// (format of ISO 8601): `updateTime>="2020-11-04T18:54:47Z" The length +// of this field should be no more than 500 characters. Reference our +// filter `LIST` requests (/display-video/api/guides/how-tos/filters) +// guide for more information. func (c *AdvertisersInsertionOrdersListCall) Filter(filter string) *AdvertisersInsertionOrdersListCall { c.urlParams_.Set("filter", filter) return c @@ -23075,7 +23164,7 @@ func (c *AdvertisersInsertionOrdersListCall) Do(opts ...googleapi.CallOption) (* // "type": "string" // }, // "filter": { - // "description": "Allows filtering by insertion order properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator used on `budget.budget_segments.date_range.end_date` must be LESS THAN (\u003c). * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)`. * The operators used on all other fields must be `EQUALS (=)`. * Supported fields: - `campaignId` - `displayName` - `entityStatus` - `budget.budget_segments.date_range.end_date` (input as YYYY-MM-DD) - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All insertion orders under a campaign: `campaignId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` insertion orders under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\")` * All insertion orders whose budget segments' dates end before March 28, 2019: `budget.budget_segments.date_range.end_date\u003c\"2019-03-28\"` * All insertion orders with an update time less than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All insertion orders with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by insertion order fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `budget.budget_segments.date_range.end_date` field must use the `LESS THAN (\u003c)` operator. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `campaignId` * `displayName` * `entityStatus` * `budget.budget_segments.date_range.end_date` (input in the form of `YYYY-MM-DD`) **Deprecated. Not available after June 8, 2023** * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * All insertion orders under a campaign: `campaignId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` insertion orders under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\")` * All insertion orders with an update time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All insertion orders with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -23586,7 +23675,7 @@ func (c *AdvertisersInsertionOrdersTargetingTypesAssignedTargetingOptionsGetCall // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -23679,17 +23768,21 @@ func (r *AdvertisersInsertionOrdersTargetingTypesAssignedTargetingOptionsService } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions // can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `assignedTargetingOptionId` - -// `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * +// `assignedTargetingOptionId` * `inheritance` Examples: * +// `AssignedTargetingOption` resources with ID 1 or 2: // `assignedTargetingOptionId="1" OR assignedTargetingOptionId="2" * -// AssignedTargetingOptions with inheritance status of NOT_INHERITED or -// INHERITED_FROM_PARTNER `inheritance="NOT_INHERITED" OR -// inheritance="INHERITED_FROM_PARTNER" The length of this field should -// be no more than 500 characters. +// `AssignedTargetingOption` resources with inheritance status of +// `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: +// `inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER" +// The length of this field should be no more than 500 characters. +// Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersInsertionOrdersTargetingTypesAssignedTargetingOptionsListCall) Filter(filter string) *AdvertisersInsertionOrdersTargetingTypesAssignedTargetingOptionsListCall { c.urlParams_.Set("filter", filter) return c @@ -23846,7 +23939,7 @@ func (c *AdvertisersInsertionOrdersTargetingTypesAssignedTargetingOptionsListCal // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` - `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` * `inheritance` Examples: * `AssignedTargetingOption` resources with ID 1 or 2: `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -23958,7 +24051,7 @@ func (c *AdvertisersInsertionOrdersTargetingTypesAssignedTargetingOptionsListCal // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -24611,18 +24704,22 @@ func (r *AdvertisersLineItemsService) BulkListLineItemAssignedTargetingOptions(a } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR` on the same field. * A -// restriction has the form of `{field} {operator} {value}`. * The -// operator must be `EQUALS (=)`. * Supported fields: - `targetingType` -// - `inheritance` Examples: * AssignedTargetingOptions of targeting -// type TARGETING_TYPE_PROXIMITY_LOCATION_LIST or TARGETING_TYPE_CHANNEL +// can be combined by the logical operator `OR`. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * `targetingType` * +// `inheritance` Examples: * `AssignedTargetingOption` resources of +// targeting type `TARGETING_TYPE_PROXIMITY_LOCATION_LIST` or +// `TARGETING_TYPE_CHANNEL`: // `targetingType="TARGETING_TYPE_PROXIMITY_LOCATION_LIST" OR -// targetingType="TARGETING_TYPE_CHANNEL" * AssignedTargetingOptions -// with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER -// `inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER" -// The length of this field should be no more than 500 characters. +// targetingType="TARGETING_TYPE_CHANNEL" * `AssignedTargetingOption` +// resources with inheritance status of `NOT_INHERITED` or +// `INHERITED_FROM_PARTNER`: `inheritance="NOT_INHERITED" OR +// inheritance="INHERITED_FROM_PARTNER" The length of this field should +// be no more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersLineItemsBulkListLineItemAssignedTargetingOptionsCall) Filter(filter string) *AdvertisersLineItemsBulkListLineItemAssignedTargetingOptionsCall { c.urlParams_.Set("filter", filter) return c @@ -24777,7 +24874,7 @@ func (c *AdvertisersLineItemsBulkListLineItemAssignedTargetingOptionsCall) Do(op // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` - `inheritance` Examples: * AssignedTargetingOptions of targeting type TARGETING_TYPE_PROXIMITY_LOCATION_LIST or TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_PROXIMITY_LOCATION_LIST\" OR targetingType=\"TARGETING_TYPE_CHANNEL\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `targetingType` * `inheritance` Examples: * `AssignedTargetingOption` resources of targeting type `TARGETING_TYPE_PROXIMITY_LOCATION_LIST` or `TARGETING_TYPE_CHANNEL`: `targetingType=\"TARGETING_TYPE_PROXIMITY_LOCATION_LIST\" OR targetingType=\"TARGETING_TYPE_CHANNEL\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -25464,38 +25561,41 @@ func (r *AdvertisersLineItemsService) List(advertiserId int64) *AdvertisersLineI } // Filter sets the optional parameter "filter": Allows filtering by line -// item properties. Supported syntax: * Filter expressions are made up -// of one or more restrictions. * Restrictions can be combined by `AND` -// or `OR` logical operators. A sequence of restrictions implicitly uses +// item fields. Supported syntax: * Filter expressions are made up of +// one or more restrictions. * Restrictions can be combined by `AND` or +// `OR` logical operators. A sequence of restrictions implicitly uses // `AND`. * A restriction has the form of `{field} {operator} {value}`. -// * The operator used on `flight.dateRange.endDate` must be LESS THAN -// (<). * The operator used on `updateTime` must be `GREATER THAN OR -// EQUAL TO (>=)` or `LESS THAN OR EQUAL TO (<=)`. * The operator used -// on `warningMessages` must be `HAS (:)`. * The operators used on all -// other fields must be `EQUALS (=)`. * Supported properties: - -// `campaignId` - `displayName` - `insertionOrderId` - `entityStatus` - -// `lineItemId` - `lineItemType` - `flight.dateRange.endDate` (input -// formatted as YYYY-MM-DD) - `warningMessages` - `flight.triggerId` - -// `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) - -// `targetedChannelId` - `targetedNegativeKeywordListId` Examples: * All -// line items under an insertion order: `insertionOrderId="1234" * All -// `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` and -// `LINE_ITEM_TYPE_DISPLAY_DEFAULT` line items under an advertiser: -// `(entityStatus="ENTITY_STATUS_ACTIVE" OR +// * The `flight.dateRange.endDate` field must use the `LESS THAN (<)` +// operator. * The `updateTime` field must use the `GREATER THAN OR +// EQUAL TO (>=)` or `LESS THAN OR EQUAL TO (<=)` operators. * The +// `warningMessages` field must use the `HAS (:)` operator. * All other +// fields must use the `EQUALS (=)` operator. Supported fields: * +// `campaignId` * `displayName` * `entityStatus` * +// `flight.dateRange.endDate` (input formatted as `YYYY-MM-DD`) +// **Deprecated. Not available after June 8, 2023** * `flight.triggerId` +// * `insertionOrderId` * `lineItemId` * `lineItemType` * +// `targetedChannelId` * `targetedNegativeKeywordListId` * `updateTime` +// (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) * +// `warningMessages` Examples: * All line items under an insertion +// order: `insertionOrderId="1234" * All `ENTITY_STATUS_ACTIVE` or +// `ENTITY_STATUS_PAUSED` and `LINE_ITEM_TYPE_DISPLAY_DEFAULT` line +// items under an advertiser: `(entityStatus="ENTITY_STATUS_ACTIVE" OR // entityStatus="ENTITY_STATUS_PAUSED") AND // lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" * All line items whose // flight dates end before March 28, 2019: // `flight.dateRange.endDate<"2019-03-28" * All line items that have // `NO_VALID_CREATIVE` in `warningMessages`: // `warningMessages:"NO_VALID_CREATIVE" * All line items with an update -// time less than or equal to `2020-11-04T18:54:47Z (format of ISO -// 8601)`: `updateTime<="2020-11-04T18:54:47Z" * All line items with an -// update time greater than or equal to `2020-11-04T18:54:47Z (format of -// ISO 8601)`: `updateTime>="2020-11-04T18:54:47Z" * All line items -// that are using both the specified channel and specified negative -// keyword list in their targeting: `targetedNegativeKeywordListId=789 -// AND targetedChannelId=12345` The length of this field should be no -// more than 500 characters. +// time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): +// `updateTime<="2020-11-04T18:54:47Z" * All line items with an update +// time greater than or equal to 2020-11-04T18:54:47Z (format of ISO +// 8601): `updateTime>="2020-11-04T18:54:47Z" * All line items that are +// using both the specified channel and specified negative keyword list +// in their targeting: `targetedNegativeKeywordListId=789 AND +// targetedChannelId=12345` The length of this field should be no more +// than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersLineItemsListCall) Filter(filter string) *AdvertisersLineItemsListCall { c.urlParams_.Set("filter", filter) return c @@ -25503,10 +25603,11 @@ func (c *AdvertisersLineItemsListCall) Filter(filter string) *AdvertisersLineIte // OrderBy sets the optional parameter "orderBy": Field by which to sort // the list. Acceptable values are: * `displayName` (default) * -// `entityStatus` * `flight.dateRange.endDate` * `updateTime` The -// default sorting order is ascending. To specify descending order for a -// field, a suffix "desc" should be added to the field name. Example: -// `displayName desc`. +// `entityStatus` * `flight.dateRange.endDate` **Deprecated. Not +// available after June 8, 2023** * `updateTime` The default sorting +// order is ascending. To specify descending order for a field, a suffix +// "desc" should be added to the field name. Example: `displayName +// desc`. func (c *AdvertisersLineItemsListCall) OrderBy(orderBy string) *AdvertisersLineItemsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -25647,12 +25748,12 @@ func (c *AdvertisersLineItemsListCall) Do(opts ...googleapi.CallOption) (*ListLi // "type": "string" // }, // "filter": { - // "description": "Allows filtering by line item properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator used on `flight.dateRange.endDate` must be LESS THAN (\u003c). * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)`. * The operator used on `warningMessages` must be `HAS (:)`. * The operators used on all other fields must be `EQUALS (=)`. * Supported properties: - `campaignId` - `displayName` - `insertionOrderId` - `entityStatus` - `lineItemId` - `lineItemType` - `flight.dateRange.endDate` (input formatted as YYYY-MM-DD) - `warningMessages` - `flight.triggerId` - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) - `targetedChannelId` - `targetedNegativeKeywordListId` Examples: * All line items under an insertion order: `insertionOrderId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` and `LINE_ITEM_TYPE_DISPLAY_DEFAULT` line items under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\") AND lineItemType=\"LINE_ITEM_TYPE_DISPLAY_DEFAULT\"` * All line items whose flight dates end before March 28, 2019: `flight.dateRange.endDate\u003c\"2019-03-28\"` * All line items that have `NO_VALID_CREATIVE` in `warningMessages`: `warningMessages:\"NO_VALID_CREATIVE\"` * All line items with an update time less than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All line items with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` * All line items that are using both the specified channel and specified negative keyword list in their targeting: `targetedNegativeKeywordListId=789 AND targetedChannelId=12345` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by line item fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `flight.dateRange.endDate` field must use the `LESS THAN (\u003c)` operator. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * The `warningMessages` field must use the `HAS (:)` operator. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `campaignId` * `displayName` * `entityStatus` * `flight.dateRange.endDate` (input formatted as `YYYY-MM-DD`) **Deprecated. Not available after June 8, 2023** * `flight.triggerId` * `insertionOrderId` * `lineItemId` * `lineItemType` * `targetedChannelId` * `targetedNegativeKeywordListId` * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) * `warningMessages` Examples: * All line items under an insertion order: `insertionOrderId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` and `LINE_ITEM_TYPE_DISPLAY_DEFAULT` line items under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\") AND lineItemType=\"LINE_ITEM_TYPE_DISPLAY_DEFAULT\"` * All line items whose flight dates end before March 28, 2019: `flight.dateRange.endDate\u003c\"2019-03-28\"` * All line items that have `NO_VALID_CREATIVE` in `warningMessages`: `warningMessages:\"NO_VALID_CREATIVE\"` * All line items with an update time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All line items with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` * All line items that are using both the specified channel and specified negative keyword list in their targeting: `targetedNegativeKeywordListId=789 AND targetedChannelId=12345` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, // "orderBy": { - // "description": "Field by which to sort the list. Acceptable values are: * `displayName` (default) * `entityStatus` * `flight.dateRange.endDate` * `updateTime` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `displayName desc`.", + // "description": "Field by which to sort the list. Acceptable values are: * `displayName` (default) * `entityStatus` * `flight.dateRange.endDate` **Deprecated. Not available after June 8, 2023** * `updateTime` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `displayName desc`.", // "location": "query", // "type": "string" // }, @@ -26144,7 +26245,7 @@ func (c *AdvertisersLineItemsTargetingTypesAssignedTargetingOptionsCreateCall) D // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -26452,7 +26553,7 @@ func (c *AdvertisersLineItemsTargetingTypesAssignedTargetingOptionsDeleteCall) D // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -26772,7 +26873,7 @@ func (c *AdvertisersLineItemsTargetingTypesAssignedTargetingOptionsGetCall) Do(o // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -26868,17 +26969,21 @@ func (r *AdvertisersLineItemsTargetingTypesAssignedTargetingOptionsService) List } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions // can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `assignedTargetingOptionId` - -// `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * +// `assignedTargetingOptionId` * `inheritance` Examples: * +// `AssignedTargetingOption` resources with ID 1 or 2: // `assignedTargetingOptionId="1" OR assignedTargetingOptionId="2" * -// AssignedTargetingOptions with inheritance status of NOT_INHERITED or -// INHERITED_FROM_PARTNER `inheritance="NOT_INHERITED" OR -// inheritance="INHERITED_FROM_PARTNER" The length of this field should -// be no more than 500 characters. +// `AssignedTargetingOption` resources with inheritance status of +// `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: +// `inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER" +// The length of this field should be no more than 500 characters. +// Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersLineItemsTargetingTypesAssignedTargetingOptionsListCall) Filter(filter string) *AdvertisersLineItemsTargetingTypesAssignedTargetingOptionsListCall { c.urlParams_.Set("filter", filter) return c @@ -27035,7 +27140,7 @@ func (c *AdvertisersLineItemsTargetingTypesAssignedTargetingOptionsListCall) Do( // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` - `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` * `inheritance` Examples: * `AssignedTargetingOption` resources with ID 1 or 2: `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -27147,7 +27252,7 @@ func (c *AdvertisersLineItemsTargetingTypesAssignedTargetingOptionsListCall) Do( // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -27531,10 +27636,14 @@ func (r *AdvertisersLocationListsService) List(advertiserId int64) *AdvertisersL // up of one or more restrictions. * Restrictions can be combined by // `AND` or `OR` logical operators. A sequence of restrictions // implicitly uses `AND`. * A restriction has the form of `{field} -// {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported -// fields: - `locationType` Examples: * All regional location list: -// `locationType="TARGETING_LOCATION_TYPE_REGIONAL" * All proximity -// location list: `locationType="TARGETING_LOCATION_TYPE_PROXIMITY" +// {operator} {value}`. * All fields must use the `EQUALS (=)` operator. +// Supported fields: * `locationType` Examples: * All regional location +// list: `locationType="TARGETING_LOCATION_TYPE_REGIONAL" * All +// proximity location list: +// `locationType="TARGETING_LOCATION_TYPE_PROXIMITY" The length of this +// field should be no more than 500 characters. Reference our filter +// `LIST` requests (/display-video/api/guides/how-tos/filters) guide for +// more information. func (c *AdvertisersLocationListsListCall) Filter(filter string) *AdvertisersLocationListsListCall { c.urlParams_.Set("filter", filter) return c @@ -27684,7 +27793,7 @@ func (c *AdvertisersLocationListsListCall) Do(opts ...googleapi.CallOption) (*Li // "type": "string" // }, // "filter": { - // "description": "Allows filtering by location list fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `locationType` Examples: * All regional location list: `locationType=\"TARGETING_LOCATION_TYPE_REGIONAL\"` * All proximity location list: `locationType=\"TARGETING_LOCATION_TYPE_PROXIMITY\"`", + // "description": "Allows filtering by location list fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `locationType` Examples: * All regional location list: `locationType=\"TARGETING_LOCATION_TYPE_REGIONAL\"` * All proximity location list: `locationType=\"TARGETING_LOCATION_TYPE_PROXIMITY\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -28415,10 +28524,13 @@ func (r *AdvertisersLocationListsAssignedLocationsService) List(advertiserId int // Filter sets the optional parameter "filter": Allows filtering by // location list assignment fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `assignedLocationId` The length of this -// field should be no more than 500 characters. +// can be combined by the `OR` logical operator. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * `assignedLocationId` The +// length of this field should be no more than 500 characters. Reference +// our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersLocationListsAssignedLocationsListCall) Filter(filter string) *AdvertisersLocationListsAssignedLocationsListCall { c.urlParams_.Set("filter", filter) return c @@ -28570,7 +28682,7 @@ func (c *AdvertisersLocationListsAssignedLocationsListCall) Do(opts ...googleapi // "type": "string" // }, // "filter": { - // "description": "Allows filtering by location list assignment fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedLocationId` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by location list assignment fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedLocationId` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -28644,7 +28756,11 @@ type AdvertisersManualTriggersActivateCall struct { // Activate: Activates a manual trigger. Each activation of the manual // trigger must be at least 5 minutes apart, otherwise an error will be -// returned. +// returned. **Warning:** Line Items using manual triggers will stop +// serving in Display & Video 360 on **May 17, 2023**. Read our feature +// deprecation announcement +// (/display-video/api/deprecations#features.manual_triggers) for more +// information. // // - advertiserId: The ID of the advertiser that the manual trigger // belongs. @@ -28749,7 +28865,7 @@ func (c *AdvertisersManualTriggersActivateCall) Do(opts ...googleapi.CallOption) } return ret, nil // { - // "description": "Activates a manual trigger. Each activation of the manual trigger must be at least 5 minutes apart, otherwise an error will be returned.", + // "description": "Activates a manual trigger. Each activation of the manual trigger must be at least 5 minutes apart, otherwise an error will be returned. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", // "flatPath": "v1/advertisers/{advertisersId}/manualTriggers/{manualTriggersId}:activate", // "httpMethod": "POST", // "id": "displayvideo.advertisers.manualTriggers.activate", @@ -28801,7 +28917,11 @@ type AdvertisersManualTriggersCreateCall struct { } // Create: Creates a new manual trigger. Returns the newly created -// manual trigger if successful. +// manual trigger if successful. **Warning:** Line Items using manual +// triggers will stop serving in Display & Video 360 on **May 17, +// 2023**. Read our feature deprecation announcement +// (/display-video/api/deprecations#features.manual_triggers) for more +// information. // // - advertiserId: Immutable. The unique ID of the advertiser that the // manual trigger belongs to. @@ -28903,7 +29023,7 @@ func (c *AdvertisersManualTriggersCreateCall) Do(opts ...googleapi.CallOption) ( } return ret, nil // { - // "description": "Creates a new manual trigger. Returns the newly created manual trigger if successful.", + // "description": "Creates a new manual trigger. Returns the newly created manual trigger if successful. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", // "flatPath": "v1/advertisers/{advertisersId}/manualTriggers", // "httpMethod": "POST", // "id": "displayvideo.advertisers.manualTriggers.create", @@ -28946,7 +29066,11 @@ type AdvertisersManualTriggersDeactivateCall struct { header_ http.Header } -// Deactivate: Deactivates a manual trigger. +// Deactivate: Deactivates a manual trigger. **Warning:** Line Items +// using manual triggers will stop serving in Display & Video 360 on +// **May 17, 2023**. Read our feature deprecation announcement +// (/display-video/api/deprecations#features.manual_triggers) for more +// information. // // - advertiserId: The ID of the advertiser that the manual trigger // belongs. @@ -29051,7 +29175,7 @@ func (c *AdvertisersManualTriggersDeactivateCall) Do(opts ...googleapi.CallOptio } return ret, nil // { - // "description": "Deactivates a manual trigger.", + // "description": "Deactivates a manual trigger. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", // "flatPath": "v1/advertisers/{advertisersId}/manualTriggers/{manualTriggersId}:deactivate", // "httpMethod": "POST", // "id": "displayvideo.advertisers.manualTriggers.deactivate", @@ -29103,7 +29227,11 @@ type AdvertisersManualTriggersGetCall struct { header_ http.Header } -// Get: Gets a manual trigger. +// Get: Gets a manual trigger. **Warning:** Line Items using manual +// triggers will stop serving in Display & Video 360 on **May 17, +// 2023**. Read our feature deprecation announcement +// (/display-video/api/deprecations#features.manual_triggers) for more +// information. // // - advertiserId: The ID of the advertiser this manual trigger belongs // to. @@ -29215,7 +29343,7 @@ func (c *AdvertisersManualTriggersGetCall) Do(opts ...googleapi.CallOption) (*Ma } return ret, nil // { - // "description": "Gets a manual trigger.", + // "description": "Gets a manual trigger. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", // "flatPath": "v1/advertisers/{advertisersId}/manualTriggers/{manualTriggersId}", // "httpMethod": "GET", // "id": "displayvideo.advertisers.manualTriggers.get", @@ -29265,7 +29393,11 @@ type AdvertisersManualTriggersListCall struct { // List: Lists manual triggers that are accessible to the current user // for a given advertiser ID. The order is defined by the order_by -// parameter. A single advertiser_id is required. +// parameter. A single advertiser_id is required. **Warning:** Line +// Items using manual triggers will stop serving in Display & Video 360 +// on **May 17, 2023**. Read our feature deprecation announcement +// (/display-video/api/deprecations#features.manual_triggers) for more +// information. // // - advertiserId: The ID of the advertiser that the fetched manual // triggers belong to. @@ -29276,14 +29408,16 @@ func (r *AdvertisersManualTriggersService) List(advertiserId int64) *Advertisers } // Filter sets the optional parameter "filter": Allows filtering by -// manual trigger properties. Supported syntax: * Filter expressions are +// manual trigger fields. Supported syntax: * Filter expressions are // made up of one or more restrictions. * Restrictions can be combined // by `AND` or `OR` logical operators. A sequence of restrictions // implicitly uses `AND`. * A restriction has the form of `{field} -// {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported -// fields: - `displayName` - `state` Examples: * All active manual -// triggers under an advertiser: `state="ACTIVE" The length of this -// field should be no more than 500 characters. +// {operator} {value}`. * All fields must use the `EQUALS (=)` operator. +// Supported fields: * `displayName` * `state` Examples: * All active +// manual triggers under an advertiser: `state="ACTIVE" The length of +// this field should be no more than 500 characters. Reference our +// filter `LIST` requests (/display-video/api/guides/how-tos/filters) +// guide for more information. func (c *AdvertisersManualTriggersListCall) Filter(filter string) *AdvertisersManualTriggersListCall { c.urlParams_.Set("filter", filter) return c @@ -29415,7 +29549,7 @@ func (c *AdvertisersManualTriggersListCall) Do(opts ...googleapi.CallOption) (*L } return ret, nil // { - // "description": "Lists manual triggers that are accessible to the current user for a given advertiser ID. The order is defined by the order_by parameter. A single advertiser_id is required.", + // "description": "Lists manual triggers that are accessible to the current user for a given advertiser ID. The order is defined by the order_by parameter. A single advertiser_id is required. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", // "flatPath": "v1/advertisers/{advertisersId}/manualTriggers", // "httpMethod": "GET", // "id": "displayvideo.advertisers.manualTriggers.list", @@ -29432,7 +29566,7 @@ func (c *AdvertisersManualTriggersListCall) Do(opts ...googleapi.CallOption) (*L // "type": "string" // }, // "filter": { - // "description": "Allows filtering by manual trigger properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `displayName` - `state` Examples: * All active manual triggers under an advertiser: `state=\"ACTIVE\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by manual trigger fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `displayName` * `state` Examples: * All active manual triggers under an advertiser: `state=\"ACTIVE\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -29498,7 +29632,11 @@ type AdvertisersManualTriggersPatchCall struct { } // Patch: Updates a manual trigger. Returns the updated manual trigger -// if successful. +// if successful. **Warning:** Line Items using manual triggers will +// stop serving in Display & Video 360 on **May 17, 2023**. Read our +// feature deprecation announcement +// (/display-video/api/deprecations#features.manual_triggers) for more +// information. // // - advertiserId: Immutable. The unique ID of the advertiser that the // manual trigger belongs to. @@ -29610,7 +29748,7 @@ func (c *AdvertisersManualTriggersPatchCall) Do(opts ...googleapi.CallOption) (* } return ret, nil // { - // "description": "Updates a manual trigger. Returns the updated manual trigger if successful.", + // "description": "Updates a manual trigger. Returns the updated manual trigger if successful. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", // "flatPath": "v1/advertisers/{advertisersId}/manualTriggers/{manualTriggersId}", // "httpMethod": "PATCH", // "id": "displayvideo.advertisers.manualTriggers.patch", @@ -30988,11 +31126,14 @@ func (r *AdvertisersNegativeKeywordListsNegativeKeywordsService) List(advertiser // Filter sets the optional parameter "filter": Allows filtering by // negative keyword fields. Supported syntax: * Filter expressions for -// negative keyword currently can only contain at most one * -// restriction. * A restriction has the form of `{field} {operator} -// {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: -// - `keywordValue` Examples: * All negative keywords for which the -// keyword value contains "google": `keywordValue : "google" +// negative keywords can only contain at most one restriction. * A +// restriction has the form of `{field} {operator} {value}`. * All +// fields must use the `HAS (:)` operator. Supported fields: * +// `keywordValue` Examples: * All negative keywords for which the +// keyword value contains "google": `keywordValue : "google" The length +// of this field should be no more than 500 characters. Reference our +// filter `LIST` requests (/display-video/api/guides/how-tos/filters) +// guide for more information. func (c *AdvertisersNegativeKeywordListsNegativeKeywordsListCall) Filter(filter string) *AdvertisersNegativeKeywordListsNegativeKeywordsListCall { c.urlParams_.Set("filter", filter) return c @@ -31145,7 +31286,7 @@ func (c *AdvertisersNegativeKeywordListsNegativeKeywordsListCall) Do(opts ...goo // "type": "string" // }, // "filter": { - // "description": "Allows filtering by negative keyword fields. Supported syntax: * Filter expressions for negative keyword currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `keywordValue` Examples: * All negative keywords for which the keyword value contains \"google\": `keywordValue : \"google\"`", + // "description": "Allows filtering by negative keyword fields. Supported syntax: * Filter expressions for negative keywords can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `keywordValue` Examples: * All negative keywords for which the keyword value contains \"google\": `keywordValue : \"google\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -31588,7 +31729,7 @@ func (c *AdvertisersTargetingTypesAssignedTargetingOptionsCreateCall) Do(opts .. // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -31849,7 +31990,7 @@ func (c *AdvertisersTargetingTypesAssignedTargetingOptionsDeleteCall) Do(opts .. // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -32123,7 +32264,7 @@ func (c *AdvertisersTargetingTypesAssignedTargetingOptionsGetCall) Do(opts ...go // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -32183,14 +32324,16 @@ func (r *AdvertisersTargetingTypesAssignedTargetingOptionsService) List(advertis } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `assignedTargetingOptionId` Examples: * -// AssignedTargetingOption with ID 123456 -// `assignedTargetingOptionId="123456" The length of this field should -// be no more than 500 characters. +// can be combined by the `OR` logical operator. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * +// `assignedTargetingOptionId` Examples: * `AssignedTargetingOption` +// with ID 123456: `assignedTargetingOptionId="123456" The length of +// this field should be no more than 500 characters. Reference our +// filter `LIST` requests (/display-video/api/guides/how-tos/filters) +// guide for more information. func (c *AdvertisersTargetingTypesAssignedTargetingOptionsListCall) Filter(filter string) *AdvertisersTargetingTypesAssignedTargetingOptionsListCall { c.urlParams_.Set("filter", filter) return c @@ -32345,7 +32488,7 @@ func (c *AdvertisersTargetingTypesAssignedTargetingOptionsListCall) Do(opts ...g // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` Examples: * AssignedTargetingOption with ID 123456 `assignedTargetingOptionId=\"123456\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` Examples: * `AssignedTargetingOption` with ID 123456: `assignedTargetingOptionId=\"123456\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -32449,7 +32592,7 @@ func (c *AdvertisersTargetingTypesAssignedTargetingOptionsListCall) Do(opts ...g // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -32700,12 +32843,14 @@ func (c *CombinedAudiencesListCall) AdvertiserId(advertiserId int64) *CombinedAu // Filter sets the optional parameter "filter": Allows filtering by // combined audience fields. Supported syntax: * Filter expressions for -// combined audiences currently can only contain at most one -// restriction. * A restriction has the form of `{field} {operator} -// {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: -// - `displayName` Examples: * All combined audiences for which the +// combined audiences can only contain at most one restriction. * A +// restriction has the form of `{field} {operator} {value}`. * All +// fields must use the `HAS (:)` operator. Supported fields: * +// `displayName` Examples: * All combined audiences for which the // display name contains "Google": `displayName : "Google". The length -// of this field should be no more than 500 characters. +// of this field should be no more than 500 characters. Reference our +// filter `LIST` requests (/display-video/api/guides/how-tos/filters) +// guide for more information. func (c *CombinedAudiencesListCall) Filter(filter string) *CombinedAudiencesListCall { c.urlParams_.Set("filter", filter) return c @@ -32856,7 +33001,7 @@ func (c *CombinedAudiencesListCall) Do(opts ...googleapi.CallOption) (*ListCombi // "type": "string" // }, // "filter": { - // "description": "Allows filtering by combined audience fields. Supported syntax: * Filter expressions for combined audiences currently can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All combined audiences for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by combined audience fields. Supported syntax: * Filter expressions for combined audiences can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All combined audiences for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -33243,21 +33388,18 @@ func (c *CustomBiddingAlgorithmsListCall) AdvertiserId(advertiserId int64) *Cust // Filter sets the optional parameter "filter": Allows filtering by // custom bidding algorithm fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by `AND`. A sequence of restrictions * implicitly -// uses `AND`. * A restriction has the form of `{field} {operator} -// {value}`. * The operator must be `CONTAINS (:)` or `EQUALS (=)`. * -// The operator must be `CONTAINS (:)` for the following field: - -// `displayName` * The operator must be `EQUALS (=)` for the following -// field: - `customBiddingAlgorithmType` * For `displayName`, the value -// is a string. We return all custom bidding algorithms whose -// display_name contains such string. * For -// `customBiddingAlgorithmType`, the value is a string. We return all -// algorithms whose custom_bidding_algorithm_type is equal to the given -// type. Examples: * All custom bidding algorithms for which the display -// name contains "politics": `displayName:politics`. * All custom -// bidding algorithms for which the type is "SCRIPT_BASED": +// can be combined by `AND`. A sequence of restrictions implicitly uses +// `AND`. * A restriction has the form of `{field} {operator} {value}`. +// * The `customBiddingAlgorithmType` field must use the `EQUALS (=)` +// operator. * The `displayName` field must use the `HAS (:)` operator. +// Supported fields: * `customBiddingAlgorithmType` * `displayName` +// Examples: * All custom bidding algorithms for which the display name +// contains "politics": `displayName:"politics". * All custom bidding +// algorithms for which the type is "SCRIPT_BASED": // `customBiddingAlgorithmType=SCRIPT_BASED` The length of this field -// should be no more than 500 characters. +// should be no more than 500 characters. Reference our filter `LIST` +// requests (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *CustomBiddingAlgorithmsListCall) Filter(filter string) *CustomBiddingAlgorithmsListCall { c.urlParams_.Set("filter", filter) return c @@ -33409,7 +33551,7 @@ func (c *CustomBiddingAlgorithmsListCall) Do(opts ...googleapi.CallOption) (*Lis // "type": "string" // }, // "filter": { - // "description": "Allows filtering by custom bidding algorithm fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND`. A sequence of restrictions * implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)` or `EQUALS (=)`. * The operator must be `CONTAINS (:)` for the following field: - `displayName` * The operator must be `EQUALS (=)` for the following field: - `customBiddingAlgorithmType` * For `displayName`, the value is a string. We return all custom bidding algorithms whose display_name contains such string. * For `customBiddingAlgorithmType`, the value is a string. We return all algorithms whose custom_bidding_algorithm_type is equal to the given type. Examples: * All custom bidding algorithms for which the display name contains \"politics\": `displayName:politics`. * All custom bidding algorithms for which the type is \"SCRIPT_BASED\": `customBiddingAlgorithmType=SCRIPT_BASED` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by custom bidding algorithm fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND`. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `customBiddingAlgorithmType` field must use the `EQUALS (=)` operator. * The `displayName` field must use the `HAS (:)` operator. Supported fields: * `customBiddingAlgorithmType` * `displayName` Examples: * All custom bidding algorithms for which the display name contains \"politics\": `displayName:\"politics\"`. * All custom bidding algorithms for which the type is \"SCRIPT_BASED\": `customBiddingAlgorithmType=SCRIPT_BASED` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -34593,12 +34735,14 @@ func (c *CustomListsListCall) AdvertiserId(advertiserId int64) *CustomListsListC // Filter sets the optional parameter "filter": Allows filtering by // custom list fields. Supported syntax: * Filter expressions for custom -// lists currently can only contain at most one restriction. * A -// restriction has the form of `{field} {operator} {value}`. * The -// operator must be `CONTAINS (:)`. * Supported fields: - `displayName` -// Examples: * All custom lists for which the display name contains -// "Google": `displayName : "Google". The length of this field should -// be no more than 500 characters. +// lists can only contain at most one restriction. * A restriction has +// the form of `{field} {operator} {value}`. * All fields must use the +// `HAS (:)` operator. Supported fields: * `displayName` Examples: * All +// custom lists for which the display name contains "Google": +// `displayName:"Google". The length of this field should be no more +// than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *CustomListsListCall) Filter(filter string) *CustomListsListCall { c.urlParams_.Set("filter", filter) return c @@ -34742,7 +34886,7 @@ func (c *CustomListsListCall) Do(opts ...googleapi.CallOption) (*ListCustomLists // "type": "string" // }, // "filter": { - // "description": "Allows filtering by custom list fields. Supported syntax: * Filter expressions for custom lists currently can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All custom lists for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by custom list fields. Supported syntax: * Filter expressions for custom lists can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All custom lists for which the display name contains \"Google\": `displayName:\"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -35286,13 +35430,15 @@ func (c *FirstAndThirdPartyAudiencesListCall) AdvertiserId(advertiserId int64) * // Filter sets the optional parameter "filter": Allows filtering by // first and third party audience fields. Supported syntax: * Filter -// expressions for first and third party audiences currently can only -// contain at most one restriction. * A restriction has the form of -// `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. -// * Supported fields: - `displayName` Examples: * All first and third +// expressions for first and third party audiences can only contain at +// most one restriction. * A restriction has the form of `{field} +// {operator} {value}`. * All fields must use the `HAS (:)` operator. +// Supported fields: * `displayName` Examples: * All first and third // party audiences for which the display name contains "Google": -// `displayName : "Google". The length of this field should be no more -// than 500 characters. +// `displayName:"Google". The length of this field should be no more +// than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *FirstAndThirdPartyAudiencesListCall) Filter(filter string) *FirstAndThirdPartyAudiencesListCall { c.urlParams_.Set("filter", filter) return c @@ -35445,7 +35591,7 @@ func (c *FirstAndThirdPartyAudiencesListCall) Do(opts ...googleapi.CallOption) ( // "type": "string" // }, // "filter": { - // "description": "Allows filtering by first and third party audience fields. Supported syntax: * Filter expressions for first and third party audiences currently can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All first and third party audiences for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by first and third party audience fields. Supported syntax: * Filter expressions for first and third party audiences can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All first and third party audiences for which the display name contains \"Google\": `displayName:\"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -36208,12 +36354,14 @@ func (c *GoogleAudiencesListCall) AdvertiserId(advertiserId int64) *GoogleAudien // Filter sets the optional parameter "filter": Allows filtering by // Google audience fields. Supported syntax: * Filter expressions for -// Google audiences currently can only contain at most one restriction. -// * A restriction has the form of `{field} {operator} {value}`. * The -// operator must be `CONTAINS (:)`. * Supported fields: - `displayName` -// Examples: * All Google audiences for which the display name contains -// "Google": `displayName : "Google". The length of this field should -// be no more than 500 characters. +// Google audiences can only contain at most one restriction. * A +// restriction has the form of `{field} {operator} {value}`. * All +// fields must use the `HAS (:)` operator. Supported fields: * +// `displayName` Examples: * All Google audiences for which the display +// name contains "Google": `displayName:"Google". The length of this +// field should be no more than 500 characters. Reference our filter +// `LIST` requests (/display-video/api/guides/how-tos/filters) guide for +// more information. func (c *GoogleAudiencesListCall) Filter(filter string) *GoogleAudiencesListCall { c.urlParams_.Set("filter", filter) return c @@ -36364,7 +36512,7 @@ func (c *GoogleAudiencesListCall) Do(opts ...googleapi.CallOption) (*ListGoogleA // "type": "string" // }, // "filter": { - // "description": "Allows filtering by Google audience fields. Supported syntax: * Filter expressions for Google audiences currently can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All Google audiences for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by Google audience fields. Supported syntax: * Filter expressions for Google audiences can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All Google audiences for which the display name contains \"Google\": `displayName:\"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -36922,18 +37070,20 @@ func (c *GuaranteedOrdersListCall) AdvertiserId(advertiserId int64) *GuaranteedO } // Filter sets the optional parameter "filter": Allows filtering by -// guaranteed order properties. * Filter expressions are made up of one -// or more restrictions. * Restrictions can be combined by `AND` or `OR` +// guaranteed order fields. * Filter expressions are made up of one or +// more restrictions. * Restrictions can be combined by `AND` or `OR` // logical operators. A sequence of restrictions implicitly uses `AND`. -// * A restriction has the form of `{field} {operator} {value}`. * The -// operator must be `EQUALS (=)`. * Supported fields: - -// `guaranteed_order_id` - `exchange` - `display_name` - +// * A restriction has the form of `{field} {operator} {value}`. * All +// fields must use the `EQUALS (=)` operator. Supported fields: * +// `guaranteed_order_id` * `exchange` * `display_name` * // `status.entityStatus` Examples: * All active guaranteed orders: // `status.entityStatus="ENTITY_STATUS_ACTIVE" * Guaranteed orders // belonging to Google Ad Manager or Rubicon exchanges: // `exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR // exchange="EXCHANGE_RUBICON" The length of this field should be no -// more than 500 characters. +// more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *GuaranteedOrdersListCall) Filter(filter string) *GuaranteedOrdersListCall { c.urlParams_.Set("filter", filter) return c @@ -37082,7 +37232,7 @@ func (c *GuaranteedOrdersListCall) Do(opts ...googleapi.CallOption) (*ListGuaran // "type": "string" // }, // "filter": { - // "description": "Allows filtering by guaranteed order properties. * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `guaranteed_order_id` - `exchange` - `display_name` - `status.entityStatus` Examples: * All active guaranteed orders: `status.entityStatus=\"ENTITY_STATUS_ACTIVE\"` * Guaranteed orders belonging to Google Ad Manager or Rubicon exchanges: `exchange=\"EXCHANGE_GOOGLE_AD_MANAGER\" OR exchange=\"EXCHANGE_RUBICON\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by guaranteed order fields. * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `guaranteed_order_id` * `exchange` * `display_name` * `status.entityStatus` Examples: * All active guaranteed orders: `status.entityStatus=\"ENTITY_STATUS_ACTIVE\"` * Guaranteed orders belonging to Google Ad Manager or Rubicon exchanges: `exchange=\"EXCHANGE_GOOGLE_AD_MANAGER\" OR exchange=\"EXCHANGE_RUBICON\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -37847,12 +37997,15 @@ func (c *InventorySourceGroupsListCall) AdvertiserId(advertiserId int64) *Invent } // Filter sets the optional parameter "filter": Allows filtering by -// inventory source group properties. Supported syntax: * Filter -// expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `inventorySourceGroupId` The length of -// this field should be no more than 500 characters. +// inventory source group fields. Supported syntax: * Filter expressions +// are made up of one or more restrictions. * Restrictions can be +// combined by the logical operator `OR`. * A restriction has the form +// of `{field} {operator} {value}`. * All fields must use the `EQUALS +// (=)` operator. Supported fields: * `inventorySourceGroupId` The +// length of this field should be no more than 500 characters. Reference +// our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *InventorySourceGroupsListCall) Filter(filter string) *InventorySourceGroupsListCall { c.urlParams_.Set("filter", filter) return c @@ -38003,7 +38156,7 @@ func (c *InventorySourceGroupsListCall) Do(opts ...googleapi.CallOption) (*ListI // "type": "string" // }, // "filter": { - // "description": "Allows filtering by inventory source group properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `inventorySourceGroupId` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by inventory source group fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `inventorySourceGroupId` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -38785,10 +38938,13 @@ func (c *InventorySourceGroupsAssignedInventorySourcesListCall) AdvertiserId(adv // Filter sets the optional parameter "filter": Allows filtering by // assigned inventory source fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `assignedInventorySourceId` The length of -// this field should be no more than 500 characters. +// can be combined by the `OR` logical operator. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * +// `assignedInventorySourceId` The length of this field should be no +// more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *InventorySourceGroupsAssignedInventorySourcesListCall) Filter(filter string) *InventorySourceGroupsAssignedInventorySourcesListCall { c.urlParams_.Set("filter", filter) return c @@ -38947,7 +39103,7 @@ func (c *InventorySourceGroupsAssignedInventorySourcesListCall) Do(opts ...googl // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned inventory source fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedInventorySourceId` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned inventory source fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedInventorySourceId` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -39500,19 +39656,21 @@ func (c *InventorySourcesListCall) AdvertiserId(advertiserId int64) *InventorySo } // Filter sets the optional parameter "filter": Allows filtering by -// inventory source properties. Supported syntax: * Filter expressions -// are made up of one or more restrictions. * Restrictions can be -// combined by `AND` or `OR` logical operators. A sequence of -// restrictions implicitly uses `AND`. * A restriction has the form of -// `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * -// Supported fields: - `status.entityStatus` - `commitment` - -// `deliveryMethod` - `rateDetails.rateType` - `exchange` Examples: * +// inventory source fields. Supported syntax: * Filter expressions are +// made up of one or more restrictions. * Restrictions can be combined +// by `AND` or `OR` logical operators. A sequence of restrictions +// implicitly uses `AND`. * A restriction has the form of `{field} +// {operator} {value}`. * All fields must use the `EQUALS (=)` operator. +// Supported fields: * `status.entityStatus` * `commitment` * +// `deliveryMethod` * `rateDetails.rateType` * `exchange` Examples: * // All active inventory sources: // `status.entityStatus="ENTITY_STATUS_ACTIVE" * Inventory sources // belonging to Google Ad Manager or Rubicon exchanges: // `exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR // exchange="EXCHANGE_RUBICON" The length of this field should be no -// more than 500 characters. +// more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *InventorySourcesListCall) Filter(filter string) *InventorySourcesListCall { c.urlParams_.Set("filter", filter) return c @@ -39661,7 +39819,7 @@ func (c *InventorySourcesListCall) Do(opts ...googleapi.CallOption) (*ListInvent // "type": "string" // }, // "filter": { - // "description": "Allows filtering by inventory source properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `status.entityStatus` - `commitment` - `deliveryMethod` - `rateDetails.rateType` - `exchange` Examples: * All active inventory sources: `status.entityStatus=\"ENTITY_STATUS_ACTIVE\"` * Inventory sources belonging to Google Ad Manager or Rubicon exchanges: `exchange=\"EXCHANGE_GOOGLE_AD_MANAGER\" OR exchange=\"EXCHANGE_RUBICON\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by inventory source fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `status.entityStatus` * `commitment` * `deliveryMethod` * `rateDetails.rateType` * `exchange` Examples: * All active inventory sources: `status.entityStatus=\"ENTITY_STATUS_ACTIVE\"` * Inventory sources belonging to Google Ad Manager or Rubicon exchanges: `exchange=\"EXCHANGE_GOOGLE_AD_MANAGER\" OR exchange=\"EXCHANGE_RUBICON\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -40615,14 +40773,16 @@ func (r *PartnersService) List() *PartnersListCall { } // Filter sets the optional parameter "filter": Allows filtering by -// partner properties. Supported syntax: * Filter expressions are made -// up of one or more restrictions. * Restrictions can be combined by -// `AND` or `OR` logical operators. A sequence of restrictions -// implicitly uses `AND`. * A restriction has the form of `{field} -// {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported -// fields: - `entityStatus` Examples: * All active partners: +// partner fields. Supported syntax: * Filter expressions are made up of +// one or more restrictions. * Restrictions can be combined by `AND` or +// `OR` logical operators. A sequence of restrictions implicitly uses +// `AND`. * A restriction has the form of `{field} {operator} {value}`. +// * All fields must use the `EQUALS (=)` operator. Supported fields: * +// `entityStatus` Examples: * All active partners: // `entityStatus="ENTITY_STATUS_ACTIVE" The length of this field should -// be no more than 500 characters. +// be no more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *PartnersListCall) Filter(filter string) *PartnersListCall { c.urlParams_.Set("filter", filter) return c @@ -40758,7 +40918,7 @@ func (c *PartnersListCall) Do(opts ...googleapi.CallOption) (*ListPartnersRespon // "parameterOrder": [], // "parameters": { // "filter": { - // "description": "Allows filtering by partner properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `entityStatus` Examples: * All active partners: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by partner fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `entityStatus` Examples: * All active partners: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -41170,12 +41330,14 @@ func (c *PartnersChannelsListCall) AdvertiserId(advertiserId int64) *PartnersCha // Filter sets the optional parameter "filter": Allows filtering by // channel fields. Supported syntax: * Filter expressions for channel -// currently can only contain at most one * restriction. * A restriction -// has the form of `{field} {operator} {value}`. * The operator must be -// `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All +// can only contain at most one restriction. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the `HAS +// (:)` operator. Supported fields: * `displayName` Examples: * All // channels for which the display name contains "google": `displayName : // "google". The length of this field should be no more than 500 -// characters. +// characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *PartnersChannelsListCall) Filter(filter string) *PartnersChannelsListCall { c.urlParams_.Set("filter", filter) return c @@ -41324,7 +41486,7 @@ func (c *PartnersChannelsListCall) Do(opts ...googleapi.CallOption) (*ListChanne // "type": "string" // }, // "filter": { - // "description": "Allows filtering by channel fields. Supported syntax: * Filter expressions for channel currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All channels for which the display name contains \"google\": `displayName : \"google\"`. The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by channel fields. Supported syntax: * Filter expressions for channel can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All channels for which the display name contains \"google\": `displayName : \"google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -42095,11 +42257,15 @@ func (c *PartnersChannelsSitesListCall) AdvertiserId(advertiserId int64) *Partne } // Filter sets the optional parameter "filter": Allows filtering by site -// fields. Supported syntax: * Filter expressions for site currently can -// only contain at most one * restriction. * A restriction has the form -// of `{field} {operator} {value}`. * The operator must be `CONTAINS -// (:)`. * Supported fields: - `urlOrAppId` Examples: * All sites for +// fields. Supported syntax: * Filter expressions for site retrieval can +// only contain at most one restriction. * A restriction has the form of +// `{field} {operator} {value}`. * All fields must use the `HAS (:)` +// operator. Supported fields: * `urlOrAppId` Examples: * All sites for // which the URL or app ID contains "google": `urlOrAppId : "google" +// The length of this field should be no more than 500 characters. +// Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *PartnersChannelsSitesListCall) Filter(filter string) *PartnersChannelsSitesListCall { c.urlParams_.Set("filter", filter) return c @@ -42258,7 +42424,7 @@ func (c *PartnersChannelsSitesListCall) Do(opts ...googleapi.CallOption) (*ListS // "type": "string" // }, // "filter": { - // "description": "Allows filtering by site fields. Supported syntax: * Filter expressions for site currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `urlOrAppId` Examples: * All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"`", + // "description": "Allows filtering by site fields. Supported syntax: * Filter expressions for site retrieval can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `urlOrAppId` Examples: * All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -42696,7 +42862,7 @@ func (c *PartnersTargetingTypesAssignedTargetingOptionsCreateCall) Do(opts ...go // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -42954,7 +43120,7 @@ func (c *PartnersTargetingTypesAssignedTargetingOptionsDeleteCall) Do(opts ...go // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -43224,7 +43390,7 @@ func (c *PartnersTargetingTypesAssignedTargetingOptionsGetCall) Do(opts ...googl // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -43280,14 +43446,17 @@ func (r *PartnersTargetingTypesAssignedTargetingOptionsService) List(partnerId i } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions // can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `assignedTargetingOptionId` Examples: * -// AssignedTargetingOption with ID 123456 -// `assignedTargetingOptionId="123456" The length of this field should -// be no more than 500 characters. +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * +// `assignedTargetingOptionId` Examples: * `AssignedTargetingOption` +// resource with ID 123456: `assignedTargetingOptionId="123456" The +// length of this field should be no more than 500 characters. Reference +// our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *PartnersTargetingTypesAssignedTargetingOptionsListCall) Filter(filter string) *PartnersTargetingTypesAssignedTargetingOptionsListCall { c.urlParams_.Set("filter", filter) return c @@ -43434,7 +43603,7 @@ func (c *PartnersTargetingTypesAssignedTargetingOptionsListCall) Do(opts ...goog // ], // "parameters": { // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` Examples: * AssignedTargetingOption with ID 123456 `assignedTargetingOptionId=\"123456\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` Examples: * `AssignedTargetingOption` resource with ID 123456: `assignedTargetingOptionId=\"123456\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -43546,7 +43715,7 @@ func (c *PartnersTargetingTypesAssignedTargetingOptionsListCall) Do(opts ...goog // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -44136,7 +44305,7 @@ func (c *TargetingTypesTargetingOptionsGetCall) Do(opts ...googleapi.CallOption) // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -44215,20 +44384,22 @@ func (c *TargetingTypesTargetingOptionsListCall) AdvertiserId(advertiserId int64 } // Filter sets the optional parameter "filter": Allows filtering by -// targeting option properties. Supported syntax: * Filter expressions -// are made up of one or more restrictions. * Restrictions can be -// combined by `OR` logical operators. * A restriction has the form of -// `{field} {operator} {value}`. * The operator must be "=" (equal -// sign). * Supported fields: - `carrierAndIspDetails.type` - -// `geoRegionDetails.geoRegionType` - `targetingOptionId` Examples: * +// targeting option fields. Supported syntax: * Filter expressions are +// made up of one or more restrictions. * Restrictions can be combined +// by `OR` logical operators. * A restriction has the form of `{field} +// {operator} {value}`. * All fields must use the `EQUALS (=)` operator. +// Supported fields: * `carrierAndIspDetails.type` * +// `geoRegionDetails.geoRegionType` * `targetingOptionId` Examples: * // All `GEO REGION` targeting options that belong to sub type // `GEO_REGION_TYPE_COUNTRY` or `GEO_REGION_TYPE_STATE`: // `geoRegionDetails.geoRegionType="GEO_REGION_TYPE_COUNTRY" OR // geoRegionDetails.geoRegionType="GEO_REGION_TYPE_STATE" * All // `CARRIER AND ISP` targeting options that belong to sub type // `CARRIER_AND_ISP_TYPE_CARRIER`: -// `carrierAndIspDetails.type="CARRIER_AND_ISP_TYPE_CARRIER". The -// length of this field should be no more than 500 characters. +// `carrierAndIspDetails.type="CARRIER_AND_ISP_TYPE_CARRIER" The length +// of this field should be no more than 500 characters. Reference our +// filter `LIST` requests (/display-video/api/guides/how-tos/filters) +// guide for more information. func (c *TargetingTypesTargetingOptionsListCall) Filter(filter string) *TargetingTypesTargetingOptionsListCall { c.urlParams_.Set("filter", filter) return c @@ -44377,7 +44548,7 @@ func (c *TargetingTypesTargetingOptionsListCall) Do(opts ...googleapi.CallOption // "type": "string" // }, // "filter": { - // "description": "Allows filtering by targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `OR` logical operators. * A restriction has the form of `{field} {operator} {value}`. * The operator must be \"=\" (equal sign). * Supported fields: - `carrierAndIspDetails.type` - `geoRegionDetails.geoRegionType` - `targetingOptionId` Examples: * All `GEO REGION` targeting options that belong to sub type `GEO_REGION_TYPE_COUNTRY` or `GEO_REGION_TYPE_STATE`: `geoRegionDetails.geoRegionType=\"GEO_REGION_TYPE_COUNTRY\" OR geoRegionDetails.geoRegionType=\"GEO_REGION_TYPE_STATE\"` * All `CARRIER AND ISP` targeting options that belong to sub type `CARRIER_AND_ISP_TYPE_CARRIER`: `carrierAndIspDetails.type=\"CARRIER_AND_ISP_TYPE_CARRIER\"`. The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `OR` logical operators. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `carrierAndIspDetails.type` * `geoRegionDetails.geoRegionType` * `targetingOptionId` Examples: * All `GEO REGION` targeting options that belong to sub type `GEO_REGION_TYPE_COUNTRY` or `GEO_REGION_TYPE_STATE`: `geoRegionDetails.geoRegionType=\"GEO_REGION_TYPE_COUNTRY\" OR geoRegionDetails.geoRegionType=\"GEO_REGION_TYPE_STATE\"` * All `CARRIER AND ISP` targeting options that belong to sub type `CARRIER_AND_ISP_TYPE_CARRIER`: `carrierAndIspDetails.type=\"CARRIER_AND_ISP_TYPE_CARRIER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -44481,7 +44652,7 @@ func (c *TargetingTypesTargetingOptionsListCall) Do(opts ...googleapi.CallOption // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -44740,7 +44911,7 @@ func (c *TargetingTypesTargetingOptionsSearchCall) Do(opts ...googleapi.CallOpti // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -44810,7 +44981,12 @@ type UsersBulkEditAssignedUserRolesCall struct { // operation will delete the assigned user roles provided in // BulkEditAssignedUserRolesRequest.deletedAssignedUserRoles and then // assign the user roles provided in -// BulkEditAssignedUserRolesRequest.createdAssignedUserRoles. +// BulkEditAssignedUserRolesRequest.createdAssignedUserRoles. This +// method has unique authentication requirements. Read the prerequisites +// in our Managing Users guide +// (/display-video/api/guides/users/overview#prerequisites) before using +// this method. The "Try this method" feature does not work for this +// method. // // - userId: The ID of the user to which the assigned user roles belong. func (r *UsersService) BulkEditAssignedUserRoles(userId int64, bulkeditassigneduserrolesrequest *BulkEditAssignedUserRolesRequest) *UsersBulkEditAssignedUserRolesCall { @@ -44912,7 +45088,7 @@ func (c *UsersBulkEditAssignedUserRolesCall) Do(opts ...googleapi.CallOption) (* } return ret, nil // { - // "description": "Bulk edits user roles for a user. The operation will delete the assigned user roles provided in BulkEditAssignedUserRolesRequest.deletedAssignedUserRoles and then assign the user roles provided in BulkEditAssignedUserRolesRequest.createdAssignedUserRoles.", + // "description": "Bulk edits user roles for a user. The operation will delete the assigned user roles provided in BulkEditAssignedUserRolesRequest.deletedAssignedUserRoles and then assign the user roles provided in BulkEditAssignedUserRolesRequest.createdAssignedUserRoles. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", // "flatPath": "v1/users/{usersId}:bulkEditAssignedUserRoles", // "httpMethod": "POST", // "id": "displayvideo.users.bulkEditAssignedUserRoles", @@ -44954,7 +45130,11 @@ type UsersCreateCall struct { } // Create: Creates a new user. Returns the newly created user if -// successful. +// successful. This method has unique authentication requirements. Read +// the prerequisites in our Managing Users guide +// (/display-video/api/guides/users/overview#prerequisites) before using +// this method. The "Try this method" feature does not work for this +// method. func (r *UsersService) Create(user *User) *UsersCreateCall { c := &UsersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.user = user @@ -45049,7 +45229,7 @@ func (c *UsersCreateCall) Do(opts ...googleapi.CallOption) (*User, error) { } return ret, nil // { - // "description": "Creates a new user. Returns the newly created user if successful.", + // "description": "Creates a new user. Returns the newly created user if successful. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", // "flatPath": "v1/users", // "httpMethod": "POST", // "id": "displayvideo.users.create", @@ -45079,7 +45259,11 @@ type UsersDeleteCall struct { header_ http.Header } -// Delete: Deletes a user. +// Delete: Deletes a user. This method has unique authentication +// requirements. Read the prerequisites in our Managing Users guide +// (/display-video/api/guides/users/overview#prerequisites) before using +// this method. The "Try this method" feature does not work for this +// method. // // - userId: The ID of the user to delete. func (r *UsersService) Delete(userId int64) *UsersDeleteCall { @@ -45174,7 +45358,7 @@ func (c *UsersDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { } return ret, nil // { - // "description": "Deletes a user.", + // "description": "Deletes a user. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", // "flatPath": "v1/users/{usersId}", // "httpMethod": "DELETE", // "id": "displayvideo.users.delete", @@ -45213,7 +45397,11 @@ type UsersGetCall struct { header_ http.Header } -// Get: Gets a user. +// Get: Gets a user. This method has unique authentication requirements. +// Read the prerequisites in our Managing Users guide +// (/display-video/api/guides/users/overview#prerequisites) before using +// this method. The "Try this method" feature does not work for this +// method. // // - userId: The ID of the user to fetch. func (r *UsersService) Get(userId int64) *UsersGetCall { @@ -45321,7 +45509,7 @@ func (c *UsersGetCall) Do(opts ...googleapi.CallOption) (*User, error) { } return ret, nil // { - // "description": "Gets a user.", + // "description": "Gets a user. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", // "flatPath": "v1/users/{usersId}", // "httpMethod": "GET", // "id": "displayvideo.users.get", @@ -45361,37 +45549,44 @@ type UsersListCall struct { // List: Lists users that are accessible to the current user. If two // users have user roles on the same partner or advertiser, they can -// access each other. +// access each other. This method has unique authentication +// requirements. Read the prerequisites in our Managing Users guide +// (/display-video/api/guides/users/overview#prerequisites) before using +// this method. The "Try this method" feature does not work for this +// method. func (r *UsersService) List() *UsersListCall { c := &UsersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c } // Filter sets the optional parameter "filter": Allows filtering by user -// properties. Supported syntax: * Filter expressions are made up of one -// or more restrictions. * Restrictions can be combined by the logical +// fields. Supported syntax: * Filter expressions are made up of one or +// more restrictions. * Restrictions can be combined by the logical // operator `AND`. * A restriction has the form of `{field} {operator} -// {value}`. * The operator must be `CONTAINS (:)` or `EQUALS (=)`. * -// The operator must be `CONTAINS (:)` for the following fields: - -// `displayName` - `email` * The operator must be `EQUALS (=)` for the -// following fields: - `assignedUserRole.userRole` - -// `assignedUserRole.partnerId` - `assignedUserRole.advertiserId` - -// `assignedUserRole.entityType`: A synthetic field of AssignedUserRole -// used for filtering. Identifies the type of entity to which the user -// role is assigned. Valid values are `Partner` and `Advertiser`. - -// `assignedUserRole.parentPartnerId`: A synthetic field of -// AssignedUserRole used for filtering. Identifies the parent partner of -// the entity to which the user role is assigned." Examples: * The user -// with displayName containing `foo`: `displayName:"foo" * The user -// with email containing `bar`: `email:"bar" * All users with standard -// user roles: `assignedUserRole.userRole="STANDARD" * All users with -// user roles for partner 123: `assignedUserRole.partnerId="123" * All -// users with user roles for advertiser 123: -// `assignedUserRole.advertiserId="123" * All users with partner level -// user roles: `entityType="PARTNER" * All users with user roles for -// partner 123 and advertisers under partner 123: -// `parentPartnerId="123" The length of this field should be no more -// than 500 characters. +// {value}`. * The `budget.budget_segments.date_range.end_date` field +// must use the `LESS THAN (<)` operator. * The `displayName and `email` +// field must use the `HAS (:)` operator. * All other fields must use +// the `EQUALS (=)` operator. Supported fields: * +// `assignedUserRole.advertiserId` * `assignedUserRole.entityType` * +// This is synthetic field of `AssignedUserRole` used for filtering. +// Identifies the type of entity to which the user role is assigned. +// Valid values are `Partner` and `Advertiser`. * +// `assignedUserRole.parentPartnerId` * This is a synthetic field of +// `AssignedUserRole` used for filtering. Identifies the parent partner +// of the entity to which the user role is assigned. * +// `assignedUserRole.partnerId` * `assignedUserRole.userRole` * +// `displayName` * `email` Examples: * The user with `displayName` +// containing "foo": `displayName:"foo" * The user with `email` +// containing "bar": `email:"bar" * All users with standard user roles: +// `assignedUserRole.userRole="STANDARD" * All users with user roles +// for partner 123: `assignedUserRole.partnerId="123" * All users with +// user roles for advertiser 123: `assignedUserRole.advertiserId="123" +// * All users with partner level user roles: `entityType="PARTNER" * +// All users with user roles for partner 123 and advertisers under +// partner 123: `parentPartnerId="123" The length of this field should +// be no more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *UsersListCall) Filter(filter string) *UsersListCall { c.urlParams_.Set("filter", filter) return c @@ -45520,14 +45715,14 @@ func (c *UsersListCall) Do(opts ...googleapi.CallOption) (*ListUsersResponse, er } return ret, nil // { - // "description": "Lists users that are accessible to the current user. If two users have user roles on the same partner or advertiser, they can access each other.", + // "description": "Lists users that are accessible to the current user. If two users have user roles on the same partner or advertiser, they can access each other. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", // "flatPath": "v1/users", // "httpMethod": "GET", // "id": "displayvideo.users.list", // "parameterOrder": [], // "parameters": { // "filter": { - // "description": "Allows filtering by user properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)` or `EQUALS (=)`. * The operator must be `CONTAINS (:)` for the following fields: - `displayName` - `email` * The operator must be `EQUALS (=)` for the following fields: - `assignedUserRole.userRole` - `assignedUserRole.partnerId` - `assignedUserRole.advertiserId` - `assignedUserRole.entityType`: A synthetic field of AssignedUserRole used for filtering. Identifies the type of entity to which the user role is assigned. Valid values are `Partner` and `Advertiser`. - `assignedUserRole.parentPartnerId`: A synthetic field of AssignedUserRole used for filtering. Identifies the parent partner of the entity to which the user role is assigned.\" Examples: * The user with displayName containing `foo`: `displayName:\"foo\"` * The user with email containing `bar`: `email:\"bar\"` * All users with standard user roles: `assignedUserRole.userRole=\"STANDARD\"` * All users with user roles for partner 123: `assignedUserRole.partnerId=\"123\"` * All users with user roles for advertiser 123: `assignedUserRole.advertiserId=\"123\"` * All users with partner level user roles: `entityType=\"PARTNER\"` * All users with user roles for partner 123 and advertisers under partner 123: `parentPartnerId=\"123\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by user fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `budget.budget_segments.date_range.end_date` field must use the `LESS THAN (\u003c)` operator. * The `displayName and `email` field must use the `HAS (:)` operator. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `assignedUserRole.advertiserId` * `assignedUserRole.entityType` * This is synthetic field of `AssignedUserRole` used for filtering. Identifies the type of entity to which the user role is assigned. Valid values are `Partner` and `Advertiser`. * `assignedUserRole.parentPartnerId` * This is a synthetic field of `AssignedUserRole` used for filtering. Identifies the parent partner of the entity to which the user role is assigned. * `assignedUserRole.partnerId` * `assignedUserRole.userRole` * `displayName` * `email` Examples: * The user with `displayName` containing \"foo\": `displayName:\"foo\"` * The user with `email` containing \"bar\": `email:\"bar\"` * All users with standard user roles: `assignedUserRole.userRole=\"STANDARD\"` * All users with user roles for partner 123: `assignedUserRole.partnerId=\"123\"` * All users with user roles for advertiser 123: `assignedUserRole.advertiserId=\"123\"` * All users with partner level user roles: `entityType=\"PARTNER\"` * All users with user roles for partner 123 and advertisers under partner 123: `parentPartnerId=\"123\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -45592,7 +45787,11 @@ type UsersPatchCall struct { } // Patch: Updates an existing user. Returns the updated user if -// successful. +// successful. This method has unique authentication requirements. Read +// the prerequisites in our Managing Users guide +// (/display-video/api/guides/users/overview#prerequisites) before using +// this method. The "Try this method" feature does not work for this +// method. // // - userId: Output only. The unique ID of the user. Assigned by the // system. @@ -45701,7 +45900,7 @@ func (c *UsersPatchCall) Do(opts ...googleapi.CallOption) (*User, error) { } return ret, nil // { - // "description": "Updates an existing user. Returns the updated user if successful.", + // "description": "Updates an existing user. Returns the updated user if successful. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", // "flatPath": "v1/users/{usersId}", // "httpMethod": "PATCH", // "id": "displayvideo.users.patch", diff --git a/displayvideo/v2/displayvideo-api.json b/displayvideo/v2/displayvideo-api.json index ea4f83a704f..d7bb0a3ec7a 100644 --- a/displayvideo/v2/displayvideo-api.json +++ b/displayvideo/v2/displayvideo-api.json @@ -255,7 +255,7 @@ "parameterOrder": [], "parameters": { "filter": { - "description": "Allows filtering by advertiser properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)`. * The operator must be `EQUALS (=)`. * Supported fields: - `advertiserId` - `displayName` - `entityStatus` - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All active advertisers under a partner: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` * All advertisers with an update time less than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All advertisers with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by advertiser fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. * A restriction has the form of `{field} {operator} {value}`. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `advertiserId` * `displayName` * `entityStatus` * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * All active advertisers under a partner: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` * All advertisers with an update time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All advertisers with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -308,7 +308,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`.. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` Examples: * targetingType with value TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_CHANNEL\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=) operator`. Supported fields: * `targetingType` Examples: * targetingType with value TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_CHANNEL\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -541,7 +541,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by campaign properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)`. * The operator must be `EQUALS (=)`. * Supported fields: - `campaignId` - `displayName` - `entityStatus` - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` campaigns under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\")` * All campaigns with an update time less than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All campaigns with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by campaign fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `campaignId` * `displayName` * `entityStatus` * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` campaigns under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\")` * All campaigns with an update time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All campaigns with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -598,7 +598,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` - `inheritance` Examples: * AssignedTargetingOptions of targeting type TARGETING_TYPE_LANGUAGE or TARGETING_TYPE_GENDER `targetingType=\"TARGETING_TYPE_LANGUAGE\" OR targetingType=\"TARGETING_TYPE_GENDER\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `targetingType` * `inheritance` Examples: * `AssignedTargetingOption` resources of targeting type `TARGETING_TYPE_LANGUAGE` or `TARGETING_TYPE_GENDER`: `targetingType=\"TARGETING_TYPE_LANGUAGE\" OR targetingType=\"TARGETING_TYPE_GENDER\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -800,7 +800,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -859,7 +859,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` - `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` * `inheritance` Examples: * `AssignedTargetingOption` resources with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER` `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -966,7 +966,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -1099,7 +1099,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by channel fields. Supported syntax: * Filter expressions for channel currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All channels for which the display name contains \"google\": `displayName : \"google\"`. The length of this field should be no more than 500 characters.", + "description": "Allows filtering by channel fields. Supported syntax: * Filter expressions for channel can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All channels for which the display name contains \"google\": `displayName : \"google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -1342,7 +1342,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by site fields. Supported syntax: * Filter expressions for site currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `urlOrAppId` Examples: * All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"`", + "description": "Allows filtering by site fields. Supported syntax: * Filter expressions for site retrieval can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `urlOrAppId` Examples: * All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -1537,7 +1537,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by creative properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restriction for the same field must be combined by `OR`. * Restriction for different fields must be combined by `AND`. * Between `(` and `)` there can only be restrictions combined by `OR` for the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)` for the following fields: - `entityStatus` - `creativeType`. - `dimensions` - `minDuration` - `maxDuration` - `approvalStatus` - `exchangeReviewStatus` - `dynamic` - `creativeId` * The operator must be `HAS (:)` for the following fields: - `lineItemIds` * The operator must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` for the following fields: - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) * For `entityStatus`, `minDuration`, `maxDuration`, `updateTime`, and `dynamic`, there may be at most one restriction. * For `dimensions`, the value is in the form of `\"{width}x{height}\"`. * For `exchangeReviewStatus`, the value is in the form of `{exchange}-{reviewStatus}`. * For `minDuration` and `maxDuration`, the value is in the form of `\"{duration}s\"`. Only seconds are supported with millisecond granularity. * For `updateTime`, a creative resource's field value reflects the last time that a creative has been updated, which includes updates made by the system (e.g. creative review updates). * There may be multiple `lineItemIds` restrictions in order to search against multiple possible line item IDs. * There may be multiple `creativeId` restrictions in order to search against multiple possible creative IDs. Examples: * All native creatives: `creativeType=\"CREATIVE_TYPE_NATIVE\"` * All active creatives with 300x400 or 50x100 dimensions: `entityStatus=\"ENTITY_STATUS_ACTIVE\" AND (dimensions=\"300x400\" OR dimensions=\"50x100\")` * All dynamic creatives that are approved by AdX or AppNexus, with a minimum duration of 5 seconds and 200ms. `dynamic=\"true\" AND minDuration=\"5.2s\" AND (exchangeReviewStatus=\"EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED\" OR exchangeReviewStatus=\"EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED\")` * All video creatives that are associated with line item ID 1 or 2: `creativeType=\"CREATIVE_TYPE_VIDEO\" AND (lineItemIds:1 OR lineItemIds:2)` * Find creatives by multiple creative IDs: `creativeId=1 OR creativeId=2` * All creatives with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by creative fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `lineItemIds` field must use the `HAS (:)` operator. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * All other fields must use the `EQUALS (=)` operator. * For `entityStatus`, `minDuration`, `maxDuration`, `updateTime`, and `dynamic` fields, there may be at most one restriction. Supported Fields: * `approvalStatus` * `creativeId` * `creativeType` * `dimensions` (input in the form of `{width}x{height}`) * `dynamic` * `entityStatus` * `exchangeReviewStatus` (input in the form of `{exchange}-{reviewStatus}`) * `lineItemIds` * `maxDuration` (input in the form of `{duration}s`. Only seconds are supported) * `minDuration` (input in the form of `{duration}s`. Only seconds are supported) * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Notes: * For `updateTime`, a creative resource's field value reflects the last time that a creative has been updated, which includes updates made by the system (e.g. creative review updates). Examples: * All native creatives: `creativeType=\"CREATIVE_TYPE_NATIVE\"` * All active creatives with 300x400 or 50x100 dimensions: `entityStatus=\"ENTITY_STATUS_ACTIVE\" AND (dimensions=\"300x400\" OR dimensions=\"50x100\")` * All dynamic creatives that are approved by AdX or AppNexus, with a minimum duration of 5 seconds and 200ms: `dynamic=\"true\" AND minDuration=\"5.2s\" AND (exchangeReviewStatus=\"EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED\" OR exchangeReviewStatus=\"EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED\")` * All video creatives that are associated with line item ID 1 or 2: `creativeType=\"CREATIVE_TYPE_VIDEO\" AND (lineItemIds:1 OR lineItemIds:2)` * Find creatives by multiple creative IDs: `creativeId=1 OR creativeId=2` * All creatives with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -1731,7 +1731,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by insertion order properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator used on `budget.budget_segments.date_range.end_date` must be LESS THAN (\u003c). * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)`. * The operators used on all other fields must be `EQUALS (=)`. * Supported fields: - `campaignId` - `displayName` - `entityStatus` - `budget.budget_segments.date_range.end_date` (input as YYYY-MM-DD) - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All insertion orders under a campaign: `campaignId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` insertion orders under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\")` * All insertion orders whose budget segments' dates end before March 28, 2019: `budget.budget_segments.date_range.end_date\u003c\"2019-03-28\"` * All insertion orders with an update time less than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All insertion orders with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by insertion order fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `budget.budget_segments.date_range.end_date` field must use the `LESS THAN (\u003c)` operator. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `campaignId` * `displayName` * `entityStatus` * `budget.budget_segments.date_range.end_date` (input in the form of `YYYY-MM-DD`) **Deprecated. Not available after June 8, 2023** * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * All insertion orders under a campaign: `campaignId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` insertion orders under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\")` * All insertion orders with an update time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All insertion orders with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -1779,7 +1779,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` - `inheritance` Examples: * AssignedTargetingOptions of targeting type TARGETING_TYPE_PROXIMITY_LOCATION_LIST or TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_PROXIMITY_LOCATION_LIST\" OR targetingType=\"TARGETING_TYPE_CHANNEL\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `targetingType` * `inheritance` Examples: * `AssignedTargetingOption` resources of targeting type `TARGETING_TYPE_PROXIMITY_LOCATION_LIST` or `TARGETING_TYPE_CHANNEL`: `targetingType=\"TARGETING_TYPE_PROXIMITY_LOCATION_LIST\" OR targetingType=\"TARGETING_TYPE_CHANNEL\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -1980,7 +1980,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -2136,7 +2136,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -2289,7 +2289,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -2340,7 +2340,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` - `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` * `inheritance` Examples: * `AssignedTargetingOption` resources with ID 1 or 2: `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -2455,7 +2455,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -2635,7 +2635,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` - `inheritance` Examples: * AssignedTargetingOptions of targeting type TARGETING_TYPE_PROXIMITY_LOCATION_LIST or TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_PROXIMITY_LOCATION_LIST\" OR targetingType=\"TARGETING_TYPE_CHANNEL\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `targetingType` * `inheritance` Examples: * `AssignedTargetingOption` resources of targeting type `TARGETING_TYPE_PROXIMITY_LOCATION_LIST` or `TARGETING_TYPE_CHANNEL`: `targetingType=\"TARGETING_TYPE_PROXIMITY_LOCATION_LIST\" OR targetingType=\"TARGETING_TYPE_CHANNEL\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -2884,12 +2884,12 @@ "type": "string" }, "filter": { - "description": "Allows filtering by line item properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator used on `flight.dateRange.endDate` must be LESS THAN (\u003c). * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)`. * The operator used on `warningMessages` must be `HAS (:)`. * The operators used on all other fields must be `EQUALS (=)`. * Supported properties: - `campaignId` - `displayName` - `insertionOrderId` - `entityStatus` - `lineItemId` - `lineItemType` - `flight.dateRange.endDate` (input formatted as YYYY-MM-DD) - `warningMessages` - `flight.triggerId` - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) - `targetedChannelId` - `targetedNegativeKeywordListId` Examples: * All line items under an insertion order: `insertionOrderId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` and `LINE_ITEM_TYPE_DISPLAY_DEFAULT` line items under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\") AND lineItemType=\"LINE_ITEM_TYPE_DISPLAY_DEFAULT\"` * All line items whose flight dates end before March 28, 2019: `flight.dateRange.endDate\u003c\"2019-03-28\"` * All line items that have `NO_VALID_CREATIVE` in `warningMessages`: `warningMessages:\"NO_VALID_CREATIVE\"` * All line items with an update time less than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All line items with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` * All line items that are using both the specified channel and specified negative keyword list in their targeting: `targetedNegativeKeywordListId=789 AND targetedChannelId=12345` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by line item fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `flight.dateRange.endDate` field must use the `LESS THAN (\u003c)` operator. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * The `warningMessages` field must use the `HAS (:)` operator. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `campaignId` * `displayName` * `entityStatus` * `flight.dateRange.endDate` (input formatted as `YYYY-MM-DD`) **Deprecated. Not available after June 8, 2023** * `flight.triggerId` * `insertionOrderId` * `lineItemId` * `lineItemType` * `targetedChannelId` * `targetedNegativeKeywordListId` * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) * `warningMessages` Examples: * All line items under an insertion order: `insertionOrderId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` and `LINE_ITEM_TYPE_DISPLAY_DEFAULT` line items under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\") AND lineItemType=\"LINE_ITEM_TYPE_DISPLAY_DEFAULT\"` * All line items whose flight dates end before March 28, 2019: `flight.dateRange.endDate\u003c\"2019-03-28\"` * All line items that have `NO_VALID_CREATIVE` in `warningMessages`: `warningMessages:\"NO_VALID_CREATIVE\"` * All line items with an update time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All line items with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` * All line items that are using both the specified channel and specified negative keyword list in their targeting: `targetedNegativeKeywordListId=789 AND targetedChannelId=12345` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, "orderBy": { - "description": "Field by which to sort the list. Acceptable values are: * `displayName` (default) * `entityStatus` * `flight.dateRange.endDate` * `updateTime` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `displayName desc`.", + "description": "Field by which to sort the list. Acceptable values are: * `displayName` (default) * `entityStatus` * `flight.dateRange.endDate` **Deprecated. Not available after June 8, 2023** * `updateTime` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `displayName desc`.", "location": "query", "type": "string" }, @@ -3077,7 +3077,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -3233,7 +3233,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -3386,7 +3386,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -3437,7 +3437,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` - `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` * `inheritance` Examples: * `AssignedTargetingOption` resources with ID 1 or 2: `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -3552,7 +3552,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -3673,7 +3673,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by location list fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `locationType` Examples: * All regional location list: `locationType=\"TARGETING_LOCATION_TYPE_REGIONAL\"` * All proximity location list: `locationType=\"TARGETING_LOCATION_TYPE_PROXIMITY\"`", + "description": "Allows filtering by location list fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `locationType` Examples: * All regional location list: `locationType=\"TARGETING_LOCATION_TYPE_REGIONAL\"` * All proximity location list: `locationType=\"TARGETING_LOCATION_TYPE_PROXIMITY\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -3882,7 +3882,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by location list assignment fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedLocationId` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by location list assignment fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedLocationId` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -3925,7 +3925,7 @@ "manualTriggers": { "methods": { "activate": { - "description": "Activates a manual trigger. Each activation of the manual trigger must be at least 5 minutes apart, otherwise an error will be returned.", + "description": "Activates a manual trigger. Each activation of the manual trigger must be at least 5 minutes apart, otherwise an error will be returned. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", "flatPath": "v2/advertisers/{advertisersId}/manualTriggers/{manualTriggersId}:activate", "httpMethod": "POST", "id": "displayvideo.advertisers.manualTriggers.activate", @@ -3963,7 +3963,7 @@ ] }, "create": { - "description": "Creates a new manual trigger. Returns the newly created manual trigger if successful.", + "description": "Creates a new manual trigger. Returns the newly created manual trigger if successful. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", "flatPath": "v2/advertisers/{advertisersId}/manualTriggers", "httpMethod": "POST", "id": "displayvideo.advertisers.manualTriggers.create", @@ -3992,7 +3992,7 @@ ] }, "deactivate": { - "description": "Deactivates a manual trigger.", + "description": "Deactivates a manual trigger. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", "flatPath": "v2/advertisers/{advertisersId}/manualTriggers/{manualTriggersId}:deactivate", "httpMethod": "POST", "id": "displayvideo.advertisers.manualTriggers.deactivate", @@ -4030,7 +4030,7 @@ ] }, "get": { - "description": "Gets a manual trigger.", + "description": "Gets a manual trigger. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", "flatPath": "v2/advertisers/{advertisersId}/manualTriggers/{manualTriggersId}", "httpMethod": "GET", "id": "displayvideo.advertisers.manualTriggers.get", @@ -4065,7 +4065,7 @@ ] }, "list": { - "description": "Lists manual triggers that are accessible to the current user for a given advertiser ID. The order is defined by the order_by parameter. A single advertiser_id is required.", + "description": "Lists manual triggers that are accessible to the current user for a given advertiser ID. The order is defined by the order_by parameter. A single advertiser_id is required. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", "flatPath": "v2/advertisers/{advertisersId}/manualTriggers", "httpMethod": "GET", "id": "displayvideo.advertisers.manualTriggers.list", @@ -4082,7 +4082,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by manual trigger properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `displayName` - `state` Examples: * All active manual triggers under an advertiser: `state=\"ACTIVE\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by manual trigger fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `displayName` * `state` Examples: * All active manual triggers under an advertiser: `state=\"ACTIVE\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -4112,7 +4112,7 @@ ] }, "patch": { - "description": "Updates a manual trigger. Returns the updated manual trigger if successful.", + "description": "Updates a manual trigger. Returns the updated manual trigger if successful. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", "flatPath": "v2/advertisers/{advertisersId}/manualTriggers/{manualTriggersId}", "httpMethod": "PATCH", "id": "displayvideo.advertisers.manualTriggers.patch", @@ -4477,7 +4477,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by negative keyword fields. Supported syntax: * Filter expressions for negative keyword currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `keywordValue` Examples: * All negative keywords for which the keyword value contains \"google\": `keywordValue : \"google\"`", + "description": "Allows filtering by negative keyword fields. Supported syntax: * Filter expressions for negative keywords can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `keywordValue` Examples: * All negative keywords for which the keyword value contains \"google\": `keywordValue : \"google\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -4664,7 +4664,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -4811,7 +4811,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -4955,7 +4955,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -5005,7 +5005,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` Examples: * AssignedTargetingOption with ID 123456 `assignedTargetingOptionId=\"123456\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` Examples: * `AssignedTargetingOption` with ID 123456: `assignedTargetingOptionId=\"123456\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -5112,7 +5112,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -5202,7 +5202,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by custom YouTube ad group ad fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` and `OR`. Only the restrictions for * the same field can be combined by `OR`. A sequence of restrictions * implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported properties: - `adGroupId` - `displayName` - `entityStatus` - `adGroupAdId` Examples: * All ad group ads under an ad group: `adGroupId=\"1234\"` and its * entityStatus is `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED`: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\") AND adGroupId=\"12345\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by custom YouTube ad group ad fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` and `OR`. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `adGroupId` * `displayName` * `entityStatus` * `adGroupAdId` Examples: * All ad group ads under an ad group: `adGroupId=\"1234\"` * All ad group ads under an ad group with an entityStatus of `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED`: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\") AND adGroupId=\"12345\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -5253,7 +5253,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` Examples: * AssignedTargetingOptions of targeting type TARGETING_TYPE_YOUTUBE_VIDEO or TARGETING_TYPE_YOUTUBE_CHANNEL `targetingType=\"TARGETING_TYPE_YOUTUBE_VIDEO\" OR targetingType=\"TARGETING_TYPE_YOUTUBE_CHANNEL\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `targetingType` Examples: * `AssignedTargetingOption` resources of targeting type `TARGETING_TYPE_YOUTUBE_VIDEO` or `TARGETING_TYPE_YOUTUBE_CHANNEL`: `targetingType=\"TARGETING_TYPE_YOUTUBE_VIDEO\" OR targetingType=\"TARGETING_TYPE_YOUTUBE_CHANNEL\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -5342,7 +5342,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by custom YouTube ad group fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` and `OR`. Only the restrictions for * the same field can be combined by `OR`. A sequence of restrictions * implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported properties: - `adGroupId` - `displayName` - `entityStatus` - `lineItemId` - `adGroupFormat` Examples: * All ad groups under an line item: `lineItemId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` and `YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM` ad groups under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\") AND adGroupFormat=\"YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by custom YouTube ad group fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` and `OR`. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported properties: * `adGroupId` * `displayName` * `entityStatus` * `lineItemId` * `adGroupFormat` Examples: * All ad groups under an line item: `lineItemId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` `YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM` ad groups under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\") AND adGroupFormat=\"YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -5491,7 +5491,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -5550,7 +5550,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` Examples: * AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` Examples: * `AssignedTargetingOption` resources with ID 1 or 2: `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -5657,7 +5657,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -5758,7 +5758,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by combined audience fields. Supported syntax: * Filter expressions for combined audiences currently can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All combined audiences for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters.", + "description": "Allows filtering by combined audience fields. Supported syntax: * Filter expressions for combined audiences can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All combined audiences for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -5867,7 +5867,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by custom bidding algorithm fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND`. A sequence of restrictions * implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)` or `EQUALS (=)`. * The operator must be `CONTAINS (:)` for the following field: - `displayName` * The operator must be `EQUALS (=)` for the following field: - `customBiddingAlgorithmType` * For `displayName`, the value is a string. We return all custom bidding algorithms whose display_name contains such string. * For `customBiddingAlgorithmType`, the value is a string. We return all algorithms whose custom_bidding_algorithm_type is equal to the given type. Examples: * All custom bidding algorithms for which the display name contains \"politics\": `displayName:politics`. * All custom bidding algorithms for which the type is \"SCRIPT_BASED\": `customBiddingAlgorithmType=SCRIPT_BASED` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by custom bidding algorithm fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND`. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `customBiddingAlgorithmType` field must use the `EQUALS (=)` operator. * The `displayName` field must use the `HAS (:)` operator. Supported fields: * `customBiddingAlgorithmType` * `displayName` Examples: * All custom bidding algorithms for which the display name contains \"politics\": `displayName:\"politics\"`. * All custom bidding algorithms for which the type is \"SCRIPT_BASED\": `customBiddingAlgorithmType=SCRIPT_BASED` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -6173,7 +6173,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by custom list fields. Supported syntax: * Filter expressions for custom lists currently can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All custom lists for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters.", + "description": "Allows filtering by custom list fields. Supported syntax: * Filter expressions for custom lists can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All custom lists for which the display name contains \"Google\": `displayName:\"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -6312,7 +6312,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by first and third party audience fields. Supported syntax: * Filter expressions for first and third party audiences currently can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All first and third party audiences for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters.", + "description": "Allows filtering by first and third party audience fields. Supported syntax: * Filter expressions for first and third party audiences can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All first and third party audiences for which the display name contains \"Google\": `displayName:\"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -6520,7 +6520,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by Google audience fields. Supported syntax: * Filter expressions for Google audiences currently can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All Google audiences for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters.", + "description": "Allows filtering by Google audience fields. Supported syntax: * Filter expressions for Google audiences can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All Google audiences for which the display name contains \"Google\": `displayName:\"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -6669,7 +6669,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by guaranteed order properties. * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `guaranteed_order_id` - `exchange` - `display_name` - `status.entityStatus` Examples: * All active guaranteed orders: `status.entityStatus=\"ENTITY_STATUS_ACTIVE\"` * Guaranteed orders belonging to Google Ad Manager or Rubicon exchanges: `exchange=\"EXCHANGE_GOOGLE_AD_MANAGER\" OR exchange=\"EXCHANGE_RUBICON\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by guaranteed order fields. * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `guaranteed_order_id` * `exchange` * `display_name` * `status.entityStatus` Examples: * All active guaranteed orders: `status.entityStatus=\"ENTITY_STATUS_ACTIVE\"` * Guaranteed orders belonging to Google Ad Manager or Rubicon exchanges: `exchange=\"EXCHANGE_GOOGLE_AD_MANAGER\" OR exchange=\"EXCHANGE_RUBICON\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -6875,7 +6875,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by inventory source group properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `inventorySourceGroupId` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by inventory source group fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `inventorySourceGroupId` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -7093,7 +7093,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by assigned inventory source fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedInventorySourceId` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned inventory source fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedInventorySourceId` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -7248,7 +7248,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by inventory source properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `status.entityStatus` - `commitment` - `deliveryMethod` - `rateDetails.rateType` - `exchange` Examples: * All active inventory sources: `status.entityStatus=\"ENTITY_STATUS_ACTIVE\"` * Inventory sources belonging to Google Ad Manager or Rubicon exchanges: `exchange=\"EXCHANGE_GOOGLE_AD_MANAGER\" OR exchange=\"EXCHANGE_RUBICON\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by inventory source fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `status.entityStatus` * `commitment` * `deliveryMethod` * `rateDetails.rateType` * `exchange` Examples: * All active inventory sources: `status.entityStatus=\"ENTITY_STATUS_ACTIVE\"` * Inventory sources belonging to Google Ad Manager or Rubicon exchanges: `exchange=\"EXCHANGE_GOOGLE_AD_MANAGER\" OR exchange=\"EXCHANGE_RUBICON\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -7469,7 +7469,7 @@ "parameterOrder": [], "parameters": { "filter": { - "description": "Allows filtering by partner properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `entityStatus` Examples: * All active partners: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by partner fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `entityStatus` Examples: * All active partners: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -7594,7 +7594,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by channel fields. Supported syntax: * Filter expressions for channel currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All channels for which the display name contains \"google\": `displayName : \"google\"`. The length of this field should be no more than 500 characters.", + "description": "Allows filtering by channel fields. Supported syntax: * Filter expressions for channel can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All channels for which the display name contains \"google\": `displayName : \"google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -7837,7 +7837,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by site fields. Supported syntax: * Filter expressions for site currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `urlOrAppId` Examples: * All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"`", + "description": "Allows filtering by site fields. Supported syntax: * Filter expressions for site retrieval can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `urlOrAppId` Examples: * All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -8024,7 +8024,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -8171,7 +8171,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -8315,7 +8315,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -8357,7 +8357,7 @@ ], "parameters": { "filter": { - "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` Examples: * AssignedTargetingOption with ID 123456 `assignedTargetingOptionId=\"123456\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` Examples: * `AssignedTargetingOption` resource with ID 123456: `assignedTargetingOptionId=\"123456\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -8472,7 +8472,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -8677,7 +8677,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -8724,7 +8724,7 @@ "type": "string" }, "filter": { - "description": "Allows filtering by targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `OR` logical operators. * A restriction has the form of `{field} {operator} {value}`. * The operator must be \"=\" (equal sign). * Supported fields: - `carrierAndIspDetails.type` - `geoRegionDetails.geoRegionType` - `targetingOptionId` Examples: * All `GEO REGION` targeting options that belong to sub type `GEO_REGION_TYPE_COUNTRY` or `GEO_REGION_TYPE_STATE`: `geoRegionDetails.geoRegionType=\"GEO_REGION_TYPE_COUNTRY\" OR geoRegionDetails.geoRegionType=\"GEO_REGION_TYPE_STATE\"` * All `CARRIER AND ISP` targeting options that belong to sub type `CARRIER_AND_ISP_TYPE_CARRIER`: `carrierAndIspDetails.type=\"CARRIER_AND_ISP_TYPE_CARRIER\"`. The length of this field should be no more than 500 characters.", + "description": "Allows filtering by targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `OR` logical operators. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `carrierAndIspDetails.type` * `geoRegionDetails.geoRegionType` * `targetingOptionId` Examples: * All `GEO REGION` targeting options that belong to sub type `GEO_REGION_TYPE_COUNTRY` or `GEO_REGION_TYPE_STATE`: `geoRegionDetails.geoRegionType=\"GEO_REGION_TYPE_COUNTRY\" OR geoRegionDetails.geoRegionType=\"GEO_REGION_TYPE_STATE\"` * All `CARRIER AND ISP` targeting options that belong to sub type `CARRIER_AND_ISP_TYPE_CARRIER`: `carrierAndIspDetails.type=\"CARRIER_AND_ISP_TYPE_CARRIER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -8831,7 +8831,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -8958,7 +8958,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -8999,7 +8999,7 @@ "users": { "methods": { "bulkEditAssignedUserRoles": { - "description": "Bulk edits user roles for a user. The operation will delete the assigned user roles provided in BulkEditAssignedUserRolesRequest.deletedAssignedUserRoles and then assign the user roles provided in BulkEditAssignedUserRolesRequest.createdAssignedUserRoles.", + "description": "Bulk edits user roles for a user. The operation will delete the assigned user roles provided in BulkEditAssignedUserRolesRequest.deletedAssignedUserRoles and then assign the user roles provided in BulkEditAssignedUserRolesRequest.createdAssignedUserRoles. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", "flatPath": "v2/users/{usersId}:bulkEditAssignedUserRoles", "httpMethod": "POST", "id": "displayvideo.users.bulkEditAssignedUserRoles", @@ -9028,7 +9028,7 @@ ] }, "create": { - "description": "Creates a new user. Returns the newly created user if successful.", + "description": "Creates a new user. Returns the newly created user if successful. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", "flatPath": "v2/users", "httpMethod": "POST", "id": "displayvideo.users.create", @@ -9046,7 +9046,7 @@ ] }, "delete": { - "description": "Deletes a user.", + "description": "Deletes a user. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", "flatPath": "v2/users/{usersId}", "httpMethod": "DELETE", "id": "displayvideo.users.delete", @@ -9072,7 +9072,7 @@ ] }, "get": { - "description": "Gets a user.", + "description": "Gets a user. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", "flatPath": "v2/users/{usersId}", "httpMethod": "GET", "id": "displayvideo.users.get", @@ -9098,14 +9098,14 @@ ] }, "list": { - "description": "Lists users that are accessible to the current user. If two users have user roles on the same partner or advertiser, they can access each other.", + "description": "Lists users that are accessible to the current user. If two users have user roles on the same partner or advertiser, they can access each other. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", "flatPath": "v2/users", "httpMethod": "GET", "id": "displayvideo.users.list", "parameterOrder": [], "parameters": { "filter": { - "description": "Allows filtering by user properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)` or `EQUALS (=)`. * The operator must be `CONTAINS (:)` for the following fields: - `displayName` - `email` * The operator must be `EQUALS (=)` for the following fields: - `assignedUserRole.userRole` - `assignedUserRole.partnerId` - `assignedUserRole.advertiserId` - `assignedUserRole.entityType`: A synthetic field of AssignedUserRole used for filtering. Identifies the type of entity to which the user role is assigned. Valid values are `Partner` and `Advertiser`. - `assignedUserRole.parentPartnerId`: A synthetic field of AssignedUserRole used for filtering. Identifies the parent partner of the entity to which the user role is assigned.\" Examples: * The user with displayName containing `foo`: `displayName:\"foo\"` * The user with email containing `bar`: `email:\"bar\"` * All users with standard user roles: `assignedUserRole.userRole=\"STANDARD\"` * All users with user roles for partner 123: `assignedUserRole.partnerId=\"123\"` * All users with user roles for advertiser 123: `assignedUserRole.advertiserId=\"123\"` * All users with partner level user roles: `entityType=\"PARTNER\"` * All users with user roles for partner 123 and advertisers under partner 123: `parentPartnerId=\"123\"` The length of this field should be no more than 500 characters.", + "description": "Allows filtering by user fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `budget.budget_segments.date_range.end_date` field must use the `LESS THAN (\u003c)` operator. * The `displayName and `email` field must use the `HAS (:)` operator. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `assignedUserRole.advertiserId` * `assignedUserRole.entityType` * This is synthetic field of `AssignedUserRole` used for filtering. Identifies the type of entity to which the user role is assigned. Valid values are `Partner` and `Advertiser`. * `assignedUserRole.parentPartnerId` * This is a synthetic field of `AssignedUserRole` used for filtering. Identifies the parent partner of the entity to which the user role is assigned. * `assignedUserRole.partnerId` * `assignedUserRole.userRole` * `displayName` * `email` Examples: * The user with `displayName` containing \"foo\": `displayName:\"foo\"` * The user with `email` containing \"bar\": `email:\"bar\"` * All users with standard user roles: `assignedUserRole.userRole=\"STANDARD\"` * All users with user roles for partner 123: `assignedUserRole.partnerId=\"123\"` * All users with user roles for advertiser 123: `assignedUserRole.advertiserId=\"123\"` * All users with partner level user roles: `entityType=\"PARTNER\"` * All users with user roles for partner 123 and advertisers under partner 123: `parentPartnerId=\"123\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", "location": "query", "type": "string" }, @@ -9135,7 +9135,7 @@ ] }, "patch": { - "description": "Updates an existing user. Returns the updated user if successful.", + "description": "Updates an existing user. Returns the updated user if successful. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", "flatPath": "v2/users/{usersId}", "httpMethod": "PATCH", "id": "displayvideo.users.patch", @@ -9172,7 +9172,7 @@ } } }, - "revision": "20230420", + "revision": "20230504", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActivateManualTriggerRequest": { @@ -10139,7 +10139,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -10250,11 +10250,11 @@ "properties": { "excludedFirstAndThirdPartyAudienceGroup": { "$ref": "FirstAndThirdPartyAudienceGroup", - "description": "The first and third party audience ids and recencies of the excluded first and third party audience group. Used for negative targeting. The COMPLEMENT of the UNION of this group and other excluded audience groups is used as an INTERSECTION to any positive audience targeting. All items are logically ‘OR’ of each other." + "description": "The first and third party audience ids and recencies of the excluded first and third party audience group. Used for negative targeting. The COMPLEMENT of the UNION of this group and other excluded audience groups is used as an INTERSECTION to any positive audience targeting. All items are logically ‘OR’ of each other. **Warning:** `ACTIVITY_BASED` and `FREQUENCY_CAP` audience types will be deprecated on **May 20, 2023**. After this date, these audiences will not be able to be added to resource targeting. Read our [feature deprecation announcement](/display-video/api/deprecations#features.first_and_third_party_audience_types) for more information." }, "excludedGoogleAudienceGroup": { "$ref": "GoogleAudienceGroup", - "description": "The Google audience ids of the excluded Google audience group. Used for negative targeting. The COMPLEMENT of the UNION of this group and other excluded audience groups is used as an INTERSECTION to any positive audience targeting. Only contains Affinity, In-market and Installed-apps type Google audiences. All items are logically ‘OR’ of each other." + "description": "The Google audience ids of the excluded Google audience group. Used for negative targeting. The COMPLEMENT of the UNION of this group and other excluded audience groups is used as an INTERSECTION to any positive audience targeting. Only contains Affinity, In-market and Installed-apps type Google audiences. All items are logically ‘OR’ of each other. **Warning:** `GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS` and `GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES` audience types will be deprecated on **May 20, 2023**. After this date, these audiences will not be able to be added to resource targeting. Read our [feature deprecation announcement](/display-video/api/deprecations#features.google_audience_types) for more information." }, "includedCombinedAudienceGroup": { "$ref": "CombinedAudienceGroup", @@ -10265,7 +10265,7 @@ "description": "The custom list ids of the included custom list group. Contains custom list ids only." }, "includedFirstAndThirdPartyAudienceGroups": { - "description": "The first and third party audience ids and recencies of included first and third party audience groups. Each first and third party audience group contains first and third party audience ids only. The relation between each first and third party audience group is INTERSECTION, and the result is UNION'ed with other audience groups. Repeated groups with same settings will be ignored.", + "description": "The first and third party audience ids and recencies of included first and third party audience groups. Each first and third party audience group contains first and third party audience ids only. The relation between each first and third party audience group is INTERSECTION, and the result is UNION'ed with other audience groups. Repeated groups with same settings will be ignored. **Warning:** `ACTIVITY_BASED` and `FREQUENCY_CAP` audience types will be deprecated on **May 20, 2023**. After this date, these audiences will not be able to be added to resource targeting. Read our [feature deprecation announcement](/display-video/api/deprecations#features.first_and_third_party_audience_types) for more information.", "items": { "$ref": "FirstAndThirdPartyAudienceGroup" }, @@ -10273,7 +10273,7 @@ }, "includedGoogleAudienceGroup": { "$ref": "GoogleAudienceGroup", - "description": "The Google audience ids of the included Google audience group. Contains Google audience ids only." + "description": "The Google audience ids of the included Google audience group. Contains Google audience ids only. **Warning:** `GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS` and `GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES` audience types will be deprecated on **May 20, 2023**. After this date, these audiences will not be able to be added to resource targeting. Read our [feature deprecation announcement](/display-video/api/deprecations#features.google_audience_types) for more information." } }, "type": "object" @@ -10417,7 +10417,7 @@ "type": "object" }, "AuthorizedSellerStatusAssignedTargetingOptionDetails": { - "description": "Represents an assigned authorized seller status. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`.", + "description": "Represents an assigned authorized seller status. This will be populated in the details field of an AssignedTargetingOption when targeting_type is `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`. If a resource does not have an `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS` assigned targeting option, it is using the \"Authorized Direct Sellers and Resellers\" option.", "id": "AuthorizedSellerStatusAssignedTargetingOptionDetails", "properties": { "authorizedSellerStatus": { @@ -10428,9 +10428,9 @@ "AUTHORIZED_SELLER_STATUS_AUTHORIZED_AND_NON_PARTICIPATING_PUBLISHERS" ], "enumDescriptions": [ - "Default value when authorized seller status is not specified in this version. This enum is a placeholder for default value and does not represent a real authorized seller status option.", - "Only authorized sellers that directly own the inventory being monetized, as indicated by a DIRECT declaration in the ads.txt file.", - "All authorized sellers, including publishers that have not posted an ads.txt file. Display \u0026 Video 360 automatically disallows unauthorized sellers." + "Default value when authorized seller status is not specified in this version. This enum is a placeholder for the default value, or \"Authorized Direct Sellers and Resellers\" in the UI.", + "Only authorized sellers that directly own the inventory being monetized, as indicated by a DIRECT declaration in the ads.txt file. This value is equivalent to \"Authorized Direct Sellers\" in the UI.", + "All authorized sellers, including publishers that have not posted an ads.txt file. Display \u0026 Video 360 automatically disallows unauthorized sellers. This value is equivalent to \"Authorized and Non-Participating Publishers\" in the UI." ], "readOnly": true, "type": "string" @@ -10454,9 +10454,9 @@ "AUTHORIZED_SELLER_STATUS_AUTHORIZED_AND_NON_PARTICIPATING_PUBLISHERS" ], "enumDescriptions": [ - "Default value when authorized seller status is not specified in this version. This enum is a placeholder for default value and does not represent a real authorized seller status option.", - "Only authorized sellers that directly own the inventory being monetized, as indicated by a DIRECT declaration in the ads.txt file.", - "All authorized sellers, including publishers that have not posted an ads.txt file. Display \u0026 Video 360 automatically disallows unauthorized sellers." + "Default value when authorized seller status is not specified in this version. This enum is a placeholder for the default value, or \"Authorized Direct Sellers and Resellers\" in the UI.", + "Only authorized sellers that directly own the inventory being monetized, as indicated by a DIRECT declaration in the ads.txt file. This value is equivalent to \"Authorized Direct Sellers\" in the UI.", + "All authorized sellers, including publishers that have not posted an ads.txt file. Display \u0026 Video 360 automatically disallows unauthorized sellers. This value is equivalent to \"Authorized and Non-Participating Publishers\" in the UI." ], "readOnly": true, "type": "string" @@ -12124,7 +12124,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -13098,7 +13098,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", @@ -14637,8 +14637,8 @@ "Audience was generated through matching customers to known contact information.", "Audience was generated through matching customers to known Mobile device IDs.", "Audience was generated through matching customers to known User IDs.", - "Audience was created based on campaign activity.", - "Audience was created based on excluding the number of impressions they were served.", + "Audience was created based on campaign activity. **Warning:** This audience type will be deprecated on **May 20, 2023**. After this date, these audiences will not be able to be added to resource targeting. Read our [feature deprecation announcement](/display-video/api/deprecations#features.first_and_third_party_audience_types) for more information.", + "Audience was created based on excluding the number of impressions they were served. **Warning:** This audience type will be deprecated on **May 20, 2023**. After this date, these audiences will not be able to be added to resource targeting. Read our [feature deprecation announcement](/display-video/api/deprecations#features.first_and_third_party_audience_types) for more information.", "Audience was created based on custom variables attached to pixel.", "Audience was created based on past interactions with videos, YouTube ads, or YouTube channel.", "Subtype of third party audience type." @@ -15258,8 +15258,8 @@ "Default value when type is not specified or is unknown.", "Affinity type Google audience.", "In-Market type Google audience.", - "Installed-Apps type Google audience.", - "New-Mobile-Devices type Google audience.", + "Installed-Apps type Google audience. **Warning:** This audience type will be deprecated on **May 20, 2023**. After this date, these audiences will not be able to be added to resource targeting. Read our [feature deprecation announcement](/display-video/api/deprecations#features.google_audience_types) for more information.", + "New-Mobile-Devices type Google audience. **Warning:** This audience type will be deprecated on **May 20, 2023**. After this date, these audiences will not be able to be added to resource targeting. Read our [feature deprecation announcement](/display-video/api/deprecations#features.google_audience_types) for more information.", "Life-Event type Google audience.", "Extended-Demographic type Google audience." ], @@ -17816,7 +17816,7 @@ "type": "object" }, "ManualTrigger": { - "description": "A single manual trigger in Display \u0026 Video 360.", + "description": "A single manual trigger in Display \u0026 Video 360. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", "id": "ManualTrigger", "properties": { "activationDurationMinutes": { @@ -20045,7 +20045,7 @@ "Target ads to a specific content category (for example, arts \u0026 entertainment).", "Purchase impressions from specific deals and auction packages.", "Target ads to a specific language (for example, English or Japanese).", - "Target ads to ads.txt authorized sellers.", + "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", "Target ads to a specific regional location (for example, a city or state).", "Purchase impressions from a group of deals and auction packages.", "Purchase impressions from specific exchanges.", diff --git a/displayvideo/v2/displayvideo-gen.go b/displayvideo/v2/displayvideo-gen.go index 6e1934f0977..2a5710f7e19 100644 --- a/displayvideo/v2/displayvideo-gen.go +++ b/displayvideo/v2/displayvideo-gen.go @@ -2144,7 +2144,9 @@ type AssignedTargetingOption struct { // "TARGETING_TYPE_LANGUAGE" - Target ads to a specific language (for // example, English or Japanese). // "TARGETING_TYPE_AUTHORIZED_SELLER_STATUS" - Target ads to ads.txt - // authorized sellers. + // authorized sellers. If no targeting option of this type is assigned, + // the resource uses the "Authorized Direct Sellers and Resellers" + // option by default. // "TARGETING_TYPE_GEO_REGION" - Target ads to a specific regional // location (for example, a city or state). // "TARGETING_TYPE_INVENTORY_SOURCE_GROUP" - Purchase impressions from @@ -2344,7 +2346,12 @@ type AudienceGroupAssignedTargetingOptionDetails struct { // audience group. Used for negative targeting. The COMPLEMENT of the // UNION of this group and other excluded audience groups is used as an // INTERSECTION to any positive audience targeting. All items are - // logically ‘OR’ of each other. + // logically ‘OR’ of each other. **Warning:** `ACTIVITY_BASED` and + // `FREQUENCY_CAP` audience types will be deprecated on **May 20, + // 2023**. After this date, these audiences will not be able to be added + // to resource targeting. Read our feature deprecation announcement + // (/display-video/api/deprecations#features.first_and_third_party_audien + // ce_types) for more information. ExcludedFirstAndThirdPartyAudienceGroup *FirstAndThirdPartyAudienceGroup `json:"excludedFirstAndThirdPartyAudienceGroup,omitempty"` // ExcludedGoogleAudienceGroup: The Google audience ids of the excluded @@ -2352,7 +2359,14 @@ type AudienceGroupAssignedTargetingOptionDetails struct { // the UNION of this group and other excluded audience groups is used as // an INTERSECTION to any positive audience targeting. Only contains // Affinity, In-market and Installed-apps type Google audiences. All - // items are logically ‘OR’ of each other. + // items are logically ‘OR’ of each other. **Warning:** + // `GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS` and + // `GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES` audience types will be + // deprecated on **May 20, 2023**. After this date, these audiences will + // not be able to be added to resource targeting. Read our feature + // deprecation announcement + // (/display-video/api/deprecations#features.google_audience_types) for + // more information. ExcludedGoogleAudienceGroup *GoogleAudienceGroup `json:"excludedGoogleAudienceGroup,omitempty"` // IncludedCombinedAudienceGroup: The combined audience ids of the @@ -2370,11 +2384,23 @@ type AudienceGroupAssignedTargetingOptionDetails struct { // third party audience ids only. The relation between each first and // third party audience group is INTERSECTION, and the result is // UNION'ed with other audience groups. Repeated groups with same - // settings will be ignored. + // settings will be ignored. **Warning:** `ACTIVITY_BASED` and + // `FREQUENCY_CAP` audience types will be deprecated on **May 20, + // 2023**. After this date, these audiences will not be able to be added + // to resource targeting. Read our feature deprecation announcement + // (/display-video/api/deprecations#features.first_and_third_party_audien + // ce_types) for more information. IncludedFirstAndThirdPartyAudienceGroups []*FirstAndThirdPartyAudienceGroup `json:"includedFirstAndThirdPartyAudienceGroups,omitempty"` // IncludedGoogleAudienceGroup: The Google audience ids of the included // Google audience group. Contains Google audience ids only. + // **Warning:** `GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS` and + // `GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES` audience types will be + // deprecated on **May 20, 2023**. After this date, these audiences will + // not be able to be added to resource targeting. Read our feature + // deprecation announcement + // (/display-video/api/deprecations#features.google_audience_types) for + // more information. IncludedGoogleAudienceGroup *GoogleAudienceGroup `json:"includedGoogleAudienceGroup,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -2646,7 +2672,10 @@ func (s *AuditAdvertiserResponse) MarshalJSON() ([]byte, error) { // AuthorizedSellerStatusAssignedTargetingOptionDetails: Represents an // assigned authorized seller status. This will be populated in the // details field of an AssignedTargetingOption when targeting_type is -// `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`. +// `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`. If a resource does not +// have an `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS` assigned targeting +// option, it is using the "Authorized Direct Sellers and Resellers" +// option. type AuthorizedSellerStatusAssignedTargetingOptionDetails struct { // AuthorizedSellerStatus: Output only. The authorized seller status to // target. @@ -2654,16 +2683,18 @@ type AuthorizedSellerStatusAssignedTargetingOptionDetails struct { // Possible values: // "AUTHORIZED_SELLER_STATUS_UNSPECIFIED" - Default value when // authorized seller status is not specified in this version. This enum - // is a placeholder for default value and does not represent a real - // authorized seller status option. + // is a placeholder for the default value, or "Authorized Direct Sellers + // and Resellers" in the UI. // "AUTHORIZED_SELLER_STATUS_AUTHORIZED_DIRECT_SELLERS_ONLY" - Only // authorized sellers that directly own the inventory being monetized, - // as indicated by a DIRECT declaration in the ads.txt file. + // as indicated by a DIRECT declaration in the ads.txt file. This value + // is equivalent to "Authorized Direct Sellers" in the UI. // // "AUTHORIZED_SELLER_STATUS_AUTHORIZED_AND_NON_PARTICIPATING_PUBLISHERS" // - All authorized sellers, including publishers that have not posted // an ads.txt file. Display & Video 360 automatically disallows - // unauthorized sellers. + // unauthorized sellers. This value is equivalent to "Authorized and + // Non-Participating Publishers" in the UI. AuthorizedSellerStatus string `json:"authorizedSellerStatus,omitempty"` // TargetingOptionId: Required. The targeting_option_id of a @@ -2705,16 +2736,18 @@ type AuthorizedSellerStatusTargetingOptionDetails struct { // Possible values: // "AUTHORIZED_SELLER_STATUS_UNSPECIFIED" - Default value when // authorized seller status is not specified in this version. This enum - // is a placeholder for default value and does not represent a real - // authorized seller status option. + // is a placeholder for the default value, or "Authorized Direct Sellers + // and Resellers" in the UI. // "AUTHORIZED_SELLER_STATUS_AUTHORIZED_DIRECT_SELLERS_ONLY" - Only // authorized sellers that directly own the inventory being monetized, - // as indicated by a DIRECT declaration in the ads.txt file. + // as indicated by a DIRECT declaration in the ads.txt file. This value + // is equivalent to "Authorized Direct Sellers" in the UI. // // "AUTHORIZED_SELLER_STATUS_AUTHORIZED_AND_NON_PARTICIPATING_PUBLISHERS" // - All authorized sellers, including publishers that have not posted // an ads.txt file. Display & Video 360 automatically disallows - // unauthorized sellers. + // unauthorized sellers. This value is equivalent to "Authorized and + // Non-Participating Publishers" in the UI. AuthorizedSellerStatus string `json:"authorizedSellerStatus,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -5616,7 +5649,9 @@ type CreateAssignedTargetingOptionsRequest struct { // "TARGETING_TYPE_LANGUAGE" - Target ads to a specific language (for // example, English or Japanese). // "TARGETING_TYPE_AUTHORIZED_SELLER_STATUS" - Target ads to ads.txt - // authorized sellers. + // authorized sellers. If no targeting option of this type is assigned, + // the resource uses the "Authorized Direct Sellers and Resellers" + // option by default. // "TARGETING_TYPE_GEO_REGION" - Target ads to a specific regional // location (for example, a city or state). // "TARGETING_TYPE_INVENTORY_SOURCE_GROUP" - Purchase impressions from @@ -6913,7 +6948,9 @@ type DeleteAssignedTargetingOptionsRequest struct { // "TARGETING_TYPE_LANGUAGE" - Target ads to a specific language (for // example, English or Japanese). // "TARGETING_TYPE_AUTHORIZED_SELLER_STATUS" - Target ads to ads.txt - // authorized sellers. + // authorized sellers. If no targeting option of this type is assigned, + // the resource uses the "Authorized Direct Sellers and Resellers" + // option by default. // "TARGETING_TYPE_GEO_REGION" - Target ads to a specific regional // location (for example, a city or state). // "TARGETING_TYPE_INVENTORY_SOURCE_GROUP" - Purchase impressions from @@ -8681,8 +8718,18 @@ type FirstAndThirdPartyAudience struct { // "CUSTOMER_MATCH_USER_ID" - Audience was generated through matching // customers to known User IDs. // "ACTIVITY_BASED" - Audience was created based on campaign activity. + // **Warning:** This audience type will be deprecated on **May 20, + // 2023**. After this date, these audiences will not be able to be added + // to resource targeting. Read our [feature deprecation + // announcement](/display-video/api/deprecations#features.first_and_third + // _party_audience_types) for more information. // "FREQUENCY_CAP" - Audience was created based on excluding the - // number of impressions they were served. + // number of impressions they were served. **Warning:** This audience + // type will be deprecated on **May 20, 2023**. After this date, these + // audiences will not be able to be added to resource targeting. Read + // our [feature deprecation + // announcement](/display-video/api/deprecations#features.first_and_third + // _party_audience_types) for more information. // "TAG_BASED" - Audience was created based on custom variables // attached to pixel. // "YOUTUBE_USERS" - Audience was created based on past interactions @@ -9494,9 +9541,17 @@ type GoogleAudience struct { // "GOOGLE_AUDIENCE_TYPE_AFFINITY" - Affinity type Google audience. // "GOOGLE_AUDIENCE_TYPE_IN_MARKET" - In-Market type Google audience. // "GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS" - Installed-Apps type Google - // audience. + // audience. **Warning:** This audience type will be deprecated on **May + // 20, 2023**. After this date, these audiences will not be able to be + // added to resource targeting. Read our [feature deprecation + // announcement](/display-video/api/deprecations#features.google_audience + // _types) for more information. // "GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES" - New-Mobile-Devices type - // Google audience. + // Google audience. **Warning:** This audience type will be deprecated + // on **May 20, 2023**. After this date, these audiences will not be + // able to be added to resource targeting. Read our [feature deprecation + // announcement](/display-video/api/deprecations#features.google_audience + // _types) for more information. // "GOOGLE_AUDIENCE_TYPE_LIFE_EVENT" - Life-Event type Google // audience. // "GOOGLE_AUDIENCE_TYPE_EXTENDED_DEMOGRAPHIC" - Extended-Demographic @@ -13282,6 +13337,11 @@ func (s *LookupInvoiceCurrencyResponse) MarshalJSON() ([]byte, error) { } // ManualTrigger: A single manual trigger in Display & Video 360. +// **Warning:** Line Items using manual triggers will stop serving in +// Display & Video 360 on **May 17, 2023**. Read our feature deprecation +// announcement +// (/display-video/api/deprecations#features.manual_triggers) for more +// information. type ManualTrigger struct { // ActivationDurationMinutes: Required. The maximum duration of each // activation in minutes. Must be between 1 and 360 inclusive. After @@ -16724,7 +16784,9 @@ type TargetingOption struct { // "TARGETING_TYPE_LANGUAGE" - Target ads to a specific language (for // example, English or Japanese). // "TARGETING_TYPE_AUTHORIZED_SELLER_STATUS" - Target ads to ads.txt - // authorized sellers. + // authorized sellers. If no targeting option of this type is assigned, + // the resource uses the "Authorized Direct Sellers and Resellers" + // option by default. // "TARGETING_TYPE_GEO_REGION" - Target ads to a specific regional // location (for example, a city or state). // "TARGETING_TYPE_INVENTORY_SOURCE_GROUP" - Purchase impressions from @@ -19149,22 +19211,23 @@ func (r *AdvertisersService) List() *AdvertisersListCall { } // Filter sets the optional parameter "filter": Allows filtering by -// advertiser properties. Supported syntax: * Filter expressions are -// made up of one or more restrictions. * Restrictions can be combined -// by `AND` or `OR` logical operators. A sequence of restrictions -// implicitly uses `AND`. * A restriction has the form of `{field} -// {operator} {value}`. * The operator used on `updateTime` must be -// `GREATER THAN OR EQUAL TO (>=)` or `LESS THAN OR EQUAL TO (<=)`. * -// The operator must be `EQUALS (=)`. * Supported fields: - -// `advertiserId` - `displayName` - `entityStatus` - `updateTime` (input -// in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All active -// advertisers under a partner: `entityStatus="ENTITY_STATUS_ACTIVE" * -// All advertisers with an update time less than or equal to -// `2020-11-04T18:54:47Z (format of ISO 8601)`: -// `updateTime<="2020-11-04T18:54:47Z" * All advertisers with an update -// time greater than or equal to `2020-11-04T18:54:47Z (format of ISO -// 8601)`: `updateTime>="2020-11-04T18:54:47Z" The length of this field -// should be no more than 500 characters. +// advertiser fields. Supported syntax: * Filter expressions are made up +// of one or more restrictions. * Restrictions can be combined by `AND` +// or `OR` logical operators. * A restriction has the form of `{field} +// {operator} {value}`. * The `updateTime` field must use the `GREATER +// THAN OR EQUAL TO (>=)` or `LESS THAN OR EQUAL TO (<=)` operators. * +// All other fields must use the `EQUALS (=)` operator. Supported +// fields: * `advertiserId` * `displayName` * `entityStatus` * +// `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) +// Examples: * All active advertisers under a partner: +// `entityStatus="ENTITY_STATUS_ACTIVE" * All advertisers with an +// update time less than or equal to 2020-11-04T18:54:47Z (format of ISO +// 8601): `updateTime<="2020-11-04T18:54:47Z" * All advertisers with an +// update time greater than or equal to 2020-11-04T18:54:47Z (format of +// ISO 8601): `updateTime>="2020-11-04T18:54:47Z" The length of this +// field should be no more than 500 characters. Reference our filter +// `LIST` requests (/display-video/api/guides/how-tos/filters) guide for +// more information. func (c *AdvertisersListCall) Filter(filter string) *AdvertisersListCall { c.urlParams_.Set("filter", filter) return c @@ -19308,7 +19371,7 @@ func (c *AdvertisersListCall) Do(opts ...googleapi.CallOption) (*ListAdvertisers // "parameterOrder": [], // "parameters": { // "filter": { - // "description": "Allows filtering by advertiser properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)`. * The operator must be `EQUALS (=)`. * Supported fields: - `advertiserId` - `displayName` - `entityStatus` - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All active advertisers under a partner: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` * All advertisers with an update time less than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All advertisers with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by advertiser fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. * A restriction has the form of `{field} {operator} {value}`. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `advertiserId` * `displayName` * `entityStatus` * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * All active advertisers under a partner: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` * All advertisers with an update time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All advertisers with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -19389,14 +19452,16 @@ func (r *AdvertisersService) ListAssignedTargetingOptions(advertiserId int64) *A } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR`.. * A restriction has -// the form of `{field} {operator} {value}`. * The operator must be -// `EQUALS (=)`. * Supported fields: - `targetingType` Examples: * -// targetingType with value TARGETING_TYPE_CHANNEL +// can be combined by the `OR` logical operator. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=) operator`. Supported fields: * `targetingType` Examples: +// * targetingType with value TARGETING_TYPE_CHANNEL // `targetingType="TARGETING_TYPE_CHANNEL" The length of this field -// should be no more than 500 characters. +// should be no more than 500 characters. Reference our filter `LIST` +// requests (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersListAssignedTargetingOptionsCall) Filter(filter string) *AdvertisersListAssignedTargetingOptionsCall { c.urlParams_.Set("filter", filter) return c @@ -19549,7 +19614,7 @@ func (c *AdvertisersListAssignedTargetingOptionsCall) Do(opts ...googleapi.CallO // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`.. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` Examples: * targetingType with value TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_CHANNEL\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=) operator`. Supported fields: * `targetingType` Examples: * targetingType with value TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_CHANNEL\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -20471,23 +20536,25 @@ func (r *AdvertisersCampaignsService) List(advertiserId int64) *AdvertisersCampa } // Filter sets the optional parameter "filter": Allows filtering by -// campaign properties. Supported syntax: * Filter expressions are made -// up of one or more restrictions. * Restrictions can be combined by -// `AND` or `OR` logical operators. A sequence of restrictions -// implicitly uses `AND`. * A restriction has the form of `{field} -// {operator} {value}`. * The operator used on `updateTime` must be -// `GREATER THAN OR EQUAL TO (>=)` or `LESS THAN OR EQUAL TO (<=)`. * -// The operator must be `EQUALS (=)`. * Supported fields: - `campaignId` -// - `displayName` - `entityStatus` - `updateTime` (input in ISO 8601 -// format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All +// campaign fields. Supported syntax: * Filter expressions are made up +// of one or more restrictions. * Restrictions can be combined by `AND` +// or `OR` logical operators. A sequence of restrictions implicitly uses +// `AND`. * A restriction has the form of `{field} {operator} {value}`. +// * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (>=)` +// or `LESS THAN OR EQUAL TO (<=)` operators. * All other fields must +// use the `EQUALS (=)` operator. Supported fields: * `campaignId` * +// `displayName` * `entityStatus` * `updateTime` (input in ISO 8601 +// format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * All // `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` campaigns under an // advertiser: `(entityStatus="ENTITY_STATUS_ACTIVE" OR // entityStatus="ENTITY_STATUS_PAUSED")` * All campaigns with an update -// time less than or equal to `2020-11-04T18:54:47Z (format of ISO -// 8601)`: `updateTime<="2020-11-04T18:54:47Z" * All campaigns with an -// update time greater than or equal to `2020-11-04T18:54:47Z (format of -// ISO 8601)`: `updateTime>="2020-11-04T18:54:47Z" The length of this -// field should be no more than 500 characters. +// time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): +// `updateTime<="2020-11-04T18:54:47Z" * All campaigns with an update +// time greater than or equal to 2020-11-04T18:54:47Z (format of ISO +// 8601): `updateTime>="2020-11-04T18:54:47Z" The length of this field +// should be no more than 500 characters. Reference our filter `LIST` +// requests (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersCampaignsListCall) Filter(filter string) *AdvertisersCampaignsListCall { c.urlParams_.Set("filter", filter) return c @@ -20636,7 +20703,7 @@ func (c *AdvertisersCampaignsListCall) Do(opts ...googleapi.CallOption) (*ListCa // "type": "string" // }, // "filter": { - // "description": "Allows filtering by campaign properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)`. * The operator must be `EQUALS (=)`. * Supported fields: - `campaignId` - `displayName` - `entityStatus` - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` campaigns under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\")` * All campaigns with an update time less than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All campaigns with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by campaign fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `campaignId` * `displayName` * `entityStatus` * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` campaigns under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\")` * All campaigns with an update time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All campaigns with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -20716,18 +20783,21 @@ func (r *AdvertisersCampaignsService) ListAssignedTargetingOptions(advertiserId } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR` on the same field. * A -// restriction has the form of `{field} {operator} {value}`. * The -// operator must be `EQUALS (=)`. * Supported fields: - `targetingType` -// - `inheritance` Examples: * AssignedTargetingOptions of targeting -// type TARGETING_TYPE_LANGUAGE or TARGETING_TYPE_GENDER +// can be combined by the `OR` logical operator. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * `targetingType` * +// `inheritance` Examples: * `AssignedTargetingOption` resources of +// targeting type `TARGETING_TYPE_LANGUAGE` or `TARGETING_TYPE_GENDER`: // `targetingType="TARGETING_TYPE_LANGUAGE" OR -// targetingType="TARGETING_TYPE_GENDER" * AssignedTargetingOptions -// with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER -// `inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER" -// The length of this field should be no more than 500 characters. +// targetingType="TARGETING_TYPE_GENDER" * `AssignedTargetingOption` +// resources with inheritance status of `NOT_INHERITED` or +// `INHERITED_FROM_PARTNER`: `inheritance="NOT_INHERITED" OR +// inheritance="INHERITED_FROM_PARTNER" The length of this field should +// be no more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersCampaignsListAssignedTargetingOptionsCall) Filter(filter string) *AdvertisersCampaignsListAssignedTargetingOptionsCall { c.urlParams_.Set("filter", filter) return c @@ -20890,7 +20960,7 @@ func (c *AdvertisersCampaignsListAssignedTargetingOptionsCall) Do(opts ...google // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` - `inheritance` Examples: * AssignedTargetingOptions of targeting type TARGETING_TYPE_LANGUAGE or TARGETING_TYPE_GENDER `targetingType=\"TARGETING_TYPE_LANGUAGE\" OR targetingType=\"TARGETING_TYPE_GENDER\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `targetingType` * `inheritance` Examples: * `AssignedTargetingOption` resources of targeting type `TARGETING_TYPE_LANGUAGE` or `TARGETING_TYPE_GENDER`: `targetingType=\"TARGETING_TYPE_LANGUAGE\" OR targetingType=\"TARGETING_TYPE_GENDER\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -21387,7 +21457,7 @@ func (c *AdvertisersCampaignsTargetingTypesAssignedTargetingOptionsGetCall) Do(o // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -21466,17 +21536,21 @@ func (r *AdvertisersCampaignsTargetingTypesAssignedTargetingOptionsService) List } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `assignedTargetingOptionId` - -// `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 +// can be combined by the `OR` logical operator. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * +// `assignedTargetingOptionId` * `inheritance` Examples: * +// `AssignedTargetingOption` resources with ID 1 or 2 // `assignedTargetingOptionId="1" OR assignedTargetingOptionId="2" * -// AssignedTargetingOptions with inheritance status of NOT_INHERITED or -// INHERITED_FROM_PARTNER `inheritance="NOT_INHERITED" OR -// inheritance="INHERITED_FROM_PARTNER" The length of this field should -// be no more than 500 characters. +// `AssignedTargetingOption` resources with inheritance status of +// `NOT_INHERITED` or `INHERITED_FROM_PARTNER` +// `inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER" +// The length of this field should be no more than 500 characters. +// Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersCampaignsTargetingTypesAssignedTargetingOptionsListCall) Filter(filter string) *AdvertisersCampaignsTargetingTypesAssignedTargetingOptionsListCall { c.urlParams_.Set("filter", filter) return c @@ -21641,7 +21715,7 @@ func (c *AdvertisersCampaignsTargetingTypesAssignedTargetingOptionsListCall) Do( // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` - `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` * `inheritance` Examples: * `AssignedTargetingOption` resources with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER` `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -21748,7 +21822,7 @@ func (c *AdvertisersCampaignsTargetingTypesAssignedTargetingOptionsListCall) Do( // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -22157,12 +22231,14 @@ func (r *AdvertisersChannelsService) List(advertiserId int64) *AdvertisersChanne // Filter sets the optional parameter "filter": Allows filtering by // channel fields. Supported syntax: * Filter expressions for channel -// currently can only contain at most one * restriction. * A restriction -// has the form of `{field} {operator} {value}`. * The operator must be -// `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All +// can only contain at most one restriction. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the `HAS +// (:)` operator. Supported fields: * `displayName` Examples: * All // channels for which the display name contains "google": `displayName : // "google". The length of this field should be no more than 500 -// characters. +// characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersChannelsListCall) Filter(filter string) *AdvertisersChannelsListCall { c.urlParams_.Set("filter", filter) return c @@ -22320,7 +22396,7 @@ func (c *AdvertisersChannelsListCall) Do(opts ...googleapi.CallOption) (*ListCha // "type": "string" // }, // "filter": { - // "description": "Allows filtering by channel fields. Supported syntax: * Filter expressions for channel currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All channels for which the display name contains \"google\": `displayName : \"google\"`. The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by channel fields. Supported syntax: * Filter expressions for channel can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All channels for which the display name contains \"google\": `displayName : \"google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -23087,11 +23163,15 @@ func (r *AdvertisersChannelsSitesService) List(advertiserId int64, channelId int } // Filter sets the optional parameter "filter": Allows filtering by site -// fields. Supported syntax: * Filter expressions for site currently can -// only contain at most one * restriction. * A restriction has the form -// of `{field} {operator} {value}`. * The operator must be `CONTAINS -// (:)`. * Supported fields: - `urlOrAppId` Examples: * All sites for +// fields. Supported syntax: * Filter expressions for site retrieval can +// only contain at most one restriction. * A restriction has the form of +// `{field} {operator} {value}`. * All fields must use the `HAS (:)` +// operator. Supported fields: * `urlOrAppId` Examples: * All sites for // which the URL or app ID contains "google": `urlOrAppId : "google" +// The length of this field should be no more than 500 characters. +// Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersChannelsSitesListCall) Filter(filter string) *AdvertisersChannelsSitesListCall { c.urlParams_.Set("filter", filter) return c @@ -23259,7 +23339,7 @@ func (c *AdvertisersChannelsSitesListCall) Do(opts ...googleapi.CallOption) (*Li // "type": "string" // }, // "filter": { - // "description": "Allows filtering by site fields. Supported syntax: * Filter expressions for site currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `urlOrAppId` Examples: * All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"`", + // "description": "Allows filtering by site fields. Supported syntax: * Filter expressions for site retrieval can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `urlOrAppId` Examples: * All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -23955,38 +24035,33 @@ func (r *AdvertisersCreativesService) List(advertiserId int64) *AdvertisersCreat } // Filter sets the optional parameter "filter": Allows filtering by -// creative properties. Supported syntax: * Filter expressions are made -// up of one or more restrictions. * Restriction for the same field must -// be combined by `OR`. * Restriction for different fields must be -// combined by `AND`. * Between `(` and `)` there can only be -// restrictions combined by `OR` for the same field. * A restriction has -// the form of `{field} {operator} {value}`. * The operator must be -// `EQUALS (=)` for the following fields: - `entityStatus` - -// `creativeType`. - `dimensions` - `minDuration` - `maxDuration` - -// `approvalStatus` - `exchangeReviewStatus` - `dynamic` - `creativeId` -// * The operator must be `HAS (:)` for the following fields: - -// `lineItemIds` * The operator must be `GREATER THAN OR EQUAL TO (>=)` -// or `LESS THAN OR EQUAL TO (<=)` for the following fields: - -// `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) * -// For `entityStatus`, `minDuration`, `maxDuration`, `updateTime`, and -// `dynamic`, there may be at most one restriction. * For `dimensions`, -// the value is in the form of "{width}x{height}". * For -// `exchangeReviewStatus`, the value is in the form of -// `{exchange}-{reviewStatus}`. * For `minDuration` and `maxDuration`, -// the value is in the form of "{duration}s". Only seconds are -// supported with millisecond granularity. * For `updateTime`, a -// creative resource's field value reflects the last time that a -// creative has been updated, which includes updates made by the system -// (e.g. creative review updates). * There may be multiple `lineItemIds` -// restrictions in order to search against multiple possible line item -// IDs. * There may be multiple `creativeId` restrictions in order to -// search against multiple possible creative IDs. Examples: * All native -// creatives: `creativeType="CREATIVE_TYPE_NATIVE" * All active -// creatives with 300x400 or 50x100 dimensions: -// `entityStatus="ENTITY_STATUS_ACTIVE" AND (dimensions="300x400" OR -// dimensions="50x100")` * All dynamic creatives that are approved by -// AdX or AppNexus, with a minimum duration of 5 seconds and 200ms. -// `dynamic="true" AND minDuration="5.2s" AND +// creative fields. Supported syntax: * Filter expressions are made up +// of one or more restrictions. * Restrictions can be combined by `AND` +// or `OR` logical operators. A sequence of restrictions implicitly uses +// `AND`. * A restriction has the form of `{field} {operator} {value}`. +// * The `lineItemIds` field must use the `HAS (:)` operator. * The +// `updateTime` field must use the `GREATER THAN OR EQUAL TO (>=)` or +// `LESS THAN OR EQUAL TO (<=)` operators. * All other fields must use +// the `EQUALS (=)` operator. * For `entityStatus`, `minDuration`, +// `maxDuration`, `updateTime`, and `dynamic` fields, there may be at +// most one restriction. Supported Fields: * `approvalStatus` * +// `creativeId` * `creativeType` * `dimensions` (input in the form of +// `{width}x{height}`) * `dynamic` * `entityStatus` * +// `exchangeReviewStatus` (input in the form of +// `{exchange}-{reviewStatus}`) * `lineItemIds` * `maxDuration` (input +// in the form of `{duration}s`. Only seconds are supported) * +// `minDuration` (input in the form of `{duration}s`. Only seconds are +// supported) * `updateTime` (input in ISO 8601 format, or +// `YYYY-MM-DDTHH:MM:SSZ`) Notes: * For `updateTime`, a creative +// resource's field value reflects the last time that a creative has +// been updated, which includes updates made by the system (e.g. +// creative review updates). Examples: * All native creatives: +// `creativeType="CREATIVE_TYPE_NATIVE" * All active creatives with +// 300x400 or 50x100 dimensions: `entityStatus="ENTITY_STATUS_ACTIVE" +// AND (dimensions="300x400" OR dimensions="50x100")` * All dynamic +// creatives that are approved by AdX or AppNexus, with a minimum +// duration of 5 seconds and 200ms: `dynamic="true" AND +// minDuration="5.2s" AND // (exchangeReviewStatus="EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROV // ED" OR // exchangeReviewStatus="EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED")` * @@ -23994,9 +24069,11 @@ func (r *AdvertisersCreativesService) List(advertiserId int64) *AdvertisersCreat // `creativeType="CREATIVE_TYPE_VIDEO" AND (lineItemIds:1 OR // lineItemIds:2)` * Find creatives by multiple creative IDs: // `creativeId=1 OR creativeId=2` * All creatives with an update time -// greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: +// greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): // `updateTime>="2020-11-04T18:54:47Z" The length of this field should -// be no more than 500 characters. +// be no more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersCreativesListCall) Filter(filter string) *AdvertisersCreativesListCall { c.urlParams_.Set("filter", filter) return c @@ -24148,7 +24225,7 @@ func (c *AdvertisersCreativesListCall) Do(opts ...googleapi.CallOption) (*ListCr // "type": "string" // }, // "filter": { - // "description": "Allows filtering by creative properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restriction for the same field must be combined by `OR`. * Restriction for different fields must be combined by `AND`. * Between `(` and `)` there can only be restrictions combined by `OR` for the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)` for the following fields: - `entityStatus` - `creativeType`. - `dimensions` - `minDuration` - `maxDuration` - `approvalStatus` - `exchangeReviewStatus` - `dynamic` - `creativeId` * The operator must be `HAS (:)` for the following fields: - `lineItemIds` * The operator must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` for the following fields: - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) * For `entityStatus`, `minDuration`, `maxDuration`, `updateTime`, and `dynamic`, there may be at most one restriction. * For `dimensions`, the value is in the form of `\"{width}x{height}\"`. * For `exchangeReviewStatus`, the value is in the form of `{exchange}-{reviewStatus}`. * For `minDuration` and `maxDuration`, the value is in the form of `\"{duration}s\"`. Only seconds are supported with millisecond granularity. * For `updateTime`, a creative resource's field value reflects the last time that a creative has been updated, which includes updates made by the system (e.g. creative review updates). * There may be multiple `lineItemIds` restrictions in order to search against multiple possible line item IDs. * There may be multiple `creativeId` restrictions in order to search against multiple possible creative IDs. Examples: * All native creatives: `creativeType=\"CREATIVE_TYPE_NATIVE\"` * All active creatives with 300x400 or 50x100 dimensions: `entityStatus=\"ENTITY_STATUS_ACTIVE\" AND (dimensions=\"300x400\" OR dimensions=\"50x100\")` * All dynamic creatives that are approved by AdX or AppNexus, with a minimum duration of 5 seconds and 200ms. `dynamic=\"true\" AND minDuration=\"5.2s\" AND (exchangeReviewStatus=\"EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED\" OR exchangeReviewStatus=\"EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED\")` * All video creatives that are associated with line item ID 1 or 2: `creativeType=\"CREATIVE_TYPE_VIDEO\" AND (lineItemIds:1 OR lineItemIds:2)` * Find creatives by multiple creative IDs: `creativeId=1 OR creativeId=2` * All creatives with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by creative fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `lineItemIds` field must use the `HAS (:)` operator. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * All other fields must use the `EQUALS (=)` operator. * For `entityStatus`, `minDuration`, `maxDuration`, `updateTime`, and `dynamic` fields, there may be at most one restriction. Supported Fields: * `approvalStatus` * `creativeId` * `creativeType` * `dimensions` (input in the form of `{width}x{height}`) * `dynamic` * `entityStatus` * `exchangeReviewStatus` (input in the form of `{exchange}-{reviewStatus}`) * `lineItemIds` * `maxDuration` (input in the form of `{duration}s`. Only seconds are supported) * `minDuration` (input in the form of `{duration}s`. Only seconds are supported) * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Notes: * For `updateTime`, a creative resource's field value reflects the last time that a creative has been updated, which includes updates made by the system (e.g. creative review updates). Examples: * All native creatives: `creativeType=\"CREATIVE_TYPE_NATIVE\"` * All active creatives with 300x400 or 50x100 dimensions: `entityStatus=\"ENTITY_STATUS_ACTIVE\" AND (dimensions=\"300x400\" OR dimensions=\"50x100\")` * All dynamic creatives that are approved by AdX or AppNexus, with a minimum duration of 5 seconds and 200ms: `dynamic=\"true\" AND minDuration=\"5.2s\" AND (exchangeReviewStatus=\"EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED\" OR exchangeReviewStatus=\"EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED\")` * All video creatives that are associated with line item ID 1 or 2: `creativeType=\"CREATIVE_TYPE_VIDEO\" AND (lineItemIds:1 OR lineItemIds:2)` * Find creatives by multiple creative IDs: `creativeId=1 OR creativeId=2` * All creatives with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -24855,31 +24932,31 @@ func (r *AdvertisersInsertionOrdersService) List(advertiserId int64) *Advertiser } // Filter sets the optional parameter "filter": Allows filtering by -// insertion order properties. Supported syntax: * Filter expressions -// are made up of one or more restrictions. * Restrictions can be -// combined by `AND` or `OR` logical operators. A sequence of -// restrictions implicitly uses `AND`. * A restriction has the form of -// `{field} {operator} {value}`. * The operator used on -// `budget.budget_segments.date_range.end_date` must be LESS THAN (<). * -// The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO -// (>=)` or `LESS THAN OR EQUAL TO (<=)`. * The operators used on all -// other fields must be `EQUALS (=)`. * Supported fields: - `campaignId` -// - `displayName` - `entityStatus` - -// `budget.budget_segments.date_range.end_date` (input as YYYY-MM-DD) - -// `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) +// insertion order fields. Supported syntax: * Filter expressions are +// made up of one or more restrictions. * Restrictions can be combined +// by `AND` or `OR` logical operators. A sequence of restrictions +// implicitly uses `AND`. * A restriction has the form of `{field} +// {operator} {value}`. * The +// `budget.budget_segments.date_range.end_date` field must use the `LESS +// THAN (<)` operator. * The `updateTime` field must use the `GREATER +// THAN OR EQUAL TO (>=)` or `LESS THAN OR EQUAL TO (<=)` operators. * +// All other fields must use the `EQUALS (=)` operator. Supported +// fields: * `campaignId` * `displayName` * `entityStatus` * +// `budget.budget_segments.date_range.end_date` (input in the form of +// `YYYY-MM-DD`) **Deprecated. Not available after June 8, 2023** * +// `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) // Examples: * All insertion orders under a campaign: // `campaignId="1234" * All `ENTITY_STATUS_ACTIVE` or // `ENTITY_STATUS_PAUSED` insertion orders under an advertiser: // `(entityStatus="ENTITY_STATUS_ACTIVE" OR -// entityStatus="ENTITY_STATUS_PAUSED")` * All insertion orders whose -// budget segments' dates end before March 28, 2019: -// `budget.budget_segments.date_range.end_date<"2019-03-28" * All -// insertion orders with an update time less than or equal to -// `2020-11-04T18:54:47Z (format of ISO 8601)`: -// `updateTime<="2020-11-04T18:54:47Z" * All insertion orders with an -// update time greater than or equal to `2020-11-04T18:54:47Z (format of -// ISO 8601)`: `updateTime>="2020-11-04T18:54:47Z" The length of this -// field should be no more than 500 characters. +// entityStatus="ENTITY_STATUS_PAUSED")` * All insertion orders with an +// update time less than or equal to 2020-11-04T18:54:47Z (format of ISO +// 8601): `updateTime<="2020-11-04T18:54:47Z" * All insertion orders +// with an update time greater than or equal to 2020-11-04T18:54:47Z +// (format of ISO 8601): `updateTime>="2020-11-04T18:54:47Z" The length +// of this field should be no more than 500 characters. Reference our +// filter `LIST` requests (/display-video/api/guides/how-tos/filters) +// guide for more information. func (c *AdvertisersInsertionOrdersListCall) Filter(filter string) *AdvertisersInsertionOrdersListCall { c.urlParams_.Set("filter", filter) return c @@ -25030,7 +25107,7 @@ func (c *AdvertisersInsertionOrdersListCall) Do(opts ...googleapi.CallOption) (* // "type": "string" // }, // "filter": { - // "description": "Allows filtering by insertion order properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator used on `budget.budget_segments.date_range.end_date` must be LESS THAN (\u003c). * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)`. * The operators used on all other fields must be `EQUALS (=)`. * Supported fields: - `campaignId` - `displayName` - `entityStatus` - `budget.budget_segments.date_range.end_date` (input as YYYY-MM-DD) - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) Examples: * All insertion orders under a campaign: `campaignId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` insertion orders under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\")` * All insertion orders whose budget segments' dates end before March 28, 2019: `budget.budget_segments.date_range.end_date\u003c\"2019-03-28\"` * All insertion orders with an update time less than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All insertion orders with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by insertion order fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `budget.budget_segments.date_range.end_date` field must use the `LESS THAN (\u003c)` operator. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `campaignId` * `displayName` * `entityStatus` * `budget.budget_segments.date_range.end_date` (input in the form of `YYYY-MM-DD`) **Deprecated. Not available after June 8, 2023** * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) Examples: * All insertion orders under a campaign: `campaignId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` insertion orders under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\")` * All insertion orders with an update time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All insertion orders with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -25110,18 +25187,22 @@ func (r *AdvertisersInsertionOrdersService) ListAssignedTargetingOptions(adverti } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR` on the same field. * A -// restriction has the form of `{field} {operator} {value}`. * The -// operator must be `EQUALS (=)`. * Supported fields: - `targetingType` -// - `inheritance` Examples: * AssignedTargetingOptions of targeting -// type TARGETING_TYPE_PROXIMITY_LOCATION_LIST or TARGETING_TYPE_CHANNEL +// can be combined by the logical operator `OR`. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * `targetingType` * +// `inheritance` Examples: * `AssignedTargetingOption` resources of +// targeting type `TARGETING_TYPE_PROXIMITY_LOCATION_LIST` or +// `TARGETING_TYPE_CHANNEL`: // `targetingType="TARGETING_TYPE_PROXIMITY_LOCATION_LIST" OR -// targetingType="TARGETING_TYPE_CHANNEL" * AssignedTargetingOptions -// with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER -// `inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER" -// The length of this field should be no more than 500 characters. +// targetingType="TARGETING_TYPE_CHANNEL" * `AssignedTargetingOption` +// resources with inheritance status of `NOT_INHERITED` or +// `INHERITED_FROM_PARTNER`: `inheritance="NOT_INHERITED" OR +// inheritance="INHERITED_FROM_PARTNER" The length of this field should +// be no more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersInsertionOrdersListAssignedTargetingOptionsCall) Filter(filter string) *AdvertisersInsertionOrdersListAssignedTargetingOptionsCall { c.urlParams_.Set("filter", filter) return c @@ -25277,7 +25358,7 @@ func (c *AdvertisersInsertionOrdersListAssignedTargetingOptionsCall) Do(opts ... // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` - `inheritance` Examples: * AssignedTargetingOptions of targeting type TARGETING_TYPE_PROXIMITY_LOCATION_LIST or TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_PROXIMITY_LOCATION_LIST\" OR targetingType=\"TARGETING_TYPE_CHANNEL\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `targetingType` * `inheritance` Examples: * `AssignedTargetingOption` resources of targeting type `TARGETING_TYPE_PROXIMITY_LOCATION_LIST` or `TARGETING_TYPE_CHANNEL`: `targetingType=\"TARGETING_TYPE_PROXIMITY_LOCATION_LIST\" OR targetingType=\"TARGETING_TYPE_CHANNEL\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -25767,7 +25848,7 @@ func (c *AdvertisersInsertionOrdersTargetingTypesAssignedTargetingOptionsCreateC // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -26066,7 +26147,7 @@ func (c *AdvertisersInsertionOrdersTargetingTypesAssignedTargetingOptionsDeleteC // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -26389,7 +26470,7 @@ func (c *AdvertisersInsertionOrdersTargetingTypesAssignedTargetingOptionsGetCall // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -26485,17 +26566,21 @@ func (r *AdvertisersInsertionOrdersTargetingTypesAssignedTargetingOptionsService } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions // can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `assignedTargetingOptionId` - -// `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * +// `assignedTargetingOptionId` * `inheritance` Examples: * +// `AssignedTargetingOption` resources with ID 1 or 2: // `assignedTargetingOptionId="1" OR assignedTargetingOptionId="2" * -// AssignedTargetingOptions with inheritance status of NOT_INHERITED or -// INHERITED_FROM_PARTNER `inheritance="NOT_INHERITED" OR -// inheritance="INHERITED_FROM_PARTNER" The length of this field should -// be no more than 500 characters. +// `AssignedTargetingOption` resources with inheritance status of +// `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: +// `inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER" +// The length of this field should be no more than 500 characters. +// Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersInsertionOrdersTargetingTypesAssignedTargetingOptionsListCall) Filter(filter string) *AdvertisersInsertionOrdersTargetingTypesAssignedTargetingOptionsListCall { c.urlParams_.Set("filter", filter) return c @@ -26652,7 +26737,7 @@ func (c *AdvertisersInsertionOrdersTargetingTypesAssignedTargetingOptionsListCal // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` - `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` * `inheritance` Examples: * `AssignedTargetingOption` resources with ID 1 or 2: `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -26767,7 +26852,7 @@ func (c *AdvertisersInsertionOrdersTargetingTypesAssignedTargetingOptionsListCal // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -27405,18 +27490,22 @@ func (r *AdvertisersLineItemsService) BulkListAssignedTargetingOptions(advertise } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions // can be combined by the logical operator `OR` on the same field. * A -// restriction has the form of `{field} {operator} {value}`. * The -// operator must be `EQUALS (=)`. * Supported fields: - `targetingType` -// - `inheritance` Examples: * AssignedTargetingOptions of targeting -// type TARGETING_TYPE_PROXIMITY_LOCATION_LIST or TARGETING_TYPE_CHANNEL +// restriction has the form of `{field} {operator} {value}`. * All +// fields must use the `EQUALS (=)` operator. Supported fields: * +// `targetingType` * `inheritance` Examples: * `AssignedTargetingOption` +// resources of targeting type `TARGETING_TYPE_PROXIMITY_LOCATION_LIST` +// or `TARGETING_TYPE_CHANNEL`: // `targetingType="TARGETING_TYPE_PROXIMITY_LOCATION_LIST" OR -// targetingType="TARGETING_TYPE_CHANNEL" * AssignedTargetingOptions -// with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER -// `inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER" -// The length of this field should be no more than 500 characters. +// targetingType="TARGETING_TYPE_CHANNEL" * `AssignedTargetingOption` +// resources with inheritance status of `NOT_INHERITED` or +// `INHERITED_FROM_PARTNER`: `inheritance="NOT_INHERITED" OR +// inheritance="INHERITED_FROM_PARTNER" The length of this field should +// be no more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersLineItemsBulkListAssignedTargetingOptionsCall) Filter(filter string) *AdvertisersLineItemsBulkListAssignedTargetingOptionsCall { c.urlParams_.Set("filter", filter) return c @@ -27580,7 +27669,7 @@ func (c *AdvertisersLineItemsBulkListAssignedTargetingOptionsCall) Do(opts ...go // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` - `inheritance` Examples: * AssignedTargetingOptions of targeting type TARGETING_TYPE_PROXIMITY_LOCATION_LIST or TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_PROXIMITY_LOCATION_LIST\" OR targetingType=\"TARGETING_TYPE_CHANNEL\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `targetingType` * `inheritance` Examples: * `AssignedTargetingOption` resources of targeting type `TARGETING_TYPE_PROXIMITY_LOCATION_LIST` or `TARGETING_TYPE_CHANNEL`: `targetingType=\"TARGETING_TYPE_PROXIMITY_LOCATION_LIST\" OR targetingType=\"TARGETING_TYPE_CHANNEL\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -28570,38 +28659,41 @@ func (r *AdvertisersLineItemsService) List(advertiserId int64) *AdvertisersLineI } // Filter sets the optional parameter "filter": Allows filtering by line -// item properties. Supported syntax: * Filter expressions are made up -// of one or more restrictions. * Restrictions can be combined by `AND` -// or `OR` logical operators. A sequence of restrictions implicitly uses +// item fields. Supported syntax: * Filter expressions are made up of +// one or more restrictions. * Restrictions can be combined by `AND` or +// `OR` logical operators. A sequence of restrictions implicitly uses // `AND`. * A restriction has the form of `{field} {operator} {value}`. -// * The operator used on `flight.dateRange.endDate` must be LESS THAN -// (<). * The operator used on `updateTime` must be `GREATER THAN OR -// EQUAL TO (>=)` or `LESS THAN OR EQUAL TO (<=)`. * The operator used -// on `warningMessages` must be `HAS (:)`. * The operators used on all -// other fields must be `EQUALS (=)`. * Supported properties: - -// `campaignId` - `displayName` - `insertionOrderId` - `entityStatus` - -// `lineItemId` - `lineItemType` - `flight.dateRange.endDate` (input -// formatted as YYYY-MM-DD) - `warningMessages` - `flight.triggerId` - -// `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) - -// `targetedChannelId` - `targetedNegativeKeywordListId` Examples: * All -// line items under an insertion order: `insertionOrderId="1234" * All -// `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` and -// `LINE_ITEM_TYPE_DISPLAY_DEFAULT` line items under an advertiser: -// `(entityStatus="ENTITY_STATUS_ACTIVE" OR +// * The `flight.dateRange.endDate` field must use the `LESS THAN (<)` +// operator. * The `updateTime` field must use the `GREATER THAN OR +// EQUAL TO (>=)` or `LESS THAN OR EQUAL TO (<=)` operators. * The +// `warningMessages` field must use the `HAS (:)` operator. * All other +// fields must use the `EQUALS (=)` operator. Supported fields: * +// `campaignId` * `displayName` * `entityStatus` * +// `flight.dateRange.endDate` (input formatted as `YYYY-MM-DD`) +// **Deprecated. Not available after June 8, 2023** * `flight.triggerId` +// * `insertionOrderId` * `lineItemId` * `lineItemType` * +// `targetedChannelId` * `targetedNegativeKeywordListId` * `updateTime` +// (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) * +// `warningMessages` Examples: * All line items under an insertion +// order: `insertionOrderId="1234" * All `ENTITY_STATUS_ACTIVE` or +// `ENTITY_STATUS_PAUSED` and `LINE_ITEM_TYPE_DISPLAY_DEFAULT` line +// items under an advertiser: `(entityStatus="ENTITY_STATUS_ACTIVE" OR // entityStatus="ENTITY_STATUS_PAUSED") AND // lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" * All line items whose // flight dates end before March 28, 2019: // `flight.dateRange.endDate<"2019-03-28" * All line items that have // `NO_VALID_CREATIVE` in `warningMessages`: // `warningMessages:"NO_VALID_CREATIVE" * All line items with an update -// time less than or equal to `2020-11-04T18:54:47Z (format of ISO -// 8601)`: `updateTime<="2020-11-04T18:54:47Z" * All line items with an -// update time greater than or equal to `2020-11-04T18:54:47Z (format of -// ISO 8601)`: `updateTime>="2020-11-04T18:54:47Z" * All line items -// that are using both the specified channel and specified negative -// keyword list in their targeting: `targetedNegativeKeywordListId=789 -// AND targetedChannelId=12345` The length of this field should be no -// more than 500 characters. +// time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): +// `updateTime<="2020-11-04T18:54:47Z" * All line items with an update +// time greater than or equal to 2020-11-04T18:54:47Z (format of ISO +// 8601): `updateTime>="2020-11-04T18:54:47Z" * All line items that are +// using both the specified channel and specified negative keyword list +// in their targeting: `targetedNegativeKeywordListId=789 AND +// targetedChannelId=12345` The length of this field should be no more +// than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersLineItemsListCall) Filter(filter string) *AdvertisersLineItemsListCall { c.urlParams_.Set("filter", filter) return c @@ -28609,10 +28701,11 @@ func (c *AdvertisersLineItemsListCall) Filter(filter string) *AdvertisersLineIte // OrderBy sets the optional parameter "orderBy": Field by which to sort // the list. Acceptable values are: * `displayName` (default) * -// `entityStatus` * `flight.dateRange.endDate` * `updateTime` The -// default sorting order is ascending. To specify descending order for a -// field, a suffix "desc" should be added to the field name. Example: -// `displayName desc`. +// `entityStatus` * `flight.dateRange.endDate` **Deprecated. Not +// available after June 8, 2023** * `updateTime` The default sorting +// order is ascending. To specify descending order for a field, a suffix +// "desc" should be added to the field name. Example: `displayName +// desc`. func (c *AdvertisersLineItemsListCall) OrderBy(orderBy string) *AdvertisersLineItemsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -28753,12 +28846,12 @@ func (c *AdvertisersLineItemsListCall) Do(opts ...googleapi.CallOption) (*ListLi // "type": "string" // }, // "filter": { - // "description": "Allows filtering by line item properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator used on `flight.dateRange.endDate` must be LESS THAN (\u003c). * The operator used on `updateTime` must be `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)`. * The operator used on `warningMessages` must be `HAS (:)`. * The operators used on all other fields must be `EQUALS (=)`. * Supported properties: - `campaignId` - `displayName` - `insertionOrderId` - `entityStatus` - `lineItemId` - `lineItemType` - `flight.dateRange.endDate` (input formatted as YYYY-MM-DD) - `warningMessages` - `flight.triggerId` - `updateTime` (input in ISO 8601 format, or YYYY-MM-DDTHH:MM:SSZ) - `targetedChannelId` - `targetedNegativeKeywordListId` Examples: * All line items under an insertion order: `insertionOrderId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` and `LINE_ITEM_TYPE_DISPLAY_DEFAULT` line items under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\") AND lineItemType=\"LINE_ITEM_TYPE_DISPLAY_DEFAULT\"` * All line items whose flight dates end before March 28, 2019: `flight.dateRange.endDate\u003c\"2019-03-28\"` * All line items that have `NO_VALID_CREATIVE` in `warningMessages`: `warningMessages:\"NO_VALID_CREATIVE\"` * All line items with an update time less than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All line items with an update time greater than or equal to `2020-11-04T18:54:47Z (format of ISO 8601)`: `updateTime\u003e=\"2020-11-04T18:54:47Z\"` * All line items that are using both the specified channel and specified negative keyword list in their targeting: `targetedNegativeKeywordListId=789 AND targetedChannelId=12345` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by line item fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `flight.dateRange.endDate` field must use the `LESS THAN (\u003c)` operator. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (\u003e=)` or `LESS THAN OR EQUAL TO (\u003c=)` operators. * The `warningMessages` field must use the `HAS (:)` operator. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `campaignId` * `displayName` * `entityStatus` * `flight.dateRange.endDate` (input formatted as `YYYY-MM-DD`) **Deprecated. Not available after June 8, 2023** * `flight.triggerId` * `insertionOrderId` * `lineItemId` * `lineItemType` * `targetedChannelId` * `targetedNegativeKeywordListId` * `updateTime` (input in ISO 8601 format, or `YYYY-MM-DDTHH:MM:SSZ`) * `warningMessages` Examples: * All line items under an insertion order: `insertionOrderId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` and `LINE_ITEM_TYPE_DISPLAY_DEFAULT` line items under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\") AND lineItemType=\"LINE_ITEM_TYPE_DISPLAY_DEFAULT\"` * All line items whose flight dates end before March 28, 2019: `flight.dateRange.endDate\u003c\"2019-03-28\"` * All line items that have `NO_VALID_CREATIVE` in `warningMessages`: `warningMessages:\"NO_VALID_CREATIVE\"` * All line items with an update time less than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003c=\"2020-11-04T18:54:47Z\"` * All line items with an update time greater than or equal to 2020-11-04T18:54:47Z (format of ISO 8601): `updateTime\u003e=\"2020-11-04T18:54:47Z\"` * All line items that are using both the specified channel and specified negative keyword list in their targeting: `targetedNegativeKeywordListId=789 AND targetedChannelId=12345` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, // "orderBy": { - // "description": "Field by which to sort the list. Acceptable values are: * `displayName` (default) * `entityStatus` * `flight.dateRange.endDate` * `updateTime` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `displayName desc`.", + // "description": "Field by which to sort the list. Acceptable values are: * `displayName` (default) * `entityStatus` * `flight.dateRange.endDate` **Deprecated. Not available after June 8, 2023** * `updateTime` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `displayName desc`.", // "location": "query", // "type": "string" // }, @@ -29253,7 +29346,7 @@ func (c *AdvertisersLineItemsTargetingTypesAssignedTargetingOptionsCreateCall) D // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -29567,7 +29660,7 @@ func (c *AdvertisersLineItemsTargetingTypesAssignedTargetingOptionsDeleteCall) D // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -29893,7 +29986,7 @@ func (c *AdvertisersLineItemsTargetingTypesAssignedTargetingOptionsGetCall) Do(o // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -29992,17 +30085,21 @@ func (r *AdvertisersLineItemsTargetingTypesAssignedTargetingOptionsService) List } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions // can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `assignedTargetingOptionId` - -// `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * +// `assignedTargetingOptionId` * `inheritance` Examples: * +// `AssignedTargetingOption` resources with ID 1 or 2: // `assignedTargetingOptionId="1" OR assignedTargetingOptionId="2" * -// AssignedTargetingOptions with inheritance status of NOT_INHERITED or -// INHERITED_FROM_PARTNER `inheritance="NOT_INHERITED" OR -// inheritance="INHERITED_FROM_PARTNER" The length of this field should -// be no more than 500 characters. +// `AssignedTargetingOption` resources with inheritance status of +// `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: +// `inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER" +// The length of this field should be no more than 500 characters. +// Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersLineItemsTargetingTypesAssignedTargetingOptionsListCall) Filter(filter string) *AdvertisersLineItemsTargetingTypesAssignedTargetingOptionsListCall { c.urlParams_.Set("filter", filter) return c @@ -30159,7 +30256,7 @@ func (c *AdvertisersLineItemsTargetingTypesAssignedTargetingOptionsListCall) Do( // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` - `inheritance` Examples: * AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * AssignedTargetingOptions with inheritance status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` * `inheritance` Examples: * `AssignedTargetingOption` resources with ID 1 or 2: `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` * `AssignedTargetingOption` resources with inheritance status of `NOT_INHERITED` or `INHERITED_FROM_PARTNER`: `inheritance=\"NOT_INHERITED\" OR inheritance=\"INHERITED_FROM_PARTNER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -30274,7 +30371,7 @@ func (c *AdvertisersLineItemsTargetingTypesAssignedTargetingOptionsListCall) Do( // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -30661,10 +30758,14 @@ func (r *AdvertisersLocationListsService) List(advertiserId int64) *AdvertisersL // up of one or more restrictions. * Restrictions can be combined by // `AND` or `OR` logical operators. A sequence of restrictions // implicitly uses `AND`. * A restriction has the form of `{field} -// {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported -// fields: - `locationType` Examples: * All regional location list: -// `locationType="TARGETING_LOCATION_TYPE_REGIONAL" * All proximity -// location list: `locationType="TARGETING_LOCATION_TYPE_PROXIMITY" +// {operator} {value}`. * All fields must use the `EQUALS (=)` operator. +// Supported fields: * `locationType` Examples: * All regional location +// list: `locationType="TARGETING_LOCATION_TYPE_REGIONAL" * All +// proximity location list: +// `locationType="TARGETING_LOCATION_TYPE_PROXIMITY" The length of this +// field should be no more than 500 characters. Reference our filter +// `LIST` requests (/display-video/api/guides/how-tos/filters) guide for +// more information. func (c *AdvertisersLocationListsListCall) Filter(filter string) *AdvertisersLocationListsListCall { c.urlParams_.Set("filter", filter) return c @@ -30814,7 +30915,7 @@ func (c *AdvertisersLocationListsListCall) Do(opts ...googleapi.CallOption) (*Li // "type": "string" // }, // "filter": { - // "description": "Allows filtering by location list fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `locationType` Examples: * All regional location list: `locationType=\"TARGETING_LOCATION_TYPE_REGIONAL\"` * All proximity location list: `locationType=\"TARGETING_LOCATION_TYPE_PROXIMITY\"`", + // "description": "Allows filtering by location list fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `locationType` Examples: * All regional location list: `locationType=\"TARGETING_LOCATION_TYPE_REGIONAL\"` * All proximity location list: `locationType=\"TARGETING_LOCATION_TYPE_PROXIMITY\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -31545,10 +31646,13 @@ func (r *AdvertisersLocationListsAssignedLocationsService) List(advertiserId int // Filter sets the optional parameter "filter": Allows filtering by // location list assignment fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `assignedLocationId` The length of this -// field should be no more than 500 characters. +// can be combined by the `OR` logical operator. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * `assignedLocationId` The +// length of this field should be no more than 500 characters. Reference +// our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersLocationListsAssignedLocationsListCall) Filter(filter string) *AdvertisersLocationListsAssignedLocationsListCall { c.urlParams_.Set("filter", filter) return c @@ -31700,7 +31804,7 @@ func (c *AdvertisersLocationListsAssignedLocationsListCall) Do(opts ...googleapi // "type": "string" // }, // "filter": { - // "description": "Allows filtering by location list assignment fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedLocationId` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by location list assignment fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedLocationId` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -31774,7 +31878,11 @@ type AdvertisersManualTriggersActivateCall struct { // Activate: Activates a manual trigger. Each activation of the manual // trigger must be at least 5 minutes apart, otherwise an error will be -// returned. +// returned. **Warning:** Line Items using manual triggers will stop +// serving in Display & Video 360 on **May 17, 2023**. Read our feature +// deprecation announcement +// (/display-video/api/deprecations#features.manual_triggers) for more +// information. // // - advertiserId: The ID of the advertiser that the manual trigger // belongs. @@ -31879,7 +31987,7 @@ func (c *AdvertisersManualTriggersActivateCall) Do(opts ...googleapi.CallOption) } return ret, nil // { - // "description": "Activates a manual trigger. Each activation of the manual trigger must be at least 5 minutes apart, otherwise an error will be returned.", + // "description": "Activates a manual trigger. Each activation of the manual trigger must be at least 5 minutes apart, otherwise an error will be returned. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", // "flatPath": "v2/advertisers/{advertisersId}/manualTriggers/{manualTriggersId}:activate", // "httpMethod": "POST", // "id": "displayvideo.advertisers.manualTriggers.activate", @@ -31931,7 +32039,11 @@ type AdvertisersManualTriggersCreateCall struct { } // Create: Creates a new manual trigger. Returns the newly created -// manual trigger if successful. +// manual trigger if successful. **Warning:** Line Items using manual +// triggers will stop serving in Display & Video 360 on **May 17, +// 2023**. Read our feature deprecation announcement +// (/display-video/api/deprecations#features.manual_triggers) for more +// information. // // - advertiserId: Immutable. The unique ID of the advertiser that the // manual trigger belongs to. @@ -32033,7 +32145,7 @@ func (c *AdvertisersManualTriggersCreateCall) Do(opts ...googleapi.CallOption) ( } return ret, nil // { - // "description": "Creates a new manual trigger. Returns the newly created manual trigger if successful.", + // "description": "Creates a new manual trigger. Returns the newly created manual trigger if successful. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", // "flatPath": "v2/advertisers/{advertisersId}/manualTriggers", // "httpMethod": "POST", // "id": "displayvideo.advertisers.manualTriggers.create", @@ -32076,7 +32188,11 @@ type AdvertisersManualTriggersDeactivateCall struct { header_ http.Header } -// Deactivate: Deactivates a manual trigger. +// Deactivate: Deactivates a manual trigger. **Warning:** Line Items +// using manual triggers will stop serving in Display & Video 360 on +// **May 17, 2023**. Read our feature deprecation announcement +// (/display-video/api/deprecations#features.manual_triggers) for more +// information. // // - advertiserId: The ID of the advertiser that the manual trigger // belongs. @@ -32181,7 +32297,7 @@ func (c *AdvertisersManualTriggersDeactivateCall) Do(opts ...googleapi.CallOptio } return ret, nil // { - // "description": "Deactivates a manual trigger.", + // "description": "Deactivates a manual trigger. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", // "flatPath": "v2/advertisers/{advertisersId}/manualTriggers/{manualTriggersId}:deactivate", // "httpMethod": "POST", // "id": "displayvideo.advertisers.manualTriggers.deactivate", @@ -32233,7 +32349,11 @@ type AdvertisersManualTriggersGetCall struct { header_ http.Header } -// Get: Gets a manual trigger. +// Get: Gets a manual trigger. **Warning:** Line Items using manual +// triggers will stop serving in Display & Video 360 on **May 17, +// 2023**. Read our feature deprecation announcement +// (/display-video/api/deprecations#features.manual_triggers) for more +// information. // // - advertiserId: The ID of the advertiser this manual trigger belongs // to. @@ -32345,7 +32465,7 @@ func (c *AdvertisersManualTriggersGetCall) Do(opts ...googleapi.CallOption) (*Ma } return ret, nil // { - // "description": "Gets a manual trigger.", + // "description": "Gets a manual trigger. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", // "flatPath": "v2/advertisers/{advertisersId}/manualTriggers/{manualTriggersId}", // "httpMethod": "GET", // "id": "displayvideo.advertisers.manualTriggers.get", @@ -32395,7 +32515,11 @@ type AdvertisersManualTriggersListCall struct { // List: Lists manual triggers that are accessible to the current user // for a given advertiser ID. The order is defined by the order_by -// parameter. A single advertiser_id is required. +// parameter. A single advertiser_id is required. **Warning:** Line +// Items using manual triggers will stop serving in Display & Video 360 +// on **May 17, 2023**. Read our feature deprecation announcement +// (/display-video/api/deprecations#features.manual_triggers) for more +// information. // // - advertiserId: The ID of the advertiser that the fetched manual // triggers belong to. @@ -32406,14 +32530,16 @@ func (r *AdvertisersManualTriggersService) List(advertiserId int64) *Advertisers } // Filter sets the optional parameter "filter": Allows filtering by -// manual trigger properties. Supported syntax: * Filter expressions are +// manual trigger fields. Supported syntax: * Filter expressions are // made up of one or more restrictions. * Restrictions can be combined // by `AND` or `OR` logical operators. A sequence of restrictions // implicitly uses `AND`. * A restriction has the form of `{field} -// {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported -// fields: - `displayName` - `state` Examples: * All active manual -// triggers under an advertiser: `state="ACTIVE" The length of this -// field should be no more than 500 characters. +// {operator} {value}`. * All fields must use the `EQUALS (=)` operator. +// Supported fields: * `displayName` * `state` Examples: * All active +// manual triggers under an advertiser: `state="ACTIVE" The length of +// this field should be no more than 500 characters. Reference our +// filter `LIST` requests (/display-video/api/guides/how-tos/filters) +// guide for more information. func (c *AdvertisersManualTriggersListCall) Filter(filter string) *AdvertisersManualTriggersListCall { c.urlParams_.Set("filter", filter) return c @@ -32545,7 +32671,7 @@ func (c *AdvertisersManualTriggersListCall) Do(opts ...googleapi.CallOption) (*L } return ret, nil // { - // "description": "Lists manual triggers that are accessible to the current user for a given advertiser ID. The order is defined by the order_by parameter. A single advertiser_id is required.", + // "description": "Lists manual triggers that are accessible to the current user for a given advertiser ID. The order is defined by the order_by parameter. A single advertiser_id is required. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", // "flatPath": "v2/advertisers/{advertisersId}/manualTriggers", // "httpMethod": "GET", // "id": "displayvideo.advertisers.manualTriggers.list", @@ -32562,7 +32688,7 @@ func (c *AdvertisersManualTriggersListCall) Do(opts ...googleapi.CallOption) (*L // "type": "string" // }, // "filter": { - // "description": "Allows filtering by manual trigger properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `displayName` - `state` Examples: * All active manual triggers under an advertiser: `state=\"ACTIVE\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by manual trigger fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `displayName` * `state` Examples: * All active manual triggers under an advertiser: `state=\"ACTIVE\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -32628,7 +32754,11 @@ type AdvertisersManualTriggersPatchCall struct { } // Patch: Updates a manual trigger. Returns the updated manual trigger -// if successful. +// if successful. **Warning:** Line Items using manual triggers will +// stop serving in Display & Video 360 on **May 17, 2023**. Read our +// feature deprecation announcement +// (/display-video/api/deprecations#features.manual_triggers) for more +// information. // // - advertiserId: Immutable. The unique ID of the advertiser that the // manual trigger belongs to. @@ -32740,7 +32870,7 @@ func (c *AdvertisersManualTriggersPatchCall) Do(opts ...googleapi.CallOption) (* } return ret, nil // { - // "description": "Updates a manual trigger. Returns the updated manual trigger if successful.", + // "description": "Updates a manual trigger. Returns the updated manual trigger if successful. **Warning:** Line Items using manual triggers will stop serving in Display \u0026 Video 360 on **May 17, 2023**. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.", // "flatPath": "v2/advertisers/{advertisersId}/manualTriggers/{manualTriggersId}", // "httpMethod": "PATCH", // "id": "displayvideo.advertisers.manualTriggers.patch", @@ -34118,11 +34248,14 @@ func (r *AdvertisersNegativeKeywordListsNegativeKeywordsService) List(advertiser // Filter sets the optional parameter "filter": Allows filtering by // negative keyword fields. Supported syntax: * Filter expressions for -// negative keyword currently can only contain at most one * -// restriction. * A restriction has the form of `{field} {operator} -// {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: -// - `keywordValue` Examples: * All negative keywords for which the -// keyword value contains "google": `keywordValue : "google" +// negative keywords can only contain at most one restriction. * A +// restriction has the form of `{field} {operator} {value}`. * All +// fields must use the `HAS (:)` operator. Supported fields: * +// `keywordValue` Examples: * All negative keywords for which the +// keyword value contains "google": `keywordValue : "google" The length +// of this field should be no more than 500 characters. Reference our +// filter `LIST` requests (/display-video/api/guides/how-tos/filters) +// guide for more information. func (c *AdvertisersNegativeKeywordListsNegativeKeywordsListCall) Filter(filter string) *AdvertisersNegativeKeywordListsNegativeKeywordsListCall { c.urlParams_.Set("filter", filter) return c @@ -34275,7 +34408,7 @@ func (c *AdvertisersNegativeKeywordListsNegativeKeywordsListCall) Do(opts ...goo // "type": "string" // }, // "filter": { - // "description": "Allows filtering by negative keyword fields. Supported syntax: * Filter expressions for negative keyword currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `keywordValue` Examples: * All negative keywords for which the keyword value contains \"google\": `keywordValue : \"google\"`", + // "description": "Allows filtering by negative keyword fields. Supported syntax: * Filter expressions for negative keywords can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `keywordValue` Examples: * All negative keywords for which the keyword value contains \"google\": `keywordValue : \"google\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -34721,7 +34854,7 @@ func (c *AdvertisersTargetingTypesAssignedTargetingOptionsCreateCall) Do(opts .. // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -34988,7 +35121,7 @@ func (c *AdvertisersTargetingTypesAssignedTargetingOptionsDeleteCall) Do(opts .. // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -35268,7 +35401,7 @@ func (c *AdvertisersTargetingTypesAssignedTargetingOptionsGetCall) Do(opts ...go // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -35331,14 +35464,16 @@ func (r *AdvertisersTargetingTypesAssignedTargetingOptionsService) List(advertis } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `assignedTargetingOptionId` Examples: * -// AssignedTargetingOption with ID 123456 -// `assignedTargetingOptionId="123456" The length of this field should -// be no more than 500 characters. +// can be combined by the `OR` logical operator. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * +// `assignedTargetingOptionId` Examples: * `AssignedTargetingOption` +// with ID 123456: `assignedTargetingOptionId="123456" The length of +// this field should be no more than 500 characters. Reference our +// filter `LIST` requests (/display-video/api/guides/how-tos/filters) +// guide for more information. func (c *AdvertisersTargetingTypesAssignedTargetingOptionsListCall) Filter(filter string) *AdvertisersTargetingTypesAssignedTargetingOptionsListCall { c.urlParams_.Set("filter", filter) return c @@ -35493,7 +35628,7 @@ func (c *AdvertisersTargetingTypesAssignedTargetingOptionsListCall) Do(opts ...g // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` Examples: * AssignedTargetingOption with ID 123456 `assignedTargetingOptionId=\"123456\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` Examples: * `AssignedTargetingOption` with ID 123456: `assignedTargetingOptionId=\"123456\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -35600,7 +35735,7 @@ func (c *AdvertisersTargetingTypesAssignedTargetingOptionsListCall) Do(opts ...g // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -35838,16 +35973,19 @@ func (r *AdvertisersYoutubeAdGroupAdsService) List(advertiserId int64) *Advertis // Filter sets the optional parameter "filter": Allows filtering by // custom YouTube ad group ad fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by `AND` and `OR`. Only the restrictions for * the -// same field can be combined by `OR`. A sequence of restrictions * +// can be combined by `AND` and `OR`. A sequence of restrictions // implicitly uses `AND`. * A restriction has the form of `{field} -// {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported -// properties: - `adGroupId` - `displayName` - `entityStatus` - +// {operator} {value}`. * All fields must use the `EQUALS (=)` operator. +// Supported fields: * `adGroupId` * `displayName` * `entityStatus` * // `adGroupAdId` Examples: * All ad group ads under an ad group: -// `adGroupId="1234" and its * entityStatus is `ENTITY_STATUS_ACTIVE` -// or `ENTITY_STATUS_PAUSED`: `(entityStatus="ENTITY_STATUS_ACTIVE" OR +// `adGroupId="1234" * All ad group ads under an ad group with an +// entityStatus of `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED`: +// `(entityStatus="ENTITY_STATUS_ACTIVE" OR // entityStatus="ENTITY_STATUS_PAUSED") AND adGroupId="12345" The -// length of this field should be no more than 500 characters. +// length of this field should be no more than 500 characters. Reference +// our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersYoutubeAdGroupAdsListCall) Filter(filter string) *AdvertisersYoutubeAdGroupAdsListCall { c.urlParams_.Set("filter", filter) return c @@ -35998,7 +36136,7 @@ func (c *AdvertisersYoutubeAdGroupAdsListCall) Do(opts ...googleapi.CallOption) // "type": "string" // }, // "filter": { - // "description": "Allows filtering by custom YouTube ad group ad fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` and `OR`. Only the restrictions for * the same field can be combined by `OR`. A sequence of restrictions * implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported properties: - `adGroupId` - `displayName` - `entityStatus` - `adGroupAdId` Examples: * All ad group ads under an ad group: `adGroupId=\"1234\"` and its * entityStatus is `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED`: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\") AND adGroupId=\"12345\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by custom YouTube ad group ad fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` and `OR`. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `adGroupId` * `displayName` * `entityStatus` * `adGroupAdId` Examples: * All ad group ads under an ad group: `adGroupId=\"1234\"` * All ad group ads under an ad group with an entityStatus of `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED`: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\") AND adGroupId=\"12345\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -36074,16 +36212,18 @@ func (r *AdvertisersYoutubeAdGroupsService) BulkListAdGroupAssignedTargetingOpti } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR` on the same field. * A -// restriction has the form of `{field} {operator} {value}`. * The -// operator must be `EQUALS (=)`. * Supported fields: - `targetingType` -// Examples: * AssignedTargetingOptions of targeting type -// TARGETING_TYPE_YOUTUBE_VIDEO or TARGETING_TYPE_YOUTUBE_CHANNEL +// can be combined by the logical operator `OR`. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * `targetingType` Examples: +// * `AssignedTargetingOption` resources of targeting type +// `TARGETING_TYPE_YOUTUBE_VIDEO` or `TARGETING_TYPE_YOUTUBE_CHANNEL`: // `targetingType="TARGETING_TYPE_YOUTUBE_VIDEO" OR // targetingType="TARGETING_TYPE_YOUTUBE_CHANNEL" The length of this -// field should be no more than 500 characters. +// field should be no more than 500 characters. Reference our filter +// `LIST` requests (/display-video/api/guides/how-tos/filters) guide for +// more information. func (c *AdvertisersYoutubeAdGroupsBulkListAdGroupAssignedTargetingOptionsCall) Filter(filter string) *AdvertisersYoutubeAdGroupsBulkListAdGroupAssignedTargetingOptionsCall { c.urlParams_.Set("filter", filter) return c @@ -36250,7 +36390,7 @@ func (c *AdvertisersYoutubeAdGroupsBulkListAdGroupAssignedTargetingOptionsCall) // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` Examples: * AssignedTargetingOptions of targeting type TARGETING_TYPE_YOUTUBE_VIDEO or TARGETING_TYPE_YOUTUBE_CHANNEL `targetingType=\"TARGETING_TYPE_YOUTUBE_VIDEO\" OR targetingType=\"TARGETING_TYPE_YOUTUBE_CHANNEL\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `targetingType` Examples: * `AssignedTargetingOption` resources of targeting type `TARGETING_TYPE_YOUTUBE_VIDEO` or `TARGETING_TYPE_YOUTUBE_CHANNEL`: `targetingType=\"TARGETING_TYPE_YOUTUBE_VIDEO\" OR targetingType=\"TARGETING_TYPE_YOUTUBE_CHANNEL\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -36493,19 +36633,21 @@ func (r *AdvertisersYoutubeAdGroupsService) List(advertiserId int64) *Advertiser // Filter sets the optional parameter "filter": Allows filtering by // custom YouTube ad group fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by `AND` and `OR`. Only the restrictions for * the -// same field can be combined by `OR`. A sequence of restrictions * +// can be combined by `AND` and `OR`. A sequence of restrictions // implicitly uses `AND`. * A restriction has the form of `{field} -// {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported -// properties: - `adGroupId` - `displayName` - `entityStatus` - -// `lineItemId` - `adGroupFormat` Examples: * All ad groups under an +// {operator} {value}`. * All fields must use the `EQUALS (=)` operator. +// Supported properties: * `adGroupId` * `displayName` * `entityStatus` +// * `lineItemId` * `adGroupFormat` Examples: * All ad groups under an // line item: `lineItemId="1234" * All `ENTITY_STATUS_ACTIVE` or -// `ENTITY_STATUS_PAUSED` and +// `ENTITY_STATUS_PAUSED` // `YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM` ad groups under an // advertiser: `(entityStatus="ENTITY_STATUS_ACTIVE" OR // entityStatus="ENTITY_STATUS_PAUSED") AND // adGroupFormat="YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM" The -// length of this field should be no more than 500 characters. +// length of this field should be no more than 500 characters. Reference +// our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersYoutubeAdGroupsListCall) Filter(filter string) *AdvertisersYoutubeAdGroupsListCall { c.urlParams_.Set("filter", filter) return c @@ -36656,7 +36798,7 @@ func (c *AdvertisersYoutubeAdGroupsListCall) Do(opts ...googleapi.CallOption) (* // "type": "string" // }, // "filter": { - // "description": "Allows filtering by custom YouTube ad group fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` and `OR`. Only the restrictions for * the same field can be combined by `OR`. A sequence of restrictions * implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported properties: - `adGroupId` - `displayName` - `entityStatus` - `lineItemId` - `adGroupFormat` Examples: * All ad groups under an line item: `lineItemId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` and `YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM` ad groups under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\") AND adGroupFormat=\"YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by custom YouTube ad group fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` and `OR`. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported properties: * `adGroupId` * `displayName` * `entityStatus` * `lineItemId` * `adGroupFormat` Examples: * All ad groups under an line item: `lineItemId=\"1234\"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` `YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM` ad groups under an advertiser: `(entityStatus=\"ENTITY_STATUS_ACTIVE\" OR entityStatus=\"ENTITY_STATUS_PAUSED\") AND adGroupFormat=\"YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -36965,7 +37107,7 @@ func (c *AdvertisersYoutubeAdGroupsTargetingTypesAssignedTargetingOptionsGetCall // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -37044,14 +37186,17 @@ func (r *AdvertisersYoutubeAdGroupsTargetingTypesAssignedTargetingOptionsService } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions // can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `assignedTargetingOptionId` Examples: * -// AssignedTargetingOptions with ID 1 or 2 -// `assignedTargetingOptionId="1" OR assignedTargetingOptionId="2" The -// length of this field should be no more than 500 characters. +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * +// `assignedTargetingOptionId` Examples: * `AssignedTargetingOption` +// resources with ID 1 or 2: `assignedTargetingOptionId="1" OR +// assignedTargetingOptionId="2" The length of this field should be no +// more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *AdvertisersYoutubeAdGroupsTargetingTypesAssignedTargetingOptionsListCall) Filter(filter string) *AdvertisersYoutubeAdGroupsTargetingTypesAssignedTargetingOptionsListCall { c.urlParams_.Set("filter", filter) return c @@ -37208,7 +37353,7 @@ func (c *AdvertisersYoutubeAdGroupsTargetingTypesAssignedTargetingOptionsListCal // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` Examples: * AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` Examples: * `AssignedTargetingOption` resources with ID 1 or 2: `assignedTargetingOptionId=\"1\" OR assignedTargetingOptionId=\"2\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -37315,7 +37460,7 @@ func (c *AdvertisersYoutubeAdGroupsTargetingTypesAssignedTargetingOptionsListCal // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -37577,12 +37722,14 @@ func (c *CombinedAudiencesListCall) AdvertiserId(advertiserId int64) *CombinedAu // Filter sets the optional parameter "filter": Allows filtering by // combined audience fields. Supported syntax: * Filter expressions for -// combined audiences currently can only contain at most one -// restriction. * A restriction has the form of `{field} {operator} -// {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: -// - `displayName` Examples: * All combined audiences for which the +// combined audiences can only contain at most one restriction. * A +// restriction has the form of `{field} {operator} {value}`. * All +// fields must use the `HAS (:)` operator. Supported fields: * +// `displayName` Examples: * All combined audiences for which the // display name contains "Google": `displayName : "Google". The length -// of this field should be no more than 500 characters. +// of this field should be no more than 500 characters. Reference our +// filter `LIST` requests (/display-video/api/guides/how-tos/filters) +// guide for more information. func (c *CombinedAudiencesListCall) Filter(filter string) *CombinedAudiencesListCall { c.urlParams_.Set("filter", filter) return c @@ -37733,7 +37880,7 @@ func (c *CombinedAudiencesListCall) Do(opts ...googleapi.CallOption) (*ListCombi // "type": "string" // }, // "filter": { - // "description": "Allows filtering by combined audience fields. Supported syntax: * Filter expressions for combined audiences currently can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All combined audiences for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by combined audience fields. Supported syntax: * Filter expressions for combined audiences can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All combined audiences for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -38120,21 +38267,18 @@ func (c *CustomBiddingAlgorithmsListCall) AdvertiserId(advertiserId int64) *Cust // Filter sets the optional parameter "filter": Allows filtering by // custom bidding algorithm fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by `AND`. A sequence of restrictions * implicitly -// uses `AND`. * A restriction has the form of `{field} {operator} -// {value}`. * The operator must be `CONTAINS (:)` or `EQUALS (=)`. * -// The operator must be `CONTAINS (:)` for the following field: - -// `displayName` * The operator must be `EQUALS (=)` for the following -// field: - `customBiddingAlgorithmType` * For `displayName`, the value -// is a string. We return all custom bidding algorithms whose -// display_name contains such string. * For -// `customBiddingAlgorithmType`, the value is a string. We return all -// algorithms whose custom_bidding_algorithm_type is equal to the given -// type. Examples: * All custom bidding algorithms for which the display -// name contains "politics": `displayName:politics`. * All custom -// bidding algorithms for which the type is "SCRIPT_BASED": +// can be combined by `AND`. A sequence of restrictions implicitly uses +// `AND`. * A restriction has the form of `{field} {operator} {value}`. +// * The `customBiddingAlgorithmType` field must use the `EQUALS (=)` +// operator. * The `displayName` field must use the `HAS (:)` operator. +// Supported fields: * `customBiddingAlgorithmType` * `displayName` +// Examples: * All custom bidding algorithms for which the display name +// contains "politics": `displayName:"politics". * All custom bidding +// algorithms for which the type is "SCRIPT_BASED": // `customBiddingAlgorithmType=SCRIPT_BASED` The length of this field -// should be no more than 500 characters. +// should be no more than 500 characters. Reference our filter `LIST` +// requests (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *CustomBiddingAlgorithmsListCall) Filter(filter string) *CustomBiddingAlgorithmsListCall { c.urlParams_.Set("filter", filter) return c @@ -38286,7 +38430,7 @@ func (c *CustomBiddingAlgorithmsListCall) Do(opts ...googleapi.CallOption) (*Lis // "type": "string" // }, // "filter": { - // "description": "Allows filtering by custom bidding algorithm fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND`. A sequence of restrictions * implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)` or `EQUALS (=)`. * The operator must be `CONTAINS (:)` for the following field: - `displayName` * The operator must be `EQUALS (=)` for the following field: - `customBiddingAlgorithmType` * For `displayName`, the value is a string. We return all custom bidding algorithms whose display_name contains such string. * For `customBiddingAlgorithmType`, the value is a string. We return all algorithms whose custom_bidding_algorithm_type is equal to the given type. Examples: * All custom bidding algorithms for which the display name contains \"politics\": `displayName:politics`. * All custom bidding algorithms for which the type is \"SCRIPT_BASED\": `customBiddingAlgorithmType=SCRIPT_BASED` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by custom bidding algorithm fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND`. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `customBiddingAlgorithmType` field must use the `EQUALS (=)` operator. * The `displayName` field must use the `HAS (:)` operator. Supported fields: * `customBiddingAlgorithmType` * `displayName` Examples: * All custom bidding algorithms for which the display name contains \"politics\": `displayName:\"politics\"`. * All custom bidding algorithms for which the type is \"SCRIPT_BASED\": `customBiddingAlgorithmType=SCRIPT_BASED` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -39470,12 +39614,14 @@ func (c *CustomListsListCall) AdvertiserId(advertiserId int64) *CustomListsListC // Filter sets the optional parameter "filter": Allows filtering by // custom list fields. Supported syntax: * Filter expressions for custom -// lists currently can only contain at most one restriction. * A -// restriction has the form of `{field} {operator} {value}`. * The -// operator must be `CONTAINS (:)`. * Supported fields: - `displayName` -// Examples: * All custom lists for which the display name contains -// "Google": `displayName : "Google". The length of this field should -// be no more than 500 characters. +// lists can only contain at most one restriction. * A restriction has +// the form of `{field} {operator} {value}`. * All fields must use the +// `HAS (:)` operator. Supported fields: * `displayName` Examples: * All +// custom lists for which the display name contains "Google": +// `displayName:"Google". The length of this field should be no more +// than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *CustomListsListCall) Filter(filter string) *CustomListsListCall { c.urlParams_.Set("filter", filter) return c @@ -39619,7 +39765,7 @@ func (c *CustomListsListCall) Do(opts ...googleapi.CallOption) (*ListCustomLists // "type": "string" // }, // "filter": { - // "description": "Allows filtering by custom list fields. Supported syntax: * Filter expressions for custom lists currently can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All custom lists for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by custom list fields. Supported syntax: * Filter expressions for custom lists can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All custom lists for which the display name contains \"Google\": `displayName:\"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -40163,13 +40309,15 @@ func (c *FirstAndThirdPartyAudiencesListCall) AdvertiserId(advertiserId int64) * // Filter sets the optional parameter "filter": Allows filtering by // first and third party audience fields. Supported syntax: * Filter -// expressions for first and third party audiences currently can only -// contain at most one restriction. * A restriction has the form of -// `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. -// * Supported fields: - `displayName` Examples: * All first and third +// expressions for first and third party audiences can only contain at +// most one restriction. * A restriction has the form of `{field} +// {operator} {value}`. * All fields must use the `HAS (:)` operator. +// Supported fields: * `displayName` Examples: * All first and third // party audiences for which the display name contains "Google": -// `displayName : "Google". The length of this field should be no more -// than 500 characters. +// `displayName:"Google". The length of this field should be no more +// than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *FirstAndThirdPartyAudiencesListCall) Filter(filter string) *FirstAndThirdPartyAudiencesListCall { c.urlParams_.Set("filter", filter) return c @@ -40322,7 +40470,7 @@ func (c *FirstAndThirdPartyAudiencesListCall) Do(opts ...googleapi.CallOption) ( // "type": "string" // }, // "filter": { - // "description": "Allows filtering by first and third party audience fields. Supported syntax: * Filter expressions for first and third party audiences currently can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All first and third party audiences for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by first and third party audience fields. Supported syntax: * Filter expressions for first and third party audiences can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All first and third party audiences for which the display name contains \"Google\": `displayName:\"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -41085,12 +41233,14 @@ func (c *GoogleAudiencesListCall) AdvertiserId(advertiserId int64) *GoogleAudien // Filter sets the optional parameter "filter": Allows filtering by // Google audience fields. Supported syntax: * Filter expressions for -// Google audiences currently can only contain at most one restriction. -// * A restriction has the form of `{field} {operator} {value}`. * The -// operator must be `CONTAINS (:)`. * Supported fields: - `displayName` -// Examples: * All Google audiences for which the display name contains -// "Google": `displayName : "Google". The length of this field should -// be no more than 500 characters. +// Google audiences can only contain at most one restriction. * A +// restriction has the form of `{field} {operator} {value}`. * All +// fields must use the `HAS (:)` operator. Supported fields: * +// `displayName` Examples: * All Google audiences for which the display +// name contains "Google": `displayName:"Google". The length of this +// field should be no more than 500 characters. Reference our filter +// `LIST` requests (/display-video/api/guides/how-tos/filters) guide for +// more information. func (c *GoogleAudiencesListCall) Filter(filter string) *GoogleAudiencesListCall { c.urlParams_.Set("filter", filter) return c @@ -41241,7 +41391,7 @@ func (c *GoogleAudiencesListCall) Do(opts ...googleapi.CallOption) (*ListGoogleA // "type": "string" // }, // "filter": { - // "description": "Allows filtering by Google audience fields. Supported syntax: * Filter expressions for Google audiences currently can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All Google audiences for which the display name contains \"Google\": `displayName : \"Google\"`. The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by Google audience fields. Supported syntax: * Filter expressions for Google audiences can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All Google audiences for which the display name contains \"Google\": `displayName:\"Google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -41799,18 +41949,20 @@ func (c *GuaranteedOrdersListCall) AdvertiserId(advertiserId int64) *GuaranteedO } // Filter sets the optional parameter "filter": Allows filtering by -// guaranteed order properties. * Filter expressions are made up of one -// or more restrictions. * Restrictions can be combined by `AND` or `OR` +// guaranteed order fields. * Filter expressions are made up of one or +// more restrictions. * Restrictions can be combined by `AND` or `OR` // logical operators. A sequence of restrictions implicitly uses `AND`. -// * A restriction has the form of `{field} {operator} {value}`. * The -// operator must be `EQUALS (=)`. * Supported fields: - -// `guaranteed_order_id` - `exchange` - `display_name` - +// * A restriction has the form of `{field} {operator} {value}`. * All +// fields must use the `EQUALS (=)` operator. Supported fields: * +// `guaranteed_order_id` * `exchange` * `display_name` * // `status.entityStatus` Examples: * All active guaranteed orders: // `status.entityStatus="ENTITY_STATUS_ACTIVE" * Guaranteed orders // belonging to Google Ad Manager or Rubicon exchanges: // `exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR // exchange="EXCHANGE_RUBICON" The length of this field should be no -// more than 500 characters. +// more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *GuaranteedOrdersListCall) Filter(filter string) *GuaranteedOrdersListCall { c.urlParams_.Set("filter", filter) return c @@ -41959,7 +42111,7 @@ func (c *GuaranteedOrdersListCall) Do(opts ...googleapi.CallOption) (*ListGuaran // "type": "string" // }, // "filter": { - // "description": "Allows filtering by guaranteed order properties. * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `guaranteed_order_id` - `exchange` - `display_name` - `status.entityStatus` Examples: * All active guaranteed orders: `status.entityStatus=\"ENTITY_STATUS_ACTIVE\"` * Guaranteed orders belonging to Google Ad Manager or Rubicon exchanges: `exchange=\"EXCHANGE_GOOGLE_AD_MANAGER\" OR exchange=\"EXCHANGE_RUBICON\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by guaranteed order fields. * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `guaranteed_order_id` * `exchange` * `display_name` * `status.entityStatus` Examples: * All active guaranteed orders: `status.entityStatus=\"ENTITY_STATUS_ACTIVE\"` * Guaranteed orders belonging to Google Ad Manager or Rubicon exchanges: `exchange=\"EXCHANGE_GOOGLE_AD_MANAGER\" OR exchange=\"EXCHANGE_RUBICON\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -42724,12 +42876,15 @@ func (c *InventorySourceGroupsListCall) AdvertiserId(advertiserId int64) *Invent } // Filter sets the optional parameter "filter": Allows filtering by -// inventory source group properties. Supported syntax: * Filter -// expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `inventorySourceGroupId` The length of -// this field should be no more than 500 characters. +// inventory source group fields. Supported syntax: * Filter expressions +// are made up of one or more restrictions. * Restrictions can be +// combined by the logical operator `OR`. * A restriction has the form +// of `{field} {operator} {value}`. * All fields must use the `EQUALS +// (=)` operator. Supported fields: * `inventorySourceGroupId` The +// length of this field should be no more than 500 characters. Reference +// our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *InventorySourceGroupsListCall) Filter(filter string) *InventorySourceGroupsListCall { c.urlParams_.Set("filter", filter) return c @@ -42880,7 +43035,7 @@ func (c *InventorySourceGroupsListCall) Do(opts ...googleapi.CallOption) (*ListI // "type": "string" // }, // "filter": { - // "description": "Allows filtering by inventory source group properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `inventorySourceGroupId` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by inventory source group fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `inventorySourceGroupId` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -43662,10 +43817,13 @@ func (c *InventorySourceGroupsAssignedInventorySourcesListCall) AdvertiserId(adv // Filter sets the optional parameter "filter": Allows filtering by // assigned inventory source fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions -// can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `assignedInventorySourceId` The length of -// this field should be no more than 500 characters. +// can be combined by the `OR` logical operator. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * +// `assignedInventorySourceId` The length of this field should be no +// more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *InventorySourceGroupsAssignedInventorySourcesListCall) Filter(filter string) *InventorySourceGroupsAssignedInventorySourcesListCall { c.urlParams_.Set("filter", filter) return c @@ -43824,7 +43982,7 @@ func (c *InventorySourceGroupsAssignedInventorySourcesListCall) Do(opts ...googl // "type": "string" // }, // "filter": { - // "description": "Allows filtering by assigned inventory source fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedInventorySourceId` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned inventory source fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the `OR` logical operator. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedInventorySourceId` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -44377,19 +44535,21 @@ func (c *InventorySourcesListCall) AdvertiserId(advertiserId int64) *InventorySo } // Filter sets the optional parameter "filter": Allows filtering by -// inventory source properties. Supported syntax: * Filter expressions -// are made up of one or more restrictions. * Restrictions can be -// combined by `AND` or `OR` logical operators. A sequence of -// restrictions implicitly uses `AND`. * A restriction has the form of -// `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * -// Supported fields: - `status.entityStatus` - `commitment` - -// `deliveryMethod` - `rateDetails.rateType` - `exchange` Examples: * +// inventory source fields. Supported syntax: * Filter expressions are +// made up of one or more restrictions. * Restrictions can be combined +// by `AND` or `OR` logical operators. A sequence of restrictions +// implicitly uses `AND`. * A restriction has the form of `{field} +// {operator} {value}`. * All fields must use the `EQUALS (=)` operator. +// Supported fields: * `status.entityStatus` * `commitment` * +// `deliveryMethod` * `rateDetails.rateType` * `exchange` Examples: * // All active inventory sources: // `status.entityStatus="ENTITY_STATUS_ACTIVE" * Inventory sources // belonging to Google Ad Manager or Rubicon exchanges: // `exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR // exchange="EXCHANGE_RUBICON" The length of this field should be no -// more than 500 characters. +// more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *InventorySourcesListCall) Filter(filter string) *InventorySourcesListCall { c.urlParams_.Set("filter", filter) return c @@ -44538,7 +44698,7 @@ func (c *InventorySourcesListCall) Do(opts ...googleapi.CallOption) (*ListInvent // "type": "string" // }, // "filter": { - // "description": "Allows filtering by inventory source properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `status.entityStatus` - `commitment` - `deliveryMethod` - `rateDetails.rateType` - `exchange` Examples: * All active inventory sources: `status.entityStatus=\"ENTITY_STATUS_ACTIVE\"` * Inventory sources belonging to Google Ad Manager or Rubicon exchanges: `exchange=\"EXCHANGE_GOOGLE_AD_MANAGER\" OR exchange=\"EXCHANGE_RUBICON\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by inventory source fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `status.entityStatus` * `commitment` * `deliveryMethod` * `rateDetails.rateType` * `exchange` Examples: * All active inventory sources: `status.entityStatus=\"ENTITY_STATUS_ACTIVE\"` * Inventory sources belonging to Google Ad Manager or Rubicon exchanges: `exchange=\"EXCHANGE_GOOGLE_AD_MANAGER\" OR exchange=\"EXCHANGE_RUBICON\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -45492,14 +45652,16 @@ func (r *PartnersService) List() *PartnersListCall { } // Filter sets the optional parameter "filter": Allows filtering by -// partner properties. Supported syntax: * Filter expressions are made -// up of one or more restrictions. * Restrictions can be combined by -// `AND` or `OR` logical operators. A sequence of restrictions -// implicitly uses `AND`. * A restriction has the form of `{field} -// {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported -// fields: - `entityStatus` Examples: * All active partners: +// partner fields. Supported syntax: * Filter expressions are made up of +// one or more restrictions. * Restrictions can be combined by `AND` or +// `OR` logical operators. A sequence of restrictions implicitly uses +// `AND`. * A restriction has the form of `{field} {operator} {value}`. +// * All fields must use the `EQUALS (=)` operator. Supported fields: * +// `entityStatus` Examples: * All active partners: // `entityStatus="ENTITY_STATUS_ACTIVE" The length of this field should -// be no more than 500 characters. +// be no more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *PartnersListCall) Filter(filter string) *PartnersListCall { c.urlParams_.Set("filter", filter) return c @@ -45635,7 +45797,7 @@ func (c *PartnersListCall) Do(opts ...googleapi.CallOption) (*ListPartnersRespon // "parameterOrder": [], // "parameters": { // "filter": { - // "description": "Allows filtering by partner properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `entityStatus` Examples: * All active partners: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by partner fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `entityStatus` Examples: * All active partners: `entityStatus=\"ENTITY_STATUS_ACTIVE\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -46047,12 +46209,14 @@ func (c *PartnersChannelsListCall) AdvertiserId(advertiserId int64) *PartnersCha // Filter sets the optional parameter "filter": Allows filtering by // channel fields. Supported syntax: * Filter expressions for channel -// currently can only contain at most one * restriction. * A restriction -// has the form of `{field} {operator} {value}`. * The operator must be -// `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All +// can only contain at most one restriction. * A restriction has the +// form of `{field} {operator} {value}`. * All fields must use the `HAS +// (:)` operator. Supported fields: * `displayName` Examples: * All // channels for which the display name contains "google": `displayName : // "google". The length of this field should be no more than 500 -// characters. +// characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *PartnersChannelsListCall) Filter(filter string) *PartnersChannelsListCall { c.urlParams_.Set("filter", filter) return c @@ -46201,7 +46365,7 @@ func (c *PartnersChannelsListCall) Do(opts ...googleapi.CallOption) (*ListChanne // "type": "string" // }, // "filter": { - // "description": "Allows filtering by channel fields. Supported syntax: * Filter expressions for channel currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All channels for which the display name contains \"google\": `displayName : \"google\"`. The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by channel fields. Supported syntax: * Filter expressions for channel can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `displayName` Examples: * All channels for which the display name contains \"google\": `displayName : \"google\"`. The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -46972,11 +47136,15 @@ func (c *PartnersChannelsSitesListCall) AdvertiserId(advertiserId int64) *Partne } // Filter sets the optional parameter "filter": Allows filtering by site -// fields. Supported syntax: * Filter expressions for site currently can -// only contain at most one * restriction. * A restriction has the form -// of `{field} {operator} {value}`. * The operator must be `CONTAINS -// (:)`. * Supported fields: - `urlOrAppId` Examples: * All sites for +// fields. Supported syntax: * Filter expressions for site retrieval can +// only contain at most one restriction. * A restriction has the form of +// `{field} {operator} {value}`. * All fields must use the `HAS (:)` +// operator. Supported fields: * `urlOrAppId` Examples: * All sites for // which the URL or app ID contains "google": `urlOrAppId : "google" +// The length of this field should be no more than 500 characters. +// Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *PartnersChannelsSitesListCall) Filter(filter string) *PartnersChannelsSitesListCall { c.urlParams_.Set("filter", filter) return c @@ -47135,7 +47303,7 @@ func (c *PartnersChannelsSitesListCall) Do(opts ...googleapi.CallOption) (*ListS // "type": "string" // }, // "filter": { - // "description": "Allows filtering by site fields. Supported syntax: * Filter expressions for site currently can only contain at most one * restriction. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)`. * Supported fields: - `urlOrAppId` Examples: * All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"`", + // "description": "Allows filtering by site fields. Supported syntax: * Filter expressions for site retrieval can only contain at most one restriction. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `HAS (:)` operator. Supported fields: * `urlOrAppId` Examples: * All sites for which the URL or app ID contains \"google\": `urlOrAppId : \"google\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -47576,7 +47744,7 @@ func (c *PartnersTargetingTypesAssignedTargetingOptionsCreateCall) Do(opts ...go // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -47840,7 +48008,7 @@ func (c *PartnersTargetingTypesAssignedTargetingOptionsDeleteCall) Do(opts ...go // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -48116,7 +48284,7 @@ func (c *PartnersTargetingTypesAssignedTargetingOptionsGetCall) Do(opts ...googl // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -48175,14 +48343,17 @@ func (r *PartnersTargetingTypesAssignedTargetingOptionsService) List(partnerId i } // Filter sets the optional parameter "filter": Allows filtering by -// assigned targeting option properties. Supported syntax: * Filter +// assigned targeting option fields. Supported syntax: * Filter // expressions are made up of one or more restrictions. * Restrictions // can be combined by the logical operator `OR`. * A restriction has the -// form of `{field} {operator} {value}`. * The operator must be `EQUALS -// (=)`. * Supported fields: - `assignedTargetingOptionId` Examples: * -// AssignedTargetingOption with ID 123456 -// `assignedTargetingOptionId="123456" The length of this field should -// be no more than 500 characters. +// form of `{field} {operator} {value}`. * All fields must use the +// `EQUALS (=)` operator. Supported fields: * +// `assignedTargetingOptionId` Examples: * `AssignedTargetingOption` +// resource with ID 123456: `assignedTargetingOptionId="123456" The +// length of this field should be no more than 500 characters. Reference +// our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *PartnersTargetingTypesAssignedTargetingOptionsListCall) Filter(filter string) *PartnersTargetingTypesAssignedTargetingOptionsListCall { c.urlParams_.Set("filter", filter) return c @@ -48329,7 +48500,7 @@ func (c *PartnersTargetingTypesAssignedTargetingOptionsListCall) Do(opts ...goog // ], // "parameters": { // "filter": { - // "description": "Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` Examples: * AssignedTargetingOption with ID 123456 `assignedTargetingOptionId=\"123456\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by assigned targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `assignedTargetingOptionId` Examples: * `AssignedTargetingOption` resource with ID 123456: `assignedTargetingOptionId=\"123456\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -48444,7 +48615,7 @@ func (c *PartnersTargetingTypesAssignedTargetingOptionsListCall) Do(opts ...goog // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -49040,7 +49211,7 @@ func (c *TargetingTypesTargetingOptionsGetCall) Do(opts ...googleapi.CallOption) // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -49122,20 +49293,22 @@ func (c *TargetingTypesTargetingOptionsListCall) AdvertiserId(advertiserId int64 } // Filter sets the optional parameter "filter": Allows filtering by -// targeting option properties. Supported syntax: * Filter expressions -// are made up of one or more restrictions. * Restrictions can be -// combined by `OR` logical operators. * A restriction has the form of -// `{field} {operator} {value}`. * The operator must be "=" (equal -// sign). * Supported fields: - `carrierAndIspDetails.type` - -// `geoRegionDetails.geoRegionType` - `targetingOptionId` Examples: * +// targeting option fields. Supported syntax: * Filter expressions are +// made up of one or more restrictions. * Restrictions can be combined +// by `OR` logical operators. * A restriction has the form of `{field} +// {operator} {value}`. * All fields must use the `EQUALS (=)` operator. +// Supported fields: * `carrierAndIspDetails.type` * +// `geoRegionDetails.geoRegionType` * `targetingOptionId` Examples: * // All `GEO REGION` targeting options that belong to sub type // `GEO_REGION_TYPE_COUNTRY` or `GEO_REGION_TYPE_STATE`: // `geoRegionDetails.geoRegionType="GEO_REGION_TYPE_COUNTRY" OR // geoRegionDetails.geoRegionType="GEO_REGION_TYPE_STATE" * All // `CARRIER AND ISP` targeting options that belong to sub type // `CARRIER_AND_ISP_TYPE_CARRIER`: -// `carrierAndIspDetails.type="CARRIER_AND_ISP_TYPE_CARRIER". The -// length of this field should be no more than 500 characters. +// `carrierAndIspDetails.type="CARRIER_AND_ISP_TYPE_CARRIER" The length +// of this field should be no more than 500 characters. Reference our +// filter `LIST` requests (/display-video/api/guides/how-tos/filters) +// guide for more information. func (c *TargetingTypesTargetingOptionsListCall) Filter(filter string) *TargetingTypesTargetingOptionsListCall { c.urlParams_.Set("filter", filter) return c @@ -49284,7 +49457,7 @@ func (c *TargetingTypesTargetingOptionsListCall) Do(opts ...googleapi.CallOption // "type": "string" // }, // "filter": { - // "description": "Allows filtering by targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `OR` logical operators. * A restriction has the form of `{field} {operator} {value}`. * The operator must be \"=\" (equal sign). * Supported fields: - `carrierAndIspDetails.type` - `geoRegionDetails.geoRegionType` - `targetingOptionId` Examples: * All `GEO REGION` targeting options that belong to sub type `GEO_REGION_TYPE_COUNTRY` or `GEO_REGION_TYPE_STATE`: `geoRegionDetails.geoRegionType=\"GEO_REGION_TYPE_COUNTRY\" OR geoRegionDetails.geoRegionType=\"GEO_REGION_TYPE_STATE\"` * All `CARRIER AND ISP` targeting options that belong to sub type `CARRIER_AND_ISP_TYPE_CARRIER`: `carrierAndIspDetails.type=\"CARRIER_AND_ISP_TYPE_CARRIER\"`. The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by targeting option fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `OR` logical operators. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `carrierAndIspDetails.type` * `geoRegionDetails.geoRegionType` * `targetingOptionId` Examples: * All `GEO REGION` targeting options that belong to sub type `GEO_REGION_TYPE_COUNTRY` or `GEO_REGION_TYPE_STATE`: `geoRegionDetails.geoRegionType=\"GEO_REGION_TYPE_COUNTRY\" OR geoRegionDetails.geoRegionType=\"GEO_REGION_TYPE_STATE\"` * All `CARRIER AND ISP` targeting options that belong to sub type `CARRIER_AND_ISP_TYPE_CARRIER`: `carrierAndIspDetails.type=\"CARRIER_AND_ISP_TYPE_CARRIER\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -49391,7 +49564,7 @@ func (c *TargetingTypesTargetingOptionsListCall) Do(opts ...googleapi.CallOption // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -49656,7 +49829,7 @@ func (c *TargetingTypesTargetingOptionsSearchCall) Do(opts ...googleapi.CallOpti // "Target ads to a specific content category (for example, arts \u0026 entertainment).", // "Purchase impressions from specific deals and auction packages.", // "Target ads to a specific language (for example, English or Japanese).", - // "Target ads to ads.txt authorized sellers.", + // "Target ads to ads.txt authorized sellers. If no targeting option of this type is assigned, the resource uses the \"Authorized Direct Sellers and Resellers\" option by default.", // "Target ads to a specific regional location (for example, a city or state).", // "Purchase impressions from a group of deals and auction packages.", // "Purchase impressions from specific exchanges.", @@ -49729,7 +49902,12 @@ type UsersBulkEditAssignedUserRolesCall struct { // operation will delete the assigned user roles provided in // BulkEditAssignedUserRolesRequest.deletedAssignedUserRoles and then // assign the user roles provided in -// BulkEditAssignedUserRolesRequest.createdAssignedUserRoles. +// BulkEditAssignedUserRolesRequest.createdAssignedUserRoles. This +// method has unique authentication requirements. Read the prerequisites +// in our Managing Users guide +// (/display-video/api/guides/users/overview#prerequisites) before using +// this method. The "Try this method" feature does not work for this +// method. // // - userId: The ID of the user to which the assigned user roles belong. func (r *UsersService) BulkEditAssignedUserRoles(userId int64, bulkeditassigneduserrolesrequest *BulkEditAssignedUserRolesRequest) *UsersBulkEditAssignedUserRolesCall { @@ -49831,7 +50009,7 @@ func (c *UsersBulkEditAssignedUserRolesCall) Do(opts ...googleapi.CallOption) (* } return ret, nil // { - // "description": "Bulk edits user roles for a user. The operation will delete the assigned user roles provided in BulkEditAssignedUserRolesRequest.deletedAssignedUserRoles and then assign the user roles provided in BulkEditAssignedUserRolesRequest.createdAssignedUserRoles.", + // "description": "Bulk edits user roles for a user. The operation will delete the assigned user roles provided in BulkEditAssignedUserRolesRequest.deletedAssignedUserRoles and then assign the user roles provided in BulkEditAssignedUserRolesRequest.createdAssignedUserRoles. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", // "flatPath": "v2/users/{usersId}:bulkEditAssignedUserRoles", // "httpMethod": "POST", // "id": "displayvideo.users.bulkEditAssignedUserRoles", @@ -49873,7 +50051,11 @@ type UsersCreateCall struct { } // Create: Creates a new user. Returns the newly created user if -// successful. +// successful. This method has unique authentication requirements. Read +// the prerequisites in our Managing Users guide +// (/display-video/api/guides/users/overview#prerequisites) before using +// this method. The "Try this method" feature does not work for this +// method. func (r *UsersService) Create(user *User) *UsersCreateCall { c := &UsersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.user = user @@ -49968,7 +50150,7 @@ func (c *UsersCreateCall) Do(opts ...googleapi.CallOption) (*User, error) { } return ret, nil // { - // "description": "Creates a new user. Returns the newly created user if successful.", + // "description": "Creates a new user. Returns the newly created user if successful. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", // "flatPath": "v2/users", // "httpMethod": "POST", // "id": "displayvideo.users.create", @@ -49998,7 +50180,11 @@ type UsersDeleteCall struct { header_ http.Header } -// Delete: Deletes a user. +// Delete: Deletes a user. This method has unique authentication +// requirements. Read the prerequisites in our Managing Users guide +// (/display-video/api/guides/users/overview#prerequisites) before using +// this method. The "Try this method" feature does not work for this +// method. // // - userId: The ID of the user to delete. func (r *UsersService) Delete(userId int64) *UsersDeleteCall { @@ -50093,7 +50279,7 @@ func (c *UsersDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { } return ret, nil // { - // "description": "Deletes a user.", + // "description": "Deletes a user. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", // "flatPath": "v2/users/{usersId}", // "httpMethod": "DELETE", // "id": "displayvideo.users.delete", @@ -50132,7 +50318,11 @@ type UsersGetCall struct { header_ http.Header } -// Get: Gets a user. +// Get: Gets a user. This method has unique authentication requirements. +// Read the prerequisites in our Managing Users guide +// (/display-video/api/guides/users/overview#prerequisites) before using +// this method. The "Try this method" feature does not work for this +// method. // // - userId: The ID of the user to fetch. func (r *UsersService) Get(userId int64) *UsersGetCall { @@ -50240,7 +50430,7 @@ func (c *UsersGetCall) Do(opts ...googleapi.CallOption) (*User, error) { } return ret, nil // { - // "description": "Gets a user.", + // "description": "Gets a user. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", // "flatPath": "v2/users/{usersId}", // "httpMethod": "GET", // "id": "displayvideo.users.get", @@ -50280,37 +50470,44 @@ type UsersListCall struct { // List: Lists users that are accessible to the current user. If two // users have user roles on the same partner or advertiser, they can -// access each other. +// access each other. This method has unique authentication +// requirements. Read the prerequisites in our Managing Users guide +// (/display-video/api/guides/users/overview#prerequisites) before using +// this method. The "Try this method" feature does not work for this +// method. func (r *UsersService) List() *UsersListCall { c := &UsersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c } // Filter sets the optional parameter "filter": Allows filtering by user -// properties. Supported syntax: * Filter expressions are made up of one -// or more restrictions. * Restrictions can be combined by the logical +// fields. Supported syntax: * Filter expressions are made up of one or +// more restrictions. * Restrictions can be combined by the logical // operator `AND`. * A restriction has the form of `{field} {operator} -// {value}`. * The operator must be `CONTAINS (:)` or `EQUALS (=)`. * -// The operator must be `CONTAINS (:)` for the following fields: - -// `displayName` - `email` * The operator must be `EQUALS (=)` for the -// following fields: - `assignedUserRole.userRole` - -// `assignedUserRole.partnerId` - `assignedUserRole.advertiserId` - -// `assignedUserRole.entityType`: A synthetic field of AssignedUserRole -// used for filtering. Identifies the type of entity to which the user -// role is assigned. Valid values are `Partner` and `Advertiser`. - -// `assignedUserRole.parentPartnerId`: A synthetic field of -// AssignedUserRole used for filtering. Identifies the parent partner of -// the entity to which the user role is assigned." Examples: * The user -// with displayName containing `foo`: `displayName:"foo" * The user -// with email containing `bar`: `email:"bar" * All users with standard -// user roles: `assignedUserRole.userRole="STANDARD" * All users with -// user roles for partner 123: `assignedUserRole.partnerId="123" * All -// users with user roles for advertiser 123: -// `assignedUserRole.advertiserId="123" * All users with partner level -// user roles: `entityType="PARTNER" * All users with user roles for -// partner 123 and advertisers under partner 123: -// `parentPartnerId="123" The length of this field should be no more -// than 500 characters. +// {value}`. * The `budget.budget_segments.date_range.end_date` field +// must use the `LESS THAN (<)` operator. * The `displayName and `email` +// field must use the `HAS (:)` operator. * All other fields must use +// the `EQUALS (=)` operator. Supported fields: * +// `assignedUserRole.advertiserId` * `assignedUserRole.entityType` * +// This is synthetic field of `AssignedUserRole` used for filtering. +// Identifies the type of entity to which the user role is assigned. +// Valid values are `Partner` and `Advertiser`. * +// `assignedUserRole.parentPartnerId` * This is a synthetic field of +// `AssignedUserRole` used for filtering. Identifies the parent partner +// of the entity to which the user role is assigned. * +// `assignedUserRole.partnerId` * `assignedUserRole.userRole` * +// `displayName` * `email` Examples: * The user with `displayName` +// containing "foo": `displayName:"foo" * The user with `email` +// containing "bar": `email:"bar" * All users with standard user roles: +// `assignedUserRole.userRole="STANDARD" * All users with user roles +// for partner 123: `assignedUserRole.partnerId="123" * All users with +// user roles for advertiser 123: `assignedUserRole.advertiserId="123" +// * All users with partner level user roles: `entityType="PARTNER" * +// All users with user roles for partner 123 and advertisers under +// partner 123: `parentPartnerId="123" The length of this field should +// be no more than 500 characters. Reference our filter `LIST` requests +// (/display-video/api/guides/how-tos/filters) guide for more +// information. func (c *UsersListCall) Filter(filter string) *UsersListCall { c.urlParams_.Set("filter", filter) return c @@ -50439,14 +50636,14 @@ func (c *UsersListCall) Do(opts ...googleapi.CallOption) (*ListUsersResponse, er } return ret, nil // { - // "description": "Lists users that are accessible to the current user. If two users have user roles on the same partner or advertiser, they can access each other.", + // "description": "Lists users that are accessible to the current user. If two users have user roles on the same partner or advertiser, they can access each other. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", // "flatPath": "v2/users", // "httpMethod": "GET", // "id": "displayvideo.users.list", // "parameterOrder": [], // "parameters": { // "filter": { - // "description": "Allows filtering by user properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `CONTAINS (:)` or `EQUALS (=)`. * The operator must be `CONTAINS (:)` for the following fields: - `displayName` - `email` * The operator must be `EQUALS (=)` for the following fields: - `assignedUserRole.userRole` - `assignedUserRole.partnerId` - `assignedUserRole.advertiserId` - `assignedUserRole.entityType`: A synthetic field of AssignedUserRole used for filtering. Identifies the type of entity to which the user role is assigned. Valid values are `Partner` and `Advertiser`. - `assignedUserRole.parentPartnerId`: A synthetic field of AssignedUserRole used for filtering. Identifies the parent partner of the entity to which the user role is assigned.\" Examples: * The user with displayName containing `foo`: `displayName:\"foo\"` * The user with email containing `bar`: `email:\"bar\"` * All users with standard user roles: `assignedUserRole.userRole=\"STANDARD\"` * All users with user roles for partner 123: `assignedUserRole.partnerId=\"123\"` * All users with user roles for advertiser 123: `assignedUserRole.advertiserId=\"123\"` * All users with partner level user roles: `entityType=\"PARTNER\"` * All users with user roles for partner 123 and advertisers under partner 123: `parentPartnerId=\"123\"` The length of this field should be no more than 500 characters.", + // "description": "Allows filtering by user fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `budget.budget_segments.date_range.end_date` field must use the `LESS THAN (\u003c)` operator. * The `displayName and `email` field must use the `HAS (:)` operator. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `assignedUserRole.advertiserId` * `assignedUserRole.entityType` * This is synthetic field of `AssignedUserRole` used for filtering. Identifies the type of entity to which the user role is assigned. Valid values are `Partner` and `Advertiser`. * `assignedUserRole.parentPartnerId` * This is a synthetic field of `AssignedUserRole` used for filtering. Identifies the parent partner of the entity to which the user role is assigned. * `assignedUserRole.partnerId` * `assignedUserRole.userRole` * `displayName` * `email` Examples: * The user with `displayName` containing \"foo\": `displayName:\"foo\"` * The user with `email` containing \"bar\": `email:\"bar\"` * All users with standard user roles: `assignedUserRole.userRole=\"STANDARD\"` * All users with user roles for partner 123: `assignedUserRole.partnerId=\"123\"` * All users with user roles for advertiser 123: `assignedUserRole.advertiserId=\"123\"` * All users with partner level user roles: `entityType=\"PARTNER\"` * All users with user roles for partner 123 and advertisers under partner 123: `parentPartnerId=\"123\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.", // "location": "query", // "type": "string" // }, @@ -50511,7 +50708,11 @@ type UsersPatchCall struct { } // Patch: Updates an existing user. Returns the updated user if -// successful. +// successful. This method has unique authentication requirements. Read +// the prerequisites in our Managing Users guide +// (/display-video/api/guides/users/overview#prerequisites) before using +// this method. The "Try this method" feature does not work for this +// method. // // - userId: Output only. The unique ID of the user. Assigned by the // system. @@ -50620,7 +50821,7 @@ func (c *UsersPatchCall) Do(opts ...googleapi.CallOption) (*User, error) { } return ret, nil // { - // "description": "Updates an existing user. Returns the updated user if successful.", + // "description": "Updates an existing user. Returns the updated user if successful. This method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method. The \"Try this method\" feature does not work for this method.", // "flatPath": "v2/users/{usersId}", // "httpMethod": "PATCH", // "id": "displayvideo.users.patch", diff --git a/dlp/v2/dlp-api.json b/dlp/v2/dlp-api.json index ee1164036d1..9e84a6c9e9f 100644 --- a/dlp/v2/dlp-api.json +++ b/dlp/v2/dlp-api.json @@ -3412,7 +3412,7 @@ } } }, - "revision": "20230402", + "revision": "20230428", "rootUrl": "https://dlp.googleapis.com/", "schemas": { "GooglePrivacyDlpV2Action": { @@ -4413,6 +4413,10 @@ "$ref": "GooglePrivacyDlpV2Regex", "description": "Regular expression based CustomInfoType." }, + "sensitivityScore": { + "$ref": "GooglePrivacyDlpV2SensitivityScore", + "description": "Sensitivity for this CustomInfoType. If this CustomInfoType extends an existing InfoType, the sensitivity here will take precedent over that of the original InfoType. If unset for a CustomInfoType, it will default to HIGH. This only applies to data profiling." + }, "storedType": { "$ref": "GooglePrivacyDlpV2StoredType", "description": "Load an existing `StoredInfoType` resource for use in `InspectDataSource`. Not currently supported in `InspectContent`." @@ -5605,6 +5609,10 @@ "description": "Name of the information type. Either a name of your choosing when creating a CustomInfoType, or one of the names listed at https://cloud.google.com/dlp/docs/infotypes-reference when specifying a built-in type. When sending Cloud DLP results to Data Catalog, infoType names should conform to the pattern `[A-Za-z0-9$_-]{1,64}`.", "type": "string" }, + "sensitivityScore": { + "$ref": "GooglePrivacyDlpV2SensitivityScore", + "description": "Optional custom sensitivity for this InfoType. This only applies to data profiling." + }, "version": { "description": "Optional version name for this InfoType.", "type": "string" diff --git a/dlp/v2/dlp-gen.go b/dlp/v2/dlp-gen.go index 8bb47a2b756..fcf98e687eb 100644 --- a/dlp/v2/dlp-gen.go +++ b/dlp/v2/dlp-gen.go @@ -2258,6 +2258,13 @@ type GooglePrivacyDlpV2CustomInfoType struct { // Regex: Regular expression based CustomInfoType. Regex *GooglePrivacyDlpV2Regex `json:"regex,omitempty"` + // SensitivityScore: Sensitivity for this CustomInfoType. If this + // CustomInfoType extends an existing InfoType, the sensitivity here + // will take precedent over that of the original InfoType. If unset for + // a CustomInfoType, it will default to HIGH. This only applies to data + // profiling. + SensitivityScore *GooglePrivacyDlpV2SensitivityScore `json:"sensitivityScore,omitempty"` + // StoredType: Load an existing `StoredInfoType` resource for use in // `InspectDataSource`. Not currently supported in `InspectContent`. StoredType *GooglePrivacyDlpV2StoredType `json:"storedType,omitempty"` @@ -4546,6 +4553,10 @@ type GooglePrivacyDlpV2InfoType struct { // infoType names should conform to the pattern `[A-Za-z0-9$_-]{1,64}`. Name string `json:"name,omitempty"` + // SensitivityScore: Optional custom sensitivity for this InfoType. This + // only applies to data profiling. + SensitivityScore *GooglePrivacyDlpV2SensitivityScore `json:"sensitivityScore,omitempty"` + // Version: Optional version name for this InfoType. Version string `json:"version,omitempty"` diff --git a/documentai/v1/documentai-api.json b/documentai/v1/documentai-api.json index fb77cb971a4..99cc0894f64 100644 --- a/documentai/v1/documentai-api.json +++ b/documentai/v1/documentai-api.json @@ -148,7 +148,7 @@ ], "parameters": { "parent": { - "description": "Required. The project of processor type to list. The available processor types may depend on the allow-listing on projects. Format: `projects/{project}/locations/{location}`", + "description": "Required. The location of processor types to list. Format: `projects/{project}/locations/{location}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -363,7 +363,7 @@ ], "parameters": { "pageSize": { - "description": "The maximum number of processor types to return. If unspecified, at most 100 processor types will be returned. The maximum value is 500; values above 500 will be coerced to 500.", + "description": "The maximum number of processor types to return. If unspecified, at most `100` processor types will be returned. The maximum value is `500`. Values above `500` will be coerced to `500`.", "format": "int32", "location": "query", "type": "integer" @@ -374,7 +374,7 @@ "type": "string" }, "parent": { - "description": "Required. The location of processor type to list. The available processor types may depend on the allow-listing on projects. Format: `projects/{project}/locations/{location}`", + "description": "Required. The location of processor types to list. Format: `projects/{project}/locations/{location}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -422,7 +422,7 @@ ] }, "create": { - "description": "Creates a processor from the type processor that the user chose. The processor will be at \"ENABLED\" state by default after its creation.", + "description": "Creates a processor from the ProcessorType provided. The processor will be at `ENABLED` state by default after its creation.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processors", "httpMethod": "POST", "id": "documentai.projects.locations.processors.create", @@ -565,7 +565,7 @@ ], "parameters": { "pageSize": { - "description": "The maximum number of processors to return. If unspecified, at most 50 processors will be returned. The maximum value is 100; values above 100 will be coerced to 100.", + "description": "The maximum number of processors to return. If unspecified, at most `50` processors will be returned. The maximum value is `100`. Values above `100` will be coerced to `100`.", "format": "int32", "location": "query", "type": "integer" @@ -827,7 +827,7 @@ ], "parameters": { "pageSize": { - "description": "The maximum number of processor versions to return. If unspecified, at most 10 processor versions will be returned. The maximum value is 20; values above 20 will be coerced to 20.", + "description": "The maximum number of processor versions to return. If unspecified, at most `10` processor versions will be returned. The maximum value is `20`. Values above `20` will be coerced to `20`.", "format": "int32", "location": "query", "type": "integer" @@ -882,7 +882,7 @@ ] }, "train": { - "description": "Trains a new processor version. Operation metadata is returned as cloud_documentai_core.TrainProcessorVersionMetadata.", + "description": "Trains a new processor version. Operation metadata is returned as TrainProcessorVersionMetadata.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processors/{processorsId}/processorVersions:train", "httpMethod": "POST", "id": "documentai.projects.locations.processors.processorVersions.train", @@ -976,7 +976,7 @@ ], "parameters": { "pageSize": { - "description": "The standard list page size. If unspecified, at most `5` evaluations will be returned. The maximum value is `100`; values above `100` will be coerced to `100`.", + "description": "The standard list page size. If unspecified, at most `5` evaluations are returned. The maximum value is `100`. Values above `100` are coerced to `100`.", "format": "int32", "location": "query", "type": "integer" @@ -1042,7 +1042,7 @@ } } }, - "revision": "20230420", + "revision": "20230504", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -1253,7 +1253,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata": { - "description": "The long-running operation metadata for CreateLabelerPool.", + "description": "The long-running operation metadata for the CreateLabelerPool method.", "id": "GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata", "properties": { "commonMetadata": { @@ -1275,7 +1275,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata": { - "description": "The long-running operation metadata for delete processor method.", + "description": "The long-running operation metadata for the DeleteProcessor method.", "id": "GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata", "properties": { "commonMetadata": { @@ -1286,7 +1286,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DeleteProcessorVersionMetadata": { - "description": "The long-running operation metadata for delete processor version method.", + "description": "The long-running operation metadata for the DeleteProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3DeleteProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -1297,7 +1297,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for deploy processor version method.", + "description": "The long-running operation metadata for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -1308,13 +1308,13 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionResponse": { - "description": "Response message for the deploy processor version method.", + "description": "Response message for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionResponse", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata": { - "description": "The long-running operation metadata for disable processor method.", + "description": "The long-running operation metadata for the DisableProcessor method.", "id": "GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata", "properties": { "commonMetadata": { @@ -1325,7 +1325,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse": { - "description": "Response message for the disable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the DisableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse", "properties": {}, "type": "object" @@ -1360,7 +1360,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata": { - "description": "The long-running operation metadata for enable processor method.", + "description": "The long-running operation metadata for the EnableProcessor method.", "id": "GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata", "properties": { "commonMetadata": { @@ -1371,7 +1371,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3EnableProcessorResponse": { - "description": "Response message for the enable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the EnableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiUiv1beta3EnableProcessorResponse", "properties": {}, "type": "object" @@ -1706,8 +1706,43 @@ }, "type": "object" }, + "GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata": { + "description": "Metadata of the sample documents operation.", + "id": "GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata", + "properties": { + "commonMetadata": { + "$ref": "GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata", + "description": "The basic metadata of the long running operation." + } + }, + "type": "object" + }, + "GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse": { + "description": "Response of the sample documents operation.", + "id": "GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse", + "properties": { + "selectedDocuments": { + "description": "The result of the sampling process.", + "items": { + "$ref": "GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument": { + "id": "GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument", + "properties": { + "documentId": { + "description": "An internal identifier for document.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionMetadata": { - "description": "The long-running operation metadata for set default processor version method.", + "description": "The long-running operation metadata for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -1718,7 +1753,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionResponse": { - "description": "Response message for set default processor version method.", + "description": "Response message for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionResponse", "properties": {}, "type": "object" @@ -1785,7 +1820,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for the undeploy processor version method.", + "description": "The long-running operation metadata for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -1796,7 +1831,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionResponse": { - "description": "Response message for the undeploy processor version method.", + "description": "Response message for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionResponse", "properties": {}, "type": "object" @@ -1926,11 +1961,11 @@ "description": "The status of human review on the processed document." }, "inputGcsSource": { - "description": "The source of the document, same as the [input_gcs_source] field in the request when the batch process started. The batch process is started by take snapshot of that document, since a user can move or change that document during the process.", + "description": "The source of the document, same as the input_gcs_source field in the request when the batch process started.", "type": "string" }, "outputGcsDestination": { - "description": "The output_gcs_destination (in the request as `output_gcs_destination`) of the processed document if it was successful, otherwise empty.", + "description": "The Cloud Storage output destination (in the request as DocumentOutputConfig.GcsOutputConfig.gcs_uri) of the processed document if it was successful, otherwise empty.", "type": "string" }, "status": { @@ -1946,11 +1981,11 @@ "properties": { "documentOutputConfig": { "$ref": "GoogleCloudDocumentaiV1DocumentOutputConfig", - "description": "The overall output config for batch process." + "description": "The output configuration for the BatchProcessDocuments method." }, "inputDocuments": { "$ref": "GoogleCloudDocumentaiV1BatchDocumentsInputConfig", - "description": "The input documents for batch process." + "description": "The input documents for the BatchProcessDocuments method." }, "skipHumanReview": { "description": "Whether Human Review feature should be skipped for this request. Default to false.", @@ -2032,7 +2067,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1DeleteProcessorMetadata": { - "description": "The long-running operation metadata for delete processor method.", + "description": "The long-running operation metadata for the DeleteProcessor method.", "id": "GoogleCloudDocumentaiV1DeleteProcessorMetadata", "properties": { "commonMetadata": { @@ -2043,7 +2078,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1DeleteProcessorVersionMetadata": { - "description": "The long-running operation metadata for delete processor version method.", + "description": "The long-running operation metadata for the DeleteProcessorVersion method.", "id": "GoogleCloudDocumentaiV1DeleteProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -2054,7 +2089,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1DeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for deploy processor version method.", + "description": "The long-running operation metadata for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1DeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -2065,19 +2100,19 @@ "type": "object" }, "GoogleCloudDocumentaiV1DeployProcessorVersionRequest": { - "description": "Request message for the deploy processor version method.", + "description": "Request message for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1DeployProcessorVersionRequest", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1DeployProcessorVersionResponse": { - "description": "Response message for the deploy processor version method.", + "description": "Response message for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1DeployProcessorVersionResponse", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1DisableProcessorMetadata": { - "description": "The long-running operation metadata for disable processor method.", + "description": "The long-running operation metadata for the DisableProcessor method.", "id": "GoogleCloudDocumentaiV1DisableProcessorMetadata", "properties": { "commonMetadata": { @@ -2088,13 +2123,13 @@ "type": "object" }, "GoogleCloudDocumentaiV1DisableProcessorRequest": { - "description": "Request message for the disable processor method.", + "description": "Request message for the DisableProcessor method.", "id": "GoogleCloudDocumentaiV1DisableProcessorRequest", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1DisableProcessorResponse": { - "description": "Response message for the disable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the DisableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiV1DisableProcessorResponse", "properties": {}, "type": "object" @@ -2167,7 +2202,7 @@ "type": "array" }, "uri": { - "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. See [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris) for more info.", + "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. For more information, refer to [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris).", "type": "string" } }, @@ -2955,11 +2990,11 @@ "description": "Color of the background." }, "bold": { - "description": "Whether the text is bold (equivalent to font weight \u003e= 700).", + "description": "Whether the text is bold (equivalent to font_weight is at least `700`).", "type": "boolean" }, "fontSize": { - "description": "Font size in points (1 point is 1/72\").", + "description": "Font size in points (`1` point is `¹⁄₇₂` inches).", "format": "int32", "type": "integer" }, @@ -2968,7 +3003,7 @@ "type": "string" }, "fontWeight": { - "description": "TrueType weight on a scale 100 (Thin) to 1000 (Ultra-heavy). Normal is 400, Bold is 700.", + "description": "TrueType weight on a scale `100` (thin) to `1000` (ultra-heavy). Normal is `400`, bold is `700`.", "format": "int32", "type": "integer" }, @@ -2986,12 +3021,12 @@ "type": "number" }, "pixelFontSize": { - "description": "Font size in pixels, equal to unrounded_fontsize * resolution / 72.0.", + "description": "Font size in pixels, equal to _unrounded font_size_ * _resolution_ ÷ `72.0`.", "format": "double", "type": "number" }, "smallcaps": { - "description": "Whether the text are small caps.", + "description": "Whether the text is in small caps.", "type": "boolean" }, "strikeout": { @@ -3431,7 +3466,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1EnableProcessorMetadata": { - "description": "The long-running operation metadata for enable processor method.", + "description": "The long-running operation metadata for the EnableProcessor method.", "id": "GoogleCloudDocumentaiV1EnableProcessorMetadata", "properties": { "commonMetadata": { @@ -3442,13 +3477,13 @@ "type": "object" }, "GoogleCloudDocumentaiV1EnableProcessorRequest": { - "description": "Request message for the enable processor method.", + "description": "Request message for the EnableProcessor method.", "id": "GoogleCloudDocumentaiV1EnableProcessorRequest", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1EnableProcessorResponse": { - "description": "Response message for the enable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the EnableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiV1EnableProcessorResponse", "properties": {}, "type": "object" @@ -3707,7 +3742,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1FetchProcessorTypesResponse": { - "description": "Response message for fetch processor types.", + "description": "Response message for the FetchProcessorTypes method.", "id": "GoogleCloudDocumentaiV1FetchProcessorTypesResponse", "properties": { "processorTypes": { @@ -3812,7 +3847,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1ListProcessorTypesResponse": { - "description": "Response message for list processor types.", + "description": "Response message for the ListProcessorTypes method.", "id": "GoogleCloudDocumentaiV1ListProcessorTypesResponse", "properties": { "nextPageToken": { @@ -3830,7 +3865,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1ListProcessorVersionsResponse": { - "description": "Response message for list processors.", + "description": "Response message for the ListProcessorVersions method.", "id": "GoogleCloudDocumentaiV1ListProcessorVersionsResponse", "properties": { "nextPageToken": { @@ -3848,7 +3883,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1ListProcessorsResponse": { - "description": "Response message for list processors.", + "description": "Response message for the ListProcessors method.", "id": "GoogleCloudDocumentaiV1ListProcessorsResponse", "properties": { "nextPageToken": { @@ -3883,11 +3918,11 @@ "type": "object" }, "GoogleCloudDocumentaiV1ProcessRequest": { - "description": "Request message for the process document method.", + "description": "Request message for the ProcessDocument method.", "id": "GoogleCloudDocumentaiV1ProcessRequest", "properties": { "fieldMask": { - "description": "Specifies which fields to include in the `ProcessResponse` Document. Only supports top level document and pages field so it must be in the form of `{document_field_name}` or `pages.{page_field_name}`.", + "description": "Specifies which fields to include in the ProcessResponse.document output. Only supports top-level document and pages field, so it must be in the form of `{document_field_name}` or `pages.{page_field_name}`.", "format": "google-fieldmask", "type": "string" }, @@ -3907,7 +3942,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1ProcessResponse": { - "description": "Response message for the process document method.", + "description": "Response message for the ProcessDocument method.", "id": "GoogleCloudDocumentaiV1ProcessResponse", "properties": { "document": { @@ -4159,7 +4194,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata": { - "description": "The long-running operation metadata for review document method.", + "description": "The long-running operation metadata for the ReviewDocument method.", "id": "GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata", "properties": { "commonMetadata": { @@ -4174,7 +4209,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1ReviewDocumentRequest": { - "description": "Request message for review document method.", + "description": "Request message for the ReviewDocument method.", "id": "GoogleCloudDocumentaiV1ReviewDocumentRequest", "properties": { "documentSchema": { @@ -4205,7 +4240,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1ReviewDocumentResponse": { - "description": "Response message for review document method.", + "description": "Response message for the ReviewDocument method.", "id": "GoogleCloudDocumentaiV1ReviewDocumentResponse", "properties": { "gcsDestination": { @@ -4234,7 +4269,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1SetDefaultProcessorVersionMetadata": { - "description": "The long-running operation metadata for set default processor version method.", + "description": "The long-running operation metadata for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiV1SetDefaultProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -4245,7 +4280,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1SetDefaultProcessorVersionRequest": { - "description": "Request message for the set default processor version method.", + "description": "Request message for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiV1SetDefaultProcessorVersionRequest", "properties": { "defaultProcessorVersion": { @@ -4256,7 +4291,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1SetDefaultProcessorVersionResponse": { - "description": "Response message for set default processor version method.", + "description": "Response message for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiV1SetDefaultProcessorVersionResponse", "properties": {}, "type": "object" @@ -4312,7 +4347,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1TrainProcessorVersionRequest": { - "description": "Request message for the create processor version method.", + "description": "Request message for the TrainProcessorVersion method.", "id": "GoogleCloudDocumentaiV1TrainProcessorVersionRequest", "properties": { "baseProcessorVersion": { @@ -4325,7 +4360,7 @@ }, "inputData": { "$ref": "GoogleCloudDocumentaiV1TrainProcessorVersionRequestInputData", - "description": "Optional. The input data used to train the `ProcessorVersion`." + "description": "Optional. The input data used to train the ProcessorVersion." }, "processorVersion": { "$ref": "GoogleCloudDocumentaiV1ProcessorVersion", @@ -4335,7 +4370,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1TrainProcessorVersionRequestInputData": { - "description": "The input data used to train a new `ProcessorVersion`.", + "description": "The input data used to train a new ProcessorVersion.", "id": "GoogleCloudDocumentaiV1TrainProcessorVersionRequestInputData", "properties": { "testDocuments": { @@ -4361,7 +4396,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1UndeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for the undeploy processor version method.", + "description": "The long-running operation metadata for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1UndeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -4372,13 +4407,13 @@ "type": "object" }, "GoogleCloudDocumentaiV1UndeployProcessorVersionRequest": { - "description": "Request message for the undeploy processor version method.", + "description": "Request message for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1UndeployProcessorVersionRequest", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1UndeployProcessorVersionResponse": { - "description": "Response message for the undeploy processor version method.", + "description": "Response message for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1UndeployProcessorVersionResponse", "properties": {}, "type": "object" @@ -4522,7 +4557,7 @@ "type": "array" }, "uri": { - "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. See [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris) for more info.", + "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. For more information, refer to [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris).", "type": "string" } }, @@ -5262,11 +5297,11 @@ "description": "Color of the background." }, "bold": { - "description": "Whether the text is bold (equivalent to font weight \u003e= 700).", + "description": "Whether the text is bold (equivalent to font_weight is at least `700`).", "type": "boolean" }, "fontSize": { - "description": "Font size in points (1 point is 1/72\").", + "description": "Font size in points (`1` point is `¹⁄₇₂` inches).", "format": "int32", "type": "integer" }, @@ -5275,7 +5310,7 @@ "type": "string" }, "fontWeight": { - "description": "TrueType weight on a scale 100 (Thin) to 1000 (Ultra-heavy). Normal is 400, Bold is 700.", + "description": "TrueType weight on a scale `100` (thin) to `1000` (ultra-heavy). Normal is `400`, bold is `700`.", "format": "int32", "type": "integer" }, @@ -5293,12 +5328,12 @@ "type": "number" }, "pixelFontSize": { - "description": "Font size in pixels, equal to unrounded_fontsize * resolution / 72.0.", + "description": "Font size in pixels, equal to _unrounded font_size_ * _resolution_ ÷ `72.0`.", "format": "double", "type": "number" }, "smallcaps": { - "description": "Whether the text are small caps.", + "description": "Whether the text is in small caps.", "type": "boolean" }, "strikeout": { @@ -5880,7 +5915,7 @@ "type": "array" }, "uri": { - "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. See [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris) for more info.", + "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. For more information, refer to [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris).", "type": "string" } }, @@ -6640,11 +6675,11 @@ "description": "Color of the background." }, "bold": { - "description": "Whether the text is bold (equivalent to font weight \u003e= 700).", + "description": "Whether the text is bold (equivalent to font_weight is at least `700`).", "type": "boolean" }, "fontSize": { - "description": "Font size in points (1 point is 1/72\").", + "description": "Font size in points (`1` point is `¹⁄₇₂` inches).", "format": "int32", "type": "integer" }, @@ -6653,7 +6688,7 @@ "type": "string" }, "fontWeight": { - "description": "TrueType weight on a scale 100 (Thin) to 1000 (Ultra-heavy). Normal is 400, Bold is 700.", + "description": "TrueType weight on a scale `100` (thin) to `1000` (ultra-heavy). Normal is `400`, bold is `700`.", "format": "int32", "type": "integer" }, @@ -6671,12 +6706,12 @@ "type": "number" }, "pixelFontSize": { - "description": "Font size in pixels, equal to unrounded_fontsize * resolution / 72.0.", + "description": "Font size in pixels, equal to _unrounded font_size_ * _resolution_ ÷ `72.0`.", "format": "double", "type": "number" }, "smallcaps": { - "description": "Whether the text are small caps.", + "description": "Whether the text is in small caps.", "type": "boolean" }, "strikeout": { @@ -7189,7 +7224,7 @@ "id": "GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus", "properties": { "humanReviewOperation": { - "description": "The name of the operation triggered by the processed document. If the human review process isn't triggered, this field will be empty. It has the same response type and metadata as the long-running operation returned by ReviewDocument method.", + "description": "The name of the operation triggered by the processed document. If the human review process isn't triggered, this field will be empty. It has the same response type and metadata as the long-running operation returned by the ReviewDocument method.", "type": "string" }, "humanReviewStatus": { @@ -7197,11 +7232,11 @@ "description": "The status of human review on the processed document." }, "inputGcsSource": { - "description": "The source of the document, same as the [input_gcs_source] field in the request when the batch process started. The batch process is started by take snapshot of that document, since a user can move or change that document during the process.", + "description": "The source of the document, same as the input_gcs_source field in the request when the batch process started.", "type": "string" }, "outputGcsDestination": { - "description": "The output_gcs_destination (in the request as `output_gcs_destination`) of the processed document if it was successful, otherwise empty.", + "description": "The Cloud Storage output destination (in the request as DocumentOutputConfig.GcsOutputConfig.gcs_uri) of the processed document if it was successful, otherwise empty.", "type": "string" }, "status": { @@ -7263,7 +7298,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DeleteProcessorMetadata": { - "description": "The long-running operation metadata for delete processor method.", + "description": "The long-running operation metadata for the DeleteProcessor method.", "id": "GoogleCloudDocumentaiV1beta3DeleteProcessorMetadata", "properties": { "commonMetadata": { @@ -7274,7 +7309,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DeleteProcessorVersionMetadata": { - "description": "The long-running operation metadata for delete processor version method.", + "description": "The long-running operation metadata for the DeleteProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3DeleteProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -7285,7 +7320,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for deploy processor version method.", + "description": "The long-running operation metadata for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3DeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -7296,13 +7331,13 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DeployProcessorVersionResponse": { - "description": "Response message for the deploy processor version method.", + "description": "Response message for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3DeployProcessorVersionResponse", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1beta3DisableProcessorMetadata": { - "description": "The long-running operation metadata for disable processor method.", + "description": "The long-running operation metadata for the DisableProcessor method.", "id": "GoogleCloudDocumentaiV1beta3DisableProcessorMetadata", "properties": { "commonMetadata": { @@ -7313,13 +7348,13 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DisableProcessorResponse": { - "description": "Response message for the disable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the DisableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiV1beta3DisableProcessorResponse", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1beta3EnableProcessorMetadata": { - "description": "The long-running operation metadata for enable processor method.", + "description": "The long-running operation metadata for the EnableProcessor method.", "id": "GoogleCloudDocumentaiV1beta3EnableProcessorMetadata", "properties": { "commonMetadata": { @@ -7330,7 +7365,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3EnableProcessorResponse": { - "description": "Response message for the enable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the EnableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiV1beta3EnableProcessorResponse", "properties": {}, "type": "object" @@ -7413,7 +7448,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata": { - "description": "The long-running operation metadata for review document method.", + "description": "The long-running operation metadata for the ReviewDocument method.", "id": "GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata", "properties": { "commonMetadata": { @@ -7462,7 +7497,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3ReviewDocumentResponse": { - "description": "Response message for review document method.", + "description": "Response message for the ReviewDocument method.", "id": "GoogleCloudDocumentaiV1beta3ReviewDocumentResponse", "properties": { "gcsDestination": { @@ -7491,7 +7526,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionMetadata": { - "description": "The long-running operation metadata for set default processor version method.", + "description": "The long-running operation metadata for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -7502,7 +7537,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionResponse": { - "description": "Response message for set default processor version method.", + "description": "Response message for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionResponse", "properties": {}, "type": "object" @@ -7569,7 +7604,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3UndeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for the undeploy processor version method.", + "description": "The long-running operation metadata for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3UndeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -7580,7 +7615,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3UndeployProcessorVersionResponse": { - "description": "Response message for the undeploy processor version method.", + "description": "Response message for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3UndeployProcessorVersionResponse", "properties": {}, "type": "object" diff --git a/documentai/v1/documentai-gen.go b/documentai/v1/documentai-gen.go index 6b7d547934e..92ef6e33940 100644 --- a/documentai/v1/documentai-gen.go +++ b/documentai/v1/documentai-gen.go @@ -549,7 +549,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata) MarshalJSON() ([ } // GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata: The -// long-running operation metadata for CreateLabelerPool. +// long-running operation metadata for the CreateLabelerPool method. type GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -609,7 +609,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata) Marsh } // GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata: The -// long-running operation metadata for delete processor method. +// long-running operation metadata for the DeleteProcessor method. type GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -639,7 +639,8 @@ func (s *GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata) MarshalJSON() ([ } // GoogleCloudDocumentaiUiv1beta3DeleteProcessorVersionMetadata: The -// long-running operation metadata for delete processor version method. +// long-running operation metadata for the DeleteProcessorVersion +// method. type GoogleCloudDocumentaiUiv1beta3DeleteProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -669,7 +670,8 @@ func (s *GoogleCloudDocumentaiUiv1beta3DeleteProcessorVersionMetadata) MarshalJS } // GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionMetadata: The -// long-running operation metadata for deploy processor version method. +// long-running operation metadata for the DeployProcessorVersion +// method. type GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -699,12 +701,12 @@ func (s *GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionMetadata) MarshalJS } // GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionResponse: -// Response message for the deploy processor version method. +// Response message for the DeployProcessorVersion method. type GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionResponse struct { } // GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata: The -// long-running operation metadata for disable processor method. +// long-running operation metadata for the DisableProcessor method. type GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -734,7 +736,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata) MarshalJSON() ( } // GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse: Response -// message for the disable processor method. Intentionally empty proto +// message for the DisableProcessor method. Intentionally empty proto // for adding fields in future. type GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse struct { } @@ -805,7 +807,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId) MarshalJS } // GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata: The -// long-running operation metadata for enable processor method. +// long-running operation metadata for the EnableProcessor method. type GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -835,8 +837,8 @@ func (s *GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata) MarshalJSON() ([ } // GoogleCloudDocumentaiUiv1beta3EnableProcessorResponse: Response -// message for the enable processor method. Intentionally empty proto -// for adding fields in future. +// message for the EnableProcessor method. Intentionally empty proto for +// adding fields in future. type GoogleCloudDocumentaiUiv1beta3EnableProcessorResponse struct { } @@ -1441,8 +1443,95 @@ func (s *GoogleCloudDocumentaiUiv1beta3RevisionRef) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata: Metadata of +// the sample documents operation. +type GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata struct { + // CommonMetadata: The basic metadata of the long running operation. + CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CommonMetadata") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CommonMetadata") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse: Response of +// the sample documents operation. +type GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse struct { + // SelectedDocuments: The result of the sampling process. + SelectedDocuments []*GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument `json:"selectedDocuments,omitempty"` + + // ForceSendFields is a list of field names (e.g. "SelectedDocuments") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "SelectedDocuments") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +type GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument struct { + // DocumentId: An internal identifier for document. + DocumentId string `json:"documentId,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DocumentId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DocumentId") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionMetadata: The -// long-running operation metadata for set default processor version +// long-running operation metadata for the SetDefaultProcessorVersion // method. type GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -1473,7 +1562,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionMetadata) Marsh } // GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionResponse: -// Response message for set default processor version method. +// Response message for the SetDefaultProcessorVersion method. type GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionResponse struct { } @@ -1590,7 +1679,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3TrainProcessorVersionResponse) MarshalJSO } // GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionMetadata: The -// long-running operation metadata for the undeploy processor version +// long-running operation metadata for the UndeployProcessorVersion // method. type GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -1621,7 +1710,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionMetadata) Marshal } // GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionResponse: -// Response message for the undeploy processor version method. +// Response message for the UndeployProcessorVersion method. type GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionResponse struct { } @@ -1858,15 +1947,12 @@ type GoogleCloudDocumentaiV1BatchProcessMetadataIndividualProcessStatus struct { HumanReviewStatus *GoogleCloudDocumentaiV1HumanReviewStatus `json:"humanReviewStatus,omitempty"` // InputGcsSource: The source of the document, same as the - // [input_gcs_source] field in the request when the batch process - // started. The batch process is started by take snapshot of that - // document, since a user can move or change that document during the - // process. + // input_gcs_source field in the request when the batch process started. InputGcsSource string `json:"inputGcsSource,omitempty"` - // OutputGcsDestination: The output_gcs_destination (in the request as - // `output_gcs_destination`) of the processed document if it was - // successful, otherwise empty. + // OutputGcsDestination: The Cloud Storage output destination (in the + // request as DocumentOutputConfig.GcsOutputConfig.gcs_uri) of the + // processed document if it was successful, otherwise empty. OutputGcsDestination string `json:"outputGcsDestination,omitempty"` // Status: The status processing the document. @@ -1899,10 +1985,12 @@ func (s *GoogleCloudDocumentaiV1BatchProcessMetadataIndividualProcessStatus) Mar // GoogleCloudDocumentaiV1BatchProcessRequest: Request message for // BatchProcessDocuments. type GoogleCloudDocumentaiV1BatchProcessRequest struct { - // DocumentOutputConfig: The overall output config for batch process. + // DocumentOutputConfig: The output configuration for the + // BatchProcessDocuments method. DocumentOutputConfig *GoogleCloudDocumentaiV1DocumentOutputConfig `json:"documentOutputConfig,omitempty"` - // InputDocuments: The input documents for batch process. + // InputDocuments: The input documents for the BatchProcessDocuments + // method. InputDocuments *GoogleCloudDocumentaiV1BatchDocumentsInputConfig `json:"inputDocuments,omitempty"` // SkipHumanReview: Whether Human Review feature should be skipped for @@ -2023,7 +2111,7 @@ func (s *GoogleCloudDocumentaiV1CommonOperationMetadata) MarshalJSON() ([]byte, } // GoogleCloudDocumentaiV1DeleteProcessorMetadata: The long-running -// operation metadata for delete processor method. +// operation metadata for the DeleteProcessor method. type GoogleCloudDocumentaiV1DeleteProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -2053,7 +2141,8 @@ func (s *GoogleCloudDocumentaiV1DeleteProcessorMetadata) MarshalJSON() ([]byte, } // GoogleCloudDocumentaiV1DeleteProcessorVersionMetadata: The -// long-running operation metadata for delete processor version method. +// long-running operation metadata for the DeleteProcessorVersion +// method. type GoogleCloudDocumentaiV1DeleteProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -2083,7 +2172,8 @@ func (s *GoogleCloudDocumentaiV1DeleteProcessorVersionMetadata) MarshalJSON() ([ } // GoogleCloudDocumentaiV1DeployProcessorVersionMetadata: The -// long-running operation metadata for deploy processor version method. +// long-running operation metadata for the DeployProcessorVersion +// method. type GoogleCloudDocumentaiV1DeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -2113,17 +2203,17 @@ func (s *GoogleCloudDocumentaiV1DeployProcessorVersionMetadata) MarshalJSON() ([ } // GoogleCloudDocumentaiV1DeployProcessorVersionRequest: Request message -// for the deploy processor version method. +// for the DeployProcessorVersion method. type GoogleCloudDocumentaiV1DeployProcessorVersionRequest struct { } // GoogleCloudDocumentaiV1DeployProcessorVersionResponse: Response -// message for the deploy processor version method. +// message for the DeployProcessorVersion method. type GoogleCloudDocumentaiV1DeployProcessorVersionResponse struct { } // GoogleCloudDocumentaiV1DisableProcessorMetadata: The long-running -// operation metadata for disable processor method. +// operation metadata for the DisableProcessor method. type GoogleCloudDocumentaiV1DisableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -2153,12 +2243,12 @@ func (s *GoogleCloudDocumentaiV1DisableProcessorMetadata) MarshalJSON() ([]byte, } // GoogleCloudDocumentaiV1DisableProcessorRequest: Request message for -// the disable processor method. +// the DisableProcessor method. type GoogleCloudDocumentaiV1DisableProcessorRequest struct { } // GoogleCloudDocumentaiV1DisableProcessorResponse: Response message for -// the disable processor method. Intentionally empty proto for adding +// the DisableProcessor method. Intentionally empty proto for adding // fields in future. type GoogleCloudDocumentaiV1DisableProcessorResponse struct { } @@ -2214,8 +2304,8 @@ type GoogleCloudDocumentaiV1Document struct { // Uri: Optional. Currently supports Google Cloud Storage URI of the // form `gs://bucket_name/object_name`. Object versioning is not - // supported. See Google Cloud Storage Request URIs - // (https://cloud.google.com/storage/docs/reference-uris) for more info. + // supported. For more information, refer to Google Cloud Storage + // Request URIs (https://cloud.google.com/storage/docs/reference-uris). Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -3501,17 +3591,18 @@ type GoogleCloudDocumentaiV1DocumentPageTokenStyleInfo struct { // BackgroundColor: Color of the background. BackgroundColor *GoogleTypeColor `json:"backgroundColor,omitempty"` - // Bold: Whether the text is bold (equivalent to font weight >= 700). + // Bold: Whether the text is bold (equivalent to font_weight is at least + // `700`). Bold bool `json:"bold,omitempty"` - // FontSize: Font size in points (1 point is 1/72"). + // FontSize: Font size in points (`1` point is `¹⁄₇₂` inches). FontSize int64 `json:"fontSize,omitempty"` // FontType: Name or style of the font. FontType string `json:"fontType,omitempty"` - // FontWeight: TrueType weight on a scale 100 (Thin) to 1000 - // (Ultra-heavy). Normal is 400, Bold is 700. + // FontWeight: TrueType weight on a scale `100` (thin) to `1000` + // (ultra-heavy). Normal is `400`, bold is `700`. FontWeight int64 `json:"fontWeight,omitempty"` // Handwritten: Whether the text is handwritten. @@ -3523,11 +3614,11 @@ type GoogleCloudDocumentaiV1DocumentPageTokenStyleInfo struct { // LetterSpacing: Letter spacing in points. LetterSpacing float64 `json:"letterSpacing,omitempty"` - // PixelFontSize: Font size in pixels, equal to unrounded_fontsize * - // resolution / 72.0. + // PixelFontSize: Font size in pixels, equal to _unrounded font_size_ * + // _resolution_ ÷ `72.0`. PixelFontSize float64 `json:"pixelFontSize,omitempty"` - // Smallcaps: Whether the text are small caps. + // Smallcaps: Whether the text is in small caps. Smallcaps bool `json:"smallcaps,omitempty"` // Strikeout: Whether the text is strikethrough. @@ -4276,7 +4367,7 @@ func (s *GoogleCloudDocumentaiV1DocumentTextChange) MarshalJSON() ([]byte, error } // GoogleCloudDocumentaiV1EnableProcessorMetadata: The long-running -// operation metadata for enable processor method. +// operation metadata for the EnableProcessor method. type GoogleCloudDocumentaiV1EnableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -4306,12 +4397,12 @@ func (s *GoogleCloudDocumentaiV1EnableProcessorMetadata) MarshalJSON() ([]byte, } // GoogleCloudDocumentaiV1EnableProcessorRequest: Request message for -// the enable processor method. +// the EnableProcessor method. type GoogleCloudDocumentaiV1EnableProcessorRequest struct { } // GoogleCloudDocumentaiV1EnableProcessorResponse: Response message for -// the enable processor method. Intentionally empty proto for adding +// the EnableProcessor method. Intentionally empty proto for adding // fields in future. type GoogleCloudDocumentaiV1EnableProcessorResponse struct { } @@ -4760,7 +4851,7 @@ func (s *GoogleCloudDocumentaiV1EvaluationReference) MarshalJSON() ([]byte, erro } // GoogleCloudDocumentaiV1FetchProcessorTypesResponse: Response message -// for fetch processor types. +// for the FetchProcessorTypes method. type GoogleCloudDocumentaiV1FetchProcessorTypesResponse struct { // ProcessorTypes: The list of processor types. ProcessorTypes []*GoogleCloudDocumentaiV1ProcessorType `json:"processorTypes,omitempty"` @@ -4976,7 +5067,7 @@ func (s *GoogleCloudDocumentaiV1ListEvaluationsResponse) MarshalJSON() ([]byte, } // GoogleCloudDocumentaiV1ListProcessorTypesResponse: Response message -// for list processor types. +// for the ListProcessorTypes method. type GoogleCloudDocumentaiV1ListProcessorTypesResponse struct { // NextPageToken: Points to the next page, otherwise empty. NextPageToken string `json:"nextPageToken,omitempty"` @@ -5012,7 +5103,7 @@ func (s *GoogleCloudDocumentaiV1ListProcessorTypesResponse) MarshalJSON() ([]byt } // GoogleCloudDocumentaiV1ListProcessorVersionsResponse: Response -// message for list processors. +// message for the ListProcessorVersions method. type GoogleCloudDocumentaiV1ListProcessorVersionsResponse struct { // NextPageToken: Points to the next processor, otherwise empty. NextPageToken string `json:"nextPageToken,omitempty"` @@ -5048,7 +5139,7 @@ func (s *GoogleCloudDocumentaiV1ListProcessorVersionsResponse) MarshalJSON() ([] } // GoogleCloudDocumentaiV1ListProcessorsResponse: Response message for -// list processors. +// the ListProcessors method. type GoogleCloudDocumentaiV1ListProcessorsResponse struct { // NextPageToken: Points to the next processor, otherwise empty. NextPageToken string `json:"nextPageToken,omitempty"` @@ -5133,11 +5224,11 @@ func (s *GoogleCloudDocumentaiV1NormalizedVertex) UnmarshalJSON(data []byte) err } // GoogleCloudDocumentaiV1ProcessRequest: Request message for the -// process document method. +// ProcessDocument method. type GoogleCloudDocumentaiV1ProcessRequest struct { - // FieldMask: Specifies which fields to include in the `ProcessResponse` - // Document. Only supports top level document and pages field so it must - // be in the form of `{document_field_name}` or + // FieldMask: Specifies which fields to include in the + // ProcessResponse.document output. Only supports top-level document and + // pages field, so it must be in the form of `{document_field_name}` or // `pages.{page_field_name}`. FieldMask string `json:"fieldMask,omitempty"` @@ -5175,7 +5266,7 @@ func (s *GoogleCloudDocumentaiV1ProcessRequest) MarshalJSON() ([]byte, error) { } // GoogleCloudDocumentaiV1ProcessResponse: Response message for the -// process document method. +// ProcessDocument method. type GoogleCloudDocumentaiV1ProcessResponse struct { // Document: The document payload, will populate fields based on the // processor's behavior. @@ -5571,7 +5662,7 @@ func (s *GoogleCloudDocumentaiV1RawDocument) MarshalJSON() ([]byte, error) { } // GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata: The -// long-running operation metadata for review document method. +// long-running operation metadata for the ReviewDocument method. type GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -5603,8 +5694,8 @@ func (s *GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata) MarshalJSON() ( return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudDocumentaiV1ReviewDocumentRequest: Request message for -// review document method. +// GoogleCloudDocumentaiV1ReviewDocumentRequest: Request message for the +// ReviewDocument method. type GoogleCloudDocumentaiV1ReviewDocumentRequest struct { // DocumentSchema: The document schema of the human review task. DocumentSchema *GoogleCloudDocumentaiV1DocumentSchema `json:"documentSchema,omitempty"` @@ -5650,7 +5741,7 @@ func (s *GoogleCloudDocumentaiV1ReviewDocumentRequest) MarshalJSON() ([]byte, er } // GoogleCloudDocumentaiV1ReviewDocumentResponse: Response message for -// review document method. +// the ReviewDocument method. type GoogleCloudDocumentaiV1ReviewDocumentResponse struct { // GcsDestination: The Cloud Storage uri for the human reviewed document // if the review is succeeded. @@ -5693,7 +5784,7 @@ func (s *GoogleCloudDocumentaiV1ReviewDocumentResponse) MarshalJSON() ([]byte, e } // GoogleCloudDocumentaiV1SetDefaultProcessorVersionMetadata: The -// long-running operation metadata for set default processor version +// long-running operation metadata for the SetDefaultProcessorVersion // method. type GoogleCloudDocumentaiV1SetDefaultProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -5724,7 +5815,7 @@ func (s *GoogleCloudDocumentaiV1SetDefaultProcessorVersionMetadata) MarshalJSON( } // GoogleCloudDocumentaiV1SetDefaultProcessorVersionRequest: Request -// message for the set default processor version method. +// message for the SetDefaultProcessorVersion method. type GoogleCloudDocumentaiV1SetDefaultProcessorVersionRequest struct { // DefaultProcessorVersion: Required. The resource name of child // ProcessorVersion to use as default. Format: @@ -5758,7 +5849,7 @@ func (s *GoogleCloudDocumentaiV1SetDefaultProcessorVersionRequest) MarshalJSON() } // GoogleCloudDocumentaiV1SetDefaultProcessorVersionResponse: Response -// message for set default processor version method. +// message for the SetDefaultProcessorVersion method. type GoogleCloudDocumentaiV1SetDefaultProcessorVersionResponse struct { } @@ -5846,7 +5937,7 @@ func (s *GoogleCloudDocumentaiV1TrainProcessorVersionMetadataDatasetValidation) } // GoogleCloudDocumentaiV1TrainProcessorVersionRequest: Request message -// for the create processor version method. +// for the TrainProcessorVersion method. type GoogleCloudDocumentaiV1TrainProcessorVersionRequest struct { // BaseProcessorVersion: Optional. The processor version to use as a // base for training. This processor version must be a child of @@ -5860,7 +5951,7 @@ type GoogleCloudDocumentaiV1TrainProcessorVersionRequest struct { DocumentSchema *GoogleCloudDocumentaiV1DocumentSchema `json:"documentSchema,omitempty"` // InputData: Optional. The input data used to train the - // `ProcessorVersion`. + // ProcessorVersion. InputData *GoogleCloudDocumentaiV1TrainProcessorVersionRequestInputData `json:"inputData,omitempty"` // ProcessorVersion: Required. The processor version to be created. @@ -5892,7 +5983,7 @@ func (s *GoogleCloudDocumentaiV1TrainProcessorVersionRequest) MarshalJSON() ([]b } // GoogleCloudDocumentaiV1TrainProcessorVersionRequestInputData: The -// input data used to train a new `ProcessorVersion`. +// input data used to train a new ProcessorVersion. type GoogleCloudDocumentaiV1TrainProcessorVersionRequestInputData struct { // TestDocuments: The documents used for testing the trained version. TestDocuments *GoogleCloudDocumentaiV1BatchDocumentsInputConfig `json:"testDocuments,omitempty"` @@ -5955,7 +6046,7 @@ func (s *GoogleCloudDocumentaiV1TrainProcessorVersionResponse) MarshalJSON() ([] } // GoogleCloudDocumentaiV1UndeployProcessorVersionMetadata: The -// long-running operation metadata for the undeploy processor version +// long-running operation metadata for the UndeployProcessorVersion // method. type GoogleCloudDocumentaiV1UndeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -5986,12 +6077,12 @@ func (s *GoogleCloudDocumentaiV1UndeployProcessorVersionMetadata) MarshalJSON() } // GoogleCloudDocumentaiV1UndeployProcessorVersionRequest: Request -// message for the undeploy processor version method. +// message for the UndeployProcessorVersion method. type GoogleCloudDocumentaiV1UndeployProcessorVersionRequest struct { } // GoogleCloudDocumentaiV1UndeployProcessorVersionResponse: Response -// message for the undeploy processor version method. +// message for the UndeployProcessorVersion method. type GoogleCloudDocumentaiV1UndeployProcessorVersionResponse struct { } @@ -6191,8 +6282,8 @@ type GoogleCloudDocumentaiV1beta1Document struct { // Uri: Optional. Currently supports Google Cloud Storage URI of the // form `gs://bucket_name/object_name`. Object versioning is not - // supported. See Google Cloud Storage Request URIs - // (https://cloud.google.com/storage/docs/reference-uris) for more info. + // supported. For more information, refer to Google Cloud Storage + // Request URIs (https://cloud.google.com/storage/docs/reference-uris). Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -7378,17 +7469,18 @@ type GoogleCloudDocumentaiV1beta1DocumentPageTokenStyleInfo struct { // BackgroundColor: Color of the background. BackgroundColor *GoogleTypeColor `json:"backgroundColor,omitempty"` - // Bold: Whether the text is bold (equivalent to font weight >= 700). + // Bold: Whether the text is bold (equivalent to font_weight is at least + // `700`). Bold bool `json:"bold,omitempty"` - // FontSize: Font size in points (1 point is 1/72"). + // FontSize: Font size in points (`1` point is `¹⁄₇₂` inches). FontSize int64 `json:"fontSize,omitempty"` // FontType: Name or style of the font. FontType string `json:"fontType,omitempty"` - // FontWeight: TrueType weight on a scale 100 (Thin) to 1000 - // (Ultra-heavy). Normal is 400, Bold is 700. + // FontWeight: TrueType weight on a scale `100` (thin) to `1000` + // (ultra-heavy). Normal is `400`, bold is `700`. FontWeight int64 `json:"fontWeight,omitempty"` // Handwritten: Whether the text is handwritten. @@ -7400,11 +7492,11 @@ type GoogleCloudDocumentaiV1beta1DocumentPageTokenStyleInfo struct { // LetterSpacing: Letter spacing in points. LetterSpacing float64 `json:"letterSpacing,omitempty"` - // PixelFontSize: Font size in pixels, equal to unrounded_fontsize * - // resolution / 72.0. + // PixelFontSize: Font size in pixels, equal to _unrounded font_size_ * + // _resolution_ ÷ `72.0`. PixelFontSize float64 `json:"pixelFontSize,omitempty"` - // Smallcaps: Whether the text are small caps. + // Smallcaps: Whether the text is in small caps. Smallcaps bool `json:"smallcaps,omitempty"` // Strikeout: Whether the text is strikethrough. @@ -8401,8 +8493,8 @@ type GoogleCloudDocumentaiV1beta2Document struct { // Uri: Optional. Currently supports Google Cloud Storage URI of the // form `gs://bucket_name/object_name`. Object versioning is not - // supported. See Google Cloud Storage Request URIs - // (https://cloud.google.com/storage/docs/reference-uris) for more info. + // supported. For more information, refer to Google Cloud Storage + // Request URIs (https://cloud.google.com/storage/docs/reference-uris). Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -9643,17 +9735,18 @@ type GoogleCloudDocumentaiV1beta2DocumentPageTokenStyleInfo struct { // BackgroundColor: Color of the background. BackgroundColor *GoogleTypeColor `json:"backgroundColor,omitempty"` - // Bold: Whether the text is bold (equivalent to font weight >= 700). + // Bold: Whether the text is bold (equivalent to font_weight is at least + // `700`). Bold bool `json:"bold,omitempty"` - // FontSize: Font size in points (1 point is 1/72"). + // FontSize: Font size in points (`1` point is `¹⁄₇₂` inches). FontSize int64 `json:"fontSize,omitempty"` // FontType: Name or style of the font. FontType string `json:"fontType,omitempty"` - // FontWeight: TrueType weight on a scale 100 (Thin) to 1000 - // (Ultra-heavy). Normal is 400, Bold is 700. + // FontWeight: TrueType weight on a scale `100` (thin) to `1000` + // (ultra-heavy). Normal is `400`, bold is `700`. FontWeight int64 `json:"fontWeight,omitempty"` // Handwritten: Whether the text is handwritten. @@ -9665,11 +9758,11 @@ type GoogleCloudDocumentaiV1beta2DocumentPageTokenStyleInfo struct { // LetterSpacing: Letter spacing in points. LetterSpacing float64 `json:"letterSpacing,omitempty"` - // PixelFontSize: Font size in pixels, equal to unrounded_fontsize * - // resolution / 72.0. + // PixelFontSize: Font size in pixels, equal to _unrounded font_size_ * + // _resolution_ ÷ `72.0`. PixelFontSize float64 `json:"pixelFontSize,omitempty"` - // Smallcaps: Whether the text are small caps. + // Smallcaps: Whether the text is in small caps. Smallcaps bool `json:"smallcaps,omitempty"` // Strikeout: Whether the text is strikethrough. @@ -10566,7 +10659,7 @@ type GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus str // HumanReviewOperation: The name of the operation triggered by the // processed document. If the human review process isn't triggered, this // field will be empty. It has the same response type and metadata as - // the long-running operation returned by ReviewDocument method. + // the long-running operation returned by the ReviewDocument method. HumanReviewOperation string `json:"humanReviewOperation,omitempty"` // HumanReviewStatus: The status of human review on the processed @@ -10574,15 +10667,12 @@ type GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus str HumanReviewStatus *GoogleCloudDocumentaiV1beta3HumanReviewStatus `json:"humanReviewStatus,omitempty"` // InputGcsSource: The source of the document, same as the - // [input_gcs_source] field in the request when the batch process - // started. The batch process is started by take snapshot of that - // document, since a user can move or change that document during the - // process. + // input_gcs_source field in the request when the batch process started. InputGcsSource string `json:"inputGcsSource,omitempty"` - // OutputGcsDestination: The output_gcs_destination (in the request as - // `output_gcs_destination`) of the processed document if it was - // successful, otherwise empty. + // OutputGcsDestination: The Cloud Storage output destination (in the + // request as DocumentOutputConfig.GcsOutputConfig.gcs_uri) of the + // processed document if it was successful, otherwise empty. OutputGcsDestination string `json:"outputGcsDestination,omitempty"` // Status: The status processing the document. @@ -10669,7 +10759,7 @@ func (s *GoogleCloudDocumentaiV1beta3CommonOperationMetadata) MarshalJSON() ([]b } // GoogleCloudDocumentaiV1beta3DeleteProcessorMetadata: The long-running -// operation metadata for delete processor method. +// operation metadata for the DeleteProcessor method. type GoogleCloudDocumentaiV1beta3DeleteProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -10699,7 +10789,8 @@ func (s *GoogleCloudDocumentaiV1beta3DeleteProcessorMetadata) MarshalJSON() ([]b } // GoogleCloudDocumentaiV1beta3DeleteProcessorVersionMetadata: The -// long-running operation metadata for delete processor version method. +// long-running operation metadata for the DeleteProcessorVersion +// method. type GoogleCloudDocumentaiV1beta3DeleteProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -10729,7 +10820,8 @@ func (s *GoogleCloudDocumentaiV1beta3DeleteProcessorVersionMetadata) MarshalJSON } // GoogleCloudDocumentaiV1beta3DeployProcessorVersionMetadata: The -// long-running operation metadata for deploy processor version method. +// long-running operation metadata for the DeployProcessorVersion +// method. type GoogleCloudDocumentaiV1beta3DeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -10759,12 +10851,12 @@ func (s *GoogleCloudDocumentaiV1beta3DeployProcessorVersionMetadata) MarshalJSON } // GoogleCloudDocumentaiV1beta3DeployProcessorVersionResponse: Response -// message for the deploy processor version method. +// message for the DeployProcessorVersion method. type GoogleCloudDocumentaiV1beta3DeployProcessorVersionResponse struct { } // GoogleCloudDocumentaiV1beta3DisableProcessorMetadata: The -// long-running operation metadata for disable processor method. +// long-running operation metadata for the DisableProcessor method. type GoogleCloudDocumentaiV1beta3DisableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -10794,13 +10886,13 @@ func (s *GoogleCloudDocumentaiV1beta3DisableProcessorMetadata) MarshalJSON() ([] } // GoogleCloudDocumentaiV1beta3DisableProcessorResponse: Response -// message for the disable processor method. Intentionally empty proto +// message for the DisableProcessor method. Intentionally empty proto // for adding fields in future. type GoogleCloudDocumentaiV1beta3DisableProcessorResponse struct { } // GoogleCloudDocumentaiV1beta3EnableProcessorMetadata: The long-running -// operation metadata for enable processor method. +// operation metadata for the EnableProcessor method. type GoogleCloudDocumentaiV1beta3EnableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -10830,7 +10922,7 @@ func (s *GoogleCloudDocumentaiV1beta3EnableProcessorMetadata) MarshalJSON() ([]b } // GoogleCloudDocumentaiV1beta3EnableProcessorResponse: Response message -// for the enable processor method. Intentionally empty proto for adding +// for the EnableProcessor method. Intentionally empty proto for adding // fields in future. type GoogleCloudDocumentaiV1beta3EnableProcessorResponse struct { } @@ -11010,7 +11102,7 @@ func (s *GoogleCloudDocumentaiV1beta3ImportProcessorVersionResponse) MarshalJSON } // GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata: The -// long-running operation metadata for review document method. +// long-running operation metadata for the ReviewDocument method. type GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -11065,7 +11157,7 @@ func (s *GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata) MarshalJSO } // GoogleCloudDocumentaiV1beta3ReviewDocumentResponse: Response message -// for review document method. +// for the ReviewDocument method. type GoogleCloudDocumentaiV1beta3ReviewDocumentResponse struct { // GcsDestination: The Cloud Storage uri for the human reviewed document // if the review is succeeded. @@ -11108,7 +11200,7 @@ func (s *GoogleCloudDocumentaiV1beta3ReviewDocumentResponse) MarshalJSON() ([]by } // GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionMetadata: The -// long-running operation metadata for set default processor version +// long-running operation metadata for the SetDefaultProcessorVersion // method. type GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -11139,7 +11231,7 @@ func (s *GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionMetadata) Marshal } // GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionResponse: -// Response message for set default processor version method. +// Response message for the SetDefaultProcessorVersion method. type GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionResponse struct { } @@ -11256,7 +11348,7 @@ func (s *GoogleCloudDocumentaiV1beta3TrainProcessorVersionResponse) MarshalJSON( } // GoogleCloudDocumentaiV1beta3UndeployProcessorVersionMetadata: The -// long-running operation metadata for the undeploy processor version +// long-running operation metadata for the UndeployProcessorVersion // method. type GoogleCloudDocumentaiV1beta3UndeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -11287,7 +11379,7 @@ func (s *GoogleCloudDocumentaiV1beta3UndeployProcessorVersionMetadata) MarshalJS } // GoogleCloudDocumentaiV1beta3UndeployProcessorVersionResponse: -// Response message for the undeploy processor version method. +// Response message for the UndeployProcessorVersion method. type GoogleCloudDocumentaiV1beta3UndeployProcessorVersionResponse struct { } @@ -12124,9 +12216,8 @@ type ProjectsLocationsFetchProcessorTypesCall struct { // FetchProcessorTypes: Fetches processor types. Note that we don't use // ListProcessorTypes here, because it isn't paginated. // -// - parent: The project of processor type to list. The available -// processor types may depend on the allow-listing on projects. -// Format: `projects/{project}/locations/{location}`. +// - parent: The location of processor types to list. Format: +// `projects/{project}/locations/{location}`. func (r *ProjectsLocationsService) FetchProcessorTypes(parent string) *ProjectsLocationsFetchProcessorTypesCall { c := &ProjectsLocationsFetchProcessorTypesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -12243,7 +12334,7 @@ func (c *ProjectsLocationsFetchProcessorTypesCall) Do(opts ...googleapi.CallOpti // ], // "parameters": { // "parent": { - // "description": "Required. The project of processor type to list. The available processor types may depend on the allow-listing on projects. Format: `projects/{project}/locations/{location}`", + // "description": "Required. The location of processor types to list. Format: `projects/{project}/locations/{location}`.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, @@ -13274,9 +13365,8 @@ type ProjectsLocationsProcessorTypesListCall struct { // List: Lists the processor types that exist. // -// - parent: The location of processor type to list. The available -// processor types may depend on the allow-listing on projects. -// Format: `projects/{project}/locations/{location}`. +// - parent: The location of processor types to list. Format: +// `projects/{project}/locations/{location}`. func (r *ProjectsLocationsProcessorTypesService) List(parent string) *ProjectsLocationsProcessorTypesListCall { c := &ProjectsLocationsProcessorTypesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -13284,9 +13374,9 @@ func (r *ProjectsLocationsProcessorTypesService) List(parent string) *ProjectsLo } // PageSize sets the optional parameter "pageSize": The maximum number -// of processor types to return. If unspecified, at most 100 processor -// types will be returned. The maximum value is 500; values above 500 -// will be coerced to 500. +// of processor types to return. If unspecified, at most `100` processor +// types will be returned. The maximum value is `500`. Values above +// `500` will be coerced to `500`. func (c *ProjectsLocationsProcessorTypesListCall) PageSize(pageSize int64) *ProjectsLocationsProcessorTypesListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c @@ -13409,7 +13499,7 @@ func (c *ProjectsLocationsProcessorTypesListCall) Do(opts ...googleapi.CallOptio // ], // "parameters": { // "pageSize": { - // "description": "The maximum number of processor types to return. If unspecified, at most 100 processor types will be returned. The maximum value is 500; values above 500 will be coerced to 500.", + // "description": "The maximum number of processor types to return. If unspecified, at most `100` processor types will be returned. The maximum value is `500`. Values above `500` will be coerced to `500`.", // "format": "int32", // "location": "query", // "type": "integer" @@ -13420,7 +13510,7 @@ func (c *ProjectsLocationsProcessorTypesListCall) Do(opts ...googleapi.CallOptio // "type": "string" // }, // "parent": { - // "description": "Required. The location of processor type to list. The available processor types may depend on the allow-listing on projects. Format: `projects/{project}/locations/{location}`", + // "description": "Required. The location of processor types to list. Format: `projects/{project}/locations/{location}`.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, @@ -13617,9 +13707,8 @@ type ProjectsLocationsProcessorsCreateCall struct { header_ http.Header } -// Create: Creates a processor from the type processor that the user -// chose. The processor will be at "ENABLED" state by default after its -// creation. +// Create: Creates a processor from the ProcessorType provided. The +// processor will be at `ENABLED` state by default after its creation. // // - parent: The parent (project and location) under which to create the // processor. Format: `projects/{project}/locations/{location}`. @@ -13721,7 +13810,7 @@ func (c *ProjectsLocationsProcessorsCreateCall) Do(opts ...googleapi.CallOption) } return ret, nil // { - // "description": "Creates a processor from the type processor that the user chose. The processor will be at \"ENABLED\" state by default after its creation.", + // "description": "Creates a processor from the ProcessorType provided. The processor will be at `ENABLED` state by default after its creation.", // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processors", // "httpMethod": "POST", // "id": "documentai.projects.locations.processors.create", @@ -14338,9 +14427,9 @@ func (r *ProjectsLocationsProcessorsService) List(parent string) *ProjectsLocati } // PageSize sets the optional parameter "pageSize": The maximum number -// of processors to return. If unspecified, at most 50 processors will -// be returned. The maximum value is 100; values above 100 will be -// coerced to 100. +// of processors to return. If unspecified, at most `50` processors will +// be returned. The maximum value is `100`. Values above `100` will be +// coerced to `100`. func (c *ProjectsLocationsProcessorsListCall) PageSize(pageSize int64) *ProjectsLocationsProcessorsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c @@ -14464,7 +14553,7 @@ func (c *ProjectsLocationsProcessorsListCall) Do(opts ...googleapi.CallOption) ( // ], // "parameters": { // "pageSize": { - // "description": "The maximum number of processors to return. If unspecified, at most 50 processors will be returned. The maximum value is 100; values above 100 will be coerced to 100.", + // "description": "The maximum number of processors to return. If unspecified, at most `50` processors will be returned. The maximum value is `100`. Values above `100` will be coerced to `100`.", // "format": "int32", // "location": "query", // "type": "integer" @@ -15690,9 +15779,9 @@ func (r *ProjectsLocationsProcessorsProcessorVersionsService) List(parent string } // PageSize sets the optional parameter "pageSize": The maximum number -// of processor versions to return. If unspecified, at most 10 processor -// versions will be returned. The maximum value is 20; values above 20 -// will be coerced to 20. +// of processor versions to return. If unspecified, at most `10` +// processor versions will be returned. The maximum value is `20`. +// Values above `20` will be coerced to `20`. func (c *ProjectsLocationsProcessorsProcessorVersionsListCall) PageSize(pageSize int64) *ProjectsLocationsProcessorsProcessorVersionsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c @@ -15816,7 +15905,7 @@ func (c *ProjectsLocationsProcessorsProcessorVersionsListCall) Do(opts ...google // ], // "parameters": { // "pageSize": { - // "description": "The maximum number of processor versions to return. If unspecified, at most 10 processor versions will be returned. The maximum value is 20; values above 20 will be coerced to 20.", + // "description": "The maximum number of processor versions to return. If unspecified, at most `10` processor versions will be returned. The maximum value is `20`. Values above `20` will be coerced to `20`.", // "format": "int32", // "location": "query", // "type": "integer" @@ -16027,7 +16116,7 @@ type ProjectsLocationsProcessorsProcessorVersionsTrainCall struct { } // Train: Trains a new processor version. Operation metadata is returned -// as cloud_documentai_core.TrainProcessorVersionMetadata. +// as TrainProcessorVersionMetadata. // // - parent: The parent (project, location and processor) to create the // new version for. Format: @@ -16130,7 +16219,7 @@ func (c *ProjectsLocationsProcessorsProcessorVersionsTrainCall) Do(opts ...googl } return ret, nil // { - // "description": "Trains a new processor version. Operation metadata is returned as cloud_documentai_core.TrainProcessorVersionMetadata.", + // "description": "Trains a new processor version. Operation metadata is returned as TrainProcessorVersionMetadata.", // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processors/{processorsId}/processorVersions:train", // "httpMethod": "POST", // "id": "documentai.projects.locations.processors.processorVersions.train", @@ -16475,9 +16564,8 @@ func (r *ProjectsLocationsProcessorsProcessorVersionsEvaluationsService) List(pa } // PageSize sets the optional parameter "pageSize": The standard list -// page size. If unspecified, at most `5` evaluations will be returned. -// The maximum value is `100`; values above `100` will be coerced to -// `100`. +// page size. If unspecified, at most `5` evaluations are returned. The +// maximum value is `100`. Values above `100` are coerced to `100`. func (c *ProjectsLocationsProcessorsProcessorVersionsEvaluationsListCall) PageSize(pageSize int64) *ProjectsLocationsProcessorsProcessorVersionsEvaluationsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c @@ -16601,7 +16689,7 @@ func (c *ProjectsLocationsProcessorsProcessorVersionsEvaluationsListCall) Do(opt // ], // "parameters": { // "pageSize": { - // "description": "The standard list page size. If unspecified, at most `5` evaluations will be returned. The maximum value is `100`; values above `100` will be coerced to `100`.", + // "description": "The standard list page size. If unspecified, at most `5` evaluations are returned. The maximum value is `100`. Values above `100` are coerced to `100`.", // "format": "int32", // "location": "query", // "type": "integer" diff --git a/documentai/v1beta2/documentai-api.json b/documentai/v1beta2/documentai-api.json index cd98a105165..afff0bef4dd 100644 --- a/documentai/v1beta2/documentai-api.json +++ b/documentai/v1beta2/documentai-api.json @@ -292,7 +292,7 @@ } } }, - "revision": "20230420", + "revision": "20230504", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -503,7 +503,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata": { - "description": "The long-running operation metadata for CreateLabelerPool.", + "description": "The long-running operation metadata for the CreateLabelerPool method.", "id": "GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata", "properties": { "commonMetadata": { @@ -525,7 +525,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata": { - "description": "The long-running operation metadata for delete processor method.", + "description": "The long-running operation metadata for the DeleteProcessor method.", "id": "GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata", "properties": { "commonMetadata": { @@ -536,7 +536,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DeleteProcessorVersionMetadata": { - "description": "The long-running operation metadata for delete processor version method.", + "description": "The long-running operation metadata for the DeleteProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3DeleteProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -547,7 +547,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for deploy processor version method.", + "description": "The long-running operation metadata for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -558,13 +558,13 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionResponse": { - "description": "Response message for the deploy processor version method.", + "description": "Response message for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionResponse", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata": { - "description": "The long-running operation metadata for disable processor method.", + "description": "The long-running operation metadata for the DisableProcessor method.", "id": "GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata", "properties": { "commonMetadata": { @@ -575,7 +575,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse": { - "description": "Response message for the disable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the DisableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse", "properties": {}, "type": "object" @@ -610,7 +610,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata": { - "description": "The long-running operation metadata for enable processor method.", + "description": "The long-running operation metadata for the EnableProcessor method.", "id": "GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata", "properties": { "commonMetadata": { @@ -621,7 +621,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3EnableProcessorResponse": { - "description": "Response message for the enable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the EnableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiUiv1beta3EnableProcessorResponse", "properties": {}, "type": "object" @@ -956,8 +956,43 @@ }, "type": "object" }, + "GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata": { + "description": "Metadata of the sample documents operation.", + "id": "GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata", + "properties": { + "commonMetadata": { + "$ref": "GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata", + "description": "The basic metadata of the long running operation." + } + }, + "type": "object" + }, + "GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse": { + "description": "Response of the sample documents operation.", + "id": "GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse", + "properties": { + "selectedDocuments": { + "description": "The result of the sampling process.", + "items": { + "$ref": "GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument": { + "id": "GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument", + "properties": { + "documentId": { + "description": "An internal identifier for document.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionMetadata": { - "description": "The long-running operation metadata for set default processor version method.", + "description": "The long-running operation metadata for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -968,7 +1003,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionResponse": { - "description": "Response message for set default processor version method.", + "description": "Response message for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionResponse", "properties": {}, "type": "object" @@ -1035,7 +1070,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for the undeploy processor version method.", + "description": "The long-running operation metadata for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -1046,7 +1081,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionResponse": { - "description": "Response message for the undeploy processor version method.", + "description": "Response message for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionResponse", "properties": {}, "type": "object" @@ -1142,11 +1177,11 @@ "description": "The status of human review on the processed document." }, "inputGcsSource": { - "description": "The source of the document, same as the [input_gcs_source] field in the request when the batch process started. The batch process is started by take snapshot of that document, since a user can move or change that document during the process.", + "description": "The source of the document, same as the input_gcs_source field in the request when the batch process started.", "type": "string" }, "outputGcsDestination": { - "description": "The output_gcs_destination (in the request as `output_gcs_destination`) of the processed document if it was successful, otherwise empty.", + "description": "The Cloud Storage output destination (in the request as DocumentOutputConfig.GcsOutputConfig.gcs_uri) of the processed document if it was successful, otherwise empty.", "type": "string" }, "status": { @@ -1208,7 +1243,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1DeleteProcessorMetadata": { - "description": "The long-running operation metadata for delete processor method.", + "description": "The long-running operation metadata for the DeleteProcessor method.", "id": "GoogleCloudDocumentaiV1DeleteProcessorMetadata", "properties": { "commonMetadata": { @@ -1219,7 +1254,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1DeleteProcessorVersionMetadata": { - "description": "The long-running operation metadata for delete processor version method.", + "description": "The long-running operation metadata for the DeleteProcessorVersion method.", "id": "GoogleCloudDocumentaiV1DeleteProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -1230,7 +1265,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1DeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for deploy processor version method.", + "description": "The long-running operation metadata for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1DeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -1241,13 +1276,13 @@ "type": "object" }, "GoogleCloudDocumentaiV1DeployProcessorVersionResponse": { - "description": "Response message for the deploy processor version method.", + "description": "Response message for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1DeployProcessorVersionResponse", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1DisableProcessorMetadata": { - "description": "The long-running operation metadata for disable processor method.", + "description": "The long-running operation metadata for the DisableProcessor method.", "id": "GoogleCloudDocumentaiV1DisableProcessorMetadata", "properties": { "commonMetadata": { @@ -1258,13 +1293,13 @@ "type": "object" }, "GoogleCloudDocumentaiV1DisableProcessorResponse": { - "description": "Response message for the disable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the DisableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiV1DisableProcessorResponse", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1EnableProcessorMetadata": { - "description": "The long-running operation metadata for enable processor method.", + "description": "The long-running operation metadata for the EnableProcessor method.", "id": "GoogleCloudDocumentaiV1EnableProcessorMetadata", "properties": { "commonMetadata": { @@ -1275,7 +1310,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1EnableProcessorResponse": { - "description": "Response message for the enable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the EnableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiV1EnableProcessorResponse", "properties": {}, "type": "object" @@ -1336,7 +1371,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata": { - "description": "The long-running operation metadata for review document method.", + "description": "The long-running operation metadata for the ReviewDocument method.", "id": "GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata", "properties": { "commonMetadata": { @@ -1351,7 +1386,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1ReviewDocumentResponse": { - "description": "Response message for review document method.", + "description": "Response message for the ReviewDocument method.", "id": "GoogleCloudDocumentaiV1ReviewDocumentResponse", "properties": { "gcsDestination": { @@ -1380,7 +1415,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1SetDefaultProcessorVersionMetadata": { - "description": "The long-running operation metadata for set default processor version method.", + "description": "The long-running operation metadata for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiV1SetDefaultProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -1391,7 +1426,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1SetDefaultProcessorVersionResponse": { - "description": "Response message for set default processor version method.", + "description": "Response message for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiV1SetDefaultProcessorVersionResponse", "properties": {}, "type": "object" @@ -1458,7 +1493,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1UndeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for the undeploy processor version method.", + "description": "The long-running operation metadata for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1UndeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -1469,7 +1504,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1UndeployProcessorVersionResponse": { - "description": "Response message for the undeploy processor version method.", + "description": "Response message for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1UndeployProcessorVersionResponse", "properties": {}, "type": "object" @@ -1596,7 +1631,7 @@ "type": "array" }, "uri": { - "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. See [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris) for more info.", + "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. For more information, refer to [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris).", "type": "string" } }, @@ -2336,11 +2371,11 @@ "description": "Color of the background." }, "bold": { - "description": "Whether the text is bold (equivalent to font weight \u003e= 700).", + "description": "Whether the text is bold (equivalent to font_weight is at least `700`).", "type": "boolean" }, "fontSize": { - "description": "Font size in points (1 point is 1/72\").", + "description": "Font size in points (`1` point is `¹⁄₇₂` inches).", "format": "int32", "type": "integer" }, @@ -2349,7 +2384,7 @@ "type": "string" }, "fontWeight": { - "description": "TrueType weight on a scale 100 (Thin) to 1000 (Ultra-heavy). Normal is 400, Bold is 700.", + "description": "TrueType weight on a scale `100` (thin) to `1000` (ultra-heavy). Normal is `400`, bold is `700`.", "format": "int32", "type": "integer" }, @@ -2367,12 +2402,12 @@ "type": "number" }, "pixelFontSize": { - "description": "Font size in pixels, equal to unrounded_fontsize * resolution / 72.0.", + "description": "Font size in pixels, equal to _unrounded font_size_ * _resolution_ ÷ `72.0`.", "format": "double", "type": "number" }, "smallcaps": { - "description": "Whether the text are small caps.", + "description": "Whether the text is in small caps.", "type": "boolean" }, "strikeout": { @@ -2979,7 +3014,7 @@ "type": "array" }, "uri": { - "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. See [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris) for more info.", + "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. For more information, refer to [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris).", "type": "string" } }, @@ -3739,11 +3774,11 @@ "description": "Color of the background." }, "bold": { - "description": "Whether the text is bold (equivalent to font weight \u003e= 700).", + "description": "Whether the text is bold (equivalent to font_weight is at least `700`).", "type": "boolean" }, "fontSize": { - "description": "Font size in points (1 point is 1/72\").", + "description": "Font size in points (`1` point is `¹⁄₇₂` inches).", "format": "int32", "type": "integer" }, @@ -3752,7 +3787,7 @@ "type": "string" }, "fontWeight": { - "description": "TrueType weight on a scale 100 (Thin) to 1000 (Ultra-heavy). Normal is 400, Bold is 700.", + "description": "TrueType weight on a scale `100` (thin) to `1000` (ultra-heavy). Normal is `400`, bold is `700`.", "format": "int32", "type": "integer" }, @@ -3770,12 +3805,12 @@ "type": "number" }, "pixelFontSize": { - "description": "Font size in pixels, equal to unrounded_fontsize * resolution / 72.0.", + "description": "Font size in pixels, equal to _unrounded font_size_ * _resolution_ ÷ `72.0`.", "format": "double", "type": "number" }, "smallcaps": { - "description": "Whether the text are small caps.", + "description": "Whether the text is in small caps.", "type": "boolean" }, "strikeout": { @@ -4445,7 +4480,7 @@ "id": "GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus", "properties": { "humanReviewOperation": { - "description": "The name of the operation triggered by the processed document. If the human review process isn't triggered, this field will be empty. It has the same response type and metadata as the long-running operation returned by ReviewDocument method.", + "description": "The name of the operation triggered by the processed document. If the human review process isn't triggered, this field will be empty. It has the same response type and metadata as the long-running operation returned by the ReviewDocument method.", "type": "string" }, "humanReviewStatus": { @@ -4453,11 +4488,11 @@ "description": "The status of human review on the processed document." }, "inputGcsSource": { - "description": "The source of the document, same as the [input_gcs_source] field in the request when the batch process started. The batch process is started by take snapshot of that document, since a user can move or change that document during the process.", + "description": "The source of the document, same as the input_gcs_source field in the request when the batch process started.", "type": "string" }, "outputGcsDestination": { - "description": "The output_gcs_destination (in the request as `output_gcs_destination`) of the processed document if it was successful, otherwise empty.", + "description": "The Cloud Storage output destination (in the request as DocumentOutputConfig.GcsOutputConfig.gcs_uri) of the processed document if it was successful, otherwise empty.", "type": "string" }, "status": { @@ -4519,7 +4554,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DeleteProcessorMetadata": { - "description": "The long-running operation metadata for delete processor method.", + "description": "The long-running operation metadata for the DeleteProcessor method.", "id": "GoogleCloudDocumentaiV1beta3DeleteProcessorMetadata", "properties": { "commonMetadata": { @@ -4530,7 +4565,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DeleteProcessorVersionMetadata": { - "description": "The long-running operation metadata for delete processor version method.", + "description": "The long-running operation metadata for the DeleteProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3DeleteProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -4541,7 +4576,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for deploy processor version method.", + "description": "The long-running operation metadata for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3DeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -4552,13 +4587,13 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DeployProcessorVersionResponse": { - "description": "Response message for the deploy processor version method.", + "description": "Response message for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3DeployProcessorVersionResponse", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1beta3DisableProcessorMetadata": { - "description": "The long-running operation metadata for disable processor method.", + "description": "The long-running operation metadata for the DisableProcessor method.", "id": "GoogleCloudDocumentaiV1beta3DisableProcessorMetadata", "properties": { "commonMetadata": { @@ -4569,13 +4604,13 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DisableProcessorResponse": { - "description": "Response message for the disable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the DisableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiV1beta3DisableProcessorResponse", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1beta3EnableProcessorMetadata": { - "description": "The long-running operation metadata for enable processor method.", + "description": "The long-running operation metadata for the EnableProcessor method.", "id": "GoogleCloudDocumentaiV1beta3EnableProcessorMetadata", "properties": { "commonMetadata": { @@ -4586,7 +4621,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3EnableProcessorResponse": { - "description": "Response message for the enable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the EnableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiV1beta3EnableProcessorResponse", "properties": {}, "type": "object" @@ -4669,7 +4704,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata": { - "description": "The long-running operation metadata for review document method.", + "description": "The long-running operation metadata for the ReviewDocument method.", "id": "GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata", "properties": { "commonMetadata": { @@ -4718,7 +4753,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3ReviewDocumentResponse": { - "description": "Response message for review document method.", + "description": "Response message for the ReviewDocument method.", "id": "GoogleCloudDocumentaiV1beta3ReviewDocumentResponse", "properties": { "gcsDestination": { @@ -4747,7 +4782,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionMetadata": { - "description": "The long-running operation metadata for set default processor version method.", + "description": "The long-running operation metadata for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -4758,7 +4793,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionResponse": { - "description": "Response message for set default processor version method.", + "description": "Response message for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionResponse", "properties": {}, "type": "object" @@ -4825,7 +4860,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3UndeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for the undeploy processor version method.", + "description": "The long-running operation metadata for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3UndeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -4836,7 +4871,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3UndeployProcessorVersionResponse": { - "description": "Response message for the undeploy processor version method.", + "description": "Response message for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3UndeployProcessorVersionResponse", "properties": {}, "type": "object" diff --git a/documentai/v1beta2/documentai-gen.go b/documentai/v1beta2/documentai-gen.go index c509ce9d941..5d1459d2147 100644 --- a/documentai/v1beta2/documentai-gen.go +++ b/documentai/v1beta2/documentai-gen.go @@ -501,7 +501,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata) MarshalJSON() ([ } // GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata: The -// long-running operation metadata for CreateLabelerPool. +// long-running operation metadata for the CreateLabelerPool method. type GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -561,7 +561,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata) Marsh } // GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata: The -// long-running operation metadata for delete processor method. +// long-running operation metadata for the DeleteProcessor method. type GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -591,7 +591,8 @@ func (s *GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata) MarshalJSON() ([ } // GoogleCloudDocumentaiUiv1beta3DeleteProcessorVersionMetadata: The -// long-running operation metadata for delete processor version method. +// long-running operation metadata for the DeleteProcessorVersion +// method. type GoogleCloudDocumentaiUiv1beta3DeleteProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -621,7 +622,8 @@ func (s *GoogleCloudDocumentaiUiv1beta3DeleteProcessorVersionMetadata) MarshalJS } // GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionMetadata: The -// long-running operation metadata for deploy processor version method. +// long-running operation metadata for the DeployProcessorVersion +// method. type GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -651,12 +653,12 @@ func (s *GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionMetadata) MarshalJS } // GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionResponse: -// Response message for the deploy processor version method. +// Response message for the DeployProcessorVersion method. type GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionResponse struct { } // GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata: The -// long-running operation metadata for disable processor method. +// long-running operation metadata for the DisableProcessor method. type GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -686,7 +688,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata) MarshalJSON() ( } // GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse: Response -// message for the disable processor method. Intentionally empty proto +// message for the DisableProcessor method. Intentionally empty proto // for adding fields in future. type GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse struct { } @@ -757,7 +759,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId) MarshalJS } // GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata: The -// long-running operation metadata for enable processor method. +// long-running operation metadata for the EnableProcessor method. type GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -787,8 +789,8 @@ func (s *GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata) MarshalJSON() ([ } // GoogleCloudDocumentaiUiv1beta3EnableProcessorResponse: Response -// message for the enable processor method. Intentionally empty proto -// for adding fields in future. +// message for the EnableProcessor method. Intentionally empty proto for +// adding fields in future. type GoogleCloudDocumentaiUiv1beta3EnableProcessorResponse struct { } @@ -1393,8 +1395,95 @@ func (s *GoogleCloudDocumentaiUiv1beta3RevisionRef) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata: Metadata of +// the sample documents operation. +type GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata struct { + // CommonMetadata: The basic metadata of the long running operation. + CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CommonMetadata") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CommonMetadata") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse: Response of +// the sample documents operation. +type GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse struct { + // SelectedDocuments: The result of the sampling process. + SelectedDocuments []*GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument `json:"selectedDocuments,omitempty"` + + // ForceSendFields is a list of field names (e.g. "SelectedDocuments") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "SelectedDocuments") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +type GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument struct { + // DocumentId: An internal identifier for document. + DocumentId string `json:"documentId,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DocumentId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DocumentId") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionMetadata: The -// long-running operation metadata for set default processor version +// long-running operation metadata for the SetDefaultProcessorVersion // method. type GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -1425,7 +1514,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionMetadata) Marsh } // GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionResponse: -// Response message for set default processor version method. +// Response message for the SetDefaultProcessorVersion method. type GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionResponse struct { } @@ -1542,7 +1631,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3TrainProcessorVersionResponse) MarshalJSO } // GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionMetadata: The -// long-running operation metadata for the undeploy processor version +// long-running operation metadata for the UndeployProcessorVersion // method. type GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -1573,7 +1662,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionMetadata) Marshal } // GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionResponse: -// Response message for the undeploy processor version method. +// Response message for the UndeployProcessorVersion method. type GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionResponse struct { } @@ -1728,15 +1817,12 @@ type GoogleCloudDocumentaiV1BatchProcessMetadataIndividualProcessStatus struct { HumanReviewStatus *GoogleCloudDocumentaiV1HumanReviewStatus `json:"humanReviewStatus,omitempty"` // InputGcsSource: The source of the document, same as the - // [input_gcs_source] field in the request when the batch process - // started. The batch process is started by take snapshot of that - // document, since a user can move or change that document during the - // process. + // input_gcs_source field in the request when the batch process started. InputGcsSource string `json:"inputGcsSource,omitempty"` - // OutputGcsDestination: The output_gcs_destination (in the request as - // `output_gcs_destination`) of the processed document if it was - // successful, otherwise empty. + // OutputGcsDestination: The Cloud Storage output destination (in the + // request as DocumentOutputConfig.GcsOutputConfig.gcs_uri) of the + // processed document if it was successful, otherwise empty. OutputGcsDestination string `json:"outputGcsDestination,omitempty"` // Status: The status processing the document. @@ -1822,7 +1908,7 @@ func (s *GoogleCloudDocumentaiV1CommonOperationMetadata) MarshalJSON() ([]byte, } // GoogleCloudDocumentaiV1DeleteProcessorMetadata: The long-running -// operation metadata for delete processor method. +// operation metadata for the DeleteProcessor method. type GoogleCloudDocumentaiV1DeleteProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -1852,7 +1938,8 @@ func (s *GoogleCloudDocumentaiV1DeleteProcessorMetadata) MarshalJSON() ([]byte, } // GoogleCloudDocumentaiV1DeleteProcessorVersionMetadata: The -// long-running operation metadata for delete processor version method. +// long-running operation metadata for the DeleteProcessorVersion +// method. type GoogleCloudDocumentaiV1DeleteProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -1882,7 +1969,8 @@ func (s *GoogleCloudDocumentaiV1DeleteProcessorVersionMetadata) MarshalJSON() ([ } // GoogleCloudDocumentaiV1DeployProcessorVersionMetadata: The -// long-running operation metadata for deploy processor version method. +// long-running operation metadata for the DeployProcessorVersion +// method. type GoogleCloudDocumentaiV1DeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -1912,12 +2000,12 @@ func (s *GoogleCloudDocumentaiV1DeployProcessorVersionMetadata) MarshalJSON() ([ } // GoogleCloudDocumentaiV1DeployProcessorVersionResponse: Response -// message for the deploy processor version method. +// message for the DeployProcessorVersion method. type GoogleCloudDocumentaiV1DeployProcessorVersionResponse struct { } // GoogleCloudDocumentaiV1DisableProcessorMetadata: The long-running -// operation metadata for disable processor method. +// operation metadata for the DisableProcessor method. type GoogleCloudDocumentaiV1DisableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -1947,13 +2035,13 @@ func (s *GoogleCloudDocumentaiV1DisableProcessorMetadata) MarshalJSON() ([]byte, } // GoogleCloudDocumentaiV1DisableProcessorResponse: Response message for -// the disable processor method. Intentionally empty proto for adding +// the DisableProcessor method. Intentionally empty proto for adding // fields in future. type GoogleCloudDocumentaiV1DisableProcessorResponse struct { } // GoogleCloudDocumentaiV1EnableProcessorMetadata: The long-running -// operation metadata for enable processor method. +// operation metadata for the EnableProcessor method. type GoogleCloudDocumentaiV1EnableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -1983,7 +2071,7 @@ func (s *GoogleCloudDocumentaiV1EnableProcessorMetadata) MarshalJSON() ([]byte, } // GoogleCloudDocumentaiV1EnableProcessorResponse: Response message for -// the enable processor method. Intentionally empty proto for adding +// the EnableProcessor method. Intentionally empty proto for adding // fields in future. type GoogleCloudDocumentaiV1EnableProcessorResponse struct { } @@ -2102,7 +2190,7 @@ func (s *GoogleCloudDocumentaiV1HumanReviewStatus) MarshalJSON() ([]byte, error) } // GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata: The -// long-running operation metadata for review document method. +// long-running operation metadata for the ReviewDocument method. type GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -2135,7 +2223,7 @@ func (s *GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata) MarshalJSON() ( } // GoogleCloudDocumentaiV1ReviewDocumentResponse: Response message for -// review document method. +// the ReviewDocument method. type GoogleCloudDocumentaiV1ReviewDocumentResponse struct { // GcsDestination: The Cloud Storage uri for the human reviewed document // if the review is succeeded. @@ -2178,7 +2266,7 @@ func (s *GoogleCloudDocumentaiV1ReviewDocumentResponse) MarshalJSON() ([]byte, e } // GoogleCloudDocumentaiV1SetDefaultProcessorVersionMetadata: The -// long-running operation metadata for set default processor version +// long-running operation metadata for the SetDefaultProcessorVersion // method. type GoogleCloudDocumentaiV1SetDefaultProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -2209,7 +2297,7 @@ func (s *GoogleCloudDocumentaiV1SetDefaultProcessorVersionMetadata) MarshalJSON( } // GoogleCloudDocumentaiV1SetDefaultProcessorVersionResponse: Response -// message for set default processor version method. +// message for the SetDefaultProcessorVersion method. type GoogleCloudDocumentaiV1SetDefaultProcessorVersionResponse struct { } @@ -2328,7 +2416,7 @@ func (s *GoogleCloudDocumentaiV1TrainProcessorVersionResponse) MarshalJSON() ([] } // GoogleCloudDocumentaiV1UndeployProcessorVersionMetadata: The -// long-running operation metadata for the undeploy processor version +// long-running operation metadata for the UndeployProcessorVersion // method. type GoogleCloudDocumentaiV1UndeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -2359,7 +2447,7 @@ func (s *GoogleCloudDocumentaiV1UndeployProcessorVersionMetadata) MarshalJSON() } // GoogleCloudDocumentaiV1UndeployProcessorVersionResponse: Response -// message for the undeploy processor version method. +// message for the UndeployProcessorVersion method. type GoogleCloudDocumentaiV1UndeployProcessorVersionResponse struct { } @@ -2526,8 +2614,8 @@ type GoogleCloudDocumentaiV1beta1Document struct { // Uri: Optional. Currently supports Google Cloud Storage URI of the // form `gs://bucket_name/object_name`. Object versioning is not - // supported. See Google Cloud Storage Request URIs - // (https://cloud.google.com/storage/docs/reference-uris) for more info. + // supported. For more information, refer to Google Cloud Storage + // Request URIs (https://cloud.google.com/storage/docs/reference-uris). Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -3713,17 +3801,18 @@ type GoogleCloudDocumentaiV1beta1DocumentPageTokenStyleInfo struct { // BackgroundColor: Color of the background. BackgroundColor *GoogleTypeColor `json:"backgroundColor,omitempty"` - // Bold: Whether the text is bold (equivalent to font weight >= 700). + // Bold: Whether the text is bold (equivalent to font_weight is at least + // `700`). Bold bool `json:"bold,omitempty"` - // FontSize: Font size in points (1 point is 1/72"). + // FontSize: Font size in points (`1` point is `¹⁄₇₂` inches). FontSize int64 `json:"fontSize,omitempty"` // FontType: Name or style of the font. FontType string `json:"fontType,omitempty"` - // FontWeight: TrueType weight on a scale 100 (Thin) to 1000 - // (Ultra-heavy). Normal is 400, Bold is 700. + // FontWeight: TrueType weight on a scale `100` (thin) to `1000` + // (ultra-heavy). Normal is `400`, bold is `700`. FontWeight int64 `json:"fontWeight,omitempty"` // Handwritten: Whether the text is handwritten. @@ -3735,11 +3824,11 @@ type GoogleCloudDocumentaiV1beta1DocumentPageTokenStyleInfo struct { // LetterSpacing: Letter spacing in points. LetterSpacing float64 `json:"letterSpacing,omitempty"` - // PixelFontSize: Font size in pixels, equal to unrounded_fontsize * - // resolution / 72.0. + // PixelFontSize: Font size in pixels, equal to _unrounded font_size_ * + // _resolution_ ÷ `72.0`. PixelFontSize float64 `json:"pixelFontSize,omitempty"` - // Smallcaps: Whether the text are small caps. + // Smallcaps: Whether the text is in small caps. Smallcaps bool `json:"smallcaps,omitempty"` // Strikeout: Whether the text is strikethrough. @@ -4796,8 +4885,8 @@ type GoogleCloudDocumentaiV1beta2Document struct { // Uri: Optional. Currently supports Google Cloud Storage URI of the // form `gs://bucket_name/object_name`. Object versioning is not - // supported. See Google Cloud Storage Request URIs - // (https://cloud.google.com/storage/docs/reference-uris) for more info. + // supported. For more information, refer to Google Cloud Storage + // Request URIs (https://cloud.google.com/storage/docs/reference-uris). Uri string `json:"uri,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -6042,17 +6131,18 @@ type GoogleCloudDocumentaiV1beta2DocumentPageTokenStyleInfo struct { // BackgroundColor: Color of the background. BackgroundColor *GoogleTypeColor `json:"backgroundColor,omitempty"` - // Bold: Whether the text is bold (equivalent to font weight >= 700). + // Bold: Whether the text is bold (equivalent to font_weight is at least + // `700`). Bold bool `json:"bold,omitempty"` - // FontSize: Font size in points (1 point is 1/72"). + // FontSize: Font size in points (`1` point is `¹⁄₇₂` inches). FontSize int64 `json:"fontSize,omitempty"` // FontType: Name or style of the font. FontType string `json:"fontType,omitempty"` - // FontWeight: TrueType weight on a scale 100 (Thin) to 1000 - // (Ultra-heavy). Normal is 400, Bold is 700. + // FontWeight: TrueType weight on a scale `100` (thin) to `1000` + // (ultra-heavy). Normal is `400`, bold is `700`. FontWeight int64 `json:"fontWeight,omitempty"` // Handwritten: Whether the text is handwritten. @@ -6064,11 +6154,11 @@ type GoogleCloudDocumentaiV1beta2DocumentPageTokenStyleInfo struct { // LetterSpacing: Letter spacing in points. LetterSpacing float64 `json:"letterSpacing,omitempty"` - // PixelFontSize: Font size in pixels, equal to unrounded_fontsize * - // resolution / 72.0. + // PixelFontSize: Font size in pixels, equal to _unrounded font_size_ * + // _resolution_ ÷ `72.0`. PixelFontSize float64 `json:"pixelFontSize,omitempty"` - // Smallcaps: Whether the text are small caps. + // Smallcaps: Whether the text is in small caps. Smallcaps bool `json:"smallcaps,omitempty"` // Strikeout: Whether the text is strikethrough. @@ -7252,7 +7342,7 @@ type GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus str // HumanReviewOperation: The name of the operation triggered by the // processed document. If the human review process isn't triggered, this // field will be empty. It has the same response type and metadata as - // the long-running operation returned by ReviewDocument method. + // the long-running operation returned by the ReviewDocument method. HumanReviewOperation string `json:"humanReviewOperation,omitempty"` // HumanReviewStatus: The status of human review on the processed @@ -7260,15 +7350,12 @@ type GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus str HumanReviewStatus *GoogleCloudDocumentaiV1beta3HumanReviewStatus `json:"humanReviewStatus,omitempty"` // InputGcsSource: The source of the document, same as the - // [input_gcs_source] field in the request when the batch process - // started. The batch process is started by take snapshot of that - // document, since a user can move or change that document during the - // process. + // input_gcs_source field in the request when the batch process started. InputGcsSource string `json:"inputGcsSource,omitempty"` - // OutputGcsDestination: The output_gcs_destination (in the request as - // `output_gcs_destination`) of the processed document if it was - // successful, otherwise empty. + // OutputGcsDestination: The Cloud Storage output destination (in the + // request as DocumentOutputConfig.GcsOutputConfig.gcs_uri) of the + // processed document if it was successful, otherwise empty. OutputGcsDestination string `json:"outputGcsDestination,omitempty"` // Status: The status processing the document. @@ -7355,7 +7442,7 @@ func (s *GoogleCloudDocumentaiV1beta3CommonOperationMetadata) MarshalJSON() ([]b } // GoogleCloudDocumentaiV1beta3DeleteProcessorMetadata: The long-running -// operation metadata for delete processor method. +// operation metadata for the DeleteProcessor method. type GoogleCloudDocumentaiV1beta3DeleteProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -7385,7 +7472,8 @@ func (s *GoogleCloudDocumentaiV1beta3DeleteProcessorMetadata) MarshalJSON() ([]b } // GoogleCloudDocumentaiV1beta3DeleteProcessorVersionMetadata: The -// long-running operation metadata for delete processor version method. +// long-running operation metadata for the DeleteProcessorVersion +// method. type GoogleCloudDocumentaiV1beta3DeleteProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -7415,7 +7503,8 @@ func (s *GoogleCloudDocumentaiV1beta3DeleteProcessorVersionMetadata) MarshalJSON } // GoogleCloudDocumentaiV1beta3DeployProcessorVersionMetadata: The -// long-running operation metadata for deploy processor version method. +// long-running operation metadata for the DeployProcessorVersion +// method. type GoogleCloudDocumentaiV1beta3DeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -7445,12 +7534,12 @@ func (s *GoogleCloudDocumentaiV1beta3DeployProcessorVersionMetadata) MarshalJSON } // GoogleCloudDocumentaiV1beta3DeployProcessorVersionResponse: Response -// message for the deploy processor version method. +// message for the DeployProcessorVersion method. type GoogleCloudDocumentaiV1beta3DeployProcessorVersionResponse struct { } // GoogleCloudDocumentaiV1beta3DisableProcessorMetadata: The -// long-running operation metadata for disable processor method. +// long-running operation metadata for the DisableProcessor method. type GoogleCloudDocumentaiV1beta3DisableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -7480,13 +7569,13 @@ func (s *GoogleCloudDocumentaiV1beta3DisableProcessorMetadata) MarshalJSON() ([] } // GoogleCloudDocumentaiV1beta3DisableProcessorResponse: Response -// message for the disable processor method. Intentionally empty proto +// message for the DisableProcessor method. Intentionally empty proto // for adding fields in future. type GoogleCloudDocumentaiV1beta3DisableProcessorResponse struct { } // GoogleCloudDocumentaiV1beta3EnableProcessorMetadata: The long-running -// operation metadata for enable processor method. +// operation metadata for the EnableProcessor method. type GoogleCloudDocumentaiV1beta3EnableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -7516,7 +7605,7 @@ func (s *GoogleCloudDocumentaiV1beta3EnableProcessorMetadata) MarshalJSON() ([]b } // GoogleCloudDocumentaiV1beta3EnableProcessorResponse: Response message -// for the enable processor method. Intentionally empty proto for adding +// for the EnableProcessor method. Intentionally empty proto for adding // fields in future. type GoogleCloudDocumentaiV1beta3EnableProcessorResponse struct { } @@ -7696,7 +7785,7 @@ func (s *GoogleCloudDocumentaiV1beta3ImportProcessorVersionResponse) MarshalJSON } // GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata: The -// long-running operation metadata for review document method. +// long-running operation metadata for the ReviewDocument method. type GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -7751,7 +7840,7 @@ func (s *GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata) MarshalJSO } // GoogleCloudDocumentaiV1beta3ReviewDocumentResponse: Response message -// for review document method. +// for the ReviewDocument method. type GoogleCloudDocumentaiV1beta3ReviewDocumentResponse struct { // GcsDestination: The Cloud Storage uri for the human reviewed document // if the review is succeeded. @@ -7794,7 +7883,7 @@ func (s *GoogleCloudDocumentaiV1beta3ReviewDocumentResponse) MarshalJSON() ([]by } // GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionMetadata: The -// long-running operation metadata for set default processor version +// long-running operation metadata for the SetDefaultProcessorVersion // method. type GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -7825,7 +7914,7 @@ func (s *GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionMetadata) Marshal } // GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionResponse: -// Response message for set default processor version method. +// Response message for the SetDefaultProcessorVersion method. type GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionResponse struct { } @@ -7942,7 +8031,7 @@ func (s *GoogleCloudDocumentaiV1beta3TrainProcessorVersionResponse) MarshalJSON( } // GoogleCloudDocumentaiV1beta3UndeployProcessorVersionMetadata: The -// long-running operation metadata for the undeploy processor version +// long-running operation metadata for the UndeployProcessorVersion // method. type GoogleCloudDocumentaiV1beta3UndeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -7973,7 +8062,7 @@ func (s *GoogleCloudDocumentaiV1beta3UndeployProcessorVersionMetadata) MarshalJS } // GoogleCloudDocumentaiV1beta3UndeployProcessorVersionResponse: -// Response message for the undeploy processor version method. +// Response message for the UndeployProcessorVersion method. type GoogleCloudDocumentaiV1beta3UndeployProcessorVersionResponse struct { } diff --git a/documentai/v1beta3/documentai-api.json b/documentai/v1beta3/documentai-api.json index 5c9334eac97..9a11217b5da 100644 --- a/documentai/v1beta3/documentai-api.json +++ b/documentai/v1beta3/documentai-api.json @@ -119,7 +119,7 @@ ], "parameters": { "parent": { - "description": "Required. The project of processor type to list. The available processor types may depend on the allow-listing on projects. Format: `projects/{project}/locations/{location}`", + "description": "Required. The location of processor types to list. Format: `projects/{project}/locations/{location}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -334,7 +334,7 @@ ], "parameters": { "pageSize": { - "description": "The maximum number of processor types to return. If unspecified, at most 100 processor types will be returned. The maximum value is 500; values above 500 will be coerced to 500.", + "description": "The maximum number of processor types to return. If unspecified, at most `100` processor types will be returned. The maximum value is `500`. Values above `500` will be coerced to `500`.", "format": "int32", "location": "query", "type": "integer" @@ -345,7 +345,7 @@ "type": "string" }, "parent": { - "description": "Required. The location of processor type to list. The available processor types may depend on the allow-listing on projects. Format: `projects/{project}/locations/{location}`", + "description": "Required. The location of processor types to list. Format: `projects/{project}/locations/{location}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -393,7 +393,7 @@ ] }, "create": { - "description": "Creates a processor from the type processor that the user chose. The processor will be at \"ENABLED\" state by default after its creation.", + "description": "Creates a processor from the ProcessorType provided. The processor will be at `ENABLED` state by default after its creation.", "flatPath": "v1beta3/projects/{projectsId}/locations/{locationsId}/processors", "httpMethod": "POST", "id": "documentai.projects.locations.processors.create", @@ -536,7 +536,7 @@ ], "parameters": { "pageSize": { - "description": "The maximum number of processors to return. If unspecified, at most 50 processors will be returned. The maximum value is 100; values above 100 will be coerced to 100.", + "description": "The maximum number of processors to return. If unspecified, at most `50` processors will be returned. The maximum value is `100`. Values above `100` will be coerced to `100`.", "format": "int32", "location": "query", "type": "integer" @@ -826,7 +826,7 @@ ], "parameters": { "pageSize": { - "description": "The maximum number of processor versions to return. If unspecified, at most 10 processor versions will be returned. The maximum value is 20; values above 20 will be coerced to 20.", + "description": "The maximum number of processor versions to return. If unspecified, at most `10` processor versions will be returned. The maximum value is `20`. Values above `20` will be coerced to `20`.", "format": "int32", "location": "query", "type": "integer" @@ -881,7 +881,7 @@ ] }, "train": { - "description": "Trains a new processor version. Operation metadata is returned as cloud_documentai_core.TrainProcessorVersionMetadata.", + "description": "Trains a new processor version. Operation metadata is returned as TrainProcessorVersionMetadata.", "flatPath": "v1beta3/projects/{projectsId}/locations/{locationsId}/processors/{processorsId}/processorVersions:train", "httpMethod": "POST", "id": "documentai.projects.locations.processors.processorVersions.train", @@ -975,7 +975,7 @@ ], "parameters": { "pageSize": { - "description": "The standard list page size. If unspecified, at most `5` evaluations will be returned. The maximum value is `100`; values above `100` will be coerced to `100`.", + "description": "The standard list page size. If unspecified, at most `5` evaluations are returned. The maximum value is `100`. Values above `100` are coerced to `100`.", "format": "int32", "location": "query", "type": "integer" @@ -1012,7 +1012,7 @@ } } }, - "revision": "20230420", + "revision": "20230504", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -1223,7 +1223,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata": { - "description": "The long-running operation metadata for CreateLabelerPool.", + "description": "The long-running operation metadata for the CreateLabelerPool method.", "id": "GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata", "properties": { "commonMetadata": { @@ -1245,7 +1245,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata": { - "description": "The long-running operation metadata for delete processor method.", + "description": "The long-running operation metadata for the DeleteProcessor method.", "id": "GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata", "properties": { "commonMetadata": { @@ -1256,7 +1256,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DeleteProcessorVersionMetadata": { - "description": "The long-running operation metadata for delete processor version method.", + "description": "The long-running operation metadata for the DeleteProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3DeleteProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -1267,7 +1267,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for deploy processor version method.", + "description": "The long-running operation metadata for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -1278,13 +1278,13 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionResponse": { - "description": "Response message for the deploy processor version method.", + "description": "Response message for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionResponse", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata": { - "description": "The long-running operation metadata for disable processor method.", + "description": "The long-running operation metadata for the DisableProcessor method.", "id": "GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata", "properties": { "commonMetadata": { @@ -1295,7 +1295,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse": { - "description": "Response message for the disable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the DisableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse", "properties": {}, "type": "object" @@ -1330,7 +1330,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata": { - "description": "The long-running operation metadata for enable processor method.", + "description": "The long-running operation metadata for the EnableProcessor method.", "id": "GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata", "properties": { "commonMetadata": { @@ -1341,7 +1341,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3EnableProcessorResponse": { - "description": "Response message for the enable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the EnableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiUiv1beta3EnableProcessorResponse", "properties": {}, "type": "object" @@ -1676,8 +1676,43 @@ }, "type": "object" }, + "GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata": { + "description": "Metadata of the sample documents operation.", + "id": "GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata", + "properties": { + "commonMetadata": { + "$ref": "GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata", + "description": "The basic metadata of the long running operation." + } + }, + "type": "object" + }, + "GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse": { + "description": "Response of the sample documents operation.", + "id": "GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse", + "properties": { + "selectedDocuments": { + "description": "The result of the sampling process.", + "items": { + "$ref": "GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument": { + "id": "GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument", + "properties": { + "documentId": { + "description": "An internal identifier for document.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionMetadata": { - "description": "The long-running operation metadata for set default processor version method.", + "description": "The long-running operation metadata for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -1688,7 +1723,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionResponse": { - "description": "Response message for set default processor version method.", + "description": "Response message for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionResponse", "properties": {}, "type": "object" @@ -1755,7 +1790,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for the undeploy processor version method.", + "description": "The long-running operation metadata for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -1766,7 +1801,7 @@ "type": "object" }, "GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionResponse": { - "description": "Response message for the undeploy processor version method.", + "description": "Response message for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionResponse", "properties": {}, "type": "object" @@ -1862,11 +1897,11 @@ "description": "The status of human review on the processed document." }, "inputGcsSource": { - "description": "The source of the document, same as the [input_gcs_source] field in the request when the batch process started. The batch process is started by take snapshot of that document, since a user can move or change that document during the process.", + "description": "The source of the document, same as the input_gcs_source field in the request when the batch process started.", "type": "string" }, "outputGcsDestination": { - "description": "The output_gcs_destination (in the request as `output_gcs_destination`) of the processed document if it was successful, otherwise empty.", + "description": "The Cloud Storage output destination (in the request as DocumentOutputConfig.GcsOutputConfig.gcs_uri) of the processed document if it was successful, otherwise empty.", "type": "string" }, "status": { @@ -1928,7 +1963,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1DeleteProcessorMetadata": { - "description": "The long-running operation metadata for delete processor method.", + "description": "The long-running operation metadata for the DeleteProcessor method.", "id": "GoogleCloudDocumentaiV1DeleteProcessorMetadata", "properties": { "commonMetadata": { @@ -1939,7 +1974,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1DeleteProcessorVersionMetadata": { - "description": "The long-running operation metadata for delete processor version method.", + "description": "The long-running operation metadata for the DeleteProcessorVersion method.", "id": "GoogleCloudDocumentaiV1DeleteProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -1950,7 +1985,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1DeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for deploy processor version method.", + "description": "The long-running operation metadata for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1DeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -1961,13 +1996,13 @@ "type": "object" }, "GoogleCloudDocumentaiV1DeployProcessorVersionResponse": { - "description": "Response message for the deploy processor version method.", + "description": "Response message for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1DeployProcessorVersionResponse", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1DisableProcessorMetadata": { - "description": "The long-running operation metadata for disable processor method.", + "description": "The long-running operation metadata for the DisableProcessor method.", "id": "GoogleCloudDocumentaiV1DisableProcessorMetadata", "properties": { "commonMetadata": { @@ -1978,13 +2013,13 @@ "type": "object" }, "GoogleCloudDocumentaiV1DisableProcessorResponse": { - "description": "Response message for the disable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the DisableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiV1DisableProcessorResponse", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1EnableProcessorMetadata": { - "description": "The long-running operation metadata for enable processor method.", + "description": "The long-running operation metadata for the EnableProcessor method.", "id": "GoogleCloudDocumentaiV1EnableProcessorMetadata", "properties": { "commonMetadata": { @@ -1995,7 +2030,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1EnableProcessorResponse": { - "description": "Response message for the enable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the EnableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiV1EnableProcessorResponse", "properties": {}, "type": "object" @@ -2056,7 +2091,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata": { - "description": "The long-running operation metadata for review document method.", + "description": "The long-running operation metadata for the ReviewDocument method.", "id": "GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata", "properties": { "commonMetadata": { @@ -2071,7 +2106,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1ReviewDocumentResponse": { - "description": "Response message for review document method.", + "description": "Response message for the ReviewDocument method.", "id": "GoogleCloudDocumentaiV1ReviewDocumentResponse", "properties": { "gcsDestination": { @@ -2100,7 +2135,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1SetDefaultProcessorVersionMetadata": { - "description": "The long-running operation metadata for set default processor version method.", + "description": "The long-running operation metadata for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiV1SetDefaultProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -2111,7 +2146,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1SetDefaultProcessorVersionResponse": { - "description": "Response message for set default processor version method.", + "description": "Response message for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiV1SetDefaultProcessorVersionResponse", "properties": {}, "type": "object" @@ -2178,7 +2213,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1UndeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for the undeploy processor version method.", + "description": "The long-running operation metadata for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1UndeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -2189,7 +2224,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1UndeployProcessorVersionResponse": { - "description": "Response message for the undeploy processor version method.", + "description": "Response message for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1UndeployProcessorVersionResponse", "properties": {}, "type": "object" @@ -2316,7 +2351,7 @@ "type": "array" }, "uri": { - "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. See [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris) for more info.", + "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. For more information, refer to [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris).", "type": "string" } }, @@ -3056,11 +3091,11 @@ "description": "Color of the background." }, "bold": { - "description": "Whether the text is bold (equivalent to font weight \u003e= 700).", + "description": "Whether the text is bold (equivalent to font_weight is at least `700`).", "type": "boolean" }, "fontSize": { - "description": "Font size in points (1 point is 1/72\").", + "description": "Font size in points (`1` point is `¹⁄₇₂` inches).", "format": "int32", "type": "integer" }, @@ -3069,7 +3104,7 @@ "type": "string" }, "fontWeight": { - "description": "TrueType weight on a scale 100 (Thin) to 1000 (Ultra-heavy). Normal is 400, Bold is 700.", + "description": "TrueType weight on a scale `100` (thin) to `1000` (ultra-heavy). Normal is `400`, bold is `700`.", "format": "int32", "type": "integer" }, @@ -3087,12 +3122,12 @@ "type": "number" }, "pixelFontSize": { - "description": "Font size in pixels, equal to unrounded_fontsize * resolution / 72.0.", + "description": "Font size in pixels, equal to _unrounded font_size_ * _resolution_ ÷ `72.0`.", "format": "double", "type": "number" }, "smallcaps": { - "description": "Whether the text are small caps.", + "description": "Whether the text is in small caps.", "type": "boolean" }, "strikeout": { @@ -3674,7 +3709,7 @@ "type": "array" }, "uri": { - "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. See [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris) for more info.", + "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. For more information, refer to [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris).", "type": "string" } }, @@ -4434,11 +4469,11 @@ "description": "Color of the background." }, "bold": { - "description": "Whether the text is bold (equivalent to font weight \u003e= 700).", + "description": "Whether the text is bold (equivalent to font_weight is at least `700`).", "type": "boolean" }, "fontSize": { - "description": "Font size in points (1 point is 1/72\").", + "description": "Font size in points (`1` point is `¹⁄₇₂` inches).", "format": "int32", "type": "integer" }, @@ -4447,7 +4482,7 @@ "type": "string" }, "fontWeight": { - "description": "TrueType weight on a scale 100 (Thin) to 1000 (Ultra-heavy). Normal is 400, Bold is 700.", + "description": "TrueType weight on a scale `100` (thin) to `1000` (ultra-heavy). Normal is `400`, bold is `700`.", "format": "int32", "type": "integer" }, @@ -4465,12 +4500,12 @@ "type": "number" }, "pixelFontSize": { - "description": "Font size in pixels, equal to unrounded_fontsize * resolution / 72.0.", + "description": "Font size in pixels, equal to _unrounded font_size_ * _resolution_ ÷ `72.0`.", "format": "double", "type": "number" }, "smallcaps": { - "description": "Whether the text are small caps.", + "description": "Whether the text is in small caps.", "type": "boolean" }, "strikeout": { @@ -5017,7 +5052,7 @@ "id": "GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus", "properties": { "humanReviewOperation": { - "description": "The name of the operation triggered by the processed document. If the human review process isn't triggered, this field will be empty. It has the same response type and metadata as the long-running operation returned by ReviewDocument method.", + "description": "The name of the operation triggered by the processed document. If the human review process isn't triggered, this field will be empty. It has the same response type and metadata as the long-running operation returned by the ReviewDocument method.", "type": "string" }, "humanReviewStatus": { @@ -5025,11 +5060,11 @@ "description": "The status of human review on the processed document." }, "inputGcsSource": { - "description": "The source of the document, same as the [input_gcs_source] field in the request when the batch process started. The batch process is started by take snapshot of that document, since a user can move or change that document during the process.", + "description": "The source of the document, same as the input_gcs_source field in the request when the batch process started.", "type": "string" }, "outputGcsDestination": { - "description": "The output_gcs_destination (in the request as `output_gcs_destination`) of the processed document if it was successful, otherwise empty.", + "description": "The Cloud Storage output destination (in the request as DocumentOutputConfig.GcsOutputConfig.gcs_uri) of the processed document if it was successful, otherwise empty.", "type": "string" }, "status": { @@ -5045,7 +5080,7 @@ "properties": { "documentOutputConfig": { "$ref": "GoogleCloudDocumentaiV1beta3DocumentOutputConfig", - "description": "The overall output config for batch process." + "description": "The output configuration for the BatchProcessDocuments method." }, "inputConfigs": { "description": "The input config for each single document in the batch process.", @@ -5056,7 +5091,7 @@ }, "inputDocuments": { "$ref": "GoogleCloudDocumentaiV1beta3BatchDocumentsInputConfig", - "description": "The input documents for batch process." + "description": "The input documents for the BatchProcessDocuments method." }, "outputConfig": { "$ref": "GoogleCloudDocumentaiV1beta3BatchProcessRequestBatchOutputConfig", @@ -5082,14 +5117,14 @@ "type": "string" }, "mimeType": { - "description": "Mimetype of the input. If the input is a raw document, the supported mimetypes are application/pdf, image/tiff, and image/gif. If the input is a Document proto, the type should be application/json.", + "description": "Media type (MIME type) of the input. If the input is a raw document, refer to [supported file types](https://cloud.google.com/document-ai/docs/file-types) for the list of media types. If the input is a Document, the type should be `application/json`.", "type": "string" } }, "type": "object" }, "GoogleCloudDocumentaiV1beta3BatchProcessRequestBatchOutputConfig": { - "description": "The message for output config in batch process.", + "description": "The output configuration in the BatchProcessDocuments method.", "id": "GoogleCloudDocumentaiV1beta3BatchProcessRequestBatchOutputConfig", "properties": { "gcsDestination": { @@ -5172,7 +5207,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DeleteProcessorMetadata": { - "description": "The long-running operation metadata for delete processor method.", + "description": "The long-running operation metadata for the DeleteProcessor method.", "id": "GoogleCloudDocumentaiV1beta3DeleteProcessorMetadata", "properties": { "commonMetadata": { @@ -5183,7 +5218,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DeleteProcessorVersionMetadata": { - "description": "The long-running operation metadata for delete processor version method.", + "description": "The long-running operation metadata for the DeleteProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3DeleteProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -5194,7 +5229,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for deploy processor version method.", + "description": "The long-running operation metadata for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3DeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -5205,19 +5240,19 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DeployProcessorVersionRequest": { - "description": "Request message for the deploy processor version method.", + "description": "Request message for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3DeployProcessorVersionRequest", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1beta3DeployProcessorVersionResponse": { - "description": "Response message for the deploy processor version method.", + "description": "Response message for the DeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3DeployProcessorVersionResponse", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1beta3DisableProcessorMetadata": { - "description": "The long-running operation metadata for disable processor method.", + "description": "The long-running operation metadata for the DisableProcessor method.", "id": "GoogleCloudDocumentaiV1beta3DisableProcessorMetadata", "properties": { "commonMetadata": { @@ -5228,13 +5263,13 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3DisableProcessorRequest": { - "description": "Request message for the disable processor method.", + "description": "Request message for the DisableProcessor method.", "id": "GoogleCloudDocumentaiV1beta3DisableProcessorRequest", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1beta3DisableProcessorResponse": { - "description": "Response message for the disable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the DisableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiV1beta3DisableProcessorResponse", "properties": {}, "type": "object" @@ -5307,7 +5342,7 @@ "type": "array" }, "uri": { - "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. See [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris) for more info.", + "description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. For more information, refer to [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris).", "type": "string" } }, @@ -6095,11 +6130,11 @@ "description": "Color of the background." }, "bold": { - "description": "Whether the text is bold (equivalent to font weight \u003e= 700).", + "description": "Whether the text is bold (equivalent to font_weight is at least `700`).", "type": "boolean" }, "fontSize": { - "description": "Font size in points (1 point is 1/72\").", + "description": "Font size in points (`1` point is `¹⁄₇₂` inches).", "format": "int32", "type": "integer" }, @@ -6108,7 +6143,7 @@ "type": "string" }, "fontWeight": { - "description": "TrueType weight on a scale 100 (Thin) to 1000 (Ultra-heavy). Normal is 400, Bold is 700.", + "description": "TrueType weight on a scale `100` (thin) to `1000` (ultra-heavy). Normal is `400`, bold is `700`.", "format": "int32", "type": "integer" }, @@ -6126,12 +6161,12 @@ "type": "number" }, "pixelFontSize": { - "description": "Font size in pixels, equal to unrounded_fontsize * resolution / 72.0.", + "description": "Font size in pixels, equal to _unrounded font_size_ * _resolution_ ÷ `72.0`.", "format": "double", "type": "number" }, "smallcaps": { - "description": "Whether the text are small caps.", + "description": "Whether the text is in small caps.", "type": "boolean" }, "strikeout": { @@ -6571,7 +6606,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3EnableProcessorMetadata": { - "description": "The long-running operation metadata for enable processor method.", + "description": "The long-running operation metadata for the EnableProcessor method.", "id": "GoogleCloudDocumentaiV1beta3EnableProcessorMetadata", "properties": { "commonMetadata": { @@ -6582,13 +6617,13 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3EnableProcessorRequest": { - "description": "Request message for the enable processor method.", + "description": "Request message for the EnableProcessor method.", "id": "GoogleCloudDocumentaiV1beta3EnableProcessorRequest", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1beta3EnableProcessorResponse": { - "description": "Response message for the enable processor method. Intentionally empty proto for adding fields in future.", + "description": "Response message for the EnableProcessor method. Intentionally empty proto for adding fields in future.", "id": "GoogleCloudDocumentaiV1beta3EnableProcessorResponse", "properties": {}, "type": "object" @@ -6847,7 +6882,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3FetchProcessorTypesResponse": { - "description": "Response message for fetch processor types.", + "description": "Response message for the FetchProcessorTypes method.", "id": "GoogleCloudDocumentaiV1beta3FetchProcessorTypesResponse", "properties": { "processorTypes": { @@ -6945,11 +6980,11 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3ImportProcessorVersionRequest": { - "description": "The request message for the `ImportProcessorVersion` method. This method requires the source processor version and destination processor to be in the same location. This method requires the Document AI Service Agent of the destination project to have [Document AI Editor role](https://cloud.google.com/document-ai/docs/access-control/iam-roles) on the source project. The destination project is specified as part of the `parent` field. The source project is specified as part of `source` field. The Service Agent for Document AI can be found in https://cloud.google.com/iam/docs/service-agents.", + "description": "The request message for the ImportProcessorVersion method. Requirements: - The source processor version and destination processor must be in the same location. - The Document AI [Service Agent](https://cloud.google.com/iam/docs/service-agents) of the destination project must have [Document AI Editor role](https://cloud.google.com/document-ai/docs/access-control/iam-roles) on the source project. The destination project is specified as part of the parent field. The source project is specified as part of the source field.", "id": "GoogleCloudDocumentaiV1beta3ImportProcessorVersionRequest", "properties": { "processorVersionSource": { - "description": "The source processor version to import from.", + "description": "The source processor version to import from. The source processor version and destination processor need to be in the same environment and region.", "type": "string" } }, @@ -6985,7 +7020,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3ListProcessorTypesResponse": { - "description": "Response message for list processor types.", + "description": "Response message for the ListProcessorTypes method.", "id": "GoogleCloudDocumentaiV1beta3ListProcessorTypesResponse", "properties": { "nextPageToken": { @@ -7003,7 +7038,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3ListProcessorVersionsResponse": { - "description": "Response message for list processors.", + "description": "Response message for the ListProcessorVersions method.", "id": "GoogleCloudDocumentaiV1beta3ListProcessorVersionsResponse", "properties": { "nextPageToken": { @@ -7021,7 +7056,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3ListProcessorsResponse": { - "description": "Response message for list processors.", + "description": "Response message for the ListProcessors method.", "id": "GoogleCloudDocumentaiV1beta3ListProcessorsResponse", "properties": { "nextPageToken": { @@ -7115,15 +7150,15 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3ProcessRequest": { - "description": "Request message for the process document method.", + "description": "Request message for the ProcessDocument method.", "id": "GoogleCloudDocumentaiV1beta3ProcessRequest", "properties": { "document": { "$ref": "GoogleCloudDocumentaiV1beta3Document", - "description": "The document payload, the [content] and [mime_type] fields must be set." + "description": "The document payload, the content and mime_type fields must be set." }, "fieldMask": { - "description": "Specifies which fields to include in the `ProcessResponse` Document. Only supports top level document and pages field so it must be in the form of `{document_field_name}` or `pages.{page_field_name}`.", + "description": "Specifies which fields to include in the ProcessResponse.document output. Only supports top-level document and pages field, so it must be in the form of `{document_field_name}` or `pages.{page_field_name}`.", "format": "google-fieldmask", "type": "string" }, @@ -7147,7 +7182,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3ProcessResponse": { - "description": "Response message for the process document method.", + "description": "Response message for the ProcessDocument method.", "id": "GoogleCloudDocumentaiV1beta3ProcessResponse", "properties": { "document": { @@ -7403,7 +7438,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata": { - "description": "The long-running operation metadata for review document method.", + "description": "The long-running operation metadata for the ReviewDocument method.", "id": "GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata", "properties": { "commonMetadata": { @@ -7452,7 +7487,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3ReviewDocumentRequest": { - "description": "Request message for review document method.", + "description": "Request message for the ReviewDocument method.", "id": "GoogleCloudDocumentaiV1beta3ReviewDocumentRequest", "properties": { "document": { @@ -7487,7 +7522,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3ReviewDocumentResponse": { - "description": "Response message for review document method.", + "description": "Response message for the ReviewDocument method.", "id": "GoogleCloudDocumentaiV1beta3ReviewDocumentResponse", "properties": { "gcsDestination": { @@ -7516,7 +7551,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionMetadata": { - "description": "The long-running operation metadata for set default processor version method.", + "description": "The long-running operation metadata for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -7527,7 +7562,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionRequest": { - "description": "Request message for the set default processor version method.", + "description": "Request message for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionRequest", "properties": { "defaultProcessorVersion": { @@ -7538,7 +7573,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionResponse": { - "description": "Response message for set default processor version method.", + "description": "Response message for the SetDefaultProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionResponse", "properties": {}, "type": "object" @@ -7594,7 +7629,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequest": { - "description": "Request message for the create processor version method.", + "description": "Request message for the TrainProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequest", "properties": { "baseProcessorVersion": { @@ -7607,7 +7642,7 @@ }, "inputData": { "$ref": "GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequestInputData", - "description": "Optional. The input data used to train the `ProcessorVersion`." + "description": "Optional. The input data used to train the ProcessorVersion." }, "processorVersion": { "$ref": "GoogleCloudDocumentaiV1beta3ProcessorVersion", @@ -7617,7 +7652,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequestInputData": { - "description": "The input data used to train a new `ProcessorVersion`.", + "description": "The input data used to train a new ProcessorVersion.", "id": "GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequestInputData", "properties": { "testDocuments": { @@ -7643,7 +7678,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3UndeployProcessorVersionMetadata": { - "description": "The long-running operation metadata for the undeploy processor version method.", + "description": "The long-running operation metadata for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3UndeployProcessorVersionMetadata", "properties": { "commonMetadata": { @@ -7654,13 +7689,13 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3UndeployProcessorVersionRequest": { - "description": "Request message for the undeploy processor version method.", + "description": "Request message for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3UndeployProcessorVersionRequest", "properties": {}, "type": "object" }, "GoogleCloudDocumentaiV1beta3UndeployProcessorVersionResponse": { - "description": "Response message for the undeploy processor version method.", + "description": "Response message for the UndeployProcessorVersion method.", "id": "GoogleCloudDocumentaiV1beta3UndeployProcessorVersionResponse", "properties": {}, "type": "object" diff --git a/documentai/v1beta3/documentai-gen.go b/documentai/v1beta3/documentai-gen.go index 039fdb0cb66..4c8fff1efad 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -525,7 +525,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata) MarshalJSON() ([ } // GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata: The -// long-running operation metadata for CreateLabelerPool. +// long-running operation metadata for the CreateLabelerPool method. type GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -585,7 +585,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata) Marsh } // GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata: The -// long-running operation metadata for delete processor method. +// long-running operation metadata for the DeleteProcessor method. type GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -615,7 +615,8 @@ func (s *GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata) MarshalJSON() ([ } // GoogleCloudDocumentaiUiv1beta3DeleteProcessorVersionMetadata: The -// long-running operation metadata for delete processor version method. +// long-running operation metadata for the DeleteProcessorVersion +// method. type GoogleCloudDocumentaiUiv1beta3DeleteProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -645,7 +646,8 @@ func (s *GoogleCloudDocumentaiUiv1beta3DeleteProcessorVersionMetadata) MarshalJS } // GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionMetadata: The -// long-running operation metadata for deploy processor version method. +// long-running operation metadata for the DeployProcessorVersion +// method. type GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -675,12 +677,12 @@ func (s *GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionMetadata) MarshalJS } // GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionResponse: -// Response message for the deploy processor version method. +// Response message for the DeployProcessorVersion method. type GoogleCloudDocumentaiUiv1beta3DeployProcessorVersionResponse struct { } // GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata: The -// long-running operation metadata for disable processor method. +// long-running operation metadata for the DisableProcessor method. type GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -710,7 +712,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata) MarshalJSON() ( } // GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse: Response -// message for the disable processor method. Intentionally empty proto +// message for the DisableProcessor method. Intentionally empty proto // for adding fields in future. type GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse struct { } @@ -781,7 +783,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3DocumentIdGCSManagedDocumentId) MarshalJS } // GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata: The -// long-running operation metadata for enable processor method. +// long-running operation metadata for the EnableProcessor method. type GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -811,8 +813,8 @@ func (s *GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata) MarshalJSON() ([ } // GoogleCloudDocumentaiUiv1beta3EnableProcessorResponse: Response -// message for the enable processor method. Intentionally empty proto -// for adding fields in future. +// message for the EnableProcessor method. Intentionally empty proto for +// adding fields in future. type GoogleCloudDocumentaiUiv1beta3EnableProcessorResponse struct { } @@ -1417,8 +1419,95 @@ func (s *GoogleCloudDocumentaiUiv1beta3RevisionRef) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata: Metadata of +// the sample documents operation. +type GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata struct { + // CommonMetadata: The basic metadata of the long running operation. + CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CommonMetadata") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CommonMetadata") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDocumentaiUiv1beta3SampleDocumentsMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse: Response of +// the sample documents operation. +type GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse struct { + // SelectedDocuments: The result of the sampling process. + SelectedDocuments []*GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument `json:"selectedDocuments,omitempty"` + + // ForceSendFields is a list of field names (e.g. "SelectedDocuments") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "SelectedDocuments") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +type GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument struct { + // DocumentId: An internal identifier for document. + DocumentId string `json:"documentId,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DocumentId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DocumentId") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDocumentaiUiv1beta3SampleDocumentsResponseSelectedDocument + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionMetadata: The -// long-running operation metadata for set default processor version +// long-running operation metadata for the SetDefaultProcessorVersion // method. type GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -1449,7 +1538,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionMetadata) Marsh } // GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionResponse: -// Response message for set default processor version method. +// Response message for the SetDefaultProcessorVersion method. type GoogleCloudDocumentaiUiv1beta3SetDefaultProcessorVersionResponse struct { } @@ -1566,7 +1655,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3TrainProcessorVersionResponse) MarshalJSO } // GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionMetadata: The -// long-running operation metadata for the undeploy processor version +// long-running operation metadata for the UndeployProcessorVersion // method. type GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -1597,7 +1686,7 @@ func (s *GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionMetadata) Marshal } // GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionResponse: -// Response message for the undeploy processor version method. +// Response message for the UndeployProcessorVersion method. type GoogleCloudDocumentaiUiv1beta3UndeployProcessorVersionResponse struct { } @@ -1752,15 +1841,12 @@ type GoogleCloudDocumentaiV1BatchProcessMetadataIndividualProcessStatus struct { HumanReviewStatus *GoogleCloudDocumentaiV1HumanReviewStatus `json:"humanReviewStatus,omitempty"` // InputGcsSource: The source of the document, same as the - // [input_gcs_source] field in the request when the batch process - // started. The batch process is started by take snapshot of that - // document, since a user can move or change that document during the - // process. + // input_gcs_source field in the request when the batch process started. InputGcsSource string `json:"inputGcsSource,omitempty"` - // OutputGcsDestination: The output_gcs_destination (in the request as - // `output_gcs_destination`) of the processed document if it was - // successful, otherwise empty. + // OutputGcsDestination: The Cloud Storage output destination (in the + // request as DocumentOutputConfig.GcsOutputConfig.gcs_uri) of the + // processed document if it was successful, otherwise empty. OutputGcsDestination string `json:"outputGcsDestination,omitempty"` // Status: The status processing the document. @@ -1846,7 +1932,7 @@ func (s *GoogleCloudDocumentaiV1CommonOperationMetadata) MarshalJSON() ([]byte, } // GoogleCloudDocumentaiV1DeleteProcessorMetadata: The long-running -// operation metadata for delete processor method. +// operation metadata for the DeleteProcessor method. type GoogleCloudDocumentaiV1DeleteProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -1876,7 +1962,8 @@ func (s *GoogleCloudDocumentaiV1DeleteProcessorMetadata) MarshalJSON() ([]byte, } // GoogleCloudDocumentaiV1DeleteProcessorVersionMetadata: The -// long-running operation metadata for delete processor version method. +// long-running operation metadata for the DeleteProcessorVersion +// method. type GoogleCloudDocumentaiV1DeleteProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -1906,7 +1993,8 @@ func (s *GoogleCloudDocumentaiV1DeleteProcessorVersionMetadata) MarshalJSON() ([ } // GoogleCloudDocumentaiV1DeployProcessorVersionMetadata: The -// long-running operation metadata for deploy processor version method. +// long-running operation metadata for the DeployProcessorVersion +// method. type GoogleCloudDocumentaiV1DeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -1936,12 +2024,12 @@ func (s *GoogleCloudDocumentaiV1DeployProcessorVersionMetadata) MarshalJSON() ([ } // GoogleCloudDocumentaiV1DeployProcessorVersionResponse: Response -// message for the deploy processor version method. +// message for the DeployProcessorVersion method. type GoogleCloudDocumentaiV1DeployProcessorVersionResponse struct { } // GoogleCloudDocumentaiV1DisableProcessorMetadata: The long-running -// operation metadata for disable processor method. +// operation metadata for the DisableProcessor method. type GoogleCloudDocumentaiV1DisableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -1971,13 +2059,13 @@ func (s *GoogleCloudDocumentaiV1DisableProcessorMetadata) MarshalJSON() ([]byte, } // GoogleCloudDocumentaiV1DisableProcessorResponse: Response message for -// the disable processor method. Intentionally empty proto for adding +// the DisableProcessor method. Intentionally empty proto for adding // fields in future. type GoogleCloudDocumentaiV1DisableProcessorResponse struct { } // GoogleCloudDocumentaiV1EnableProcessorMetadata: The long-running -// operation metadata for enable processor method. +// operation metadata for the EnableProcessor method. type GoogleCloudDocumentaiV1EnableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -2007,7 +2095,7 @@ func (s *GoogleCloudDocumentaiV1EnableProcessorMetadata) MarshalJSON() ([]byte, } // GoogleCloudDocumentaiV1EnableProcessorResponse: Response message for -// the enable processor method. Intentionally empty proto for adding +// the EnableProcessor method. Intentionally empty proto for adding // fields in future. type GoogleCloudDocumentaiV1EnableProcessorResponse struct { } @@ -2126,7 +2214,7 @@ func (s *GoogleCloudDocumentaiV1HumanReviewStatus) MarshalJSON() ([]byte, error) } // GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata: The -// long-running operation metadata for review document method. +// long-running operation metadata for the ReviewDocument method. type GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -2159,7 +2247,7 @@ func (s *GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata) MarshalJSON() ( } // GoogleCloudDocumentaiV1ReviewDocumentResponse: Response message for -// review document method. +// the ReviewDocument method. type GoogleCloudDocumentaiV1ReviewDocumentResponse struct { // GcsDestination: The Cloud Storage uri for the human reviewed document // if the review is succeeded. @@ -2202,7 +2290,7 @@ func (s *GoogleCloudDocumentaiV1ReviewDocumentResponse) MarshalJSON() ([]byte, e } // GoogleCloudDocumentaiV1SetDefaultProcessorVersionMetadata: The -// long-running operation metadata for set default processor version +// long-running operation metadata for the SetDefaultProcessorVersion // method. type GoogleCloudDocumentaiV1SetDefaultProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -2233,7 +2321,7 @@ func (s *GoogleCloudDocumentaiV1SetDefaultProcessorVersionMetadata) MarshalJSON( } // GoogleCloudDocumentaiV1SetDefaultProcessorVersionResponse: Response -// message for set default processor version method. +// message for the SetDefaultProcessorVersion method. type GoogleCloudDocumentaiV1SetDefaultProcessorVersionResponse struct { } @@ -2352,7 +2440,7 @@ func (s *GoogleCloudDocumentaiV1TrainProcessorVersionResponse) MarshalJSON() ([] } // GoogleCloudDocumentaiV1UndeployProcessorVersionMetadata: The -// long-running operation metadata for the undeploy processor version +// long-running operation metadata for the UndeployProcessorVersion // method. type GoogleCloudDocumentaiV1UndeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -2383,7 +2471,7 @@ func (s *GoogleCloudDocumentaiV1UndeployProcessorVersionMetadata) MarshalJSON() } // GoogleCloudDocumentaiV1UndeployProcessorVersionResponse: Response -// message for the undeploy processor version method. +// message for the UndeployProcessorVersion method. type GoogleCloudDocumentaiV1UndeployProcessorVersionResponse struct { } @@ -2550,8 +2638,8 @@ type GoogleCloudDocumentaiV1beta1Document struct { // Uri: Optional. Currently supports Google Cloud Storage URI of the // form `gs://bucket_name/object_name`. Object versioning is not - // supported. See Google Cloud Storage Request URIs - // (https://cloud.google.com/storage/docs/reference-uris) for more info. + // supported. For more information, refer to Google Cloud Storage + // Request URIs (https://cloud.google.com/storage/docs/reference-uris). Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -3737,17 +3825,18 @@ type GoogleCloudDocumentaiV1beta1DocumentPageTokenStyleInfo struct { // BackgroundColor: Color of the background. BackgroundColor *GoogleTypeColor `json:"backgroundColor,omitempty"` - // Bold: Whether the text is bold (equivalent to font weight >= 700). + // Bold: Whether the text is bold (equivalent to font_weight is at least + // `700`). Bold bool `json:"bold,omitempty"` - // FontSize: Font size in points (1 point is 1/72"). + // FontSize: Font size in points (`1` point is `¹⁄₇₂` inches). FontSize int64 `json:"fontSize,omitempty"` // FontType: Name or style of the font. FontType string `json:"fontType,omitempty"` - // FontWeight: TrueType weight on a scale 100 (Thin) to 1000 - // (Ultra-heavy). Normal is 400, Bold is 700. + // FontWeight: TrueType weight on a scale `100` (thin) to `1000` + // (ultra-heavy). Normal is `400`, bold is `700`. FontWeight int64 `json:"fontWeight,omitempty"` // Handwritten: Whether the text is handwritten. @@ -3759,11 +3848,11 @@ type GoogleCloudDocumentaiV1beta1DocumentPageTokenStyleInfo struct { // LetterSpacing: Letter spacing in points. LetterSpacing float64 `json:"letterSpacing,omitempty"` - // PixelFontSize: Font size in pixels, equal to unrounded_fontsize * - // resolution / 72.0. + // PixelFontSize: Font size in pixels, equal to _unrounded font_size_ * + // _resolution_ ÷ `72.0`. PixelFontSize float64 `json:"pixelFontSize,omitempty"` - // Smallcaps: Whether the text are small caps. + // Smallcaps: Whether the text is in small caps. Smallcaps bool `json:"smallcaps,omitempty"` // Strikeout: Whether the text is strikethrough. @@ -4760,8 +4849,8 @@ type GoogleCloudDocumentaiV1beta2Document struct { // Uri: Optional. Currently supports Google Cloud Storage URI of the // form `gs://bucket_name/object_name`. Object versioning is not - // supported. See Google Cloud Storage Request URIs - // (https://cloud.google.com/storage/docs/reference-uris) for more info. + // supported. For more information, refer to Google Cloud Storage + // Request URIs (https://cloud.google.com/storage/docs/reference-uris). Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -6002,17 +6091,18 @@ type GoogleCloudDocumentaiV1beta2DocumentPageTokenStyleInfo struct { // BackgroundColor: Color of the background. BackgroundColor *GoogleTypeColor `json:"backgroundColor,omitempty"` - // Bold: Whether the text is bold (equivalent to font weight >= 700). + // Bold: Whether the text is bold (equivalent to font_weight is at least + // `700`). Bold bool `json:"bold,omitempty"` - // FontSize: Font size in points (1 point is 1/72"). + // FontSize: Font size in points (`1` point is `¹⁄₇₂` inches). FontSize int64 `json:"fontSize,omitempty"` // FontType: Name or style of the font. FontType string `json:"fontType,omitempty"` - // FontWeight: TrueType weight on a scale 100 (Thin) to 1000 - // (Ultra-heavy). Normal is 400, Bold is 700. + // FontWeight: TrueType weight on a scale `100` (thin) to `1000` + // (ultra-heavy). Normal is `400`, bold is `700`. FontWeight int64 `json:"fontWeight,omitempty"` // Handwritten: Whether the text is handwritten. @@ -6024,11 +6114,11 @@ type GoogleCloudDocumentaiV1beta2DocumentPageTokenStyleInfo struct { // LetterSpacing: Letter spacing in points. LetterSpacing float64 `json:"letterSpacing,omitempty"` - // PixelFontSize: Font size in pixels, equal to unrounded_fontsize * - // resolution / 72.0. + // PixelFontSize: Font size in pixels, equal to _unrounded font_size_ * + // _resolution_ ÷ `72.0`. PixelFontSize float64 `json:"pixelFontSize,omitempty"` - // Smallcaps: Whether the text are small caps. + // Smallcaps: Whether the text is in small caps. Smallcaps bool `json:"smallcaps,omitempty"` // Strikeout: Whether the text is strikethrough. @@ -7007,7 +7097,7 @@ type GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus str // HumanReviewOperation: The name of the operation triggered by the // processed document. If the human review process isn't triggered, this // field will be empty. It has the same response type and metadata as - // the long-running operation returned by ReviewDocument method. + // the long-running operation returned by the ReviewDocument method. HumanReviewOperation string `json:"humanReviewOperation,omitempty"` // HumanReviewStatus: The status of human review on the processed @@ -7015,15 +7105,12 @@ type GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus str HumanReviewStatus *GoogleCloudDocumentaiV1beta3HumanReviewStatus `json:"humanReviewStatus,omitempty"` // InputGcsSource: The source of the document, same as the - // [input_gcs_source] field in the request when the batch process - // started. The batch process is started by take snapshot of that - // document, since a user can move or change that document during the - // process. + // input_gcs_source field in the request when the batch process started. InputGcsSource string `json:"inputGcsSource,omitempty"` - // OutputGcsDestination: The output_gcs_destination (in the request as - // `output_gcs_destination`) of the processed document if it was - // successful, otherwise empty. + // OutputGcsDestination: The Cloud Storage output destination (in the + // request as DocumentOutputConfig.GcsOutputConfig.gcs_uri) of the + // processed document if it was successful, otherwise empty. OutputGcsDestination string `json:"outputGcsDestination,omitempty"` // Status: The status processing the document. @@ -7057,14 +7144,16 @@ func (s *GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus // GoogleCloudDocumentaiV1beta3BatchProcessRequest: Request message for // BatchProcessDocuments. type GoogleCloudDocumentaiV1beta3BatchProcessRequest struct { - // DocumentOutputConfig: The overall output config for batch process. + // DocumentOutputConfig: The output configuration for the + // BatchProcessDocuments method. DocumentOutputConfig *GoogleCloudDocumentaiV1beta3DocumentOutputConfig `json:"documentOutputConfig,omitempty"` // InputConfigs: The input config for each single document in the batch // process. InputConfigs []*GoogleCloudDocumentaiV1beta3BatchProcessRequestBatchInputConfig `json:"inputConfigs,omitempty"` - // InputDocuments: The input documents for batch process. + // InputDocuments: The input documents for the BatchProcessDocuments + // method. InputDocuments *GoogleCloudDocumentaiV1beta3BatchDocumentsInputConfig `json:"inputDocuments,omitempty"` // OutputConfig: The overall output config for batch process. @@ -7108,10 +7197,11 @@ type GoogleCloudDocumentaiV1beta3BatchProcessRequestBatchInputConfig struct { // GcsSource: The Cloud Storage location as the source of the document. GcsSource string `json:"gcsSource,omitempty"` - // MimeType: Mimetype of the input. If the input is a raw document, the - // supported mimetypes are application/pdf, image/tiff, and image/gif. - // If the input is a Document proto, the type should be - // application/json. + // MimeType: Media type (MIME type) of the input. If the input is a raw + // document, refer to supported file types + // (https://cloud.google.com/document-ai/docs/file-types) for the list + // of media types. If the input is a Document, the type should be + // `application/json`. MimeType string `json:"mimeType,omitempty"` // ForceSendFields is a list of field names (e.g. "GcsSource") to @@ -7138,7 +7228,7 @@ func (s *GoogleCloudDocumentaiV1beta3BatchProcessRequestBatchInputConfig) Marsha } // GoogleCloudDocumentaiV1beta3BatchProcessRequestBatchOutputConfig: The -// message for output config in batch process. +// output configuration in the BatchProcessDocuments method. type GoogleCloudDocumentaiV1beta3BatchProcessRequestBatchOutputConfig struct { // GcsDestination: The output Cloud Storage directory to put the // processed documents. @@ -7257,7 +7347,7 @@ func (s *GoogleCloudDocumentaiV1beta3CommonOperationMetadata) MarshalJSON() ([]b } // GoogleCloudDocumentaiV1beta3DeleteProcessorMetadata: The long-running -// operation metadata for delete processor method. +// operation metadata for the DeleteProcessor method. type GoogleCloudDocumentaiV1beta3DeleteProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -7287,7 +7377,8 @@ func (s *GoogleCloudDocumentaiV1beta3DeleteProcessorMetadata) MarshalJSON() ([]b } // GoogleCloudDocumentaiV1beta3DeleteProcessorVersionMetadata: The -// long-running operation metadata for delete processor version method. +// long-running operation metadata for the DeleteProcessorVersion +// method. type GoogleCloudDocumentaiV1beta3DeleteProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -7317,7 +7408,8 @@ func (s *GoogleCloudDocumentaiV1beta3DeleteProcessorVersionMetadata) MarshalJSON } // GoogleCloudDocumentaiV1beta3DeployProcessorVersionMetadata: The -// long-running operation metadata for deploy processor version method. +// long-running operation metadata for the DeployProcessorVersion +// method. type GoogleCloudDocumentaiV1beta3DeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -7347,17 +7439,17 @@ func (s *GoogleCloudDocumentaiV1beta3DeployProcessorVersionMetadata) MarshalJSON } // GoogleCloudDocumentaiV1beta3DeployProcessorVersionRequest: Request -// message for the deploy processor version method. +// message for the DeployProcessorVersion method. type GoogleCloudDocumentaiV1beta3DeployProcessorVersionRequest struct { } // GoogleCloudDocumentaiV1beta3DeployProcessorVersionResponse: Response -// message for the deploy processor version method. +// message for the DeployProcessorVersion method. type GoogleCloudDocumentaiV1beta3DeployProcessorVersionResponse struct { } // GoogleCloudDocumentaiV1beta3DisableProcessorMetadata: The -// long-running operation metadata for disable processor method. +// long-running operation metadata for the DisableProcessor method. type GoogleCloudDocumentaiV1beta3DisableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -7387,12 +7479,12 @@ func (s *GoogleCloudDocumentaiV1beta3DisableProcessorMetadata) MarshalJSON() ([] } // GoogleCloudDocumentaiV1beta3DisableProcessorRequest: Request message -// for the disable processor method. +// for the DisableProcessor method. type GoogleCloudDocumentaiV1beta3DisableProcessorRequest struct { } // GoogleCloudDocumentaiV1beta3DisableProcessorResponse: Response -// message for the disable processor method. Intentionally empty proto +// message for the DisableProcessor method. Intentionally empty proto // for adding fields in future. type GoogleCloudDocumentaiV1beta3DisableProcessorResponse struct { } @@ -7449,8 +7541,8 @@ type GoogleCloudDocumentaiV1beta3Document struct { // Uri: Optional. Currently supports Google Cloud Storage URI of the // form `gs://bucket_name/object_name`. Object versioning is not - // supported. See Google Cloud Storage Request URIs - // (https://cloud.google.com/storage/docs/reference-uris) for more info. + // supported. For more information, refer to Google Cloud Storage + // Request URIs (https://cloud.google.com/storage/docs/reference-uris). Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Content") to @@ -8738,17 +8830,18 @@ type GoogleCloudDocumentaiV1beta3DocumentPageTokenStyleInfo struct { // BackgroundColor: Color of the background. BackgroundColor *GoogleTypeColor `json:"backgroundColor,omitempty"` - // Bold: Whether the text is bold (equivalent to font weight >= 700). + // Bold: Whether the text is bold (equivalent to font_weight is at least + // `700`). Bold bool `json:"bold,omitempty"` - // FontSize: Font size in points (1 point is 1/72"). + // FontSize: Font size in points (`1` point is `¹⁄₇₂` inches). FontSize int64 `json:"fontSize,omitempty"` // FontType: Name or style of the font. FontType string `json:"fontType,omitempty"` - // FontWeight: TrueType weight on a scale 100 (Thin) to 1000 - // (Ultra-heavy). Normal is 400, Bold is 700. + // FontWeight: TrueType weight on a scale `100` (thin) to `1000` + // (ultra-heavy). Normal is `400`, bold is `700`. FontWeight int64 `json:"fontWeight,omitempty"` // Handwritten: Whether the text is handwritten. @@ -8760,11 +8853,11 @@ type GoogleCloudDocumentaiV1beta3DocumentPageTokenStyleInfo struct { // LetterSpacing: Letter spacing in points. LetterSpacing float64 `json:"letterSpacing,omitempty"` - // PixelFontSize: Font size in pixels, equal to unrounded_fontsize * - // resolution / 72.0. + // PixelFontSize: Font size in pixels, equal to _unrounded font_size_ * + // _resolution_ ÷ `72.0`. PixelFontSize float64 `json:"pixelFontSize,omitempty"` - // Smallcaps: Whether the text are small caps. + // Smallcaps: Whether the text is in small caps. Smallcaps bool `json:"smallcaps,omitempty"` // Strikeout: Whether the text is strikethrough. @@ -9514,7 +9607,7 @@ func (s *GoogleCloudDocumentaiV1beta3DocumentTextChange) MarshalJSON() ([]byte, } // GoogleCloudDocumentaiV1beta3EnableProcessorMetadata: The long-running -// operation metadata for enable processor method. +// operation metadata for the EnableProcessor method. type GoogleCloudDocumentaiV1beta3EnableProcessorMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -9544,12 +9637,12 @@ func (s *GoogleCloudDocumentaiV1beta3EnableProcessorMetadata) MarshalJSON() ([]b } // GoogleCloudDocumentaiV1beta3EnableProcessorRequest: Request message -// for the enable processor method. +// for the EnableProcessor method. type GoogleCloudDocumentaiV1beta3EnableProcessorRequest struct { } // GoogleCloudDocumentaiV1beta3EnableProcessorResponse: Response message -// for the enable processor method. Intentionally empty proto for adding +// for the EnableProcessor method. Intentionally empty proto for adding // fields in future. type GoogleCloudDocumentaiV1beta3EnableProcessorResponse struct { } @@ -9998,7 +10091,7 @@ func (s *GoogleCloudDocumentaiV1beta3EvaluationReference) MarshalJSON() ([]byte, } // GoogleCloudDocumentaiV1beta3FetchProcessorTypesResponse: Response -// message for fetch processor types. +// message for the FetchProcessorTypes method. type GoogleCloudDocumentaiV1beta3FetchProcessorTypesResponse struct { // ProcessorTypes: The list of processor types. ProcessorTypes []*GoogleCloudDocumentaiV1beta3ProcessorType `json:"processorTypes,omitempty"` @@ -10207,17 +10300,19 @@ func (s *GoogleCloudDocumentaiV1beta3ImportProcessorVersionMetadata) MarshalJSON } // GoogleCloudDocumentaiV1beta3ImportProcessorVersionRequest: The -// request message for the `ImportProcessorVersion` method. This method -// requires the source processor version and destination processor to be -// in the same location. This method requires the Document AI Service -// Agent of the destination project to have Document AI Editor role +// request message for the ImportProcessorVersion method. Requirements: +// - The source processor version and destination processor must be in +// the same location. - The Document AI Service Agent +// (https://cloud.google.com/iam/docs/service-agents) of the destination +// project must have Document AI Editor role // (https://cloud.google.com/document-ai/docs/access-control/iam-roles) // on the source project. The destination project is specified as part -// of the `parent` field. The source project is specified as part of -// `source` field. The Service Agent for Document AI can be found in -// https://cloud.google.com/iam/docs/service-agents. +// of the parent field. The source project is specified as part of the +// source field. type GoogleCloudDocumentaiV1beta3ImportProcessorVersionRequest struct { // ProcessorVersionSource: The source processor version to import from. + // The source processor version and destination processor need to be in + // the same environment and region. ProcessorVersionSource string `json:"processorVersionSource,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -10314,7 +10409,7 @@ func (s *GoogleCloudDocumentaiV1beta3ListEvaluationsResponse) MarshalJSON() ([]b } // GoogleCloudDocumentaiV1beta3ListProcessorTypesResponse: Response -// message for list processor types. +// message for the ListProcessorTypes method. type GoogleCloudDocumentaiV1beta3ListProcessorTypesResponse struct { // NextPageToken: Points to the next page, otherwise empty. NextPageToken string `json:"nextPageToken,omitempty"` @@ -10350,7 +10445,7 @@ func (s *GoogleCloudDocumentaiV1beta3ListProcessorTypesResponse) MarshalJSON() ( } // GoogleCloudDocumentaiV1beta3ListProcessorVersionsResponse: Response -// message for list processors. +// message for the ListProcessorVersions method. type GoogleCloudDocumentaiV1beta3ListProcessorVersionsResponse struct { // NextPageToken: Points to the next processor, otherwise empty. NextPageToken string `json:"nextPageToken,omitempty"` @@ -10386,7 +10481,7 @@ func (s *GoogleCloudDocumentaiV1beta3ListProcessorVersionsResponse) MarshalJSON( } // GoogleCloudDocumentaiV1beta3ListProcessorsResponse: Response message -// for list processors. +// for the ListProcessors method. type GoogleCloudDocumentaiV1beta3ListProcessorsResponse struct { // NextPageToken: Points to the next processor, otherwise empty. NextPageToken string `json:"nextPageToken,omitempty"` @@ -10589,15 +10684,15 @@ func (s *GoogleCloudDocumentaiV1beta3ProcessOptions) MarshalJSON() ([]byte, erro } // GoogleCloudDocumentaiV1beta3ProcessRequest: Request message for the -// process document method. +// ProcessDocument method. type GoogleCloudDocumentaiV1beta3ProcessRequest struct { - // Document: The document payload, the [content] and [mime_type] fields - // must be set. + // Document: The document payload, the content and mime_type fields must + // be set. Document *GoogleCloudDocumentaiV1beta3Document `json:"document,omitempty"` - // FieldMask: Specifies which fields to include in the `ProcessResponse` - // Document. Only supports top level document and pages field so it must - // be in the form of `{document_field_name}` or + // FieldMask: Specifies which fields to include in the + // ProcessResponse.document output. Only supports top-level document and + // pages field, so it must be in the form of `{document_field_name}` or // `pages.{page_field_name}`. FieldMask string `json:"fieldMask,omitempty"` @@ -10638,7 +10733,7 @@ func (s *GoogleCloudDocumentaiV1beta3ProcessRequest) MarshalJSON() ([]byte, erro } // GoogleCloudDocumentaiV1beta3ProcessResponse: Response message for the -// process document method. +// ProcessDocument method. type GoogleCloudDocumentaiV1beta3ProcessResponse struct { // Document: The document payload, will populate fields based on the // processor's behavior. @@ -11040,7 +11135,7 @@ func (s *GoogleCloudDocumentaiV1beta3RawDocument) MarshalJSON() ([]byte, error) } // GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata: The -// long-running operation metadata for review document method. +// long-running operation metadata for the ReviewDocument method. type GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. CommonMetadata *GoogleCloudDocumentaiV1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` @@ -11095,7 +11190,7 @@ func (s *GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata) MarshalJSO } // GoogleCloudDocumentaiV1beta3ReviewDocumentRequest: Request message -// for review document method. +// for the ReviewDocument method. type GoogleCloudDocumentaiV1beta3ReviewDocumentRequest struct { // Document: The document that needs human review. Document *GoogleCloudDocumentaiV1beta3Document `json:"document,omitempty"` @@ -11143,7 +11238,7 @@ func (s *GoogleCloudDocumentaiV1beta3ReviewDocumentRequest) MarshalJSON() ([]byt } // GoogleCloudDocumentaiV1beta3ReviewDocumentResponse: Response message -// for review document method. +// for the ReviewDocument method. type GoogleCloudDocumentaiV1beta3ReviewDocumentResponse struct { // GcsDestination: The Cloud Storage uri for the human reviewed document // if the review is succeeded. @@ -11186,7 +11281,7 @@ func (s *GoogleCloudDocumentaiV1beta3ReviewDocumentResponse) MarshalJSON() ([]by } // GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionMetadata: The -// long-running operation metadata for set default processor version +// long-running operation metadata for the SetDefaultProcessorVersion // method. type GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -11217,7 +11312,7 @@ func (s *GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionMetadata) Marshal } // GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionRequest: -// Request message for the set default processor version method. +// Request message for the SetDefaultProcessorVersion method. type GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionRequest struct { // DefaultProcessorVersion: Required. The resource name of child // ProcessorVersion to use as default. Format: @@ -11251,7 +11346,7 @@ func (s *GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionRequest) MarshalJ } // GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionResponse: -// Response message for set default processor version method. +// Response message for the SetDefaultProcessorVersion method. type GoogleCloudDocumentaiV1beta3SetDefaultProcessorVersionResponse struct { } @@ -11337,7 +11432,7 @@ func (s *GoogleCloudDocumentaiV1beta3TrainProcessorVersionMetadataDatasetValidat } // GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequest: Request -// message for the create processor version method. +// message for the TrainProcessorVersion method. type GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequest struct { // BaseProcessorVersion: Optional. The processor version to use as a // base for training. This processor version must be a child of @@ -11351,7 +11446,7 @@ type GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequest struct { DocumentSchema *GoogleCloudDocumentaiV1beta3DocumentSchema `json:"documentSchema,omitempty"` // InputData: Optional. The input data used to train the - // `ProcessorVersion`. + // ProcessorVersion. InputData *GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequestInputData `json:"inputData,omitempty"` // ProcessorVersion: Required. The processor version to be created. @@ -11383,7 +11478,7 @@ func (s *GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequest) MarshalJSON() } // GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequestInputData: -// The input data used to train a new `ProcessorVersion`. +// The input data used to train a new ProcessorVersion. type GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequestInputData struct { // TestDocuments: The documents used for testing the trained version. TestDocuments *GoogleCloudDocumentaiV1beta3BatchDocumentsInputConfig `json:"testDocuments,omitempty"` @@ -11446,7 +11541,7 @@ func (s *GoogleCloudDocumentaiV1beta3TrainProcessorVersionResponse) MarshalJSON( } // GoogleCloudDocumentaiV1beta3UndeployProcessorVersionMetadata: The -// long-running operation metadata for the undeploy processor version +// long-running operation metadata for the UndeployProcessorVersion // method. type GoogleCloudDocumentaiV1beta3UndeployProcessorVersionMetadata struct { // CommonMetadata: The basic metadata of the long-running operation. @@ -11477,12 +11572,12 @@ func (s *GoogleCloudDocumentaiV1beta3UndeployProcessorVersionMetadata) MarshalJS } // GoogleCloudDocumentaiV1beta3UndeployProcessorVersionRequest: Request -// message for the undeploy processor version method. +// message for the UndeployProcessorVersion method. type GoogleCloudDocumentaiV1beta3UndeployProcessorVersionRequest struct { } // GoogleCloudDocumentaiV1beta3UndeployProcessorVersionResponse: -// Response message for the undeploy processor version method. +// Response message for the UndeployProcessorVersion method. type GoogleCloudDocumentaiV1beta3UndeployProcessorVersionResponse struct { } @@ -12217,9 +12312,8 @@ type ProjectsLocationsFetchProcessorTypesCall struct { // FetchProcessorTypes: Fetches processor types. Note that we don't use // ListProcessorTypes here, because it isn't paginated. // -// - parent: The project of processor type to list. The available -// processor types may depend on the allow-listing on projects. -// Format: `projects/{project}/locations/{location}`. +// - parent: The location of processor types to list. Format: +// `projects/{project}/locations/{location}`. func (r *ProjectsLocationsService) FetchProcessorTypes(parent string) *ProjectsLocationsFetchProcessorTypesCall { c := &ProjectsLocationsFetchProcessorTypesCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -12337,7 +12431,7 @@ func (c *ProjectsLocationsFetchProcessorTypesCall) Do(opts ...googleapi.CallOpti // ], // "parameters": { // "parent": { - // "description": "Required. The project of processor type to list. The available processor types may depend on the allow-listing on projects. Format: `projects/{project}/locations/{location}`", + // "description": "Required. The location of processor types to list. Format: `projects/{project}/locations/{location}`.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, @@ -13369,9 +13463,8 @@ type ProjectsLocationsProcessorTypesListCall struct { // List: Lists the processor types that exist. // -// - parent: The location of processor type to list. The available -// processor types may depend on the allow-listing on projects. -// Format: `projects/{project}/locations/{location}`. +// - parent: The location of processor types to list. Format: +// `projects/{project}/locations/{location}`. func (r *ProjectsLocationsProcessorTypesService) List(parent string) *ProjectsLocationsProcessorTypesListCall { c := &ProjectsLocationsProcessorTypesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -13379,9 +13472,9 @@ func (r *ProjectsLocationsProcessorTypesService) List(parent string) *ProjectsLo } // PageSize sets the optional parameter "pageSize": The maximum number -// of processor types to return. If unspecified, at most 100 processor -// types will be returned. The maximum value is 500; values above 500 -// will be coerced to 500. +// of processor types to return. If unspecified, at most `100` processor +// types will be returned. The maximum value is `500`. Values above +// `500` will be coerced to `500`. func (c *ProjectsLocationsProcessorTypesListCall) PageSize(pageSize int64) *ProjectsLocationsProcessorTypesListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c @@ -13505,7 +13598,7 @@ func (c *ProjectsLocationsProcessorTypesListCall) Do(opts ...googleapi.CallOptio // ], // "parameters": { // "pageSize": { - // "description": "The maximum number of processor types to return. If unspecified, at most 100 processor types will be returned. The maximum value is 500; values above 500 will be coerced to 500.", + // "description": "The maximum number of processor types to return. If unspecified, at most `100` processor types will be returned. The maximum value is `500`. Values above `500` will be coerced to `500`.", // "format": "int32", // "location": "query", // "type": "integer" @@ -13516,7 +13609,7 @@ func (c *ProjectsLocationsProcessorTypesListCall) Do(opts ...googleapi.CallOptio // "type": "string" // }, // "parent": { - // "description": "Required. The location of processor type to list. The available processor types may depend on the allow-listing on projects. Format: `projects/{project}/locations/{location}`", + // "description": "Required. The location of processor types to list. Format: `projects/{project}/locations/{location}`.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, @@ -13713,9 +13806,8 @@ type ProjectsLocationsProcessorsCreateCall struct { header_ http.Header } -// Create: Creates a processor from the type processor that the user -// chose. The processor will be at "ENABLED" state by default after its -// creation. +// Create: Creates a processor from the ProcessorType provided. The +// processor will be at `ENABLED` state by default after its creation. // // - parent: The parent (project and location) under which to create the // processor. Format: `projects/{project}/locations/{location}`. @@ -13818,7 +13910,7 @@ func (c *ProjectsLocationsProcessorsCreateCall) Do(opts ...googleapi.CallOption) } return ret, nil // { - // "description": "Creates a processor from the type processor that the user chose. The processor will be at \"ENABLED\" state by default after its creation.", + // "description": "Creates a processor from the ProcessorType provided. The processor will be at `ENABLED` state by default after its creation.", // "flatPath": "v1beta3/projects/{projectsId}/locations/{locationsId}/processors", // "httpMethod": "POST", // "id": "documentai.projects.locations.processors.create", @@ -14436,9 +14528,9 @@ func (r *ProjectsLocationsProcessorsService) List(parent string) *ProjectsLocati } // PageSize sets the optional parameter "pageSize": The maximum number -// of processors to return. If unspecified, at most 50 processors will -// be returned. The maximum value is 100; values above 100 will be -// coerced to 100. +// of processors to return. If unspecified, at most `50` processors will +// be returned. The maximum value is `100`. Values above `100` will be +// coerced to `100`. func (c *ProjectsLocationsProcessorsListCall) PageSize(pageSize int64) *ProjectsLocationsProcessorsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c @@ -14562,7 +14654,7 @@ func (c *ProjectsLocationsProcessorsListCall) Do(opts ...googleapi.CallOption) ( // ], // "parameters": { // "pageSize": { - // "description": "The maximum number of processors to return. If unspecified, at most 50 processors will be returned. The maximum value is 100; values above 100 will be coerced to 100.", + // "description": "The maximum number of processors to return. If unspecified, at most `50` processors will be returned. The maximum value is `100`. Values above `100` will be coerced to `100`.", // "format": "int32", // "location": "query", // "type": "integer" @@ -15935,9 +16027,9 @@ func (r *ProjectsLocationsProcessorsProcessorVersionsService) List(parent string } // PageSize sets the optional parameter "pageSize": The maximum number -// of processor versions to return. If unspecified, at most 10 processor -// versions will be returned. The maximum value is 20; values above 20 -// will be coerced to 20. +// of processor versions to return. If unspecified, at most `10` +// processor versions will be returned. The maximum value is `20`. +// Values above `20` will be coerced to `20`. func (c *ProjectsLocationsProcessorsProcessorVersionsListCall) PageSize(pageSize int64) *ProjectsLocationsProcessorsProcessorVersionsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c @@ -16062,7 +16154,7 @@ func (c *ProjectsLocationsProcessorsProcessorVersionsListCall) Do(opts ...google // ], // "parameters": { // "pageSize": { - // "description": "The maximum number of processor versions to return. If unspecified, at most 10 processor versions will be returned. The maximum value is 20; values above 20 will be coerced to 20.", + // "description": "The maximum number of processor versions to return. If unspecified, at most `10` processor versions will be returned. The maximum value is `20`. Values above `20` will be coerced to `20`.", // "format": "int32", // "location": "query", // "type": "integer" @@ -16274,7 +16366,7 @@ type ProjectsLocationsProcessorsProcessorVersionsTrainCall struct { } // Train: Trains a new processor version. Operation metadata is returned -// as cloud_documentai_core.TrainProcessorVersionMetadata. +// as TrainProcessorVersionMetadata. // // - parent: The parent (project, location and processor) to create the // new version for. Format: @@ -16377,7 +16469,7 @@ func (c *ProjectsLocationsProcessorsProcessorVersionsTrainCall) Do(opts ...googl } return ret, nil // { - // "description": "Trains a new processor version. Operation metadata is returned as cloud_documentai_core.TrainProcessorVersionMetadata.", + // "description": "Trains a new processor version. Operation metadata is returned as TrainProcessorVersionMetadata.", // "flatPath": "v1beta3/projects/{projectsId}/locations/{locationsId}/processors/{processorsId}/processorVersions:train", // "httpMethod": "POST", // "id": "documentai.projects.locations.processors.processorVersions.train", @@ -16722,9 +16814,8 @@ func (r *ProjectsLocationsProcessorsProcessorVersionsEvaluationsService) List(pa } // PageSize sets the optional parameter "pageSize": The standard list -// page size. If unspecified, at most `5` evaluations will be returned. -// The maximum value is `100`; values above `100` will be coerced to -// `100`. +// page size. If unspecified, at most `5` evaluations are returned. The +// maximum value is `100`. Values above `100` are coerced to `100`. func (c *ProjectsLocationsProcessorsProcessorVersionsEvaluationsListCall) PageSize(pageSize int64) *ProjectsLocationsProcessorsProcessorVersionsEvaluationsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c @@ -16848,7 +16939,7 @@ func (c *ProjectsLocationsProcessorsProcessorVersionsEvaluationsListCall) Do(opt // ], // "parameters": { // "pageSize": { - // "description": "The standard list page size. If unspecified, at most `5` evaluations will be returned. The maximum value is `100`; values above `100` will be coerced to `100`.", + // "description": "The standard list page size. If unspecified, at most `5` evaluations are returned. The maximum value is `100`. Values above `100` are coerced to `100`.", // "format": "int32", // "location": "query", // "type": "integer" diff --git a/domains/v1/domains-api.json b/domains/v1/domains-api.json index a9e1a8bcb7b..7e7da245638 100644 --- a/domains/v1/domains-api.json +++ b/domains/v1/domains-api.json @@ -843,7 +843,7 @@ } } }, - "revision": "20230315", + "revision": "20230419", "rootUrl": "https://domains.googleapis.com/", "schemas": { "AuditConfig": { @@ -1376,7 +1376,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/domains/v1/domains-gen.go b/domains/v1/domains-gen.go index 49ec0636b88..9a0f0e586f2 100644 --- a/domains/v1/domains-gen.go +++ b/domains/v1/domains-gen.go @@ -1129,7 +1129,7 @@ func (s *ListRegistrationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/domains/v1alpha2/domains-api.json b/domains/v1alpha2/domains-api.json index 8bca7ffe29d..59efc592f58 100644 --- a/domains/v1alpha2/domains-api.json +++ b/domains/v1alpha2/domains-api.json @@ -843,7 +843,7 @@ } } }, - "revision": "20230315", + "revision": "20230419", "rootUrl": "https://domains.googleapis.com/", "schemas": { "AuditConfig": { @@ -1376,7 +1376,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/domains/v1alpha2/domains-gen.go b/domains/v1alpha2/domains-gen.go index 573085ece69..91888b38e23 100644 --- a/domains/v1alpha2/domains-gen.go +++ b/domains/v1alpha2/domains-gen.go @@ -1129,7 +1129,7 @@ func (s *ListRegistrationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/domains/v1beta1/domains-api.json b/domains/v1beta1/domains-api.json index ef667ffb870..8be03764544 100644 --- a/domains/v1beta1/domains-api.json +++ b/domains/v1beta1/domains-api.json @@ -843,7 +843,7 @@ } } }, - "revision": "20230315", + "revision": "20230419", "rootUrl": "https://domains.googleapis.com/", "schemas": { "AuditConfig": { @@ -1376,7 +1376,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/domains/v1beta1/domains-gen.go b/domains/v1beta1/domains-gen.go index 4b5fa7c8476..a3c78f38cd5 100644 --- a/domains/v1beta1/domains-gen.go +++ b/domains/v1beta1/domains-gen.go @@ -1129,7 +1129,7 @@ func (s *ListRegistrationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/drivelabels/v2/drivelabels-api.json b/drivelabels/v2/drivelabels-api.json index 102234e4efd..d99e47df974 100644 --- a/drivelabels/v2/drivelabels-api.json +++ b/drivelabels/v2/drivelabels-api.json @@ -898,7 +898,7 @@ } } }, - "revision": "20230327", + "revision": "20230428", "rootUrl": "https://drivelabels.googleapis.com/", "schemas": { "GoogleAppsDriveLabelsV2BadgeColors": { @@ -2186,12 +2186,14 @@ "enum": [ "LABEL_TYPE_UNSPECIFIED", "SHARED", - "ADMIN" + "ADMIN", + "GOOGLE_APP" ], "enumDescriptions": [ "Unknown label type.", "Shared labels may be shared with users to apply to Drive items.", - "Admin-owned label. Only creatable and editable by admins. Supports some additional admin-only features." + "Admin-owned label. Only creatable and editable by admins. Supports some additional admin-only features.", + "A label owned by an internal Google application rather than a customer. These labels are read-only." ], "type": "string" }, diff --git a/drivelabels/v2/drivelabels-gen.go b/drivelabels/v2/drivelabels-gen.go index e78b39f919d..524637c2825 100644 --- a/drivelabels/v2/drivelabels-gen.go +++ b/drivelabels/v2/drivelabels-gen.go @@ -2256,6 +2256,8 @@ type GoogleAppsDriveLabelsV2Label struct { // items. // "ADMIN" - Admin-owned label. Only creatable and editable by admins. // Supports some additional admin-only features. + // "GOOGLE_APP" - A label owned by an internal Google application + // rather than a customer. These labels are read-only. LabelType string `json:"labelType,omitempty"` // LearnMoreUri: Custom URL to present to users to allow them to learn diff --git a/drivelabels/v2beta/drivelabels-api.json b/drivelabels/v2beta/drivelabels-api.json index 87f02fb1c8c..0422246e0ed 100644 --- a/drivelabels/v2beta/drivelabels-api.json +++ b/drivelabels/v2beta/drivelabels-api.json @@ -898,7 +898,7 @@ } } }, - "revision": "20230327", + "revision": "20230428", "rootUrl": "https://drivelabels.googleapis.com/", "schemas": { "GoogleAppsDriveLabelsV2betaBadgeColors": { @@ -2186,12 +2186,14 @@ "enum": [ "LABEL_TYPE_UNSPECIFIED", "SHARED", - "ADMIN" + "ADMIN", + "GOOGLE_APP" ], "enumDescriptions": [ "Unknown label type.", "Shared labels may be shared with users to apply to Drive items.", - "Admin-owned label. Only creatable and editable by admins. Supports some additional admin-only features." + "Admin-owned label. Only creatable and editable by admins. Supports some additional admin-only features.", + "A label owned by an internal Google application rather than a customer. These labels are read-only." ], "type": "string" }, diff --git a/drivelabels/v2beta/drivelabels-gen.go b/drivelabels/v2beta/drivelabels-gen.go index 75094ee11f2..af0c02a9fba 100644 --- a/drivelabels/v2beta/drivelabels-gen.go +++ b/drivelabels/v2beta/drivelabels-gen.go @@ -2258,6 +2258,8 @@ type GoogleAppsDriveLabelsV2betaLabel struct { // items. // "ADMIN" - Admin-owned label. Only creatable and editable by admins. // Supports some additional admin-only features. + // "GOOGLE_APP" - A label owned by an internal Google application + // rather than a customer. These labels are read-only. LabelType string `json:"labelType,omitempty"` // LearnMoreUri: Custom URL to present to users to allow them to learn diff --git a/eventarc/v1/eventarc-api.json b/eventarc/v1/eventarc-api.json index 134b549aa21..bfc4e37fe27 100644 --- a/eventarc/v1/eventarc-api.json +++ b/eventarc/v1/eventarc-api.json @@ -470,7 +470,7 @@ "type": "string" }, "validateOnly": { - "description": "Required. If set, validate the request and preview the review, but do not post it.", + "description": "Optional. If set, validate the request and preview the review, but do not post it.", "location": "query", "type": "boolean" } @@ -503,7 +503,7 @@ "type": "string" }, "validateOnly": { - "description": "Required. If set, validate the request and preview the review, but do not post it.", + "description": "Optional. If set, validate the request and preview the review, but do not post it.", "location": "query", "type": "boolean" } @@ -636,7 +636,7 @@ "type": "string" }, "validateOnly": { - "description": "Required. If set, validate the request and preview the review, but do not post it.", + "description": "Optional. If set, validate the request and preview the review, but do not post it.", "location": "query", "type": "boolean" } @@ -932,7 +932,7 @@ "type": "string" }, "validateOnly": { - "description": "Required. If set, validate the request and preview the review, but do not post it.", + "description": "Optional. If set, validate the request and preview the review, but do not post it.", "location": "query", "type": "boolean" } @@ -975,7 +975,7 @@ "type": "string" }, "validateOnly": { - "description": "Required. If set, validate the request and preview the review, but do not post it.", + "description": "Optional. If set, validate the request and preview the review, but do not post it.", "location": "query", "type": "boolean" } @@ -1118,7 +1118,7 @@ "type": "string" }, "validateOnly": { - "description": "Required. If set, validate the request and preview the review, but do not post it.", + "description": "Optional. If set, validate the request and preview the review, but do not post it.", "location": "query", "type": "boolean" } @@ -1197,7 +1197,7 @@ } } }, - "revision": "20230331", + "revision": "20230428", "rootUrl": "https://eventarc.googleapis.com/", "schemas": { "AuditConfig": { @@ -1769,7 +1769,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/eventarc/v1/eventarc-gen.go b/eventarc/v1/eventarc-gen.go index e0e1b7f914b..9045de56491 100644 --- a/eventarc/v1/eventarc-gen.go +++ b/eventarc/v1/eventarc-gen.go @@ -1279,7 +1279,7 @@ func (s *ListTriggersResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -3716,8 +3716,8 @@ func (c *ProjectsLocationsChannelsCreateCall) ChannelId(channelId string) *Proje return c } -// ValidateOnly sets the optional parameter "validateOnly": Required. If -// set, validate the request and preview the review, but do not post it. +// ValidateOnly sets the optional parameter "validateOnly": If set, +// validate the request and preview the review, but do not post it. func (c *ProjectsLocationsChannelsCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsChannelsCreateCall { c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) return c @@ -3835,7 +3835,7 @@ func (c *ProjectsLocationsChannelsCreateCall) Do(opts ...googleapi.CallOption) ( // "type": "string" // }, // "validateOnly": { - // "description": "Required. If set, validate the request and preview the review, but do not post it.", + // "description": "Optional. If set, validate the request and preview the review, but do not post it.", // "location": "query", // "type": "boolean" // } @@ -3873,8 +3873,8 @@ func (r *ProjectsLocationsChannelsService) Delete(name string) *ProjectsLocation return c } -// ValidateOnly sets the optional parameter "validateOnly": Required. If -// set, validate the request and preview the review, but do not post it. +// ValidateOnly sets the optional parameter "validateOnly": If set, +// validate the request and preview the review, but do not post it. func (c *ProjectsLocationsChannelsDeleteCall) ValidateOnly(validateOnly bool) *ProjectsLocationsChannelsDeleteCall { c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) return c @@ -3982,7 +3982,7 @@ func (c *ProjectsLocationsChannelsDeleteCall) Do(opts ...googleapi.CallOption) ( // "type": "string" // }, // "validateOnly": { - // "description": "Required. If set, validate the request and preview the review, but do not post it.", + // "description": "Optional. If set, validate the request and preview the review, but do not post it.", // "location": "query", // "type": "boolean" // } @@ -4562,8 +4562,8 @@ func (c *ProjectsLocationsChannelsPatchCall) UpdateMask(updateMask string) *Proj return c } -// ValidateOnly sets the optional parameter "validateOnly": Required. If -// set, validate the request and preview the review, but do not post it. +// ValidateOnly sets the optional parameter "validateOnly": If set, +// validate the request and preview the review, but do not post it. func (c *ProjectsLocationsChannelsPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsChannelsPatchCall { c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) return c @@ -4682,7 +4682,7 @@ func (c *ProjectsLocationsChannelsPatchCall) Do(opts ...googleapi.CallOption) (* // "type": "string" // }, // "validateOnly": { - // "description": "Required. If set, validate the request and preview the review, but do not post it.", + // "description": "Optional. If set, validate the request and preview the review, but do not post it.", // "location": "query", // "type": "boolean" // } @@ -6035,8 +6035,8 @@ func (c *ProjectsLocationsTriggersCreateCall) TriggerId(triggerId string) *Proje return c } -// ValidateOnly sets the optional parameter "validateOnly": Required. If -// set, validate the request and preview the review, but do not post it. +// ValidateOnly sets the optional parameter "validateOnly": If set, +// validate the request and preview the review, but do not post it. func (c *ProjectsLocationsTriggersCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsTriggersCreateCall { c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) return c @@ -6154,7 +6154,7 @@ func (c *ProjectsLocationsTriggersCreateCall) Do(opts ...googleapi.CallOption) ( // "type": "string" // }, // "validateOnly": { - // "description": "Required. If set, validate the request and preview the review, but do not post it.", + // "description": "Optional. If set, validate the request and preview the review, but do not post it.", // "location": "query", // "type": "boolean" // } @@ -6208,8 +6208,8 @@ func (c *ProjectsLocationsTriggersDeleteCall) Etag(etag string) *ProjectsLocatio return c } -// ValidateOnly sets the optional parameter "validateOnly": Required. If -// set, validate the request and preview the review, but do not post it. +// ValidateOnly sets the optional parameter "validateOnly": If set, +// validate the request and preview the review, but do not post it. func (c *ProjectsLocationsTriggersDeleteCall) ValidateOnly(validateOnly bool) *ProjectsLocationsTriggersDeleteCall { c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) return c @@ -6327,7 +6327,7 @@ func (c *ProjectsLocationsTriggersDeleteCall) Do(opts ...googleapi.CallOption) ( // "type": "string" // }, // "validateOnly": { - // "description": "Required. If set, validate the request and preview the review, but do not post it.", + // "description": "Optional. If set, validate the request and preview the review, but do not post it.", // "location": "query", // "type": "boolean" // } @@ -6930,8 +6930,8 @@ func (c *ProjectsLocationsTriggersPatchCall) UpdateMask(updateMask string) *Proj return c } -// ValidateOnly sets the optional parameter "validateOnly": Required. If -// set, validate the request and preview the review, but do not post it. +// ValidateOnly sets the optional parameter "validateOnly": If set, +// validate the request and preview the review, but do not post it. func (c *ProjectsLocationsTriggersPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsTriggersPatchCall { c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) return c @@ -7055,7 +7055,7 @@ func (c *ProjectsLocationsTriggersPatchCall) Do(opts ...googleapi.CallOption) (* // "type": "string" // }, // "validateOnly": { - // "description": "Required. If set, validate the request and preview the review, but do not post it.", + // "description": "Optional. If set, validate the request and preview the review, but do not post it.", // "location": "query", // "type": "boolean" // } diff --git a/eventarc/v1beta1/eventarc-api.json b/eventarc/v1beta1/eventarc-api.json index 0badbcd4c32..45ad8d0a048 100644 --- a/eventarc/v1beta1/eventarc-api.json +++ b/eventarc/v1beta1/eventarc-api.json @@ -584,7 +584,7 @@ } } }, - "revision": "20230307", + "revision": "20230428", "rootUrl": "https://eventarc.googleapis.com/", "schemas": { "AuditConfig": { @@ -784,7 +784,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/eventarc/v1beta1/eventarc-gen.go b/eventarc/v1beta1/eventarc-gen.go index 405318db43f..939680b0536 100644 --- a/eventarc/v1beta1/eventarc-gen.go +++ b/eventarc/v1beta1/eventarc-gen.go @@ -622,7 +622,7 @@ func (s *ListTriggersResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/file/v1/file-api.json b/file/v1/file-api.json index e8aab35713f..e6d2ee5aee7 100644 --- a/file/v1/file-api.json +++ b/file/v1/file-api.json @@ -874,7 +874,7 @@ } } }, - "revision": "20230405", + "revision": "20230429", "rootUrl": "https://file.googleapis.com/", "schemas": { "Backup": { @@ -941,7 +941,8 @@ "BASIC_HDD", "BASIC_SSD", "HIGH_SCALE_SSD", - "ENTERPRISE" + "ENTERPRISE", + "ZONAL" ], "enumDescriptions": [ "Not set.", @@ -950,7 +951,8 @@ "BASIC instances offer a maximum capacity of 63.9 TB. BASIC_HDD is an alias for STANDARD Tier, offering economical performance backed by HDD.", "BASIC instances offer a maximum capacity of 63.9 TB. BASIC_SSD is an alias for PREMIUM Tier, and offers improved performance backed by SSD.", "HIGH_SCALE instances offer expanded capacity and performance scaling capabilities.", - "ENTERPRISE instances offer the features and availability needed for mission-critical workloads." + "ENTERPRISE instances offer the features and availability needed for mission-critical workloads.", + "ZONAL instances offer expanded capacity and performance scaling capabilities." ], "readOnly": true, "type": "string" @@ -1469,7 +1471,8 @@ "BASIC_HDD", "BASIC_SSD", "HIGH_SCALE_SSD", - "ENTERPRISE" + "ENTERPRISE", + "ZONAL" ], "enumDescriptions": [ "Not set.", @@ -1478,7 +1481,8 @@ "BASIC instances offer a maximum capacity of 63.9 TB. BASIC_HDD is an alias for STANDARD Tier, offering economical performance backed by HDD.", "BASIC instances offer a maximum capacity of 63.9 TB. BASIC_SSD is an alias for PREMIUM Tier, and offers improved performance backed by SSD.", "HIGH_SCALE instances offer expanded capacity and performance scaling capabilities.", - "ENTERPRISE instances offer the features and availability needed for mission-critical workloads." + "ENTERPRISE instances offer the features and availability needed for mission-critical workloads.", + "ZONAL instances offer expanded capacity and performance scaling capabilities." ], "type": "string" } @@ -1590,7 +1594,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/file/v1/file-gen.go b/file/v1/file-gen.go index aa90e020bc6..ead392b0530 100644 --- a/file/v1/file-gen.go +++ b/file/v1/file-gen.go @@ -268,6 +268,8 @@ type Backup struct { // performance scaling capabilities. // "ENTERPRISE" - ENTERPRISE instances offer the features and // availability needed for mission-critical workloads. + // "ZONAL" - ZONAL instances offer expanded capacity and performance + // scaling capabilities. SourceInstanceTier string `json:"sourceInstanceTier,omitempty"` // State: Output only. The backup state. @@ -1064,6 +1066,8 @@ type Instance struct { // performance scaling capabilities. // "ENTERPRISE" - ENTERPRISE instances offer the features and // availability needed for mission-critical workloads. + // "ZONAL" - ZONAL instances offer expanded capacity and performance + // scaling capabilities. Tier string `json:"tier,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1295,7 +1299,7 @@ func (s *ListSnapshotsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/file/v1beta1/file-api.json b/file/v1beta1/file-api.json index 8103041c94d..1120f5c7c64 100644 --- a/file/v1beta1/file-api.json +++ b/file/v1beta1/file-api.json @@ -1041,7 +1041,7 @@ } } }, - "revision": "20230405", + "revision": "20230429", "rootUrl": "https://file.googleapis.com/", "schemas": { "Backup": { @@ -1108,7 +1108,8 @@ "BASIC_HDD", "BASIC_SSD", "HIGH_SCALE_SSD", - "ENTERPRISE" + "ENTERPRISE", + "ZONAL" ], "enumDescriptions": [ "Not set.", @@ -1117,7 +1118,8 @@ "BASIC instances offer a maximum capacity of 63.9 TB. BASIC_HDD is an alias for STANDARD Tier, offering economical performance backed by HDD.", "BASIC instances offer a maximum capacity of 63.9 TB. BASIC_SSD is an alias for PREMIUM Tier, and offers improved performance backed by SSD.", "HIGH_SCALE instances offer expanded capacity and performance scaling capabilities.", - "ENTERPRISE instances offer the features and availability needed for mission-critical workloads." + "ENTERPRISE instances offer the features and availability needed for mission-critical workloads.", + "ZONAL instances offer expanded capacity and performance scaling capabilities." ], "readOnly": true, "type": "string" @@ -1215,6 +1217,17 @@ }, "type": "object" }, + "DirectoryServicesConfig": { + "description": "Directory Services configuration for Kerberos-based authentication.", + "id": "DirectoryServicesConfig", + "properties": { + "managedActiveDirectory": { + "$ref": "ManagedActiveDirectoryConfig", + "description": "Configuration for Managed Service for Microsoft Active Directory." + } + }, + "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", @@ -1547,6 +1560,10 @@ "description": "The description of the instance (2048 characters or less).", "type": "string" }, + "directoryServices": { + "$ref": "DirectoryServicesConfig", + "description": "Directory Services configuration for Kerberos-based authentication. Should only be set if protocol is \"NFS_V4_1\"." + }, "etag": { "description": "Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.", "type": "string" @@ -1676,7 +1693,8 @@ "BASIC_HDD", "BASIC_SSD", "HIGH_SCALE_SSD", - "ENTERPRISE" + "ENTERPRISE", + "ZONAL" ], "enumDescriptions": [ "Not set.", @@ -1685,7 +1703,8 @@ "BASIC instances offer a maximum capacity of 63.9 TB. BASIC_HDD is an alias for STANDARD Tier, offering economical performance backed by HDD.", "BASIC instances offer a maximum capacity of 63.9 TB. BASIC_SSD is an alias for PREMIUM Tier, and offers improved performance backed by SSD.", "HIGH_SCALE instances offer expanded capacity and performance scaling capabilities.", - "ENTERPRISE instances offer the features and availability needed for mission-critical workloads." + "ENTERPRISE instances offer the features and availability needed for mission-critical workloads.", + "ZONAL instances offer expanded capacity and performance scaling capabilities." ], "type": "string" } @@ -1822,7 +1841,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -1920,6 +1939,21 @@ }, "type": "object" }, + "ManagedActiveDirectoryConfig": { + "description": "ManagedActiveDirectoryConfig contains all the parameters for connecting to Managed Active Directory.", + "id": "ManagedActiveDirectoryConfig", + "properties": { + "computer": { + "description": "The computer name is used as a prefix to the mount remote target. Example: if the computer_name is `my-computer`, the mount command will look like: `$mount -o vers=4,sec=krb5 my-computer.filestore.:`.", + "type": "string" + }, + "domain": { + "description": "Fully qualified domain name.", + "type": "string" + } + }, + "type": "object" + }, "NetworkConfig": { "description": "Network configuration for the instance.", "id": "NetworkConfig", @@ -2007,6 +2041,27 @@ }, "type": "array" }, + "securityFlavors": { + "description": "The security flavors allowed for mount operations. The default is AUTH_SYS.", + "items": { + "enum": [ + "SECURITY_FLAVOR_UNSPECIFIED", + "AUTH_SYS", + "KRB5", + "KRB5I", + "KRB5P" + ], + "enumDescriptions": [ + "SecurityFlavor not set.", + "The user's UNIX user-id and group-ids are transferred \"in the clear\" (not encrypted) on the network, unauthenticated by the NFS server (default).", + "End-user authentication through Kerberos V5.", + "krb5 plus integrity protection (data packets are tamper proof).", + "krb5i plus privacy protection (data packets are tamper proof and encrypted)." + ], + "type": "string" + }, + "type": "array" + }, "squashMode": { "description": "Either NO_ROOT_SQUASH, for allowing root access on the exported directory, or ROOT_SQUASH, for not allowing root access. The default is NO_ROOT_SQUASH.", "enum": [ diff --git a/file/v1beta1/file-gen.go b/file/v1beta1/file-gen.go index 017b55ffd60..8829130e894 100644 --- a/file/v1beta1/file-gen.go +++ b/file/v1beta1/file-gen.go @@ -278,6 +278,8 @@ type Backup struct { // performance scaling capabilities. // "ENTERPRISE" - ENTERPRISE instances offer the features and // availability needed for mission-critical workloads. + // "ZONAL" - ZONAL instances offer expanded capacity and performance + // scaling capabilities. SourceInstanceTier string `json:"sourceInstanceTier,omitempty"` // State: Output only. The backup state. @@ -454,6 +456,38 @@ func (s *DenyMaintenancePeriod) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// DirectoryServicesConfig: Directory Services configuration for +// Kerberos-based authentication. +type DirectoryServicesConfig struct { + // ManagedActiveDirectory: Configuration for Managed Service for + // Microsoft Active Directory. + ManagedActiveDirectory *ManagedActiveDirectoryConfig `json:"managedActiveDirectory,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "ManagedActiveDirectory") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ManagedActiveDirectory") + // to include in API requests with the JSON null value. By default, + // fields with empty values are omitted from API requests. However, any + // field with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *DirectoryServicesConfig) MarshalJSON() ([]byte, error) { + type NoMethod DirectoryServicesConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, 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 @@ -1005,6 +1039,11 @@ type Instance struct { // less). Description string `json:"description,omitempty"` + // DirectoryServices: Directory Services configuration for + // Kerberos-based authentication. Should only be set if protocol is + // "NFS_V4_1". + DirectoryServices *DirectoryServicesConfig `json:"directoryServices,omitempty"` + // Etag: Server-specified ETag for the instance resource to prevent // simultaneous updates from overwriting each other. Etag string `json:"etag,omitempty"` @@ -1110,6 +1149,8 @@ type Instance struct { // performance scaling capabilities. // "ENTERPRISE" - ENTERPRISE instances offer the features and // availability needed for mission-critical workloads. + // "ZONAL" - ZONAL instances offer expanded capacity and performance + // scaling capabilities. Tier string `json:"tier,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1381,7 +1422,7 @@ func (s *ListSnapshotsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -1524,6 +1565,41 @@ func (s *MaintenanceWindow) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ManagedActiveDirectoryConfig: ManagedActiveDirectoryConfig contains +// all the parameters for connecting to Managed Active Directory. +type ManagedActiveDirectoryConfig struct { + // Computer: The computer name is used as a prefix to the mount remote + // target. Example: if the computer_name is `my-computer`, the mount + // command will look like: `$mount -o vers=4,sec=krb5 + // my-computer.filestore.:`. + Computer string `json:"computer,omitempty"` + + // Domain: Fully qualified domain name. + Domain string `json:"domain,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Computer") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Computer") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ManagedActiveDirectoryConfig) MarshalJSON() ([]byte, error) { + type NoMethod ManagedActiveDirectoryConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // NetworkConfig: Network configuration for the instance. type NetworkConfig struct { // ConnectMode: The network connect mode of the Filestore instance. If @@ -1633,6 +1709,21 @@ type NfsExportOptions struct { // NfsExportOptions. IpRanges []string `json:"ipRanges,omitempty"` + // SecurityFlavors: The security flavors allowed for mount operations. + // The default is AUTH_SYS. + // + // Possible values: + // "SECURITY_FLAVOR_UNSPECIFIED" - SecurityFlavor not set. + // "AUTH_SYS" - The user's UNIX user-id and group-ids are transferred + // "in the clear" (not encrypted) on the network, unauthenticated by the + // NFS server (default). + // "KRB5" - End-user authentication through Kerberos V5. + // "KRB5I" - krb5 plus integrity protection (data packets are tamper + // proof). + // "KRB5P" - krb5i plus privacy protection (data packets are tamper + // proof and encrypted). + SecurityFlavors []string `json:"securityFlavors,omitempty"` + // SquashMode: Either NO_ROOT_SQUASH, for allowing root access on the // exported directory, or ROOT_SQUASH, for not allowing root access. The // default is NO_ROOT_SQUASH. diff --git a/gameservices/v1/gameservices-api.json b/gameservices/v1/gameservices-api.json index 22b271f08e1..d1aacb033dd 100644 --- a/gameservices/v1/gameservices-api.json +++ b/gameservices/v1/gameservices-api.json @@ -401,7 +401,7 @@ } } }, - "revision": "20230308", + "revision": "20230426", "rootUrl": "https://gameservices.googleapis.com/", "schemas": { "AuditConfig": { @@ -737,7 +737,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/gameservices/v1/gameservices-gen.go b/gameservices/v1/gameservices-gen.go index 54173e8e54d..a8d47d352c8 100644 --- a/gameservices/v1/gameservices-gen.go +++ b/gameservices/v1/gameservices-gen.go @@ -819,7 +819,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/gameservices/v1beta/gameservices-api.json b/gameservices/v1beta/gameservices-api.json index 26968c8711e..08a2023ca1f 100644 --- a/gameservices/v1beta/gameservices-api.json +++ b/gameservices/v1beta/gameservices-api.json @@ -401,7 +401,7 @@ } } }, - "revision": "20230308", + "revision": "20230426", "rootUrl": "https://gameservices.googleapis.com/", "schemas": { "AuditConfig": { @@ -737,7 +737,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/gameservices/v1beta/gameservices-gen.go b/gameservices/v1beta/gameservices-gen.go index 2fda136235b..cd65477a56f 100644 --- a/gameservices/v1beta/gameservices-gen.go +++ b/gameservices/v1beta/gameservices-gen.go @@ -819,7 +819,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/gkehub/v1/gkehub-api.json b/gkehub/v1/gkehub-api.json index 5b1ce1f9889..7781c1973fa 100644 --- a/gkehub/v1/gkehub-api.json +++ b/gkehub/v1/gkehub-api.json @@ -1192,7 +1192,7 @@ } } }, - "revision": "20230414", + "revision": "20230430", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceFeatureSpec": { @@ -1217,7 +1217,7 @@ "id": "ApplianceCluster", "properties": { "resourceLink": { - "description": "Immutable. Self-link of the GCP resource for the Appliance Cluster. For example: //transferappliance.googleapis.com/projects/my-project/locations/us-west1-a/appliances/my-appliance", + "description": "Immutable. Self-link of the Google Cloud resource for the Appliance Cluster. For example: //transferappliance.googleapis.com/projects/my-project/locations/us-west1-a/appliances/my-appliance", "type": "string" } }, @@ -2160,7 +2160,7 @@ "id": "EdgeCluster", "properties": { "resourceLink": { - "description": "Immutable. Self-link of the GCP resource for the Edge Cluster. For example: //edgecontainer.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster", + "description": "Immutable. Self-link of the Google Cloud resource for the Edge Cluster. For example: //edgecontainer.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster", "type": "string" } }, @@ -2219,7 +2219,7 @@ "additionalProperties": { "type": "string" }, - "description": "GCP labels for this Feature.", + "description": "Labels for this Feature.", "type": "object" }, "membershipSpecs": { @@ -2387,7 +2387,7 @@ "type": "boolean" }, "resourceLink": { - "description": "Immutable. Self-link of the GCP resource for the GKE cluster. For example: //container.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster Zonal clusters are also supported.", + "description": "Immutable. Self-link of the Google Cloud resource for the GKE cluster. For example: //container.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster Zonal clusters are also supported.", "type": "string" } }, @@ -2787,7 +2787,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -2857,7 +2857,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. GCP labels for this membership.", + "description": "Optional. Labels for this membership.", "type": "object" }, "lastConnectionTime": { @@ -3131,7 +3131,7 @@ "type": "boolean" }, "resourceLink": { - "description": "Immutable. Self-link of the GCP resource for the GKE Multi-Cloud cluster. For example: //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/awsClusters/my-cluster //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/azureClusters/my-cluster //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/attachedClusters/my-cluster", + "description": "Immutable. Self-link of the Google Cloud resource for the GKE Multi-Cloud cluster. For example: //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/awsClusters/my-cluster //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/azureClusters/my-cluster //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/attachedClusters/my-cluster", "type": "string" } }, @@ -3180,7 +3180,7 @@ "type": "string" }, "resourceLink": { - "description": "Immutable. Self-link of the GCP resource for the GKE On-Prem cluster. For example: //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/vmwareClusters/my-cluster //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/bareMetalClusters/my-cluster", + "description": "Immutable. Self-link of the Google Cloud resource for the GKE On-Prem cluster. For example: //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/vmwareClusters/my-cluster //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/bareMetalClusters/my-cluster", "type": "string" } }, diff --git a/gkehub/v1/gkehub-gen.go b/gkehub/v1/gkehub-gen.go index 70dffcde168..6b8be478c79 100644 --- a/gkehub/v1/gkehub-gen.go +++ b/gkehub/v1/gkehub-gen.go @@ -257,8 +257,8 @@ func (s *AppDevExperienceFeatureState) MarshalJSON() ([]byte, error) { // ApplianceCluster: ApplianceCluster contains information specific to // GDC Edge Appliance Clusters. type ApplianceCluster struct { - // ResourceLink: Immutable. Self-link of the GCP resource for the - // Appliance Cluster. For example: + // ResourceLink: Immutable. Self-link of the Google Cloud resource for + // the Appliance Cluster. For example: // //transferappliance.googleapis.com/projects/my-project/locations/us-we // st1-a/appliances/my-appliance ResourceLink string `json:"resourceLink,omitempty"` @@ -1761,8 +1761,8 @@ func (s *ConnectAgentResource) MarshalJSON() ([]byte, error) { // EdgeCluster: EdgeCluster contains information specific to Google Edge // Clusters. type EdgeCluster struct { - // ResourceLink: Immutable. Self-link of the GCP resource for the Edge - // Cluster. For example: + // ResourceLink: Immutable. Self-link of the Google Cloud resource for + // the Edge Cluster. For example: // //edgecontainer.googleapis.com/projects/my-project/locations/us-west1- // a/clusters/my-cluster ResourceLink string `json:"resourceLink,omitempty"` @@ -1874,7 +1874,7 @@ type Feature struct { // to all memberships of the fleet. FleetDefaultMemberConfig *CommonFleetDefaultMemberConfigSpec `json:"fleetDefaultMemberConfig,omitempty"` - // Labels: GCP labels for this Feature. + // Labels: Labels for this Feature. Labels map[string]string `json:"labels,omitempty"` // MembershipSpecs: Optional. Membership-specific configuration for this @@ -2121,8 +2121,8 @@ type GkeCluster struct { // Plane. ClusterMissing bool `json:"clusterMissing,omitempty"` - // ResourceLink: Immutable. Self-link of the GCP resource for the GKE - // cluster. For example: + // ResourceLink: Immutable. Self-link of the Google Cloud resource for + // the GKE cluster. For example: // //container.googleapis.com/projects/my-project/locations/us-west1-a/cl // usters/my-cluster Zonal clusters are also supported. ResourceLink string `json:"resourceLink,omitempty"` @@ -2804,7 +2804,7 @@ func (s *ListScopesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -2882,7 +2882,7 @@ type Membership struct { // to the UID of the `kube-system` namespace object. ExternalId string `json:"externalId,omitempty"` - // Labels: Optional. GCP labels for this membership. + // Labels: Optional. Labels for this membership. Labels map[string]string `json:"labels,omitempty"` // LastConnectionTime: Output only. For clusters using Connect, the @@ -3297,8 +3297,8 @@ type MultiCloudCluster struct { // Multi-Cloud cluster no longer exists. ClusterMissing bool `json:"clusterMissing,omitempty"` - // ResourceLink: Immutable. Self-link of the GCP resource for the GKE - // Multi-Cloud cluster. For example: + // ResourceLink: Immutable. Self-link of the Google Cloud resource for + // the GKE Multi-Cloud cluster. For example: // //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1- // a/awsClusters/my-cluster // //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1- @@ -3384,8 +3384,8 @@ type OnPremCluster struct { // "USER" - The ClusterType is user cluster. ClusterType string `json:"clusterType,omitempty"` - // ResourceLink: Immutable. Self-link of the GCP resource for the GKE - // On-Prem cluster. For example: + // ResourceLink: Immutable. Self-link of the Google Cloud resource for + // the GKE On-Prem cluster. For example: // //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/vm // wareClusters/my-cluster // //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/ba diff --git a/gkehub/v1alpha/gkehub-api.json b/gkehub/v1alpha/gkehub-api.json index f8d8cdc2325..680ac860509 100644 --- a/gkehub/v1alpha/gkehub-api.json +++ b/gkehub/v1alpha/gkehub-api.json @@ -625,7 +625,7 @@ ], "parameters": { "name": { - "description": "Output only. The full, unique resource name of this fleet in the format of `projects/{project}/locations/{location}/fleets/{fleet}`. Each GCP project can have at most one fleet resource, named \"default\".", + "description": "Output only. The full, unique resource name of this fleet in the format of `projects/{project}/locations/{location}/fleets/{fleet}`. Each Google Cloud project can have at most one fleet resource, named \"default\".", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/fleets/[^/]+$", "required": true, @@ -1816,7 +1816,7 @@ } } }, - "revision": "20230414", + "revision": "20230430", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -1871,7 +1871,7 @@ "id": "ApplianceCluster", "properties": { "resourceLink": { - "description": "Immutable. Self-link of the GCP resource for the Appliance Cluster. For example: //transferappliance.googleapis.com/projects/my-project/locations/us-west1-a/appliances/my-appliance", + "description": "Immutable. Self-link of the Google Cloud resource for the Appliance Cluster. For example: //transferappliance.googleapis.com/projects/my-project/locations/us-west1-a/appliances/my-appliance", "type": "string" } }, @@ -2931,7 +2931,7 @@ "id": "EdgeCluster", "properties": { "resourceLink": { - "description": "Immutable. Self-link of the GCP resource for the Edge Cluster. For example: //edgecontainer.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster", + "description": "Immutable. Self-link of the Google Cloud resource for the Edge Cluster. For example: //edgecontainer.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster", "type": "string" } }, @@ -2990,7 +2990,7 @@ "additionalProperties": { "type": "string" }, - "description": "GCP labels for this Feature.", + "description": "Labels for this Feature.", "type": "object" }, "membershipSpecs": { @@ -3156,7 +3156,7 @@ "type": "string" }, "name": { - "description": "Output only. The full, unique resource name of this fleet in the format of `projects/{project}/locations/{location}/fleets/{fleet}`. Each GCP project can have at most one fleet resource, named \"default\".", + "description": "Output only. The full, unique resource name of this fleet in the format of `projects/{project}/locations/{location}/fleets/{fleet}`. Each Google Cloud project can have at most one fleet resource, named \"default\".", "readOnly": true, "type": "string" }, @@ -3208,7 +3208,12 @@ "FleetObservabilityFeatureSpec": { "description": "**Fleet Observability**: The Hub-wide input for the FleetObservability feature.", "id": "FleetObservabilityFeatureSpec", - "properties": {}, + "properties": { + "loggingConfig": { + "$ref": "FleetObservabilityLoggingConfig", + "description": "Specified if fleet logging feature is enabled for the entire fleet. If UNSPECIFIED, fleet logging feature is disabled for the entire fleet." + } + }, "type": "object" }, "FleetObservabilityFeatureState": { @@ -3217,6 +3222,21 @@ "properties": {}, "type": "object" }, + "FleetObservabilityLoggingConfig": { + "description": "LoggingConfig defines the configuration for different types of logs.", + "id": "FleetObservabilityLoggingConfig", + "properties": { + "defaultConfig": { + "$ref": "FleetObservabilityRoutingConfig", + "description": "Specified if applying the default routing config to logs not specified in other configs." + }, + "fleetScopeLogsConfig": { + "$ref": "FleetObservabilityRoutingConfig", + "description": "Specified if applying the routing config to all logs for all fleet scopes." + } + }, + "type": "object" + }, "FleetObservabilityMembershipSpec": { "description": "**FleetObservability**: The membership-specific input for FleetObservability feature.", "id": "FleetObservabilityMembershipSpec", @@ -3229,6 +3249,27 @@ "properties": {}, "type": "object" }, + "FleetObservabilityRoutingConfig": { + "description": "RoutingConfig configures the behaviour of fleet logging feature.", + "id": "FleetObservabilityRoutingConfig", + "properties": { + "mode": { + "description": "mode configures the logs routing mode.", + "enum": [ + "MODE_UNSPECIFIED", + "COPY", + "MOVE" + ], + "enumDescriptions": [ + "If UNSPECIFIED, fleet logging feature is disabled.", + "logs will be copied to the destination project.", + "logs will be moved to the destination project." + ], + "type": "string" + } + }, + "type": "object" + }, "GenerateConnectManifestResponse": { "description": "GenerateConnectManifestResponse contains manifest information for installing/upgrading a Connect agent.", "id": "GenerateConnectManifestResponse", @@ -3253,7 +3294,7 @@ "type": "boolean" }, "resourceLink": { - "description": "Immutable. Self-link of the GCP resource for the GKE cluster. For example: //container.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster Zonal clusters are also supported.", + "description": "Immutable. Self-link of the Google Cloud resource for the GKE cluster. For example: //container.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster Zonal clusters are also supported.", "type": "string" } }, @@ -3732,7 +3773,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -3802,7 +3843,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. GCP labels for this membership.", + "description": "Optional. Labels for this membership.", "type": "object" }, "lastConnectionTime": { @@ -4138,7 +4179,7 @@ "type": "boolean" }, "resourceLink": { - "description": "Immutable. Self-link of the GCP resource for the GKE Multi-Cloud cluster. For example: //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/awsClusters/my-cluster //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/azureClusters/my-cluster //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/attachedClusters/my-cluster", + "description": "Immutable. Self-link of the Google Cloud resource for the GKE Multi-Cloud cluster. For example: //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/awsClusters/my-cluster //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/azureClusters/my-cluster //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/attachedClusters/my-cluster", "type": "string" } }, @@ -4270,7 +4311,7 @@ "type": "string" }, "resourceLink": { - "description": "Immutable. Self-link of the GCP resource for the GKE On-Prem cluster. For example: //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/vmwareClusters/my-cluster //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/bareMetalClusters/my-cluster", + "description": "Immutable. Self-link of the Google Cloud resource for the GKE On-Prem cluster. For example: //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/vmwareClusters/my-cluster //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/bareMetalClusters/my-cluster", "type": "string" } }, @@ -4391,14 +4432,14 @@ "id": "PolicyControllerBundleInstallSpec", "properties": { "exemptedNamespaces": { - "description": "the set of namespaces to be exempted from the bundle TODO (b/271878194): Decrement this", + "description": "the set of namespaces to be exempted from the bundle", "items": { "type": "string" }, "type": "array" }, "management": { - "description": "Management specifies how the bundle will be managed by the controller. TODO (b/271878194): Remove this", + "description": "Management specifies how the bundle will be managed by the controller.", "enum": [ "MANAGEMENT_UNSPECIFIED", "INSTALLED" @@ -4430,7 +4471,7 @@ "additionalProperties": { "$ref": "PolicyControllerPolicyControllerDeploymentConfig" }, - "description": "Map of deployment configs to deployments (“admission”, “audit”, “mutation”).", + "description": "Map of deployment configs to deployments (\"admission\", \"audit\", \"mutation').", "type": "object" }, "exemptableNamespaces": { @@ -4478,7 +4519,7 @@ }, "templateLibraryConfig": { "$ref": "PolicyControllerTemplateLibraryConfig", - "description": "Configures the library templates to install along with Policy Controller. TODO (b/271878194): Remove this" + "description": "Configures the library templates to install along with Policy Controller." } }, "type": "object" @@ -4513,12 +4554,12 @@ "additionalProperties": { "$ref": "PolicyControllerOnClusterState" }, - "description": "The state of the template library and any bundles included in the chosen version of the manifest TODO (b/271878194): Remove this", + "description": "The state of the template library and any bundles included in the chosen version of the manifest", "type": "object" }, "policyContentState": { "$ref": "PolicyControllerPolicyContentState", - "description": "The overall content state observed by the Hub Feature controller. TODO (b/271878194): Decrement this" + "description": "The overall content state observed by the Hub Feature controller." }, "state": { "description": "The overall Policy Controller lifecycle state observed by the Hub Feature controller.", @@ -4708,11 +4749,11 @@ "id": "PolicyControllerTemplateLibraryConfig", "properties": { "included": { - "description": "Whether the standard template library should be installed or not. TODO (b/271878194): Remove this", + "description": "Whether the standard template library should be installed or not.", "type": "boolean" }, "installation": { - "description": "Configures the manner in which the template library is installed on the cluster. TODO (b/271878194): Decrement this", + "description": "Configures the manner in which the template library is installed on the cluster.", "enum": [ "INSTALLATION_UNSPECIFIED", "NOT_INSTALLED", diff --git a/gkehub/v1alpha/gkehub-gen.go b/gkehub/v1alpha/gkehub-gen.go index 90c0b4a00bb..4c44f422402 100644 --- a/gkehub/v1alpha/gkehub-gen.go +++ b/gkehub/v1alpha/gkehub-gen.go @@ -400,8 +400,8 @@ func (s *AppDevExperienceFeatureState) MarshalJSON() ([]byte, error) { // ApplianceCluster: ApplianceCluster contains information specific to // GDC Edge Appliance Clusters. type ApplianceCluster struct { - // ResourceLink: Immutable. Self-link of the GCP resource for the - // Appliance Cluster. For example: + // ResourceLink: Immutable. Self-link of the Google Cloud resource for + // the Appliance Cluster. For example: // //transferappliance.googleapis.com/projects/my-project/locations/us-we // st1-a/appliances/my-appliance ResourceLink string `json:"resourceLink,omitempty"` @@ -2117,8 +2117,8 @@ func (s *ConnectAgentResource) MarshalJSON() ([]byte, error) { // EdgeCluster: EdgeCluster contains information specific to Google Edge // Clusters. type EdgeCluster struct { - // ResourceLink: Immutable. Self-link of the GCP resource for the Edge - // Cluster. For example: + // ResourceLink: Immutable. Self-link of the Google Cloud resource for + // the Edge Cluster. For example: // //edgecontainer.googleapis.com/projects/my-project/locations/us-west1- // a/clusters/my-cluster ResourceLink string `json:"resourceLink,omitempty"` @@ -2230,7 +2230,7 @@ type Feature struct { // to all memberships of the fleet. FleetDefaultMemberConfig *CommonFleetDefaultMemberConfigSpec `json:"fleetDefaultMemberConfig,omitempty"` - // Labels: GCP labels for this Feature. + // Labels: Labels for this Feature. Labels map[string]string `json:"labels,omitempty"` // MembershipSpecs: Optional. Membership-specific configuration for this @@ -2471,8 +2471,8 @@ type Fleet struct { // Name: Output only. The full, unique resource name of this fleet in // the format of - // `projects/{project}/locations/{location}/fleets/{fleet}`. Each GCP - // project can have at most one fleet resource, named "default". + // `projects/{project}/locations/{location}/fleets/{fleet}`. Each Google + // Cloud project can have at most one fleet resource, named "default". Name string `json:"name,omitempty"` // State: Output only. State of the namespace resource. @@ -2553,6 +2553,32 @@ func (s *FleetLifecycleState) MarshalJSON() ([]byte, error) { // FleetObservabilityFeatureSpec: **Fleet Observability**: The Hub-wide // input for the FleetObservability feature. type FleetObservabilityFeatureSpec struct { + // LoggingConfig: Specified if fleet logging feature is enabled for the + // entire fleet. If UNSPECIFIED, fleet logging feature is disabled for + // the entire fleet. + LoggingConfig *FleetObservabilityLoggingConfig `json:"loggingConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "LoggingConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "LoggingConfig") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *FleetObservabilityFeatureSpec) MarshalJSON() ([]byte, error) { + type NoMethod FleetObservabilityFeatureSpec + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // FleetObservabilityFeatureState: **FleetObservability**: An empty @@ -2560,6 +2586,40 @@ type FleetObservabilityFeatureSpec struct { type FleetObservabilityFeatureState struct { } +// FleetObservabilityLoggingConfig: LoggingConfig defines the +// configuration for different types of logs. +type FleetObservabilityLoggingConfig struct { + // DefaultConfig: Specified if applying the default routing config to + // logs not specified in other configs. + DefaultConfig *FleetObservabilityRoutingConfig `json:"defaultConfig,omitempty"` + + // FleetScopeLogsConfig: Specified if applying the routing config to all + // logs for all fleet scopes. + FleetScopeLogsConfig *FleetObservabilityRoutingConfig `json:"fleetScopeLogsConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DefaultConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DefaultConfig") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *FleetObservabilityLoggingConfig) MarshalJSON() ([]byte, error) { + type NoMethod FleetObservabilityLoggingConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // FleetObservabilityMembershipSpec: **FleetObservability**: The // membership-specific input for FleetObservability feature. type FleetObservabilityMembershipSpec struct { @@ -2570,6 +2630,41 @@ type FleetObservabilityMembershipSpec struct { type FleetObservabilityMembershipState struct { } +// FleetObservabilityRoutingConfig: RoutingConfig configures the +// behaviour of fleet logging feature. +type FleetObservabilityRoutingConfig struct { + // Mode: mode configures the logs routing mode. + // + // Possible values: + // "MODE_UNSPECIFIED" - If UNSPECIFIED, fleet logging feature is + // disabled. + // "COPY" - logs will be copied to the destination project. + // "MOVE" - logs will be moved to the destination project. + Mode string `json:"mode,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Mode") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Mode") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *FleetObservabilityRoutingConfig) MarshalJSON() ([]byte, error) { + type NoMethod FleetObservabilityRoutingConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GenerateConnectManifestResponse: GenerateConnectManifestResponse // contains manifest information for installing/upgrading a Connect // agent. @@ -2612,8 +2707,8 @@ type GkeCluster struct { // Plane. ClusterMissing bool `json:"clusterMissing,omitempty"` - // ResourceLink: Immutable. Self-link of the GCP resource for the GKE - // cluster. For example: + // ResourceLink: Immutable. Self-link of the Google Cloud resource for + // the GKE cluster. For example: // //container.googleapis.com/projects/my-project/locations/us-west1-a/cl // usters/my-cluster Zonal clusters are also supported. ResourceLink string `json:"resourceLink,omitempty"` @@ -3452,7 +3547,7 @@ func (s *ListScopesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -3530,7 +3625,7 @@ type Membership struct { // to the UID of the `kube-system` namespace object. ExternalId string `json:"externalId,omitempty"` - // Labels: Optional. GCP labels for this membership. + // Labels: Optional. Labels for this membership. Labels map[string]string `json:"labels,omitempty"` // LastConnectionTime: Output only. For clusters using Connect, the @@ -4048,8 +4143,8 @@ type MultiCloudCluster struct { // Multi-Cloud cluster no longer exists. ClusterMissing bool `json:"clusterMissing,omitempty"` - // ResourceLink: Immutable. Self-link of the GCP resource for the GKE - // Multi-Cloud cluster. For example: + // ResourceLink: Immutable. Self-link of the Google Cloud resource for + // the GKE Multi-Cloud cluster. For example: // //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1- // a/awsClusters/my-cluster // //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1- @@ -4233,8 +4328,8 @@ type OnPremCluster struct { // "USER" - The ClusterType is user cluster. ClusterType string `json:"clusterType,omitempty"` - // ResourceLink: Immutable. Self-link of the GCP resource for the GKE - // On-Prem cluster. For example: + // ResourceLink: Immutable. Self-link of the Google Cloud resource for + // the GKE On-Prem cluster. For example: // //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/vm // wareClusters/my-cluster // //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/ba @@ -4492,11 +4587,11 @@ func (s *Policy) MarshalJSON() ([]byte, error) { // specification configuration for a single managed bundle. type PolicyControllerBundleInstallSpec struct { // ExemptedNamespaces: the set of namespaces to be exempted from the - // bundle TODO (b/271878194): Decrement this + // bundle ExemptedNamespaces []string `json:"exemptedNamespaces,omitempty"` // Management: Management specifies how the bundle will be managed by - // the controller. TODO (b/271878194): Remove this + // the controller. // // Possible values: // "MANAGEMENT_UNSPECIFIED" - No Management strategy has been @@ -4542,7 +4637,7 @@ type PolicyControllerHubConfig struct { ConstraintViolationLimit int64 `json:"constraintViolationLimit,omitempty,string"` // DeploymentConfigs: Map of deployment configs to deployments - // (“admission”, “audit”, “mutation”). + // ("admission", "audit", "mutation'). DeploymentConfigs map[string]PolicyControllerPolicyControllerDeploymentConfig `json:"deploymentConfigs,omitempty"` // ExemptableNamespaces: The set of namespaces that are excluded from @@ -4585,7 +4680,7 @@ type PolicyControllerHubConfig struct { ReferentialRulesEnabled bool `json:"referentialRulesEnabled,omitempty"` // TemplateLibraryConfig: Configures the library templates to install - // along with Policy Controller. TODO (b/271878194): Remove this + // along with Policy Controller. TemplateLibraryConfig *PolicyControllerTemplateLibraryConfig `json:"templateLibraryConfig,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -4656,12 +4751,11 @@ type PolicyControllerMembershipState struct { ComponentStates map[string]PolicyControllerOnClusterState `json:"componentStates,omitempty"` // ContentStates: The state of the template library and any bundles - // included in the chosen version of the manifest TODO (b/271878194): - // Remove this + // included in the chosen version of the manifest ContentStates map[string]PolicyControllerOnClusterState `json:"contentStates,omitempty"` // PolicyContentState: The overall content state observed by the Hub - // Feature controller. TODO (b/271878194): Decrement this + // Feature controller. PolicyContentState *PolicyControllerPolicyContentState `json:"policyContentState,omitempty"` // State: The overall Policy Controller lifecycle state observed by the @@ -5014,11 +5108,11 @@ func (s *PolicyControllerResourceRequirements) MarshalJSON() ([]byte, error) { // default library templates to install. type PolicyControllerTemplateLibraryConfig struct { // Included: Whether the standard template library should be installed - // or not. TODO (b/271878194): Remove this + // or not. Included bool `json:"included,omitempty"` // Installation: Configures the manner in which the template library is - // installed on the cluster. TODO (b/271878194): Decrement this + // installed on the cluster. // // Possible values: // "INSTALLATION_UNSPECIFIED" - No installation strategy has been @@ -8669,8 +8763,9 @@ type ProjectsLocationsFleetsPatchCall struct { // // - name: Output only. The full, unique resource name of this fleet in // the format of -// `projects/{project}/locations/{location}/fleets/{fleet}`. Each GCP -// project can have at most one fleet resource, named "default". +// `projects/{project}/locations/{location}/fleets/{fleet}`. Each +// Google Cloud project can have at most one fleet resource, named +// "default". func (r *ProjectsLocationsFleetsService) Patch(name string, fleet *Fleet) *ProjectsLocationsFleetsPatchCall { c := &ProjectsLocationsFleetsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -8785,7 +8880,7 @@ func (c *ProjectsLocationsFleetsPatchCall) Do(opts ...googleapi.CallOption) (*Op // ], // "parameters": { // "name": { - // "description": "Output only. The full, unique resource name of this fleet in the format of `projects/{project}/locations/{location}/fleets/{fleet}`. Each GCP project can have at most one fleet resource, named \"default\".", + // "description": "Output only. The full, unique resource name of this fleet in the format of `projects/{project}/locations/{location}/fleets/{fleet}`. Each Google Cloud project can have at most one fleet resource, named \"default\".", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/fleets/[^/]+$", // "required": true, diff --git a/gkehub/v1alpha2/gkehub-api.json b/gkehub/v1alpha2/gkehub-api.json index 65cb2e3e495..ae8c4cdfa2c 100644 --- a/gkehub/v1alpha2/gkehub-api.json +++ b/gkehub/v1alpha2/gkehub-api.json @@ -657,7 +657,7 @@ } } }, - "revision": "20230407", + "revision": "20230430", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "ApplianceCluster": { @@ -665,7 +665,7 @@ "id": "ApplianceCluster", "properties": { "resourceLink": { - "description": "Immutable. Self-link of the GCP resource for the Appliance Cluster. For example: //transferappliance.googleapis.com/projects/my-project/locations/us-west1-a/appliances/my-appliance", + "description": "Immutable. Self-link of the Google Cloud resource for the Appliance Cluster. For example: //transferappliance.googleapis.com/projects/my-project/locations/us-west1-a/appliances/my-appliance", "type": "string" } }, @@ -793,7 +793,7 @@ "id": "EdgeCluster", "properties": { "resourceLink": { - "description": "Immutable. Self-link of the GCP resource for the Edge Cluster. For example: //edgecontainer.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster", + "description": "Immutable. Self-link of the Google Cloud resource for the Edge Cluster. For example: //edgecontainer.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster", "type": "string" } }, @@ -852,7 +852,7 @@ "type": "boolean" }, "resourceLink": { - "description": "Immutable. Self-link of the GCP resource for the GKE cluster. For example: //container.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster Zonal clusters are also supported.", + "description": "Immutable. Self-link of the Google Cloud resource for the GKE cluster. For example: //container.googleapis.com/projects/my-project/locations/us-west1-a/clusters/my-cluster Zonal clusters are also supported.", "type": "string" } }, @@ -1040,7 +1040,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -1124,7 +1124,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. GCP labels for this membership.", + "description": "Optional. Labels for this membership.", "type": "object" }, "lastConnectionTime": { @@ -1262,7 +1262,7 @@ "type": "boolean" }, "resourceLink": { - "description": "Immutable. Self-link of the GCP resource for the GKE Multi-Cloud cluster. For example: //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/awsClusters/my-cluster //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/azureClusters/my-cluster //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/attachedClusters/my-cluster", + "description": "Immutable. Self-link of the Google Cloud resource for the GKE Multi-Cloud cluster. For example: //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/awsClusters/my-cluster //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/azureClusters/my-cluster //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1-a/attachedClusters/my-cluster", "type": "string" } }, @@ -1300,7 +1300,7 @@ "type": "string" }, "resourceLink": { - "description": "Immutable. Self-link of the GCP resource for the GKE On-Prem cluster. For example: //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/vmwareClusters/my-cluster //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/bareMetalClusters/my-cluster", + "description": "Immutable. Self-link of the Google Cloud resource for the GKE On-Prem cluster. For example: //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/vmwareClusters/my-cluster //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/bareMetalClusters/my-cluster", "type": "string" } }, diff --git a/gkehub/v1alpha2/gkehub-gen.go b/gkehub/v1alpha2/gkehub-gen.go index 6e96b4ee73e..a3a76366274 100644 --- a/gkehub/v1alpha2/gkehub-gen.go +++ b/gkehub/v1alpha2/gkehub-gen.go @@ -210,8 +210,8 @@ type ProjectsLocationsOperationsService struct { // ApplianceCluster: ApplianceCluster contains information specific to // GDC Edge Appliance Clusters. type ApplianceCluster struct { - // ResourceLink: Immutable. Self-link of the GCP resource for the - // Appliance Cluster. For example: + // ResourceLink: Immutable. Self-link of the Google Cloud resource for + // the Appliance Cluster. For example: // //transferappliance.googleapis.com/projects/my-project/locations/us-we // st1-a/appliances/my-appliance ResourceLink string `json:"resourceLink,omitempty"` @@ -512,8 +512,8 @@ func (s *ConnectAgentResource) MarshalJSON() ([]byte, error) { // EdgeCluster: EdgeCluster contains information specific to Google Edge // Clusters. type EdgeCluster struct { - // ResourceLink: Immutable. Self-link of the GCP resource for the Edge - // Cluster. For example: + // ResourceLink: Immutable. Self-link of the Google Cloud resource for + // the Edge Cluster. For example: // //edgecontainer.googleapis.com/projects/my-project/locations/us-west1- // a/clusters/my-cluster ResourceLink string `json:"resourceLink,omitempty"` @@ -654,8 +654,8 @@ type GkeCluster struct { // Plane. ClusterMissing bool `json:"clusterMissing,omitempty"` - // ResourceLink: Immutable. Self-link of the GCP resource for the GKE - // cluster. For example: + // ResourceLink: Immutable. Self-link of the Google Cloud resource for + // the GKE cluster. For example: // //container.googleapis.com/projects/my-project/locations/us-west1-a/cl // usters/my-cluster Zonal clusters are also supported. ResourceLink string `json:"resourceLink,omitempty"` @@ -1005,7 +1005,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -1097,7 +1097,7 @@ type Membership struct { // "MULTI_CLOUD" - Public cloud infrastructure. InfrastructureType string `json:"infrastructureType,omitempty"` - // Labels: Optional. GCP labels for this membership. + // Labels: Optional. Labels for this membership. Labels map[string]string `json:"labels,omitempty"` // LastConnectionTime: Output only. For clusters using Connect, the @@ -1319,8 +1319,8 @@ type MultiCloudCluster struct { // Multi-Cloud cluster no longer exists. ClusterMissing bool `json:"clusterMissing,omitempty"` - // ResourceLink: Immutable. Self-link of the GCP resource for the GKE - // Multi-Cloud cluster. For example: + // ResourceLink: Immutable. Self-link of the Google Cloud resource for + // the GKE Multi-Cloud cluster. For example: // //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1- // a/awsClusters/my-cluster // //gkemulticloud.googleapis.com/projects/my-project/locations/us-west1- @@ -1374,8 +1374,8 @@ type OnPremCluster struct { // "USER" - The ClusterType is user cluster. ClusterType string `json:"clusterType,omitempty"` - // ResourceLink: Immutable. Self-link of the GCP resource for the GKE - // On-Prem cluster. For example: + // ResourceLink: Immutable. Self-link of the Google Cloud resource for + // the GKE On-Prem cluster. For example: // //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/vm // wareClusters/my-cluster // //gkeonprem.googleapis.com/projects/my-project/locations/us-west1-a/ba diff --git a/gkehub/v1beta/gkehub-api.json b/gkehub/v1beta/gkehub-api.json index 0f20949d405..7f936b855b5 100644 --- a/gkehub/v1beta/gkehub-api.json +++ b/gkehub/v1beta/gkehub-api.json @@ -625,7 +625,7 @@ ], "parameters": { "name": { - "description": "Output only. The full, unique resource name of this fleet in the format of `projects/{project}/locations/{location}/fleets/{fleet}`. Each GCP project can have at most one fleet resource, named \"default\".", + "description": "Output only. The full, unique resource name of this fleet in the format of `projects/{project}/locations/{location}/fleets/{fleet}`. Each Google Cloud project can have at most one fleet resource, named \"default\".", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/fleets/[^/]+$", "required": true, @@ -1502,7 +1502,7 @@ } } }, - "revision": "20230414", + "revision": "20230430", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -2562,7 +2562,7 @@ "additionalProperties": { "type": "string" }, - "description": "GCP labels for this Feature.", + "description": "Labels for this Feature.", "type": "object" }, "membershipSpecs": { @@ -2703,7 +2703,7 @@ "type": "string" }, "name": { - "description": "Output only. The full, unique resource name of this fleet in the format of `projects/{project}/locations/{location}/fleets/{fleet}`. Each GCP project can have at most one fleet resource, named \"default\".", + "description": "Output only. The full, unique resource name of this fleet in the format of `projects/{project}/locations/{location}/fleets/{fleet}`. Each Google Cloud project can have at most one fleet resource, named \"default\".", "readOnly": true, "type": "string" }, @@ -2755,7 +2755,12 @@ "FleetObservabilityFeatureSpec": { "description": "**Fleet Observability**: The Hub-wide input for the FleetObservability feature.", "id": "FleetObservabilityFeatureSpec", - "properties": {}, + "properties": { + "loggingConfig": { + "$ref": "FleetObservabilityLoggingConfig", + "description": "Specified if fleet logging feature is enabled for the entire fleet. If UNSPECIFIED, fleet logging feature is disabled for the entire fleet." + } + }, "type": "object" }, "FleetObservabilityFeatureState": { @@ -2764,6 +2769,21 @@ "properties": {}, "type": "object" }, + "FleetObservabilityLoggingConfig": { + "description": "LoggingConfig defines the configuration for different types of logs.", + "id": "FleetObservabilityLoggingConfig", + "properties": { + "defaultConfig": { + "$ref": "FleetObservabilityRoutingConfig", + "description": "Specified if applying the default routing config to logs not specified in other configs." + }, + "fleetScopeLogsConfig": { + "$ref": "FleetObservabilityRoutingConfig", + "description": "Specified if applying the routing config to all logs for all fleet scopes." + } + }, + "type": "object" + }, "FleetObservabilityMembershipSpec": { "description": "**FleetObservability**: The membership-specific input for FleetObservability feature.", "id": "FleetObservabilityMembershipSpec", @@ -2776,6 +2796,27 @@ "properties": {}, "type": "object" }, + "FleetObservabilityRoutingConfig": { + "description": "RoutingConfig configures the behaviour of fleet logging feature.", + "id": "FleetObservabilityRoutingConfig", + "properties": { + "mode": { + "description": "mode configures the logs routing mode.", + "enum": [ + "MODE_UNSPECIFIED", + "COPY", + "MOVE" + ], + "enumDescriptions": [ + "If UNSPECIFIED, fleet logging feature is disabled.", + "logs will be copied to the destination project.", + "logs will be moved to the destination project." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleRpcStatus": { "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": "GoogleRpcStatus", @@ -3127,7 +3168,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -3562,14 +3603,14 @@ "id": "PolicyControllerBundleInstallSpec", "properties": { "exemptedNamespaces": { - "description": "the set of namespaces to be exempted from the bundle TODO (b/271878194): Decrement this", + "description": "the set of namespaces to be exempted from the bundle", "items": { "type": "string" }, "type": "array" }, "management": { - "description": "Management specifies how the bundle will be managed by the controller. TODO (b/271878194): Remove this", + "description": "Management specifies how the bundle will be managed by the controller.", "enum": [ "MANAGEMENT_UNSPECIFIED", "INSTALLED" @@ -3601,7 +3642,7 @@ "additionalProperties": { "$ref": "PolicyControllerPolicyControllerDeploymentConfig" }, - "description": "Map of deployment configs to deployments (“admission”, “audit”, “mutation”).", + "description": "Map of deployment configs to deployments (\"admission\", \"audit\", \"mutation').", "type": "object" }, "exemptableNamespaces": { @@ -3649,7 +3690,7 @@ }, "templateLibraryConfig": { "$ref": "PolicyControllerTemplateLibraryConfig", - "description": "Configures the library templates to install along with Policy Controller. TODO (b/271878194): Remove this" + "description": "Configures the library templates to install along with Policy Controller." } }, "type": "object" @@ -3684,12 +3725,12 @@ "additionalProperties": { "$ref": "PolicyControllerOnClusterState" }, - "description": "The state of the template library and any bundles included in the chosen version of the manifest TODO (b/271878194): Remove this", + "description": "The state of the template library and any bundles included in the chosen version of the manifest", "type": "object" }, "policyContentState": { "$ref": "PolicyControllerPolicyContentState", - "description": "The overall content state observed by the Hub Feature controller. TODO (b/271878194): Decrement this" + "description": "The overall content state observed by the Hub Feature controller." }, "state": { "description": "The overall Policy Controller lifecycle state observed by the Hub Feature controller.", @@ -3879,11 +3920,11 @@ "id": "PolicyControllerTemplateLibraryConfig", "properties": { "included": { - "description": "Whether the standard template library should be installed or not. TODO (b/271878194): Remove this", + "description": "Whether the standard template library should be installed or not.", "type": "boolean" }, "installation": { - "description": "Configures the manner in which the template library is installed on the cluster. TODO (b/271878194): Decrement this", + "description": "Configures the manner in which the template library is installed on the cluster.", "enum": [ "INSTALLATION_UNSPECIFIED", "NOT_INSTALLED", diff --git a/gkehub/v1beta/gkehub-gen.go b/gkehub/v1beta/gkehub-gen.go index 3a084720cb4..1e8b81d7b02 100644 --- a/gkehub/v1beta/gkehub-gen.go +++ b/gkehub/v1beta/gkehub-gen.go @@ -1992,7 +1992,7 @@ type Feature struct { // to all memberships of the fleet. FleetDefaultMemberConfig *CommonFleetDefaultMemberConfigSpec `json:"fleetDefaultMemberConfig,omitempty"` - // Labels: GCP labels for this Feature. + // Labels: Labels for this Feature. Labels map[string]string `json:"labels,omitempty"` // MembershipSpecs: Optional. Membership-specific configuration for this @@ -2194,8 +2194,8 @@ type Fleet struct { // Name: Output only. The full, unique resource name of this fleet in // the format of - // `projects/{project}/locations/{location}/fleets/{fleet}`. Each GCP - // project can have at most one fleet resource, named "default". + // `projects/{project}/locations/{location}/fleets/{fleet}`. Each Google + // Cloud project can have at most one fleet resource, named "default". Name string `json:"name,omitempty"` // State: Output only. State of the namespace resource. @@ -2276,6 +2276,32 @@ func (s *FleetLifecycleState) MarshalJSON() ([]byte, error) { // FleetObservabilityFeatureSpec: **Fleet Observability**: The Hub-wide // input for the FleetObservability feature. type FleetObservabilityFeatureSpec struct { + // LoggingConfig: Specified if fleet logging feature is enabled for the + // entire fleet. If UNSPECIFIED, fleet logging feature is disabled for + // the entire fleet. + LoggingConfig *FleetObservabilityLoggingConfig `json:"loggingConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "LoggingConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "LoggingConfig") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *FleetObservabilityFeatureSpec) MarshalJSON() ([]byte, error) { + type NoMethod FleetObservabilityFeatureSpec + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // FleetObservabilityFeatureState: **FleetObservability**: An empty @@ -2283,6 +2309,40 @@ type FleetObservabilityFeatureSpec struct { type FleetObservabilityFeatureState struct { } +// FleetObservabilityLoggingConfig: LoggingConfig defines the +// configuration for different types of logs. +type FleetObservabilityLoggingConfig struct { + // DefaultConfig: Specified if applying the default routing config to + // logs not specified in other configs. + DefaultConfig *FleetObservabilityRoutingConfig `json:"defaultConfig,omitempty"` + + // FleetScopeLogsConfig: Specified if applying the routing config to all + // logs for all fleet scopes. + FleetScopeLogsConfig *FleetObservabilityRoutingConfig `json:"fleetScopeLogsConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DefaultConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DefaultConfig") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *FleetObservabilityLoggingConfig) MarshalJSON() ([]byte, error) { + type NoMethod FleetObservabilityLoggingConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // FleetObservabilityMembershipSpec: **FleetObservability**: The // membership-specific input for FleetObservability feature. type FleetObservabilityMembershipSpec struct { @@ -2293,6 +2353,41 @@ type FleetObservabilityMembershipSpec struct { type FleetObservabilityMembershipState struct { } +// FleetObservabilityRoutingConfig: RoutingConfig configures the +// behaviour of fleet logging feature. +type FleetObservabilityRoutingConfig struct { + // Mode: mode configures the logs routing mode. + // + // Possible values: + // "MODE_UNSPECIFIED" - If UNSPECIFIED, fleet logging feature is + // disabled. + // "COPY" - logs will be copied to the destination project. + // "MOVE" - logs will be moved to the destination project. + Mode string `json:"mode,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Mode") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Mode") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *FleetObservabilityRoutingConfig) MarshalJSON() ([]byte, error) { + type NoMethod FleetObservabilityRoutingConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleRpcStatus: 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 @@ -2900,7 +2995,7 @@ func (s *ListScopesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -3599,11 +3694,11 @@ func (s *Policy) MarshalJSON() ([]byte, error) { // specification configuration for a single managed bundle. type PolicyControllerBundleInstallSpec struct { // ExemptedNamespaces: the set of namespaces to be exempted from the - // bundle TODO (b/271878194): Decrement this + // bundle ExemptedNamespaces []string `json:"exemptedNamespaces,omitempty"` // Management: Management specifies how the bundle will be managed by - // the controller. TODO (b/271878194): Remove this + // the controller. // // Possible values: // "MANAGEMENT_UNSPECIFIED" - No Management strategy has been @@ -3649,7 +3744,7 @@ type PolicyControllerHubConfig struct { ConstraintViolationLimit int64 `json:"constraintViolationLimit,omitempty,string"` // DeploymentConfigs: Map of deployment configs to deployments - // (“admission”, “audit”, “mutation”). + // ("admission", "audit", "mutation'). DeploymentConfigs map[string]PolicyControllerPolicyControllerDeploymentConfig `json:"deploymentConfigs,omitempty"` // ExemptableNamespaces: The set of namespaces that are excluded from @@ -3692,7 +3787,7 @@ type PolicyControllerHubConfig struct { ReferentialRulesEnabled bool `json:"referentialRulesEnabled,omitempty"` // TemplateLibraryConfig: Configures the library templates to install - // along with Policy Controller. TODO (b/271878194): Remove this + // along with Policy Controller. TemplateLibraryConfig *PolicyControllerTemplateLibraryConfig `json:"templateLibraryConfig,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -3763,12 +3858,11 @@ type PolicyControllerMembershipState struct { ComponentStates map[string]PolicyControllerOnClusterState `json:"componentStates,omitempty"` // ContentStates: The state of the template library and any bundles - // included in the chosen version of the manifest TODO (b/271878194): - // Remove this + // included in the chosen version of the manifest ContentStates map[string]PolicyControllerOnClusterState `json:"contentStates,omitempty"` // PolicyContentState: The overall content state observed by the Hub - // Feature controller. TODO (b/271878194): Decrement this + // Feature controller. PolicyContentState *PolicyControllerPolicyContentState `json:"policyContentState,omitempty"` // State: The overall Policy Controller lifecycle state observed by the @@ -4121,11 +4215,11 @@ func (s *PolicyControllerResourceRequirements) MarshalJSON() ([]byte, error) { // default library templates to install. type PolicyControllerTemplateLibraryConfig struct { // Included: Whether the standard template library should be installed - // or not. TODO (b/271878194): Remove this + // or not. Included bool `json:"included,omitempty"` // Installation: Configures the manner in which the template library is - // installed on the cluster. TODO (b/271878194): Decrement this + // installed on the cluster. // // Possible values: // "INSTALLATION_UNSPECIFIED" - No installation strategy has been @@ -7372,8 +7466,9 @@ type ProjectsLocationsFleetsPatchCall struct { // // - name: Output only. The full, unique resource name of this fleet in // the format of -// `projects/{project}/locations/{location}/fleets/{fleet}`. Each GCP -// project can have at most one fleet resource, named "default". +// `projects/{project}/locations/{location}/fleets/{fleet}`. Each +// Google Cloud project can have at most one fleet resource, named +// "default". func (r *ProjectsLocationsFleetsService) Patch(name string, fleet *Fleet) *ProjectsLocationsFleetsPatchCall { c := &ProjectsLocationsFleetsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -7488,7 +7583,7 @@ func (c *ProjectsLocationsFleetsPatchCall) Do(opts ...googleapi.CallOption) (*Op // ], // "parameters": { // "name": { - // "description": "Output only. The full, unique resource name of this fleet in the format of `projects/{project}/locations/{location}/fleets/{fleet}`. Each GCP project can have at most one fleet resource, named \"default\".", + // "description": "Output only. The full, unique resource name of this fleet in the format of `projects/{project}/locations/{location}/fleets/{fleet}`. Each Google Cloud project can have at most one fleet resource, named \"default\".", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/fleets/[^/]+$", // "required": true, diff --git a/gkehub/v1beta1/gkehub-api.json b/gkehub/v1beta1/gkehub-api.json index c6ff4afa1e2..cce750d7969 100644 --- a/gkehub/v1beta1/gkehub-api.json +++ b/gkehub/v1beta1/gkehub-api.json @@ -711,7 +711,7 @@ } } }, - "revision": "20230407", + "revision": "20230430", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "ApplianceCluster": { @@ -1088,7 +1088,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/gkehub/v1beta1/gkehub-gen.go b/gkehub/v1beta1/gkehub-gen.go index b1c9db6fe2a..6ccbfd1c3de 100644 --- a/gkehub/v1beta1/gkehub-gen.go +++ b/gkehub/v1beta1/gkehub-gen.go @@ -976,7 +976,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/gkehub/v2alpha/gkehub-api.json b/gkehub/v2alpha/gkehub-api.json index 048b72b2ac4..e54de9c9b27 100644 --- a/gkehub/v2alpha/gkehub-api.json +++ b/gkehub/v2alpha/gkehub-api.json @@ -280,7 +280,7 @@ } } }, - "revision": "20230310", + "revision": "20230430", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "CancelOperationRequest": { @@ -359,7 +359,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/gkehub/v2alpha/gkehub-gen.go b/gkehub/v2alpha/gkehub-gen.go index 47f6e7a8aaf..e8ae9b82143 100644 --- a/gkehub/v2alpha/gkehub-gen.go +++ b/gkehub/v2alpha/gkehub-gen.go @@ -305,7 +305,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/gkeonprem/v1/gkeonprem-api.json b/gkeonprem/v1/gkeonprem-api.json new file mode 100644 index 00000000000..ada6f3e69fa --- /dev/null +++ b/gkeonprem/v1/gkeonprem-api.json @@ -0,0 +1,6156 @@ +{ + "auth": { + "oauth2": { + "scopes": { + "https://www.googleapis.com/auth/cloud-platform": { + "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." + } + } + } + }, + "basePath": "", + "baseUrl": "https://gkeonprem.googleapis.com/", + "batchPath": "batch", + "canonicalName": "GKE On-Prem", + "description": "", + "discoveryVersion": "v1", + "documentationLink": "https://cloud.google.com/anthos/clusters/docs/on-prem/", + "fullyEncodeReservedExpansion": true, + "icons": { + "x16": "http://www.google.com/images/icons/product/search-16.gif", + "x32": "http://www.google.com/images/icons/product/search-32.gif" + }, + "id": "gkeonprem:v1", + "kind": "discovery#restDescription", + "mtlsRootUrl": "https://gkeonprem.mtls.googleapis.com/", + "name": "gkeonprem", + "ownerDomain": "google.com", + "ownerName": "Google", + "parameters": { + "$.xgafv": { + "description": "V1 error format.", + "enum": [ + "1", + "2" + ], + "enumDescriptions": [ + "v1 error format", + "v2 error format" + ], + "location": "query", + "type": "string" + }, + "access_token": { + "description": "OAuth access token.", + "location": "query", + "type": "string" + }, + "alt": { + "default": "json", + "description": "Data format for response.", + "enum": [ + "json", + "media", + "proto" + ], + "enumDescriptions": [ + "Responses with Content-Type of application/json", + "Media download with context-dependent Content-Type", + "Responses with Content-Type of application/x-protobuf" + ], + "location": "query", + "type": "string" + }, + "callback": { + "description": "JSONP", + "location": "query", + "type": "string" + }, + "fields": { + "description": "Selector specifying which fields to include in a partial response.", + "location": "query", + "type": "string" + }, + "key": { + "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", + "location": "query", + "type": "string" + }, + "oauth_token": { + "description": "OAuth 2.0 token for the current user.", + "location": "query", + "type": "string" + }, + "prettyPrint": { + "default": "true", + "description": "Returns response with indentations and line breaks.", + "location": "query", + "type": "boolean" + }, + "quotaUser": { + "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", + "location": "query", + "type": "string" + }, + "uploadType": { + "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", + "location": "query", + "type": "string" + }, + "upload_protocol": { + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", + "location": "query", + "type": "string" + } + }, + "protocol": "rest", + "resources": { + "projects": { + "resources": { + "locations": { + "methods": { + "get": { + "description": "Gets information about a location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Resource name for the location.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Location" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists information about the supported locations for this service.", + "flatPath": "v1/projects/{projectsId}/locations", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + "location": "query", + "type": "string" + }, + "name": { + "description": "The resource that owns the locations collection, if applicable.", + "location": "path", + "pattern": "^projects/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The maximum number of results to return. If not set, the service selects a default.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}/locations", + "response": { + "$ref": "ListLocationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "bareMetalAdminClusters": { + "methods": { + "create": { + "description": "Creates a new bare metal admin cluster in a given project and location. The API needs to be combined with creating a bootstrap cluster to work. See: https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/installing/creating-clusters/create-admin-cluster-api#prepare_bootstrap_environment", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.bareMetalAdminClusters.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "bareMetalAdminClusterId": { + "description": "Required. User provided identifier that is used as part of the resource name; must conform to RFC-1034 and additionally restrict to lower-cased letters. This comes out roughly to: /^a-z+[a-z0-9]$/", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent of the project and location where the cluster is created in. Format: \"projects/{project}/locations/{location}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Validate the request without actually doing any updates.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+parent}/bareMetalAdminClusters", + "request": { + "$ref": "BareMetalAdminCluster" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "enroll": { + "description": "Enrolls an existing bare metal admin cluster to the Anthos On-Prem API within a given project and location. Through enrollment, an existing admin cluster will become Anthos On-Prem API managed. The corresponding GCP resources will be created and all future modifications to the cluster will be expected to be performed through the API.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters:enroll", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.bareMetalAdminClusters.enroll", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent of the project and location where the cluster is enrolled in. Format: \"projects/{project}/locations/{location}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/bareMetalAdminClusters:enroll", + "request": { + "$ref": "EnrollBareMetalAdminClusterRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single bare metal admin cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters/{bareMetalAdminClustersId}", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.bareMetalAdminClusters.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the bare metal admin cluster to get. Format: \"projects/{project}/locations/{location}/bareMetalAdminClusters/{bare_metal_admin_cluster}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalAdminClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "BareMetalAdminCluster" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters/{bareMetalAdminClustersId}:getIamPolicy", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.bareMetalAdminClusters.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. 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).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalAdminClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists bare metal admin clusters in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.bareMetalAdminClusters.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Requested page size. Server may return fewer items than requested. If unspecified, at most 50 clusters will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A token identifying a page of results the server should return.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent of the project and location where the clusters are listed in. Format: \"projects/{project}/locations/{location}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "View for bare metal admin clusters. When `BASIC` is specified, only the admin cluster resource name and membership are returned. The default/unset value `CLUSTER_VIEW_UNSPECIFIED` is the same as `FULL', which returns the complete admin cluster configuration details.", + "enum": [ + "CLUSTER_VIEW_UNSPECIFIED", + "BASIC", + "FULL" + ], + "enumDescriptions": [ + "If the value is not set, the default `FULL` view is used.", + "Includes basic information of a admin cluster resource including admin cluster resource name and membership.", + "Includes the complete configuration for bare metal admin cluster resource. This is the default value for ListBareMetalAdminClustersRequest method." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/bareMetalAdminClusters", + "response": { + "$ref": "ListBareMetalAdminClustersResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single bare metal admin cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters/{bareMetalAdminClustersId}", + "httpMethod": "PATCH", + "id": "gkeonprem.projects.locations.bareMetalAdminClusters.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Immutable. The bare metal admin cluster resource name.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalAdminClusters/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. Field mask is used to specify the fields to be overwritten in the BareMetalAdminCluster resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all populated fields in the BareMetalAdminCluster message will be updated. Empty fields will be ignored unless a field mask is used.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "Validate the request without actually doing any updates.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "BareMetalAdminCluster" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "queryVersionConfig": { + "description": "Queries the bare metal admin cluster version config.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters:queryVersionConfig", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.bareMetalAdminClusters.queryVersionConfig", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent of the project and location to query for version config. Format: \"projects/{project}/locations/{location}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "upgradeConfig.clusterName": { + "description": "The admin cluster resource name. This is the full resource name of the admin cluster resource. Format: \"projects/{project}/locations/{location}/bareMetalAdminClusters/{bare_metal_admin_cluster}\"", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/bareMetalAdminClusters:queryVersionConfig", + "response": { + "$ref": "QueryBareMetalAdminVersionConfigResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters/{bareMetalAdminClustersId}:setIamPolicy", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.bareMetalAdminClusters.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalAdminClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters/{bareMetalAdminClustersId}:testIamPermissions", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.bareMetalAdminClusters.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalAdminClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "unenroll": { + "description": "Unenrolls an existing bare metal admin cluster from the Anthos On-Prem API within a given project and location. Unenrollment removes the Cloud reference to the cluster without modifying the underlying OnPrem Resources. Clusters will continue to run; however, they will no longer be accessible through the Anthos On-Prem API or its clients.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters/{bareMetalAdminClustersId}:unenroll", + "httpMethod": "DELETE", + "id": "gkeonprem.projects.locations.bareMetalAdminClusters.unenroll", + "parameterOrder": [ + "name" + ], + "parameters": { + "allowMissing": { + "description": "If set to true, and the bare metal admin cluster is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + "location": "query", + "type": "boolean" + }, + "etag": { + "description": "The current etag of the bare metal admin cluster. If an etag is provided and does not match the current etag of the cluster, deletion will be blocked and an ABORTED error will be returned.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. Name of the bare metal admin cluster to be unenrolled. Format: \"projects/{project}/locations/{location}/bareMetalAdminClusters/{cluster}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalAdminClusters/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Validate the request without actually doing any updates.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}:unenroll", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "operations": { + "methods": { + "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}/bareMetalAdminClusters/{bareMetalAdminClustersId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.bareMetalAdminClusters.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalAdminClusters/[^/]+/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}/bareMetalAdminClusters/{bareMetalAdminClustersId}/operations", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.bareMetalAdminClusters.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/[^/]+/bareMetalAdminClusters/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}/operations", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + }, + "bareMetalClusters": { + "methods": { + "create": { + "description": "Creates a new bare metal cluster in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.bareMetalClusters.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "bareMetalClusterId": { + "description": "Required. User provided identifier that is used as part of the resource name; must conform to RFC-1034 and additionally restrict to lower-cased letters. This comes out roughly to: /^a-z+[a-z0-9]$/", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent of the project and location where the cluster is created in. Format: \"projects/{project}/locations/{location}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Validate the request without actually doing any updates.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+parent}/bareMetalClusters", + "request": { + "$ref": "BareMetalCluster" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single bare metal Cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}", + "httpMethod": "DELETE", + "id": "gkeonprem.projects.locations.bareMetalClusters.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "allowMissing": { + "description": "If set to true, and the bare metal cluster is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + "location": "query", + "type": "boolean" + }, + "etag": { + "description": "The current etag of the bare metal Cluster. If an etag is provided and does not match the current etag of the cluster, deletion will be blocked and an ABORTED error will be returned.", + "location": "query", + "type": "string" + }, + "force": { + "description": "If set to true, any node pools from the cluster will also be deleted.", + "location": "query", + "type": "boolean" + }, + "ignoreErrors": { + "description": "If set to true, the deletion of a bare metal user cluster resource will succeed even if errors occur during deletion. This parameter can be used when you want to delete GCP's cluster resource and the on-prem admin cluster that hosts your user cluster is disconnected / unreachable or deleted. WARNING: Using this parameter when your user cluster still exists may result in a deleted GCP user cluster but an existing on-prem user cluster.", + "location": "query", + "type": "boolean" + }, + "name": { + "description": "Required. Name of the bare metal user cluster to be deleted. Format: \"projects/{project}/locations/{location}/bareMetalClusters/{bare_metal_cluster}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Validate the request without actually doing any updates.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "enroll": { + "description": "Enrolls an existing bare metal user cluster and its node pools to the Anthos On-Prem API within a given project and location. Through enrollment, an existing cluster will become Anthos On-Prem API managed. The corresponding GCP resources will be created and all future modifications to the cluster and/or its node pools will be expected to be performed through the API.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters:enroll", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.bareMetalClusters.enroll", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent of the project and location where the cluster is enrolled in. Format: \"projects/{project}/locations/{location}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/bareMetalClusters:enroll", + "request": { + "$ref": "EnrollBareMetalClusterRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single bare metal Cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.bareMetalClusters.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the bare metal user cluster to get. Format: \"projects/{project}/locations/{location}/bareMetalClusters/{bare_metal_cluster}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "BareMetalCluster" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}:getIamPolicy", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.bareMetalClusters.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. 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).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists bare metal clusters in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.bareMetalClusters.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "A resource filtering expression following https://google.aip.dev/160. When non-empty, only resource's whose attributes field matches the filter are returned.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Requested page size. Server may return fewer items than requested. If unspecified, at most 50 clusters will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A token identifying a page of results the server should return.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent of the project and location where the clusters are listed in. Format: \"projects/{project}/locations/{location}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "View for bare metal Clusters. When `BASIC` is specified, only the cluster resource name and admin cluster membership are returned. The default/unset value `CLUSTER_VIEW_UNSPECIFIED` is the same as `FULL', which returns the complete cluster configuration details.", + "enum": [ + "CLUSTER_VIEW_UNSPECIFIED", + "BASIC", + "FULL" + ], + "enumDescriptions": [ + "If the value is not set, the default `FULL` view is used.", + "Includes basic information of a cluster resource including cluster resource name and admin cluster membership.", + "Includes the complete configuration for bare metal cluster resource. This is the default value for ListBareMetalClustersRequest method." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/bareMetalClusters", + "response": { + "$ref": "ListBareMetalClustersResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single bare metal Cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}", + "httpMethod": "PATCH", + "id": "gkeonprem.projects.locations.bareMetalClusters.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "allowMissing": { + "description": "If set to true, and the bare metal cluster is not found, the request will create a new bare metal cluster with the provided configuration. The user must have both create and update permission to call Update with allow_missing set to true.", + "location": "query", + "type": "boolean" + }, + "name": { + "description": "Immutable. The bare metal user cluster resource name.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. Field mask is used to specify the fields to be overwritten in the BareMetalCluster resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all populated fields in the BareMetalCluster message will be updated. Empty fields will be ignored unless a field mask is used.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "Validate the request without actually doing any updates.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "BareMetalCluster" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "queryVersionConfig": { + "description": "Queries the bare metal user cluster version config.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters:queryVersionConfig", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.bareMetalClusters.queryVersionConfig", + "parameterOrder": [ + "parent" + ], + "parameters": { + "createConfig.adminClusterMembership": { + "description": "The admin cluster membership. This is the full resource name of the admin cluster's fleet membership. Format: \"projects/{project}/locations/{location}/memberships/{membership}\"", + "location": "query", + "type": "string" + }, + "createConfig.adminClusterName": { + "description": "The admin cluster resource name. This is the full resource name of the admin cluster resource. Format: \"projects/{project}/locations/{location}/bareMetalAdminClusters/{bare_metal_admin_cluster}\"", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent of the project and location to query for version config. Format: \"projects/{project}/locations/{location}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "upgradeConfig.clusterName": { + "description": "The user cluster resource name. This is the full resource name of the user cluster resource. Format: \"projects/{project}/locations/{location}/bareMetalClusters/{bare_metal_cluster}\"", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/bareMetalClusters:queryVersionConfig", + "response": { + "$ref": "QueryBareMetalVersionConfigResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}:setIamPolicy", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.bareMetalClusters.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}:testIamPermissions", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.bareMetalClusters.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "unenroll": { + "description": "Unenrolls an existing bare metal user cluster and its node pools from the Anthos On-Prem API within a given project and location. Unenrollment removes the Cloud reference to the cluster without modifying the underlying OnPrem Resources. Clusters and node pools will continue to run; however, they will no longer be accessible through the Anthos On-Prem API or its clients.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}:unenroll", + "httpMethod": "DELETE", + "id": "gkeonprem.projects.locations.bareMetalClusters.unenroll", + "parameterOrder": [ + "name" + ], + "parameters": { + "allowMissing": { + "description": "If set to true, and the bare metal cluster is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + "location": "query", + "type": "boolean" + }, + "etag": { + "description": "The current etag of the bare metal Cluster. If an etag is provided and does not match the current etag of the cluster, deletion will be blocked and an ABORTED error will be returned.", + "location": "query", + "type": "string" + }, + "force": { + "description": "This is required if the cluster has any associated node pools. When set, any child node pools will also be unenrolled.", + "location": "query", + "type": "boolean" + }, + "name": { + "description": "Required. Name of the bare metal user cluster to be unenrolled. Format: \"projects/{project}/locations/{location}/bareMetalClusters/{cluster}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Validate the request without actually doing any updates.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}:unenroll", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "bareMetalNodePools": { + "methods": { + "create": { + "description": "Creates a new bare metal node pool in a given project, location and Bare Metal cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "bareMetalNodePoolId": { + "description": "The ID to use for the node pool, which will become the final component of the node pool's resource name. This value must be up to 63 characters, and valid characters are /a-z-/. The value must not be permitted to be a UUID (or UUID-like: anything matching /^[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i).", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent resource where this node pool will be created. projects/{project}/locations/{location}/bareMetalClusters/{cluster}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "If set, only validate the request, but do not actually create the node pool.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+parent}/bareMetalNodePools", + "request": { + "$ref": "BareMetalNodePool" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single bare metal node pool.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}", + "httpMethod": "DELETE", + "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "allowMissing": { + "description": "If set to true, and the bare metal node pool is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + "location": "query", + "type": "boolean" + }, + "etag": { + "description": "The current etag of the BareMetalNodePool. If an etag is provided and does not match the current etag of the node pool, deletion will be blocked and an ABORTED error will be returned.", + "location": "query", + "type": "string" + }, + "ignoreErrors": { + "description": "If set to true, the deletion of a bare metal node pool resource will succeed even if errors occur during deletion. This parameter can be used when you want to delete GCP's node pool resource and you've already deleted the on-prem admin cluster that hosted your node pool. WARNING: Using this parameter when your user cluster still exists may result in a deleted GCP node pool but an existing on-prem node pool.", + "location": "query", + "type": "boolean" + }, + "name": { + "description": "Required. The name of the node pool to delete. Format: projects/{project}/locations/{location}/bareMetalClusters/{cluster}/bareMetalNodePools/{nodepool}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "If set, only validate the request, but do not actually delete the node pool.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "enroll": { + "description": "Enrolls an existing bare metal node pool to the Anthos On-Prem API within a given project and location. Through enrollment, an existing node pool will become Anthos On-Prem API managed. The corresponding GCP resources will be created.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools:enroll", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.enroll", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource where this node pool will be created. projects/{project}/locations/{location}/bareMetalClusters/{cluster}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/bareMetalNodePools:enroll", + "request": { + "$ref": "EnrollBareMetalNodePoolRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single bare metal node pool.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the node pool to retrieve. projects/{project}/locations/{location}/bareMetalClusters/{cluster}/bareMetalNodePools/{nodepool}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "BareMetalNodePool" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}:getIamPolicy", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. 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).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists bare metal node pools in a given project, location and bare metal cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "The maximum number of node pools to return. The service may return fewer than this value. If unspecified, at most 50 node pools will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A page token, received from a previous `ListBareMetalNodePools` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListBareMetalNodePools` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent, which owns this collection of node pools. Format: projects/{project}/locations/{location}/bareMetalClusters/{bareMetalCluster}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/bareMetalNodePools", + "response": { + "$ref": "ListBareMetalNodePoolsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single bare metal node pool.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}", + "httpMethod": "PATCH", + "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Immutable. The bare metal node pool resource name.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. Field mask is used to specify the fields to be overwritten in the BareMetalNodePool resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all populated fields in the BareMetalNodePool message will be updated. Empty fields will be ignored unless a field mask is used.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "Validate the request without actually doing any updates.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "BareMetalNodePool" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}:setIamPolicy", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}:testIamPermissions", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "unenroll": { + "description": "Unenrolls a bare metal node pool from Anthos On-Prem API.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}:unenroll", + "httpMethod": "DELETE", + "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.unenroll", + "parameterOrder": [ + "name" + ], + "parameters": { + "allowMissing": { + "description": "If set to true, and the bare metal node pool is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + "location": "query", + "type": "boolean" + }, + "etag": { + "description": "The current etag of the bare metal node pool. If an etag is provided and does not match the current etag of node pool, deletion will be blocked and an ABORTED error will be returned.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The name of the node pool to unenroll. Format: projects/{project}/locations/{location}/bareMetalClusters/{cluster}/bareMetalNodePools/{nodepool}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "If set, only validate the request, but do not actually unenroll the node pool.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}:unenroll", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "operations": { + "methods": { + "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}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+/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}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}/operations", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.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/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}/operations", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + }, + "operations": { + "methods": { + "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}/bareMetalClusters/{bareMetalClustersId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.bareMetalClusters.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/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}/bareMetalClusters/{bareMetalClustersId}/operations", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.bareMetalClusters.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/[^/]+/bareMetalClusters/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}/operations", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + }, + "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": "gkeonprem.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", + "request": { + "$ref": "CancelOperationRequest" + }, + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "DELETE", + "id": "gkeonprem.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": "gkeonprem.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": "gkeonprem.projects.locations.operations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "The standard list filter.", + "location": "query", + "type": "string" + }, + "name": { + "description": "The name of the operation's parent resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}/operations", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, + "vmwareAdminClusters": { + "methods": { + "enroll": { + "description": "Enrolls an existing VMware admin cluster to the Anthos On-Prem API within a given project and location. Through enrollment, an existing admin cluster will become Anthos On-Prem API managed. The corresponding GCP resources will be created and all future modifications to the cluster will be expected to be performed through the API.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareAdminClusters:enroll", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.vmwareAdminClusters.enroll", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent of the project and location where the cluster is enrolled in. Format: \"projects/{project}/locations/{location}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/vmwareAdminClusters:enroll", + "request": { + "$ref": "EnrollVmwareAdminClusterRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single VMware admin cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareAdminClusters/{vmwareAdminClustersId}", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.vmwareAdminClusters.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the VMware admin cluster to be returned. Format: \"projects/{project}/locations/{location}/vmwareAdminClusters/{vmware_admin_cluster}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareAdminClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "VmwareAdminCluster" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareAdminClusters/{vmwareAdminClustersId}:getIamPolicy", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.vmwareAdminClusters.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. 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).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareAdminClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists VMware admin clusters in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareAdminClusters", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.vmwareAdminClusters.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Requested page size. Server may return fewer items than requested. If unspecified, at most 50 clusters will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A token identifying a page of results the server should return.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent of the project and location where the clusters are listed in. Format: \"projects/{project}/locations/{location}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "View for VMware admin clusters. When `BASIC` is specified, only the admin cluster resource name and membership are returned. The default/unset value `CLUSTER_VIEW_UNSPECIFIED` is the same as `FULL', which returns the complete admin cluster configuration details.", + "enum": [ + "CLUSTER_VIEW_UNSPECIFIED", + "BASIC", + "FULL" + ], + "enumDescriptions": [ + "If the value is not set, the default `FULL` view is used.", + "Includes basic information of a admin cluster resource including admin cluster resource name and membership.", + "Includes the complete configuration for bare metal admin cluster resource. This is the default value for ListVmwareAdminClustersRequest method." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/vmwareAdminClusters", + "response": { + "$ref": "ListVmwareAdminClustersResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single VMware admin cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareAdminClusters/{vmwareAdminClustersId}", + "httpMethod": "PATCH", + "id": "gkeonprem.projects.locations.vmwareAdminClusters.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Immutable. The VMware admin cluster resource name.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareAdminClusters/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. Field mask is used to specify the fields to be overwritten in the VMwareAdminCluster resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all populated fields in the VmwareAdminCluster message will be updated. Empty fields will be ignored unless a field mask is used.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "Validate the request without actually doing any updates.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "VmwareAdminCluster" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareAdminClusters/{vmwareAdminClustersId}:setIamPolicy", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.vmwareAdminClusters.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareAdminClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareAdminClusters/{vmwareAdminClustersId}:testIamPermissions", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.vmwareAdminClusters.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareAdminClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "unenroll": { + "description": "Unenrolls an existing VMware admin cluster from the Anthos On-Prem API within a given project and location. Unenrollment removes the Cloud reference to the cluster without modifying the underlying OnPrem Resources. Clusters will continue to run; however, they will no longer be accessible through the Anthos On-Prem API or its clients.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareAdminClusters/{vmwareAdminClustersId}:unenroll", + "httpMethod": "DELETE", + "id": "gkeonprem.projects.locations.vmwareAdminClusters.unenroll", + "parameterOrder": [ + "name" + ], + "parameters": { + "allowMissing": { + "description": "If set to true, and the VMware admin cluster is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + "location": "query", + "type": "boolean" + }, + "etag": { + "description": "The current etag of the VMware admin cluster. If an etag is provided and does not match the current etag of the cluster, deletion will be blocked and an ABORTED error will be returned.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. Name of the VMware admin cluster to be unenrolled. Format: \"projects/{project}/locations/{location}/vmwareAdminClusters/{cluster}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareAdminClusters/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Validate the request without actually doing any updates.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}:unenroll", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "operations": { + "methods": { + "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}/vmwareAdminClusters/{vmwareAdminClustersId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.vmwareAdminClusters.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareAdminClusters/[^/]+/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}/vmwareAdminClusters/{vmwareAdminClustersId}/operations", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.vmwareAdminClusters.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/[^/]+/vmwareAdminClusters/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}/operations", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + }, + "vmwareClusters": { + "methods": { + "create": { + "description": "Creates a new VMware cluster in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.vmwareClusters.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent of the project and location where this cluster is created in. Format: \"projects/{project}/locations/{location}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Validate the request without actually doing any updates.", + "location": "query", + "type": "boolean" + }, + "vmwareClusterId": { + "description": "User provided identifier that is used as part of the resource name; This value must be up to 40 characters and follow RFC-1123 (https://tools.ietf.org/html/rfc1123) format.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/vmwareClusters", + "request": { + "$ref": "VmwareCluster" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single VMware Cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}", + "httpMethod": "DELETE", + "id": "gkeonprem.projects.locations.vmwareClusters.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "allowMissing": { + "description": "If set to true, and the VMware cluster is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + "location": "query", + "type": "boolean" + }, + "etag": { + "description": "The current etag of the VMware cluster. If an etag is provided and does not match the current etag of the cluster, deletion will be blocked and an ABORTED error will be returned.", + "location": "query", + "type": "string" + }, + "force": { + "description": "If set to true, any node pools from the cluster will also be deleted.", + "location": "query", + "type": "boolean" + }, + "ignoreErrors": { + "description": "If set to true, the deletion of a VMware user cluster resource will succeed even if errors occur during deletion. This parameter can be used when you want to delete GCP's cluster resource and the on-prem admin cluster that hosts your user cluster is disconnected / unreachable or deleted. WARNING: Using this parameter when your user cluster still exists may result in a deleted GCP user cluster but an existing on-prem user cluster.", + "location": "query", + "type": "boolean" + }, + "name": { + "description": "Required. Name of the VMware user cluster to be deleted. Format: \"projects/{project}/locations/{location}/vmwareClusters/{vmware_cluster}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Validate the request without actually doing any updates.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "enroll": { + "description": "Enrolls an existing VMware user cluster and its node pools to the Anthos On-Prem API within a given project and location. Through enrollment, an existing cluster will become Anthos On-Prem API managed. The corresponding GCP resources will be created and all future modifications to the cluster and/or its node pools will be expected to be performed through the API.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters:enroll", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.vmwareClusters.enroll", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent of the project and location where the cluster is Enrolled in. Format: \"projects/{project}/locations/{location}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/vmwareClusters:enroll", + "request": { + "$ref": "EnrollVmwareClusterRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single VMware Cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.vmwareClusters.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the VMware user cluster to be returned. Format: \"projects/{project}/locations/{location}/vmwareClusters/{vmware_cluster}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "VmwareCluster" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}:getIamPolicy", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.vmwareClusters.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. 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).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists VMware Clusters in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.vmwareClusters.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "A resource filtering expression following https://google.aip.dev/160. When non-empty, only resource's whose attributes field matches the filter are returned.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Requested page size. Server may return fewer items than requested. If unspecified, at most 50 clusters will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A token identifying a page of results the server should return.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent of the project and location where the clusters are listed in. Format: \"projects/{project}/locations/{location}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "View for VMware clusters. When `BASIC` is specified, only the cluster resource name and admin cluster membership are returned. The default/unset value `CLUSTER_VIEW_UNSPECIFIED` is the same as `FULL', which returns the complete cluster configuration details.", + "enum": [ + "CLUSTER_VIEW_UNSPECIFIED", + "BASIC", + "FULL" + ], + "enumDescriptions": [ + "If the value is not set, the default `FULL` view is used.", + "Includes basic information of a cluster resource including cluster resource name and admin cluster membership.", + "Includes the complete configuration for VMware cluster resource. This is the default value for ListVmwareClustersRequest method." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/vmwareClusters", + "response": { + "$ref": "ListVmwareClustersResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single VMware cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}", + "httpMethod": "PATCH", + "id": "gkeonprem.projects.locations.vmwareClusters.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Immutable. The VMware user cluster resource name.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. Field mask is used to specify the fields to be overwritten in the VMwareCluster resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all populated fields in the VmwareCluster message will be updated. Empty fields will be ignored unless a field mask is used.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "Validate the request without actually doing any updates.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "VmwareCluster" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "queryVersionConfig": { + "description": "Queries the VMware user cluster version config.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters:queryVersionConfig", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.vmwareClusters.queryVersionConfig", + "parameterOrder": [ + "parent" + ], + "parameters": { + "createConfig.adminClusterMembership": { + "description": "The admin cluster membership. This is the full resource name of the admin cluster's fleet membership. Format: \"projects/{project}/locations/{location}/memberships/{membership}\"", + "location": "query", + "type": "string" + }, + "createConfig.adminClusterName": { + "description": "The admin cluster resource name. This is the full resource name of the admin cluster resource. Format: \"projects/{project}/locations/{location}/vmwareAdminClusters/{vmware_admin_cluster}\"", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent of the project and location to query for version config. Format: \"projects/{project}/locations/{location}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "upgradeConfig.clusterName": { + "description": "The user cluster resource name. This is the full resource name of the user cluster resource. Format: \"projects/{project}/locations/{location}/vmwareClusters/{vmware_cluster}\"", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/vmwareClusters:queryVersionConfig", + "response": { + "$ref": "QueryVmwareVersionConfigResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}:setIamPolicy", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.vmwareClusters.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}:testIamPermissions", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.vmwareClusters.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "unenroll": { + "description": "Unenrolls an existing VMware user cluster and its node pools from the Anthos On-Prem API within a given project and location. Unenrollment removes the Cloud reference to the cluster without modifying the underlying OnPrem Resources. Clusters and node pools will continue to run; however, they will no longer be accessible through the Anthos On-Prem API or UI.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}:unenroll", + "httpMethod": "DELETE", + "id": "gkeonprem.projects.locations.vmwareClusters.unenroll", + "parameterOrder": [ + "name" + ], + "parameters": { + "allowMissing": { + "description": "If set to true, and the VMware cluster is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + "location": "query", + "type": "boolean" + }, + "etag": { + "description": "The current etag of the VMware Cluster. If an etag is provided and does not match the current etag of the cluster, deletion will be blocked and an ABORTED error will be returned.", + "location": "query", + "type": "string" + }, + "force": { + "description": "This is required if the cluster has any associated node pools. When set, any child node pools will also be unenrolled.", + "location": "query", + "type": "boolean" + }, + "name": { + "description": "Required. Name of the VMware user cluster to be unenrolled. Format: \"projects/{project}/locations/{location}/vmwareClusters/{vmware_cluster}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Validate the request without actually doing any updates.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}:unenroll", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "operations": { + "methods": { + "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}/vmwareClusters/{vmwareClustersId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.vmwareClusters.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/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}/vmwareClusters/{vmwareClustersId}/operations", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.vmwareClusters.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/[^/]+/vmwareClusters/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}/operations", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, + "vmwareNodePools": { + "methods": { + "create": { + "description": "Creates a new VMware node pool in a given project, location and VMWare cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource where this node pool will be created. projects/{project}/locations/{location}/vmwareClusters/{cluster}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "If set, only validate the request, but do not actually create the node pool.", + "location": "query", + "type": "boolean" + }, + "vmwareNodePoolId": { + "description": "The ID to use for the node pool, which will become the final component of the node pool's resource name. This value must be up to 40 characters and follow RFC-1123 (https://tools.ietf.org/html/rfc1123) format. The value must not be permitted to be a UUID (or UUID-like: anything matching /^[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i).", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/vmwareNodePools", + "request": { + "$ref": "VmwareNodePool" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single VMware node pool.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}", + "httpMethod": "DELETE", + "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "allowMissing": { + "description": "If set to true, and the VMware node pool is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + "location": "query", + "type": "boolean" + }, + "etag": { + "description": "The current etag of the VmwareNodePool. If an etag is provided and does not match the current etag of the node pool, deletion will be blocked and an ABORTED error will be returned.", + "location": "query", + "type": "string" + }, + "ignoreErrors": { + "description": "If set to true, the deletion of a VMware node pool resource will succeed even if errors occur during deletion. This parameter can be used when you want to delete GCP's node pool resource and you've already deleted the on-prem admin cluster that hosted your node pool. WARNING: Using this parameter when your user cluster still exists may result in a deleted GCP node pool but an existing on-prem node pool.", + "location": "query", + "type": "boolean" + }, + "name": { + "description": "Required. The name of the node pool to delete. Format: projects/{project}/locations/{location}/vmwareClusters/{cluster}/vmwareNodePools/{nodepool}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "If set, only validate the request, but do not actually delete the node pool.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "enroll": { + "description": "Enrolls a VMware node pool to Anthos On-Prem API", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools:enroll", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.enroll", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource where the node pool is enrolled in.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/vmwareNodePools:enroll", + "request": { + "$ref": "EnrollVmwareNodePoolRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single VMware node pool.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the node pool to retrieve. projects/{project}/locations/{location}/vmwareClusters/{cluster}/vmwareNodePools/{nodepool}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "VmwareNodePool" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}:getIamPolicy", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. 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).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists VMware node pools in a given project, location and VMWare cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "The maximum number of node pools to return. The service may return fewer than this value. If unspecified, at most 50 node pools will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A page token, received from a previous `ListVmwareNodePools` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListVmwareNodePools` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent, which owns this collection of node pools. Format: projects/{project}/locations/{location}/vmwareClusters/{vmwareCluster}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/vmwareNodePools", + "response": { + "$ref": "ListVmwareNodePoolsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single VMware node pool.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}", + "httpMethod": "PATCH", + "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Immutable. The resource name of this node pool.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. Field mask is used to specify the fields to be overwritten in the VMwareNodePool resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all populated fields in the VMwareNodePool message will be updated. Empty fields will be ignored unless a field mask is used.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "Validate the request without actually doing any updates.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "VmwareNodePool" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}:setIamPolicy", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "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.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}:testIamPermissions", + "httpMethod": "POST", + "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "unenroll": { + "description": "Unenrolls a VMware node pool to Anthos On-Prem API", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}:unenroll", + "httpMethod": "DELETE", + "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.unenroll", + "parameterOrder": [ + "name" + ], + "parameters": { + "etag": { + "description": "The current etag of the VMware node pool. If an etag is provided and does not match the current etag of node pool, deletion will be blocked and an ABORTED error will be returned.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The name of the node pool to unenroll. Format: projects/{project}/locations/{location}/vmwareClusters/{cluster}/vmwareNodePools/{nodepool}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "If set, only validate the request, but do not actually unenroll the node pool.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}:unenroll", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "operations": { + "methods": { + "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}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+/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}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}/operations", + "httpMethod": "GET", + "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.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/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}/operations", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + } + } + } + } + } + }, + "revision": "20230426", + "rootUrl": "https://gkeonprem.googleapis.com/", + "schemas": { + "Authorization": { + "description": "Authorization defines the On-Prem cluster authorization configuration to bootstrap onto the admin cluster.", + "id": "Authorization", + "properties": { + "adminUsers": { + "description": "Required. For VMware user, bare metal user and standalone clusters, users that will be granted the cluster-admin role on the cluster, providing full access to the cluster. For bare metal Admin cluster, users will be granted the view role, which is a view only access.", + "items": { + "$ref": "ClusterUser" + }, + "type": "array" + } + }, + "type": "object" + }, + "BareMetalAdminApiServerArgument": { + "description": "BareMetalAdminApiServerArgument represents an arg name-\u003evalue pair. Only a subset of customized flags are supported. Please refer to the API server documentation below to know the exact format: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/", + "id": "BareMetalAdminApiServerArgument", + "properties": { + "argument": { + "description": "Required. The argument name as it appears on the API Server command line please make sure to remove the leading dashes.", + "type": "string" + }, + "value": { + "description": "Required. The value of the arg as it will be passed to the API Server command line.", + "type": "string" + } + }, + "type": "object" + }, + "BareMetalAdminCluster": { + "description": "## Resource that represents a bare metal admin cluster.", + "id": "BareMetalAdminCluster", + "properties": { + "annotations": { + "additionalProperties": { + "type": "string" + }, + "description": "Annotations on the bare metal admin cluster. This field has the same restrictions as Kubernetes annotations. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.", + "type": "object" + }, + "bareMetalVersion": { + "description": "The Anthos clusters on bare metal version for the bare metal admin cluster.", + "type": "string" + }, + "clusterOperations": { + "$ref": "BareMetalAdminClusterOperationsConfig", + "description": "Cluster operations configuration." + }, + "controlPlane": { + "$ref": "BareMetalAdminControlPlaneConfig", + "description": "Control plane configuration." + }, + "createTime": { + "description": "Output only. The time at which this bare metal admin cluster was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "deleteTime": { + "description": "Output only. The time at which this bare metal admin cluster was deleted. If the resource is not deleted, this must be empty", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "A human readable description of this bare metal admin cluster.", + "type": "string" + }, + "endpoint": { + "description": "Output only. The IP address name of bare metal admin cluster's API server.", + "readOnly": true, + "type": "string" + }, + "etag": { + "description": "This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. Allows clients to perform consistent read-modify-writes through optimistic concurrency control.", + "type": "string" + }, + "fleet": { + "$ref": "Fleet", + "description": "Output only. Fleet configuration for the cluster.", + "readOnly": true + }, + "loadBalancer": { + "$ref": "BareMetalAdminLoadBalancerConfig", + "description": "Load balancer configuration." + }, + "localName": { + "description": "Output only. The object name of the bare metal cluster custom resource. This field is used to support conflicting names when enrolling existing clusters to the API. When used as a part of cluster enrollment, this field will differ from the ID in the resource name. For new clusters, this field will match the user provided cluster name and be visible in the last component of the resource name. It is not modifiable. All users should use this name to access their cluster using gkectl or kubectl and should expect to see the local name when viewing admin cluster controller logs.", + "readOnly": true, + "type": "string" + }, + "maintenanceConfig": { + "$ref": "BareMetalAdminMaintenanceConfig", + "description": "Maintenance configuration." + }, + "maintenanceStatus": { + "$ref": "BareMetalAdminMaintenanceStatus", + "description": "Output only. MaintenanceStatus representing state of maintenance.", + "readOnly": true + }, + "name": { + "description": "Immutable. The bare metal admin cluster resource name.", + "type": "string" + }, + "networkConfig": { + "$ref": "BareMetalAdminNetworkConfig", + "description": "Network configuration." + }, + "nodeAccessConfig": { + "$ref": "BareMetalAdminNodeAccessConfig", + "description": "Node access related configurations." + }, + "nodeConfig": { + "$ref": "BareMetalAdminWorkloadNodeConfig", + "description": "Workload node configuration." + }, + "osEnvironmentConfig": { + "$ref": "BareMetalAdminOsEnvironmentConfig", + "description": "OS environment related configurations." + }, + "proxy": { + "$ref": "BareMetalAdminProxyConfig", + "description": "Proxy configuration." + }, + "reconciling": { + "description": "Output only. If set, there are currently changes in flight to the bare metal Admin Cluster.", + "readOnly": true, + "type": "boolean" + }, + "securityConfig": { + "$ref": "BareMetalAdminSecurityConfig", + "description": "Security related configuration." + }, + "state": { + "description": "Output only. The current state of the bare metal admin cluster.", + "enum": [ + "STATE_UNSPECIFIED", + "PROVISIONING", + "RUNNING", + "RECONCILING", + "STOPPING", + "ERROR", + "DEGRADED" + ], + "enumDescriptions": [ + "Not set.", + "The PROVISIONING state indicates the cluster is being created.", + "The RUNNING state indicates the cluster has been created and is fully usable.", + "The RECONCILING state indicates that the cluster is being updated. It remains available, but potentially with degraded performance.", + "The STOPPING state indicates the cluster is being deleted.", + "The ERROR state indicates the cluster is in a broken unrecoverable state.", + "The DEGRADED state indicates the cluster requires user action to restore full functionality." + ], + "readOnly": true, + "type": "string" + }, + "status": { + "$ref": "ResourceStatus", + "description": "Output only. ResourceStatus representing detailed cluster status.", + "readOnly": true + }, + "storage": { + "$ref": "BareMetalAdminStorageConfig", + "description": "Storage configuration." + }, + "uid": { + "description": "Output only. The unique identifier of the bare metal admin cluster.", + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. The time at which this bare metal admin cluster was last updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "validationCheck": { + "$ref": "ValidationCheck", + "description": "Output only. ValidationCheck representing the result of the preflight check.", + "readOnly": true + } + }, + "type": "object" + }, + "BareMetalAdminClusterOperationsConfig": { + "description": "BareMetalAdminClusterOperationsConfig specifies the admin cluster's observability infrastructure.", + "id": "BareMetalAdminClusterOperationsConfig", + "properties": { + "enableApplicationLogs": { + "description": "Whether collection of application logs/metrics should be enabled (in addition to system logs/metrics).", + "type": "boolean" + } + }, + "type": "object" + }, + "BareMetalAdminControlPlaneConfig": { + "description": "BareMetalAdminControlPlaneConfig specifies the control plane configuration.", + "id": "BareMetalAdminControlPlaneConfig", + "properties": { + "apiServerArgs": { + "description": "Customizes the default API server args. Only a subset of customized flags are supported. Please refer to the API server documentation below to know the exact format: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/", + "items": { + "$ref": "BareMetalAdminApiServerArgument" + }, + "type": "array" + }, + "controlPlaneNodePoolConfig": { + "$ref": "BareMetalAdminControlPlaneNodePoolConfig", + "description": "Configures the node pool running the control plane. If specified the corresponding NodePool will be created for the cluster's control plane. The NodePool will have the same name and namespace as the cluster." + } + }, + "type": "object" + }, + "BareMetalAdminControlPlaneNodePoolConfig": { + "description": "BareMetalAdminControlPlaneNodePoolConfig specifies the control plane node pool configuration. We have a control plane specific node pool config so that we can flexible about supporting control plane specific fields in the future.", + "id": "BareMetalAdminControlPlaneNodePoolConfig", + "properties": { + "nodePoolConfig": { + "$ref": "BareMetalNodePoolConfig", + "description": "The generic configuration for a node pool running the control plane." + } + }, + "type": "object" + }, + "BareMetalAdminDrainedMachine": { + "description": "BareMetalAdminDrainedMachine represents the machines that are drained.", + "id": "BareMetalAdminDrainedMachine", + "properties": { + "nodeIp": { + "description": "Drained machine IP address.", + "type": "string" + } + }, + "type": "object" + }, + "BareMetalAdminDrainingMachine": { + "description": "BareMetalAdminDrainingMachine represents the machines that are currently draining.", + "id": "BareMetalAdminDrainingMachine", + "properties": { + "nodeIp": { + "description": "Draining machine IP address.", + "type": "string" + }, + "podCount": { + "description": "The count of pods yet to drain.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "BareMetalAdminIslandModeCidrConfig": { + "description": "BareMetalAdminIslandModeCidrConfig specifies the cluster CIDR configuration while running in island mode.", + "id": "BareMetalAdminIslandModeCidrConfig", + "properties": { + "podAddressCidrBlocks": { + "description": "Required. All pods in the cluster are assigned an RFC1918 IPv4 address from these ranges. This field cannot be changed after creation.", + "items": { + "type": "string" + }, + "type": "array" + }, + "serviceAddressCidrBlocks": { + "description": "Required. All services in the cluster are assigned an RFC1918 IPv4 address from these ranges. This field cannot be changed after creation.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "BareMetalAdminLoadBalancerConfig": { + "description": "BareMetalAdminLoadBalancerConfig specifies the load balancer configuration.", + "id": "BareMetalAdminLoadBalancerConfig", + "properties": { + "manualLbConfig": { + "$ref": "BareMetalAdminManualLbConfig", + "description": "Manually configured load balancers." + }, + "portConfig": { + "$ref": "BareMetalAdminPortConfig", + "description": "Configures the ports that the load balancer will listen on." + }, + "vipConfig": { + "$ref": "BareMetalAdminVipConfig", + "description": "The VIPs used by the load balancer." + } + }, + "type": "object" + }, + "BareMetalAdminMachineDrainStatus": { + "description": "BareMetalAdminMachineDrainStatus represents the status of bare metal node machines that are undergoing drain operations.", + "id": "BareMetalAdminMachineDrainStatus", + "properties": { + "drainedMachines": { + "description": "The list of drained machines.", + "items": { + "$ref": "BareMetalAdminDrainedMachine" + }, + "type": "array" + }, + "drainingMachines": { + "description": "The list of draning machines.", + "items": { + "$ref": "BareMetalAdminDrainingMachine" + }, + "type": "array" + } + }, + "type": "object" + }, + "BareMetalAdminMaintenanceConfig": { + "description": "BareMetalAdminMaintenanceConfig specifies configurations to put bare metal Admin cluster CRs nodes in and out of maintenance.", + "id": "BareMetalAdminMaintenanceConfig", + "properties": { + "maintenanceAddressCidrBlocks": { + "description": "Required. All IPv4 address from these ranges will be placed into maintenance mode. Nodes in maintenance mode will be cordoned and drained. When both of these are true, the \"baremetal.cluster.gke.io/maintenance\" annotation will be set on the node resource.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "BareMetalAdminMaintenanceStatus": { + "description": "BareMetalAdminMaintenanceStatus represents the maintenance status for bare metal Admin cluster CR's nodes.", + "id": "BareMetalAdminMaintenanceStatus", + "properties": { + "machineDrainStatus": { + "$ref": "BareMetalAdminMachineDrainStatus", + "description": "Represents the status of draining and drained machine nodes. This is used to show the progress of cluster upgrade." + } + }, + "type": "object" + }, + "BareMetalAdminManualLbConfig": { + "description": "BareMetalAdminManualLbConfig represents configuration parameters for a manual load balancer.", + "id": "BareMetalAdminManualLbConfig", + "properties": { + "enabled": { + "description": "Whether manual load balancing is enabled.", + "type": "boolean" + } + }, + "type": "object" + }, + "BareMetalAdminNetworkConfig": { + "description": "BareMetalAdminNetworkConfig specifies the cluster network configuration.", + "id": "BareMetalAdminNetworkConfig", + "properties": { + "islandModeCidr": { + "$ref": "BareMetalAdminIslandModeCidrConfig", + "description": "Configuration for Island mode CIDR." + } + }, + "type": "object" + }, + "BareMetalAdminNodeAccessConfig": { + "description": "Specifies the node access related settings for the bare metal admin cluster.", + "id": "BareMetalAdminNodeAccessConfig", + "properties": { + "loginUser": { + "description": "Required. LoginUser is the user name used to access node machines. It defaults to \"root\" if not set.", + "type": "string" + } + }, + "type": "object" + }, + "BareMetalAdminOsEnvironmentConfig": { + "description": "Specifies operating system operation settings for cluster provisioning.", + "id": "BareMetalAdminOsEnvironmentConfig", + "properties": { + "packageRepoExcluded": { + "description": "Whether the package repo should be added when initializing bare metal machines.", + "type": "boolean" + } + }, + "type": "object" + }, + "BareMetalAdminPortConfig": { + "description": "BareMetalAdminPortConfig is the specification of load balancer ports.", + "id": "BareMetalAdminPortConfig", + "properties": { + "controlPlaneLoadBalancerPort": { + "description": "The port that control plane hosted load balancers will listen on.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "BareMetalAdminProxyConfig": { + "description": "BareMetalAdminProxyConfig specifies the cluster proxy configuration.", + "id": "BareMetalAdminProxyConfig", + "properties": { + "noProxy": { + "description": "A list of IPs, hostnames, and domains that should skip the proxy. Examples: [\"127.0.0.1\", \"example.com\", \".corp\", \"localhost\"].", + "items": { + "type": "string" + }, + "type": "array" + }, + "uri": { + "description": "Required. Specifies the address of your proxy server. Examples: `http://domain` WARNING: Do not provide credentials in the format `http://(username:password@)domain` these will be rejected by the server.", + "type": "string" + } + }, + "type": "object" + }, + "BareMetalAdminSecurityConfig": { + "description": "Specifies the security related settings for the bare metal admin cluster.", + "id": "BareMetalAdminSecurityConfig", + "properties": { + "authorization": { + "$ref": "Authorization", + "description": "Configures user access to the admin cluster." + } + }, + "type": "object" + }, + "BareMetalAdminStorageConfig": { + "description": "BareMetalAdminStorageConfig specifies the cluster storage configuration.", + "id": "BareMetalAdminStorageConfig", + "properties": { + "lvpNodeMountsConfig": { + "$ref": "BareMetalLvpConfig", + "description": "Required. Specifies the config for local PersistentVolumes backed by mounted node disks. These disks need to be formatted and mounted by the user, which can be done before or after cluster creation." + }, + "lvpShareConfig": { + "$ref": "BareMetalLvpShareConfig", + "description": "Required. Specifies the config for local PersistentVolumes backed by subdirectories in a shared filesystem. These subdirectores are automatically created during cluster creation." + } + }, + "type": "object" + }, + "BareMetalAdminVipConfig": { + "description": "BareMetalAdminVipConfig for bare metal load balancer configurations.", + "id": "BareMetalAdminVipConfig", + "properties": { + "controlPlaneVip": { + "description": "The VIP which you previously set aside for the Kubernetes API of this bare metal admin cluster.", + "type": "string" + } + }, + "type": "object" + }, + "BareMetalAdminWorkloadNodeConfig": { + "description": "BareMetalAdminWorkloadNodeConfig specifies the workload node configurations.", + "id": "BareMetalAdminWorkloadNodeConfig", + "properties": { + "maxPodsPerNode": { + "description": "The maximum number of pods a node can run. The size of the CIDR range assigned to the node will be derived from this parameter. By default 110 Pods are created per Node. Upper bound is 250 for both HA and non-HA admin cluster. Lower bound is 64 for non-HA admin cluster and 32 for HA admin cluster.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "BareMetalApiServerArgument": { + "description": "Represents an arg name-\u003evalue pair. Only a subset of customized flags are supported. For the exact format, refer to the [API server documentation](https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/).", + "id": "BareMetalApiServerArgument", + "properties": { + "argument": { + "description": "Required. The argument name as it appears on the API Server command line, make sure to remove the leading dashes.", + "type": "string" + }, + "value": { + "description": "Required. The value of the arg as it will be passed to the API Server command line.", + "type": "string" + } + }, + "type": "object" + }, + "BareMetalBgpLbConfig": { + "description": "BareMetalBgpLbConfig represents configuration parameters for a Border Gateway Protocol (BGP) load balancer.", + "id": "BareMetalBgpLbConfig", + "properties": { + "addressPools": { + "description": "Required. AddressPools is a list of non-overlapping IP pools used by load balancer typed services. All addresses must be routable to load balancer nodes. IngressVIP must be included in the pools.", + "items": { + "$ref": "BareMetalLoadBalancerAddressPool" + }, + "type": "array" + }, + "asn": { + "description": "Required. BGP autonomous system number (ASN) of the cluster. This field can be updated after cluster creation.", + "format": "int64", + "type": "string" + }, + "bgpPeerConfigs": { + "description": "Required. The list of BGP peers that the cluster will connect to. At least one peer must be configured for each control plane node. Control plane nodes will connect to these peers to advertise the control plane VIP. The Services load balancer also uses these peers by default. This field can be updated after cluster creation.", + "items": { + "$ref": "BareMetalBgpPeerConfig" + }, + "type": "array" + }, + "loadBalancerNodePoolConfig": { + "$ref": "BareMetalLoadBalancerNodePoolConfig", + "description": "Specifies the node pool running data plane load balancing. L2 connectivity is required among nodes in this pool. If missing, the control plane node pool is used for data plane load balancing." + } + }, + "type": "object" + }, + "BareMetalBgpPeerConfig": { + "description": "BareMetalBgpPeerConfig represents configuration parameters for a Border Gateway Protocol (BGP) peer.", + "id": "BareMetalBgpPeerConfig", + "properties": { + "asn": { + "description": "Required. BGP autonomous system number (ASN) for the network that contains the external peer device.", + "format": "int64", + "type": "string" + }, + "controlPlaneNodes": { + "description": "The IP address of the control plane node that connects to the external peer. If you don't specify any control plane nodes, all control plane nodes can connect to the external peer. If you specify one or more IP addresses, only the nodes specified participate in peering sessions.", + "items": { + "type": "string" + }, + "type": "array" + }, + "ipAddress": { + "description": "Required. The IP address of the external peer device.", + "type": "string" + } + }, + "type": "object" + }, + "BareMetalCluster": { + "description": "Resource that represents a bare metal user cluster.", + "id": "BareMetalCluster", + "properties": { + "adminClusterMembership": { + "description": "Required. The admin cluster this bare metal user cluster belongs to. This is the full resource name of the admin cluster's fleet membership.", + "type": "string" + }, + "adminClusterName": { + "description": "Output only. The resource name of the bare metal admin cluster managing this user cluster.", + "readOnly": true, + "type": "string" + }, + "annotations": { + "additionalProperties": { + "type": "string" + }, + "description": "Annotations on the bare metal user cluster. This field has the same restrictions as Kubernetes annotations. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.", + "type": "object" + }, + "bareMetalVersion": { + "description": "Required. The Anthos clusters on bare metal version for your user cluster.", + "type": "string" + }, + "clusterOperations": { + "$ref": "BareMetalClusterOperationsConfig", + "description": "Cluster operations configuration." + }, + "controlPlane": { + "$ref": "BareMetalControlPlaneConfig", + "description": "Required. Control plane configuration." + }, + "createTime": { + "description": "Output only. The time when the bare metal user cluster was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "deleteTime": { + "description": "Output only. The time when the bare metal user cluster was deleted. If the resource is not deleted, this must be empty", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "A human readable description of this bare metal user cluster.", + "type": "string" + }, + "endpoint": { + "description": "Output only. The IP address of the bare metal user cluster's API server.", + "readOnly": true, + "type": "string" + }, + "etag": { + "description": "Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. Allows clients to perform consistent read-modify-writes through optimistic concurrency control.", + "readOnly": true, + "type": "string" + }, + "fleet": { + "$ref": "Fleet", + "description": "Output only. Fleet configuration for the cluster.", + "readOnly": true + }, + "loadBalancer": { + "$ref": "BareMetalLoadBalancerConfig", + "description": "Required. Load balancer configuration." + }, + "localName": { + "description": "Output only. The object name of the bare metal user cluster custom resource on the associated admin cluster. This field is used to support conflicting names when enrolling existing clusters to the API. When used as a part of cluster enrollment, this field will differ from the name in the resource name. For new clusters, this field will match the user provided cluster name and be visible in the last component of the resource name. It is not modifiable. When the local name and cluster name differ, the local name is used in the admin cluster controller logs. You use the cluster name when accessing the cluster using bmctl and kubectl.", + "readOnly": true, + "type": "string" + }, + "maintenanceConfig": { + "$ref": "BareMetalMaintenanceConfig", + "description": "Maintenance configuration." + }, + "maintenanceStatus": { + "$ref": "BareMetalMaintenanceStatus", + "description": "Output only. Status of on-going maintenance tasks.", + "readOnly": true + }, + "name": { + "description": "Immutable. The bare metal user cluster resource name.", + "type": "string" + }, + "networkConfig": { + "$ref": "BareMetalNetworkConfig", + "description": "Required. Network configuration." + }, + "nodeAccessConfig": { + "$ref": "BareMetalNodeAccessConfig", + "description": "Node access related configurations." + }, + "nodeConfig": { + "$ref": "BareMetalWorkloadNodeConfig", + "description": "Workload node configuration." + }, + "osEnvironmentConfig": { + "$ref": "BareMetalOsEnvironmentConfig", + "description": "OS environment related configurations." + }, + "proxy": { + "$ref": "BareMetalProxyConfig", + "description": "Proxy configuration." + }, + "reconciling": { + "description": "Output only. If set, there are currently changes in flight to the bare metal user cluster.", + "readOnly": true, + "type": "boolean" + }, + "securityConfig": { + "$ref": "BareMetalSecurityConfig", + "description": "Security related setting configuration." + }, + "state": { + "description": "Output only. The current state of the bare metal user cluster.", + "enum": [ + "STATE_UNSPECIFIED", + "PROVISIONING", + "RUNNING", + "RECONCILING", + "STOPPING", + "ERROR", + "DEGRADED" + ], + "enumDescriptions": [ + "Not set.", + "The PROVISIONING state indicates the cluster is being created.", + "The RUNNING state indicates the cluster has been created and is fully usable.", + "The RECONCILING state indicates that the cluster is being updated. It remains available, but potentially with degraded performance.", + "The STOPPING state indicates the cluster is being deleted.", + "The ERROR state indicates the cluster is in a broken unrecoverable state.", + "The DEGRADED state indicates the cluster requires user action to restore full functionality." + ], + "readOnly": true, + "type": "string" + }, + "status": { + "$ref": "ResourceStatus", + "description": "Output only. Detailed cluster status.", + "readOnly": true + }, + "storage": { + "$ref": "BareMetalStorageConfig", + "description": "Required. Storage configuration." + }, + "uid": { + "description": "Output only. The unique identifier of the bare metal user cluster.", + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. The time when the bare metal user cluster was last updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "validationCheck": { + "$ref": "ValidationCheck", + "description": "Output only. The result of the preflight check.", + "readOnly": true + } + }, + "type": "object" + }, + "BareMetalClusterOperationsConfig": { + "description": "Specifies the bare metal user cluster's observability infrastructure.", + "id": "BareMetalClusterOperationsConfig", + "properties": { + "enableApplicationLogs": { + "description": "Whether collection of application logs/metrics should be enabled (in addition to system logs/metrics).", + "type": "boolean" + } + }, + "type": "object" + }, + "BareMetalControlPlaneConfig": { + "description": "Specifies the control plane configuration.", + "id": "BareMetalControlPlaneConfig", + "properties": { + "apiServerArgs": { + "description": "Customizes the default API server args. Only a subset of customized flags are supported. For the exact format, refer to the [API server documentation](https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/).", + "items": { + "$ref": "BareMetalApiServerArgument" + }, + "type": "array" + }, + "controlPlaneNodePoolConfig": { + "$ref": "BareMetalControlPlaneNodePoolConfig", + "description": "Required. Configures the node pool running the control plane." + } + }, + "type": "object" + }, + "BareMetalControlPlaneNodePoolConfig": { + "description": "Specifies the control plane node pool configuration.", + "id": "BareMetalControlPlaneNodePoolConfig", + "properties": { + "nodePoolConfig": { + "$ref": "BareMetalNodePoolConfig", + "description": "Required. The generic configuration for a node pool running the control plane." + } + }, + "type": "object" + }, + "BareMetalDrainedMachine": { + "description": "Represents a machine that is currently drained.", + "id": "BareMetalDrainedMachine", + "properties": { + "nodeIp": { + "description": "Drained machine IP address.", + "type": "string" + } + }, + "type": "object" + }, + "BareMetalDrainingMachine": { + "description": "Represents a machine that is currently draining.", + "id": "BareMetalDrainingMachine", + "properties": { + "nodeIp": { + "description": "Draining machine IP address.", + "type": "string" + }, + "podCount": { + "description": "The count of pods yet to drain.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "BareMetalIslandModeCidrConfig": { + "description": "Specifies the cluster CIDR configuration while running in island mode.", + "id": "BareMetalIslandModeCidrConfig", + "properties": { + "podAddressCidrBlocks": { + "description": "Required. All pods in the cluster are assigned an RFC1918 IPv4 address from these ranges. This field cannot be changed after creation.", + "items": { + "type": "string" + }, + "type": "array" + }, + "serviceAddressCidrBlocks": { + "description": "Required. All services in the cluster are assigned an RFC1918 IPv4 address from these ranges. This field is mutable after creation starting with version 1.15.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "BareMetalKubeletConfig": { + "description": "KubeletConfig defines the modifiable kubelet configurations for baremetal machines. Note: this list includes fields supported in GKE (see https://cloud.google.com/kubernetes-engine/docs/how-to/node-system-config#kubelet-options).", + "id": "BareMetalKubeletConfig", + "properties": { + "registryBurst": { + "description": "The maximum size of bursty pulls, temporarily allows pulls to burst to this number, while still not exceeding registry_pull_qps. The value must not be a negative number. Updating this field may impact scalability by changing the amount of traffic produced by image pulls. Defaults to 10.", + "format": "int32", + "type": "integer" + }, + "registryPullQps": { + "description": "The limit of registry pulls per second. Setting this value to 0 means no limit. Updating this field may impact scalability by changing the amount of traffic produced by image pulls. Defaults to 5.", + "format": "int32", + "type": "integer" + }, + "serializeImagePullsDisabled": { + "description": "Prevents the Kubelet from pulling multiple images at a time. We recommend *not* changing the default value on nodes that run docker daemon with version \u003c 1.9 or an Another Union File System (Aufs) storage backend. Issue https://github.com/kubernetes/kubernetes/issues/10959 has more details.", + "type": "boolean" + } + }, + "type": "object" + }, + "BareMetalLoadBalancerAddressPool": { + "description": "Represents an IP pool used by the load balancer.", + "id": "BareMetalLoadBalancerAddressPool", + "properties": { + "addresses": { + "description": "Required. The addresses that are part of this pool. Each address must be either in the CIDR form (1.2.3.0/24) or range form (1.2.3.1-1.2.3.5).", + "items": { + "type": "string" + }, + "type": "array" + }, + "avoidBuggyIps": { + "description": "If true, avoid using IPs ending in .0 or .255. This avoids buggy consumer devices mistakenly dropping IPv4 traffic for those special IP addresses.", + "type": "boolean" + }, + "manualAssign": { + "description": "If true, prevent IP addresses from being automatically assigned.", + "type": "boolean" + }, + "pool": { + "description": "Required. The name of the address pool.", + "type": "string" + } + }, + "type": "object" + }, + "BareMetalLoadBalancerConfig": { + "description": "Specifies the load balancer configuration.", + "id": "BareMetalLoadBalancerConfig", + "properties": { + "bgpLbConfig": { + "$ref": "BareMetalBgpLbConfig", + "description": "Configuration for BGP typed load balancers. When set network_config.advanced_networking is automatically set to true." + }, + "manualLbConfig": { + "$ref": "BareMetalManualLbConfig", + "description": "Manually configured load balancers." + }, + "metalLbConfig": { + "$ref": "BareMetalMetalLbConfig", + "description": "Configuration for MetalLB load balancers." + }, + "portConfig": { + "$ref": "BareMetalPortConfig", + "description": "Configures the ports that the load balancer will listen on." + }, + "vipConfig": { + "$ref": "BareMetalVipConfig", + "description": "The VIPs used by the load balancer." + } + }, + "type": "object" + }, + "BareMetalLoadBalancerNodePoolConfig": { + "description": "Specifies the load balancer's node pool configuration.", + "id": "BareMetalLoadBalancerNodePoolConfig", + "properties": { + "nodePoolConfig": { + "$ref": "BareMetalNodePoolConfig", + "description": "The generic configuration for a node pool running a load balancer." + } + }, + "type": "object" + }, + "BareMetalLvpConfig": { + "description": "Specifies the configs for local persistent volumes (PVs).", + "id": "BareMetalLvpConfig", + "properties": { + "path": { + "description": "Required. The host machine path.", + "type": "string" + }, + "storageClass": { + "description": "Required. The StorageClass name that PVs will be created with.", + "type": "string" + } + }, + "type": "object" + }, + "BareMetalLvpShareConfig": { + "description": "Specifies the configs for local persistent volumes under a shared file system.", + "id": "BareMetalLvpShareConfig", + "properties": { + "lvpConfig": { + "$ref": "BareMetalLvpConfig", + "description": "Required. Defines the machine path and storage class for the LVP Share." + }, + "sharedPathPvCount": { + "description": "The number of subdirectories to create under path.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "BareMetalMachineDrainStatus": { + "description": "Represents the status of node machines that are undergoing drain operations.", + "id": "BareMetalMachineDrainStatus", + "properties": { + "drainedMachines": { + "description": "The list of drained machines.", + "items": { + "$ref": "BareMetalDrainedMachine" + }, + "type": "array" + }, + "drainingMachines": { + "description": "The list of draning machines.", + "items": { + "$ref": "BareMetalDrainingMachine" + }, + "type": "array" + } + }, + "type": "object" + }, + "BareMetalMaintenanceConfig": { + "description": "Specifies configurations to put bare metal nodes in and out of maintenance.", + "id": "BareMetalMaintenanceConfig", + "properties": { + "maintenanceAddressCidrBlocks": { + "description": "Required. All IPv4 address from these ranges will be placed into maintenance mode. Nodes in maintenance mode will be cordoned and drained. When both of these are true, the \"baremetal.cluster.gke.io/maintenance\" annotation will be set on the node resource.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "BareMetalMaintenanceStatus": { + "description": "Represents the maintenance status of the bare metal user cluster.", + "id": "BareMetalMaintenanceStatus", + "properties": { + "machineDrainStatus": { + "$ref": "BareMetalMachineDrainStatus", + "description": "The maintenance status of node machines." + } + }, + "type": "object" + }, + "BareMetalManualLbConfig": { + "description": "Represents configuration parameters for a manual load balancer.", + "id": "BareMetalManualLbConfig", + "properties": { + "enabled": { + "description": "Whether manual load balancing is enabled.", + "type": "boolean" + } + }, + "type": "object" + }, + "BareMetalMetalLbConfig": { + "description": "Represents configuration parameters for a MetalLB load balancer.", + "id": "BareMetalMetalLbConfig", + "properties": { + "addressPools": { + "description": "Required. AddressPools is a list of non-overlapping IP pools used by load balancer typed services. All addresses must be routable to load balancer nodes. IngressVIP must be included in the pools.", + "items": { + "$ref": "BareMetalLoadBalancerAddressPool" + }, + "type": "array" + }, + "loadBalancerNodePoolConfig": { + "$ref": "BareMetalLoadBalancerNodePoolConfig", + "description": "Specifies the node pool running the load balancer. L2 connectivity is required among nodes in this pool. If missing, the control plane node pool is used as the load balancer pool." + } + }, + "type": "object" + }, + "BareMetalMultipleNetworkInterfacesConfig": { + "description": "Specifies the multiple networking interfaces cluster configuration.", + "id": "BareMetalMultipleNetworkInterfacesConfig", + "properties": { + "enabled": { + "description": "Whether to enable multiple network interfaces for your pods. When set network_config.advanced_networking is automatically set to true.", + "type": "boolean" + } + }, + "type": "object" + }, + "BareMetalNetworkConfig": { + "description": "Specifies the cluster network configuration.", + "id": "BareMetalNetworkConfig", + "properties": { + "advancedNetworking": { + "description": "Enables the use of advanced Anthos networking features, such as Bundled Load Balancing with BGP or the egress NAT gateway. Setting configuration for advanced networking features will automatically set this flag.", + "type": "boolean" + }, + "islandModeCidr": { + "$ref": "BareMetalIslandModeCidrConfig", + "description": "Configuration for island mode CIDR. In an island-mode network, nodes have unique IP addresses, but pods don't have unique addresses across clusters. This doesn't cause problems because pods in one cluster never directly communicate with pods in another cluster. Instead, there are gateways that mediate between a pod in one cluster and a pod in another cluster." + }, + "multipleNetworkInterfacesConfig": { + "$ref": "BareMetalMultipleNetworkInterfacesConfig", + "description": "Configuration for multiple network interfaces." + }, + "srIovConfig": { + "$ref": "BareMetalSrIovConfig", + "description": "Configuration for SR-IOV." + } + }, + "type": "object" + }, + "BareMetalNodeAccessConfig": { + "description": "Specifies the node access related settings for the bare metal user cluster.", + "id": "BareMetalNodeAccessConfig", + "properties": { + "loginUser": { + "description": "LoginUser is the user name used to access node machines. It defaults to \"root\" if not set.", + "type": "string" + } + }, + "type": "object" + }, + "BareMetalNodeConfig": { + "description": "BareMetalNodeConfig lists machine addresses to access Nodes.", + "id": "BareMetalNodeConfig", + "properties": { + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "The labels assigned to this node. An object containing a list of key/value pairs. The labels here, unioned with the labels set on BareMetalNodePoolConfig are the set of labels that will be applied to the node. If there are any conflicts, the BareMetalNodeConfig labels take precedence. Example: { \"name\": \"wrench\", \"mass\": \"1.3kg\", \"count\": \"3\" }.", + "type": "object" + }, + "nodeIp": { + "description": "The default IPv4 address for SSH access and Kubernetes node. Example: 192.168.0.1", + "type": "string" + } + }, + "type": "object" + }, + "BareMetalNodePool": { + "description": "Resource that represents a bare metal node pool.", + "id": "BareMetalNodePool", + "properties": { + "annotations": { + "additionalProperties": { + "type": "string" + }, + "description": "Annotations on the bare metal node pool. This field has the same restrictions as Kubernetes annotations. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.", + "type": "object" + }, + "createTime": { + "description": "Output only. The time at which this bare metal node pool was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "deleteTime": { + "description": "Output only. The time at which this bare metal node pool was deleted. If the resource is not deleted, this must be empty", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "The display name for the bare metal node pool.", + "type": "string" + }, + "etag": { + "description": "This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. Allows clients to perform consistent read-modify-writes through optimistic concurrency control.", + "type": "string" + }, + "name": { + "description": "Immutable. The bare metal node pool resource name.", + "type": "string" + }, + "nodePoolConfig": { + "$ref": "BareMetalNodePoolConfig", + "description": "Required. Node pool configuration." + }, + "reconciling": { + "description": "Output only. If set, there are currently changes in flight to the bare metal node pool.", + "readOnly": true, + "type": "boolean" + }, + "state": { + "description": "Output only. The current state of the bare metal node pool.", + "enum": [ + "STATE_UNSPECIFIED", + "PROVISIONING", + "RUNNING", + "RECONCILING", + "STOPPING", + "ERROR", + "DEGRADED" + ], + "enumDescriptions": [ + "Not set.", + "The PROVISIONING state indicates the bare metal node pool is being created.", + "The RUNNING state indicates the bare metal node pool has been created and is fully usable.", + "The RECONCILING state indicates that the bare metal node pool is being updated. It remains available, but potentially with degraded performance.", + "The STOPPING state indicates the bare metal node pool is being deleted.", + "The ERROR state indicates the bare metal node pool is in a broken unrecoverable state.", + "The DEGRADED state indicates the bare metal node pool requires user action to restore full functionality." + ], + "readOnly": true, + "type": "string" + }, + "status": { + "$ref": "ResourceStatus", + "description": "Output only. ResourceStatus representing the detailed node pool status.", + "readOnly": true + }, + "uid": { + "description": "Output only. The unique identifier of the bare metal node pool.", + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. The time at which this bare metal node pool was last updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "BareMetalNodePoolConfig": { + "description": "BareMetalNodePoolConfig describes the configuration of all nodes within a given bare metal node pool.", + "id": "BareMetalNodePoolConfig", + "properties": { + "kubeletConfig": { + "$ref": "BareMetalKubeletConfig", + "description": "The modifiable kubelet configurations for the baremetal machines." + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "The labels assigned to nodes of this node pool. An object containing a list of key/value pairs. Example: { \"name\": \"wrench\", \"mass\": \"1.3kg\", \"count\": \"3\" }.", + "type": "object" + }, + "nodeConfigs": { + "description": "Required. The list of machine addresses in the bare metal node pool.", + "items": { + "$ref": "BareMetalNodeConfig" + }, + "type": "array" + }, + "operatingSystem": { + "description": "Specifies the nodes operating system (default: LINUX).", + "enum": [ + "OPERATING_SYSTEM_UNSPECIFIED", + "LINUX" + ], + "enumDescriptions": [ + "No operating system runtime selected.", + "Linux operating system." + ], + "type": "string" + }, + "taints": { + "description": "The initial taints assigned to nodes of this node pool.", + "items": { + "$ref": "NodeTaint" + }, + "type": "array" + } + }, + "type": "object" + }, + "BareMetalOsEnvironmentConfig": { + "description": "Specifies operating system settings for cluster provisioning.", + "id": "BareMetalOsEnvironmentConfig", + "properties": { + "packageRepoExcluded": { + "description": "Whether the package repo should not be included when initializing bare metal machines.", + "type": "boolean" + } + }, + "type": "object" + }, + "BareMetalPortConfig": { + "description": "Specifies load balancer ports for the bare metal user cluster.", + "id": "BareMetalPortConfig", + "properties": { + "controlPlaneLoadBalancerPort": { + "description": "The port that control plane hosted load balancers will listen on.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "BareMetalProxyConfig": { + "description": "Specifies the cluster proxy configuration.", + "id": "BareMetalProxyConfig", + "properties": { + "noProxy": { + "description": "A list of IPs, hostnames, and domains that should skip the proxy. Examples: [\"127.0.0.1\", \"example.com\", \".corp\", \"localhost\"].", + "items": { + "type": "string" + }, + "type": "array" + }, + "uri": { + "description": "Required. Specifies the address of your proxy server. Examples: `http://domain` Do not provide credentials in the format `http://(username:password@)domain` these will be rejected by the server.", + "type": "string" + } + }, + "type": "object" + }, + "BareMetalSecurityConfig": { + "description": "Specifies the security related settings for the bare metal user cluster.", + "id": "BareMetalSecurityConfig", + "properties": { + "authorization": { + "$ref": "Authorization", + "description": "Configures user access to the user cluster." + } + }, + "type": "object" + }, + "BareMetalSrIovConfig": { + "description": "Specifies the SR-IOV networking operator config.", + "id": "BareMetalSrIovConfig", + "properties": { + "enabled": { + "description": "Whether to install the SR-IOV operator.", + "type": "boolean" + } + }, + "type": "object" + }, + "BareMetalStorageConfig": { + "description": "BareMetalStorageConfig specifies the cluster storage configuration.", + "id": "BareMetalStorageConfig", + "properties": { + "lvpNodeMountsConfig": { + "$ref": "BareMetalLvpConfig", + "description": "Required. Specifies the config for local PersistentVolumes backed by mounted node disks. These disks need to be formatted and mounted by the user, which can be done before or after cluster creation." + }, + "lvpShareConfig": { + "$ref": "BareMetalLvpShareConfig", + "description": "Required. Specifies the config for local PersistentVolumes backed by subdirectories in a shared filesystem. These subdirectores are automatically created during cluster creation." + } + }, + "type": "object" + }, + "BareMetalVersionInfo": { + "description": "Contains information about a specific Anthos on bare metal version.", + "id": "BareMetalVersionInfo", + "properties": { + "hasDependencies": { + "description": "If set, the cluster dependencies (e.g. the admin cluster, other user clusters managed by the same admin cluster, version skew policy, etc) must be upgraded before this version can be installed or upgraded to.", + "type": "boolean" + }, + "version": { + "description": "Version number e.g. 1.13.1.", + "type": "string" + } + }, + "type": "object" + }, + "BareMetalVipConfig": { + "description": "Specifies the VIP config for the bare metal load balancer.", + "id": "BareMetalVipConfig", + "properties": { + "controlPlaneVip": { + "description": "The VIP which you previously set aside for the Kubernetes API of this bare metal user cluster.", + "type": "string" + }, + "ingressVip": { + "description": "The VIP which you previously set aside for ingress traffic into this bare metal user cluster.", + "type": "string" + } + }, + "type": "object" + }, + "BareMetalWorkloadNodeConfig": { + "description": "Specifies the workload node configurations.", + "id": "BareMetalWorkloadNodeConfig", + "properties": { + "containerRuntime": { + "description": "Specifies which container runtime will be used.", + "enum": [ + "CONTAINER_RUNTIME_UNSPECIFIED", + "CONTAINERD" + ], + "enumDescriptions": [ + "No container runtime selected.", + "Containerd runtime." + ], + "type": "string" + }, + "maxPodsPerNode": { + "description": "The maximum number of pods a node can run. The size of the CIDR range assigned to the node will be derived from this parameter.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "Binding": { + "description": "Associates `members`, or principals, with a `role`.", + "id": "Binding", + "properties": { + "condition": { + "$ref": "Expr", + "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." + }, + "members": { + "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding.", + "items": { + "type": "string" + }, + "type": "array" + }, + "role": { + "description": "Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`.", + "type": "string" + } + }, + "type": "object" + }, + "CancelOperationRequest": { + "description": "The request message for Operations.CancelOperation.", + "id": "CancelOperationRequest", + "properties": {}, + "type": "object" + }, + "ClusterUser": { + "description": "ClusterUser configures user principals for an RBAC policy.", + "id": "ClusterUser", + "properties": { + "username": { + "description": "Required. The name of the user, e.g. `my-gcp-id@gmail.com`.", + "type": "string" + } + }, + "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" + }, + "EnrollBareMetalAdminClusterRequest": { + "description": "Message for enrolling an existing bare metal admin cluster to the GKE on-prem API.", + "id": "EnrollBareMetalAdminClusterRequest", + "properties": { + "bareMetalAdminClusterId": { + "description": "User provided OnePlatform identifier that is used as part of the resource name. This must be unique among all GKE on-prem clusters within a project and location and will return a 409 if the cluster already exists. This value must be up to 40 characters and follow RFC-1123 (https://tools.ietf.org/html/rfc1123) format.", + "type": "string" + }, + "localName": { + "description": "The object name of the bare metal OnPremAdminCluster custom resource on the associated admin cluster. This field is used to support conflicting resource names when enrolling existing clusters to the API. When not provided, this field will resolve to the bare_metal_admin_cluster_id. Otherwise, it must match the object name of the bare metal OnPremAdminCluster custom resource. It is not modifiable outside / beyond the enrollment operation.", + "type": "string" + }, + "membership": { + "description": "Required. This is the full resource name of this admin cluster's fleet membership.", + "type": "string" + } + }, + "type": "object" + }, + "EnrollBareMetalClusterRequest": { + "description": "Message for enrolling an existing bare metal cluster to the Anthos On-Prem API.", + "id": "EnrollBareMetalClusterRequest", + "properties": { + "adminClusterMembership": { + "description": "Required. The admin cluster this bare metal user cluster belongs to. This is the full resource name of the admin cluster's fleet membership. In the future, references to other resource types might be allowed if admin clusters are modeled as their own resources.", + "type": "string" + }, + "bareMetalClusterId": { + "description": "User provided OnePlatform identifier that is used as part of the resource name. This must be unique among all bare metal clusters within a project and location and will return a 409 if the cluster already exists. This value must be up to 40 characters and follow RFC-1123 (https://tools.ietf.org/html/rfc1123) format.", + "type": "string" + }, + "localName": { + "description": "The object name of the bare metal cluster custom resource on the associated admin cluster. This field is used to support conflicting resource names when enrolling existing clusters to the API. When not provided, this field will resolve to the bare_metal_cluster_id. Otherwise, it must match the object name of the bare metal cluster custom resource. It is not modifiable outside / beyond the enrollment operation.", + "type": "string" + } + }, + "type": "object" + }, + "EnrollBareMetalNodePoolRequest": { + "description": "Message for enrolling an existing bare metal node pool to the GKE on-prem API.", + "id": "EnrollBareMetalNodePoolRequest", + "properties": { + "bareMetalNodePoolId": { + "description": "User provided OnePlatform identifier that is used as part of the resource name. This value must be up to 40 characters and follow RFC-1123 (https://tools.ietf.org/html/rfc1123) format.", + "type": "string" + }, + "validateOnly": { + "description": "If set, only validate the request, but do not actually enroll the node pool.", + "type": "boolean" + } + }, + "type": "object" + }, + "EnrollVmwareAdminClusterRequest": { + "description": "Message for enrolling an existing VMware admin cluster to the GKE on-prem API.", + "id": "EnrollVmwareAdminClusterRequest", + "properties": { + "localName": { + "description": "The object name of the VMware OnPremAdminCluster custom resource on the associated admin cluster. This field is used to support conflicting resource names when enrolling existing clusters to the API. When not provided, this field will resolve to the vmware_admin_cluster_id. Otherwise, it must match the object name of the VMware OnPremAdminCluster custom resource. It is not modifiable outside / beyond the enrollment operation.", + "type": "string" + }, + "membership": { + "description": "Required. This is the full resource name of this admin cluster's fleet membership.", + "type": "string" + }, + "vmwareAdminClusterId": { + "description": "User provided OnePlatform identifier that is used as part of the resource name. This must be unique among all GKE on-prem clusters within a project and location and will return a 409 if the cluster already exists. This value must be up to 40 characters and follow RFC-1123 (https://tools.ietf.org/html/rfc1123) format.", + "type": "string" + } + }, + "type": "object" + }, + "EnrollVmwareClusterRequest": { + "description": "Message for enrolling an existing VMware cluster to the Anthos On-Prem API.", + "id": "EnrollVmwareClusterRequest", + "properties": { + "adminClusterMembership": { + "description": "Required. The admin cluster this VMware user cluster belongs to. This is the full resource name of the admin cluster's fleet membership. In the future, references to other resource types might be allowed if admin clusters are modeled as their own resources.", + "type": "string" + }, + "localName": { + "description": "The object name of the VMware OnPremUserCluster custom resource on the associated admin cluster. This field is used to support conflicting resource names when enrolling existing clusters to the API. When not provided, this field will resolve to the vmware_cluster_id. Otherwise, it must match the object name of the VMware OnPremUserCluster custom resource. It is not modifiable outside / beyond the enrollment operation.", + "type": "string" + }, + "validateOnly": { + "description": "Validate the request without actually doing any updates.", + "type": "boolean" + }, + "vmwareClusterId": { + "description": "User provided OnePlatform identifier that is used as part of the resource name. This must be unique among all GKE on-prem clusters within a project and location and will return a 409 if the cluster already exists. This value must be up to 40 characters and follow RFC-1123 (https://tools.ietf.org/html/rfc1123) format.", + "type": "string" + } + }, + "type": "object" + }, + "EnrollVmwareNodePoolRequest": { + "description": "Message for enrolling a VMware node pool.", + "id": "EnrollVmwareNodePoolRequest", + "properties": { + "vmwareNodePoolId": { + "description": "The target node pool id to be enrolled.", + "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", + "properties": { + "description": { + "description": "Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.", + "type": "string" + }, + "expression": { + "description": "Textual representation of an expression in Common Expression Language syntax.", + "type": "string" + }, + "location": { + "description": "Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.", + "type": "string" + }, + "title": { + "description": "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.", + "type": "string" + } + }, + "type": "object" + }, + "Fleet": { + "description": "Fleet related configuration. Fleets are a Google Cloud concept for logically organizing clusters, letting you use and manage multi-cluster capabilities and apply consistent policies across your systems. See [Anthos Fleets](`https://cloud.google.com/anthos/multicluster-management/fleets`) for more details on Anthos multi-cluster capabilities using Fleets. ##", + "id": "Fleet", + "properties": { + "membership": { + "description": "Output only. The name of the managed fleet Membership resource associated to this cluster. Membership names are formatted as `projects//locations//memberships/`.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ListBareMetalAdminClustersResponse": { + "description": "Response message for listing bare metal admin clusters.", + "id": "ListBareMetalAdminClustersResponse", + "properties": { + "bareMetalAdminClusters": { + "description": "The list of bare metal admin cluster.", + "items": { + "$ref": "BareMetalAdminCluster" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token identifying a page of results the server should return. If the token is not empty this means that more results are available and should be retrieved by repeating the request with the provided page token.", + "type": "string" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListBareMetalClustersResponse": { + "description": "Response message for listing bare metal Clusters.", + "id": "ListBareMetalClustersResponse", + "properties": { + "bareMetalClusters": { + "description": "The list of bare metal Clusters.", + "items": { + "$ref": "BareMetalCluster" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token identifying a page of results the server should return. If the token is not empty this means that more results are available and should be retrieved by repeating the request with the provided page token.", + "type": "string" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListBareMetalNodePoolsResponse": { + "description": "Response message for listing bare metal node pools.", + "id": "ListBareMetalNodePoolsResponse", + "properties": { + "bareMetalNodePools": { + "description": "The node pools from the specified parent resource.", + "items": { + "$ref": "BareMetalNodePool" + }, + "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" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListLocationsResponse": { + "description": "The response message for Locations.ListLocations.", + "id": "ListLocationsResponse", + "properties": { + "locations": { + "description": "A list of locations that matches the specified filter in the request.", + "items": { + "$ref": "Location" + }, + "type": "array" + }, + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + } + }, + "type": "object" + }, + "ListOperationsResponse": { + "description": "The response message for Operations.ListOperations.", + "id": "ListOperationsResponse", + "properties": { + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + }, + "operations": { + "description": "A list of operations that matches the specified filter in the request.", + "items": { + "$ref": "Operation" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListVmwareAdminClustersResponse": { + "description": "Response message for listing VMware admin clusters.", + "id": "ListVmwareAdminClustersResponse", + "properties": { + "nextPageToken": { + "description": "A token identifying a page of results the server should return. If the token is not empty this means that more results are available and should be retrieved by repeating the request with the provided page token.", + "type": "string" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + }, + "vmwareAdminClusters": { + "description": "The list of VMware admin cluster.", + "items": { + "$ref": "VmwareAdminCluster" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListVmwareClustersResponse": { + "description": "Response message for listing VMware Clusters.", + "id": "ListVmwareClustersResponse", + "properties": { + "nextPageToken": { + "description": "A token identifying a page of results the server should return. If the token is not empty this means that more results are available and should be retrieved by repeating the request with the provided page token.", + "type": "string" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + }, + "vmwareClusters": { + "description": "The list of VMware Cluster.", + "items": { + "$ref": "VmwareCluster" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListVmwareNodePoolsResponse": { + "description": "Response message for listing VMware node pools.", + "id": "ListVmwareNodePoolsResponse", + "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" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + }, + "vmwareNodePools": { + "description": "The node pools from the specified parent resource.", + "items": { + "$ref": "VmwareNodePool" + }, + "type": "array" + } + }, + "type": "object" + }, + "Location": { + "description": "A resource that represents a Google Cloud location.", + "id": "Location", + "properties": { + "displayName": { + "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", + "type": "object" + }, + "locationId": { + "description": "The canonical id for this location. For example: `\"us-east1\"`.", + "type": "string" + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata. For example the available capacity at the given location.", + "type": "object" + }, + "name": { + "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", + "type": "string" + } + }, + "type": "object" + }, + "NodeTaint": { + "description": "NodeTaint applied to every Kubernetes node in a node pool. Kubernetes taints can be used together with tolerations to control how workloads are scheduled to your nodes. Node taints are permanent.", + "id": "NodeTaint", + "properties": { + "effect": { + "description": "The taint effect.", + "enum": [ + "EFFECT_UNSPECIFIED", + "NO_SCHEDULE", + "PREFER_NO_SCHEDULE", + "NO_EXECUTE" + ], + "enumDescriptions": [ + "Not set.", + "Do not allow new pods to schedule onto the node unless they tolerate the taint, but allow all pods submitted to Kubelet without going through the scheduler to start, and allow all already-running pods to continue running. Enforced by the scheduler.", + "Like TaintEffectNoSchedule, but the scheduler tries not to schedule new pods onto the node, rather than prohibiting new pods from scheduling onto the node entirely. Enforced by the scheduler.", + "Evict any already-running pods that do not tolerate the taint. Currently enforced by NodeController." + ], + "type": "string" + }, + "key": { + "description": "Key associated with the effect.", + "type": "string" + }, + "value": { + "description": "Value associated with the effect.", + "type": "string" + } + }, + "type": "object" + }, + "Operation": { + "description": "This resource represents a long-running operation that is the result of a network API call.", + "id": "Operation", + "properties": { + "done": { + "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.", + "type": "boolean" + }, + "error": { + "$ref": "Status", + "description": "The error result of the operation in case of failure or cancellation." + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.", + "type": "object" + }, + "name": { + "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.", + "type": "string" + }, + "response": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", + "type": "object" + } + }, + "type": "object" + }, + "OperationMetadata": { + "description": "Represents the metadata of the long-running operation.", + "id": "OperationMetadata", + "properties": { + "apiVersion": { + "description": "Output only. API version used to start the operation.", + "readOnly": true, + "type": "string" + }, + "createTime": { + "description": "Output only. The time the operation was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "endTime": { + "description": "Output only. The time the operation finished running.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "requestedCancellation": { + "description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have [Operation.error] value with a [google.rpc.Status.code] of 1, corresponding to `Code.CANCELLED`.", + "readOnly": true, + "type": "boolean" + }, + "statusMessage": { + "description": "Output only. Human-readable status of the operation, if any.", + "readOnly": true, + "type": "string" + }, + "target": { + "description": "Output only. Server-defined resource path for the target of the operation.", + "readOnly": true, + "type": "string" + }, + "type": { + "description": "Output only. Type of operation being executed.", + "enum": [ + "OPERATION_TYPE_UNSPECIFIED", + "CREATE", + "DELETE", + "UPDATE", + "UPGRADE" + ], + "enumDescriptions": [ + "Not set.", + "The resource is being created.", + "The resource is being deleted.", + "The resource is being updated.", + "The resource is being upgraded." + ], + "readOnly": true, + "type": "string" + }, + "verb": { + "description": "Output only. Name of the verb executed by the operation.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "Policy": { + "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time \u003c timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time \u003c timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).", + "id": "Policy", + "properties": { + "bindings": { + "description": "Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.", + "items": { + "$ref": "Binding" + }, + "type": "array" + }, + "etag": { + "description": "`etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.", + "format": "byte", + "type": "string" + }, + "version": { + "description": "Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "QueryBareMetalAdminVersionConfigResponse": { + "description": "Response message for querying bare metal admin cluster version config.", + "id": "QueryBareMetalAdminVersionConfigResponse", + "properties": { + "versions": { + "description": "List of available versions to install or to upgrade to.", + "items": { + "$ref": "BareMetalVersionInfo" + }, + "type": "array" + } + }, + "type": "object" + }, + "QueryBareMetalVersionConfigResponse": { + "description": "Response message for querying bare metal admin cluster version config.", + "id": "QueryBareMetalVersionConfigResponse", + "properties": { + "versions": { + "description": "List of available versions to install or to upgrade to.", + "items": { + "$ref": "BareMetalVersionInfo" + }, + "type": "array" + } + }, + "type": "object" + }, + "QueryVmwareVersionConfigResponse": { + "description": "Response message for querying VMware user cluster version config.", + "id": "QueryVmwareVersionConfigResponse", + "properties": { + "versions": { + "description": "List of available versions to install or to upgrade to.", + "items": { + "$ref": "VmwareVersionInfo" + }, + "type": "array" + } + }, + "type": "object" + }, + "ResourceCondition": { + "description": "ResourceCondition provides a standard mechanism for higher-level status reporting from controller.", + "id": "ResourceCondition", + "properties": { + "lastTransitionTime": { + "description": "Last time the condition transit from one status to another.", + "format": "google-datetime", + "type": "string" + }, + "message": { + "description": "Human-readable message indicating details about last transition.", + "type": "string" + }, + "reason": { + "description": "Machine-readable message indicating details about last transition.", + "type": "string" + }, + "state": { + "description": "state of the condition.", + "enum": [ + "STATE_UNSPECIFIED", + "STATE_TRUE", + "STATE_FALSE", + "STATE_UNKNOWN" + ], + "enumDescriptions": [ + "Not set.", + "Resource is in the condition.", + "Resource is not in the condition.", + "Kubernetes controller can't decide if the resource is in the condition or not." + ], + "type": "string" + }, + "type": { + "description": "Type of the condition. (e.g., ClusterRunning, NodePoolRunning or ServerSidePreflightReady)", + "type": "string" + } + }, + "type": "object" + }, + "ResourceStatus": { + "description": "ResourceStatus describes why a cluster or node pool has a certain status. (e.g., ERROR or DEGRADED).", + "id": "ResourceStatus", + "properties": { + "conditions": { + "description": "ResourceCondition provide a standard mechanism for higher-level status reporting from controller.", + "items": { + "$ref": "ResourceCondition" + }, + "type": "array" + }, + "errorMessage": { + "description": "Human-friendly representation of the error message from controller. The error message can be temporary as the controller controller creates a cluster or node pool. If the error message persists for a longer period of time, it can be used to surface error message to indicate real problems requiring user intervention.", + "type": "string" + } + }, + "type": "object" + }, + "SetIamPolicyRequest": { + "description": "Request message for `SetIamPolicy` method.", + "id": "SetIamPolicyRequest", + "properties": { + "policy": { + "$ref": "Policy", + "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them." + } + }, + "type": "object" + }, + "Status": { + "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", + "id": "Status", + "properties": { + "code": { + "description": "The status code, which should be an enum value of google.rpc.Code.", + "format": "int32", + "type": "integer" + }, + "details": { + "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", + "type": "string" + } + }, + "type": "object" + }, + "TestIamPermissionsRequest": { + "description": "Request message for `TestIamPermissions` method.", + "id": "TestIamPermissionsRequest", + "properties": { + "permissions": { + "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "TestIamPermissionsResponse": { + "description": "Response message for `TestIamPermissions` method.", + "id": "TestIamPermissionsResponse", + "properties": { + "permissions": { + "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ValidationCheck": { + "description": "ValidationCheck represents the result of preflight check.", + "id": "ValidationCheck", + "properties": { + "option": { + "description": "Options used for the validation check", + "enum": [ + "OPTIONS_UNSPECIFIED", + "SKIP_VALIDATION_CHECK_BLOCKING", + "SKIP_VALIDATION_ALL" + ], + "enumDescriptions": [ + "Default value. Standard preflight validation check will be used.", + "Prevent failed preflight checks from failing.", + "Skip all preflight check validations." + ], + "type": "string" + }, + "scenario": { + "description": "Output only. The scenario when the preflight checks were run.", + "enum": [ + "SCENARIO_UNSPECIFIED", + "CREATE", + "UPDATE" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "The validation check occurred during a create flow.", + "The validation check occurred during an update flow." + ], + "readOnly": true, + "type": "string" + }, + "status": { + "$ref": "ValidationCheckStatus", + "description": "Output only. The detailed validation check status.", + "readOnly": true + } + }, + "type": "object" + }, + "ValidationCheckResult": { + "description": "ValidationCheckResult defines the details about the validation check.", + "id": "ValidationCheckResult", + "properties": { + "category": { + "description": "The category of the validation.", + "type": "string" + }, + "description": { + "description": "The description of the validation check.", + "type": "string" + }, + "details": { + "description": "Detailed failure information, which might be unformatted.", + "type": "string" + }, + "reason": { + "description": "A human-readable message of the check failure.", + "type": "string" + }, + "state": { + "description": "The validation check state.", + "enum": [ + "STATE_UNKNOWN", + "STATE_FAILURE", + "STATE_SKIPPED", + "STATE_FATAL", + "STATE_WARNING" + ], + "enumDescriptions": [ + "The default value. The check result is unknown.", + "The check failed.", + "The check was skipped.", + "The check itself failed to complete.", + "The check encountered a warning." + ], + "type": "string" + } + }, + "type": "object" + }, + "ValidationCheckStatus": { + "description": "ValidationCheckStatus defines the detailed validation check status.", + "id": "ValidationCheckStatus", + "properties": { + "result": { + "description": "Individual checks which failed as part of the Preflight check execution.", + "items": { + "$ref": "ValidationCheckResult" + }, + "type": "array" + } + }, + "type": "object" + }, + "VmwareAAGConfig": { + "description": "Specifies anti affinity group config for the VMware user cluster.", + "id": "VmwareAAGConfig", + "properties": { + "aagConfigDisabled": { + "description": "Spread nodes across at least three physical hosts (requires at least three hosts). Enabled by default.", + "type": "boolean" + } + }, + "type": "object" + }, + "VmwareAddressPool": { + "description": "Represents an IP pool used by the load balancer.", + "id": "VmwareAddressPool", + "properties": { + "addresses": { + "description": "Required. The addresses that are part of this pool. Each address must be either in the CIDR form (1.2.3.0/24) or range form (1.2.3.1-1.2.3.5).", + "items": { + "type": "string" + }, + "type": "array" + }, + "avoidBuggyIps": { + "description": "If true, avoid using IPs ending in .0 or .255. This avoids buggy consumer devices mistakenly dropping IPv4 traffic for those special IP addresses.", + "type": "boolean" + }, + "manualAssign": { + "description": "If true, prevent IP addresses from being automatically assigned.", + "type": "boolean" + }, + "pool": { + "description": "Required. The name of the address pool.", + "type": "string" + } + }, + "type": "object" + }, + "VmwareAdminAddonNodeConfig": { + "description": "VmwareAdminAddonNodeConfig contains add-on node configurations for VMware admin cluster.", + "id": "VmwareAdminAddonNodeConfig", + "properties": { + "autoResizeConfig": { + "$ref": "VmwareAutoResizeConfig", + "description": "VmwareAutoResizeConfig config specifies auto resize config." + } + }, + "type": "object" + }, + "VmwareAdminCluster": { + "description": "Resource that represents a VMware admin cluster.", + "id": "VmwareAdminCluster", + "properties": { + "addonNode": { + "$ref": "VmwareAdminAddonNodeConfig", + "description": "The VMware admin cluster addon node configuration." + }, + "annotations": { + "additionalProperties": { + "type": "string" + }, + "description": "Annotations on the VMware admin cluster. This field has the same restrictions as Kubernetes annotations. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.", + "type": "object" + }, + "antiAffinityGroups": { + "$ref": "VmwareAAGConfig", + "description": "The VMware admin cluster anti affinity group configuration." + }, + "autoRepairConfig": { + "$ref": "VmwareAutoRepairConfig", + "description": "The VMware admin cluster auto repair configuration." + }, + "bootstrapClusterMembership": { + "description": "The bootstrap cluster this VMware admin cluster belongs to.", + "type": "string" + }, + "controlPlaneNode": { + "$ref": "VmwareAdminControlPlaneNodeConfig", + "description": "The VMware admin cluster control plane node configuration." + }, + "createTime": { + "description": "Output only. The time at which VMware admin cluster was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "A human readable description of this VMware admin cluster.", + "type": "string" + }, + "endpoint": { + "description": "Output only. The DNS name of VMware admin cluster's API server.", + "readOnly": true, + "type": "string" + }, + "etag": { + "description": "This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. Allows clients to perform consistent read-modify-writes through optimistic concurrency control.", + "type": "string" + }, + "fleet": { + "$ref": "Fleet", + "description": "Output only. Fleet configuration for the cluster.", + "readOnly": true + }, + "imageType": { + "description": "The OS image type for the VMware admin cluster.", + "type": "string" + }, + "loadBalancer": { + "$ref": "VmwareAdminLoadBalancerConfig", + "description": "The VMware admin cluster load balancer configuration." + }, + "localName": { + "description": "Output only. The object name of the VMware OnPremAdminCluster custom resource. This field is used to support conflicting names when enrolling existing clusters to the API. When used as a part of cluster enrollment, this field will differ from the ID in the resource name. For new clusters, this field will match the user provided cluster name and be visible in the last component of the resource name. It is not modifiable. All users should use this name to access their cluster using gkectl or kubectl and should expect to see the local name when viewing admin cluster controller logs.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Immutable. The VMware admin cluster resource name.", + "type": "string" + }, + "networkConfig": { + "$ref": "VmwareAdminNetworkConfig", + "description": "The VMware admin cluster network configuration." + }, + "onPremVersion": { + "description": "The Anthos clusters on the VMware version for the admin cluster.", + "type": "string" + }, + "platformConfig": { + "$ref": "VmwarePlatformConfig", + "description": "The VMware platform configuration." + }, + "reconciling": { + "description": "Output only. If set, there are currently changes in flight to the VMware admin cluster.", + "readOnly": true, + "type": "boolean" + }, + "state": { + "description": "Output only. The current state of VMware admin cluster.", + "enum": [ + "STATE_UNSPECIFIED", + "PROVISIONING", + "RUNNING", + "RECONCILING", + "STOPPING", + "ERROR", + "DEGRADED" + ], + "enumDescriptions": [ + "Not set.", + "The PROVISIONING state indicates the cluster is being created.", + "The RUNNING state indicates the cluster has been created and is fully usable.", + "The RECONCILING state indicates that the cluster is being updated. It remains available, but potentially with degraded performance.", + "The STOPPING state indicates the cluster is being deleted.", + "The ERROR state indicates the cluster is in a broken unrecoverable state.", + "The DEGRADED state indicates the cluster requires user action to restore full functionality." + ], + "readOnly": true, + "type": "string" + }, + "status": { + "$ref": "ResourceStatus", + "description": "Output only. ResourceStatus representing detailed cluster state.", + "readOnly": true + }, + "uid": { + "description": "Output only. The unique identifier of the VMware admin cluster.", + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. The time at which VMware admin cluster was last updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "vcenter": { + "$ref": "VmwareAdminVCenterConfig", + "description": "The VMware admin cluster VCenter configuration." + } + }, + "type": "object" + }, + "VmwareAdminControlPlaneNodeConfig": { + "description": "VmwareAdminControlPlaneNodeConfig contains control plane node configuration for VMware admin cluster.", + "id": "VmwareAdminControlPlaneNodeConfig", + "properties": { + "cpus": { + "description": "The number of vCPUs for the control-plane node of the admin cluster.", + "format": "int64", + "type": "string" + }, + "memory": { + "description": "The number of mebibytes of memory for the control-plane node of the admin cluster.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "VmwareAdminF5BigIpConfig": { + "description": "VmwareAdminF5BigIpConfig represents configuration parameters for an F5 BIG-IP load balancer.", + "id": "VmwareAdminF5BigIpConfig", + "properties": { + "address": { + "description": "The load balancer's IP address.", + "type": "string" + }, + "partition": { + "description": "The preexisting partition to be used by the load balancer. This partition is usually created for the admin cluster for example: 'my-f5-admin-partition'.", + "type": "string" + }, + "snatPool": { + "description": "The pool name. Only necessary, if using SNAT.", + "type": "string" + } + }, + "type": "object" + }, + "VmwareAdminLoadBalancerConfig": { + "description": "VmwareAdminLoadBalancerConfig contains load balancer configuration for VMware admin cluster.", + "id": "VmwareAdminLoadBalancerConfig", + "properties": { + "f5Config": { + "$ref": "VmwareAdminF5BigIpConfig", + "description": "Configuration for F5 Big IP typed load balancers." + }, + "manualLbConfig": { + "$ref": "VmwareAdminManualLbConfig", + "description": "Manually configured load balancers." + }, + "metalLbConfig": { + "$ref": "VmwareAdminMetalLbConfig", + "description": "MetalLB load balancers." + }, + "vipConfig": { + "$ref": "VmwareAdminVipConfig", + "description": "The VIPs used by the load balancer." + } + }, + "type": "object" + }, + "VmwareAdminManualLbConfig": { + "id": "VmwareAdminManualLbConfig", + "properties": { + "addonsNodePort": { + "description": "NodePort for add-ons server in the admin cluster.", + "format": "int32", + "type": "integer" + }, + "controlPlaneNodePort": { + "description": "NodePort for control plane service. The Kubernetes API server in the admin cluster is implemented as a Service of type NodePort (ex. 30968).", + "format": "int32", + "type": "integer" + }, + "ingressHttpNodePort": { + "description": "NodePort for ingress service's http. The ingress service in the admin cluster is implemented as a Service of type NodePort (ex. 32527).", + "format": "int32", + "type": "integer" + }, + "ingressHttpsNodePort": { + "description": "NodePort for ingress service's https. The ingress service in the admin cluster is implemented as a Service of type NodePort (ex. 30139).", + "format": "int32", + "type": "integer" + }, + "konnectivityServerNodePort": { + "description": "NodePort for konnectivity server service running as a sidecar in each kube-apiserver pod (ex. 30564).", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "VmwareAdminMetalLbConfig": { + "description": "VmwareAdminMetalLbConfig represents configuration parameters for a MetalLB load balancer. For admin clusters, currently no configurations is needed.", + "id": "VmwareAdminMetalLbConfig", + "properties": {}, + "type": "object" + }, + "VmwareAdminNetworkConfig": { + "description": "VmwareAdminNetworkConfig contains network configuration for VMware admin cluster.", + "id": "VmwareAdminNetworkConfig", + "properties": { + "dhcpIpConfig": { + "$ref": "VmwareDhcpIpConfig", + "description": "Configuration settings for a DHCP IP configuration." + }, + "hostConfig": { + "$ref": "VmwareHostConfig", + "description": "Represents common network settings irrespective of the host's IP address." + }, + "podAddressCidrBlocks": { + "description": "Required. All pods in the cluster are assigned an RFC1918 IPv4 address from these ranges. Only a single range is supported. This field cannot be changed after creation.", + "items": { + "type": "string" + }, + "type": "array" + }, + "serviceAddressCidrBlocks": { + "description": "Required. All services in the cluster are assigned an RFC1918 IPv4 address from these ranges. Only a single range is supported. This field cannot be changed after creation.", + "items": { + "type": "string" + }, + "type": "array" + }, + "staticIpConfig": { + "$ref": "VmwareStaticIpConfig", + "description": "Configuration settings for a static IP configuration." + }, + "vcenterNetwork": { + "description": "vcenter_network specifies vCenter network name.", + "type": "string" + } + }, + "type": "object" + }, + "VmwareAdminVCenterConfig": { + "description": "VmwareAdminVCenterConfig contains VCenter configuration for VMware admin cluster.", + "id": "VmwareAdminVCenterConfig", + "properties": { + "address": { + "description": "The vCenter IP address.", + "type": "string" + }, + "caCertData": { + "description": "Contains the vCenter CA certificate public key for SSL verification.", + "type": "string" + }, + "cluster": { + "description": "The name of the vCenter cluster for the admin cluster.", + "type": "string" + }, + "dataDisk": { + "description": "The name of the virtual machine disk (VMDK) for the admin cluster.", + "type": "string" + }, + "datacenter": { + "description": "The name of the vCenter datacenter for the admin cluster.", + "type": "string" + }, + "datastore": { + "description": "The name of the vCenter datastore for the admin cluster.", + "type": "string" + }, + "folder": { + "description": "The name of the vCenter folder for the admin cluster.", + "type": "string" + }, + "resourcePool": { + "description": "The name of the vCenter resource pool for the admin cluster.", + "type": "string" + } + }, + "type": "object" + }, + "VmwareAdminVipConfig": { + "description": "VmwareAdminVipConfig for VMware load balancer configurations.", + "id": "VmwareAdminVipConfig", + "properties": { + "addonsVip": { + "description": "The VIP to configure the load balancer for add-ons.", + "type": "string" + }, + "controlPlaneVip": { + "description": "The VIP which you previously set aside for the Kubernetes API of the admin cluster.", + "type": "string" + } + }, + "type": "object" + }, + "VmwareAutoRepairConfig": { + "description": "Specifies config to enable/disable auto repair. The cluster-health-controller is deployed only if Enabled is true.", + "id": "VmwareAutoRepairConfig", + "properties": { + "enabled": { + "description": "Whether auto repair is enabled.", + "type": "boolean" + } + }, + "type": "object" + }, + "VmwareAutoResizeConfig": { + "description": "Represents auto resizing configurations for the VMware user cluster.", + "id": "VmwareAutoResizeConfig", + "properties": { + "enabled": { + "description": "Whether to enable controle plane node auto resizing.", + "type": "boolean" + } + }, + "type": "object" + }, + "VmwareBundleConfig": { + "description": "VmwareBundleConfig represents configuration for the bundle.", + "id": "VmwareBundleConfig", + "properties": { + "status": { + "$ref": "ResourceStatus", + "description": "Output only. Resource status for the bundle.", + "readOnly": true + }, + "version": { + "description": "The version of the bundle.", + "type": "string" + } + }, + "type": "object" + }, + "VmwareCluster": { + "description": "Resource that represents a VMware user cluster. ##", + "id": "VmwareCluster", + "properties": { + "adminClusterMembership": { + "description": "Required. The admin cluster this VMware user cluster belongs to. This is the full resource name of the admin cluster's fleet membership. In the future, references to other resource types might be allowed if admin clusters are modeled as their own resources.", + "type": "string" + }, + "adminClusterName": { + "description": "Output only. The resource name of the VMware admin cluster hosting this user cluster.", + "readOnly": true, + "type": "string" + }, + "annotations": { + "additionalProperties": { + "type": "string" + }, + "description": "Annotations on the VMware user cluster. This field has the same restrictions as Kubernetes annotations. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.", + "type": "object" + }, + "antiAffinityGroups": { + "$ref": "VmwareAAGConfig", + "description": "AAGConfig specifies whether to spread VMware user cluster nodes across at least three physical hosts in the datacenter." + }, + "authorization": { + "$ref": "Authorization", + "description": "RBAC policy that will be applied and managed by the Anthos On-Prem API." + }, + "autoRepairConfig": { + "$ref": "VmwareAutoRepairConfig", + "description": "Configuration for auto repairing." + }, + "controlPlaneNode": { + "$ref": "VmwareControlPlaneNodeConfig", + "description": "VMware user cluster control plane nodes must have either 1 or 3 replicas." + }, + "createTime": { + "description": "Output only. The time at which VMware user cluster was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "dataplaneV2": { + "$ref": "VmwareDataplaneV2Config", + "description": "VmwareDataplaneV2Config specifies configuration for Dataplane V2." + }, + "deleteTime": { + "description": "Output only. The time at which VMware user cluster was deleted.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "A human readable description of this VMware user cluster.", + "type": "string" + }, + "enableControlPlaneV2": { + "description": "Enable control plane V2. Default to false.", + "type": "boolean" + }, + "endpoint": { + "description": "Output only. The DNS name of VMware user cluster's API server.", + "readOnly": true, + "type": "string" + }, + "etag": { + "description": "This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. Allows clients to perform consistent read-modify-writes through optimistic concurrency control.", + "type": "string" + }, + "fleet": { + "$ref": "Fleet", + "description": "Output only. Fleet configuration for the cluster.", + "readOnly": true + }, + "loadBalancer": { + "$ref": "VmwareLoadBalancerConfig", + "description": "Load balancer configuration." + }, + "localName": { + "description": "Output only. The object name of the VMware OnPremUserCluster custom resource on the associated admin cluster. This field is used to support conflicting names when enrolling existing clusters to the API. When used as a part of cluster enrollment, this field will differ from the ID in the resource name. For new clusters, this field will match the user provided cluster name and be visible in the last component of the resource name. It is not modifiable. All users should use this name to access their cluster using gkectl or kubectl and should expect to see the local name when viewing admin cluster controller logs.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Immutable. The VMware user cluster resource name.", + "type": "string" + }, + "networkConfig": { + "$ref": "VmwareNetworkConfig", + "description": "The VMware user cluster network configuration." + }, + "onPremVersion": { + "description": "The Anthos clusters on the VMware version for your user cluster. Defaults to the admin cluster version.", + "type": "string" + }, + "reconciling": { + "description": "Output only. If set, there are currently changes in flight to the VMware user cluster.", + "readOnly": true, + "type": "boolean" + }, + "state": { + "description": "Output only. The current state of VMware user cluster.", + "enum": [ + "STATE_UNSPECIFIED", + "PROVISIONING", + "RUNNING", + "RECONCILING", + "STOPPING", + "ERROR", + "DEGRADED" + ], + "enumDescriptions": [ + "Not set.", + "The PROVISIONING state indicates the cluster is being created.", + "The RUNNING state indicates the cluster has been created and is fully usable.", + "The RECONCILING state indicates that the cluster is being updated. It remains available, but potentially with degraded performance.", + "The STOPPING state indicates the cluster is being deleted.", + "The ERROR state indicates the cluster is in a broken unrecoverable state.", + "The DEGRADED state indicates the cluster requires user action to restore full functionality." + ], + "readOnly": true, + "type": "string" + }, + "status": { + "$ref": "ResourceStatus", + "description": "Output only. ResourceStatus representing detailed cluster state.", + "readOnly": true + }, + "storage": { + "$ref": "VmwareStorageConfig", + "description": "Storage configuration." + }, + "uid": { + "description": "Output only. The unique identifier of the VMware user cluster.", + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. The time at which VMware user cluster was last updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "validationCheck": { + "$ref": "ValidationCheck", + "description": "Output only. ValidationCheck represents the result of the preflight check job.", + "readOnly": true + }, + "vcenter": { + "$ref": "VmwareVCenterConfig", + "description": "Output only. VmwareVCenterConfig specifies vCenter config for the user cluster. Inherited from the admin cluster.", + "readOnly": true + }, + "vmTrackingEnabled": { + "description": "Enable VM tracking.", + "type": "boolean" + } + }, + "type": "object" + }, + "VmwareControlPlaneNodeConfig": { + "description": "Specifies control plane node config for the VMware user cluster.", + "id": "VmwareControlPlaneNodeConfig", + "properties": { + "autoResizeConfig": { + "$ref": "VmwareAutoResizeConfig", + "description": "AutoResizeConfig provides auto resizing configurations." + }, + "cpus": { + "description": "The number of CPUs for each admin cluster node that serve as control planes for this VMware user cluster. (default: 4 CPUs)", + "format": "int64", + "type": "string" + }, + "memory": { + "description": "The megabytes of memory for each admin cluster node that serves as a control plane for this VMware user cluster (default: 8192 MB memory).", + "format": "int64", + "type": "string" + }, + "replicas": { + "description": "The number of control plane nodes for this VMware user cluster. (default: 1 replica).", + "format": "int64", + "type": "string" + }, + "vsphereConfig": { + "$ref": "VmwareControlPlaneVsphereConfig", + "description": "Output only. Vsphere-specific config.", + "readOnly": true + } + }, + "type": "object" + }, + "VmwareControlPlaneV2Config": { + "description": "Specifies control plane V2 config.", + "id": "VmwareControlPlaneV2Config", + "properties": { + "controlPlaneIpBlock": { + "$ref": "VmwareIpBlock", + "description": "Static IP addresses for the control plane nodes." + } + }, + "type": "object" + }, + "VmwareControlPlaneVsphereConfig": { + "description": "Specifies control plane node config.", + "id": "VmwareControlPlaneVsphereConfig", + "properties": { + "datastore": { + "description": "The Vsphere datastore used by the control plane Node.", + "type": "string" + } + }, + "type": "object" + }, + "VmwareDataplaneV2Config": { + "description": "Contains configurations for Dataplane V2, which is optimized dataplane for Kubernetes networking. For more information, see: https://cloud.google.com/kubernetes-engine/docs/concepts/dataplane-v2", + "id": "VmwareDataplaneV2Config", + "properties": { + "advancedNetworking": { + "description": "Enable advanced networking which requires dataplane_v2_enabled to be set true.", + "type": "boolean" + }, + "dataplaneV2Enabled": { + "description": "Enables Dataplane V2.", + "type": "boolean" + }, + "windowsDataplaneV2Enabled": { + "description": "Enable Dataplane V2 for clusters with Windows nodes.", + "type": "boolean" + } + }, + "type": "object" + }, + "VmwareDhcpIpConfig": { + "description": "Represents the network configuration required for the VMware user clusters with DHCP IP configurations.", + "id": "VmwareDhcpIpConfig", + "properties": { + "enabled": { + "description": "enabled is a flag to mark if DHCP IP allocation is used for VMware user clusters.", + "type": "boolean" + } + }, + "type": "object" + }, + "VmwareF5BigIpConfig": { + "description": "Represents configuration parameters for an F5 BIG-IP load balancer.", + "id": "VmwareF5BigIpConfig", + "properties": { + "address": { + "description": "The load balancer's IP address.", + "type": "string" + }, + "partition": { + "description": "The preexisting partition to be used by the load balancer. This partition is usually created for the admin cluster for example: 'my-f5-admin-partition'.", + "type": "string" + }, + "snatPool": { + "description": "The pool name. Only necessary, if using SNAT.", + "type": "string" + } + }, + "type": "object" + }, + "VmwareHostConfig": { + "description": "Represents the common parameters for all the hosts irrespective of their IP address.", + "id": "VmwareHostConfig", + "properties": { + "dnsSearchDomains": { + "description": "DNS search domains.", + "items": { + "type": "string" + }, + "type": "array" + }, + "dnsServers": { + "description": "DNS servers.", + "items": { + "type": "string" + }, + "type": "array" + }, + "ntpServers": { + "description": "NTP servers.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "VmwareHostIp": { + "description": "Represents VMware user cluster node's network configuration.", + "id": "VmwareHostIp", + "properties": { + "hostname": { + "description": "Hostname of the machine. VM's name will be used if this field is empty.", + "type": "string" + }, + "ip": { + "description": "IP could be an IP address (like 1.2.3.4) or a CIDR (like 1.2.3.0/24).", + "type": "string" + } + }, + "type": "object" + }, + "VmwareIpBlock": { + "description": "Represents a collection of IP addresses to assign to nodes.", + "id": "VmwareIpBlock", + "properties": { + "gateway": { + "description": "The network gateway used by the VMware user cluster.", + "type": "string" + }, + "ips": { + "description": "The node's network configurations used by the VMware user cluster.", + "items": { + "$ref": "VmwareHostIp" + }, + "type": "array" + }, + "netmask": { + "description": "The netmask used by the VMware user cluster.", + "type": "string" + } + }, + "type": "object" + }, + "VmwareLoadBalancerConfig": { + "description": "Specifies the locad balancer config for the VMware user cluster.", + "id": "VmwareLoadBalancerConfig", + "properties": { + "f5Config": { + "$ref": "VmwareF5BigIpConfig", + "description": "Configuration for F5 Big IP typed load balancers." + }, + "manualLbConfig": { + "$ref": "VmwareManualLbConfig", + "description": "Manually configured load balancers." + }, + "metalLbConfig": { + "$ref": "VmwareMetalLbConfig", + "description": "Configuration for MetalLB typed load balancers." + }, + "vipConfig": { + "$ref": "VmwareVipConfig", + "description": "The VIPs used by the load balancer." + } + }, + "type": "object" + }, + "VmwareManualLbConfig": { + "description": "Represents configuration parameters for an already existing manual load balancer. Given the nature of manual load balancers it is expected that said load balancer will be fully managed by users. IMPORTANT: Please note that the Anthos On-Prem API will not generate or update ManualLB configurations it can only bind a pre-existing configuration to a new VMware user cluster.", + "id": "VmwareManualLbConfig", + "properties": { + "controlPlaneNodePort": { + "description": "NodePort for control plane service. The Kubernetes API server in the admin cluster is implemented as a Service of type NodePort (ex. 30968).", + "format": "int32", + "type": "integer" + }, + "ingressHttpNodePort": { + "description": "NodePort for ingress service's http. The ingress service in the admin cluster is implemented as a Service of type NodePort (ex. 32527).", + "format": "int32", + "type": "integer" + }, + "ingressHttpsNodePort": { + "description": "NodePort for ingress service's https. The ingress service in the admin cluster is implemented as a Service of type NodePort (ex. 30139).", + "format": "int32", + "type": "integer" + }, + "konnectivityServerNodePort": { + "description": "NodePort for konnectivity server service running as a sidecar in each kube-apiserver pod (ex. 30564).", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "VmwareMetalLbConfig": { + "description": "Represents configuration parameters for the MetalLB load balancer.", + "id": "VmwareMetalLbConfig", + "properties": { + "addressPools": { + "description": "Required. AddressPools is a list of non-overlapping IP pools used by load balancer typed services. All addresses must be routable to load balancer nodes. IngressVIP must be included in the pools.", + "items": { + "$ref": "VmwareAddressPool" + }, + "type": "array" + } + }, + "type": "object" + }, + "VmwareNetworkConfig": { + "description": "Specifies network config for the VMware user cluster.", + "id": "VmwareNetworkConfig", + "properties": { + "controlPlaneV2Config": { + "$ref": "VmwareControlPlaneV2Config", + "description": "Configuration for control plane V2 mode." + }, + "dhcpIpConfig": { + "$ref": "VmwareDhcpIpConfig", + "description": "Configuration settings for a DHCP IP configuration." + }, + "hostConfig": { + "$ref": "VmwareHostConfig", + "description": "Represents common network settings irrespective of the host's IP address." + }, + "podAddressCidrBlocks": { + "description": "Required. All pods in the cluster are assigned an RFC1918 IPv4 address from these ranges. Only a single range is supported. This field cannot be changed after creation.", + "items": { + "type": "string" + }, + "type": "array" + }, + "serviceAddressCidrBlocks": { + "description": "Required. All services in the cluster are assigned an RFC1918 IPv4 address from these ranges. Only a single range is supported. This field cannot be changed after creation.", + "items": { + "type": "string" + }, + "type": "array" + }, + "staticIpConfig": { + "$ref": "VmwareStaticIpConfig", + "description": "Configuration settings for a static IP configuration." + }, + "vcenterNetwork": { + "description": "Output only. vcenter_network specifies vCenter network name. Inherited from the admin cluster.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "VmwareNodeConfig": { + "description": "Parameters that describe the configuration of all nodes within a given node pool.", + "id": "VmwareNodeConfig", + "properties": { + "bootDiskSizeGb": { + "description": "VMware disk size to be used during creation.", + "format": "int64", + "type": "string" + }, + "cpus": { + "description": "The number of CPUs for each node in the node pool.", + "format": "int64", + "type": "string" + }, + "enableLoadBalancer": { + "description": "Allow node pool traffic to be load balanced. Only works for clusters with MetalLB load balancers.", + "type": "boolean" + }, + "image": { + "description": "The OS image name in vCenter, only valid when using Windows.", + "type": "string" + }, + "imageType": { + "description": "Required. The OS image to be used for each node in a node pool. Currently `cos`, `ubuntu`, `ubuntu_containerd` and `windows` are supported.", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "The map of Kubernetes labels (key/value pairs) to be applied to each node. These will added in addition to any default label(s) that Kubernetes may apply to the node. In case of conflict in label keys, the applied set may differ depending on the Kubernetes version -- it's best to assume the behavior is undefined and conflicts should be avoided. For more information, including usage and the valid values, see: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/", + "type": "object" + }, + "memoryMb": { + "description": "The megabytes of memory for each node in the node pool.", + "format": "int64", + "type": "string" + }, + "replicas": { + "description": "The number of nodes in the node pool.", + "format": "int64", + "type": "string" + }, + "taints": { + "description": "The initial taints assigned to nodes of this node pool.", + "items": { + "$ref": "NodeTaint" + }, + "type": "array" + }, + "vsphereConfig": { + "$ref": "VmwareVsphereConfig", + "description": "Output only. Specifies the vSphere config for node pool.", + "readOnly": true + } + }, + "type": "object" + }, + "VmwareNodePool": { + "description": "Resource VmwareNodePool represents a VMware node pool. ##", + "id": "VmwareNodePool", + "properties": { + "annotations": { + "additionalProperties": { + "type": "string" + }, + "description": "Annotations on the node pool. This field has the same restrictions as Kubernetes annotations. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.", + "type": "object" + }, + "config": { + "$ref": "VmwareNodeConfig", + "description": "Required. The node configuration of the node pool." + }, + "createTime": { + "description": "Output only. The time at which this node pool was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "deleteTime": { + "description": "Output only. The time at which this node pool was deleted. If the resource is not deleted, this must be empty", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "The display name for the node pool.", + "type": "string" + }, + "etag": { + "description": "This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. Allows clients to perform consistent read-modify-writes through optimistic concurrency control.", + "type": "string" + }, + "name": { + "description": "Immutable. The resource name of this node pool.", + "type": "string" + }, + "nodePoolAutoscaling": { + "$ref": "VmwareNodePoolAutoscalingConfig", + "description": "Node pool autoscaling config for the node pool." + }, + "onPremVersion": { + "description": "Anthos version for the node pool. Defaults to the user cluster version.", + "type": "string" + }, + "reconciling": { + "description": "Output only. If set, there are currently changes in flight to the node pool.", + "readOnly": true, + "type": "boolean" + }, + "state": { + "description": "Output only. The current state of the node pool.", + "enum": [ + "STATE_UNSPECIFIED", + "PROVISIONING", + "RUNNING", + "RECONCILING", + "STOPPING", + "ERROR", + "DEGRADED" + ], + "enumDescriptions": [ + "Not set.", + "The PROVISIONING state indicates the node pool is being created.", + "The RUNNING state indicates the node pool has been created and is fully usable.", + "The RECONCILING state indicates that the node pool is being updated. It remains available, but potentially with degraded performance.", + "The STOPPING state indicates the cluster is being deleted", + "The ERROR state indicates the node pool is in a broken unrecoverable state.", + "The DEGRADED state indicates the node pool requires user action to restore full functionality." + ], + "readOnly": true, + "type": "string" + }, + "status": { + "$ref": "ResourceStatus", + "description": "Output only. ResourceStatus representing the detailed VMware node pool state.", + "readOnly": true + }, + "uid": { + "description": "Output only. The unique identifier of the node pool.", + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. The time at which this node pool was last updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "VmwareNodePoolAutoscalingConfig": { + "description": "NodePoolAutoscaling config for the NodePool to allow for the kubernetes to scale NodePool.", + "id": "VmwareNodePoolAutoscalingConfig", + "properties": { + "maxReplicas": { + "description": "Maximum number of replicas in the NodePool.", + "format": "int32", + "type": "integer" + }, + "minReplicas": { + "description": "Minimum number of replicas in the NodePool.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "VmwarePlatformConfig": { + "description": "VmwarePlatformConfig represents configuration for the VMware platform.", + "id": "VmwarePlatformConfig", + "properties": { + "bundles": { + "description": "Output only. The list of bundles installed in the admin cluster.", + "items": { + "$ref": "VmwareBundleConfig" + }, + "readOnly": true, + "type": "array" + }, + "platformVersion": { + "description": "Output only. The platform version e.g. 1.13.2.", + "readOnly": true, + "type": "string" + }, + "requiredPlatformVersion": { + "description": "Input only. The required platform version e.g. 1.13.1. If the current platform version is lower than the target version, the platform version will be updated to the target version. If the target version is not installed in the platform (bundle versions), download the target version bundle.", + "type": "string" + }, + "status": { + "$ref": "ResourceStatus", + "description": "Output only. Resource status for the platform.", + "readOnly": true + } + }, + "type": "object" + }, + "VmwareStaticIpConfig": { + "description": "Represents the network configuration required for the VMware user clusters with Static IP configurations.", + "id": "VmwareStaticIpConfig", + "properties": { + "ipBlocks": { + "description": "Represents the configuration values for static IP allocation to nodes.", + "items": { + "$ref": "VmwareIpBlock" + }, + "type": "array" + } + }, + "type": "object" + }, + "VmwareStorageConfig": { + "description": "Specifies vSphere CSI components deployment config in the VMware user cluster.", + "id": "VmwareStorageConfig", + "properties": { + "vsphereCsiDisabled": { + "description": "Whether or not to deploy vSphere CSI components in the VMware user cluster. Enabled by default.", + "type": "boolean" + } + }, + "type": "object" + }, + "VmwareVCenterConfig": { + "description": "Represents configuration for the VMware VCenter for the user cluster.", + "id": "VmwareVCenterConfig", + "properties": { + "address": { + "description": "The vCenter IP address.", + "type": "string" + }, + "caCertData": { + "description": "Contains the vCenter CA certificate public key for SSL verification.", + "type": "string" + }, + "cluster": { + "description": "The name of the vCenter cluster for the user cluster.", + "type": "string" + }, + "datacenter": { + "description": "The name of the vCenter datacenter for the user cluster.", + "type": "string" + }, + "datastore": { + "description": "The name of the vCenter datastore for the user cluster.", + "type": "string" + }, + "folder": { + "description": "The name of the vCenter folder for the user cluster.", + "type": "string" + }, + "resourcePool": { + "description": "The name of the vCenter resource pool for the user cluster.", + "type": "string" + } + }, + "type": "object" + }, + "VmwareVersionInfo": { + "description": "Contains information about a specific Anthos on VMware version.", + "id": "VmwareVersionInfo", + "properties": { + "hasDependencies": { + "description": "If set, the cluster dependencies (e.g. the admin cluster, other user clusters managed by the same admin cluster) must be upgraded before this version can be installed or upgraded to.", + "type": "boolean" + }, + "isInstalled": { + "description": "If set, the version is installed in the admin cluster. Otherwise, the version bundle must be downloaded and installed before a user cluster can be created at or upgraded to this version.", + "type": "boolean" + }, + "version": { + "description": "Version number e.g. 1.13.1-gke.1000.", + "type": "string" + } + }, + "type": "object" + }, + "VmwareVipConfig": { + "description": "Specifies the VIP config for the VMware user cluster load balancer.", + "id": "VmwareVipConfig", + "properties": { + "controlPlaneVip": { + "description": "The VIP which you previously set aside for the Kubernetes API of this cluster.", + "type": "string" + }, + "ingressVip": { + "description": "The VIP which you previously set aside for ingress traffic into this cluster.", + "type": "string" + } + }, + "type": "object" + }, + "VmwareVsphereConfig": { + "description": "VmwareVsphereConfig represents configuration for the VMware VCenter for node pool.", + "id": "VmwareVsphereConfig", + "properties": { + "datastore": { + "description": "The name of the vCenter datastore. Inherited from the user cluster.", + "type": "string" + }, + "tags": { + "description": "Tags to apply to VMs.", + "items": { + "$ref": "VmwareVsphereTag" + }, + "type": "array" + } + }, + "type": "object" + }, + "VmwareVsphereTag": { + "description": "VmwareVsphereTag describes a vSphere tag to be placed on VMs in the node pool. For more information, see https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.vcenterhost.doc/GUID-E8E854DD-AA97-4E0C-8419-CE84F93C4058.html", + "id": "VmwareVsphereTag", + "properties": { + "category": { + "description": "The Vsphere tag category.", + "type": "string" + }, + "tag": { + "description": "The Vsphere tag name.", + "type": "string" + } + }, + "type": "object" + } + }, + "servicePath": "", + "title": "Anthos On-Prem API", + "version": "v1", + "version_module": true +} \ No newline at end of file diff --git a/gkeonprem/v1/gkeonprem-gen.go b/gkeonprem/v1/gkeonprem-gen.go new file mode 100644 index 00000000000..ce43335c5f9 --- /dev/null +++ b/gkeonprem/v1/gkeonprem-gen.go @@ -0,0 +1,19470 @@ +// Copyright 2023 Google LLC. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// Code generated file. DO NOT EDIT. + +// Package gkeonprem provides access to the Anthos On-Prem API. +// +// For product documentation, see: https://cloud.google.com/anthos/clusters/docs/on-prem/ +// +// # Creating a client +// +// Usage example: +// +// import "google.golang.org/api/gkeonprem/v1" +// ... +// ctx := context.Background() +// gkeonpremService, err := gkeonprem.NewService(ctx) +// +// In this example, Google Application Default Credentials are used for authentication. +// +// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials. +// +// # Other authentication options +// +// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey: +// +// gkeonpremService, err := gkeonprem.NewService(ctx, option.WithAPIKey("AIza...")) +// +// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource: +// +// config := &oauth2.Config{...} +// // ... +// token, err := config.Exchange(ctx, ...) +// gkeonpremService, err := gkeonprem.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token))) +// +// See https://godoc.org/google.golang.org/api/option/ for details on options. +package gkeonprem // import "google.golang.org/api/gkeonprem/v1" + +import ( + "bytes" + "context" + "encoding/json" + "errors" + "fmt" + "io" + "net/http" + "net/url" + "strconv" + "strings" + + googleapi "google.golang.org/api/googleapi" + internal "google.golang.org/api/internal" + gensupport "google.golang.org/api/internal/gensupport" + option "google.golang.org/api/option" + internaloption "google.golang.org/api/option/internaloption" + htransport "google.golang.org/api/transport/http" +) + +// Always reference these packages, just in case the auto-generated code +// below doesn't. +var _ = bytes.NewBuffer +var _ = strconv.Itoa +var _ = fmt.Sprintf +var _ = json.NewDecoder +var _ = io.Copy +var _ = url.Parse +var _ = gensupport.MarshalJSON +var _ = googleapi.Version +var _ = errors.New +var _ = strings.Replace +var _ = context.Canceled +var _ = internaloption.WithDefaultEndpoint +var _ = internal.Version + +const apiId = "gkeonprem:v1" +const apiName = "gkeonprem" +const apiVersion = "v1" +const basePath = "https://gkeonprem.googleapis.com/" +const mtlsBasePath = "https://gkeonprem.mtls.googleapis.com/" + +// OAuth2 scopes used by this API. +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" +) + +// 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", + ) + // NOTE: prepend, so we don't override user-specified scopes. + opts = append([]option.ClientOption{scopesOption}, opts...) + opts = append(opts, internaloption.WithDefaultEndpoint(basePath)) + opts = append(opts, internaloption.WithDefaultMTLSEndpoint(mtlsBasePath)) + client, endpoint, err := htransport.NewClient(ctx, opts...) + if err != nil { + return nil, err + } + s, err := New(client) + if err != nil { + return nil, err + } + if endpoint != "" { + s.BasePath = endpoint + } + return s, nil +} + +// New creates a new Service. It uses the provided http.Client for requests. +// +// Deprecated: please use NewService instead. +// To provide a custom HTTP client, use option.WithHTTPClient. +// If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead. +func New(client *http.Client) (*Service, error) { + if client == nil { + return nil, errors.New("client is nil") + } + s := &Service{client: client, BasePath: basePath} + s.Projects = NewProjectsService(s) + return s, nil +} + +type Service struct { + client *http.Client + BasePath string // API endpoint base URL + UserAgent string // optional additional User-Agent fragment + + Projects *ProjectsService +} + +func (s *Service) userAgent() string { + if s.UserAgent == "" { + return googleapi.UserAgent + } + return googleapi.UserAgent + " " + s.UserAgent +} + +func NewProjectsService(s *Service) *ProjectsService { + rs := &ProjectsService{s: s} + rs.Locations = NewProjectsLocationsService(s) + return rs +} + +type ProjectsService struct { + s *Service + + Locations *ProjectsLocationsService +} + +func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { + rs := &ProjectsLocationsService{s: s} + rs.BareMetalAdminClusters = NewProjectsLocationsBareMetalAdminClustersService(s) + rs.BareMetalClusters = NewProjectsLocationsBareMetalClustersService(s) + rs.Operations = NewProjectsLocationsOperationsService(s) + rs.VmwareAdminClusters = NewProjectsLocationsVmwareAdminClustersService(s) + rs.VmwareClusters = NewProjectsLocationsVmwareClustersService(s) + return rs +} + +type ProjectsLocationsService struct { + s *Service + + BareMetalAdminClusters *ProjectsLocationsBareMetalAdminClustersService + + BareMetalClusters *ProjectsLocationsBareMetalClustersService + + Operations *ProjectsLocationsOperationsService + + VmwareAdminClusters *ProjectsLocationsVmwareAdminClustersService + + VmwareClusters *ProjectsLocationsVmwareClustersService +} + +func NewProjectsLocationsBareMetalAdminClustersService(s *Service) *ProjectsLocationsBareMetalAdminClustersService { + rs := &ProjectsLocationsBareMetalAdminClustersService{s: s} + rs.Operations = NewProjectsLocationsBareMetalAdminClustersOperationsService(s) + return rs +} + +type ProjectsLocationsBareMetalAdminClustersService struct { + s *Service + + Operations *ProjectsLocationsBareMetalAdminClustersOperationsService +} + +func NewProjectsLocationsBareMetalAdminClustersOperationsService(s *Service) *ProjectsLocationsBareMetalAdminClustersOperationsService { + rs := &ProjectsLocationsBareMetalAdminClustersOperationsService{s: s} + return rs +} + +type ProjectsLocationsBareMetalAdminClustersOperationsService struct { + s *Service +} + +func NewProjectsLocationsBareMetalClustersService(s *Service) *ProjectsLocationsBareMetalClustersService { + rs := &ProjectsLocationsBareMetalClustersService{s: s} + rs.BareMetalNodePools = NewProjectsLocationsBareMetalClustersBareMetalNodePoolsService(s) + rs.Operations = NewProjectsLocationsBareMetalClustersOperationsService(s) + return rs +} + +type ProjectsLocationsBareMetalClustersService struct { + s *Service + + BareMetalNodePools *ProjectsLocationsBareMetalClustersBareMetalNodePoolsService + + Operations *ProjectsLocationsBareMetalClustersOperationsService +} + +func NewProjectsLocationsBareMetalClustersBareMetalNodePoolsService(s *Service) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsService { + rs := &ProjectsLocationsBareMetalClustersBareMetalNodePoolsService{s: s} + rs.Operations = NewProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsService(s) + return rs +} + +type ProjectsLocationsBareMetalClustersBareMetalNodePoolsService struct { + s *Service + + Operations *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsService +} + +func NewProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsService(s *Service) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsService { + rs := &ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsService{s: s} + return rs +} + +type ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsService struct { + s *Service +} + +func NewProjectsLocationsBareMetalClustersOperationsService(s *Service) *ProjectsLocationsBareMetalClustersOperationsService { + rs := &ProjectsLocationsBareMetalClustersOperationsService{s: s} + return rs +} + +type ProjectsLocationsBareMetalClustersOperationsService struct { + s *Service +} + +func NewProjectsLocationsOperationsService(s *Service) *ProjectsLocationsOperationsService { + rs := &ProjectsLocationsOperationsService{s: s} + return rs +} + +type ProjectsLocationsOperationsService struct { + s *Service +} + +func NewProjectsLocationsVmwareAdminClustersService(s *Service) *ProjectsLocationsVmwareAdminClustersService { + rs := &ProjectsLocationsVmwareAdminClustersService{s: s} + rs.Operations = NewProjectsLocationsVmwareAdminClustersOperationsService(s) + return rs +} + +type ProjectsLocationsVmwareAdminClustersService struct { + s *Service + + Operations *ProjectsLocationsVmwareAdminClustersOperationsService +} + +func NewProjectsLocationsVmwareAdminClustersOperationsService(s *Service) *ProjectsLocationsVmwareAdminClustersOperationsService { + rs := &ProjectsLocationsVmwareAdminClustersOperationsService{s: s} + return rs +} + +type ProjectsLocationsVmwareAdminClustersOperationsService struct { + s *Service +} + +func NewProjectsLocationsVmwareClustersService(s *Service) *ProjectsLocationsVmwareClustersService { + rs := &ProjectsLocationsVmwareClustersService{s: s} + rs.Operations = NewProjectsLocationsVmwareClustersOperationsService(s) + rs.VmwareNodePools = NewProjectsLocationsVmwareClustersVmwareNodePoolsService(s) + return rs +} + +type ProjectsLocationsVmwareClustersService struct { + s *Service + + Operations *ProjectsLocationsVmwareClustersOperationsService + + VmwareNodePools *ProjectsLocationsVmwareClustersVmwareNodePoolsService +} + +func NewProjectsLocationsVmwareClustersOperationsService(s *Service) *ProjectsLocationsVmwareClustersOperationsService { + rs := &ProjectsLocationsVmwareClustersOperationsService{s: s} + return rs +} + +type ProjectsLocationsVmwareClustersOperationsService struct { + s *Service +} + +func NewProjectsLocationsVmwareClustersVmwareNodePoolsService(s *Service) *ProjectsLocationsVmwareClustersVmwareNodePoolsService { + rs := &ProjectsLocationsVmwareClustersVmwareNodePoolsService{s: s} + rs.Operations = NewProjectsLocationsVmwareClustersVmwareNodePoolsOperationsService(s) + return rs +} + +type ProjectsLocationsVmwareClustersVmwareNodePoolsService struct { + s *Service + + Operations *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsService +} + +func NewProjectsLocationsVmwareClustersVmwareNodePoolsOperationsService(s *Service) *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsService { + rs := &ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsService{s: s} + return rs +} + +type ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsService struct { + s *Service +} + +// Authorization: Authorization defines the On-Prem cluster +// authorization configuration to bootstrap onto the admin cluster. +type Authorization struct { + // AdminUsers: Required. For VMware user, bare metal user and standalone + // clusters, users that will be granted the cluster-admin role on the + // cluster, providing full access to the cluster. For bare metal Admin + // cluster, users will be granted the view role, which is a view only + // access. + AdminUsers []*ClusterUser `json:"adminUsers,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AdminUsers") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AdminUsers") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Authorization) MarshalJSON() ([]byte, error) { + type NoMethod Authorization + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminApiServerArgument: BareMetalAdminApiServerArgument +// represents an arg name->value pair. Only a subset of customized flags +// are supported. Please refer to the API server documentation below to +// know the exact format: +// https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/ +type BareMetalAdminApiServerArgument struct { + // Argument: Required. The argument name as it appears on the API Server + // command line please make sure to remove the leading dashes. + Argument string `json:"argument,omitempty"` + + // Value: Required. The value of the arg as it will be passed to the API + // Server command line. + Value string `json:"value,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Argument") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Argument") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminApiServerArgument) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminApiServerArgument + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminCluster: ## Resource that represents a bare metal admin +// cluster. +type BareMetalAdminCluster struct { + // Annotations: Annotations on the bare metal admin cluster. This field + // has the same restrictions as Kubernetes annotations. The total size + // of all keys and values combined is limited to 256k. Key can have 2 + // segments: prefix (optional) and name (required), separated by a slash + // (/). Prefix must be a DNS subdomain. Name must be 63 characters or + // less, begin and end with alphanumerics, with dashes (-), underscores + // (_), dots (.), and alphanumerics between. + Annotations map[string]string `json:"annotations,omitempty"` + + // BareMetalVersion: The Anthos clusters on bare metal version for the + // bare metal admin cluster. + BareMetalVersion string `json:"bareMetalVersion,omitempty"` + + // ClusterOperations: Cluster operations configuration. + ClusterOperations *BareMetalAdminClusterOperationsConfig `json:"clusterOperations,omitempty"` + + // ControlPlane: Control plane configuration. + ControlPlane *BareMetalAdminControlPlaneConfig `json:"controlPlane,omitempty"` + + // CreateTime: Output only. The time at which this bare metal admin + // cluster was created. + CreateTime string `json:"createTime,omitempty"` + + // DeleteTime: Output only. The time at which this bare metal admin + // cluster was deleted. If the resource is not deleted, this must be + // empty + DeleteTime string `json:"deleteTime,omitempty"` + + // Description: A human readable description of this bare metal admin + // cluster. + Description string `json:"description,omitempty"` + + // Endpoint: Output only. The IP address name of bare metal admin + // cluster's API server. + Endpoint string `json:"endpoint,omitempty"` + + // Etag: This checksum is computed by the server based on the value of + // other fields, and may be sent on update and delete requests to ensure + // the client has an up-to-date value before proceeding. Allows clients + // to perform consistent read-modify-writes through optimistic + // concurrency control. + Etag string `json:"etag,omitempty"` + + // Fleet: Output only. Fleet configuration for the cluster. + Fleet *Fleet `json:"fleet,omitempty"` + + // LoadBalancer: Load balancer configuration. + LoadBalancer *BareMetalAdminLoadBalancerConfig `json:"loadBalancer,omitempty"` + + // LocalName: Output only. The object name of the bare metal cluster + // custom resource. This field is used to support conflicting names when + // enrolling existing clusters to the API. When used as a part of + // cluster enrollment, this field will differ from the ID in the + // resource name. For new clusters, this field will match the user + // provided cluster name and be visible in the last component of the + // resource name. It is not modifiable. All users should use this name + // to access their cluster using gkectl or kubectl and should expect to + // see the local name when viewing admin cluster controller logs. + LocalName string `json:"localName,omitempty"` + + // MaintenanceConfig: Maintenance configuration. + MaintenanceConfig *BareMetalAdminMaintenanceConfig `json:"maintenanceConfig,omitempty"` + + // MaintenanceStatus: Output only. MaintenanceStatus representing state + // of maintenance. + MaintenanceStatus *BareMetalAdminMaintenanceStatus `json:"maintenanceStatus,omitempty"` + + // Name: Immutable. The bare metal admin cluster resource name. + Name string `json:"name,omitempty"` + + // NetworkConfig: Network configuration. + NetworkConfig *BareMetalAdminNetworkConfig `json:"networkConfig,omitempty"` + + // NodeAccessConfig: Node access related configurations. + NodeAccessConfig *BareMetalAdminNodeAccessConfig `json:"nodeAccessConfig,omitempty"` + + // NodeConfig: Workload node configuration. + NodeConfig *BareMetalAdminWorkloadNodeConfig `json:"nodeConfig,omitempty"` + + // OsEnvironmentConfig: OS environment related configurations. + OsEnvironmentConfig *BareMetalAdminOsEnvironmentConfig `json:"osEnvironmentConfig,omitempty"` + + // Proxy: Proxy configuration. + Proxy *BareMetalAdminProxyConfig `json:"proxy,omitempty"` + + // Reconciling: Output only. If set, there are currently changes in + // flight to the bare metal Admin Cluster. + Reconciling bool `json:"reconciling,omitempty"` + + // SecurityConfig: Security related configuration. + SecurityConfig *BareMetalAdminSecurityConfig `json:"securityConfig,omitempty"` + + // State: Output only. The current state of the bare metal admin + // cluster. + // + // Possible values: + // "STATE_UNSPECIFIED" - Not set. + // "PROVISIONING" - The PROVISIONING state indicates the cluster is + // being created. + // "RUNNING" - The RUNNING state indicates the cluster has been + // created and is fully usable. + // "RECONCILING" - The RECONCILING state indicates that the cluster is + // being updated. It remains available, but potentially with degraded + // performance. + // "STOPPING" - The STOPPING state indicates the cluster is being + // deleted. + // "ERROR" - The ERROR state indicates the cluster is in a broken + // unrecoverable state. + // "DEGRADED" - The DEGRADED state indicates the cluster requires user + // action to restore full functionality. + State string `json:"state,omitempty"` + + // Status: Output only. ResourceStatus representing detailed cluster + // status. + Status *ResourceStatus `json:"status,omitempty"` + + // Storage: Storage configuration. + Storage *BareMetalAdminStorageConfig `json:"storage,omitempty"` + + // Uid: Output only. The unique identifier of the bare metal admin + // cluster. + Uid string `json:"uid,omitempty"` + + // UpdateTime: Output only. The time at which this bare metal admin + // cluster was last updated. + UpdateTime string `json:"updateTime,omitempty"` + + // ValidationCheck: Output only. ValidationCheck representing the result + // of the preflight check. + ValidationCheck *ValidationCheck `json:"validationCheck,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Annotations") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Annotations") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminCluster) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminCluster + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminClusterOperationsConfig: +// BareMetalAdminClusterOperationsConfig specifies the admin cluster's +// observability infrastructure. +type BareMetalAdminClusterOperationsConfig struct { + // EnableApplicationLogs: Whether collection of application logs/metrics + // should be enabled (in addition to system logs/metrics). + EnableApplicationLogs bool `json:"enableApplicationLogs,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "EnableApplicationLogs") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "EnableApplicationLogs") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminClusterOperationsConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminClusterOperationsConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminControlPlaneConfig: BareMetalAdminControlPlaneConfig +// specifies the control plane configuration. +type BareMetalAdminControlPlaneConfig struct { + // ApiServerArgs: Customizes the default API server args. Only a subset + // of customized flags are supported. Please refer to the API server + // documentation below to know the exact format: + // https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/ + ApiServerArgs []*BareMetalAdminApiServerArgument `json:"apiServerArgs,omitempty"` + + // ControlPlaneNodePoolConfig: Configures the node pool running the + // control plane. If specified the corresponding NodePool will be + // created for the cluster's control plane. The NodePool will have the + // same name and namespace as the cluster. + ControlPlaneNodePoolConfig *BareMetalAdminControlPlaneNodePoolConfig `json:"controlPlaneNodePoolConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ApiServerArgs") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ApiServerArgs") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminControlPlaneConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminControlPlaneConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminControlPlaneNodePoolConfig: +// BareMetalAdminControlPlaneNodePoolConfig specifies the control plane +// node pool configuration. We have a control plane specific node pool +// config so that we can flexible about supporting control plane +// specific fields in the future. +type BareMetalAdminControlPlaneNodePoolConfig struct { + // NodePoolConfig: The generic configuration for a node pool running the + // control plane. + NodePoolConfig *BareMetalNodePoolConfig `json:"nodePoolConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "NodePoolConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NodePoolConfig") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminControlPlaneNodePoolConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminControlPlaneNodePoolConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminDrainedMachine: BareMetalAdminDrainedMachine represents +// the machines that are drained. +type BareMetalAdminDrainedMachine struct { + // NodeIp: Drained machine IP address. + NodeIp string `json:"nodeIp,omitempty"` + + // ForceSendFields is a list of field names (e.g. "NodeIp") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NodeIp") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminDrainedMachine) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminDrainedMachine + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminDrainingMachine: BareMetalAdminDrainingMachine +// represents the machines that are currently draining. +type BareMetalAdminDrainingMachine struct { + // NodeIp: Draining machine IP address. + NodeIp string `json:"nodeIp,omitempty"` + + // PodCount: The count of pods yet to drain. + PodCount int64 `json:"podCount,omitempty"` + + // ForceSendFields is a list of field names (e.g. "NodeIp") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NodeIp") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminDrainingMachine) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminDrainingMachine + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminIslandModeCidrConfig: +// BareMetalAdminIslandModeCidrConfig specifies the cluster CIDR +// configuration while running in island mode. +type BareMetalAdminIslandModeCidrConfig struct { + // PodAddressCidrBlocks: Required. All pods in the cluster are assigned + // an RFC1918 IPv4 address from these ranges. This field cannot be + // changed after creation. + PodAddressCidrBlocks []string `json:"podAddressCidrBlocks,omitempty"` + + // ServiceAddressCidrBlocks: Required. All services in the cluster are + // assigned an RFC1918 IPv4 address from these ranges. This field cannot + // be changed after creation. + ServiceAddressCidrBlocks []string `json:"serviceAddressCidrBlocks,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "PodAddressCidrBlocks") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "PodAddressCidrBlocks") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminIslandModeCidrConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminIslandModeCidrConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminLoadBalancerConfig: BareMetalAdminLoadBalancerConfig +// specifies the load balancer configuration. +type BareMetalAdminLoadBalancerConfig struct { + // ManualLbConfig: Manually configured load balancers. + ManualLbConfig *BareMetalAdminManualLbConfig `json:"manualLbConfig,omitempty"` + + // PortConfig: Configures the ports that the load balancer will listen + // on. + PortConfig *BareMetalAdminPortConfig `json:"portConfig,omitempty"` + + // VipConfig: The VIPs used by the load balancer. + VipConfig *BareMetalAdminVipConfig `json:"vipConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ManualLbConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ManualLbConfig") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminLoadBalancerConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminLoadBalancerConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminMachineDrainStatus: BareMetalAdminMachineDrainStatus +// represents the status of bare metal node machines that are undergoing +// drain operations. +type BareMetalAdminMachineDrainStatus struct { + // DrainedMachines: The list of drained machines. + DrainedMachines []*BareMetalAdminDrainedMachine `json:"drainedMachines,omitempty"` + + // DrainingMachines: The list of draning machines. + DrainingMachines []*BareMetalAdminDrainingMachine `json:"drainingMachines,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DrainedMachines") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DrainedMachines") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminMachineDrainStatus) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminMachineDrainStatus + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminMaintenanceConfig: BareMetalAdminMaintenanceConfig +// specifies configurations to put bare metal Admin cluster CRs nodes in +// and out of maintenance. +type BareMetalAdminMaintenanceConfig struct { + // MaintenanceAddressCidrBlocks: Required. All IPv4 address from these + // ranges will be placed into maintenance mode. Nodes in maintenance + // mode will be cordoned and drained. When both of these are true, the + // "baremetal.cluster.gke.io/maintenance" annotation will be set on the + // node resource. + MaintenanceAddressCidrBlocks []string `json:"maintenanceAddressCidrBlocks,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "MaintenanceAddressCidrBlocks") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted + // from API requests. However, any non-pointer, non-interface field + // appearing in ForceSendFields will be sent to the server regardless of + // whether the field is empty or not. This may be used to include empty + // fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. + // "MaintenanceAddressCidrBlocks") to include in API requests with the + // JSON null value. By default, fields with empty values are omitted + // from API requests. However, any field with an empty value appearing + // in NullFields will be sent to the server as null. It is an error if a + // field in this list has a non-empty value. This may be used to include + // null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminMaintenanceConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminMaintenanceConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminMaintenanceStatus: BareMetalAdminMaintenanceStatus +// represents the maintenance status for bare metal Admin cluster CR's +// nodes. +type BareMetalAdminMaintenanceStatus struct { + // MachineDrainStatus: Represents the status of draining and drained + // machine nodes. This is used to show the progress of cluster upgrade. + MachineDrainStatus *BareMetalAdminMachineDrainStatus `json:"machineDrainStatus,omitempty"` + + // ForceSendFields is a list of field names (e.g. "MachineDrainStatus") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "MachineDrainStatus") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminMaintenanceStatus) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminMaintenanceStatus + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminManualLbConfig: BareMetalAdminManualLbConfig represents +// configuration parameters for a manual load balancer. +type BareMetalAdminManualLbConfig struct { + // Enabled: Whether manual load balancing is enabled. + Enabled bool `json:"enabled,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Enabled") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Enabled") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminManualLbConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminManualLbConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminNetworkConfig: BareMetalAdminNetworkConfig specifies +// the cluster network configuration. +type BareMetalAdminNetworkConfig struct { + // IslandModeCidr: Configuration for Island mode CIDR. + IslandModeCidr *BareMetalAdminIslandModeCidrConfig `json:"islandModeCidr,omitempty"` + + // ForceSendFields is a list of field names (e.g. "IslandModeCidr") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "IslandModeCidr") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminNetworkConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminNetworkConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminNodeAccessConfig: Specifies the node access related +// settings for the bare metal admin cluster. +type BareMetalAdminNodeAccessConfig struct { + // LoginUser: Required. LoginUser is the user name used to access node + // machines. It defaults to "root" if not set. + LoginUser string `json:"loginUser,omitempty"` + + // ForceSendFields is a list of field names (e.g. "LoginUser") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "LoginUser") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminNodeAccessConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminNodeAccessConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminOsEnvironmentConfig: Specifies operating system +// operation settings for cluster provisioning. +type BareMetalAdminOsEnvironmentConfig struct { + // PackageRepoExcluded: Whether the package repo should be added when + // initializing bare metal machines. + PackageRepoExcluded bool `json:"packageRepoExcluded,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PackageRepoExcluded") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "PackageRepoExcluded") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminOsEnvironmentConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminOsEnvironmentConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminPortConfig: BareMetalAdminPortConfig is the +// specification of load balancer ports. +type BareMetalAdminPortConfig struct { + // ControlPlaneLoadBalancerPort: The port that control plane hosted load + // balancers will listen on. + ControlPlaneLoadBalancerPort int64 `json:"controlPlaneLoadBalancerPort,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "ControlPlaneLoadBalancerPort") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted + // from API requests. However, any non-pointer, non-interface field + // appearing in ForceSendFields will be sent to the server regardless of + // whether the field is empty or not. This may be used to include empty + // fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. + // "ControlPlaneLoadBalancerPort") to include in API requests with the + // JSON null value. By default, fields with empty values are omitted + // from API requests. However, any field with an empty value appearing + // in NullFields will be sent to the server as null. It is an error if a + // field in this list has a non-empty value. This may be used to include + // null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminPortConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminPortConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminProxyConfig: BareMetalAdminProxyConfig specifies the +// cluster proxy configuration. +type BareMetalAdminProxyConfig struct { + // NoProxy: A list of IPs, hostnames, and domains that should skip the + // proxy. Examples: ["127.0.0.1", "example.com", ".corp", "localhost"]. + NoProxy []string `json:"noProxy,omitempty"` + + // Uri: Required. Specifies the address of your proxy server. Examples: + // `http://domain` WARNING: Do not provide credentials in the format + // `http://(username:password@)domain` these will be rejected by the + // server. + Uri string `json:"uri,omitempty"` + + // ForceSendFields is a list of field names (e.g. "NoProxy") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NoProxy") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminProxyConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminProxyConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminSecurityConfig: Specifies the security related settings +// for the bare metal admin cluster. +type BareMetalAdminSecurityConfig struct { + // Authorization: Configures user access to the admin cluster. + Authorization *Authorization `json:"authorization,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Authorization") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Authorization") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminSecurityConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminSecurityConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminStorageConfig: BareMetalAdminStorageConfig specifies +// the cluster storage configuration. +type BareMetalAdminStorageConfig struct { + // LvpNodeMountsConfig: Required. Specifies the config for local + // PersistentVolumes backed by mounted node disks. These disks need to + // be formatted and mounted by the user, which can be done before or + // after cluster creation. + LvpNodeMountsConfig *BareMetalLvpConfig `json:"lvpNodeMountsConfig,omitempty"` + + // LvpShareConfig: Required. Specifies the config for local + // PersistentVolumes backed by subdirectories in a shared filesystem. + // These subdirectores are automatically created during cluster + // creation. + LvpShareConfig *BareMetalLvpShareConfig `json:"lvpShareConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "LvpNodeMountsConfig") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "LvpNodeMountsConfig") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminStorageConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminStorageConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminVipConfig: BareMetalAdminVipConfig for bare metal load +// balancer configurations. +type BareMetalAdminVipConfig struct { + // ControlPlaneVip: The VIP which you previously set aside for the + // Kubernetes API of this bare metal admin cluster. + ControlPlaneVip string `json:"controlPlaneVip,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ControlPlaneVip") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ControlPlaneVip") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminVipConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminVipConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalAdminWorkloadNodeConfig: BareMetalAdminWorkloadNodeConfig +// specifies the workload node configurations. +type BareMetalAdminWorkloadNodeConfig struct { + // MaxPodsPerNode: The maximum number of pods a node can run. The size + // of the CIDR range assigned to the node will be derived from this + // parameter. By default 110 Pods are created per Node. Upper bound is + // 250 for both HA and non-HA admin cluster. Lower bound is 64 for + // non-HA admin cluster and 32 for HA admin cluster. + MaxPodsPerNode int64 `json:"maxPodsPerNode,omitempty,string"` + + // ForceSendFields is a list of field names (e.g. "MaxPodsPerNode") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "MaxPodsPerNode") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalAdminWorkloadNodeConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalAdminWorkloadNodeConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalApiServerArgument: Represents an arg name->value pair. Only +// a subset of customized flags are supported. For the exact format, +// refer to the API server documentation +// (https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/). +type BareMetalApiServerArgument struct { + // Argument: Required. The argument name as it appears on the API Server + // command line, make sure to remove the leading dashes. + Argument string `json:"argument,omitempty"` + + // Value: Required. The value of the arg as it will be passed to the API + // Server command line. + Value string `json:"value,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Argument") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Argument") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalApiServerArgument) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalApiServerArgument + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalBgpLbConfig: BareMetalBgpLbConfig represents configuration +// parameters for a Border Gateway Protocol (BGP) load balancer. +type BareMetalBgpLbConfig struct { + // AddressPools: Required. AddressPools is a list of non-overlapping IP + // pools used by load balancer typed services. All addresses must be + // routable to load balancer nodes. IngressVIP must be included in the + // pools. + AddressPools []*BareMetalLoadBalancerAddressPool `json:"addressPools,omitempty"` + + // Asn: Required. BGP autonomous system number (ASN) of the cluster. + // This field can be updated after cluster creation. + Asn int64 `json:"asn,omitempty,string"` + + // BgpPeerConfigs: Required. The list of BGP peers that the cluster will + // connect to. At least one peer must be configured for each control + // plane node. Control plane nodes will connect to these peers to + // advertise the control plane VIP. The Services load balancer also uses + // these peers by default. This field can be updated after cluster + // creation. + BgpPeerConfigs []*BareMetalBgpPeerConfig `json:"bgpPeerConfigs,omitempty"` + + // LoadBalancerNodePoolConfig: Specifies the node pool running data + // plane load balancing. L2 connectivity is required among nodes in this + // pool. If missing, the control plane node pool is used for data plane + // load balancing. + LoadBalancerNodePoolConfig *BareMetalLoadBalancerNodePoolConfig `json:"loadBalancerNodePoolConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AddressPools") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AddressPools") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalBgpLbConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalBgpLbConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalBgpPeerConfig: BareMetalBgpPeerConfig represents +// configuration parameters for a Border Gateway Protocol (BGP) peer. +type BareMetalBgpPeerConfig struct { + // Asn: Required. BGP autonomous system number (ASN) for the network + // that contains the external peer device. + Asn int64 `json:"asn,omitempty,string"` + + // ControlPlaneNodes: The IP address of the control plane node that + // connects to the external peer. If you don't specify any control plane + // nodes, all control plane nodes can connect to the external peer. If + // you specify one or more IP addresses, only the nodes specified + // participate in peering sessions. + ControlPlaneNodes []string `json:"controlPlaneNodes,omitempty"` + + // IpAddress: Required. The IP address of the external peer device. + IpAddress string `json:"ipAddress,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Asn") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Asn") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalBgpPeerConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalBgpPeerConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalCluster: Resource that represents a bare metal user cluster. +type BareMetalCluster struct { + // AdminClusterMembership: Required. The admin cluster this bare metal + // user cluster belongs to. This is the full resource name of the admin + // cluster's fleet membership. + AdminClusterMembership string `json:"adminClusterMembership,omitempty"` + + // AdminClusterName: Output only. The resource name of the bare metal + // admin cluster managing this user cluster. + AdminClusterName string `json:"adminClusterName,omitempty"` + + // Annotations: Annotations on the bare metal user cluster. This field + // has the same restrictions as Kubernetes annotations. The total size + // of all keys and values combined is limited to 256k. Key can have 2 + // segments: prefix (optional) and name (required), separated by a slash + // (/). Prefix must be a DNS subdomain. Name must be 63 characters or + // less, begin and end with alphanumerics, with dashes (-), underscores + // (_), dots (.), and alphanumerics between. + Annotations map[string]string `json:"annotations,omitempty"` + + // BareMetalVersion: Required. The Anthos clusters on bare metal version + // for your user cluster. + BareMetalVersion string `json:"bareMetalVersion,omitempty"` + + // ClusterOperations: Cluster operations configuration. + ClusterOperations *BareMetalClusterOperationsConfig `json:"clusterOperations,omitempty"` + + // ControlPlane: Required. Control plane configuration. + ControlPlane *BareMetalControlPlaneConfig `json:"controlPlane,omitempty"` + + // CreateTime: Output only. The time when the bare metal user cluster + // was created. + CreateTime string `json:"createTime,omitempty"` + + // DeleteTime: Output only. The time when the bare metal user cluster + // was deleted. If the resource is not deleted, this must be empty + DeleteTime string `json:"deleteTime,omitempty"` + + // Description: A human readable description of this bare metal user + // cluster. + Description string `json:"description,omitempty"` + + // Endpoint: Output only. The IP address of the bare metal user + // cluster's API server. + Endpoint string `json:"endpoint,omitempty"` + + // Etag: Output only. This checksum is computed by the server based on + // the value of other fields, and may be sent on update and delete + // requests to ensure the client has an up-to-date value before + // proceeding. Allows clients to perform consistent read-modify-writes + // through optimistic concurrency control. + Etag string `json:"etag,omitempty"` + + // Fleet: Output only. Fleet configuration for the cluster. + Fleet *Fleet `json:"fleet,omitempty"` + + // LoadBalancer: Required. Load balancer configuration. + LoadBalancer *BareMetalLoadBalancerConfig `json:"loadBalancer,omitempty"` + + // LocalName: Output only. The object name of the bare metal user + // cluster custom resource on the associated admin cluster. This field + // is used to support conflicting names when enrolling existing clusters + // to the API. When used as a part of cluster enrollment, this field + // will differ from the name in the resource name. For new clusters, + // this field will match the user provided cluster name and be visible + // in the last component of the resource name. It is not modifiable. + // When the local name and cluster name differ, the local name is used + // in the admin cluster controller logs. You use the cluster name when + // accessing the cluster using bmctl and kubectl. + LocalName string `json:"localName,omitempty"` + + // MaintenanceConfig: Maintenance configuration. + MaintenanceConfig *BareMetalMaintenanceConfig `json:"maintenanceConfig,omitempty"` + + // MaintenanceStatus: Output only. Status of on-going maintenance tasks. + MaintenanceStatus *BareMetalMaintenanceStatus `json:"maintenanceStatus,omitempty"` + + // Name: Immutable. The bare metal user cluster resource name. + Name string `json:"name,omitempty"` + + // NetworkConfig: Required. Network configuration. + NetworkConfig *BareMetalNetworkConfig `json:"networkConfig,omitempty"` + + // NodeAccessConfig: Node access related configurations. + NodeAccessConfig *BareMetalNodeAccessConfig `json:"nodeAccessConfig,omitempty"` + + // NodeConfig: Workload node configuration. + NodeConfig *BareMetalWorkloadNodeConfig `json:"nodeConfig,omitempty"` + + // OsEnvironmentConfig: OS environment related configurations. + OsEnvironmentConfig *BareMetalOsEnvironmentConfig `json:"osEnvironmentConfig,omitempty"` + + // Proxy: Proxy configuration. + Proxy *BareMetalProxyConfig `json:"proxy,omitempty"` + + // Reconciling: Output only. If set, there are currently changes in + // flight to the bare metal user cluster. + Reconciling bool `json:"reconciling,omitempty"` + + // SecurityConfig: Security related setting configuration. + SecurityConfig *BareMetalSecurityConfig `json:"securityConfig,omitempty"` + + // State: Output only. The current state of the bare metal user cluster. + // + // Possible values: + // "STATE_UNSPECIFIED" - Not set. + // "PROVISIONING" - The PROVISIONING state indicates the cluster is + // being created. + // "RUNNING" - The RUNNING state indicates the cluster has been + // created and is fully usable. + // "RECONCILING" - The RECONCILING state indicates that the cluster is + // being updated. It remains available, but potentially with degraded + // performance. + // "STOPPING" - The STOPPING state indicates the cluster is being + // deleted. + // "ERROR" - The ERROR state indicates the cluster is in a broken + // unrecoverable state. + // "DEGRADED" - The DEGRADED state indicates the cluster requires user + // action to restore full functionality. + State string `json:"state,omitempty"` + + // Status: Output only. Detailed cluster status. + Status *ResourceStatus `json:"status,omitempty"` + + // Storage: Required. Storage configuration. + Storage *BareMetalStorageConfig `json:"storage,omitempty"` + + // Uid: Output only. The unique identifier of the bare metal user + // cluster. + Uid string `json:"uid,omitempty"` + + // UpdateTime: Output only. The time when the bare metal user cluster + // was last updated. + UpdateTime string `json:"updateTime,omitempty"` + + // ValidationCheck: Output only. The result of the preflight check. + ValidationCheck *ValidationCheck `json:"validationCheck,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. + // "AdminClusterMembership") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AdminClusterMembership") + // to include in API requests with the JSON null value. By default, + // fields with empty values are omitted from API requests. However, any + // field with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalCluster) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalCluster + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalClusterOperationsConfig: Specifies the bare metal user +// cluster's observability infrastructure. +type BareMetalClusterOperationsConfig struct { + // EnableApplicationLogs: Whether collection of application logs/metrics + // should be enabled (in addition to system logs/metrics). + EnableApplicationLogs bool `json:"enableApplicationLogs,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "EnableApplicationLogs") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "EnableApplicationLogs") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalClusterOperationsConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalClusterOperationsConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalControlPlaneConfig: Specifies the control plane +// configuration. +type BareMetalControlPlaneConfig struct { + // ApiServerArgs: Customizes the default API server args. Only a subset + // of customized flags are supported. For the exact format, refer to the + // API server documentation + // (https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/). + ApiServerArgs []*BareMetalApiServerArgument `json:"apiServerArgs,omitempty"` + + // ControlPlaneNodePoolConfig: Required. Configures the node pool + // running the control plane. + ControlPlaneNodePoolConfig *BareMetalControlPlaneNodePoolConfig `json:"controlPlaneNodePoolConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ApiServerArgs") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ApiServerArgs") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalControlPlaneConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalControlPlaneConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalControlPlaneNodePoolConfig: Specifies the control plane node +// pool configuration. +type BareMetalControlPlaneNodePoolConfig struct { + // NodePoolConfig: Required. The generic configuration for a node pool + // running the control plane. + NodePoolConfig *BareMetalNodePoolConfig `json:"nodePoolConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "NodePoolConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NodePoolConfig") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalControlPlaneNodePoolConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalControlPlaneNodePoolConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalDrainedMachine: Represents a machine that is currently +// drained. +type BareMetalDrainedMachine struct { + // NodeIp: Drained machine IP address. + NodeIp string `json:"nodeIp,omitempty"` + + // ForceSendFields is a list of field names (e.g. "NodeIp") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NodeIp") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalDrainedMachine) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalDrainedMachine + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalDrainingMachine: Represents a machine that is currently +// draining. +type BareMetalDrainingMachine struct { + // NodeIp: Draining machine IP address. + NodeIp string `json:"nodeIp,omitempty"` + + // PodCount: The count of pods yet to drain. + PodCount int64 `json:"podCount,omitempty"` + + // ForceSendFields is a list of field names (e.g. "NodeIp") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NodeIp") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalDrainingMachine) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalDrainingMachine + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalIslandModeCidrConfig: Specifies the cluster CIDR +// configuration while running in island mode. +type BareMetalIslandModeCidrConfig struct { + // PodAddressCidrBlocks: Required. All pods in the cluster are assigned + // an RFC1918 IPv4 address from these ranges. This field cannot be + // changed after creation. + PodAddressCidrBlocks []string `json:"podAddressCidrBlocks,omitempty"` + + // ServiceAddressCidrBlocks: Required. All services in the cluster are + // assigned an RFC1918 IPv4 address from these ranges. This field is + // mutable after creation starting with version 1.15. + ServiceAddressCidrBlocks []string `json:"serviceAddressCidrBlocks,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "PodAddressCidrBlocks") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "PodAddressCidrBlocks") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalIslandModeCidrConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalIslandModeCidrConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalKubeletConfig: KubeletConfig defines the modifiable kubelet +// configurations for baremetal machines. Note: this list includes +// fields supported in GKE (see +// https://cloud.google.com/kubernetes-engine/docs/how-to/node-system-config#kubelet-options). +type BareMetalKubeletConfig struct { + // RegistryBurst: The maximum size of bursty pulls, temporarily allows + // pulls to burst to this number, while still not exceeding + // registry_pull_qps. The value must not be a negative number. Updating + // this field may impact scalability by changing the amount of traffic + // produced by image pulls. Defaults to 10. + RegistryBurst int64 `json:"registryBurst,omitempty"` + + // RegistryPullQps: The limit of registry pulls per second. Setting this + // value to 0 means no limit. Updating this field may impact scalability + // by changing the amount of traffic produced by image pulls. Defaults + // to 5. + RegistryPullQps int64 `json:"registryPullQps,omitempty"` + + // SerializeImagePullsDisabled: Prevents the Kubelet from pulling + // multiple images at a time. We recommend *not* changing the default + // value on nodes that run docker daemon with version < 1.9 or an + // Another Union File System (Aufs) storage backend. Issue + // https://github.com/kubernetes/kubernetes/issues/10959 has more + // details. + SerializeImagePullsDisabled bool `json:"serializeImagePullsDisabled,omitempty"` + + // ForceSendFields is a list of field names (e.g. "RegistryBurst") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "RegistryBurst") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalKubeletConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalKubeletConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalLoadBalancerAddressPool: Represents an IP pool used by the +// load balancer. +type BareMetalLoadBalancerAddressPool struct { + // Addresses: Required. The addresses that are part of this pool. Each + // address must be either in the CIDR form (1.2.3.0/24) or range form + // (1.2.3.1-1.2.3.5). + Addresses []string `json:"addresses,omitempty"` + + // AvoidBuggyIps: If true, avoid using IPs ending in .0 or .255. This + // avoids buggy consumer devices mistakenly dropping IPv4 traffic for + // those special IP addresses. + AvoidBuggyIps bool `json:"avoidBuggyIps,omitempty"` + + // ManualAssign: If true, prevent IP addresses from being automatically + // assigned. + ManualAssign bool `json:"manualAssign,omitempty"` + + // Pool: Required. The name of the address pool. + Pool string `json:"pool,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Addresses") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Addresses") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalLoadBalancerAddressPool) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalLoadBalancerAddressPool + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalLoadBalancerConfig: Specifies the load balancer +// configuration. +type BareMetalLoadBalancerConfig struct { + // BgpLbConfig: Configuration for BGP typed load balancers. When set + // network_config.advanced_networking is automatically set to true. + BgpLbConfig *BareMetalBgpLbConfig `json:"bgpLbConfig,omitempty"` + + // ManualLbConfig: Manually configured load balancers. + ManualLbConfig *BareMetalManualLbConfig `json:"manualLbConfig,omitempty"` + + // MetalLbConfig: Configuration for MetalLB load balancers. + MetalLbConfig *BareMetalMetalLbConfig `json:"metalLbConfig,omitempty"` + + // PortConfig: Configures the ports that the load balancer will listen + // on. + PortConfig *BareMetalPortConfig `json:"portConfig,omitempty"` + + // VipConfig: The VIPs used by the load balancer. + VipConfig *BareMetalVipConfig `json:"vipConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BgpLbConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BgpLbConfig") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalLoadBalancerConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalLoadBalancerConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalLoadBalancerNodePoolConfig: Specifies the load balancer's +// node pool configuration. +type BareMetalLoadBalancerNodePoolConfig struct { + // NodePoolConfig: The generic configuration for a node pool running a + // load balancer. + NodePoolConfig *BareMetalNodePoolConfig `json:"nodePoolConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "NodePoolConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NodePoolConfig") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalLoadBalancerNodePoolConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalLoadBalancerNodePoolConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalLvpConfig: Specifies the configs for local persistent +// volumes (PVs). +type BareMetalLvpConfig struct { + // Path: Required. The host machine path. + Path string `json:"path,omitempty"` + + // StorageClass: Required. The StorageClass name that PVs will be + // created with. + StorageClass string `json:"storageClass,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Path") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Path") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalLvpConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalLvpConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalLvpShareConfig: Specifies the configs for local persistent +// volumes under a shared file system. +type BareMetalLvpShareConfig struct { + // LvpConfig: Required. Defines the machine path and storage class for + // the LVP Share. + LvpConfig *BareMetalLvpConfig `json:"lvpConfig,omitempty"` + + // SharedPathPvCount: The number of subdirectories to create under path. + SharedPathPvCount int64 `json:"sharedPathPvCount,omitempty"` + + // ForceSendFields is a list of field names (e.g. "LvpConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "LvpConfig") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalLvpShareConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalLvpShareConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalMachineDrainStatus: Represents the status of node machines +// that are undergoing drain operations. +type BareMetalMachineDrainStatus struct { + // DrainedMachines: The list of drained machines. + DrainedMachines []*BareMetalDrainedMachine `json:"drainedMachines,omitempty"` + + // DrainingMachines: The list of draning machines. + DrainingMachines []*BareMetalDrainingMachine `json:"drainingMachines,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DrainedMachines") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DrainedMachines") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalMachineDrainStatus) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalMachineDrainStatus + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalMaintenanceConfig: Specifies configurations to put bare +// metal nodes in and out of maintenance. +type BareMetalMaintenanceConfig struct { + // MaintenanceAddressCidrBlocks: Required. All IPv4 address from these + // ranges will be placed into maintenance mode. Nodes in maintenance + // mode will be cordoned and drained. When both of these are true, the + // "baremetal.cluster.gke.io/maintenance" annotation will be set on the + // node resource. + MaintenanceAddressCidrBlocks []string `json:"maintenanceAddressCidrBlocks,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "MaintenanceAddressCidrBlocks") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted + // from API requests. However, any non-pointer, non-interface field + // appearing in ForceSendFields will be sent to the server regardless of + // whether the field is empty or not. This may be used to include empty + // fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. + // "MaintenanceAddressCidrBlocks") to include in API requests with the + // JSON null value. By default, fields with empty values are omitted + // from API requests. However, any field with an empty value appearing + // in NullFields will be sent to the server as null. It is an error if a + // field in this list has a non-empty value. This may be used to include + // null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalMaintenanceConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalMaintenanceConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalMaintenanceStatus: Represents the maintenance status of the +// bare metal user cluster. +type BareMetalMaintenanceStatus struct { + // MachineDrainStatus: The maintenance status of node machines. + MachineDrainStatus *BareMetalMachineDrainStatus `json:"machineDrainStatus,omitempty"` + + // ForceSendFields is a list of field names (e.g. "MachineDrainStatus") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "MachineDrainStatus") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalMaintenanceStatus) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalMaintenanceStatus + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalManualLbConfig: Represents configuration parameters for a +// manual load balancer. +type BareMetalManualLbConfig struct { + // Enabled: Whether manual load balancing is enabled. + Enabled bool `json:"enabled,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Enabled") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Enabled") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalManualLbConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalManualLbConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalMetalLbConfig: Represents configuration parameters for a +// MetalLB load balancer. +type BareMetalMetalLbConfig struct { + // AddressPools: Required. AddressPools is a list of non-overlapping IP + // pools used by load balancer typed services. All addresses must be + // routable to load balancer nodes. IngressVIP must be included in the + // pools. + AddressPools []*BareMetalLoadBalancerAddressPool `json:"addressPools,omitempty"` + + // LoadBalancerNodePoolConfig: Specifies the node pool running the load + // balancer. L2 connectivity is required among nodes in this pool. If + // missing, the control plane node pool is used as the load balancer + // pool. + LoadBalancerNodePoolConfig *BareMetalLoadBalancerNodePoolConfig `json:"loadBalancerNodePoolConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AddressPools") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AddressPools") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalMetalLbConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalMetalLbConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalMultipleNetworkInterfacesConfig: Specifies the multiple +// networking interfaces cluster configuration. +type BareMetalMultipleNetworkInterfacesConfig struct { + // Enabled: Whether to enable multiple network interfaces for your pods. + // When set network_config.advanced_networking is automatically set to + // true. + Enabled bool `json:"enabled,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Enabled") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Enabled") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalMultipleNetworkInterfacesConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalMultipleNetworkInterfacesConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalNetworkConfig: Specifies the cluster network configuration. +type BareMetalNetworkConfig struct { + // AdvancedNetworking: Enables the use of advanced Anthos networking + // features, such as Bundled Load Balancing with BGP or the egress NAT + // gateway. Setting configuration for advanced networking features will + // automatically set this flag. + AdvancedNetworking bool `json:"advancedNetworking,omitempty"` + + // IslandModeCidr: Configuration for island mode CIDR. In an island-mode + // network, nodes have unique IP addresses, but pods don't have unique + // addresses across clusters. This doesn't cause problems because pods + // in one cluster never directly communicate with pods in another + // cluster. Instead, there are gateways that mediate between a pod in + // one cluster and a pod in another cluster. + IslandModeCidr *BareMetalIslandModeCidrConfig `json:"islandModeCidr,omitempty"` + + // MultipleNetworkInterfacesConfig: Configuration for multiple network + // interfaces. + MultipleNetworkInterfacesConfig *BareMetalMultipleNetworkInterfacesConfig `json:"multipleNetworkInterfacesConfig,omitempty"` + + // SrIovConfig: Configuration for SR-IOV. + SrIovConfig *BareMetalSrIovConfig `json:"srIovConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AdvancedNetworking") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AdvancedNetworking") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalNetworkConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalNetworkConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalNodeAccessConfig: Specifies the node access related settings +// for the bare metal user cluster. +type BareMetalNodeAccessConfig struct { + // LoginUser: LoginUser is the user name used to access node machines. + // It defaults to "root" if not set. + LoginUser string `json:"loginUser,omitempty"` + + // ForceSendFields is a list of field names (e.g. "LoginUser") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "LoginUser") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalNodeAccessConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalNodeAccessConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalNodeConfig: BareMetalNodeConfig lists machine addresses to +// access Nodes. +type BareMetalNodeConfig struct { + // Labels: The labels assigned to this node. An object containing a list + // of key/value pairs. The labels here, unioned with the labels set on + // BareMetalNodePoolConfig are the set of labels that will be applied to + // the node. If there are any conflicts, the BareMetalNodeConfig labels + // take precedence. Example: { "name": "wrench", "mass": "1.3kg", + // "count": "3" }. + Labels map[string]string `json:"labels,omitempty"` + + // NodeIp: The default IPv4 address for SSH access and Kubernetes node. + // Example: 192.168.0.1 + NodeIp string `json:"nodeIp,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Labels") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalNodeConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalNodeConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalNodePool: Resource that represents a bare metal node pool. +type BareMetalNodePool struct { + // Annotations: Annotations on the bare metal node pool. This field has + // the same restrictions as Kubernetes annotations. The total size of + // all keys and values combined is limited to 256k. Key can have 2 + // segments: prefix (optional) and name (required), separated by a slash + // (/). Prefix must be a DNS subdomain. Name must be 63 characters or + // less, begin and end with alphanumerics, with dashes (-), underscores + // (_), dots (.), and alphanumerics between. + Annotations map[string]string `json:"annotations,omitempty"` + + // CreateTime: Output only. The time at which this bare metal node pool + // was created. + CreateTime string `json:"createTime,omitempty"` + + // DeleteTime: Output only. The time at which this bare metal node pool + // was deleted. If the resource is not deleted, this must be empty + DeleteTime string `json:"deleteTime,omitempty"` + + // DisplayName: The display name for the bare metal node pool. + DisplayName string `json:"displayName,omitempty"` + + // Etag: This checksum is computed by the server based on the value of + // other fields, and may be sent on update and delete requests to ensure + // the client has an up-to-date value before proceeding. Allows clients + // to perform consistent read-modify-writes through optimistic + // concurrency control. + Etag string `json:"etag,omitempty"` + + // Name: Immutable. The bare metal node pool resource name. + Name string `json:"name,omitempty"` + + // NodePoolConfig: Required. Node pool configuration. + NodePoolConfig *BareMetalNodePoolConfig `json:"nodePoolConfig,omitempty"` + + // Reconciling: Output only. If set, there are currently changes in + // flight to the bare metal node pool. + Reconciling bool `json:"reconciling,omitempty"` + + // State: Output only. The current state of the bare metal node pool. + // + // Possible values: + // "STATE_UNSPECIFIED" - Not set. + // "PROVISIONING" - The PROVISIONING state indicates the bare metal + // node pool is being created. + // "RUNNING" - The RUNNING state indicates the bare metal node pool + // has been created and is fully usable. + // "RECONCILING" - The RECONCILING state indicates that the bare metal + // node pool is being updated. It remains available, but potentially + // with degraded performance. + // "STOPPING" - The STOPPING state indicates the bare metal node pool + // is being deleted. + // "ERROR" - The ERROR state indicates the bare metal node pool is in + // a broken unrecoverable state. + // "DEGRADED" - The DEGRADED state indicates the bare metal node pool + // requires user action to restore full functionality. + State string `json:"state,omitempty"` + + // Status: Output only. ResourceStatus representing the detailed node + // pool status. + Status *ResourceStatus `json:"status,omitempty"` + + // Uid: Output only. The unique identifier of the bare metal node pool. + Uid string `json:"uid,omitempty"` + + // UpdateTime: Output only. The time at which this bare metal node pool + // was last updated. + UpdateTime string `json:"updateTime,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Annotations") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Annotations") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalNodePool) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalNodePool + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalNodePoolConfig: BareMetalNodePoolConfig describes the +// configuration of all nodes within a given bare metal node pool. +type BareMetalNodePoolConfig struct { + // KubeletConfig: The modifiable kubelet configurations for the + // baremetal machines. + KubeletConfig *BareMetalKubeletConfig `json:"kubeletConfig,omitempty"` + + // Labels: The labels assigned to nodes of this node pool. An object + // containing a list of key/value pairs. Example: { "name": "wrench", + // "mass": "1.3kg", "count": "3" }. + Labels map[string]string `json:"labels,omitempty"` + + // NodeConfigs: Required. The list of machine addresses in the bare + // metal node pool. + NodeConfigs []*BareMetalNodeConfig `json:"nodeConfigs,omitempty"` + + // OperatingSystem: Specifies the nodes operating system (default: + // LINUX). + // + // Possible values: + // "OPERATING_SYSTEM_UNSPECIFIED" - No operating system runtime + // selected. + // "LINUX" - Linux operating system. + OperatingSystem string `json:"operatingSystem,omitempty"` + + // Taints: The initial taints assigned to nodes of this node pool. + Taints []*NodeTaint `json:"taints,omitempty"` + + // ForceSendFields is a list of field names (e.g. "KubeletConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "KubeletConfig") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalNodePoolConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalNodePoolConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalOsEnvironmentConfig: Specifies operating system settings for +// cluster provisioning. +type BareMetalOsEnvironmentConfig struct { + // PackageRepoExcluded: Whether the package repo should not be included + // when initializing bare metal machines. + PackageRepoExcluded bool `json:"packageRepoExcluded,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PackageRepoExcluded") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "PackageRepoExcluded") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalOsEnvironmentConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalOsEnvironmentConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalPortConfig: Specifies load balancer ports for the bare metal +// user cluster. +type BareMetalPortConfig struct { + // ControlPlaneLoadBalancerPort: The port that control plane hosted load + // balancers will listen on. + ControlPlaneLoadBalancerPort int64 `json:"controlPlaneLoadBalancerPort,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "ControlPlaneLoadBalancerPort") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted + // from API requests. However, any non-pointer, non-interface field + // appearing in ForceSendFields will be sent to the server regardless of + // whether the field is empty or not. This may be used to include empty + // fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. + // "ControlPlaneLoadBalancerPort") to include in API requests with the + // JSON null value. By default, fields with empty values are omitted + // from API requests. However, any field with an empty value appearing + // in NullFields will be sent to the server as null. It is an error if a + // field in this list has a non-empty value. This may be used to include + // null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalPortConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalPortConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalProxyConfig: Specifies the cluster proxy configuration. +type BareMetalProxyConfig struct { + // NoProxy: A list of IPs, hostnames, and domains that should skip the + // proxy. Examples: ["127.0.0.1", "example.com", ".corp", "localhost"]. + NoProxy []string `json:"noProxy,omitempty"` + + // Uri: Required. Specifies the address of your proxy server. Examples: + // `http://domain` Do not provide credentials in the format + // `http://(username:password@)domain` these will be rejected by the + // server. + Uri string `json:"uri,omitempty"` + + // ForceSendFields is a list of field names (e.g. "NoProxy") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NoProxy") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalProxyConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalProxyConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalSecurityConfig: Specifies the security related settings for +// the bare metal user cluster. +type BareMetalSecurityConfig struct { + // Authorization: Configures user access to the user cluster. + Authorization *Authorization `json:"authorization,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Authorization") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Authorization") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalSecurityConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalSecurityConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalSrIovConfig: Specifies the SR-IOV networking operator +// config. +type BareMetalSrIovConfig struct { + // Enabled: Whether to install the SR-IOV operator. + Enabled bool `json:"enabled,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Enabled") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Enabled") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalSrIovConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalSrIovConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalStorageConfig: BareMetalStorageConfig specifies the cluster +// storage configuration. +type BareMetalStorageConfig struct { + // LvpNodeMountsConfig: Required. Specifies the config for local + // PersistentVolumes backed by mounted node disks. These disks need to + // be formatted and mounted by the user, which can be done before or + // after cluster creation. + LvpNodeMountsConfig *BareMetalLvpConfig `json:"lvpNodeMountsConfig,omitempty"` + + // LvpShareConfig: Required. Specifies the config for local + // PersistentVolumes backed by subdirectories in a shared filesystem. + // These subdirectores are automatically created during cluster + // creation. + LvpShareConfig *BareMetalLvpShareConfig `json:"lvpShareConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "LvpNodeMountsConfig") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "LvpNodeMountsConfig") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalStorageConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalStorageConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalVersionInfo: Contains information about a specific Anthos on +// bare metal version. +type BareMetalVersionInfo struct { + // HasDependencies: If set, the cluster dependencies (e.g. the admin + // cluster, other user clusters managed by the same admin cluster, + // version skew policy, etc) must be upgraded before this version can be + // installed or upgraded to. + HasDependencies bool `json:"hasDependencies,omitempty"` + + // Version: Version number e.g. 1.13.1. + Version string `json:"version,omitempty"` + + // ForceSendFields is a list of field names (e.g. "HasDependencies") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "HasDependencies") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalVersionInfo) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalVersionInfo + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalVipConfig: Specifies the VIP config for the bare metal load +// balancer. +type BareMetalVipConfig struct { + // ControlPlaneVip: The VIP which you previously set aside for the + // Kubernetes API of this bare metal user cluster. + ControlPlaneVip string `json:"controlPlaneVip,omitempty"` + + // IngressVip: The VIP which you previously set aside for ingress + // traffic into this bare metal user cluster. + IngressVip string `json:"ingressVip,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ControlPlaneVip") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ControlPlaneVip") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalVipConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalVipConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BareMetalWorkloadNodeConfig: Specifies the workload node +// configurations. +type BareMetalWorkloadNodeConfig struct { + // ContainerRuntime: Specifies which container runtime will be used. + // + // Possible values: + // "CONTAINER_RUNTIME_UNSPECIFIED" - No container runtime selected. + // "CONTAINERD" - Containerd runtime. + ContainerRuntime string `json:"containerRuntime,omitempty"` + + // MaxPodsPerNode: The maximum number of pods a node can run. The size + // of the CIDR range assigned to the node will be derived from this + // parameter. + MaxPodsPerNode int64 `json:"maxPodsPerNode,omitempty,string"` + + // ForceSendFields is a list of field names (e.g. "ContainerRuntime") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ContainerRuntime") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *BareMetalWorkloadNodeConfig) MarshalJSON() ([]byte, error) { + type NoMethod BareMetalWorkloadNodeConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Binding: Associates `members`, or principals, with a `role`. +type Binding struct { + // Condition: The condition that is associated with this binding. If the + // condition evaluates to `true`, then this binding applies to the + // current request. If the condition evaluates to `false`, then this + // binding does not apply to the current request. However, a different + // role binding might grant the same role to one or more of the + // principals in this binding. To learn which resources support + // conditions in their IAM policies, see the IAM documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). + Condition *Expr `json:"condition,omitempty"` + + // Members: Specifies the principals requesting access for a Google + // Cloud resource. `members` can have the following values: * + // `allUsers`: A special identifier that represents anyone who is on the + // internet; with or without a Google account. * + // `allAuthenticatedUsers`: A special identifier that represents anyone + // who is authenticated with a Google account or a service account. Does + // not include identities that come from external identity providers + // (IdPs) through identity federation. * `user:{emailid}`: An email + // address that represents a specific Google account. For example, + // `alice@example.com` . * `serviceAccount:{emailid}`: An email address + // that represents a Google service account. For example, + // `my-other-app@appspot.gserviceaccount.com`. * + // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: + // An identifier for a Kubernetes service account + // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). + // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. + // * `group:{emailid}`: An email address that represents a Google group. + // For example, `admins@example.com`. * `domain:{domain}`: The G Suite + // domain (primary) that represents all the users of that domain. For + // example, `google.com` or `example.com`. * + // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus + // unique identifier) representing a user that has been recently + // deleted. For example, `alice@example.com?uid=123456789012345678901`. + // If the user is recovered, this value reverts to `user:{emailid}` and + // the recovered user retains the role in the binding. * + // `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address + // (plus unique identifier) representing a service account that has been + // recently deleted. For example, + // `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. + // If the service account is undeleted, this value reverts to + // `serviceAccount:{emailid}` and the undeleted service account retains + // the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: + // An email address (plus unique identifier) representing a Google group + // that has been recently deleted. For example, + // `admins@example.com?uid=123456789012345678901`. If the group is + // recovered, this value reverts to `group:{emailid}` and the recovered + // group retains the role in the binding. + Members []string `json:"members,omitempty"` + + // Role: Role that is assigned to the list of `members`, or principals. + // For example, `roles/viewer`, `roles/editor`, or `roles/owner`. + Role string `json:"role,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Condition") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Condition") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Binding) MarshalJSON() ([]byte, error) { + type NoMethod Binding + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// CancelOperationRequest: The request message for +// Operations.CancelOperation. +type CancelOperationRequest struct { +} + +// ClusterUser: ClusterUser configures user principals for an RBAC +// policy. +type ClusterUser struct { + // Username: Required. The name of the user, e.g. `my-gcp-id@gmail.com`. + Username string `json:"username,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Username") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Username") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ClusterUser) MarshalJSON() ([]byte, error) { + type NoMethod ClusterUser + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, 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:"-"` +} + +// EnrollBareMetalAdminClusterRequest: Message for enrolling an existing +// bare metal admin cluster to the GKE on-prem API. +type EnrollBareMetalAdminClusterRequest struct { + // BareMetalAdminClusterId: User provided OnePlatform identifier that is + // used as part of the resource name. This must be unique among all GKE + // on-prem clusters within a project and location and will return a 409 + // if the cluster already exists. This value must be up to 40 characters + // and follow RFC-1123 (https://tools.ietf.org/html/rfc1123) format. + BareMetalAdminClusterId string `json:"bareMetalAdminClusterId,omitempty"` + + // LocalName: The object name of the bare metal OnPremAdminCluster + // custom resource on the associated admin cluster. This field is used + // to support conflicting resource names when enrolling existing + // clusters to the API. When not provided, this field will resolve to + // the bare_metal_admin_cluster_id. Otherwise, it must match the object + // name of the bare metal OnPremAdminCluster custom resource. It is not + // modifiable outside / beyond the enrollment operation. + LocalName string `json:"localName,omitempty"` + + // Membership: Required. This is the full resource name of this admin + // cluster's fleet membership. + Membership string `json:"membership,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "BareMetalAdminClusterId") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted + // from API requests. However, any non-pointer, non-interface field + // appearing in ForceSendFields will be sent to the server regardless of + // whether the field is empty or not. This may be used to include empty + // fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BareMetalAdminClusterId") + // to include in API requests with the JSON null value. By default, + // fields with empty values are omitted from API requests. However, any + // field with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *EnrollBareMetalAdminClusterRequest) MarshalJSON() ([]byte, error) { + type NoMethod EnrollBareMetalAdminClusterRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// EnrollBareMetalClusterRequest: Message for enrolling an existing bare +// metal cluster to the Anthos On-Prem API. +type EnrollBareMetalClusterRequest struct { + // AdminClusterMembership: Required. The admin cluster this bare metal + // user cluster belongs to. This is the full resource name of the admin + // cluster's fleet membership. In the future, references to other + // resource types might be allowed if admin clusters are modeled as + // their own resources. + AdminClusterMembership string `json:"adminClusterMembership,omitempty"` + + // BareMetalClusterId: User provided OnePlatform identifier that is used + // as part of the resource name. This must be unique among all bare + // metal clusters within a project and location and will return a 409 if + // the cluster already exists. This value must be up to 40 characters + // and follow RFC-1123 (https://tools.ietf.org/html/rfc1123) format. + BareMetalClusterId string `json:"bareMetalClusterId,omitempty"` + + // LocalName: The object name of the bare metal cluster custom resource + // on the associated admin cluster. This field is used to support + // conflicting resource names when enrolling existing clusters to the + // API. When not provided, this field will resolve to the + // bare_metal_cluster_id. Otherwise, it must match the object name of + // the bare metal cluster custom resource. It is not modifiable outside + // / beyond the enrollment operation. + LocalName string `json:"localName,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "AdminClusterMembership") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AdminClusterMembership") + // to include in API requests with the JSON null value. By default, + // fields with empty values are omitted from API requests. However, any + // field with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *EnrollBareMetalClusterRequest) MarshalJSON() ([]byte, error) { + type NoMethod EnrollBareMetalClusterRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// EnrollBareMetalNodePoolRequest: Message for enrolling an existing +// bare metal node pool to the GKE on-prem API. +type EnrollBareMetalNodePoolRequest struct { + // BareMetalNodePoolId: User provided OnePlatform identifier that is + // used as part of the resource name. This value must be up to 40 + // characters and follow RFC-1123 (https://tools.ietf.org/html/rfc1123) + // format. + BareMetalNodePoolId string `json:"bareMetalNodePoolId,omitempty"` + + // ValidateOnly: If set, only validate the request, but do not actually + // enroll the node pool. + ValidateOnly bool `json:"validateOnly,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BareMetalNodePoolId") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BareMetalNodePoolId") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *EnrollBareMetalNodePoolRequest) MarshalJSON() ([]byte, error) { + type NoMethod EnrollBareMetalNodePoolRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// EnrollVmwareAdminClusterRequest: Message for enrolling an existing +// VMware admin cluster to the GKE on-prem API. +type EnrollVmwareAdminClusterRequest struct { + // LocalName: The object name of the VMware OnPremAdminCluster custom + // resource on the associated admin cluster. This field is used to + // support conflicting resource names when enrolling existing clusters + // to the API. When not provided, this field will resolve to the + // vmware_admin_cluster_id. Otherwise, it must match the object name of + // the VMware OnPremAdminCluster custom resource. It is not modifiable + // outside / beyond the enrollment operation. + LocalName string `json:"localName,omitempty"` + + // Membership: Required. This is the full resource name of this admin + // cluster's fleet membership. + Membership string `json:"membership,omitempty"` + + // VmwareAdminClusterId: User provided OnePlatform identifier that is + // used as part of the resource name. This must be unique among all GKE + // on-prem clusters within a project and location and will return a 409 + // if the cluster already exists. This value must be up to 40 characters + // and follow RFC-1123 (https://tools.ietf.org/html/rfc1123) format. + VmwareAdminClusterId string `json:"vmwareAdminClusterId,omitempty"` + + // ForceSendFields is a list of field names (e.g. "LocalName") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "LocalName") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *EnrollVmwareAdminClusterRequest) MarshalJSON() ([]byte, error) { + type NoMethod EnrollVmwareAdminClusterRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// EnrollVmwareClusterRequest: Message for enrolling an existing VMware +// cluster to the Anthos On-Prem API. +type EnrollVmwareClusterRequest struct { + // AdminClusterMembership: Required. The admin cluster this VMware user + // cluster belongs to. This is the full resource name of the admin + // cluster's fleet membership. In the future, references to other + // resource types might be allowed if admin clusters are modeled as + // their own resources. + AdminClusterMembership string `json:"adminClusterMembership,omitempty"` + + // LocalName: The object name of the VMware OnPremUserCluster custom + // resource on the associated admin cluster. This field is used to + // support conflicting resource names when enrolling existing clusters + // to the API. When not provided, this field will resolve to the + // vmware_cluster_id. Otherwise, it must match the object name of the + // VMware OnPremUserCluster custom resource. It is not modifiable + // outside / beyond the enrollment operation. + LocalName string `json:"localName,omitempty"` + + // ValidateOnly: Validate the request without actually doing any + // updates. + ValidateOnly bool `json:"validateOnly,omitempty"` + + // VmwareClusterId: User provided OnePlatform identifier that is used as + // part of the resource name. This must be unique among all GKE on-prem + // clusters within a project and location and will return a 409 if the + // cluster already exists. This value must be up to 40 characters and + // follow RFC-1123 (https://tools.ietf.org/html/rfc1123) format. + VmwareClusterId string `json:"vmwareClusterId,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "AdminClusterMembership") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AdminClusterMembership") + // to include in API requests with the JSON null value. By default, + // fields with empty values are omitted from API requests. However, any + // field with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *EnrollVmwareClusterRequest) MarshalJSON() ([]byte, error) { + type NoMethod EnrollVmwareClusterRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// EnrollVmwareNodePoolRequest: Message for enrolling a VMware node +// pool. +type EnrollVmwareNodePoolRequest struct { + // VmwareNodePoolId: The target node pool id to be enrolled. + VmwareNodePoolId string `json:"vmwareNodePoolId,omitempty"` + + // ForceSendFields is a list of field names (e.g. "VmwareNodePoolId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "VmwareNodePoolId") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *EnrollVmwareNodePoolRequest) MarshalJSON() ([]byte, error) { + type NoMethod EnrollVmwareNodePoolRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, 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 (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 Expr 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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Description") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Expr) MarshalJSON() ([]byte, error) { + type NoMethod Expr + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Fleet: Fleet related configuration. Fleets are a Google Cloud concept +// for logically organizing clusters, letting you use and manage +// multi-cluster capabilities and apply consistent policies across your +// systems. See Anthos Fleets +// (`https://cloud.google.com/anthos/multicluster-management/fleets`) +// for more details on Anthos multi-cluster capabilities using Fleets. +// ## +type Fleet struct { + // Membership: Output only. The name of the managed fleet Membership + // resource associated to this cluster. Membership names are formatted + // as `projects//locations//memberships/`. + Membership string `json:"membership,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Membership") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Fleet) MarshalJSON() ([]byte, error) { + type NoMethod Fleet + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListBareMetalAdminClustersResponse: Response message for listing bare +// metal admin clusters. +type ListBareMetalAdminClustersResponse struct { + // BareMetalAdminClusters: The list of bare metal admin cluster. + BareMetalAdminClusters []*BareMetalAdminCluster `json:"bareMetalAdminClusters,omitempty"` + + // NextPageToken: A token identifying a page of results the server + // should return. If the token is not empty this means that more results + // are available and should be retrieved by repeating the request with + // the provided page token. + NextPageToken string `json:"nextPageToken,omitempty"` + + // Unreachable: Locations that could not be reached. + 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. + // "BareMetalAdminClusters") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BareMetalAdminClusters") + // to include in API requests with the JSON null value. By default, + // fields with empty values are omitted from API requests. However, any + // field with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *ListBareMetalAdminClustersResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListBareMetalAdminClustersResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListBareMetalClustersResponse: Response message for listing bare +// metal Clusters. +type ListBareMetalClustersResponse struct { + // BareMetalClusters: The list of bare metal Clusters. + BareMetalClusters []*BareMetalCluster `json:"bareMetalClusters,omitempty"` + + // NextPageToken: A token identifying a page of results the server + // should return. If the token is not empty this means that more results + // are available and should be retrieved by repeating the request with + // the provided page token. + NextPageToken string `json:"nextPageToken,omitempty"` + + // Unreachable: Locations that could not be reached. + 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. "BareMetalClusters") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BareMetalClusters") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *ListBareMetalClustersResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListBareMetalClustersResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListBareMetalNodePoolsResponse: Response message for listing bare +// metal node pools. +type ListBareMetalNodePoolsResponse struct { + // BareMetalNodePools: The node pools from the specified parent + // resource. + BareMetalNodePools []*BareMetalNodePool `json:"bareMetalNodePools,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"` + + // Unreachable: Locations that could not be reached. + 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. "BareMetalNodePools") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BareMetalNodePools") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *ListBareMetalNodePoolsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListBareMetalNodePoolsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListLocationsResponse: The response message for +// Locations.ListLocations. +type ListLocationsResponse struct { + // Locations: A list of locations that matches the specified filter in + // the request. + Locations []*Location `json:"locations,omitempty"` + + // NextPageToken: The standard List next-page token. + 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. "Locations") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Locations") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListLocationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListLocationsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, 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"` + + // 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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NextPageToken") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListOperationsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListVmwareAdminClustersResponse: Response message for listing VMware +// admin clusters. +type ListVmwareAdminClustersResponse struct { + // NextPageToken: A token identifying a page of results the server + // should return. If the token is not empty this means that more results + // are available and should be retrieved by repeating the request with + // the provided page token. + NextPageToken string `json:"nextPageToken,omitempty"` + + // Unreachable: Locations that could not be reached. + Unreachable []string `json:"unreachable,omitempty"` + + // VmwareAdminClusters: The list of VMware admin cluster. + VmwareAdminClusters []*VmwareAdminCluster `json:"vmwareAdminClusters,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NextPageToken") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListVmwareAdminClustersResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListVmwareAdminClustersResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListVmwareClustersResponse: Response message for listing VMware +// Clusters. +type ListVmwareClustersResponse struct { + // NextPageToken: A token identifying a page of results the server + // should return. If the token is not empty this means that more results + // are available and should be retrieved by repeating the request with + // the provided page token. + NextPageToken string `json:"nextPageToken,omitempty"` + + // Unreachable: Locations that could not be reached. + Unreachable []string `json:"unreachable,omitempty"` + + // VmwareClusters: The list of VMware Cluster. + VmwareClusters []*VmwareCluster `json:"vmwareClusters,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NextPageToken") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListVmwareClustersResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListVmwareClustersResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListVmwareNodePoolsResponse: Response message for listing VMware node +// pools. +type ListVmwareNodePoolsResponse 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"` + + // Unreachable: Locations that could not be reached. + Unreachable []string `json:"unreachable,omitempty"` + + // VmwareNodePools: The node pools from the specified parent resource. + VmwareNodePools []*VmwareNodePool `json:"vmwareNodePools,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NextPageToken") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListVmwareNodePoolsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListVmwareNodePoolsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Location: A resource that represents a Google Cloud location. +type Location struct { + // DisplayName: The friendly name for this location, typically a nearby + // city name. For example, "Tokyo". + DisplayName string `json:"displayName,omitempty"` + + // Labels: Cross-service attributes for the location. For example + // {"cloud.googleapis.com/region": "us-east1"} + Labels map[string]string `json:"labels,omitempty"` + + // LocationId: The canonical id for this location. For example: + // "us-east1". + LocationId string `json:"locationId,omitempty"` + + // Metadata: Service-specific metadata. For example the available + // capacity at the given location. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + + // Name: Resource name for the location, which may vary between + // implementations. For example: + // "projects/example-project/locations/us-east1" + Name string `json:"name,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "DisplayName") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DisplayName") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Location) MarshalJSON() ([]byte, error) { + type NoMethod Location + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// NodeTaint: NodeTaint applied to every Kubernetes node in a node pool. +// Kubernetes taints can be used together with tolerations to control +// how workloads are scheduled to your nodes. Node taints are permanent. +type NodeTaint struct { + // Effect: The taint effect. + // + // Possible values: + // "EFFECT_UNSPECIFIED" - Not set. + // "NO_SCHEDULE" - Do not allow new pods to schedule onto the node + // unless they tolerate the taint, but allow all pods submitted to + // Kubelet without going through the scheduler to start, and allow all + // already-running pods to continue running. Enforced by the scheduler. + // "PREFER_NO_SCHEDULE" - Like TaintEffectNoSchedule, but the + // scheduler tries not to schedule new pods onto the node, rather than + // prohibiting new pods from scheduling onto the node entirely. Enforced + // by the scheduler. + // "NO_EXECUTE" - Evict any already-running pods that do not tolerate + // the taint. Currently enforced by NodeController. + Effect string `json:"effect,omitempty"` + + // Key: Key associated with the effect. + Key string `json:"key,omitempty"` + + // Value: Value associated with the effect. + Value string `json:"value,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Effect") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Effect") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *NodeTaint) MarshalJSON() ([]byte, error) { + type NoMethod NodeTaint + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Operation: This resource represents a long-running operation that is +// the result of a network API call. +type Operation struct { + // Done: If the value is `false`, it means the operation is still in + // progress. If `true`, the operation is completed, and either `error` + // or `response` is available. + Done bool `json:"done,omitempty"` + + // Error: The error result of the operation in case of failure or + // cancellation. + Error *Status `json:"error,omitempty"` + + // Metadata: Service-specific metadata associated with the operation. It + // typically contains progress information and common metadata such as + // create time. Some services might not provide such metadata. Any + // method that returns a long-running operation should document the + // metadata type, if any. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + + // Name: The server-assigned name, which is only unique within the same + // service that originally returns it. If you use the default HTTP + // mapping, the `name` should be a resource name ending with + // `operations/{unique_id}`. + Name string `json:"name,omitempty"` + + // Response: The normal response of the operation in case of success. If + // the original method returns no data on success, such as `Delete`, the + // response is `google.protobuf.Empty`. If the original method is + // standard `Get`/`Create`/`Update`, the response should be the + // resource. For other methods, the response should have the type + // `XxxResponse`, where `Xxx` is the original method name. For example, + // if the original method name is `TakeSnapshot()`, the inferred + // response type is `TakeSnapshotResponse`. + 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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Done") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Operation) MarshalJSON() ([]byte, error) { + type NoMethod Operation + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// OperationMetadata: Represents the metadata of the long-running +// operation. +type OperationMetadata struct { + // ApiVersion: Output only. API version used to start the operation. + ApiVersion string `json:"apiVersion,omitempty"` + + // CreateTime: Output only. The time the operation was created. + CreateTime string `json:"createTime,omitempty"` + + // EndTime: Output only. The time the operation finished running. + EndTime string `json:"endTime,omitempty"` + + // RequestedCancellation: Output only. Identifies whether the user has + // requested cancellation of the operation. Operations that have + // successfully been cancelled have [Operation.error] value with a + // [google.rpc.Status.code] of 1, corresponding to `Code.CANCELLED`. + RequestedCancellation bool `json:"requestedCancellation,omitempty"` + + // StatusMessage: Output only. Human-readable status of the operation, + // if any. + StatusMessage string `json:"statusMessage,omitempty"` + + // Target: Output only. Server-defined resource path for the target of + // the operation. + Target string `json:"target,omitempty"` + + // Type: Output only. Type of operation being executed. + // + // Possible values: + // "OPERATION_TYPE_UNSPECIFIED" - Not set. + // "CREATE" - The resource is being created. + // "DELETE" - The resource is being deleted. + // "UPDATE" - The resource is being updated. + // "UPGRADE" - The resource is being upgraded. + Type string `json:"type,omitempty"` + + // Verb: Output only. Name of the verb executed by the operation. + Verb string `json:"verb,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ApiVersion") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ApiVersion") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *OperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod OperationMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Policy: An Identity and Access Management (IAM) policy, which +// specifies access controls for Google Cloud resources. A `Policy` is a +// collection of `bindings`. A `binding` binds one or more `members`, or +// principals, to a single `role`. Principals can be user accounts, +// service accounts, Google groups, and domains (such as G Suite). A +// `role` is a named list of permissions; each `role` can be an IAM +// predefined role or a user-created custom role. For some types of +// Google Cloud resources, a `binding` can also specify a `condition`, +// which is a logical expression that allows access to a resource only +// if the expression evaluates to `true`. A condition can add +// constraints based on attributes of the request, the resource, or +// both. To learn which resources support conditions in their IAM +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": +// "roles/resourcemanager.organizationAdmin", "members": [ +// "user:mike@example.com", "group:admins@example.com", +// "domain:google.com", +// "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { +// "role": "roles/resourcemanager.organizationViewer", "members": [ +// "user:eve@example.com" ], "condition": { "title": "expirable access", +// "description": "Does not grant access after Sep 2020", "expression": +// "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], +// "etag": "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - +// members: - user:mike@example.com - group:admins@example.com - +// domain:google.com - +// serviceAccount:my-project-id@appspot.gserviceaccount.com role: +// roles/resourcemanager.organizationAdmin - members: - +// user:eve@example.com role: roles/resourcemanager.organizationViewer +// condition: title: expirable access description: Does not grant access +// after Sep 2020 expression: request.time < +// timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 +// For a description of IAM and its features, see the IAM documentation +// (https://cloud.google.com/iam/docs/). +type Policy struct { + // Bindings: Associates a list of `members`, or principals, with a + // `role`. Optionally, may specify a `condition` that determines how and + // when the `bindings` are applied. Each of the `bindings` must contain + // at least one principal. The `bindings` in a `Policy` can refer to up + // to 1,500 principals; up to 250 of these principals can be Google + // groups. Each occurrence of a principal counts towards these limits. + // For example, if the `bindings` grant 50 different roles to + // `user:alice@example.com`, and not to any other principal, then you + // can add another 1,450 principals to the `bindings` in the `Policy`. + Bindings []*Binding `json:"bindings,omitempty"` + + // Etag: `etag` is used for optimistic concurrency control as a way to + // help prevent simultaneous updates of a policy from overwriting each + // other. It is strongly suggested that systems make use of the `etag` + // in the read-modify-write cycle to perform policy updates in order to + // avoid race conditions: An `etag` is returned in the response to + // `getIamPolicy`, and systems are expected to put that etag in the + // request to `setIamPolicy` to ensure that their change will be applied + // to the same version of the policy. **Important:** If you use IAM + // Conditions, you must include the `etag` field whenever you call + // `setIamPolicy`. If you omit this field, then IAM allows you to + // overwrite a version `3` policy with a version `1` policy, and all of + // the conditions in the version `3` policy are lost. + Etag string `json:"etag,omitempty"` + + // Version: Specifies the format of the policy. Valid values are `0`, + // `1`, and `3`. Requests that specify an invalid value are rejected. + // Any operation that affects conditional role bindings must specify + // version `3`. This requirement applies to the following operations: * + // Getting a policy that includes a conditional role binding * Adding a + // conditional role binding to a policy * Changing a conditional role + // binding in a policy * Removing any role binding, with or without a + // condition, from a policy that includes conditions **Important:** If + // you use IAM Conditions, you must include the `etag` field whenever + // you call `setIamPolicy`. If you omit this field, then IAM allows you + // to overwrite a version `3` policy with a version `1` policy, and all + // of the conditions in the version `3` policy are lost. If a policy + // does not include any conditions, operations on that policy may + // specify any valid version or leave the field unset. To learn which + // resources support conditions in their IAM policies, see the IAM + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). + Version int64 `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. "Bindings") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Bindings") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Policy) MarshalJSON() ([]byte, error) { + type NoMethod Policy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// QueryBareMetalAdminVersionConfigResponse: Response message for +// querying bare metal admin cluster version config. +type QueryBareMetalAdminVersionConfigResponse struct { + // Versions: List of available versions to install or to upgrade to. + Versions []*BareMetalVersionInfo `json:"versions,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Versions") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Versions") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *QueryBareMetalAdminVersionConfigResponse) MarshalJSON() ([]byte, error) { + type NoMethod QueryBareMetalAdminVersionConfigResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// QueryBareMetalVersionConfigResponse: Response message for querying +// bare metal admin cluster version config. +type QueryBareMetalVersionConfigResponse struct { + // Versions: List of available versions to install or to upgrade to. + Versions []*BareMetalVersionInfo `json:"versions,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Versions") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Versions") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *QueryBareMetalVersionConfigResponse) MarshalJSON() ([]byte, error) { + type NoMethod QueryBareMetalVersionConfigResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// QueryVmwareVersionConfigResponse: Response message for querying +// VMware user cluster version config. +type QueryVmwareVersionConfigResponse struct { + // Versions: List of available versions to install or to upgrade to. + Versions []*VmwareVersionInfo `json:"versions,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Versions") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Versions") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *QueryVmwareVersionConfigResponse) MarshalJSON() ([]byte, error) { + type NoMethod QueryVmwareVersionConfigResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ResourceCondition: ResourceCondition provides a standard mechanism +// for higher-level status reporting from controller. +type ResourceCondition struct { + // LastTransitionTime: Last time the condition transit from one status + // to another. + LastTransitionTime string `json:"lastTransitionTime,omitempty"` + + // Message: Human-readable message indicating details about last + // transition. + Message string `json:"message,omitempty"` + + // Reason: Machine-readable message indicating details about last + // transition. + Reason string `json:"reason,omitempty"` + + // State: state of the condition. + // + // Possible values: + // "STATE_UNSPECIFIED" - Not set. + // "STATE_TRUE" - Resource is in the condition. + // "STATE_FALSE" - Resource is not in the condition. + // "STATE_UNKNOWN" - Kubernetes controller can't decide if the + // resource is in the condition or not. + State string `json:"state,omitempty"` + + // Type: Type of the condition. (e.g., ClusterRunning, NodePoolRunning + // or ServerSidePreflightReady) + 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 default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "LastTransitionTime") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *ResourceCondition) MarshalJSON() ([]byte, error) { + type NoMethod ResourceCondition + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ResourceStatus: ResourceStatus describes why a cluster or node pool +// has a certain status. (e.g., ERROR or DEGRADED). +type ResourceStatus struct { + // Conditions: ResourceCondition provide a standard mechanism for + // higher-level status reporting from controller. + Conditions []*ResourceCondition `json:"conditions,omitempty"` + + // ErrorMessage: Human-friendly representation of the error message from + // controller. The error message can be temporary as the controller + // controller creates a cluster or node pool. If the error message + // persists for a longer period of time, it can be used to surface error + // message to indicate real problems requiring user intervention. + ErrorMessage string `json:"errorMessage,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Conditions") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Conditions") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ResourceStatus) MarshalJSON() ([]byte, error) { + type NoMethod ResourceStatus + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// SetIamPolicyRequest: Request message for `SetIamPolicy` method. +type SetIamPolicyRequest struct { + // Policy: REQUIRED: The complete policy to be applied to the + // `resource`. The size of the policy is limited to a few 10s of KB. An + // empty policy is a valid policy but certain Google Cloud services + // (such as Projects) might reject them. + Policy *Policy `json:"policy,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Policy") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Policy") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { + type NoMethod SetIamPolicyRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, 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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Code") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Status) MarshalJSON() ([]byte, error) { + type NoMethod Status + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// TestIamPermissionsRequest: Request message for `TestIamPermissions` +// method. +type TestIamPermissionsRequest struct { + // Permissions: The set of permissions to check for the `resource`. + // Permissions with wildcards (such as `*` or `storage.*`) are not + // allowed. For more information see IAM Overview + // (https://cloud.google.com/iam/docs/overview#permissions). + Permissions []string `json:"permissions,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Permissions") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Permissions") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *TestIamPermissionsRequest) MarshalJSON() ([]byte, error) { + type NoMethod TestIamPermissionsRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// TestIamPermissionsResponse: Response message for `TestIamPermissions` +// method. +type TestIamPermissionsResponse struct { + // Permissions: A subset of `TestPermissionsRequest.permissions` that + // the caller is allowed. + Permissions []string `json:"permissions,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Permissions") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Permissions") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *TestIamPermissionsResponse) MarshalJSON() ([]byte, error) { + type NoMethod TestIamPermissionsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ValidationCheck: ValidationCheck represents the result of preflight +// check. +type ValidationCheck struct { + // Option: Options used for the validation check + // + // Possible values: + // "OPTIONS_UNSPECIFIED" - Default value. Standard preflight + // validation check will be used. + // "SKIP_VALIDATION_CHECK_BLOCKING" - Prevent failed preflight checks + // from failing. + // "SKIP_VALIDATION_ALL" - Skip all preflight check validations. + Option string `json:"option,omitempty"` + + // Scenario: Output only. The scenario when the preflight checks were + // run. + // + // Possible values: + // "SCENARIO_UNSPECIFIED" - Default value. This value is unused. + // "CREATE" - The validation check occurred during a create flow. + // "UPDATE" - The validation check occurred during an update flow. + Scenario string `json:"scenario,omitempty"` + + // Status: Output only. The detailed validation check status. + Status *ValidationCheckStatus `json:"status,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Option") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Option") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ValidationCheck) MarshalJSON() ([]byte, error) { + type NoMethod ValidationCheck + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ValidationCheckResult: ValidationCheckResult defines the details +// about the validation check. +type ValidationCheckResult struct { + // Category: The category of the validation. + Category string `json:"category,omitempty"` + + // Description: The description of the validation check. + Description string `json:"description,omitempty"` + + // Details: Detailed failure information, which might be unformatted. + Details string `json:"details,omitempty"` + + // Reason: A human-readable message of the check failure. + Reason string `json:"reason,omitempty"` + + // State: The validation check state. + // + // Possible values: + // "STATE_UNKNOWN" - The default value. The check result is unknown. + // "STATE_FAILURE" - The check failed. + // "STATE_SKIPPED" - The check was skipped. + // "STATE_FATAL" - The check itself failed to complete. + // "STATE_WARNING" - The check encountered a warning. + State string `json:"state,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Category") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Category") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ValidationCheckResult) MarshalJSON() ([]byte, error) { + type NoMethod ValidationCheckResult + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ValidationCheckStatus: ValidationCheckStatus defines the detailed +// validation check status. +type ValidationCheckStatus struct { + // Result: Individual checks which failed as part of the Preflight check + // execution. + Result []*ValidationCheckResult `json:"result,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Result") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Result") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ValidationCheckStatus) MarshalJSON() ([]byte, error) { + type NoMethod ValidationCheckStatus + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareAAGConfig: Specifies anti affinity group config for the VMware +// user cluster. +type VmwareAAGConfig struct { + // AagConfigDisabled: Spread nodes across at least three physical hosts + // (requires at least three hosts). Enabled by default. + AagConfigDisabled bool `json:"aagConfigDisabled,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AagConfigDisabled") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AagConfigDisabled") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *VmwareAAGConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareAAGConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareAddressPool: Represents an IP pool used by the load balancer. +type VmwareAddressPool struct { + // Addresses: Required. The addresses that are part of this pool. Each + // address must be either in the CIDR form (1.2.3.0/24) or range form + // (1.2.3.1-1.2.3.5). + Addresses []string `json:"addresses,omitempty"` + + // AvoidBuggyIps: If true, avoid using IPs ending in .0 or .255. This + // avoids buggy consumer devices mistakenly dropping IPv4 traffic for + // those special IP addresses. + AvoidBuggyIps bool `json:"avoidBuggyIps,omitempty"` + + // ManualAssign: If true, prevent IP addresses from being automatically + // assigned. + ManualAssign bool `json:"manualAssign,omitempty"` + + // Pool: Required. The name of the address pool. + Pool string `json:"pool,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Addresses") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Addresses") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareAddressPool) MarshalJSON() ([]byte, error) { + type NoMethod VmwareAddressPool + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareAdminAddonNodeConfig: VmwareAdminAddonNodeConfig contains +// add-on node configurations for VMware admin cluster. +type VmwareAdminAddonNodeConfig struct { + // AutoResizeConfig: VmwareAutoResizeConfig config specifies auto resize + // config. + AutoResizeConfig *VmwareAutoResizeConfig `json:"autoResizeConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AutoResizeConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AutoResizeConfig") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *VmwareAdminAddonNodeConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareAdminAddonNodeConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareAdminCluster: Resource that represents a VMware admin cluster. +type VmwareAdminCluster struct { + // AddonNode: The VMware admin cluster addon node configuration. + AddonNode *VmwareAdminAddonNodeConfig `json:"addonNode,omitempty"` + + // Annotations: Annotations on the VMware admin cluster. This field has + // the same restrictions as Kubernetes annotations. The total size of + // all keys and values combined is limited to 256k. Key can have 2 + // segments: prefix (optional) and name (required), separated by a slash + // (/). Prefix must be a DNS subdomain. Name must be 63 characters or + // less, begin and end with alphanumerics, with dashes (-), underscores + // (_), dots (.), and alphanumerics between. + Annotations map[string]string `json:"annotations,omitempty"` + + // AntiAffinityGroups: The VMware admin cluster anti affinity group + // configuration. + AntiAffinityGroups *VmwareAAGConfig `json:"antiAffinityGroups,omitempty"` + + // AutoRepairConfig: The VMware admin cluster auto repair configuration. + AutoRepairConfig *VmwareAutoRepairConfig `json:"autoRepairConfig,omitempty"` + + // BootstrapClusterMembership: The bootstrap cluster this VMware admin + // cluster belongs to. + BootstrapClusterMembership string `json:"bootstrapClusterMembership,omitempty"` + + // ControlPlaneNode: The VMware admin cluster control plane node + // configuration. + ControlPlaneNode *VmwareAdminControlPlaneNodeConfig `json:"controlPlaneNode,omitempty"` + + // CreateTime: Output only. The time at which VMware admin cluster was + // created. + CreateTime string `json:"createTime,omitempty"` + + // Description: A human readable description of this VMware admin + // cluster. + Description string `json:"description,omitempty"` + + // Endpoint: Output only. The DNS name of VMware admin cluster's API + // server. + Endpoint string `json:"endpoint,omitempty"` + + // Etag: This checksum is computed by the server based on the value of + // other fields, and may be sent on update and delete requests to ensure + // the client has an up-to-date value before proceeding. Allows clients + // to perform consistent read-modify-writes through optimistic + // concurrency control. + Etag string `json:"etag,omitempty"` + + // Fleet: Output only. Fleet configuration for the cluster. + Fleet *Fleet `json:"fleet,omitempty"` + + // ImageType: The OS image type for the VMware admin cluster. + ImageType string `json:"imageType,omitempty"` + + // LoadBalancer: The VMware admin cluster load balancer configuration. + LoadBalancer *VmwareAdminLoadBalancerConfig `json:"loadBalancer,omitempty"` + + // LocalName: Output only. The object name of the VMware + // OnPremAdminCluster custom resource. This field is used to support + // conflicting names when enrolling existing clusters to the API. When + // used as a part of cluster enrollment, this field will differ from the + // ID in the resource name. For new clusters, this field will match the + // user provided cluster name and be visible in the last component of + // the resource name. It is not modifiable. All users should use this + // name to access their cluster using gkectl or kubectl and should + // expect to see the local name when viewing admin cluster controller + // logs. + LocalName string `json:"localName,omitempty"` + + // Name: Immutable. The VMware admin cluster resource name. + Name string `json:"name,omitempty"` + + // NetworkConfig: The VMware admin cluster network configuration. + NetworkConfig *VmwareAdminNetworkConfig `json:"networkConfig,omitempty"` + + // OnPremVersion: The Anthos clusters on the VMware version for the + // admin cluster. + OnPremVersion string `json:"onPremVersion,omitempty"` + + // PlatformConfig: The VMware platform configuration. + PlatformConfig *VmwarePlatformConfig `json:"platformConfig,omitempty"` + + // Reconciling: Output only. If set, there are currently changes in + // flight to the VMware admin cluster. + Reconciling bool `json:"reconciling,omitempty"` + + // State: Output only. The current state of VMware admin cluster. + // + // Possible values: + // "STATE_UNSPECIFIED" - Not set. + // "PROVISIONING" - The PROVISIONING state indicates the cluster is + // being created. + // "RUNNING" - The RUNNING state indicates the cluster has been + // created and is fully usable. + // "RECONCILING" - The RECONCILING state indicates that the cluster is + // being updated. It remains available, but potentially with degraded + // performance. + // "STOPPING" - The STOPPING state indicates the cluster is being + // deleted. + // "ERROR" - The ERROR state indicates the cluster is in a broken + // unrecoverable state. + // "DEGRADED" - The DEGRADED state indicates the cluster requires user + // action to restore full functionality. + State string `json:"state,omitempty"` + + // Status: Output only. ResourceStatus representing detailed cluster + // state. + Status *ResourceStatus `json:"status,omitempty"` + + // Uid: Output only. The unique identifier of the VMware admin cluster. + Uid string `json:"uid,omitempty"` + + // UpdateTime: Output only. The time at which VMware admin cluster was + // last updated. + UpdateTime string `json:"updateTime,omitempty"` + + // Vcenter: The VMware admin cluster VCenter configuration. + Vcenter *VmwareAdminVCenterConfig `json:"vcenter,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "AddonNode") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AddonNode") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareAdminCluster) MarshalJSON() ([]byte, error) { + type NoMethod VmwareAdminCluster + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareAdminControlPlaneNodeConfig: VmwareAdminControlPlaneNodeConfig +// contains control plane node configuration for VMware admin cluster. +type VmwareAdminControlPlaneNodeConfig struct { + // Cpus: The number of vCPUs for the control-plane node of the admin + // cluster. + Cpus int64 `json:"cpus,omitempty,string"` + + // Memory: The number of mebibytes of memory for the control-plane node + // of the admin cluster. + Memory int64 `json:"memory,omitempty,string"` + + // ForceSendFields is a list of field names (e.g. "Cpus") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Cpus") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareAdminControlPlaneNodeConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareAdminControlPlaneNodeConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareAdminF5BigIpConfig: VmwareAdminF5BigIpConfig represents +// configuration parameters for an F5 BIG-IP load balancer. +type VmwareAdminF5BigIpConfig struct { + // Address: The load balancer's IP address. + Address string `json:"address,omitempty"` + + // Partition: The preexisting partition to be used by the load balancer. + // This partition is usually created for the admin cluster for example: + // 'my-f5-admin-partition'. + Partition string `json:"partition,omitempty"` + + // SnatPool: The pool name. Only necessary, if using SNAT. + SnatPool string `json:"snatPool,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Address") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareAdminF5BigIpConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareAdminF5BigIpConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareAdminLoadBalancerConfig: VmwareAdminLoadBalancerConfig contains +// load balancer configuration for VMware admin cluster. +type VmwareAdminLoadBalancerConfig struct { + // F5Config: Configuration for F5 Big IP typed load balancers. + F5Config *VmwareAdminF5BigIpConfig `json:"f5Config,omitempty"` + + // ManualLbConfig: Manually configured load balancers. + ManualLbConfig *VmwareAdminManualLbConfig `json:"manualLbConfig,omitempty"` + + // MetalLbConfig: MetalLB load balancers. + MetalLbConfig *VmwareAdminMetalLbConfig `json:"metalLbConfig,omitempty"` + + // VipConfig: The VIPs used by the load balancer. + VipConfig *VmwareAdminVipConfig `json:"vipConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "F5Config") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "F5Config") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareAdminLoadBalancerConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareAdminLoadBalancerConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +type VmwareAdminManualLbConfig struct { + // AddonsNodePort: NodePort for add-ons server in the admin cluster. + AddonsNodePort int64 `json:"addonsNodePort,omitempty"` + + // ControlPlaneNodePort: NodePort for control plane service. The + // Kubernetes API server in the admin cluster is implemented as a + // Service of type NodePort (ex. 30968). + ControlPlaneNodePort int64 `json:"controlPlaneNodePort,omitempty"` + + // IngressHttpNodePort: NodePort for ingress service's http. The ingress + // service in the admin cluster is implemented as a Service of type + // NodePort (ex. 32527). + IngressHttpNodePort int64 `json:"ingressHttpNodePort,omitempty"` + + // IngressHttpsNodePort: NodePort for ingress service's https. The + // ingress service in the admin cluster is implemented as a Service of + // type NodePort (ex. 30139). + IngressHttpsNodePort int64 `json:"ingressHttpsNodePort,omitempty"` + + // KonnectivityServerNodePort: NodePort for konnectivity server service + // running as a sidecar in each kube-apiserver pod (ex. 30564). + KonnectivityServerNodePort int64 `json:"konnectivityServerNodePort,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AddonsNodePort") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AddonsNodePort") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *VmwareAdminManualLbConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareAdminManualLbConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareAdminMetalLbConfig: VmwareAdminMetalLbConfig represents +// configuration parameters for a MetalLB load balancer. For admin +// clusters, currently no configurations is needed. +type VmwareAdminMetalLbConfig struct { +} + +// VmwareAdminNetworkConfig: VmwareAdminNetworkConfig contains network +// configuration for VMware admin cluster. +type VmwareAdminNetworkConfig struct { + // DhcpIpConfig: Configuration settings for a DHCP IP configuration. + DhcpIpConfig *VmwareDhcpIpConfig `json:"dhcpIpConfig,omitempty"` + + // HostConfig: Represents common network settings irrespective of the + // host's IP address. + HostConfig *VmwareHostConfig `json:"hostConfig,omitempty"` + + // PodAddressCidrBlocks: Required. All pods in the cluster are assigned + // an RFC1918 IPv4 address from these ranges. Only a single range is + // supported. This field cannot be changed after creation. + PodAddressCidrBlocks []string `json:"podAddressCidrBlocks,omitempty"` + + // ServiceAddressCidrBlocks: Required. All services in the cluster are + // assigned an RFC1918 IPv4 address from these ranges. Only a single + // range is supported. This field cannot be changed after creation. + ServiceAddressCidrBlocks []string `json:"serviceAddressCidrBlocks,omitempty"` + + // StaticIpConfig: Configuration settings for a static IP configuration. + StaticIpConfig *VmwareStaticIpConfig `json:"staticIpConfig,omitempty"` + + // VcenterNetwork: vcenter_network specifies vCenter network name. + VcenterNetwork string `json:"vcenterNetwork,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DhcpIpConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DhcpIpConfig") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareAdminNetworkConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareAdminNetworkConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareAdminVCenterConfig: VmwareAdminVCenterConfig contains VCenter +// configuration for VMware admin cluster. +type VmwareAdminVCenterConfig struct { + // Address: The vCenter IP address. + Address string `json:"address,omitempty"` + + // CaCertData: Contains the vCenter CA certificate public key for SSL + // verification. + CaCertData string `json:"caCertData,omitempty"` + + // Cluster: The name of the vCenter cluster for the admin cluster. + Cluster string `json:"cluster,omitempty"` + + // DataDisk: The name of the virtual machine disk (VMDK) for the admin + // cluster. + DataDisk string `json:"dataDisk,omitempty"` + + // Datacenter: The name of the vCenter datacenter for the admin cluster. + Datacenter string `json:"datacenter,omitempty"` + + // Datastore: The name of the vCenter datastore for the admin cluster. + Datastore string `json:"datastore,omitempty"` + + // Folder: The name of the vCenter folder for the admin cluster. + Folder string `json:"folder,omitempty"` + + // ResourcePool: The name of the vCenter resource pool for the admin + // cluster. + ResourcePool string `json:"resourcePool,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Address") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareAdminVCenterConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareAdminVCenterConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareAdminVipConfig: VmwareAdminVipConfig for VMware load balancer +// configurations. +type VmwareAdminVipConfig struct { + // AddonsVip: The VIP to configure the load balancer for add-ons. + AddonsVip string `json:"addonsVip,omitempty"` + + // ControlPlaneVip: The VIP which you previously set aside for the + // Kubernetes API of the admin cluster. + ControlPlaneVip string `json:"controlPlaneVip,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AddonsVip") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AddonsVip") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareAdminVipConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareAdminVipConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareAutoRepairConfig: Specifies config to enable/disable auto +// repair. The cluster-health-controller is deployed only if Enabled is +// true. +type VmwareAutoRepairConfig struct { + // Enabled: Whether auto repair is enabled. + Enabled bool `json:"enabled,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Enabled") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Enabled") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareAutoRepairConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareAutoRepairConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareAutoResizeConfig: Represents auto resizing configurations for +// the VMware user cluster. +type VmwareAutoResizeConfig struct { + // Enabled: Whether to enable controle plane node auto resizing. + Enabled bool `json:"enabled,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Enabled") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Enabled") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareAutoResizeConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareAutoResizeConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareBundleConfig: VmwareBundleConfig represents configuration for +// the bundle. +type VmwareBundleConfig struct { + // Status: Output only. Resource status for the bundle. + Status *ResourceStatus `json:"status,omitempty"` + + // Version: The version of the bundle. + Version string `json:"version,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Status") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Status") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareBundleConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareBundleConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareCluster: Resource that represents a VMware user cluster. ## +type VmwareCluster struct { + // AdminClusterMembership: Required. The admin cluster this VMware user + // cluster belongs to. This is the full resource name of the admin + // cluster's fleet membership. In the future, references to other + // resource types might be allowed if admin clusters are modeled as + // their own resources. + AdminClusterMembership string `json:"adminClusterMembership,omitempty"` + + // AdminClusterName: Output only. The resource name of the VMware admin + // cluster hosting this user cluster. + AdminClusterName string `json:"adminClusterName,omitempty"` + + // Annotations: Annotations on the VMware user cluster. This field has + // the same restrictions as Kubernetes annotations. The total size of + // all keys and values combined is limited to 256k. Key can have 2 + // segments: prefix (optional) and name (required), separated by a slash + // (/). Prefix must be a DNS subdomain. Name must be 63 characters or + // less, begin and end with alphanumerics, with dashes (-), underscores + // (_), dots (.), and alphanumerics between. + Annotations map[string]string `json:"annotations,omitempty"` + + // AntiAffinityGroups: AAGConfig specifies whether to spread VMware user + // cluster nodes across at least three physical hosts in the datacenter. + AntiAffinityGroups *VmwareAAGConfig `json:"antiAffinityGroups,omitempty"` + + // Authorization: RBAC policy that will be applied and managed by the + // Anthos On-Prem API. + Authorization *Authorization `json:"authorization,omitempty"` + + // AutoRepairConfig: Configuration for auto repairing. + AutoRepairConfig *VmwareAutoRepairConfig `json:"autoRepairConfig,omitempty"` + + // ControlPlaneNode: VMware user cluster control plane nodes must have + // either 1 or 3 replicas. + ControlPlaneNode *VmwareControlPlaneNodeConfig `json:"controlPlaneNode,omitempty"` + + // CreateTime: Output only. The time at which VMware user cluster was + // created. + CreateTime string `json:"createTime,omitempty"` + + // DataplaneV2: VmwareDataplaneV2Config specifies configuration for + // Dataplane V2. + DataplaneV2 *VmwareDataplaneV2Config `json:"dataplaneV2,omitempty"` + + // DeleteTime: Output only. The time at which VMware user cluster was + // deleted. + DeleteTime string `json:"deleteTime,omitempty"` + + // Description: A human readable description of this VMware user + // cluster. + Description string `json:"description,omitempty"` + + // EnableControlPlaneV2: Enable control plane V2. Default to false. + EnableControlPlaneV2 bool `json:"enableControlPlaneV2,omitempty"` + + // Endpoint: Output only. The DNS name of VMware user cluster's API + // server. + Endpoint string `json:"endpoint,omitempty"` + + // Etag: This checksum is computed by the server based on the value of + // other fields, and may be sent on update and delete requests to ensure + // the client has an up-to-date value before proceeding. Allows clients + // to perform consistent read-modify-writes through optimistic + // concurrency control. + Etag string `json:"etag,omitempty"` + + // Fleet: Output only. Fleet configuration for the cluster. + Fleet *Fleet `json:"fleet,omitempty"` + + // LoadBalancer: Load balancer configuration. + LoadBalancer *VmwareLoadBalancerConfig `json:"loadBalancer,omitempty"` + + // LocalName: Output only. The object name of the VMware + // OnPremUserCluster custom resource on the associated admin cluster. + // This field is used to support conflicting names when enrolling + // existing clusters to the API. When used as a part of cluster + // enrollment, this field will differ from the ID in the resource name. + // For new clusters, this field will match the user provided cluster + // name and be visible in the last component of the resource name. It is + // not modifiable. All users should use this name to access their + // cluster using gkectl or kubectl and should expect to see the local + // name when viewing admin cluster controller logs. + LocalName string `json:"localName,omitempty"` + + // Name: Immutable. The VMware user cluster resource name. + Name string `json:"name,omitempty"` + + // NetworkConfig: The VMware user cluster network configuration. + NetworkConfig *VmwareNetworkConfig `json:"networkConfig,omitempty"` + + // OnPremVersion: The Anthos clusters on the VMware version for your + // user cluster. Defaults to the admin cluster version. + OnPremVersion string `json:"onPremVersion,omitempty"` + + // Reconciling: Output only. If set, there are currently changes in + // flight to the VMware user cluster. + Reconciling bool `json:"reconciling,omitempty"` + + // State: Output only. The current state of VMware user cluster. + // + // Possible values: + // "STATE_UNSPECIFIED" - Not set. + // "PROVISIONING" - The PROVISIONING state indicates the cluster is + // being created. + // "RUNNING" - The RUNNING state indicates the cluster has been + // created and is fully usable. + // "RECONCILING" - The RECONCILING state indicates that the cluster is + // being updated. It remains available, but potentially with degraded + // performance. + // "STOPPING" - The STOPPING state indicates the cluster is being + // deleted. + // "ERROR" - The ERROR state indicates the cluster is in a broken + // unrecoverable state. + // "DEGRADED" - The DEGRADED state indicates the cluster requires user + // action to restore full functionality. + State string `json:"state,omitempty"` + + // Status: Output only. ResourceStatus representing detailed cluster + // state. + Status *ResourceStatus `json:"status,omitempty"` + + // Storage: Storage configuration. + Storage *VmwareStorageConfig `json:"storage,omitempty"` + + // Uid: Output only. The unique identifier of the VMware user cluster. + Uid string `json:"uid,omitempty"` + + // UpdateTime: Output only. The time at which VMware user cluster was + // last updated. + UpdateTime string `json:"updateTime,omitempty"` + + // ValidationCheck: Output only. ValidationCheck represents the result + // of the preflight check job. + ValidationCheck *ValidationCheck `json:"validationCheck,omitempty"` + + // Vcenter: Output only. VmwareVCenterConfig specifies vCenter config + // for the user cluster. Inherited from the admin cluster. + Vcenter *VmwareVCenterConfig `json:"vcenter,omitempty"` + + // VmTrackingEnabled: Enable VM tracking. + VmTrackingEnabled bool `json:"vmTrackingEnabled,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. + // "AdminClusterMembership") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AdminClusterMembership") + // to include in API requests with the JSON null value. By default, + // fields with empty values are omitted from API requests. However, any + // field with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *VmwareCluster) MarshalJSON() ([]byte, error) { + type NoMethod VmwareCluster + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareControlPlaneNodeConfig: Specifies control plane node config for +// the VMware user cluster. +type VmwareControlPlaneNodeConfig struct { + // AutoResizeConfig: AutoResizeConfig provides auto resizing + // configurations. + AutoResizeConfig *VmwareAutoResizeConfig `json:"autoResizeConfig,omitempty"` + + // Cpus: The number of CPUs for each admin cluster node that serve as + // control planes for this VMware user cluster. (default: 4 CPUs) + Cpus int64 `json:"cpus,omitempty,string"` + + // Memory: The megabytes of memory for each admin cluster node that + // serves as a control plane for this VMware user cluster (default: 8192 + // MB memory). + Memory int64 `json:"memory,omitempty,string"` + + // Replicas: The number of control plane nodes for this VMware user + // cluster. (default: 1 replica). + Replicas int64 `json:"replicas,omitempty,string"` + + // VsphereConfig: Output only. Vsphere-specific config. + VsphereConfig *VmwareControlPlaneVsphereConfig `json:"vsphereConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AutoResizeConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AutoResizeConfig") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *VmwareControlPlaneNodeConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareControlPlaneNodeConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareControlPlaneV2Config: Specifies control plane V2 config. +type VmwareControlPlaneV2Config struct { + // ControlPlaneIpBlock: Static IP addresses for the control plane nodes. + ControlPlaneIpBlock *VmwareIpBlock `json:"controlPlaneIpBlock,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ControlPlaneIpBlock") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ControlPlaneIpBlock") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *VmwareControlPlaneV2Config) MarshalJSON() ([]byte, error) { + type NoMethod VmwareControlPlaneV2Config + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareControlPlaneVsphereConfig: Specifies control plane node config. +type VmwareControlPlaneVsphereConfig struct { + // Datastore: The Vsphere datastore used by the control plane Node. + Datastore string `json:"datastore,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Datastore") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Datastore") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareControlPlaneVsphereConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareControlPlaneVsphereConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareDataplaneV2Config: Contains configurations for Dataplane V2, +// which is optimized dataplane for Kubernetes networking. For more +// information, see: +// https://cloud.google.com/kubernetes-engine/docs/concepts/dataplane-v2 +type VmwareDataplaneV2Config struct { + // AdvancedNetworking: Enable advanced networking which requires + // dataplane_v2_enabled to be set true. + AdvancedNetworking bool `json:"advancedNetworking,omitempty"` + + // DataplaneV2Enabled: Enables Dataplane V2. + DataplaneV2Enabled bool `json:"dataplaneV2Enabled,omitempty"` + + // WindowsDataplaneV2Enabled: Enable Dataplane V2 for clusters with + // Windows nodes. + WindowsDataplaneV2Enabled bool `json:"windowsDataplaneV2Enabled,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AdvancedNetworking") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AdvancedNetworking") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *VmwareDataplaneV2Config) MarshalJSON() ([]byte, error) { + type NoMethod VmwareDataplaneV2Config + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareDhcpIpConfig: Represents the network configuration required for +// the VMware user clusters with DHCP IP configurations. +type VmwareDhcpIpConfig struct { + // Enabled: enabled is a flag to mark if DHCP IP allocation is used for + // VMware user clusters. + Enabled bool `json:"enabled,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Enabled") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Enabled") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareDhcpIpConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareDhcpIpConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareF5BigIpConfig: Represents configuration parameters for an F5 +// BIG-IP load balancer. +type VmwareF5BigIpConfig struct { + // Address: The load balancer's IP address. + Address string `json:"address,omitempty"` + + // Partition: The preexisting partition to be used by the load balancer. + // This partition is usually created for the admin cluster for example: + // 'my-f5-admin-partition'. + Partition string `json:"partition,omitempty"` + + // SnatPool: The pool name. Only necessary, if using SNAT. + SnatPool string `json:"snatPool,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Address") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareF5BigIpConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareF5BigIpConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareHostConfig: Represents the common parameters for all the hosts +// irrespective of their IP address. +type VmwareHostConfig struct { + // DnsSearchDomains: DNS search domains. + DnsSearchDomains []string `json:"dnsSearchDomains,omitempty"` + + // DnsServers: DNS servers. + DnsServers []string `json:"dnsServers,omitempty"` + + // NtpServers: NTP servers. + NtpServers []string `json:"ntpServers,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DnsSearchDomains") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DnsSearchDomains") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *VmwareHostConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareHostConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareHostIp: Represents VMware user cluster node's network +// configuration. +type VmwareHostIp struct { + // Hostname: Hostname of the machine. VM's name will be used if this + // field is empty. + Hostname string `json:"hostname,omitempty"` + + // Ip: IP could be an IP address (like 1.2.3.4) or a CIDR (like + // 1.2.3.0/24). + Ip string `json:"ip,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Hostname") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Hostname") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareHostIp) MarshalJSON() ([]byte, error) { + type NoMethod VmwareHostIp + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareIpBlock: Represents a collection of IP addresses to assign to +// nodes. +type VmwareIpBlock struct { + // Gateway: The network gateway used by the VMware user cluster. + Gateway string `json:"gateway,omitempty"` + + // Ips: The node's network configurations used by the VMware user + // cluster. + Ips []*VmwareHostIp `json:"ips,omitempty"` + + // Netmask: The netmask used by the VMware user cluster. + Netmask string `json:"netmask,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Gateway") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Gateway") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareIpBlock) MarshalJSON() ([]byte, error) { + type NoMethod VmwareIpBlock + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareLoadBalancerConfig: Specifies the locad balancer config for the +// VMware user cluster. +type VmwareLoadBalancerConfig struct { + // F5Config: Configuration for F5 Big IP typed load balancers. + F5Config *VmwareF5BigIpConfig `json:"f5Config,omitempty"` + + // ManualLbConfig: Manually configured load balancers. + ManualLbConfig *VmwareManualLbConfig `json:"manualLbConfig,omitempty"` + + // MetalLbConfig: Configuration for MetalLB typed load balancers. + MetalLbConfig *VmwareMetalLbConfig `json:"metalLbConfig,omitempty"` + + // VipConfig: The VIPs used by the load balancer. + VipConfig *VmwareVipConfig `json:"vipConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "F5Config") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "F5Config") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareLoadBalancerConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareLoadBalancerConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareManualLbConfig: Represents configuration parameters for an +// already existing manual load balancer. Given the nature of manual +// load balancers it is expected that said load balancer will be fully +// managed by users. IMPORTANT: Please note that the Anthos On-Prem API +// will not generate or update ManualLB configurations it can only bind +// a pre-existing configuration to a new VMware user cluster. +type VmwareManualLbConfig struct { + // ControlPlaneNodePort: NodePort for control plane service. The + // Kubernetes API server in the admin cluster is implemented as a + // Service of type NodePort (ex. 30968). + ControlPlaneNodePort int64 `json:"controlPlaneNodePort,omitempty"` + + // IngressHttpNodePort: NodePort for ingress service's http. The ingress + // service in the admin cluster is implemented as a Service of type + // NodePort (ex. 32527). + IngressHttpNodePort int64 `json:"ingressHttpNodePort,omitempty"` + + // IngressHttpsNodePort: NodePort for ingress service's https. The + // ingress service in the admin cluster is implemented as a Service of + // type NodePort (ex. 30139). + IngressHttpsNodePort int64 `json:"ingressHttpsNodePort,omitempty"` + + // KonnectivityServerNodePort: NodePort for konnectivity server service + // running as a sidecar in each kube-apiserver pod (ex. 30564). + KonnectivityServerNodePort int64 `json:"konnectivityServerNodePort,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "ControlPlaneNodePort") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ControlPlaneNodePort") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *VmwareManualLbConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareManualLbConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareMetalLbConfig: Represents configuration parameters for the +// MetalLB load balancer. +type VmwareMetalLbConfig struct { + // AddressPools: Required. AddressPools is a list of non-overlapping IP + // pools used by load balancer typed services. All addresses must be + // routable to load balancer nodes. IngressVIP must be included in the + // pools. + AddressPools []*VmwareAddressPool `json:"addressPools,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AddressPools") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AddressPools") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareMetalLbConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareMetalLbConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareNetworkConfig: Specifies network config for the VMware user +// cluster. +type VmwareNetworkConfig struct { + // ControlPlaneV2Config: Configuration for control plane V2 mode. + ControlPlaneV2Config *VmwareControlPlaneV2Config `json:"controlPlaneV2Config,omitempty"` + + // DhcpIpConfig: Configuration settings for a DHCP IP configuration. + DhcpIpConfig *VmwareDhcpIpConfig `json:"dhcpIpConfig,omitempty"` + + // HostConfig: Represents common network settings irrespective of the + // host's IP address. + HostConfig *VmwareHostConfig `json:"hostConfig,omitempty"` + + // PodAddressCidrBlocks: Required. All pods in the cluster are assigned + // an RFC1918 IPv4 address from these ranges. Only a single range is + // supported. This field cannot be changed after creation. + PodAddressCidrBlocks []string `json:"podAddressCidrBlocks,omitempty"` + + // ServiceAddressCidrBlocks: Required. All services in the cluster are + // assigned an RFC1918 IPv4 address from these ranges. Only a single + // range is supported. This field cannot be changed after creation. + ServiceAddressCidrBlocks []string `json:"serviceAddressCidrBlocks,omitempty"` + + // StaticIpConfig: Configuration settings for a static IP configuration. + StaticIpConfig *VmwareStaticIpConfig `json:"staticIpConfig,omitempty"` + + // VcenterNetwork: Output only. vcenter_network specifies vCenter + // network name. Inherited from the admin cluster. + VcenterNetwork string `json:"vcenterNetwork,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "ControlPlaneV2Config") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ControlPlaneV2Config") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *VmwareNetworkConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareNetworkConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareNodeConfig: Parameters that describe the configuration of all +// nodes within a given node pool. +type VmwareNodeConfig struct { + // BootDiskSizeGb: VMware disk size to be used during creation. + BootDiskSizeGb int64 `json:"bootDiskSizeGb,omitempty,string"` + + // Cpus: The number of CPUs for each node in the node pool. + Cpus int64 `json:"cpus,omitempty,string"` + + // EnableLoadBalancer: Allow node pool traffic to be load balanced. Only + // works for clusters with MetalLB load balancers. + EnableLoadBalancer bool `json:"enableLoadBalancer,omitempty"` + + // Image: The OS image name in vCenter, only valid when using Windows. + Image string `json:"image,omitempty"` + + // ImageType: Required. The OS image to be used for each node in a node + // pool. Currently `cos`, `ubuntu`, `ubuntu_containerd` and `windows` + // are supported. + ImageType string `json:"imageType,omitempty"` + + // Labels: The map of Kubernetes labels (key/value pairs) to be applied + // to each node. These will added in addition to any default label(s) + // that Kubernetes may apply to the node. In case of conflict in label + // keys, the applied set may differ depending on the Kubernetes version + // -- it's best to assume the behavior is undefined and conflicts should + // be avoided. For more information, including usage and the valid + // values, see: + // https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/ + Labels map[string]string `json:"labels,omitempty"` + + // MemoryMb: The megabytes of memory for each node in the node pool. + MemoryMb int64 `json:"memoryMb,omitempty,string"` + + // Replicas: The number of nodes in the node pool. + Replicas int64 `json:"replicas,omitempty,string"` + + // Taints: The initial taints assigned to nodes of this node pool. + Taints []*NodeTaint `json:"taints,omitempty"` + + // VsphereConfig: Output only. Specifies the vSphere config for node + // pool. + VsphereConfig *VmwareVsphereConfig `json:"vsphereConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BootDiskSizeGb") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BootDiskSizeGb") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *VmwareNodeConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareNodeConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareNodePool: Resource VmwareNodePool represents a VMware node +// pool. ## +type VmwareNodePool struct { + // Annotations: Annotations on the node pool. This field has the same + // restrictions as Kubernetes annotations. The total size of all keys + // and values combined is limited to 256k. Key can have 2 segments: + // prefix (optional) and name (required), separated by a slash (/). + // Prefix must be a DNS subdomain. Name must be 63 characters or less, + // begin and end with alphanumerics, with dashes (-), underscores (_), + // dots (.), and alphanumerics between. + Annotations map[string]string `json:"annotations,omitempty"` + + // Config: Required. The node configuration of the node pool. + Config *VmwareNodeConfig `json:"config,omitempty"` + + // CreateTime: Output only. The time at which this node pool was + // created. + CreateTime string `json:"createTime,omitempty"` + + // DeleteTime: Output only. The time at which this node pool was + // deleted. If the resource is not deleted, this must be empty + DeleteTime string `json:"deleteTime,omitempty"` + + // DisplayName: The display name for the node pool. + DisplayName string `json:"displayName,omitempty"` + + // Etag: This checksum is computed by the server based on the value of + // other fields, and may be sent on update and delete requests to ensure + // the client has an up-to-date value before proceeding. Allows clients + // to perform consistent read-modify-writes through optimistic + // concurrency control. + Etag string `json:"etag,omitempty"` + + // Name: Immutable. The resource name of this node pool. + Name string `json:"name,omitempty"` + + // NodePoolAutoscaling: Node pool autoscaling config for the node pool. + NodePoolAutoscaling *VmwareNodePoolAutoscalingConfig `json:"nodePoolAutoscaling,omitempty"` + + // OnPremVersion: Anthos version for the node pool. Defaults to the user + // cluster version. + OnPremVersion string `json:"onPremVersion,omitempty"` + + // Reconciling: Output only. If set, there are currently changes in + // flight to the node pool. + Reconciling bool `json:"reconciling,omitempty"` + + // State: Output only. The current state of the node pool. + // + // Possible values: + // "STATE_UNSPECIFIED" - Not set. + // "PROVISIONING" - The PROVISIONING state indicates the node pool is + // being created. + // "RUNNING" - The RUNNING state indicates the node pool has been + // created and is fully usable. + // "RECONCILING" - The RECONCILING state indicates that the node pool + // is being updated. It remains available, but potentially with degraded + // performance. + // "STOPPING" - The STOPPING state indicates the cluster is being + // deleted + // "ERROR" - The ERROR state indicates the node pool is in a broken + // unrecoverable state. + // "DEGRADED" - The DEGRADED state indicates the node pool requires + // user action to restore full functionality. + State string `json:"state,omitempty"` + + // Status: Output only. ResourceStatus representing the detailed VMware + // node pool state. + Status *ResourceStatus `json:"status,omitempty"` + + // Uid: Output only. The unique identifier of the node pool. + Uid string `json:"uid,omitempty"` + + // UpdateTime: Output only. The time at which this node pool was last + // updated. + UpdateTime string `json:"updateTime,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Annotations") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Annotations") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareNodePool) MarshalJSON() ([]byte, error) { + type NoMethod VmwareNodePool + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareNodePoolAutoscalingConfig: NodePoolAutoscaling config for the +// NodePool to allow for the kubernetes to scale NodePool. +type VmwareNodePoolAutoscalingConfig struct { + // MaxReplicas: Maximum number of replicas in the NodePool. + MaxReplicas int64 `json:"maxReplicas,omitempty"` + + // MinReplicas: Minimum number of replicas in the NodePool. + MinReplicas int64 `json:"minReplicas,omitempty"` + + // ForceSendFields is a list of field names (e.g. "MaxReplicas") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "MaxReplicas") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareNodePoolAutoscalingConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareNodePoolAutoscalingConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwarePlatformConfig: VmwarePlatformConfig represents configuration +// for the VMware platform. +type VmwarePlatformConfig struct { + // Bundles: Output only. The list of bundles installed in the admin + // cluster. + Bundles []*VmwareBundleConfig `json:"bundles,omitempty"` + + // PlatformVersion: Output only. The platform version e.g. 1.13.2. + PlatformVersion string `json:"platformVersion,omitempty"` + + // RequiredPlatformVersion: Input only. The required platform version + // e.g. 1.13.1. If the current platform version is lower than the target + // version, the platform version will be updated to the target version. + // If the target version is not installed in the platform (bundle + // versions), download the target version bundle. + RequiredPlatformVersion string `json:"requiredPlatformVersion,omitempty"` + + // Status: Output only. Resource status for the platform. + Status *ResourceStatus `json:"status,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Bundles") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Bundles") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwarePlatformConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwarePlatformConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareStaticIpConfig: Represents the network configuration required +// for the VMware user clusters with Static IP configurations. +type VmwareStaticIpConfig struct { + // IpBlocks: Represents the configuration values for static IP + // allocation to nodes. + IpBlocks []*VmwareIpBlock `json:"ipBlocks,omitempty"` + + // ForceSendFields is a list of field names (e.g. "IpBlocks") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "IpBlocks") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareStaticIpConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareStaticIpConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareStorageConfig: Specifies vSphere CSI components deployment +// config in the VMware user cluster. +type VmwareStorageConfig struct { + // VsphereCsiDisabled: Whether or not to deploy vSphere CSI components + // in the VMware user cluster. Enabled by default. + VsphereCsiDisabled bool `json:"vsphereCsiDisabled,omitempty"` + + // ForceSendFields is a list of field names (e.g. "VsphereCsiDisabled") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "VsphereCsiDisabled") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *VmwareStorageConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareStorageConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareVCenterConfig: Represents configuration for the VMware VCenter +// for the user cluster. +type VmwareVCenterConfig struct { + // Address: The vCenter IP address. + Address string `json:"address,omitempty"` + + // CaCertData: Contains the vCenter CA certificate public key for SSL + // verification. + CaCertData string `json:"caCertData,omitempty"` + + // Cluster: The name of the vCenter cluster for the user cluster. + Cluster string `json:"cluster,omitempty"` + + // Datacenter: The name of the vCenter datacenter for the user cluster. + Datacenter string `json:"datacenter,omitempty"` + + // Datastore: The name of the vCenter datastore for the user cluster. + Datastore string `json:"datastore,omitempty"` + + // Folder: The name of the vCenter folder for the user cluster. + Folder string `json:"folder,omitempty"` + + // ResourcePool: The name of the vCenter resource pool for the user + // cluster. + ResourcePool string `json:"resourcePool,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Address") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareVCenterConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareVCenterConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareVersionInfo: Contains information about a specific Anthos on +// VMware version. +type VmwareVersionInfo struct { + // HasDependencies: If set, the cluster dependencies (e.g. the admin + // cluster, other user clusters managed by the same admin cluster) must + // be upgraded before this version can be installed or upgraded to. + HasDependencies bool `json:"hasDependencies,omitempty"` + + // IsInstalled: If set, the version is installed in the admin cluster. + // Otherwise, the version bundle must be downloaded and installed before + // a user cluster can be created at or upgraded to this version. + IsInstalled bool `json:"isInstalled,omitempty"` + + // Version: Version number e.g. 1.13.1-gke.1000. + Version string `json:"version,omitempty"` + + // ForceSendFields is a list of field names (e.g. "HasDependencies") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "HasDependencies") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *VmwareVersionInfo) MarshalJSON() ([]byte, error) { + type NoMethod VmwareVersionInfo + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareVipConfig: Specifies the VIP config for the VMware user cluster +// load balancer. +type VmwareVipConfig struct { + // ControlPlaneVip: The VIP which you previously set aside for the + // Kubernetes API of this cluster. + ControlPlaneVip string `json:"controlPlaneVip,omitempty"` + + // IngressVip: The VIP which you previously set aside for ingress + // traffic into this cluster. + IngressVip string `json:"ingressVip,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ControlPlaneVip") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ControlPlaneVip") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *VmwareVipConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareVipConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareVsphereConfig: VmwareVsphereConfig represents configuration for +// the VMware VCenter for node pool. +type VmwareVsphereConfig struct { + // Datastore: The name of the vCenter datastore. Inherited from the user + // cluster. + Datastore string `json:"datastore,omitempty"` + + // Tags: Tags to apply to VMs. + Tags []*VmwareVsphereTag `json:"tags,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Datastore") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Datastore") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareVsphereConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareVsphereConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VmwareVsphereTag: VmwareVsphereTag describes a vSphere tag to be +// placed on VMs in the node pool. For more information, see +// https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.vcenterhost.doc/GUID-E8E854DD-AA97-4E0C-8419-CE84F93C4058.html +type VmwareVsphereTag struct { + // Category: The Vsphere tag category. + Category string `json:"category,omitempty"` + + // Tag: The Vsphere tag name. + Tag string `json:"tag,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Category") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Category") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareVsphereTag) MarshalJSON() ([]byte, error) { + type NoMethod VmwareVsphereTag + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// method id "gkeonprem.projects.locations.get": + +type ProjectsLocationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets information about a location. +// +// - name: Resource name for the location. +func (r *ProjectsLocationsService) Get(name string) *ProjectsLocationsGetCall { + c := &ProjectsLocationsGetCall{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 information. +func (c *ProjectsLocationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsGetCall) Context(ctx context.Context) *ProjectsLocationsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.get" call. +// Exactly one of *Location or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Location.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 *ProjectsLocationsGetCall) Do(opts ...googleapi.CallOption) (*Location, 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 := &Location{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets information about a location.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Resource name for the location.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Location" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.list": + +type ProjectsLocationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists information about the supported locations for this +// service. +// +// - name: The resource that owns the locations collection, if +// applicable. +func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { + c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": A filter to narrow down +// results to a preferred subset. The filtering language accepts strings +// like "displayName=tokyo", and is documented in more detail in +// AIP-160 (https://google.aip.dev/160). +func (c *ProjectsLocationsListCall) Filter(filter string) *ProjectsLocationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number +// of results to return. If not set, the service selects a default. +func (c *ProjectsLocationsListCall) PageSize(pageSize int64) *ProjectsLocationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token +// received from the `next_page_token` field in the response. Send that +// page token to receive the subsequent page. +func (c *ProjectsLocationsListCall) PageToken(pageToken string) *ProjectsLocationsListCall { + 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 information. +func (c *ProjectsLocationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsListCall) Context(ctx context.Context) *ProjectsLocationsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/locations") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.list" call. +// Exactly one of *ListLocationsResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListLocationsResponse.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 *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocationsResponse, 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 := &ListLocationsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists information about the supported locations for this service.", + // "flatPath": "v1/projects/{projectsId}/locations", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.list", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "filter": { + // "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + // "location": "query", + // "type": "string" + // }, + // "name": { + // "description": "The resource that owns the locations collection, if applicable.", + // "location": "path", + // "pattern": "^projects/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "pageSize": { + // "description": "The maximum number of results to return. If not set, the service selects a default.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}/locations", + // "response": { + // "$ref": "ListLocationsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "gkeonprem.projects.locations.bareMetalAdminClusters.create": + +type ProjectsLocationsBareMetalAdminClustersCreateCall struct { + s *Service + parent string + baremetaladmincluster *BareMetalAdminCluster + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new bare metal admin cluster in a given project and +// location. The API needs to be combined with creating a bootstrap +// cluster to work. See: +// https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/installing/creating-clusters/create-admin-cluster-api#prepare_bootstrap_environment +// +// - parent: The parent of the project and location where the cluster is +// created in. Format: "projects/{project}/locations/{location}". +func (r *ProjectsLocationsBareMetalAdminClustersService) Create(parent string, baremetaladmincluster *BareMetalAdminCluster) *ProjectsLocationsBareMetalAdminClustersCreateCall { + c := &ProjectsLocationsBareMetalAdminClustersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.baremetaladmincluster = baremetaladmincluster + return c +} + +// BareMetalAdminClusterId sets the optional parameter +// "bareMetalAdminClusterId": Required. User provided identifier that is +// used as part of the resource name; must conform to RFC-1034 and +// additionally restrict to lower-cased letters. This comes out roughly +// to: /^a-z+[a-z0-9]$/ +func (c *ProjectsLocationsBareMetalAdminClustersCreateCall) BareMetalAdminClusterId(bareMetalAdminClusterId string) *ProjectsLocationsBareMetalAdminClustersCreateCall { + c.urlParams_.Set("bareMetalAdminClusterId", bareMetalAdminClusterId) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Validate the +// request without actually doing any updates. +func (c *ProjectsLocationsBareMetalAdminClustersCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsBareMetalAdminClustersCreateCall { + 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 information. +func (c *ProjectsLocationsBareMetalAdminClustersCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalAdminClustersCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalAdminClustersCreateCall) Context(ctx context.Context) *ProjectsLocationsBareMetalAdminClustersCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalAdminClustersCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalAdminClustersCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.baremetaladmincluster) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/bareMetalAdminClusters") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalAdminClusters.create" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalAdminClustersCreateCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates a new bare metal admin cluster in a given project and location. The API needs to be combined with creating a bootstrap cluster to work. See: https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/installing/creating-clusters/create-admin-cluster-api#prepare_bootstrap_environment", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.bareMetalAdminClusters.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "bareMetalAdminClusterId": { + // "description": "Required. User provided identifier that is used as part of the resource name; must conform to RFC-1034 and additionally restrict to lower-cased letters. This comes out roughly to: /^a-z+[a-z0-9]$/", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The parent of the project and location where the cluster is created in. Format: \"projects/{project}/locations/{location}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "Validate the request without actually doing any updates.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+parent}/bareMetalAdminClusters", + // "request": { + // "$ref": "BareMetalAdminCluster" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalAdminClusters.enroll": + +type ProjectsLocationsBareMetalAdminClustersEnrollCall struct { + s *Service + parent string + enrollbaremetaladminclusterrequest *EnrollBareMetalAdminClusterRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Enroll: Enrolls an existing bare metal admin cluster to the Anthos +// On-Prem API within a given project and location. Through enrollment, +// an existing admin cluster will become Anthos On-Prem API managed. The +// corresponding GCP resources will be created and all future +// modifications to the cluster will be expected to be performed through +// the API. +// +// - parent: The parent of the project and location where the cluster is +// enrolled in. Format: "projects/{project}/locations/{location}". +func (r *ProjectsLocationsBareMetalAdminClustersService) Enroll(parent string, enrollbaremetaladminclusterrequest *EnrollBareMetalAdminClusterRequest) *ProjectsLocationsBareMetalAdminClustersEnrollCall { + c := &ProjectsLocationsBareMetalAdminClustersEnrollCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.enrollbaremetaladminclusterrequest = enrollbaremetaladminclusterrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBareMetalAdminClustersEnrollCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalAdminClustersEnrollCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalAdminClustersEnrollCall) Context(ctx context.Context) *ProjectsLocationsBareMetalAdminClustersEnrollCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalAdminClustersEnrollCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalAdminClustersEnrollCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.enrollbaremetaladminclusterrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/bareMetalAdminClusters:enroll") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalAdminClusters.enroll" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalAdminClustersEnrollCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Enrolls an existing bare metal admin cluster to the Anthos On-Prem API within a given project and location. Through enrollment, an existing admin cluster will become Anthos On-Prem API managed. The corresponding GCP resources will be created and all future modifications to the cluster will be expected to be performed through the API.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters:enroll", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.bareMetalAdminClusters.enroll", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The parent of the project and location where the cluster is enrolled in. Format: \"projects/{project}/locations/{location}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/bareMetalAdminClusters:enroll", + // "request": { + // "$ref": "EnrollBareMetalAdminClusterRequest" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalAdminClusters.get": + +type ProjectsLocationsBareMetalAdminClustersGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of a single bare metal admin cluster. +// +// - name: Name of the bare metal admin cluster to get. Format: +// "projects/{project}/locations/{location}/bareMetalAdminClusters/{bar +// e_metal_admin_cluster}". +func (r *ProjectsLocationsBareMetalAdminClustersService) Get(name string) *ProjectsLocationsBareMetalAdminClustersGetCall { + c := &ProjectsLocationsBareMetalAdminClustersGetCall{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 information. +func (c *ProjectsLocationsBareMetalAdminClustersGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalAdminClustersGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsBareMetalAdminClustersGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsBareMetalAdminClustersGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalAdminClustersGetCall) Context(ctx context.Context) *ProjectsLocationsBareMetalAdminClustersGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalAdminClustersGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalAdminClustersGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalAdminClusters.get" call. +// Exactly one of *BareMetalAdminCluster or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *BareMetalAdminCluster.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 *ProjectsLocationsBareMetalAdminClustersGetCall) Do(opts ...googleapi.CallOption) (*BareMetalAdminCluster, 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 := &BareMetalAdminCluster{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets details of a single bare metal admin cluster.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters/{bareMetalAdminClustersId}", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.bareMetalAdminClusters.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Name of the bare metal admin cluster to get. Format: \"projects/{project}/locations/{location}/bareMetalAdminClusters/{bare_metal_admin_cluster}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalAdminClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "BareMetalAdminCluster" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalAdminClusters.getIamPolicy": + +type ProjectsLocationsBareMetalAdminClustersGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - 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 *ProjectsLocationsBareMetalAdminClustersService) GetIamPolicy(resource string) *ProjectsLocationsBareMetalAdminClustersGetIamPolicyCall { + c := &ProjectsLocationsBareMetalAdminClustersGetIamPolicyCall{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 *ProjectsLocationsBareMetalAdminClustersGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsBareMetalAdminClustersGetIamPolicyCall { + 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 information. +func (c *ProjectsLocationsBareMetalAdminClustersGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalAdminClustersGetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsBareMetalAdminClustersGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsBareMetalAdminClustersGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalAdminClustersGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsBareMetalAdminClustersGetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalAdminClustersGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalAdminClustersGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalAdminClusters.getIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. 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 *ProjectsLocationsBareMetalAdminClustersGetIamPolicyCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters/{bareMetalAdminClustersId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.bareMetalAdminClusters.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. 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).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalAdminClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalAdminClusters.list": + +type ProjectsLocationsBareMetalAdminClustersListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists bare metal admin clusters in a given project and +// location. +// +// - parent: The parent of the project and location where the clusters +// are listed in. Format: "projects/{project}/locations/{location}". +func (r *ProjectsLocationsBareMetalAdminClustersService) List(parent string) *ProjectsLocationsBareMetalAdminClustersListCall { + c := &ProjectsLocationsBareMetalAdminClustersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": Requested page size. +// Server may return fewer items than requested. If unspecified, at most +// 50 clusters will be returned. The maximum value is 1000; values above +// 1000 will be coerced to 1000. +func (c *ProjectsLocationsBareMetalAdminClustersListCall) PageSize(pageSize int64) *ProjectsLocationsBareMetalAdminClustersListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A token +// identifying a page of results the server should return. +func (c *ProjectsLocationsBareMetalAdminClustersListCall) PageToken(pageToken string) *ProjectsLocationsBareMetalAdminClustersListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// View sets the optional parameter "view": View for bare metal admin +// clusters. When `BASIC` is specified, only the admin cluster resource +// name and membership are returned. The default/unset value +// `CLUSTER_VIEW_UNSPECIFIED` is the same as `FULL', which returns the +// complete admin cluster configuration details. +// +// Possible values: +// +// "CLUSTER_VIEW_UNSPECIFIED" - If the value is not set, the default +// +// `FULL` view is used. +// +// "BASIC" - Includes basic information of a admin cluster resource +// +// including admin cluster resource name and membership. +// +// "FULL" - Includes the complete configuration for bare metal admin +// +// cluster resource. This is the default value for +// ListBareMetalAdminClustersRequest method. +func (c *ProjectsLocationsBareMetalAdminClustersListCall) View(view string) *ProjectsLocationsBareMetalAdminClustersListCall { + c.urlParams_.Set("view", view) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBareMetalAdminClustersListCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalAdminClustersListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsBareMetalAdminClustersListCall) IfNoneMatch(entityTag string) *ProjectsLocationsBareMetalAdminClustersListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalAdminClustersListCall) Context(ctx context.Context) *ProjectsLocationsBareMetalAdminClustersListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalAdminClustersListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalAdminClustersListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/bareMetalAdminClusters") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalAdminClusters.list" call. +// Exactly one of *ListBareMetalAdminClustersResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *ListBareMetalAdminClustersResponse.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 *ProjectsLocationsBareMetalAdminClustersListCall) Do(opts ...googleapi.CallOption) (*ListBareMetalAdminClustersResponse, 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 := &ListBareMetalAdminClustersResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists bare metal admin clusters in a given project and location.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.bareMetalAdminClusters.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "Requested page size. Server may return fewer items than requested. If unspecified, at most 50 clusters will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "A token identifying a page of results the server should return.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The parent of the project and location where the clusters are listed in. Format: \"projects/{project}/locations/{location}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "view": { + // "description": "View for bare metal admin clusters. When `BASIC` is specified, only the admin cluster resource name and membership are returned. The default/unset value `CLUSTER_VIEW_UNSPECIFIED` is the same as `FULL', which returns the complete admin cluster configuration details.", + // "enum": [ + // "CLUSTER_VIEW_UNSPECIFIED", + // "BASIC", + // "FULL" + // ], + // "enumDescriptions": [ + // "If the value is not set, the default `FULL` view is used.", + // "Includes basic information of a admin cluster resource including admin cluster resource name and membership.", + // "Includes the complete configuration for bare metal admin cluster resource. This is the default value for ListBareMetalAdminClustersRequest method." + // ], + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/bareMetalAdminClusters", + // "response": { + // "$ref": "ListBareMetalAdminClustersResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsBareMetalAdminClustersListCall) Pages(ctx context.Context, f func(*ListBareMetalAdminClustersResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "gkeonprem.projects.locations.bareMetalAdminClusters.patch": + +type ProjectsLocationsBareMetalAdminClustersPatchCall struct { + s *Service + name string + baremetaladmincluster *BareMetalAdminCluster + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the parameters of a single bare metal admin cluster. +// +// - name: Immutable. The bare metal admin cluster resource name. +func (r *ProjectsLocationsBareMetalAdminClustersService) Patch(name string, baremetaladmincluster *BareMetalAdminCluster) *ProjectsLocationsBareMetalAdminClustersPatchCall { + c := &ProjectsLocationsBareMetalAdminClustersPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.baremetaladmincluster = baremetaladmincluster + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Field +// mask is used to specify the fields to be overwritten in the +// BareMetalAdminCluster resource by the update. The fields specified in +// the update_mask are relative to the resource, not the full request. A +// field will be overwritten if it is in the mask. If the user does not +// provide a mask then all populated fields in the BareMetalAdminCluster +// message will be updated. Empty fields will be ignored unless a field +// mask is used. +func (c *ProjectsLocationsBareMetalAdminClustersPatchCall) UpdateMask(updateMask string) *ProjectsLocationsBareMetalAdminClustersPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Validate the +// request without actually doing any updates. +func (c *ProjectsLocationsBareMetalAdminClustersPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsBareMetalAdminClustersPatchCall { + 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 information. +func (c *ProjectsLocationsBareMetalAdminClustersPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalAdminClustersPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalAdminClustersPatchCall) Context(ctx context.Context) *ProjectsLocationsBareMetalAdminClustersPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalAdminClustersPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalAdminClustersPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.baremetaladmincluster) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalAdminClusters.patch" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalAdminClustersPatchCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates the parameters of a single bare metal admin cluster.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters/{bareMetalAdminClustersId}", + // "httpMethod": "PATCH", + // "id": "gkeonprem.projects.locations.bareMetalAdminClusters.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Immutable. The bare metal admin cluster resource name.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalAdminClusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Required. Field mask is used to specify the fields to be overwritten in the BareMetalAdminCluster resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all populated fields in the BareMetalAdminCluster message will be updated. Empty fields will be ignored unless a field mask is used.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // }, + // "validateOnly": { + // "description": "Validate the request without actually doing any updates.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "BareMetalAdminCluster" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalAdminClusters.queryVersionConfig": + +type ProjectsLocationsBareMetalAdminClustersQueryVersionConfigCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// QueryVersionConfig: Queries the bare metal admin cluster version +// config. +// +// - parent: The parent of the project and location to query for version +// config. Format: "projects/{project}/locations/{location}". +func (r *ProjectsLocationsBareMetalAdminClustersService) QueryVersionConfig(parent string) *ProjectsLocationsBareMetalAdminClustersQueryVersionConfigCall { + c := &ProjectsLocationsBareMetalAdminClustersQueryVersionConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// UpgradeConfigClusterName sets the optional parameter +// "upgradeConfig.clusterName": The admin cluster resource name. This is +// the full resource name of the admin cluster resource. Format: +// "projects/{project}/locations/{location}/bareMetalAdminClusters/{bare_ +// metal_admin_cluster}" +func (c *ProjectsLocationsBareMetalAdminClustersQueryVersionConfigCall) UpgradeConfigClusterName(upgradeConfigClusterName string) *ProjectsLocationsBareMetalAdminClustersQueryVersionConfigCall { + c.urlParams_.Set("upgradeConfig.clusterName", upgradeConfigClusterName) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBareMetalAdminClustersQueryVersionConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalAdminClustersQueryVersionConfigCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalAdminClustersQueryVersionConfigCall) Context(ctx context.Context) *ProjectsLocationsBareMetalAdminClustersQueryVersionConfigCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalAdminClustersQueryVersionConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalAdminClustersQueryVersionConfigCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/bareMetalAdminClusters:queryVersionConfig") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalAdminClusters.queryVersionConfig" call. +// Exactly one of *QueryBareMetalAdminVersionConfigResponse or error +// will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *QueryBareMetalAdminVersionConfigResponse.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 *ProjectsLocationsBareMetalAdminClustersQueryVersionConfigCall) Do(opts ...googleapi.CallOption) (*QueryBareMetalAdminVersionConfigResponse, 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 := &QueryBareMetalAdminVersionConfigResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Queries the bare metal admin cluster version config.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters:queryVersionConfig", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.bareMetalAdminClusters.queryVersionConfig", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The parent of the project and location to query for version config. Format: \"projects/{project}/locations/{location}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "upgradeConfig.clusterName": { + // "description": "The admin cluster resource name. This is the full resource name of the admin cluster resource. Format: \"projects/{project}/locations/{location}/bareMetalAdminClusters/{bare_metal_admin_cluster}\"", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/bareMetalAdminClusters:queryVersionConfig", + // "response": { + // "$ref": "QueryBareMetalAdminVersionConfigResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalAdminClusters.setIamPolicy": + +type ProjectsLocationsBareMetalAdminClustersSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - 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 *ProjectsLocationsBareMetalAdminClustersService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsBareMetalAdminClustersSetIamPolicyCall { + c := &ProjectsLocationsBareMetalAdminClustersSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBareMetalAdminClustersSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalAdminClustersSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalAdminClustersSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsBareMetalAdminClustersSetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalAdminClustersSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalAdminClustersSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalAdminClusters.setIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. 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 *ProjectsLocationsBareMetalAdminClustersSetIamPolicyCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters/{bareMetalAdminClustersId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.bareMetalAdminClusters.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalAdminClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalAdminClusters.testIamPermissions": + +type ProjectsLocationsBareMetalAdminClustersTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. +func (r *ProjectsLocationsBareMetalAdminClustersService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsBareMetalAdminClustersTestIamPermissionsCall { + c := &ProjectsLocationsBareMetalAdminClustersTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBareMetalAdminClustersTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalAdminClustersTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalAdminClustersTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsBareMetalAdminClustersTestIamPermissionsCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalAdminClustersTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalAdminClustersTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalAdminClusters.testIamPermissions" call. +// Exactly one of *TestIamPermissionsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.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 *ProjectsLocationsBareMetalAdminClustersTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, 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 := &TestIamPermissionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters/{bareMetalAdminClustersId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.bareMetalAdminClusters.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalAdminClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalAdminClusters.unenroll": + +type ProjectsLocationsBareMetalAdminClustersUnenrollCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Unenroll: Unenrolls an existing bare metal admin cluster from the +// Anthos On-Prem API within a given project and location. Unenrollment +// removes the Cloud reference to the cluster without modifying the +// underlying OnPrem Resources. Clusters will continue to run; however, +// they will no longer be accessible through the Anthos On-Prem API or +// its clients. +// +// - name: Name of the bare metal admin cluster to be unenrolled. +// Format: +// "projects/{project}/locations/{location}/bareMetalAdminClusters/{clu +// ster}". +func (r *ProjectsLocationsBareMetalAdminClustersService) Unenroll(name string) *ProjectsLocationsBareMetalAdminClustersUnenrollCall { + c := &ProjectsLocationsBareMetalAdminClustersUnenrollCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to +// true, and the bare metal admin cluster is not found, the request will +// succeed but no action will be taken on the server and return a +// completed LRO. +func (c *ProjectsLocationsBareMetalAdminClustersUnenrollCall) AllowMissing(allowMissing bool) *ProjectsLocationsBareMetalAdminClustersUnenrollCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// Etag sets the optional parameter "etag": The current etag of the bare +// metal admin cluster. If an etag is provided and does not match the +// current etag of the cluster, deletion will be blocked and an ABORTED +// error will be returned. +func (c *ProjectsLocationsBareMetalAdminClustersUnenrollCall) Etag(etag string) *ProjectsLocationsBareMetalAdminClustersUnenrollCall { + c.urlParams_.Set("etag", etag) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Validate the +// request without actually doing any updates. +func (c *ProjectsLocationsBareMetalAdminClustersUnenrollCall) ValidateOnly(validateOnly bool) *ProjectsLocationsBareMetalAdminClustersUnenrollCall { + 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 information. +func (c *ProjectsLocationsBareMetalAdminClustersUnenrollCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalAdminClustersUnenrollCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalAdminClustersUnenrollCall) Context(ctx context.Context) *ProjectsLocationsBareMetalAdminClustersUnenrollCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalAdminClustersUnenrollCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalAdminClustersUnenrollCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:unenroll") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalAdminClusters.unenroll" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalAdminClustersUnenrollCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Unenrolls an existing bare metal admin cluster from the Anthos On-Prem API within a given project and location. Unenrollment removes the Cloud reference to the cluster without modifying the underlying OnPrem Resources. Clusters will continue to run; however, they will no longer be accessible through the Anthos On-Prem API or its clients.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalAdminClusters/{bareMetalAdminClustersId}:unenroll", + // "httpMethod": "DELETE", + // "id": "gkeonprem.projects.locations.bareMetalAdminClusters.unenroll", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "allowMissing": { + // "description": "If set to true, and the bare metal admin cluster is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + // "location": "query", + // "type": "boolean" + // }, + // "etag": { + // "description": "The current etag of the bare metal admin cluster. If an etag is provided and does not match the current etag of the cluster, deletion will be blocked and an ABORTED error will be returned.", + // "location": "query", + // "type": "string" + // }, + // "name": { + // "description": "Required. Name of the bare metal admin cluster to be unenrolled. Format: \"projects/{project}/locations/{location}/bareMetalAdminClusters/{cluster}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalAdminClusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "Validate the request without actually doing any updates.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}:unenroll", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalAdminClusters.operations.get": + +type ProjectsLocationsBareMetalAdminClustersOperationsGetCall 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 *ProjectsLocationsBareMetalAdminClustersOperationsService) Get(name string) *ProjectsLocationsBareMetalAdminClustersOperationsGetCall { + c := &ProjectsLocationsBareMetalAdminClustersOperationsGetCall{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 information. +func (c *ProjectsLocationsBareMetalAdminClustersOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalAdminClustersOperationsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsBareMetalAdminClustersOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsBareMetalAdminClustersOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalAdminClustersOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsBareMetalAdminClustersOperationsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalAdminClustersOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalAdminClustersOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalAdminClusters.operations.get" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalAdminClustersOperationsGetCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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}/bareMetalAdminClusters/{bareMetalAdminClustersId}/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.bareMetalAdminClusters.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalAdminClusters/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalAdminClusters.operations.list": + +type ProjectsLocationsBareMetalAdminClustersOperationsListCall 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 *ProjectsLocationsBareMetalAdminClustersOperationsService) List(name string) *ProjectsLocationsBareMetalAdminClustersOperationsListCall { + c := &ProjectsLocationsBareMetalAdminClustersOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *ProjectsLocationsBareMetalAdminClustersOperationsListCall) Filter(filter string) *ProjectsLocationsBareMetalAdminClustersOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *ProjectsLocationsBareMetalAdminClustersOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsBareMetalAdminClustersOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *ProjectsLocationsBareMetalAdminClustersOperationsListCall) PageToken(pageToken string) *ProjectsLocationsBareMetalAdminClustersOperationsListCall { + 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 information. +func (c *ProjectsLocationsBareMetalAdminClustersOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalAdminClustersOperationsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsBareMetalAdminClustersOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsBareMetalAdminClustersOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalAdminClustersOperationsListCall) Context(ctx context.Context) *ProjectsLocationsBareMetalAdminClustersOperationsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalAdminClustersOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalAdminClustersOperationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalAdminClusters.operations.list" call. +// Exactly one of *ListOperationsResponse or error will be non-nil. 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 *ProjectsLocationsBareMetalAdminClustersOperationsListCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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}/bareMetalAdminClusters/{bareMetalAdminClustersId}/operations", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.bareMetalAdminClusters.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/[^/]+/bareMetalAdminClusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "pageSize": { + // "description": "The standard list page size.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The standard list page token.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}/operations", + // "response": { + // "$ref": "ListOperationsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsBareMetalAdminClustersOperationsListCall) Pages(ctx context.Context, f func(*ListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.create": + +type ProjectsLocationsBareMetalClustersCreateCall struct { + s *Service + parent string + baremetalcluster *BareMetalCluster + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new bare metal cluster in a given project and +// location. +// +// - parent: The parent of the project and location where the cluster is +// created in. Format: "projects/{project}/locations/{location}". +func (r *ProjectsLocationsBareMetalClustersService) Create(parent string, baremetalcluster *BareMetalCluster) *ProjectsLocationsBareMetalClustersCreateCall { + c := &ProjectsLocationsBareMetalClustersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.baremetalcluster = baremetalcluster + return c +} + +// BareMetalClusterId sets the optional parameter "bareMetalClusterId": +// Required. User provided identifier that is used as part of the +// resource name; must conform to RFC-1034 and additionally restrict to +// lower-cased letters. This comes out roughly to: /^a-z+[a-z0-9]$/ +func (c *ProjectsLocationsBareMetalClustersCreateCall) BareMetalClusterId(bareMetalClusterId string) *ProjectsLocationsBareMetalClustersCreateCall { + c.urlParams_.Set("bareMetalClusterId", bareMetalClusterId) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Validate the +// request without actually doing any updates. +func (c *ProjectsLocationsBareMetalClustersCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsBareMetalClustersCreateCall { + 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 information. +func (c *ProjectsLocationsBareMetalClustersCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersCreateCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.baremetalcluster) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/bareMetalClusters") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.create" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersCreateCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates a new bare metal cluster in a given project and location.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.bareMetalClusters.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "bareMetalClusterId": { + // "description": "Required. User provided identifier that is used as part of the resource name; must conform to RFC-1034 and additionally restrict to lower-cased letters. This comes out roughly to: /^a-z+[a-z0-9]$/", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The parent of the project and location where the cluster is created in. Format: \"projects/{project}/locations/{location}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "Validate the request without actually doing any updates.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+parent}/bareMetalClusters", + // "request": { + // "$ref": "BareMetalCluster" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.delete": + +type ProjectsLocationsBareMetalClustersDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a single bare metal Cluster. +// +// - name: Name of the bare metal user cluster to be deleted. Format: +// "projects/{project}/locations/{location}/bareMetalClusters/{bare_met +// al_cluster}". +func (r *ProjectsLocationsBareMetalClustersService) Delete(name string) *ProjectsLocationsBareMetalClustersDeleteCall { + c := &ProjectsLocationsBareMetalClustersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to +// true, and the bare metal cluster is not found, the request will +// succeed but no action will be taken on the server and return a +// completed LRO. +func (c *ProjectsLocationsBareMetalClustersDeleteCall) AllowMissing(allowMissing bool) *ProjectsLocationsBareMetalClustersDeleteCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// Etag sets the optional parameter "etag": The current etag of the bare +// metal Cluster. If an etag is provided and does not match the current +// etag of the cluster, deletion will be blocked and an ABORTED error +// will be returned. +func (c *ProjectsLocationsBareMetalClustersDeleteCall) Etag(etag string) *ProjectsLocationsBareMetalClustersDeleteCall { + c.urlParams_.Set("etag", etag) + return c +} + +// Force sets the optional parameter "force": If set to true, any node +// pools from the cluster will also be deleted. +func (c *ProjectsLocationsBareMetalClustersDeleteCall) Force(force bool) *ProjectsLocationsBareMetalClustersDeleteCall { + c.urlParams_.Set("force", fmt.Sprint(force)) + return c +} + +// IgnoreErrors sets the optional parameter "ignoreErrors": If set to +// true, the deletion of a bare metal user cluster resource will succeed +// even if errors occur during deletion. This parameter can be used when +// you want to delete GCP's cluster resource and the on-prem admin +// cluster that hosts your user cluster is disconnected / unreachable or +// deleted. WARNING: Using this parameter when your user cluster still +// exists may result in a deleted GCP user cluster but an existing +// on-prem user cluster. +func (c *ProjectsLocationsBareMetalClustersDeleteCall) IgnoreErrors(ignoreErrors bool) *ProjectsLocationsBareMetalClustersDeleteCall { + c.urlParams_.Set("ignoreErrors", fmt.Sprint(ignoreErrors)) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Validate the +// request without actually doing any updates. +func (c *ProjectsLocationsBareMetalClustersDeleteCall) ValidateOnly(validateOnly bool) *ProjectsLocationsBareMetalClustersDeleteCall { + 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 information. +func (c *ProjectsLocationsBareMetalClustersDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersDeleteCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.delete" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersDeleteCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Deletes a single bare metal Cluster.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}", + // "httpMethod": "DELETE", + // "id": "gkeonprem.projects.locations.bareMetalClusters.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "allowMissing": { + // "description": "If set to true, and the bare metal cluster is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + // "location": "query", + // "type": "boolean" + // }, + // "etag": { + // "description": "The current etag of the bare metal Cluster. If an etag is provided and does not match the current etag of the cluster, deletion will be blocked and an ABORTED error will be returned.", + // "location": "query", + // "type": "string" + // }, + // "force": { + // "description": "If set to true, any node pools from the cluster will also be deleted.", + // "location": "query", + // "type": "boolean" + // }, + // "ignoreErrors": { + // "description": "If set to true, the deletion of a bare metal user cluster resource will succeed even if errors occur during deletion. This parameter can be used when you want to delete GCP's cluster resource and the on-prem admin cluster that hosts your user cluster is disconnected / unreachable or deleted. WARNING: Using this parameter when your user cluster still exists may result in a deleted GCP user cluster but an existing on-prem user cluster.", + // "location": "query", + // "type": "boolean" + // }, + // "name": { + // "description": "Required. Name of the bare metal user cluster to be deleted. Format: \"projects/{project}/locations/{location}/bareMetalClusters/{bare_metal_cluster}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "Validate the request without actually doing any updates.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.enroll": + +type ProjectsLocationsBareMetalClustersEnrollCall struct { + s *Service + parent string + enrollbaremetalclusterrequest *EnrollBareMetalClusterRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Enroll: Enrolls an existing bare metal user cluster and its node +// pools to the Anthos On-Prem API within a given project and location. +// Through enrollment, an existing cluster will become Anthos On-Prem +// API managed. The corresponding GCP resources will be created and all +// future modifications to the cluster and/or its node pools will be +// expected to be performed through the API. +// +// - parent: The parent of the project and location where the cluster is +// enrolled in. Format: "projects/{project}/locations/{location}". +func (r *ProjectsLocationsBareMetalClustersService) Enroll(parent string, enrollbaremetalclusterrequest *EnrollBareMetalClusterRequest) *ProjectsLocationsBareMetalClustersEnrollCall { + c := &ProjectsLocationsBareMetalClustersEnrollCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.enrollbaremetalclusterrequest = enrollbaremetalclusterrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBareMetalClustersEnrollCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersEnrollCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersEnrollCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersEnrollCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersEnrollCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersEnrollCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.enrollbaremetalclusterrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/bareMetalClusters:enroll") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.enroll" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersEnrollCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Enrolls an existing bare metal user cluster and its node pools to the Anthos On-Prem API within a given project and location. Through enrollment, an existing cluster will become Anthos On-Prem API managed. The corresponding GCP resources will be created and all future modifications to the cluster and/or its node pools will be expected to be performed through the API.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters:enroll", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.bareMetalClusters.enroll", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The parent of the project and location where the cluster is enrolled in. Format: \"projects/{project}/locations/{location}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/bareMetalClusters:enroll", + // "request": { + // "$ref": "EnrollBareMetalClusterRequest" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.get": + +type ProjectsLocationsBareMetalClustersGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of a single bare metal Cluster. +// +// - name: Name of the bare metal user cluster to get. Format: +// "projects/{project}/locations/{location}/bareMetalClusters/{bare_met +// al_cluster}". +func (r *ProjectsLocationsBareMetalClustersService) Get(name string) *ProjectsLocationsBareMetalClustersGetCall { + c := &ProjectsLocationsBareMetalClustersGetCall{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 information. +func (c *ProjectsLocationsBareMetalClustersGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsBareMetalClustersGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsBareMetalClustersGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersGetCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.get" call. +// Exactly one of *BareMetalCluster or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *BareMetalCluster.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 *ProjectsLocationsBareMetalClustersGetCall) Do(opts ...googleapi.CallOption) (*BareMetalCluster, 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 := &BareMetalCluster{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets details of a single bare metal Cluster.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.bareMetalClusters.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Name of the bare metal user cluster to get. Format: \"projects/{project}/locations/{location}/bareMetalClusters/{bare_metal_cluster}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "BareMetalCluster" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.getIamPolicy": + +type ProjectsLocationsBareMetalClustersGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - 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 *ProjectsLocationsBareMetalClustersService) GetIamPolicy(resource string) *ProjectsLocationsBareMetalClustersGetIamPolicyCall { + c := &ProjectsLocationsBareMetalClustersGetIamPolicyCall{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 *ProjectsLocationsBareMetalClustersGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsBareMetalClustersGetIamPolicyCall { + 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 information. +func (c *ProjectsLocationsBareMetalClustersGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersGetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsBareMetalClustersGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsBareMetalClustersGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersGetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.getIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersGetIamPolicyCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.bareMetalClusters.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. 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).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.list": + +type ProjectsLocationsBareMetalClustersListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists bare metal clusters in a given project and location. +// +// - parent: The parent of the project and location where the clusters +// are listed in. Format: "projects/{project}/locations/{location}". +func (r *ProjectsLocationsBareMetalClustersService) List(parent string) *ProjectsLocationsBareMetalClustersListCall { + c := &ProjectsLocationsBareMetalClustersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": A resource filtering +// expression following https://google.aip.dev/160. When non-empty, only +// resource's whose attributes field matches the filter are returned. +func (c *ProjectsLocationsBareMetalClustersListCall) Filter(filter string) *ProjectsLocationsBareMetalClustersListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": Requested page size. +// Server may return fewer items than requested. If unspecified, at most +// 50 clusters will be returned. The maximum value is 1000; values above +// 1000 will be coerced to 1000. +func (c *ProjectsLocationsBareMetalClustersListCall) PageSize(pageSize int64) *ProjectsLocationsBareMetalClustersListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A token +// identifying a page of results the server should return. +func (c *ProjectsLocationsBareMetalClustersListCall) PageToken(pageToken string) *ProjectsLocationsBareMetalClustersListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// View sets the optional parameter "view": View for bare metal +// Clusters. When `BASIC` is specified, only the cluster resource name +// and admin cluster membership are returned. The default/unset value +// `CLUSTER_VIEW_UNSPECIFIED` is the same as `FULL', which returns the +// complete cluster configuration details. +// +// Possible values: +// +// "CLUSTER_VIEW_UNSPECIFIED" - If the value is not set, the default +// +// `FULL` view is used. +// +// "BASIC" - Includes basic information of a cluster resource +// +// including cluster resource name and admin cluster membership. +// +// "FULL" - Includes the complete configuration for bare metal cluster +// +// resource. This is the default value for ListBareMetalClustersRequest +// method. +func (c *ProjectsLocationsBareMetalClustersListCall) View(view string) *ProjectsLocationsBareMetalClustersListCall { + c.urlParams_.Set("view", view) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBareMetalClustersListCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsBareMetalClustersListCall) IfNoneMatch(entityTag string) *ProjectsLocationsBareMetalClustersListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersListCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/bareMetalClusters") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.list" call. +// Exactly one of *ListBareMetalClustersResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *ListBareMetalClustersResponse.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 *ProjectsLocationsBareMetalClustersListCall) Do(opts ...googleapi.CallOption) (*ListBareMetalClustersResponse, 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 := &ListBareMetalClustersResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists bare metal clusters in a given project and location.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.bareMetalClusters.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "filter": { + // "description": "A resource filtering expression following https://google.aip.dev/160. When non-empty, only resource's whose attributes field matches the filter are returned.", + // "location": "query", + // "type": "string" + // }, + // "pageSize": { + // "description": "Requested page size. Server may return fewer items than requested. If unspecified, at most 50 clusters will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "A token identifying a page of results the server should return.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The parent of the project and location where the clusters are listed in. Format: \"projects/{project}/locations/{location}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "view": { + // "description": "View for bare metal Clusters. When `BASIC` is specified, only the cluster resource name and admin cluster membership are returned. The default/unset value `CLUSTER_VIEW_UNSPECIFIED` is the same as `FULL', which returns the complete cluster configuration details.", + // "enum": [ + // "CLUSTER_VIEW_UNSPECIFIED", + // "BASIC", + // "FULL" + // ], + // "enumDescriptions": [ + // "If the value is not set, the default `FULL` view is used.", + // "Includes basic information of a cluster resource including cluster resource name and admin cluster membership.", + // "Includes the complete configuration for bare metal cluster resource. This is the default value for ListBareMetalClustersRequest method." + // ], + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/bareMetalClusters", + // "response": { + // "$ref": "ListBareMetalClustersResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsBareMetalClustersListCall) Pages(ctx context.Context, f func(*ListBareMetalClustersResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.patch": + +type ProjectsLocationsBareMetalClustersPatchCall struct { + s *Service + name string + baremetalcluster *BareMetalCluster + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the parameters of a single bare metal Cluster. +// +// - name: Immutable. The bare metal user cluster resource name. +func (r *ProjectsLocationsBareMetalClustersService) Patch(name string, baremetalcluster *BareMetalCluster) *ProjectsLocationsBareMetalClustersPatchCall { + c := &ProjectsLocationsBareMetalClustersPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.baremetalcluster = baremetalcluster + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to +// true, and the bare metal cluster is not found, the request will +// create a new bare metal cluster with the provided configuration. The +// user must have both create and update permission to call Update with +// allow_missing set to true. +func (c *ProjectsLocationsBareMetalClustersPatchCall) AllowMissing(allowMissing bool) *ProjectsLocationsBareMetalClustersPatchCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Field +// mask is used to specify the fields to be overwritten in the +// BareMetalCluster resource by the update. The fields specified in the +// update_mask are relative to the resource, not the full request. A +// field will be overwritten if it is in the mask. If the user does not +// provide a mask then all populated fields in the BareMetalCluster +// message will be updated. Empty fields will be ignored unless a field +// mask is used. +func (c *ProjectsLocationsBareMetalClustersPatchCall) UpdateMask(updateMask string) *ProjectsLocationsBareMetalClustersPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Validate the +// request without actually doing any updates. +func (c *ProjectsLocationsBareMetalClustersPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsBareMetalClustersPatchCall { + 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 information. +func (c *ProjectsLocationsBareMetalClustersPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersPatchCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.baremetalcluster) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.patch" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersPatchCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates the parameters of a single bare metal Cluster.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}", + // "httpMethod": "PATCH", + // "id": "gkeonprem.projects.locations.bareMetalClusters.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "allowMissing": { + // "description": "If set to true, and the bare metal cluster is not found, the request will create a new bare metal cluster with the provided configuration. The user must have both create and update permission to call Update with allow_missing set to true.", + // "location": "query", + // "type": "boolean" + // }, + // "name": { + // "description": "Immutable. The bare metal user cluster resource name.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Required. Field mask is used to specify the fields to be overwritten in the BareMetalCluster resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all populated fields in the BareMetalCluster message will be updated. Empty fields will be ignored unless a field mask is used.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // }, + // "validateOnly": { + // "description": "Validate the request without actually doing any updates.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "BareMetalCluster" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.queryVersionConfig": + +type ProjectsLocationsBareMetalClustersQueryVersionConfigCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// QueryVersionConfig: Queries the bare metal user cluster version +// config. +// +// - parent: The parent of the project and location to query for version +// config. Format: "projects/{project}/locations/{location}". +func (r *ProjectsLocationsBareMetalClustersService) QueryVersionConfig(parent string) *ProjectsLocationsBareMetalClustersQueryVersionConfigCall { + c := &ProjectsLocationsBareMetalClustersQueryVersionConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// CreateConfigAdminClusterMembership sets the optional parameter +// "createConfig.adminClusterMembership": The admin cluster membership. +// This is the full resource name of the admin cluster's fleet +// membership. Format: +// "projects/{project}/locations/{location}/memberships/{membership}" +func (c *ProjectsLocationsBareMetalClustersQueryVersionConfigCall) CreateConfigAdminClusterMembership(createConfigAdminClusterMembership string) *ProjectsLocationsBareMetalClustersQueryVersionConfigCall { + c.urlParams_.Set("createConfig.adminClusterMembership", createConfigAdminClusterMembership) + return c +} + +// CreateConfigAdminClusterName sets the optional parameter +// "createConfig.adminClusterName": The admin cluster resource name. +// This is the full resource name of the admin cluster resource. Format: +// "projects/{project}/locations/{location}/bareMetalAdminClusters/{bare_ +// metal_admin_cluster}" +func (c *ProjectsLocationsBareMetalClustersQueryVersionConfigCall) CreateConfigAdminClusterName(createConfigAdminClusterName string) *ProjectsLocationsBareMetalClustersQueryVersionConfigCall { + c.urlParams_.Set("createConfig.adminClusterName", createConfigAdminClusterName) + return c +} + +// UpgradeConfigClusterName sets the optional parameter +// "upgradeConfig.clusterName": The user cluster resource name. This is +// the full resource name of the user cluster resource. Format: +// "projects/{project}/locations/{location}/bareMetalClusters/{bare_metal +// _cluster}" +func (c *ProjectsLocationsBareMetalClustersQueryVersionConfigCall) UpgradeConfigClusterName(upgradeConfigClusterName string) *ProjectsLocationsBareMetalClustersQueryVersionConfigCall { + c.urlParams_.Set("upgradeConfig.clusterName", upgradeConfigClusterName) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBareMetalClustersQueryVersionConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersQueryVersionConfigCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersQueryVersionConfigCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersQueryVersionConfigCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersQueryVersionConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersQueryVersionConfigCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/bareMetalClusters:queryVersionConfig") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.queryVersionConfig" call. +// Exactly one of *QueryBareMetalVersionConfigResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *QueryBareMetalVersionConfigResponse.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 *ProjectsLocationsBareMetalClustersQueryVersionConfigCall) Do(opts ...googleapi.CallOption) (*QueryBareMetalVersionConfigResponse, 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 := &QueryBareMetalVersionConfigResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Queries the bare metal user cluster version config.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters:queryVersionConfig", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.bareMetalClusters.queryVersionConfig", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "createConfig.adminClusterMembership": { + // "description": "The admin cluster membership. This is the full resource name of the admin cluster's fleet membership. Format: \"projects/{project}/locations/{location}/memberships/{membership}\"", + // "location": "query", + // "type": "string" + // }, + // "createConfig.adminClusterName": { + // "description": "The admin cluster resource name. This is the full resource name of the admin cluster resource. Format: \"projects/{project}/locations/{location}/bareMetalAdminClusters/{bare_metal_admin_cluster}\"", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The parent of the project and location to query for version config. Format: \"projects/{project}/locations/{location}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "upgradeConfig.clusterName": { + // "description": "The user cluster resource name. This is the full resource name of the user cluster resource. Format: \"projects/{project}/locations/{location}/bareMetalClusters/{bare_metal_cluster}\"", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/bareMetalClusters:queryVersionConfig", + // "response": { + // "$ref": "QueryBareMetalVersionConfigResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.setIamPolicy": + +type ProjectsLocationsBareMetalClustersSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - 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 *ProjectsLocationsBareMetalClustersService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsBareMetalClustersSetIamPolicyCall { + c := &ProjectsLocationsBareMetalClustersSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBareMetalClustersSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersSetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.setIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersSetIamPolicyCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.bareMetalClusters.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.testIamPermissions": + +type ProjectsLocationsBareMetalClustersTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. +func (r *ProjectsLocationsBareMetalClustersService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsBareMetalClustersTestIamPermissionsCall { + c := &ProjectsLocationsBareMetalClustersTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBareMetalClustersTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersTestIamPermissionsCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.testIamPermissions" call. +// Exactly one of *TestIamPermissionsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.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 *ProjectsLocationsBareMetalClustersTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, 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 := &TestIamPermissionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.bareMetalClusters.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.unenroll": + +type ProjectsLocationsBareMetalClustersUnenrollCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Unenroll: Unenrolls an existing bare metal user cluster and its node +// pools from the Anthos On-Prem API within a given project and +// location. Unenrollment removes the Cloud reference to the cluster +// without modifying the underlying OnPrem Resources. Clusters and node +// pools will continue to run; however, they will no longer be +// accessible through the Anthos On-Prem API or its clients. +// +// - name: Name of the bare metal user cluster to be unenrolled. Format: +// "projects/{project}/locations/{location}/bareMetalClusters/{cluster} +// ". +func (r *ProjectsLocationsBareMetalClustersService) Unenroll(name string) *ProjectsLocationsBareMetalClustersUnenrollCall { + c := &ProjectsLocationsBareMetalClustersUnenrollCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to +// true, and the bare metal cluster is not found, the request will +// succeed but no action will be taken on the server and return a +// completed LRO. +func (c *ProjectsLocationsBareMetalClustersUnenrollCall) AllowMissing(allowMissing bool) *ProjectsLocationsBareMetalClustersUnenrollCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// Etag sets the optional parameter "etag": The current etag of the bare +// metal Cluster. If an etag is provided and does not match the current +// etag of the cluster, deletion will be blocked and an ABORTED error +// will be returned. +func (c *ProjectsLocationsBareMetalClustersUnenrollCall) Etag(etag string) *ProjectsLocationsBareMetalClustersUnenrollCall { + c.urlParams_.Set("etag", etag) + return c +} + +// Force sets the optional parameter "force": This is required if the +// cluster has any associated node pools. When set, any child node pools +// will also be unenrolled. +func (c *ProjectsLocationsBareMetalClustersUnenrollCall) Force(force bool) *ProjectsLocationsBareMetalClustersUnenrollCall { + c.urlParams_.Set("force", fmt.Sprint(force)) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Validate the +// request without actually doing any updates. +func (c *ProjectsLocationsBareMetalClustersUnenrollCall) ValidateOnly(validateOnly bool) *ProjectsLocationsBareMetalClustersUnenrollCall { + 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 information. +func (c *ProjectsLocationsBareMetalClustersUnenrollCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersUnenrollCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersUnenrollCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersUnenrollCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersUnenrollCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersUnenrollCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:unenroll") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.unenroll" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersUnenrollCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Unenrolls an existing bare metal user cluster and its node pools from the Anthos On-Prem API within a given project and location. Unenrollment removes the Cloud reference to the cluster without modifying the underlying OnPrem Resources. Clusters and node pools will continue to run; however, they will no longer be accessible through the Anthos On-Prem API or its clients.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}:unenroll", + // "httpMethod": "DELETE", + // "id": "gkeonprem.projects.locations.bareMetalClusters.unenroll", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "allowMissing": { + // "description": "If set to true, and the bare metal cluster is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + // "location": "query", + // "type": "boolean" + // }, + // "etag": { + // "description": "The current etag of the bare metal Cluster. If an etag is provided and does not match the current etag of the cluster, deletion will be blocked and an ABORTED error will be returned.", + // "location": "query", + // "type": "string" + // }, + // "force": { + // "description": "This is required if the cluster has any associated node pools. When set, any child node pools will also be unenrolled.", + // "location": "query", + // "type": "boolean" + // }, + // "name": { + // "description": "Required. Name of the bare metal user cluster to be unenrolled. Format: \"projects/{project}/locations/{location}/bareMetalClusters/{cluster}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "Validate the request without actually doing any updates.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}:unenroll", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.create": + +type ProjectsLocationsBareMetalClustersBareMetalNodePoolsCreateCall struct { + s *Service + parent string + baremetalnodepool *BareMetalNodePool + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new bare metal node pool in a given project, +// location and Bare Metal cluster. +// +// - parent: The parent resource where this node pool will be created. +// projects/{project}/locations/{location}/bareMetalClusters/{cluster}. +func (r *ProjectsLocationsBareMetalClustersBareMetalNodePoolsService) Create(parent string, baremetalnodepool *BareMetalNodePool) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsCreateCall { + c := &ProjectsLocationsBareMetalClustersBareMetalNodePoolsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.baremetalnodepool = baremetalnodepool + return c +} + +// BareMetalNodePoolId sets the optional parameter +// "bareMetalNodePoolId": The ID to use for the node pool, which will +// become the final component of the node pool's resource name. This +// value must be up to 63 characters, and valid characters are /a-z-/. +// The value must not be permitted to be a UUID (or UUID-like: anything +// matching /^[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i). +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsCreateCall) BareMetalNodePoolId(bareMetalNodePoolId string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsCreateCall { + c.urlParams_.Set("bareMetalNodePoolId", bareMetalNodePoolId) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, only +// validate the request, but do not actually create the node pool. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsCreateCall { + 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 information. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsCreateCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.baremetalnodepool) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/bareMetalNodePools") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.create" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsCreateCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates a new bare metal node pool in a given project, location and Bare Metal cluster.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "bareMetalNodePoolId": { + // "description": "The ID to use for the node pool, which will become the final component of the node pool's resource name. This value must be up to 63 characters, and valid characters are /a-z-/. The value must not be permitted to be a UUID (or UUID-like: anything matching /^[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i).", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The parent resource where this node pool will be created. projects/{project}/locations/{location}/bareMetalClusters/{cluster}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "If set, only validate the request, but do not actually create the node pool.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+parent}/bareMetalNodePools", + // "request": { + // "$ref": "BareMetalNodePool" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.delete": + +type ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a single bare metal node pool. +// +// - name: The name of the node pool to delete. Format: +// projects/{project}/locations/{location}/bareMetalClusters/{cluster}/ +// bareMetalNodePools/{nodepool}. +func (r *ProjectsLocationsBareMetalClustersBareMetalNodePoolsService) Delete(name string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall { + c := &ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to +// true, and the bare metal node pool is not found, the request will +// succeed but no action will be taken on the server and return a +// completed LRO. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall) AllowMissing(allowMissing bool) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// Etag sets the optional parameter "etag": The current etag of the +// BareMetalNodePool. If an etag is provided and does not match the +// current etag of the node pool, deletion will be blocked and an +// ABORTED error will be returned. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall) Etag(etag string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall { + c.urlParams_.Set("etag", etag) + return c +} + +// IgnoreErrors sets the optional parameter "ignoreErrors": If set to +// true, the deletion of a bare metal node pool resource will succeed +// even if errors occur during deletion. This parameter can be used when +// you want to delete GCP's node pool resource and you've already +// deleted the on-prem admin cluster that hosted your node pool. +// WARNING: Using this parameter when your user cluster still exists may +// result in a deleted GCP node pool but an existing on-prem node pool. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall) IgnoreErrors(ignoreErrors bool) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall { + c.urlParams_.Set("ignoreErrors", fmt.Sprint(ignoreErrors)) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, only +// validate the request, but do not actually delete the node pool. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall) ValidateOnly(validateOnly bool) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall { + 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 information. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.delete" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsDeleteCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Deletes a single bare metal node pool.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}", + // "httpMethod": "DELETE", + // "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "allowMissing": { + // "description": "If set to true, and the bare metal node pool is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + // "location": "query", + // "type": "boolean" + // }, + // "etag": { + // "description": "The current etag of the BareMetalNodePool. If an etag is provided and does not match the current etag of the node pool, deletion will be blocked and an ABORTED error will be returned.", + // "location": "query", + // "type": "string" + // }, + // "ignoreErrors": { + // "description": "If set to true, the deletion of a bare metal node pool resource will succeed even if errors occur during deletion. This parameter can be used when you want to delete GCP's node pool resource and you've already deleted the on-prem admin cluster that hosted your node pool. WARNING: Using this parameter when your user cluster still exists may result in a deleted GCP node pool but an existing on-prem node pool.", + // "location": "query", + // "type": "boolean" + // }, + // "name": { + // "description": "Required. The name of the node pool to delete. Format: projects/{project}/locations/{location}/bareMetalClusters/{cluster}/bareMetalNodePools/{nodepool}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "If set, only validate the request, but do not actually delete the node pool.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.enroll": + +type ProjectsLocationsBareMetalClustersBareMetalNodePoolsEnrollCall struct { + s *Service + parent string + enrollbaremetalnodepoolrequest *EnrollBareMetalNodePoolRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Enroll: Enrolls an existing bare metal node pool to the Anthos +// On-Prem API within a given project and location. Through enrollment, +// an existing node pool will become Anthos On-Prem API managed. The +// corresponding GCP resources will be created. +// +// - parent: The parent resource where this node pool will be created. +// projects/{project}/locations/{location}/bareMetalClusters/{cluster}. +func (r *ProjectsLocationsBareMetalClustersBareMetalNodePoolsService) Enroll(parent string, enrollbaremetalnodepoolrequest *EnrollBareMetalNodePoolRequest) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsEnrollCall { + c := &ProjectsLocationsBareMetalClustersBareMetalNodePoolsEnrollCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.enrollbaremetalnodepoolrequest = enrollbaremetalnodepoolrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsEnrollCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsEnrollCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsEnrollCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsEnrollCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsEnrollCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsEnrollCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.enrollbaremetalnodepoolrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/bareMetalNodePools:enroll") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.enroll" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsEnrollCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Enrolls an existing bare metal node pool to the Anthos On-Prem API within a given project and location. Through enrollment, an existing node pool will become Anthos On-Prem API managed. The corresponding GCP resources will be created.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools:enroll", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.enroll", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The parent resource where this node pool will be created. projects/{project}/locations/{location}/bareMetalClusters/{cluster}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/bareMetalNodePools:enroll", + // "request": { + // "$ref": "EnrollBareMetalNodePoolRequest" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.get": + +type ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of a single bare metal node pool. +// +// - name: The name of the node pool to retrieve. +// projects/{project}/locations/{location}/bareMetalClusters/{cluster}/ +// bareMetalNodePools/{nodepool}. +func (r *ProjectsLocationsBareMetalClustersBareMetalNodePoolsService) Get(name string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetCall { + c := &ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetCall{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 information. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.get" call. +// Exactly one of *BareMetalNodePool or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *BareMetalNodePool.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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetCall) Do(opts ...googleapi.CallOption) (*BareMetalNodePool, 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 := &BareMetalNodePool{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets details of a single bare metal node pool.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The name of the node pool to retrieve. projects/{project}/locations/{location}/bareMetalClusters/{cluster}/bareMetalNodePools/{nodepool}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "BareMetalNodePool" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.getIamPolicy": + +type ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - 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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsService) GetIamPolicy(resource string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetIamPolicyCall { + c := &ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetIamPolicyCall{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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetIamPolicyCall { + 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 information. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.getIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsGetIamPolicyCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. 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).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.list": + +type ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists bare metal node pools in a given project, location and +// bare metal cluster. +// +// - parent: The parent, which owns this collection of node pools. +// Format: +// projects/{project}/locations/{location}/bareMetalClusters/{bareMetal +// Cluster}. +func (r *ProjectsLocationsBareMetalClustersBareMetalNodePoolsService) List(parent string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall { + c := &ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number +// of node pools to return. The service may return fewer than this +// value. If unspecified, at most 50 node pools will be returned. The +// maximum value is 1000; values above 1000 will be coerced to 1000. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall) PageSize(pageSize int64) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, +// received from a previous `ListBareMetalNodePools` call. Provide this +// to retrieve the subsequent page. When paginating, all other +// parameters provided to `ListBareMetalNodePools` must match the call +// that provided the page token. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall) PageToken(pageToken string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall { + 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 information. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/bareMetalNodePools") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.list" call. +// Exactly one of *ListBareMetalNodePoolsResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *ListBareMetalNodePoolsResponse.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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall) Do(opts ...googleapi.CallOption) (*ListBareMetalNodePoolsResponse, 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 := &ListBareMetalNodePoolsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists bare metal node pools in a given project, location and bare metal cluster.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "The maximum number of node pools to return. The service may return fewer than this value. If unspecified, at most 50 node pools will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "A page token, received from a previous `ListBareMetalNodePools` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListBareMetalNodePools` must match the call that provided the page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The parent, which owns this collection of node pools. Format: projects/{project}/locations/{location}/bareMetalClusters/{bareMetalCluster}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/bareMetalNodePools", + // "response": { + // "$ref": "ListBareMetalNodePoolsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsListCall) Pages(ctx context.Context, f func(*ListBareMetalNodePoolsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.patch": + +type ProjectsLocationsBareMetalClustersBareMetalNodePoolsPatchCall struct { + s *Service + name string + baremetalnodepool *BareMetalNodePool + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the parameters of a single bare metal node pool. +// +// - name: Immutable. The bare metal node pool resource name. +func (r *ProjectsLocationsBareMetalClustersBareMetalNodePoolsService) Patch(name string, baremetalnodepool *BareMetalNodePool) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsPatchCall { + c := &ProjectsLocationsBareMetalClustersBareMetalNodePoolsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.baremetalnodepool = baremetalnodepool + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Field +// mask is used to specify the fields to be overwritten in the +// BareMetalNodePool resource by the update. The fields specified in the +// update_mask are relative to the resource, not the full request. A +// field will be overwritten if it is in the mask. If the user does not +// provide a mask then all populated fields in the BareMetalNodePool +// message will be updated. Empty fields will be ignored unless a field +// mask is used. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Validate the +// request without actually doing any updates. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsPatchCall { + 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 information. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsPatchCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.baremetalnodepool) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.patch" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsPatchCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates the parameters of a single bare metal node pool.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}", + // "httpMethod": "PATCH", + // "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Immutable. The bare metal node pool resource name.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Required. Field mask is used to specify the fields to be overwritten in the BareMetalNodePool resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all populated fields in the BareMetalNodePool message will be updated. Empty fields will be ignored unless a field mask is used.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // }, + // "validateOnly": { + // "description": "Validate the request without actually doing any updates.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "BareMetalNodePool" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.setIamPolicy": + +type ProjectsLocationsBareMetalClustersBareMetalNodePoolsSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - 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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsSetIamPolicyCall { + c := &ProjectsLocationsBareMetalClustersBareMetalNodePoolsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsSetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.setIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsSetIamPolicyCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.testIamPermissions": + +type ProjectsLocationsBareMetalClustersBareMetalNodePoolsTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. +func (r *ProjectsLocationsBareMetalClustersBareMetalNodePoolsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsTestIamPermissionsCall { + c := &ProjectsLocationsBareMetalClustersBareMetalNodePoolsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsTestIamPermissionsCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.testIamPermissions" call. +// Exactly one of *TestIamPermissionsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, 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 := &TestIamPermissionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.unenroll": + +type ProjectsLocationsBareMetalClustersBareMetalNodePoolsUnenrollCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Unenroll: Unenrolls a bare metal node pool from Anthos On-Prem API. +// +// - name: The name of the node pool to unenroll. Format: +// projects/{project}/locations/{location}/bareMetalClusters/{cluster}/ +// bareMetalNodePools/{nodepool}. +func (r *ProjectsLocationsBareMetalClustersBareMetalNodePoolsService) Unenroll(name string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsUnenrollCall { + c := &ProjectsLocationsBareMetalClustersBareMetalNodePoolsUnenrollCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to +// true, and the bare metal node pool is not found, the request will +// succeed but no action will be taken on the server and return a +// completed LRO. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsUnenrollCall) AllowMissing(allowMissing bool) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsUnenrollCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// Etag sets the optional parameter "etag": The current etag of the bare +// metal node pool. If an etag is provided and does not match the +// current etag of node pool, deletion will be blocked and an ABORTED +// error will be returned. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsUnenrollCall) Etag(etag string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsUnenrollCall { + c.urlParams_.Set("etag", etag) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, only +// validate the request, but do not actually unenroll the node pool. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsUnenrollCall) ValidateOnly(validateOnly bool) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsUnenrollCall { + 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 information. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsUnenrollCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsUnenrollCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsUnenrollCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsUnenrollCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsUnenrollCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsUnenrollCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:unenroll") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.unenroll" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsUnenrollCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Unenrolls a bare metal node pool from Anthos On-Prem API.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}:unenroll", + // "httpMethod": "DELETE", + // "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.unenroll", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "allowMissing": { + // "description": "If set to true, and the bare metal node pool is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + // "location": "query", + // "type": "boolean" + // }, + // "etag": { + // "description": "The current etag of the bare metal node pool. If an etag is provided and does not match the current etag of node pool, deletion will be blocked and an ABORTED error will be returned.", + // "location": "query", + // "type": "string" + // }, + // "name": { + // "description": "Required. The name of the node pool to unenroll. Format: projects/{project}/locations/{location}/bareMetalClusters/{cluster}/bareMetalNodePools/{nodepool}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "If set, only validate the request, but do not actually unenroll the node pool.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}:unenroll", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.operations.get": + +type ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsGetCall 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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsService) Get(name string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsGetCall { + c := &ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsGetCall{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 information. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.operations.get" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsGetCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.operations.list": + +type ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall 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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsService) List(name string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall { + c := &ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall) Filter(filter string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall) PageToken(pageToken string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall { + 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 information. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.operations.list" call. +// Exactly one of *ListOperationsResponse or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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}/bareMetalClusters/{bareMetalClustersId}/bareMetalNodePools/{bareMetalNodePoolsId}/operations", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.bareMetalClusters.bareMetalNodePools.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/[^/]+/bareMetalClusters/[^/]+/bareMetalNodePools/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "pageSize": { + // "description": "The standard list page size.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The standard list page token.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}/operations", + // "response": { + // "$ref": "ListOperationsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsBareMetalClustersBareMetalNodePoolsOperationsListCall) Pages(ctx context.Context, f func(*ListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.operations.get": + +type ProjectsLocationsBareMetalClustersOperationsGetCall 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 *ProjectsLocationsBareMetalClustersOperationsService) Get(name string) *ProjectsLocationsBareMetalClustersOperationsGetCall { + c := &ProjectsLocationsBareMetalClustersOperationsGetCall{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 information. +func (c *ProjectsLocationsBareMetalClustersOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersOperationsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsBareMetalClustersOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsBareMetalClustersOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersOperationsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.operations.get" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersOperationsGetCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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}/bareMetalClusters/{bareMetalClustersId}/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.bareMetalClusters.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/bareMetalClusters/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.bareMetalClusters.operations.list": + +type ProjectsLocationsBareMetalClustersOperationsListCall 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 *ProjectsLocationsBareMetalClustersOperationsService) List(name string) *ProjectsLocationsBareMetalClustersOperationsListCall { + c := &ProjectsLocationsBareMetalClustersOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *ProjectsLocationsBareMetalClustersOperationsListCall) Filter(filter string) *ProjectsLocationsBareMetalClustersOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *ProjectsLocationsBareMetalClustersOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsBareMetalClustersOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *ProjectsLocationsBareMetalClustersOperationsListCall) PageToken(pageToken string) *ProjectsLocationsBareMetalClustersOperationsListCall { + 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 information. +func (c *ProjectsLocationsBareMetalClustersOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsBareMetalClustersOperationsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsBareMetalClustersOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsBareMetalClustersOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsBareMetalClustersOperationsListCall) Context(ctx context.Context) *ProjectsLocationsBareMetalClustersOperationsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsBareMetalClustersOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBareMetalClustersOperationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.bareMetalClusters.operations.list" call. +// Exactly one of *ListOperationsResponse or error will be non-nil. 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 *ProjectsLocationsBareMetalClustersOperationsListCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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}/bareMetalClusters/{bareMetalClustersId}/operations", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.bareMetalClusters.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/[^/]+/bareMetalClusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "pageSize": { + // "description": "The standard list page size.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The standard list page token.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}/operations", + // "response": { + // "$ref": "ListOperationsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsBareMetalClustersOperationsListCall) Pages(ctx context.Context, f func(*ListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "gkeonprem.projects.locations.operations.cancel": + +type ProjectsLocationsOperationsCancelCall struct { + s *Service + name string + canceloperationrequest *CancelOperationRequest + 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, canceloperationrequest *CancelOperationRequest) *ProjectsLocationsOperationsCancelCall { + c := &ProjectsLocationsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.canceloperationrequest = canceloperationrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +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. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsOperationsCancelCall) Context(ctx context.Context) *ProjectsLocationsOperationsCancelCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP 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 := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.canceloperationrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.operations.cancel" call. +// Exactly one of *Empty or error will be non-nil. 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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": "gkeonprem.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", + // "request": { + // "$ref": "CancelOperationRequest" + // }, + // "response": { + // "$ref": "Empty" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.operations.delete": + +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 information. +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. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsOperationsDeleteCall) Context(ctx context.Context) *ProjectsLocationsOperationsDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP 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 := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.operations.delete" call. +// Exactly one of *Empty or error will be non-nil. 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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": "gkeonprem.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" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.operations.get": + +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 information. +func (c *ProjectsLocationsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +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. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsOperationsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP 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 := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.operations.get" call. +// Exactly one of *Operation or error will be non-nil. 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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": "gkeonprem.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" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.operations.list": + +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 +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +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. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsOperationsListCall) Context(ctx context.Context) *ProjectsLocationsOperationsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP 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 := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.operations.list" call. +// Exactly one of *ListOperationsResponse or error will be non-nil. 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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": "gkeonprem.projects.locations.operations.list", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "filter": { + // "description": "The standard list filter.", + // "location": "query", + // "type": "string" + // }, + // "name": { + // "description": "The name of the operation's parent resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "pageSize": { + // "description": "The standard list page size.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The standard list page token.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}/operations", + // "response": { + // "$ref": "ListOperationsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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")) // reset paging to original point + 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) + } +} + +// method id "gkeonprem.projects.locations.vmwareAdminClusters.enroll": + +type ProjectsLocationsVmwareAdminClustersEnrollCall struct { + s *Service + parent string + enrollvmwareadminclusterrequest *EnrollVmwareAdminClusterRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Enroll: Enrolls an existing VMware admin cluster to the Anthos +// On-Prem API within a given project and location. Through enrollment, +// an existing admin cluster will become Anthos On-Prem API managed. The +// corresponding GCP resources will be created and all future +// modifications to the cluster will be expected to be performed through +// the API. +// +// - parent: The parent of the project and location where the cluster is +// enrolled in. Format: "projects/{project}/locations/{location}". +func (r *ProjectsLocationsVmwareAdminClustersService) Enroll(parent string, enrollvmwareadminclusterrequest *EnrollVmwareAdminClusterRequest) *ProjectsLocationsVmwareAdminClustersEnrollCall { + c := &ProjectsLocationsVmwareAdminClustersEnrollCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.enrollvmwareadminclusterrequest = enrollvmwareadminclusterrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsVmwareAdminClustersEnrollCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareAdminClustersEnrollCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareAdminClustersEnrollCall) Context(ctx context.Context) *ProjectsLocationsVmwareAdminClustersEnrollCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareAdminClustersEnrollCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareAdminClustersEnrollCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.enrollvmwareadminclusterrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/vmwareAdminClusters:enroll") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareAdminClusters.enroll" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsVmwareAdminClustersEnrollCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Enrolls an existing VMware admin cluster to the Anthos On-Prem API within a given project and location. Through enrollment, an existing admin cluster will become Anthos On-Prem API managed. The corresponding GCP resources will be created and all future modifications to the cluster will be expected to be performed through the API.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareAdminClusters:enroll", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.vmwareAdminClusters.enroll", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The parent of the project and location where the cluster is enrolled in. Format: \"projects/{project}/locations/{location}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/vmwareAdminClusters:enroll", + // "request": { + // "$ref": "EnrollVmwareAdminClusterRequest" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareAdminClusters.get": + +type ProjectsLocationsVmwareAdminClustersGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of a single VMware admin cluster. +// +// - name: Name of the VMware admin cluster to be returned. Format: +// "projects/{project}/locations/{location}/vmwareAdminClusters/{vmware +// _admin_cluster}". +func (r *ProjectsLocationsVmwareAdminClustersService) Get(name string) *ProjectsLocationsVmwareAdminClustersGetCall { + c := &ProjectsLocationsVmwareAdminClustersGetCall{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 information. +func (c *ProjectsLocationsVmwareAdminClustersGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareAdminClustersGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsVmwareAdminClustersGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsVmwareAdminClustersGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareAdminClustersGetCall) Context(ctx context.Context) *ProjectsLocationsVmwareAdminClustersGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareAdminClustersGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareAdminClustersGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareAdminClusters.get" call. +// Exactly one of *VmwareAdminCluster or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *VmwareAdminCluster.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 *ProjectsLocationsVmwareAdminClustersGetCall) Do(opts ...googleapi.CallOption) (*VmwareAdminCluster, 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 := &VmwareAdminCluster{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets details of a single VMware admin cluster.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareAdminClusters/{vmwareAdminClustersId}", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.vmwareAdminClusters.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Name of the VMware admin cluster to be returned. Format: \"projects/{project}/locations/{location}/vmwareAdminClusters/{vmware_admin_cluster}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareAdminClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "VmwareAdminCluster" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareAdminClusters.getIamPolicy": + +type ProjectsLocationsVmwareAdminClustersGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - 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 *ProjectsLocationsVmwareAdminClustersService) GetIamPolicy(resource string) *ProjectsLocationsVmwareAdminClustersGetIamPolicyCall { + c := &ProjectsLocationsVmwareAdminClustersGetIamPolicyCall{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 *ProjectsLocationsVmwareAdminClustersGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsVmwareAdminClustersGetIamPolicyCall { + 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 information. +func (c *ProjectsLocationsVmwareAdminClustersGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareAdminClustersGetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsVmwareAdminClustersGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsVmwareAdminClustersGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareAdminClustersGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsVmwareAdminClustersGetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareAdminClustersGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareAdminClustersGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareAdminClusters.getIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. 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 *ProjectsLocationsVmwareAdminClustersGetIamPolicyCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareAdminClusters/{vmwareAdminClustersId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.vmwareAdminClusters.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. 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).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareAdminClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareAdminClusters.list": + +type ProjectsLocationsVmwareAdminClustersListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists VMware admin clusters in a given project and location. +// +// - parent: The parent of the project and location where the clusters +// are listed in. Format: "projects/{project}/locations/{location}". +func (r *ProjectsLocationsVmwareAdminClustersService) List(parent string) *ProjectsLocationsVmwareAdminClustersListCall { + c := &ProjectsLocationsVmwareAdminClustersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": Requested page size. +// Server may return fewer items than requested. If unspecified, at most +// 50 clusters will be returned. The maximum value is 1000; values above +// 1000 will be coerced to 1000. +func (c *ProjectsLocationsVmwareAdminClustersListCall) PageSize(pageSize int64) *ProjectsLocationsVmwareAdminClustersListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A token +// identifying a page of results the server should return. +func (c *ProjectsLocationsVmwareAdminClustersListCall) PageToken(pageToken string) *ProjectsLocationsVmwareAdminClustersListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// View sets the optional parameter "view": View for VMware admin +// clusters. When `BASIC` is specified, only the admin cluster resource +// name and membership are returned. The default/unset value +// `CLUSTER_VIEW_UNSPECIFIED` is the same as `FULL', which returns the +// complete admin cluster configuration details. +// +// Possible values: +// +// "CLUSTER_VIEW_UNSPECIFIED" - If the value is not set, the default +// +// `FULL` view is used. +// +// "BASIC" - Includes basic information of a admin cluster resource +// +// including admin cluster resource name and membership. +// +// "FULL" - Includes the complete configuration for bare metal admin +// +// cluster resource. This is the default value for +// ListVmwareAdminClustersRequest method. +func (c *ProjectsLocationsVmwareAdminClustersListCall) View(view string) *ProjectsLocationsVmwareAdminClustersListCall { + c.urlParams_.Set("view", view) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsVmwareAdminClustersListCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareAdminClustersListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsVmwareAdminClustersListCall) IfNoneMatch(entityTag string) *ProjectsLocationsVmwareAdminClustersListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareAdminClustersListCall) Context(ctx context.Context) *ProjectsLocationsVmwareAdminClustersListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareAdminClustersListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareAdminClustersListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/vmwareAdminClusters") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareAdminClusters.list" call. +// Exactly one of *ListVmwareAdminClustersResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *ListVmwareAdminClustersResponse.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 *ProjectsLocationsVmwareAdminClustersListCall) Do(opts ...googleapi.CallOption) (*ListVmwareAdminClustersResponse, 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 := &ListVmwareAdminClustersResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists VMware admin clusters in a given project and location.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareAdminClusters", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.vmwareAdminClusters.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "Requested page size. Server may return fewer items than requested. If unspecified, at most 50 clusters will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "A token identifying a page of results the server should return.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The parent of the project and location where the clusters are listed in. Format: \"projects/{project}/locations/{location}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "view": { + // "description": "View for VMware admin clusters. When `BASIC` is specified, only the admin cluster resource name and membership are returned. The default/unset value `CLUSTER_VIEW_UNSPECIFIED` is the same as `FULL', which returns the complete admin cluster configuration details.", + // "enum": [ + // "CLUSTER_VIEW_UNSPECIFIED", + // "BASIC", + // "FULL" + // ], + // "enumDescriptions": [ + // "If the value is not set, the default `FULL` view is used.", + // "Includes basic information of a admin cluster resource including admin cluster resource name and membership.", + // "Includes the complete configuration for bare metal admin cluster resource. This is the default value for ListVmwareAdminClustersRequest method." + // ], + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/vmwareAdminClusters", + // "response": { + // "$ref": "ListVmwareAdminClustersResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsVmwareAdminClustersListCall) Pages(ctx context.Context, f func(*ListVmwareAdminClustersResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "gkeonprem.projects.locations.vmwareAdminClusters.patch": + +type ProjectsLocationsVmwareAdminClustersPatchCall struct { + s *Service + name string + vmwareadmincluster *VmwareAdminCluster + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the parameters of a single VMware admin cluster. +// +// - name: Immutable. The VMware admin cluster resource name. +func (r *ProjectsLocationsVmwareAdminClustersService) Patch(name string, vmwareadmincluster *VmwareAdminCluster) *ProjectsLocationsVmwareAdminClustersPatchCall { + c := &ProjectsLocationsVmwareAdminClustersPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.vmwareadmincluster = vmwareadmincluster + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Field +// mask is used to specify the fields to be overwritten in the +// VMwareAdminCluster resource by the update. The fields specified in +// the update_mask are relative to the resource, not the full request. A +// field will be overwritten if it is in the mask. If the user does not +// provide a mask then all populated fields in the VmwareAdminCluster +// message will be updated. Empty fields will be ignored unless a field +// mask is used. +func (c *ProjectsLocationsVmwareAdminClustersPatchCall) UpdateMask(updateMask string) *ProjectsLocationsVmwareAdminClustersPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Validate the +// request without actually doing any updates. +func (c *ProjectsLocationsVmwareAdminClustersPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsVmwareAdminClustersPatchCall { + 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 information. +func (c *ProjectsLocationsVmwareAdminClustersPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareAdminClustersPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareAdminClustersPatchCall) Context(ctx context.Context) *ProjectsLocationsVmwareAdminClustersPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareAdminClustersPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareAdminClustersPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.vmwareadmincluster) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareAdminClusters.patch" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsVmwareAdminClustersPatchCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates the parameters of a single VMware admin cluster.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareAdminClusters/{vmwareAdminClustersId}", + // "httpMethod": "PATCH", + // "id": "gkeonprem.projects.locations.vmwareAdminClusters.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Immutable. The VMware admin cluster resource name.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareAdminClusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Required. Field mask is used to specify the fields to be overwritten in the VMwareAdminCluster resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all populated fields in the VmwareAdminCluster message will be updated. Empty fields will be ignored unless a field mask is used.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // }, + // "validateOnly": { + // "description": "Validate the request without actually doing any updates.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "VmwareAdminCluster" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareAdminClusters.setIamPolicy": + +type ProjectsLocationsVmwareAdminClustersSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - 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 *ProjectsLocationsVmwareAdminClustersService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsVmwareAdminClustersSetIamPolicyCall { + c := &ProjectsLocationsVmwareAdminClustersSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsVmwareAdminClustersSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareAdminClustersSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareAdminClustersSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsVmwareAdminClustersSetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareAdminClustersSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareAdminClustersSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareAdminClusters.setIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. 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 *ProjectsLocationsVmwareAdminClustersSetIamPolicyCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareAdminClusters/{vmwareAdminClustersId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.vmwareAdminClusters.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareAdminClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareAdminClusters.testIamPermissions": + +type ProjectsLocationsVmwareAdminClustersTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. +func (r *ProjectsLocationsVmwareAdminClustersService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsVmwareAdminClustersTestIamPermissionsCall { + c := &ProjectsLocationsVmwareAdminClustersTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsVmwareAdminClustersTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareAdminClustersTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareAdminClustersTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsVmwareAdminClustersTestIamPermissionsCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareAdminClustersTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareAdminClustersTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareAdminClusters.testIamPermissions" call. +// Exactly one of *TestIamPermissionsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.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 *ProjectsLocationsVmwareAdminClustersTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, 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 := &TestIamPermissionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareAdminClusters/{vmwareAdminClustersId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.vmwareAdminClusters.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareAdminClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareAdminClusters.unenroll": + +type ProjectsLocationsVmwareAdminClustersUnenrollCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Unenroll: Unenrolls an existing VMware admin cluster from the Anthos +// On-Prem API within a given project and location. Unenrollment removes +// the Cloud reference to the cluster without modifying the underlying +// OnPrem Resources. Clusters will continue to run; however, they will +// no longer be accessible through the Anthos On-Prem API or its +// clients. +// +// - name: Name of the VMware admin cluster to be unenrolled. Format: +// "projects/{project}/locations/{location}/vmwareAdminClusters/{cluste +// r}". +func (r *ProjectsLocationsVmwareAdminClustersService) Unenroll(name string) *ProjectsLocationsVmwareAdminClustersUnenrollCall { + c := &ProjectsLocationsVmwareAdminClustersUnenrollCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to +// true, and the VMware admin cluster is not found, the request will +// succeed but no action will be taken on the server and return a +// completed LRO. +func (c *ProjectsLocationsVmwareAdminClustersUnenrollCall) AllowMissing(allowMissing bool) *ProjectsLocationsVmwareAdminClustersUnenrollCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// Etag sets the optional parameter "etag": The current etag of the +// VMware admin cluster. If an etag is provided and does not match the +// current etag of the cluster, deletion will be blocked and an ABORTED +// error will be returned. +func (c *ProjectsLocationsVmwareAdminClustersUnenrollCall) Etag(etag string) *ProjectsLocationsVmwareAdminClustersUnenrollCall { + c.urlParams_.Set("etag", etag) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Validate the +// request without actually doing any updates. +func (c *ProjectsLocationsVmwareAdminClustersUnenrollCall) ValidateOnly(validateOnly bool) *ProjectsLocationsVmwareAdminClustersUnenrollCall { + 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 information. +func (c *ProjectsLocationsVmwareAdminClustersUnenrollCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareAdminClustersUnenrollCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareAdminClustersUnenrollCall) Context(ctx context.Context) *ProjectsLocationsVmwareAdminClustersUnenrollCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareAdminClustersUnenrollCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareAdminClustersUnenrollCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:unenroll") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareAdminClusters.unenroll" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsVmwareAdminClustersUnenrollCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Unenrolls an existing VMware admin cluster from the Anthos On-Prem API within a given project and location. Unenrollment removes the Cloud reference to the cluster without modifying the underlying OnPrem Resources. Clusters will continue to run; however, they will no longer be accessible through the Anthos On-Prem API or its clients.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareAdminClusters/{vmwareAdminClustersId}:unenroll", + // "httpMethod": "DELETE", + // "id": "gkeonprem.projects.locations.vmwareAdminClusters.unenroll", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "allowMissing": { + // "description": "If set to true, and the VMware admin cluster is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + // "location": "query", + // "type": "boolean" + // }, + // "etag": { + // "description": "The current etag of the VMware admin cluster. If an etag is provided and does not match the current etag of the cluster, deletion will be blocked and an ABORTED error will be returned.", + // "location": "query", + // "type": "string" + // }, + // "name": { + // "description": "Required. Name of the VMware admin cluster to be unenrolled. Format: \"projects/{project}/locations/{location}/vmwareAdminClusters/{cluster}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareAdminClusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "Validate the request without actually doing any updates.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}:unenroll", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareAdminClusters.operations.get": + +type ProjectsLocationsVmwareAdminClustersOperationsGetCall 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 *ProjectsLocationsVmwareAdminClustersOperationsService) Get(name string) *ProjectsLocationsVmwareAdminClustersOperationsGetCall { + c := &ProjectsLocationsVmwareAdminClustersOperationsGetCall{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 information. +func (c *ProjectsLocationsVmwareAdminClustersOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareAdminClustersOperationsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsVmwareAdminClustersOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsVmwareAdminClustersOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareAdminClustersOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsVmwareAdminClustersOperationsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareAdminClustersOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareAdminClustersOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareAdminClusters.operations.get" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsVmwareAdminClustersOperationsGetCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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}/vmwareAdminClusters/{vmwareAdminClustersId}/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.vmwareAdminClusters.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareAdminClusters/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareAdminClusters.operations.list": + +type ProjectsLocationsVmwareAdminClustersOperationsListCall 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 *ProjectsLocationsVmwareAdminClustersOperationsService) List(name string) *ProjectsLocationsVmwareAdminClustersOperationsListCall { + c := &ProjectsLocationsVmwareAdminClustersOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *ProjectsLocationsVmwareAdminClustersOperationsListCall) Filter(filter string) *ProjectsLocationsVmwareAdminClustersOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *ProjectsLocationsVmwareAdminClustersOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsVmwareAdminClustersOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *ProjectsLocationsVmwareAdminClustersOperationsListCall) PageToken(pageToken string) *ProjectsLocationsVmwareAdminClustersOperationsListCall { + 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 information. +func (c *ProjectsLocationsVmwareAdminClustersOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareAdminClustersOperationsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsVmwareAdminClustersOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsVmwareAdminClustersOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareAdminClustersOperationsListCall) Context(ctx context.Context) *ProjectsLocationsVmwareAdminClustersOperationsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareAdminClustersOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareAdminClustersOperationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareAdminClusters.operations.list" call. +// Exactly one of *ListOperationsResponse or error will be non-nil. 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 *ProjectsLocationsVmwareAdminClustersOperationsListCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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}/vmwareAdminClusters/{vmwareAdminClustersId}/operations", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.vmwareAdminClusters.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/[^/]+/vmwareAdminClusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "pageSize": { + // "description": "The standard list page size.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The standard list page token.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}/operations", + // "response": { + // "$ref": "ListOperationsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsVmwareAdminClustersOperationsListCall) Pages(ctx context.Context, f func(*ListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "gkeonprem.projects.locations.vmwareClusters.create": + +type ProjectsLocationsVmwareClustersCreateCall struct { + s *Service + parent string + vmwarecluster *VmwareCluster + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new VMware cluster in a given project and location. +// +// - parent: The parent of the project and location where this cluster +// is created in. Format: "projects/{project}/locations/{location}". +func (r *ProjectsLocationsVmwareClustersService) Create(parent string, vmwarecluster *VmwareCluster) *ProjectsLocationsVmwareClustersCreateCall { + c := &ProjectsLocationsVmwareClustersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.vmwarecluster = vmwarecluster + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Validate the +// request without actually doing any updates. +func (c *ProjectsLocationsVmwareClustersCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsVmwareClustersCreateCall { + c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) + return c +} + +// VmwareClusterId sets the optional parameter "vmwareClusterId": User +// provided identifier that is used as part of the resource name; This +// value must be up to 40 characters and follow RFC-1123 +// (https://tools.ietf.org/html/rfc1123) format. +func (c *ProjectsLocationsVmwareClustersCreateCall) VmwareClusterId(vmwareClusterId string) *ProjectsLocationsVmwareClustersCreateCall { + c.urlParams_.Set("vmwareClusterId", vmwareClusterId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsVmwareClustersCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersCreateCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.vmwarecluster) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/vmwareClusters") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.create" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsVmwareClustersCreateCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates a new VMware cluster in a given project and location.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.vmwareClusters.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The parent of the project and location where this cluster is created in. Format: \"projects/{project}/locations/{location}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "Validate the request without actually doing any updates.", + // "location": "query", + // "type": "boolean" + // }, + // "vmwareClusterId": { + // "description": "User provided identifier that is used as part of the resource name; This value must be up to 40 characters and follow RFC-1123 (https://tools.ietf.org/html/rfc1123) format.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/vmwareClusters", + // "request": { + // "$ref": "VmwareCluster" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.delete": + +type ProjectsLocationsVmwareClustersDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a single VMware Cluster. +// +// - name: Name of the VMware user cluster to be deleted. Format: +// "projects/{project}/locations/{location}/vmwareClusters/{vmware_clus +// ter}". +func (r *ProjectsLocationsVmwareClustersService) Delete(name string) *ProjectsLocationsVmwareClustersDeleteCall { + c := &ProjectsLocationsVmwareClustersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to +// true, and the VMware cluster is not found, the request will succeed +// but no action will be taken on the server and return a completed LRO. +func (c *ProjectsLocationsVmwareClustersDeleteCall) AllowMissing(allowMissing bool) *ProjectsLocationsVmwareClustersDeleteCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// Etag sets the optional parameter "etag": The current etag of the +// VMware cluster. If an etag is provided and does not match the current +// etag of the cluster, deletion will be blocked and an ABORTED error +// will be returned. +func (c *ProjectsLocationsVmwareClustersDeleteCall) Etag(etag string) *ProjectsLocationsVmwareClustersDeleteCall { + c.urlParams_.Set("etag", etag) + return c +} + +// Force sets the optional parameter "force": If set to true, any node +// pools from the cluster will also be deleted. +func (c *ProjectsLocationsVmwareClustersDeleteCall) Force(force bool) *ProjectsLocationsVmwareClustersDeleteCall { + c.urlParams_.Set("force", fmt.Sprint(force)) + return c +} + +// IgnoreErrors sets the optional parameter "ignoreErrors": If set to +// true, the deletion of a VMware user cluster resource will succeed +// even if errors occur during deletion. This parameter can be used when +// you want to delete GCP's cluster resource and the on-prem admin +// cluster that hosts your user cluster is disconnected / unreachable or +// deleted. WARNING: Using this parameter when your user cluster still +// exists may result in a deleted GCP user cluster but an existing +// on-prem user cluster. +func (c *ProjectsLocationsVmwareClustersDeleteCall) IgnoreErrors(ignoreErrors bool) *ProjectsLocationsVmwareClustersDeleteCall { + c.urlParams_.Set("ignoreErrors", fmt.Sprint(ignoreErrors)) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Validate the +// request without actually doing any updates. +func (c *ProjectsLocationsVmwareClustersDeleteCall) ValidateOnly(validateOnly bool) *ProjectsLocationsVmwareClustersDeleteCall { + 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 information. +func (c *ProjectsLocationsVmwareClustersDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersDeleteCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.delete" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsVmwareClustersDeleteCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Deletes a single VMware Cluster.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}", + // "httpMethod": "DELETE", + // "id": "gkeonprem.projects.locations.vmwareClusters.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "allowMissing": { + // "description": "If set to true, and the VMware cluster is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + // "location": "query", + // "type": "boolean" + // }, + // "etag": { + // "description": "The current etag of the VMware cluster. If an etag is provided and does not match the current etag of the cluster, deletion will be blocked and an ABORTED error will be returned.", + // "location": "query", + // "type": "string" + // }, + // "force": { + // "description": "If set to true, any node pools from the cluster will also be deleted.", + // "location": "query", + // "type": "boolean" + // }, + // "ignoreErrors": { + // "description": "If set to true, the deletion of a VMware user cluster resource will succeed even if errors occur during deletion. This parameter can be used when you want to delete GCP's cluster resource and the on-prem admin cluster that hosts your user cluster is disconnected / unreachable or deleted. WARNING: Using this parameter when your user cluster still exists may result in a deleted GCP user cluster but an existing on-prem user cluster.", + // "location": "query", + // "type": "boolean" + // }, + // "name": { + // "description": "Required. Name of the VMware user cluster to be deleted. Format: \"projects/{project}/locations/{location}/vmwareClusters/{vmware_cluster}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "Validate the request without actually doing any updates.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.enroll": + +type ProjectsLocationsVmwareClustersEnrollCall struct { + s *Service + parent string + enrollvmwareclusterrequest *EnrollVmwareClusterRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Enroll: Enrolls an existing VMware user cluster and its node pools to +// the Anthos On-Prem API within a given project and location. Through +// enrollment, an existing cluster will become Anthos On-Prem API +// managed. The corresponding GCP resources will be created and all +// future modifications to the cluster and/or its node pools will be +// expected to be performed through the API. +// +// - parent: The parent of the project and location where the cluster is +// Enrolled in. Format: "projects/{project}/locations/{location}". +func (r *ProjectsLocationsVmwareClustersService) Enroll(parent string, enrollvmwareclusterrequest *EnrollVmwareClusterRequest) *ProjectsLocationsVmwareClustersEnrollCall { + c := &ProjectsLocationsVmwareClustersEnrollCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.enrollvmwareclusterrequest = enrollvmwareclusterrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsVmwareClustersEnrollCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersEnrollCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersEnrollCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersEnrollCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersEnrollCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersEnrollCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.enrollvmwareclusterrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/vmwareClusters:enroll") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.enroll" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsVmwareClustersEnrollCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Enrolls an existing VMware user cluster and its node pools to the Anthos On-Prem API within a given project and location. Through enrollment, an existing cluster will become Anthos On-Prem API managed. The corresponding GCP resources will be created and all future modifications to the cluster and/or its node pools will be expected to be performed through the API.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters:enroll", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.vmwareClusters.enroll", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The parent of the project and location where the cluster is Enrolled in. Format: \"projects/{project}/locations/{location}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/vmwareClusters:enroll", + // "request": { + // "$ref": "EnrollVmwareClusterRequest" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.get": + +type ProjectsLocationsVmwareClustersGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of a single VMware Cluster. +// +// - name: Name of the VMware user cluster to be returned. Format: +// "projects/{project}/locations/{location}/vmwareClusters/{vmware_clus +// ter}". +func (r *ProjectsLocationsVmwareClustersService) Get(name string) *ProjectsLocationsVmwareClustersGetCall { + c := &ProjectsLocationsVmwareClustersGetCall{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 information. +func (c *ProjectsLocationsVmwareClustersGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsVmwareClustersGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsVmwareClustersGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersGetCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.get" call. +// Exactly one of *VmwareCluster or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *VmwareCluster.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 *ProjectsLocationsVmwareClustersGetCall) Do(opts ...googleapi.CallOption) (*VmwareCluster, 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 := &VmwareCluster{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets details of a single VMware Cluster.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.vmwareClusters.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Name of the VMware user cluster to be returned. Format: \"projects/{project}/locations/{location}/vmwareClusters/{vmware_cluster}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "VmwareCluster" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.getIamPolicy": + +type ProjectsLocationsVmwareClustersGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - 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 *ProjectsLocationsVmwareClustersService) GetIamPolicy(resource string) *ProjectsLocationsVmwareClustersGetIamPolicyCall { + c := &ProjectsLocationsVmwareClustersGetIamPolicyCall{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 *ProjectsLocationsVmwareClustersGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsVmwareClustersGetIamPolicyCall { + 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 information. +func (c *ProjectsLocationsVmwareClustersGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersGetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsVmwareClustersGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsVmwareClustersGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersGetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.getIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. 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 *ProjectsLocationsVmwareClustersGetIamPolicyCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.vmwareClusters.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. 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).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.list": + +type ProjectsLocationsVmwareClustersListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists VMware Clusters in a given project and location. +// +// - parent: The parent of the project and location where the clusters +// are listed in. Format: "projects/{project}/locations/{location}". +func (r *ProjectsLocationsVmwareClustersService) List(parent string) *ProjectsLocationsVmwareClustersListCall { + c := &ProjectsLocationsVmwareClustersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": A resource filtering +// expression following https://google.aip.dev/160. When non-empty, only +// resource's whose attributes field matches the filter are returned. +func (c *ProjectsLocationsVmwareClustersListCall) Filter(filter string) *ProjectsLocationsVmwareClustersListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": Requested page size. +// Server may return fewer items than requested. If unspecified, at most +// 50 clusters will be returned. The maximum value is 1000; values above +// 1000 will be coerced to 1000. +func (c *ProjectsLocationsVmwareClustersListCall) PageSize(pageSize int64) *ProjectsLocationsVmwareClustersListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A token +// identifying a page of results the server should return. +func (c *ProjectsLocationsVmwareClustersListCall) PageToken(pageToken string) *ProjectsLocationsVmwareClustersListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// View sets the optional parameter "view": View for VMware clusters. +// When `BASIC` is specified, only the cluster resource name and admin +// cluster membership are returned. The default/unset value +// `CLUSTER_VIEW_UNSPECIFIED` is the same as `FULL', which returns the +// complete cluster configuration details. +// +// Possible values: +// +// "CLUSTER_VIEW_UNSPECIFIED" - If the value is not set, the default +// +// `FULL` view is used. +// +// "BASIC" - Includes basic information of a cluster resource +// +// including cluster resource name and admin cluster membership. +// +// "FULL" - Includes the complete configuration for VMware cluster +// +// resource. This is the default value for ListVmwareClustersRequest +// method. +func (c *ProjectsLocationsVmwareClustersListCall) View(view string) *ProjectsLocationsVmwareClustersListCall { + c.urlParams_.Set("view", view) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsVmwareClustersListCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsVmwareClustersListCall) IfNoneMatch(entityTag string) *ProjectsLocationsVmwareClustersListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersListCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/vmwareClusters") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.list" call. +// Exactly one of *ListVmwareClustersResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *ListVmwareClustersResponse.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 *ProjectsLocationsVmwareClustersListCall) Do(opts ...googleapi.CallOption) (*ListVmwareClustersResponse, 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 := &ListVmwareClustersResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists VMware Clusters in a given project and location.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.vmwareClusters.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "filter": { + // "description": "A resource filtering expression following https://google.aip.dev/160. When non-empty, only resource's whose attributes field matches the filter are returned.", + // "location": "query", + // "type": "string" + // }, + // "pageSize": { + // "description": "Requested page size. Server may return fewer items than requested. If unspecified, at most 50 clusters will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "A token identifying a page of results the server should return.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The parent of the project and location where the clusters are listed in. Format: \"projects/{project}/locations/{location}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "view": { + // "description": "View for VMware clusters. When `BASIC` is specified, only the cluster resource name and admin cluster membership are returned. The default/unset value `CLUSTER_VIEW_UNSPECIFIED` is the same as `FULL', which returns the complete cluster configuration details.", + // "enum": [ + // "CLUSTER_VIEW_UNSPECIFIED", + // "BASIC", + // "FULL" + // ], + // "enumDescriptions": [ + // "If the value is not set, the default `FULL` view is used.", + // "Includes basic information of a cluster resource including cluster resource name and admin cluster membership.", + // "Includes the complete configuration for VMware cluster resource. This is the default value for ListVmwareClustersRequest method." + // ], + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/vmwareClusters", + // "response": { + // "$ref": "ListVmwareClustersResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsVmwareClustersListCall) Pages(ctx context.Context, f func(*ListVmwareClustersResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "gkeonprem.projects.locations.vmwareClusters.patch": + +type ProjectsLocationsVmwareClustersPatchCall struct { + s *Service + name string + vmwarecluster *VmwareCluster + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the parameters of a single VMware cluster. +// +// - name: Immutable. The VMware user cluster resource name. +func (r *ProjectsLocationsVmwareClustersService) Patch(name string, vmwarecluster *VmwareCluster) *ProjectsLocationsVmwareClustersPatchCall { + c := &ProjectsLocationsVmwareClustersPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.vmwarecluster = vmwarecluster + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Field +// mask is used to specify the fields to be overwritten in the +// VMwareCluster resource by the update. The fields specified in the +// update_mask are relative to the resource, not the full request. A +// field will be overwritten if it is in the mask. If the user does not +// provide a mask then all populated fields in the VmwareCluster message +// will be updated. Empty fields will be ignored unless a field mask is +// used. +func (c *ProjectsLocationsVmwareClustersPatchCall) UpdateMask(updateMask string) *ProjectsLocationsVmwareClustersPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Validate the +// request without actually doing any updates. +func (c *ProjectsLocationsVmwareClustersPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsVmwareClustersPatchCall { + 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 information. +func (c *ProjectsLocationsVmwareClustersPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersPatchCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.vmwarecluster) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.patch" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsVmwareClustersPatchCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates the parameters of a single VMware cluster.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}", + // "httpMethod": "PATCH", + // "id": "gkeonprem.projects.locations.vmwareClusters.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Immutable. The VMware user cluster resource name.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Required. Field mask is used to specify the fields to be overwritten in the VMwareCluster resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all populated fields in the VmwareCluster message will be updated. Empty fields will be ignored unless a field mask is used.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // }, + // "validateOnly": { + // "description": "Validate the request without actually doing any updates.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "VmwareCluster" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.queryVersionConfig": + +type ProjectsLocationsVmwareClustersQueryVersionConfigCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// QueryVersionConfig: Queries the VMware user cluster version config. +// +// - parent: The parent of the project and location to query for version +// config. Format: "projects/{project}/locations/{location}". +func (r *ProjectsLocationsVmwareClustersService) QueryVersionConfig(parent string) *ProjectsLocationsVmwareClustersQueryVersionConfigCall { + c := &ProjectsLocationsVmwareClustersQueryVersionConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// CreateConfigAdminClusterMembership sets the optional parameter +// "createConfig.adminClusterMembership": The admin cluster membership. +// This is the full resource name of the admin cluster's fleet +// membership. Format: +// "projects/{project}/locations/{location}/memberships/{membership}" +func (c *ProjectsLocationsVmwareClustersQueryVersionConfigCall) CreateConfigAdminClusterMembership(createConfigAdminClusterMembership string) *ProjectsLocationsVmwareClustersQueryVersionConfigCall { + c.urlParams_.Set("createConfig.adminClusterMembership", createConfigAdminClusterMembership) + return c +} + +// CreateConfigAdminClusterName sets the optional parameter +// "createConfig.adminClusterName": The admin cluster resource name. +// This is the full resource name of the admin cluster resource. Format: +// "projects/{project}/locations/{location}/vmwareAdminClusters/{vmware_a +// dmin_cluster}" +func (c *ProjectsLocationsVmwareClustersQueryVersionConfigCall) CreateConfigAdminClusterName(createConfigAdminClusterName string) *ProjectsLocationsVmwareClustersQueryVersionConfigCall { + c.urlParams_.Set("createConfig.adminClusterName", createConfigAdminClusterName) + return c +} + +// UpgradeConfigClusterName sets the optional parameter +// "upgradeConfig.clusterName": The user cluster resource name. This is +// the full resource name of the user cluster resource. Format: +// "projects/{project}/locations/{location}/vmwareClusters/{vmware_cluste +// r}" +func (c *ProjectsLocationsVmwareClustersQueryVersionConfigCall) UpgradeConfigClusterName(upgradeConfigClusterName string) *ProjectsLocationsVmwareClustersQueryVersionConfigCall { + c.urlParams_.Set("upgradeConfig.clusterName", upgradeConfigClusterName) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsVmwareClustersQueryVersionConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersQueryVersionConfigCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersQueryVersionConfigCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersQueryVersionConfigCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersQueryVersionConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersQueryVersionConfigCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/vmwareClusters:queryVersionConfig") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.queryVersionConfig" call. +// Exactly one of *QueryVmwareVersionConfigResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *QueryVmwareVersionConfigResponse.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 *ProjectsLocationsVmwareClustersQueryVersionConfigCall) Do(opts ...googleapi.CallOption) (*QueryVmwareVersionConfigResponse, 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 := &QueryVmwareVersionConfigResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Queries the VMware user cluster version config.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters:queryVersionConfig", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.vmwareClusters.queryVersionConfig", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "createConfig.adminClusterMembership": { + // "description": "The admin cluster membership. This is the full resource name of the admin cluster's fleet membership. Format: \"projects/{project}/locations/{location}/memberships/{membership}\"", + // "location": "query", + // "type": "string" + // }, + // "createConfig.adminClusterName": { + // "description": "The admin cluster resource name. This is the full resource name of the admin cluster resource. Format: \"projects/{project}/locations/{location}/vmwareAdminClusters/{vmware_admin_cluster}\"", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The parent of the project and location to query for version config. Format: \"projects/{project}/locations/{location}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "upgradeConfig.clusterName": { + // "description": "The user cluster resource name. This is the full resource name of the user cluster resource. Format: \"projects/{project}/locations/{location}/vmwareClusters/{vmware_cluster}\"", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/vmwareClusters:queryVersionConfig", + // "response": { + // "$ref": "QueryVmwareVersionConfigResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.setIamPolicy": + +type ProjectsLocationsVmwareClustersSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - 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 *ProjectsLocationsVmwareClustersService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsVmwareClustersSetIamPolicyCall { + c := &ProjectsLocationsVmwareClustersSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsVmwareClustersSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersSetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.setIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. 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 *ProjectsLocationsVmwareClustersSetIamPolicyCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.vmwareClusters.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.testIamPermissions": + +type ProjectsLocationsVmwareClustersTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. +func (r *ProjectsLocationsVmwareClustersService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsVmwareClustersTestIamPermissionsCall { + c := &ProjectsLocationsVmwareClustersTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsVmwareClustersTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersTestIamPermissionsCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.testIamPermissions" call. +// Exactly one of *TestIamPermissionsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.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 *ProjectsLocationsVmwareClustersTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, 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 := &TestIamPermissionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.vmwareClusters.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.unenroll": + +type ProjectsLocationsVmwareClustersUnenrollCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Unenroll: Unenrolls an existing VMware user cluster and its node +// pools from the Anthos On-Prem API within a given project and +// location. Unenrollment removes the Cloud reference to the cluster +// without modifying the underlying OnPrem Resources. Clusters and node +// pools will continue to run; however, they will no longer be +// accessible through the Anthos On-Prem API or UI. +// +// - name: Name of the VMware user cluster to be unenrolled. Format: +// "projects/{project}/locations/{location}/vmwareClusters/{vmware_clus +// ter}". +func (r *ProjectsLocationsVmwareClustersService) Unenroll(name string) *ProjectsLocationsVmwareClustersUnenrollCall { + c := &ProjectsLocationsVmwareClustersUnenrollCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to +// true, and the VMware cluster is not found, the request will succeed +// but no action will be taken on the server and return a completed LRO. +func (c *ProjectsLocationsVmwareClustersUnenrollCall) AllowMissing(allowMissing bool) *ProjectsLocationsVmwareClustersUnenrollCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// Etag sets the optional parameter "etag": The current etag of the +// VMware Cluster. If an etag is provided and does not match the current +// etag of the cluster, deletion will be blocked and an ABORTED error +// will be returned. +func (c *ProjectsLocationsVmwareClustersUnenrollCall) Etag(etag string) *ProjectsLocationsVmwareClustersUnenrollCall { + c.urlParams_.Set("etag", etag) + return c +} + +// Force sets the optional parameter "force": This is required if the +// cluster has any associated node pools. When set, any child node pools +// will also be unenrolled. +func (c *ProjectsLocationsVmwareClustersUnenrollCall) Force(force bool) *ProjectsLocationsVmwareClustersUnenrollCall { + c.urlParams_.Set("force", fmt.Sprint(force)) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Validate the +// request without actually doing any updates. +func (c *ProjectsLocationsVmwareClustersUnenrollCall) ValidateOnly(validateOnly bool) *ProjectsLocationsVmwareClustersUnenrollCall { + 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 information. +func (c *ProjectsLocationsVmwareClustersUnenrollCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersUnenrollCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersUnenrollCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersUnenrollCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersUnenrollCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersUnenrollCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:unenroll") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.unenroll" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsVmwareClustersUnenrollCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Unenrolls an existing VMware user cluster and its node pools from the Anthos On-Prem API within a given project and location. Unenrollment removes the Cloud reference to the cluster without modifying the underlying OnPrem Resources. Clusters and node pools will continue to run; however, they will no longer be accessible through the Anthos On-Prem API or UI.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}:unenroll", + // "httpMethod": "DELETE", + // "id": "gkeonprem.projects.locations.vmwareClusters.unenroll", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "allowMissing": { + // "description": "If set to true, and the VMware cluster is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + // "location": "query", + // "type": "boolean" + // }, + // "etag": { + // "description": "The current etag of the VMware Cluster. If an etag is provided and does not match the current etag of the cluster, deletion will be blocked and an ABORTED error will be returned.", + // "location": "query", + // "type": "string" + // }, + // "force": { + // "description": "This is required if the cluster has any associated node pools. When set, any child node pools will also be unenrolled.", + // "location": "query", + // "type": "boolean" + // }, + // "name": { + // "description": "Required. Name of the VMware user cluster to be unenrolled. Format: \"projects/{project}/locations/{location}/vmwareClusters/{vmware_cluster}\"", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "Validate the request without actually doing any updates.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}:unenroll", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.operations.get": + +type ProjectsLocationsVmwareClustersOperationsGetCall 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 *ProjectsLocationsVmwareClustersOperationsService) Get(name string) *ProjectsLocationsVmwareClustersOperationsGetCall { + c := &ProjectsLocationsVmwareClustersOperationsGetCall{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 information. +func (c *ProjectsLocationsVmwareClustersOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersOperationsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsVmwareClustersOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsVmwareClustersOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersOperationsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.operations.get" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsVmwareClustersOperationsGetCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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}/vmwareClusters/{vmwareClustersId}/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.vmwareClusters.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.operations.list": + +type ProjectsLocationsVmwareClustersOperationsListCall 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 *ProjectsLocationsVmwareClustersOperationsService) List(name string) *ProjectsLocationsVmwareClustersOperationsListCall { + c := &ProjectsLocationsVmwareClustersOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *ProjectsLocationsVmwareClustersOperationsListCall) Filter(filter string) *ProjectsLocationsVmwareClustersOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *ProjectsLocationsVmwareClustersOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsVmwareClustersOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *ProjectsLocationsVmwareClustersOperationsListCall) PageToken(pageToken string) *ProjectsLocationsVmwareClustersOperationsListCall { + 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 information. +func (c *ProjectsLocationsVmwareClustersOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersOperationsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsVmwareClustersOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsVmwareClustersOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersOperationsListCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersOperationsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersOperationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.operations.list" call. +// Exactly one of *ListOperationsResponse or error will be non-nil. 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 *ProjectsLocationsVmwareClustersOperationsListCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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}/vmwareClusters/{vmwareClustersId}/operations", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.vmwareClusters.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/[^/]+/vmwareClusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "pageSize": { + // "description": "The standard list page size.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The standard list page token.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}/operations", + // "response": { + // "$ref": "ListOperationsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsVmwareClustersOperationsListCall) Pages(ctx context.Context, f func(*ListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.create": + +type ProjectsLocationsVmwareClustersVmwareNodePoolsCreateCall struct { + s *Service + parent string + vmwarenodepool *VmwareNodePool + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new VMware node pool in a given project, location +// and VMWare cluster. +// +// - parent: The parent resource where this node pool will be created. +// projects/{project}/locations/{location}/vmwareClusters/{cluster}. +func (r *ProjectsLocationsVmwareClustersVmwareNodePoolsService) Create(parent string, vmwarenodepool *VmwareNodePool) *ProjectsLocationsVmwareClustersVmwareNodePoolsCreateCall { + c := &ProjectsLocationsVmwareClustersVmwareNodePoolsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.vmwarenodepool = vmwarenodepool + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, only +// validate the request, but do not actually create the node pool. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsVmwareClustersVmwareNodePoolsCreateCall { + c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) + return c +} + +// VmwareNodePoolId sets the optional parameter "vmwareNodePoolId": The +// ID to use for the node pool, which will become the final component of +// the node pool's resource name. This value must be up to 40 characters +// and follow RFC-1123 (https://tools.ietf.org/html/rfc1123) format. The +// value must not be permitted to be a UUID (or UUID-like: anything +// matching /^[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i). +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsCreateCall) VmwareNodePoolId(vmwareNodePoolId string) *ProjectsLocationsVmwareClustersVmwareNodePoolsCreateCall { + c.urlParams_.Set("vmwareNodePoolId", vmwareNodePoolId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersVmwareNodePoolsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsCreateCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersVmwareNodePoolsCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.vmwarenodepool) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/vmwareNodePools") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.create" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsVmwareClustersVmwareNodePoolsCreateCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates a new VMware node pool in a given project, location and VMWare cluster.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The parent resource where this node pool will be created. projects/{project}/locations/{location}/vmwareClusters/{cluster}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "If set, only validate the request, but do not actually create the node pool.", + // "location": "query", + // "type": "boolean" + // }, + // "vmwareNodePoolId": { + // "description": "The ID to use for the node pool, which will become the final component of the node pool's resource name. This value must be up to 40 characters and follow RFC-1123 (https://tools.ietf.org/html/rfc1123) format. The value must not be permitted to be a UUID (or UUID-like: anything matching /^[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i).", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/vmwareNodePools", + // "request": { + // "$ref": "VmwareNodePool" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.delete": + +type ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a single VMware node pool. +// +// - name: The name of the node pool to delete. Format: +// projects/{project}/locations/{location}/vmwareClusters/{cluster}/vmw +// areNodePools/{nodepool}. +func (r *ProjectsLocationsVmwareClustersVmwareNodePoolsService) Delete(name string) *ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall { + c := &ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to +// true, and the VMware node pool is not found, the request will succeed +// but no action will be taken on the server and return a completed LRO. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall) AllowMissing(allowMissing bool) *ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// Etag sets the optional parameter "etag": The current etag of the +// VmwareNodePool. If an etag is provided and does not match the current +// etag of the node pool, deletion will be blocked and an ABORTED error +// will be returned. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall) Etag(etag string) *ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall { + c.urlParams_.Set("etag", etag) + return c +} + +// IgnoreErrors sets the optional parameter "ignoreErrors": If set to +// true, the deletion of a VMware node pool resource will succeed even +// if errors occur during deletion. This parameter can be used when you +// want to delete GCP's node pool resource and you've already deleted +// the on-prem admin cluster that hosted your node pool. WARNING: Using +// this parameter when your user cluster still exists may result in a +// deleted GCP node pool but an existing on-prem node pool. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall) IgnoreErrors(ignoreErrors bool) *ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall { + c.urlParams_.Set("ignoreErrors", fmt.Sprint(ignoreErrors)) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, only +// validate the request, but do not actually delete the node pool. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall) ValidateOnly(validateOnly bool) *ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall { + 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 information. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.delete" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsVmwareClustersVmwareNodePoolsDeleteCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Deletes a single VMware node pool.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}", + // "httpMethod": "DELETE", + // "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "allowMissing": { + // "description": "If set to true, and the VMware node pool is not found, the request will succeed but no action will be taken on the server and return a completed LRO.", + // "location": "query", + // "type": "boolean" + // }, + // "etag": { + // "description": "The current etag of the VmwareNodePool. If an etag is provided and does not match the current etag of the node pool, deletion will be blocked and an ABORTED error will be returned.", + // "location": "query", + // "type": "string" + // }, + // "ignoreErrors": { + // "description": "If set to true, the deletion of a VMware node pool resource will succeed even if errors occur during deletion. This parameter can be used when you want to delete GCP's node pool resource and you've already deleted the on-prem admin cluster that hosted your node pool. WARNING: Using this parameter when your user cluster still exists may result in a deleted GCP node pool but an existing on-prem node pool.", + // "location": "query", + // "type": "boolean" + // }, + // "name": { + // "description": "Required. The name of the node pool to delete. Format: projects/{project}/locations/{location}/vmwareClusters/{cluster}/vmwareNodePools/{nodepool}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "If set, only validate the request, but do not actually delete the node pool.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.enroll": + +type ProjectsLocationsVmwareClustersVmwareNodePoolsEnrollCall struct { + s *Service + parent string + enrollvmwarenodepoolrequest *EnrollVmwareNodePoolRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Enroll: Enrolls a VMware node pool to Anthos On-Prem API +// +// - parent: The parent resource where the node pool is enrolled in. +func (r *ProjectsLocationsVmwareClustersVmwareNodePoolsService) Enroll(parent string, enrollvmwarenodepoolrequest *EnrollVmwareNodePoolRequest) *ProjectsLocationsVmwareClustersVmwareNodePoolsEnrollCall { + c := &ProjectsLocationsVmwareClustersVmwareNodePoolsEnrollCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.enrollvmwarenodepoolrequest = enrollvmwarenodepoolrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsEnrollCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersVmwareNodePoolsEnrollCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsEnrollCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersVmwareNodePoolsEnrollCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsEnrollCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsEnrollCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.enrollvmwarenodepoolrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/vmwareNodePools:enroll") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.enroll" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsVmwareClustersVmwareNodePoolsEnrollCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Enrolls a VMware node pool to Anthos On-Prem API", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools:enroll", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.enroll", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The parent resource where the node pool is enrolled in.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/vmwareNodePools:enroll", + // "request": { + // "$ref": "EnrollVmwareNodePoolRequest" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.get": + +type ProjectsLocationsVmwareClustersVmwareNodePoolsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of a single VMware node pool. +// +// - name: The name of the node pool to retrieve. +// projects/{project}/locations/{location}/vmwareClusters/{cluster}/vmw +// areNodePools/{nodepool}. +func (r *ProjectsLocationsVmwareClustersVmwareNodePoolsService) Get(name string) *ProjectsLocationsVmwareClustersVmwareNodePoolsGetCall { + c := &ProjectsLocationsVmwareClustersVmwareNodePoolsGetCall{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 information. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersVmwareNodePoolsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsVmwareClustersVmwareNodePoolsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsGetCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersVmwareNodePoolsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.get" call. +// Exactly one of *VmwareNodePool or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *VmwareNodePool.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 *ProjectsLocationsVmwareClustersVmwareNodePoolsGetCall) Do(opts ...googleapi.CallOption) (*VmwareNodePool, 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 := &VmwareNodePool{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets details of a single VMware node pool.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The name of the node pool to retrieve. projects/{project}/locations/{location}/vmwareClusters/{cluster}/vmwareNodePools/{nodepool}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "VmwareNodePool" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.getIamPolicy": + +type ProjectsLocationsVmwareClustersVmwareNodePoolsGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - 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 *ProjectsLocationsVmwareClustersVmwareNodePoolsService) GetIamPolicy(resource string) *ProjectsLocationsVmwareClustersVmwareNodePoolsGetIamPolicyCall { + c := &ProjectsLocationsVmwareClustersVmwareNodePoolsGetIamPolicyCall{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 *ProjectsLocationsVmwareClustersVmwareNodePoolsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsVmwareClustersVmwareNodePoolsGetIamPolicyCall { + 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 information. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersVmwareNodePoolsGetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsVmwareClustersVmwareNodePoolsGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersVmwareNodePoolsGetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.getIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. 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 *ProjectsLocationsVmwareClustersVmwareNodePoolsGetIamPolicyCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. 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).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.list": + +type ProjectsLocationsVmwareClustersVmwareNodePoolsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists VMware node pools in a given project, location and VMWare +// cluster. +// +// - parent: The parent, which owns this collection of node pools. +// Format: +// projects/{project}/locations/{location}/vmwareClusters/{vmwareCluste +// r}. +func (r *ProjectsLocationsVmwareClustersVmwareNodePoolsService) List(parent string) *ProjectsLocationsVmwareClustersVmwareNodePoolsListCall { + c := &ProjectsLocationsVmwareClustersVmwareNodePoolsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number +// of node pools to return. The service may return fewer than this +// value. If unspecified, at most 50 node pools will be returned. The +// maximum value is 1000; values above 1000 will be coerced to 1000. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsListCall) PageSize(pageSize int64) *ProjectsLocationsVmwareClustersVmwareNodePoolsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, +// received from a previous `ListVmwareNodePools` call. Provide this to +// retrieve the subsequent page. When paginating, all other parameters +// provided to `ListVmwareNodePools` must match the call that provided +// the page token. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsListCall) PageToken(pageToken string) *ProjectsLocationsVmwareClustersVmwareNodePoolsListCall { + 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 information. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersVmwareNodePoolsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsVmwareClustersVmwareNodePoolsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsListCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersVmwareNodePoolsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/vmwareNodePools") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.list" call. +// Exactly one of *ListVmwareNodePoolsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *ListVmwareNodePoolsResponse.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 *ProjectsLocationsVmwareClustersVmwareNodePoolsListCall) Do(opts ...googleapi.CallOption) (*ListVmwareNodePoolsResponse, 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 := &ListVmwareNodePoolsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists VMware node pools in a given project, location and VMWare cluster.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "The maximum number of node pools to return. The service may return fewer than this value. If unspecified, at most 50 node pools will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "A page token, received from a previous `ListVmwareNodePools` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListVmwareNodePools` must match the call that provided the page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The parent, which owns this collection of node pools. Format: projects/{project}/locations/{location}/vmwareClusters/{vmwareCluster}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/vmwareNodePools", + // "response": { + // "$ref": "ListVmwareNodePoolsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsVmwareClustersVmwareNodePoolsListCall) Pages(ctx context.Context, f func(*ListVmwareNodePoolsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.patch": + +type ProjectsLocationsVmwareClustersVmwareNodePoolsPatchCall struct { + s *Service + name string + vmwarenodepool *VmwareNodePool + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the parameters of a single VMware node pool. +// +// - name: Immutable. The resource name of this node pool. +func (r *ProjectsLocationsVmwareClustersVmwareNodePoolsService) Patch(name string, vmwarenodepool *VmwareNodePool) *ProjectsLocationsVmwareClustersVmwareNodePoolsPatchCall { + c := &ProjectsLocationsVmwareClustersVmwareNodePoolsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.vmwarenodepool = vmwarenodepool + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Field +// mask is used to specify the fields to be overwritten in the +// VMwareNodePool resource by the update. The fields specified in the +// update_mask are relative to the resource, not the full request. A +// field will be overwritten if it is in the mask. If the user does not +// provide a mask then all populated fields in the VMwareNodePool +// message will be updated. Empty fields will be ignored unless a field +// mask is used. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsVmwareClustersVmwareNodePoolsPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Validate the +// request without actually doing any updates. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsVmwareClustersVmwareNodePoolsPatchCall { + 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 information. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersVmwareNodePoolsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsPatchCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersVmwareNodePoolsPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.vmwarenodepool) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + 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, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.patch" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsVmwareClustersVmwareNodePoolsPatchCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates the parameters of a single VMware node pool.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}", + // "httpMethod": "PATCH", + // "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Immutable. The resource name of this node pool.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Required. Field mask is used to specify the fields to be overwritten in the VMwareNodePool resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all populated fields in the VMwareNodePool message will be updated. Empty fields will be ignored unless a field mask is used.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // }, + // "validateOnly": { + // "description": "Validate the request without actually doing any updates.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "VmwareNodePool" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.setIamPolicy": + +type ProjectsLocationsVmwareClustersVmwareNodePoolsSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - 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 *ProjectsLocationsVmwareClustersVmwareNodePoolsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsVmwareClustersVmwareNodePoolsSetIamPolicyCall { + c := &ProjectsLocationsVmwareClustersVmwareNodePoolsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersVmwareNodePoolsSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersVmwareNodePoolsSetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.setIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. 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 *ProjectsLocationsVmwareClustersVmwareNodePoolsSetIamPolicyCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "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.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.testIamPermissions": + +type ProjectsLocationsVmwareClustersVmwareNodePoolsTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the +// appropriate value for this field. +func (r *ProjectsLocationsVmwareClustersVmwareNodePoolsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsVmwareClustersVmwareNodePoolsTestIamPermissionsCall { + c := &ProjectsLocationsVmwareClustersVmwareNodePoolsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersVmwareNodePoolsTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersVmwareNodePoolsTestIamPermissionsCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.testIamPermissions" call. +// Exactly one of *TestIamPermissionsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.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 *ProjectsLocationsVmwareClustersVmwareNodePoolsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, 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 := &TestIamPermissionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.unenroll": + +type ProjectsLocationsVmwareClustersVmwareNodePoolsUnenrollCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Unenroll: Unenrolls a VMware node pool to Anthos On-Prem API +// +// - name: The name of the node pool to unenroll. Format: +// projects/{project}/locations/{location}/vmwareClusters/{cluster}/vmw +// areNodePools/{nodepool}. +func (r *ProjectsLocationsVmwareClustersVmwareNodePoolsService) Unenroll(name string) *ProjectsLocationsVmwareClustersVmwareNodePoolsUnenrollCall { + c := &ProjectsLocationsVmwareClustersVmwareNodePoolsUnenrollCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Etag sets the optional parameter "etag": The current etag of the +// VMware node pool. If an etag is provided and does not match the +// current etag of node pool, deletion will be blocked and an ABORTED +// error will be returned. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsUnenrollCall) Etag(etag string) *ProjectsLocationsVmwareClustersVmwareNodePoolsUnenrollCall { + c.urlParams_.Set("etag", etag) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, only +// validate the request, but do not actually unenroll the node pool. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsUnenrollCall) ValidateOnly(validateOnly bool) *ProjectsLocationsVmwareClustersVmwareNodePoolsUnenrollCall { + 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 information. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsUnenrollCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersVmwareNodePoolsUnenrollCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsUnenrollCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersVmwareNodePoolsUnenrollCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsUnenrollCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsUnenrollCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:unenroll") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.unenroll" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsVmwareClustersVmwareNodePoolsUnenrollCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Unenrolls a VMware node pool to Anthos On-Prem API", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}:unenroll", + // "httpMethod": "DELETE", + // "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.unenroll", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "etag": { + // "description": "The current etag of the VMware node pool. If an etag is provided and does not match the current etag of node pool, deletion will be blocked and an ABORTED error will be returned.", + // "location": "query", + // "type": "string" + // }, + // "name": { + // "description": "Required. The name of the node pool to unenroll. Format: projects/{project}/locations/{location}/vmwareClusters/{cluster}/vmwareNodePools/{nodepool}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "If set, only validate the request, but do not actually unenroll the node pool.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v1/{+name}:unenroll", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.operations.get": + +type ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsGetCall 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 *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsService) Get(name string) *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsGetCall { + c := &ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsGetCall{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 information. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.operations.get" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsGetCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.operations.list": + +type ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall 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 *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsService) List(name string) *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall { + c := &ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall) Filter(filter string) *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall) PageToken(pageToken string) *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall { + 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 information. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall) Context(ctx context.Context) *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.operations.list" call. +// Exactly one of *ListOperationsResponse or error will be non-nil. 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 *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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}/vmwareClusters/{vmwareClustersId}/vmwareNodePools/{vmwareNodePoolsId}/operations", + // "httpMethod": "GET", + // "id": "gkeonprem.projects.locations.vmwareClusters.vmwareNodePools.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/[^/]+/vmwareClusters/[^/]+/vmwareNodePools/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "pageSize": { + // "description": "The standard list page size.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The standard list page token.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}/operations", + // "response": { + // "$ref": "ListOperationsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsVmwareClustersVmwareNodePoolsOperationsListCall) Pages(ctx context.Context, f func(*ListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} diff --git a/healthcare/v1/healthcare-api.json b/healthcare/v1/healthcare-api.json index 5515563611d..e0083a97d86 100644 --- a/healthcare/v1/healthcare-api.json +++ b/healthcare/v1/healthcare-api.json @@ -4078,7 +4078,7 @@ } } }, - "revision": "20230412", + "revision": "20230427", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "ActivateConsentRequest": { @@ -4653,6 +4653,10 @@ "text": { "$ref": "TextConfig", "description": "Configures de-identification of text wherever it is found in the source_dataset." + }, + "useRegionalDataProcessing": { + "description": "Ensures in-flight data remains in the region of origin during de-identification. Using this option results in a significant reduction of throughput, and is not compatible with `LOCATION` or `ORGANIZATION_NAME` infoTypes. `LOCATION` must be excluded within `TextConfig`, and must also be excluded within `ImageConfig` if image redaction is required.", + "type": "boolean" } }, "type": "object" @@ -6074,7 +6078,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -6792,6 +6796,20 @@ "TextConfig": { "id": "TextConfig", "properties": { + "additionalTransformations": { + "description": "Transformations to apply to the detected data, overridden by `exclude_info_types`.", + "items": { + "$ref": "InfoTypeTransformation" + }, + "type": "array" + }, + "excludeInfoTypes": { + "description": "InfoTypes to skip transforming, overriding `additional_transformations`.", + "items": { + "type": "string" + }, + "type": "array" + }, "transformations": { "description": "The transformations to apply to the detected data. Deprecated. Use `additional_transformations` instead.", "items": { diff --git a/healthcare/v1/healthcare-gen.go b/healthcare/v1/healthcare-gen.go index 0ba7dd53bc3..aa53c1abc6c 100644 --- a/healthcare/v1/healthcare-gen.go +++ b/healthcare/v1/healthcare-gen.go @@ -1430,6 +1430,14 @@ type DeidentifyConfig struct { // the source_dataset. Text *TextConfig `json:"text,omitempty"` + // UseRegionalDataProcessing: Ensures in-flight data remains in the + // region of origin during de-identification. Using this option results + // in a significant reduction of throughput, and is not compatible with + // `LOCATION` or `ORGANIZATION_NAME` infoTypes. `LOCATION` must be + // excluded within `TextConfig`, and must also be excluded within + // `ImageConfig` if image redaction is required. + UseRegionalDataProcessing bool `json:"useRegionalDataProcessing,omitempty"` + // ForceSendFields is a list of field names (e.g. "Dicom") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -4431,7 +4439,7 @@ func (s *ListUserDataMappingsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -5834,25 +5842,34 @@ func (s *TestIamPermissionsResponse) MarshalJSON() ([]byte, error) { } type TextConfig struct { + // AdditionalTransformations: Transformations to apply to the detected + // data, overridden by `exclude_info_types`. + AdditionalTransformations []*InfoTypeTransformation `json:"additionalTransformations,omitempty"` + + // ExcludeInfoTypes: InfoTypes to skip transforming, overriding + // `additional_transformations`. + ExcludeInfoTypes []string `json:"excludeInfoTypes,omitempty"` + // Transformations: The transformations to apply to the detected data. // Deprecated. Use `additional_transformations` instead. Transformations []*InfoTypeTransformation `json:"transformations,omitempty"` - // ForceSendFields is a list of field names (e.g. "Transformations") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. + // ForceSendFields is a list of field names (e.g. + // "AdditionalTransformations") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted + // from API requests. However, any non-pointer, non-interface field + // appearing in ForceSendFields will be sent to the server regardless of + // whether the field is empty or not. This may be used to include empty + // fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Transformations") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the - // server as null. It is an error if a field in this list has a - // non-empty value. This may be used to include null fields in Patch - // requests. + // NullFields is a list of field names (e.g. + // "AdditionalTransformations") to include in API requests with the JSON + // null value. By default, fields with empty values are omitted from API + // requests. However, any field with an empty value appearing in + // NullFields will be sent to the server as null. It is an error if a + // field in this list has a non-empty value. This may be used to include + // null fields in Patch requests. NullFields []string `json:"-"` } diff --git a/healthcare/v1beta1/healthcare-api.json b/healthcare/v1beta1/healthcare-api.json index 19b4cfd1f22..13a538892c5 100644 --- a/healthcare/v1beta1/healthcare-api.json +++ b/healthcare/v1beta1/healthcare-api.json @@ -4941,7 +4941,7 @@ } } }, - "revision": "20230412", + "revision": "20230427", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "Action": { @@ -5759,6 +5759,10 @@ "text": { "$ref": "TextConfig", "description": "Configures de-identification of text wherever it is found in the source_dataset." + }, + "useRegionalDataProcessing": { + "description": "Ensures in-flight data remains in the region of origin during de-identification. Using this option results in a significant reduction of throughput, and is not compatible with `LOCATION` or `ORGANIZATION_NAME` infoTypes. If the deprecated [`DicomConfig`](google.cloud.healthcare.v1beta1.deidentify.DeidentifyConfig.dicom_config) or [`FhirConfig`](google.cloud.healthcare.v1beta1.deidentify.DeidentifyConfig.fhir_config) are used, then `LOCATION` must be excluded within `TextConfig`, and must also be excluded within `ImageConfig` if image redaction is required.", + "type": "boolean" } }, "type": "object" @@ -7670,7 +7674,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/healthcare/v1beta1/healthcare-gen.go b/healthcare/v1beta1/healthcare-gen.go index ac48f3015b3..2f621e09c1a 100644 --- a/healthcare/v1beta1/healthcare-gen.go +++ b/healthcare/v1beta1/healthcare-gen.go @@ -1899,6 +1899,19 @@ type DeidentifyConfig struct { // the source_dataset. Text *TextConfig `json:"text,omitempty"` + // UseRegionalDataProcessing: Ensures in-flight data remains in the + // region of origin during de-identification. Using this option results + // in a significant reduction of throughput, and is not compatible with + // `LOCATION` or `ORGANIZATION_NAME` infoTypes. If the deprecated + // `DicomConfig` + // (google.cloud.healthcare.v1beta1.deidentify.DeidentifyConfig.dicom_con + // fig) or `FhirConfig` + // (google.cloud.healthcare.v1beta1.deidentify.DeidentifyConfig.fhir_conf + // ig) are used, then `LOCATION` must be excluded within `TextConfig`, + // and must also be excluded within `ImageConfig` if image redaction is + // required. + UseRegionalDataProcessing bool `json:"useRegionalDataProcessing,omitempty"` + // ForceSendFields is a list of field names (e.g. "Annotation") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -5857,7 +5870,7 @@ func (s *ListUserDataMappingsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/iam/v1/iam-api.json b/iam/v1/iam-api.json index 051e44048f2..89171e32376 100644 --- a/iam/v1/iam-api.json +++ b/iam/v1/iam-api.json @@ -2284,6 +2284,7 @@ ] }, "signBlob": { + "deprecated": true, "description": "**Note:** This method is deprecated. Use the [`signBlob`](https://cloud.google.com/iam/help/rest-credentials/v1/projects.serviceAccounts/signBlob) method in the IAM Service Account Credentials API instead. If you currently use this method, see the [migration guide](https://cloud.google.com/iam/help/credentials/migrate-api) for instructions. Signs a blob using the system-managed private key for a ServiceAccount.", "flatPath": "v1/projects/{projectsId}/serviceAccounts/{serviceAccountsId}:signBlob", "httpMethod": "POST", @@ -2312,6 +2313,7 @@ ] }, "signJwt": { + "deprecated": true, "description": "**Note:** This method is deprecated. Use the [`signJwt`](https://cloud.google.com/iam/help/rest-credentials/v1/projects.serviceAccounts/signJwt) method in the IAM Service Account Credentials API instead. If you currently use this method, see the [migration guide](https://cloud.google.com/iam/help/credentials/migrate-api) for instructions. Signs a JSON Web Token (JWT) using the system-managed private key for a ServiceAccount.", "flatPath": "v1/projects/{projectsId}/serviceAccounts/{serviceAccountsId}:signJwt", "httpMethod": "POST", @@ -2749,7 +2751,7 @@ } } }, - "revision": "20230406", + "revision": "20230427", "rootUrl": "https://iam.googleapis.com/", "schemas": { "AdminAuditData": { @@ -3051,6 +3053,41 @@ "issuerUri": { "description": "Required. The OIDC issuer URI. Must be a valid URI using the 'https' scheme.", "type": "string" + }, + "webSsoConfig": { + "$ref": "GoogleIamAdminV1WorkforcePoolProviderOidcWebSsoConfig", + "description": "Required. Configuration for web single sign-on for the OIDC provider. Here, web sign-in refers to console sign-in and gcloud sign-in through the browser." + } + }, + "type": "object" + }, + "GoogleIamAdminV1WorkforcePoolProviderOidcWebSsoConfig": { + "description": "Configuration for web single sign-on for the OIDC provider.", + "id": "GoogleIamAdminV1WorkforcePoolProviderOidcWebSsoConfig", + "properties": { + "assertionClaimsBehavior": { + "description": "Required. The behavior for how OIDC Claims are included in the `assertion` object used for attribute mapping and attribute condition.", + "enum": [ + "ASSERTION_CLAIMS_BEHAVIOR_UNSPECIFIED", + "ONLY_ID_TOKEN_CLAIMS" + ], + "enumDescriptions": [ + "No assertion claims behavior specified.", + "Only include ID Token Claims." + ], + "type": "string" + }, + "responseType": { + "description": "Required. The Response Type to request for in the OIDC Authorization Request for web sign-in.", + "enum": [ + "RESPONSE_TYPE_UNSPECIFIED", + "ID_TOKEN" + ], + "enumDescriptions": [ + "No Response Type specified.", + "The `response_type=id_token` selection uses the Implicit Flow for web sign-in." + ], + "type": "string" } }, "type": "object" @@ -4089,7 +4126,7 @@ "type": "string" }, "disabled": { - "description": "Whether the pool is disabled. You cannot use a disabled pool to exchange tokens, or use existing tokens to access resources. If the pool is re-enabled, existing tokens grant access again.", + "description": "Disables the workforce pool. You cannot use a disabled pool to exchange tokens, or use existing tokens to access resources. If the pool is re-enabled, existing tokens grant access again.", "type": "boolean" }, "displayName": { @@ -4148,7 +4185,7 @@ "type": "string" }, "disabled": { - "description": "Whether the provider is disabled. You cannot use a disabled provider to exchange tokens. However, existing tokens still grant access.", + "description": "Disables the workforce pool provider. You cannot use a disabled provider to exchange tokens. However, existing tokens still grant access.", "type": "boolean" }, "displayName": { diff --git a/iam/v1/iam-gen.go b/iam/v1/iam-gen.go index 8b5827d98c5..86717a7a869 100644 --- a/iam/v1/iam-gen.go +++ b/iam/v1/iam-gen.go @@ -1065,6 +1065,11 @@ type GoogleIamAdminV1WorkforcePoolProviderOidc struct { // the 'https' scheme. IssuerUri string `json:"issuerUri,omitempty"` + // WebSsoConfig: Required. Configuration for web single sign-on for the + // OIDC provider. Here, web sign-in refers to console sign-in and gcloud + // sign-in through the browser. + WebSsoConfig *GoogleIamAdminV1WorkforcePoolProviderOidcWebSsoConfig `json:"webSsoConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "ClientId") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -1088,6 +1093,53 @@ func (s *GoogleIamAdminV1WorkforcePoolProviderOidc) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleIamAdminV1WorkforcePoolProviderOidcWebSsoConfig: Configuration +// for web single sign-on for the OIDC provider. +type GoogleIamAdminV1WorkforcePoolProviderOidcWebSsoConfig struct { + // AssertionClaimsBehavior: Required. The behavior for how OIDC Claims + // are included in the `assertion` object used for attribute mapping and + // attribute condition. + // + // Possible values: + // "ASSERTION_CLAIMS_BEHAVIOR_UNSPECIFIED" - No assertion claims + // behavior specified. + // "ONLY_ID_TOKEN_CLAIMS" - Only include ID Token Claims. + AssertionClaimsBehavior string `json:"assertionClaimsBehavior,omitempty"` + + // ResponseType: Required. The Response Type to request for in the OIDC + // Authorization Request for web sign-in. + // + // Possible values: + // "RESPONSE_TYPE_UNSPECIFIED" - No Response Type specified. + // "ID_TOKEN" - The `response_type=id_token` selection uses the + // Implicit Flow for web sign-in. + ResponseType string `json:"responseType,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "AssertionClaimsBehavior") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted + // from API requests. However, any non-pointer, non-interface field + // appearing in ForceSendFields will be sent to the server regardless of + // whether the field is empty or not. This may be used to include empty + // fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AssertionClaimsBehavior") + // to include in API requests with the JSON null value. By default, + // fields with empty values are omitted from API requests. However, any + // field with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleIamAdminV1WorkforcePoolProviderOidcWebSsoConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamAdminV1WorkforcePoolProviderOidcWebSsoConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleIamAdminV1WorkforcePoolProviderSaml: Represents a SAML identity // provider. type GoogleIamAdminV1WorkforcePoolProviderSaml struct { @@ -3037,9 +3089,9 @@ type WorkforcePool struct { // 256 characters. Description string `json:"description,omitempty"` - // Disabled: Whether the pool is disabled. You cannot use a disabled - // pool to exchange tokens, or use existing tokens to access resources. - // If the pool is re-enabled, existing tokens grant access again. + // Disabled: Disables the workforce pool. You cannot use a disabled pool + // to exchange tokens, or use existing tokens to access resources. If + // the pool is re-enabled, existing tokens grant access again. Disabled bool `json:"disabled,omitempty"` // DisplayName: A user-specified display name of the pool in Google @@ -3178,9 +3230,9 @@ type WorkforcePoolProvider struct { // exceed 256 characters. Description string `json:"description,omitempty"` - // Disabled: Whether the provider is disabled. You cannot use a disabled - // provider to exchange tokens. However, existing tokens still grant - // access. + // Disabled: Disables the workforce pool provider. You cannot use a + // disabled provider to exchange tokens. However, existing tokens still + // grant access. Disabled bool `json:"disabled,omitempty"` // DisplayName: A user-specified display name for the provider. Cannot @@ -14960,6 +15012,7 @@ func (c *ProjectsServiceAccountsSignBlobCall) Do(opts ...googleapi.CallOption) ( } return ret, nil // { + // "deprecated": true, // "description": "**Note:** This method is deprecated. Use the [`signBlob`](https://cloud.google.com/iam/help/rest-credentials/v1/projects.serviceAccounts/signBlob) method in the IAM Service Account Credentials API instead. If you currently use this method, see the [migration guide](https://cloud.google.com/iam/help/credentials/migrate-api) for instructions. Signs a blob using the system-managed private key for a ServiceAccount.", // "flatPath": "v1/projects/{projectsId}/serviceAccounts/{serviceAccountsId}:signBlob", // "httpMethod": "POST", @@ -15121,6 +15174,7 @@ func (c *ProjectsServiceAccountsSignJwtCall) Do(opts ...googleapi.CallOption) (* } return ret, nil // { + // "deprecated": true, // "description": "**Note:** This method is deprecated. Use the [`signJwt`](https://cloud.google.com/iam/help/rest-credentials/v1/projects.serviceAccounts/signJwt) method in the IAM Service Account Credentials API instead. If you currently use this method, see the [migration guide](https://cloud.google.com/iam/help/credentials/migrate-api) for instructions. Signs a JSON Web Token (JWT) using the system-managed private key for a ServiceAccount.", // "flatPath": "v1/projects/{projectsId}/serviceAccounts/{serviceAccountsId}:signJwt", // "httpMethod": "POST", diff --git a/integrations/v1alpha/integrations-api.json b/integrations/v1alpha/integrations-api.json index 6587573eceb..b44b812ee7e 100644 --- a/integrations/v1alpha/integrations-api.json +++ b/integrations/v1alpha/integrations-api.json @@ -3202,7 +3202,7 @@ } } }, - "revision": "20230409", + "revision": "20230502", "rootUrl": "https://integrations.googleapis.com/", "schemas": { "CrmlogErrorCode": { @@ -3701,6 +3701,10 @@ "locationName": { "description": "Location name of the key ring, e.g. \"us-west1\".", "type": "string" + }, + "serviceAccount": { + "description": "Optional. The service account used for authentication of this KMS key. If this is not provided, the service account in Client.clientSource will be used.", + "type": "string" } }, "type": "object" @@ -5890,12 +5894,36 @@ "enum": [ "UNSPECIFIED_EXTERNAL_CATEGORY", "CORE", - "CONNECTORS" + "CONNECTORS", + "EXTERNAL_HTTP", + "EXTERNAL_INTEGRATION_SERVICES", + "EXTERNAL_CUSTOMER_ACTIONS", + "EXTERNAL_FLOW_CONTROL", + "EXTERNAL_WORKSPACE", + "EXTERNAL_SECURITY", + "EXTERNAL_DATABASES", + "EXTERNAL_ANALYTICS", + "EXTERNAL_BYOC", + "EXTERNAL_BYOT", + "EXTERNAL_ARTIFICIAL_INTELIGENCE", + "EXTERNAL_DATA_MANIPULATION" ], "enumDescriptions": [ "", "", - "" + "", + "HTTP tasks, e.g. rest api call task", + "Integration services, e.g. connector task", + "Customer ations, e.g. email task", + "Flow control, e.g. while loop task", + "Workspace tasks, e.g. list drive task", + "Security, e.g. kms related tasks", + "Database operation tasks, e.g. read firestore info tasks", + "Analytics tasks, e.g. dataflow creattion tasks", + "BYOC tasks", + "BYOT tasks", + "AI related tasks.", + "Data manipulation related tasks, e.g. data mapping task" ], "type": "string" }, @@ -7687,6 +7715,10 @@ }, "type": "array" }, + "authKey": { + "description": "Identifier key for auth config", + "type": "string" + }, "authType": { "description": "The type of authentication configured.", "enum": [ @@ -7971,6 +8003,21 @@ "description": "Output only. Current status of the connection.", "readOnly": true }, + "subscriptionType": { + "description": "Output only. This subscription type enum value states if the metrics should be sent for billing or not.", + "enum": [ + "SUBSCRIPTION_TYPE_UNSPECIFIED", + "PAY_G", + "PAID" + ], + "enumDescriptions": [ + "Unspecified subscription type.", + "Metrics should be sent for billing for PayG type.", + "Metrics should not be sent for billing for Paid Subscription type." + ], + "readOnly": true, + "type": "string" + }, "suspended": { "description": "Optional. Suspended indicates if a user has suspended a connection or not.", "type": "boolean" @@ -10969,7 +11016,7 @@ "type": "object" }, "GoogleInternalCloudCrmEventbusV3PostToQueueWithTriggerIdRequest": { - "description": "Use this request to post all workflows associated with a given trigger id. Next available id: 10", + "description": "Use this request to post all workflows associated with a given trigger id. Next available id: 11", "id": "GoogleInternalCloudCrmEventbusV3PostToQueueWithTriggerIdRequest", "properties": { "clientId": { @@ -11006,6 +11053,10 @@ "description": "Optional. This is used to de-dup incoming request: if the duplicate request was detected, the response from the previous execution is returned. Must have no more than 36 characters and contain only alphanumeric characters and hyphens.", "type": "string" }, + "resourceName": { + "description": "This field is only required when using Admin Access. The resource name of target, or the parent resource name. For example: \"projects/*/locations/*/integrations/*\"", + "type": "string" + }, "scheduledTime": { "description": "Optional. Time in milliseconds since epoch when the given event would be scheduled.", "format": "int64", diff --git a/integrations/v1alpha/integrations-gen.go b/integrations/v1alpha/integrations-gen.go index e4e6c149f7c..14895e54338 100644 --- a/integrations/v1alpha/integrations-gen.go +++ b/integrations/v1alpha/integrations-gen.go @@ -1029,6 +1029,11 @@ type EnterpriseCrmEventbusProtoCloudKmsConfig struct { // LocationName: Location name of the key ring, e.g. "us-west1". LocationName string `json:"locationName,omitempty"` + // ServiceAccount: Optional. The service account used for authentication + // of this KMS key. If this is not provided, the service account in + // Client.clientSource will be used. + ServiceAccount string `json:"serviceAccount,omitempty"` + // ForceSendFields is a list of field names (e.g. "GcpProjectId") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -4089,6 +4094,22 @@ type EnterpriseCrmEventbusProtoTaskMetadata struct { // "UNSPECIFIED_EXTERNAL_CATEGORY" // "CORE" // "CONNECTORS" + // "EXTERNAL_HTTP" - HTTP tasks, e.g. rest api call task + // "EXTERNAL_INTEGRATION_SERVICES" - Integration services, e.g. + // connector task + // "EXTERNAL_CUSTOMER_ACTIONS" - Customer ations, e.g. email task + // "EXTERNAL_FLOW_CONTROL" - Flow control, e.g. while loop task + // "EXTERNAL_WORKSPACE" - Workspace tasks, e.g. list drive task + // "EXTERNAL_SECURITY" - Security, e.g. kms related tasks + // "EXTERNAL_DATABASES" - Database operation tasks, e.g. read + // firestore info tasks + // "EXTERNAL_ANALYTICS" - Analytics tasks, e.g. dataflow creattion + // tasks + // "EXTERNAL_BYOC" - BYOC tasks + // "EXTERNAL_BYOT" - BYOT tasks + // "EXTERNAL_ARTIFICIAL_INTELIGENCE" - AI related tasks. + // "EXTERNAL_DATA_MANIPULATION" - Data manipulation related tasks, + // e.g. data mapping task ExternalCategory string `json:"externalCategory,omitempty"` // ExternalCategorySequence: Sequence with which the task in specific @@ -6294,6 +6315,9 @@ type GoogleCloudConnectorsV1AuthConfig struct { // AdditionalVariables: List containing additional auth configs. AdditionalVariables []*GoogleCloudConnectorsV1ConfigVariable `json:"additionalVariables,omitempty"` + // AuthKey: Identifier key for auth config + AuthKey string `json:"authKey,omitempty"` + // AuthType: The type of authentication configured. // // Possible values: @@ -6689,6 +6713,16 @@ type GoogleCloudConnectorsV1Connection struct { // Status: Output only. Current status of the connection. Status *GoogleCloudConnectorsV1ConnectionStatus `json:"status,omitempty"` + // SubscriptionType: Output only. This subscription type enum value + // states if the metrics should be sent for billing or not. + // + // Possible values: + // "SUBSCRIPTION_TYPE_UNSPECIFIED" - Unspecified subscription type. + // "PAY_G" - Metrics should be sent for billing for PayG type. + // "PAID" - Metrics should not be sent for billing for Paid + // Subscription type. + SubscriptionType string `json:"subscriptionType,omitempty"` + // Suspended: Optional. Suspended indicates if a user has suspended a // connection or not. Suspended bool `json:"suspended,omitempty"` @@ -11124,7 +11158,7 @@ func (s *GoogleCloudIntegrationsV1alphaValueType) UnmarshalJSON(data []byte) err // GoogleInternalCloudCrmEventbusV3PostToQueueWithTriggerIdRequest: Use // this request to post all workflows associated with a given trigger -// id. Next available id: 10 +// id. Next available id: 11 type GoogleInternalCloudCrmEventbusV3PostToQueueWithTriggerIdRequest struct { // ClientId: Optional. If the client id is provided, then the // combination of trigger id and client id is matched across all the @@ -11175,6 +11209,11 @@ type GoogleInternalCloudCrmEventbusV3PostToQueueWithTriggerIdRequest struct { // contain only alphanumeric characters and hyphens. RequestId string `json:"requestId,omitempty"` + // ResourceName: This field is only required when using Admin Access. + // The resource name of target, or the parent resource name. For + // example: "projects/*/locations/*/integrations/*" + ResourceName string `json:"resourceName,omitempty"` + // ScheduledTime: Optional. Time in milliseconds since epoch when the // given event would be scheduled. ScheduledTime int64 `json:"scheduledTime,omitempty,string"` diff --git a/logging/v2/logging-api.json b/logging/v2/logging-api.json index 428112f28e3..b3c7a8d5682 100644 --- a/logging/v2/logging-api.json +++ b/logging/v2/logging-api.json @@ -7007,7 +7007,7 @@ } } }, - "revision": "20230331", + "revision": "20230421", "rootUrl": "https://logging.googleapis.com/", "schemas": { "BigQueryDataset": { @@ -7798,7 +7798,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/logging/v2/logging-gen.go b/logging/v2/logging-gen.go index b96ddd31bc5..f54adeefe30 100644 --- a/logging/v2/logging-gen.go +++ b/logging/v2/logging-gen.go @@ -2286,7 +2286,7 @@ func (s *ListViewsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/memcache/v1/memcache-api.json b/memcache/v1/memcache-api.json index 47853dfbf66..b6cedb02d04 100644 --- a/memcache/v1/memcache-api.json +++ b/memcache/v1/memcache-api.json @@ -556,7 +556,7 @@ } } }, - "revision": "20230316", + "revision": "20230420", "rootUrl": "https://memcache.googleapis.com/", "schemas": { "ApplyParametersRequest": { @@ -1223,7 +1223,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/memcache/v1/memcache-gen.go b/memcache/v1/memcache-gen.go index 0d58d5c9dcb..9c1dda4968b 100644 --- a/memcache/v1/memcache-gen.go +++ b/memcache/v1/memcache-gen.go @@ -1243,7 +1243,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/memcache/v1beta2/memcache-api.json b/memcache/v1beta2/memcache-api.json index 9d83e0a7444..ad70ee25d25 100644 --- a/memcache/v1beta2/memcache-api.json +++ b/memcache/v1beta2/memcache-api.json @@ -584,7 +584,7 @@ } } }, - "revision": "20230316", + "revision": "20230420", "rootUrl": "https://memcache.googleapis.com/", "schemas": { "ApplyParametersRequest": { @@ -1274,7 +1274,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/memcache/v1beta2/memcache-gen.go b/memcache/v1beta2/memcache-gen.go index 544bb8e70d6..005ab99ec14 100644 --- a/memcache/v1beta2/memcache-gen.go +++ b/memcache/v1beta2/memcache-gen.go @@ -1280,7 +1280,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/metastore/v1/metastore-api.json b/metastore/v1/metastore-api.json index 62a1270655b..916964a04d3 100644 --- a/metastore/v1/metastore-api.json +++ b/metastore/v1/metastore-api.json @@ -571,6 +571,34 @@ }, "services": { "methods": { + "alterLocation": { + "description": "Alter metadata resource location. The metadata resource can be a database, table, or partition. This functionality only updates the parent directory for the respective metadata resource and does not transfer any existing data to the new location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}:alterLocation", + "httpMethod": "POST", + "id": "metastore.projects.locations.services.alterLocation", + "parameterOrder": [ + "service" + ], + "parameters": { + "service": { + "description": "Required. The relative resource name of the metastore service to mutate metadata, in the following format:projects/{project_id}/locations/{location_id}/services/{service_id}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+service}:alterLocation", + "request": { + "$ref": "AlterMetadataResourceLocationRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "create": { "description": "Creates a metastore service in a project and location.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services", @@ -769,6 +797,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "moveTableToDatabase": { + "description": "Move a table to another database.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}:moveTableToDatabase", + "httpMethod": "POST", + "id": "metastore.projects.locations.services.moveTableToDatabase", + "parameterOrder": [ + "service" + ], + "parameters": { + "service": { + "description": "Required. The relative resource name of the metastore service to mutate metadata, in the following format:projects/{project_id}/locations/{location_id}/services/{service_id}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+service}:moveTableToDatabase", + "request": { + "$ref": "MoveTableToDatabaseRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "patch": { "description": "Updates the parameters of a single service.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}", @@ -808,6 +864,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "queryMetadata": { + "description": "Query DPMS metadata.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}:queryMetadata", + "httpMethod": "POST", + "id": "metastore.projects.locations.services.queryMetadata", + "parameterOrder": [ + "service" + ], + "parameters": { + "service": { + "description": "Required. The relative resource name of the metastore service to query metadata, in the following format:projects/{project_id}/locations/{location_id}/services/{service_id}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+service}:queryMetadata", + "request": { + "$ref": "QueryMetadataRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "restore": { "description": "Restores a service from a backup.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}:restore", @@ -1255,9 +1339,30 @@ } } }, - "revision": "20230305", + "revision": "20230502", "rootUrl": "https://metastore.googleapis.com/", "schemas": { + "AlterMetadataResourceLocationRequest": { + "description": "Request message for DataprocMetastore.AlterMetadataResourceLocation.", + "id": "AlterMetadataResourceLocationRequest", + "properties": { + "locationUri": { + "description": "Required. The new location URI for the metadata resource.", + "type": "string" + }, + "resourceName": { + "description": "Required. The relative metadata resource name in the following format.databases/{database_id} or databases/{database_id}/tables/{table_id} or databases/{database_id}/tables/{table_id}/partitions/{partition_id}", + "type": "string" + } + }, + "type": "object" + }, + "AlterMetadataResourceLocationResponse": { + "description": "Response message for DataprocMetastore.AlterMetadataResourceLocation.", + "id": "AlterMetadataResourceLocationResponse", + "properties": {}, + "type": "object" + }, "AuditConfig": { "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs.If there are AuditConfigs for both allServices and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted.Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts jose@example.com from DATA_READ logging, and aliya@example.com from DATA_WRITE logging.", "id": "AuditConfig", @@ -1515,6 +1620,20 @@ }, "type": "object" }, + "ErrorDetails": { + "description": "Error details in public error message for DataprocMetastore.QueryMetadata.", + "id": "ErrorDetails", + "properties": { + "details": { + "additionalProperties": { + "type": "string" + }, + "description": "Additional structured details about this error.Keys define the failure items. Value describes the exception or details of the item.", + "type": "object" + } + }, + "type": "object" + }, "ExportMetadataRequest": { "description": "Request message for DataprocMetastore.ExportMetadata.", "id": "ExportMetadataRequest", @@ -1844,7 +1963,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -2064,6 +2183,31 @@ }, "type": "object" }, + "MoveTableToDatabaseRequest": { + "description": "Request message for DataprocMetastore.MoveTableToDatabase.", + "id": "MoveTableToDatabaseRequest", + "properties": { + "dbName": { + "description": "Required. The name of the database where the table resides.", + "type": "string" + }, + "destinationDbName": { + "description": "Required. The name of the database where the table should be moved.", + "type": "string" + }, + "tableName": { + "description": "Required. The name of the table to be moved.", + "type": "string" + } + }, + "type": "object" + }, + "MoveTableToDatabaseResponse": { + "description": "Response message for DataprocMetastore.MoveTableToDatabase.", + "id": "MoveTableToDatabaseResponse", + "properties": {}, + "type": "object" + }, "NetworkConfig": { "description": "Network configuration for the Dataproc Metastore service.", "id": "NetworkConfig", @@ -2188,6 +2332,28 @@ }, "type": "object" }, + "QueryMetadataRequest": { + "description": "Request message for DataprocMetastore.QueryMetadata.", + "id": "QueryMetadataRequest", + "properties": { + "query": { + "description": "Required. A read-only SQL query to execute against the metadata database. The query cannot change or mutate the data.", + "type": "string" + } + }, + "type": "object" + }, + "QueryMetadataResponse": { + "description": "Response message for DataprocMetastore.QueryMetadata.", + "id": "QueryMetadataResponse", + "properties": { + "resultManifestUri": { + "description": "The manifest URI is link to a JSON instance in Cloud Storage. This instance manifests immediately along with QueryMetadataResponse. The content of the URI is not retriable until the long-running operation query against the metadata finishes.", + "type": "string" + } + }, + "type": "object" + }, "Restore": { "description": "The details of a metadata restore operation.", "id": "Restore", diff --git a/metastore/v1/metastore-gen.go b/metastore/v1/metastore-gen.go index 24e3adfce99..c7e7aa8dfae 100644 --- a/metastore/v1/metastore-gen.go +++ b/metastore/v1/metastore-gen.go @@ -219,6 +219,47 @@ type ProjectsLocationsServicesMetadataImportsService struct { s *APIService } +// AlterMetadataResourceLocationRequest: Request message for +// DataprocMetastore.AlterMetadataResourceLocation. +type AlterMetadataResourceLocationRequest struct { + // LocationUri: Required. The new location URI for the metadata + // resource. + LocationUri string `json:"locationUri,omitempty"` + + // ResourceName: Required. The relative metadata resource name in the + // following format.databases/{database_id} or + // databases/{database_id}/tables/{table_id} or + // databases/{database_id}/tables/{table_id}/partitions/{partition_id} + ResourceName string `json:"resourceName,omitempty"` + + // ForceSendFields is a list of field names (e.g. "LocationUri") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "LocationUri") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *AlterMetadataResourceLocationRequest) MarshalJSON() ([]byte, error) { + type NoMethod AlterMetadataResourceLocationRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// AlterMetadataResourceLocationResponse: Response message for +// DataprocMetastore.AlterMetadataResourceLocation. +type AlterMetadataResourceLocationResponse struct { +} + // AuditConfig: Specifies the audit configuration for a service. The // configuration determines which permission types are logged, and what // identities, if any, are exempted from logging. An AuditConfig must @@ -675,6 +716,37 @@ func (s *EncryptionConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ErrorDetails: Error details in public error message for +// DataprocMetastore.QueryMetadata. +type ErrorDetails struct { + // Details: Additional structured details about this error.Keys define + // the failure items. Value describes the exception or details of the + // item. + Details map[string]string `json:"details,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Details") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Details") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ErrorDetails) MarshalJSON() ([]byte, error) { + type NoMethod ErrorDetails + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ExportMetadataRequest: Request message for // DataprocMetastore.ExportMetadata. type ExportMetadataRequest struct { @@ -1242,7 +1314,7 @@ func (s *ListServicesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -1520,6 +1592,47 @@ func (s *MetadataManagementActivity) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// MoveTableToDatabaseRequest: Request message for +// DataprocMetastore.MoveTableToDatabase. +type MoveTableToDatabaseRequest struct { + // DbName: Required. The name of the database where the table resides. + DbName string `json:"dbName,omitempty"` + + // DestinationDbName: Required. The name of the database where the table + // should be moved. + DestinationDbName string `json:"destinationDbName,omitempty"` + + // TableName: Required. The name of the table to be moved. + TableName string `json:"tableName,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DbName") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DbName") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *MoveTableToDatabaseRequest) MarshalJSON() ([]byte, error) { + type NoMethod MoveTableToDatabaseRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// MoveTableToDatabaseResponse: Response message for +// DataprocMetastore.MoveTableToDatabase. +type MoveTableToDatabaseResponse struct { +} + // NetworkConfig: Network configuration for the Dataproc Metastore // service. type NetworkConfig struct { @@ -1772,6 +1885,69 @@ func (s *Policy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// QueryMetadataRequest: Request message for +// DataprocMetastore.QueryMetadata. +type QueryMetadataRequest struct { + // Query: Required. A read-only SQL query to execute against the + // metadata database. The query cannot change or mutate the data. + Query string `json:"query,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Query") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Query") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *QueryMetadataRequest) MarshalJSON() ([]byte, error) { + type NoMethod QueryMetadataRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// QueryMetadataResponse: Response message for +// DataprocMetastore.QueryMetadata. +type QueryMetadataResponse struct { + // ResultManifestUri: The manifest URI is link to a JSON instance in + // Cloud Storage. This instance manifests immediately along with + // QueryMetadataResponse. The content of the URI is not retriable until + // the long-running operation query against the metadata finishes. + ResultManifestUri string `json:"resultManifestUri,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ResultManifestUri") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ResultManifestUri") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *QueryMetadataResponse) MarshalJSON() ([]byte, error) { + type NoMethod QueryMetadataResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Restore: The details of a metadata restore operation. type Restore struct { // Backup: Output only. The relative resource name of the metastore @@ -4672,6 +4848,154 @@ func (c *ProjectsLocationsOperationsListCall) Pages(ctx context.Context, f func( } } +// method id "metastore.projects.locations.services.alterLocation": + +type ProjectsLocationsServicesAlterLocationCall struct { + s *APIService + service string + altermetadataresourcelocationrequest *AlterMetadataResourceLocationRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// AlterLocation: Alter metadata resource location. The metadata +// resource can be a database, table, or partition. This functionality +// only updates the parent directory for the respective metadata +// resource and does not transfer any existing data to the new location. +// +// - service: The relative resource name of the metastore service to +// mutate metadata, in the following +// format:projects/{project_id}/locations/{location_id}/services/{servi +// ce_id}. +func (r *ProjectsLocationsServicesService) AlterLocation(service string, altermetadataresourcelocationrequest *AlterMetadataResourceLocationRequest) *ProjectsLocationsServicesAlterLocationCall { + c := &ProjectsLocationsServicesAlterLocationCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.service = service + c.altermetadataresourcelocationrequest = altermetadataresourcelocationrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsServicesAlterLocationCall) Fields(s ...googleapi.Field) *ProjectsLocationsServicesAlterLocationCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsServicesAlterLocationCall) Context(ctx context.Context) *ProjectsLocationsServicesAlterLocationCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsServicesAlterLocationCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsServicesAlterLocationCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.altermetadataresourcelocationrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+service}:alterLocation") + 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{ + "service": c.service, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "metastore.projects.locations.services.alterLocation" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsServicesAlterLocationCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Alter metadata resource location. The metadata resource can be a database, table, or partition. This functionality only updates the parent directory for the respective metadata resource and does not transfer any existing data to the new location.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}:alterLocation", + // "httpMethod": "POST", + // "id": "metastore.projects.locations.services.alterLocation", + // "parameterOrder": [ + // "service" + // ], + // "parameters": { + // "service": { + // "description": "Required. The relative resource name of the metastore service to mutate metadata, in the following format:projects/{project_id}/locations/{location_id}/services/{service_id}.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+service}:alterLocation", + // "request": { + // "$ref": "AlterMetadataResourceLocationRequest" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "metastore.projects.locations.services.create": type ProjectsLocationsServicesCreateCall struct { @@ -5701,6 +6025,151 @@ func (c *ProjectsLocationsServicesListCall) Pages(ctx context.Context, f func(*L } } +// method id "metastore.projects.locations.services.moveTableToDatabase": + +type ProjectsLocationsServicesMoveTableToDatabaseCall struct { + s *APIService + service string + movetabletodatabaserequest *MoveTableToDatabaseRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// MoveTableToDatabase: Move a table to another database. +// +// - service: The relative resource name of the metastore service to +// mutate metadata, in the following +// format:projects/{project_id}/locations/{location_id}/services/{servi +// ce_id}. +func (r *ProjectsLocationsServicesService) MoveTableToDatabase(service string, movetabletodatabaserequest *MoveTableToDatabaseRequest) *ProjectsLocationsServicesMoveTableToDatabaseCall { + c := &ProjectsLocationsServicesMoveTableToDatabaseCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.service = service + c.movetabletodatabaserequest = movetabletodatabaserequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsServicesMoveTableToDatabaseCall) Fields(s ...googleapi.Field) *ProjectsLocationsServicesMoveTableToDatabaseCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsServicesMoveTableToDatabaseCall) Context(ctx context.Context) *ProjectsLocationsServicesMoveTableToDatabaseCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsServicesMoveTableToDatabaseCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsServicesMoveTableToDatabaseCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.movetabletodatabaserequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+service}:moveTableToDatabase") + 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{ + "service": c.service, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "metastore.projects.locations.services.moveTableToDatabase" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsServicesMoveTableToDatabaseCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Move a table to another database.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}:moveTableToDatabase", + // "httpMethod": "POST", + // "id": "metastore.projects.locations.services.moveTableToDatabase", + // "parameterOrder": [ + // "service" + // ], + // "parameters": { + // "service": { + // "description": "Required. The relative resource name of the metastore service to mutate metadata, in the following format:projects/{project_id}/locations/{location_id}/services/{service_id}.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+service}:moveTableToDatabase", + // "request": { + // "$ref": "MoveTableToDatabaseRequest" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "metastore.projects.locations.services.patch": type ProjectsLocationsServicesPatchCall struct { @@ -5882,6 +6351,151 @@ func (c *ProjectsLocationsServicesPatchCall) Do(opts ...googleapi.CallOption) (* } +// method id "metastore.projects.locations.services.queryMetadata": + +type ProjectsLocationsServicesQueryMetadataCall struct { + s *APIService + service string + querymetadatarequest *QueryMetadataRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// QueryMetadata: Query DPMS metadata. +// +// - service: The relative resource name of the metastore service to +// query metadata, in the following +// format:projects/{project_id}/locations/{location_id}/services/{servi +// ce_id}. +func (r *ProjectsLocationsServicesService) QueryMetadata(service string, querymetadatarequest *QueryMetadataRequest) *ProjectsLocationsServicesQueryMetadataCall { + c := &ProjectsLocationsServicesQueryMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.service = service + c.querymetadatarequest = querymetadatarequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsServicesQueryMetadataCall) Fields(s ...googleapi.Field) *ProjectsLocationsServicesQueryMetadataCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsServicesQueryMetadataCall) Context(ctx context.Context) *ProjectsLocationsServicesQueryMetadataCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsServicesQueryMetadataCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsServicesQueryMetadataCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.querymetadatarequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+service}:queryMetadata") + 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{ + "service": c.service, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "metastore.projects.locations.services.queryMetadata" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsLocationsServicesQueryMetadataCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Query DPMS metadata.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}:queryMetadata", + // "httpMethod": "POST", + // "id": "metastore.projects.locations.services.queryMetadata", + // "parameterOrder": [ + // "service" + // ], + // "parameters": { + // "service": { + // "description": "Required. The relative resource name of the metastore service to query metadata, in the following format:projects/{project_id}/locations/{location_id}/services/{service_id}.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+service}:queryMetadata", + // "request": { + // "$ref": "QueryMetadataRequest" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "metastore.projects.locations.services.restore": type ProjectsLocationsServicesRestoreCall struct { diff --git a/metastore/v1alpha/metastore-api.json b/metastore/v1alpha/metastore-api.json index 4c557098143..566f8463917 100644 --- a/metastore/v1alpha/metastore-api.json +++ b/metastore/v1alpha/metastore-api.json @@ -1579,7 +1579,7 @@ } } }, - "revision": "20230317", + "revision": "20230502", "rootUrl": "https://metastore.googleapis.com/", "schemas": { "AlterMetadataResourceLocationRequest": { @@ -1889,6 +1889,20 @@ }, "type": "object" }, + "ErrorDetails": { + "description": "Error details in public error message for DataprocMetastore.QueryMetadata.", + "id": "ErrorDetails", + "properties": { + "details": { + "additionalProperties": { + "type": "string" + }, + "description": "Additional structured details about this error.Keys define the failure items. Value describes the exception or details of the item.", + "type": "object" + } + }, + "type": "object" + }, "ExportMetadataRequest": { "description": "Request message for DataprocMetastore.ExportMetadata.", "id": "ExportMetadataRequest", @@ -2243,7 +2257,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/metastore/v1alpha/metastore-gen.go b/metastore/v1alpha/metastore-gen.go index e36115fbce2..f6f650e9156 100644 --- a/metastore/v1alpha/metastore-gen.go +++ b/metastore/v1alpha/metastore-gen.go @@ -804,6 +804,37 @@ func (s *EncryptionConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ErrorDetails: Error details in public error message for +// DataprocMetastore.QueryMetadata. +type ErrorDetails struct { + // Details: Additional structured details about this error.Keys define + // the failure items. Value describes the exception or details of the + // item. + Details map[string]string `json:"details,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Details") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Details") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ErrorDetails) MarshalJSON() ([]byte, error) { + type NoMethod ErrorDetails + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ExportMetadataRequest: Request message for // DataprocMetastore.ExportMetadata. type ExportMetadataRequest struct { @@ -1411,7 +1442,7 @@ func (s *ListServicesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/metastore/v1beta/metastore-api.json b/metastore/v1beta/metastore-api.json index 9a019902e4a..6e8b5926b31 100644 --- a/metastore/v1beta/metastore-api.json +++ b/metastore/v1beta/metastore-api.json @@ -1579,7 +1579,7 @@ } } }, - "revision": "20230317", + "revision": "20230502", "rootUrl": "https://metastore.googleapis.com/", "schemas": { "AlterMetadataResourceLocationRequest": { @@ -1889,6 +1889,20 @@ }, "type": "object" }, + "ErrorDetails": { + "description": "Error details in public error message for DataprocMetastore.QueryMetadata.", + "id": "ErrorDetails", + "properties": { + "details": { + "additionalProperties": { + "type": "string" + }, + "description": "Additional structured details about this error.Keys define the failure items. Value describes the exception or details of the item.", + "type": "object" + } + }, + "type": "object" + }, "ExportMetadataRequest": { "description": "Request message for DataprocMetastore.ExportMetadata.", "id": "ExportMetadataRequest", @@ -2243,7 +2257,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/metastore/v1beta/metastore-gen.go b/metastore/v1beta/metastore-gen.go index 0b2e5c3c69b..aa9d69699d4 100644 --- a/metastore/v1beta/metastore-gen.go +++ b/metastore/v1beta/metastore-gen.go @@ -804,6 +804,37 @@ func (s *EncryptionConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ErrorDetails: Error details in public error message for +// DataprocMetastore.QueryMetadata. +type ErrorDetails struct { + // Details: Additional structured details about this error.Keys define + // the failure items. Value describes the exception or details of the + // item. + Details map[string]string `json:"details,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Details") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Details") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ErrorDetails) MarshalJSON() ([]byte, error) { + type NoMethod ErrorDetails + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ExportMetadataRequest: Request message for // DataprocMetastore.ExportMetadata. type ExportMetadataRequest struct { @@ -1411,7 +1442,7 @@ func (s *ListServicesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/migrationcenter/v1alpha1/migrationcenter-api.json b/migrationcenter/v1alpha1/migrationcenter-api.json index 9cfab61cbfc..59a2be84f08 100644 --- a/migrationcenter/v1alpha1/migrationcenter-api.json +++ b/migrationcenter/v1alpha1/migrationcenter-api.json @@ -1929,6 +1929,103 @@ "https://www.googleapis.com/auth/cloud-platform" ] } + }, + "resources": { + "errorFrames": { + "methods": { + "get": { + "description": "Gets the details of an error frame.", + "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/sources/{sourcesId}/errorFrames/{errorFramesId}", + "httpMethod": "GET", + "id": "migrationcenter.projects.locations.sources.errorFrames.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the frame to retrieve. Format: projects/{project}/locations/{location}/sources/{source}/errorFrames/{error_frame}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/sources/[^/]+/errorFrames/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "Optional. An optional view mode to control the level of details for the frame. The default is a basic frame view.", + "enum": [ + "ERROR_FRAME_VIEW_UNSPECIFIED", + "ERROR_FRAME_VIEW_BASIC", + "ERROR_FRAME_VIEW_FULL" + ], + "enumDescriptions": [ + "Value is unset. The system will fallback to the default value.", + "Include basic frame data, but not the full contents.", + "Include everything." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1alpha1/{+name}", + "response": { + "$ref": "ErrorFrame" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists all error frames in a given source and location.", + "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/sources/{sourcesId}/errorFrames", + "httpMethod": "GET", + "id": "migrationcenter.projects.locations.sources.errorFrames.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A token identifying a page of results the server should return.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Parent value (the source) for `ListErrorFramesRequest`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/sources/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "Optional. An optional view mode to control the level of details of each error frame. The default is a BASIC frame view.", + "enum": [ + "ERROR_FRAME_VIEW_UNSPECIFIED", + "ERROR_FRAME_VIEW_BASIC", + "ERROR_FRAME_VIEW_FULL" + ], + "enumDescriptions": [ + "Value is unset. The system will fallback to the default value.", + "Include basic frame data, but not the full contents.", + "Include everything." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1alpha1/{+parent}/errorFrames", + "response": { + "$ref": "ListErrorFramesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } } } } @@ -1936,7 +2033,7 @@ } } }, - "revision": "20230414", + "revision": "20230428", "rootUrl": "https://migrationcenter.googleapis.com/", "schemas": { "AddAssetsToGroupRequest": { @@ -2792,6 +2889,37 @@ "properties": {}, "type": "object" }, + "ErrorFrame": { + "description": "Message representing a frame which failed to be processed due to an error.", + "id": "ErrorFrame", + "properties": { + "ingestionTime": { + "description": "Output only. Frame ingestion time.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. The identifier of the ErrorFrame.", + "readOnly": true, + "type": "string" + }, + "originalFrame": { + "$ref": "AssetFrame", + "description": "Output only. The frame that was originally reported.", + "readOnly": true + }, + "violations": { + "description": "Output only. All the violations that were detected for the frame.", + "items": { + "$ref": "FrameViolationEntry" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, "ExecutionReport": { "description": "A resource that reports result of the import job execution.", "id": "ExecutionReport", @@ -2872,6 +3000,21 @@ }, "type": "object" }, + "FrameViolationEntry": { + "description": "A resource that contains a single violation of a reported `AssetFrame` resource.", + "id": "FrameViolationEntry", + "properties": { + "field": { + "description": "The field of the original frame where the violation occurred.", + "type": "string" + }, + "violation": { + "description": "A message describing the violation.", + "type": "string" + } + }, + "type": "object" + }, "Frames": { "description": "Collection of frame data.", "id": "Frames", @@ -3475,6 +3618,31 @@ }, "type": "object" }, + "ListErrorFramesResponse": { + "description": "A response for listing error frames.", + "id": "ListErrorFramesResponse", + "properties": { + "errorFrames": { + "description": "The list of error frames.", + "items": { + "$ref": "ErrorFrame" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token identifying a page of results the server should return.", + "type": "string" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "ListGroupsResponse": { "description": "A response for listing groups.", "id": "ListGroupsResponse", @@ -3687,7 +3855,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -4874,6 +5042,12 @@ "description": "User-friendly display name.", "type": "string" }, + "errorFrameCount": { + "description": "Output only. The number of frames that were reported by the source and contained errors.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, "isManaged": { "description": "If `true`, the source is managed by other service(s).", "type": "boolean" @@ -4894,6 +5068,23 @@ "format": "int32", "type": "integer" }, + "state": { + "description": "Output only. The state of the source.", + "enum": [ + "STATE_UNSPECIFIED", + "ACTIVE", + "DELETING", + "INVALID" + ], + "enumDescriptions": [ + "Unspecified.", + "The source is active and ready to be used.", + "In the process of being deleted.", + "Source is in an invalid state. Asset frames reported to it will be ignored." + ], + "readOnly": true, + "type": "string" + }, "type": { "description": "Data source type.", "enum": [ diff --git a/migrationcenter/v1alpha1/migrationcenter-gen.go b/migrationcenter/v1alpha1/migrationcenter-gen.go index 7c48bc63043..ffee2d0c781 100644 --- a/migrationcenter/v1alpha1/migrationcenter-gen.go +++ b/migrationcenter/v1alpha1/migrationcenter-gen.go @@ -260,11 +260,23 @@ type ProjectsLocationsReportConfigsReportsService struct { func NewProjectsLocationsSourcesService(s *Service) *ProjectsLocationsSourcesService { rs := &ProjectsLocationsSourcesService{s: s} + rs.ErrorFrames = NewProjectsLocationsSourcesErrorFramesService(s) return rs } type ProjectsLocationsSourcesService struct { s *Service + + ErrorFrames *ProjectsLocationsSourcesErrorFramesService +} + +func NewProjectsLocationsSourcesErrorFramesService(s *Service) *ProjectsLocationsSourcesErrorFramesService { + rs := &ProjectsLocationsSourcesErrorFramesService{s: s} + return rs +} + +type ProjectsLocationsSourcesErrorFramesService struct { + s *Service } // AddAssetsToGroupRequest: A request to add assets to a group. @@ -1811,6 +1823,49 @@ type Empty struct { googleapi.ServerResponse `json:"-"` } +// ErrorFrame: Message representing a frame which failed to be processed +// due to an error. +type ErrorFrame struct { + // IngestionTime: Output only. Frame ingestion time. + IngestionTime string `json:"ingestionTime,omitempty"` + + // Name: Output only. The identifier of the ErrorFrame. + Name string `json:"name,omitempty"` + + // OriginalFrame: Output only. The frame that was originally reported. + OriginalFrame *AssetFrame `json:"originalFrame,omitempty"` + + // Violations: Output only. All the violations that were detected for + // the frame. + Violations []*FrameViolationEntry `json:"violations,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "IngestionTime") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "IngestionTime") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ErrorFrame) MarshalJSON() ([]byte, error) { + type NoMethod ErrorFrame + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ExecutionReport: A resource that reports result of the import job // execution. type ExecutionReport struct { @@ -1927,6 +1982,38 @@ func (s *FitDescriptor) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// FrameViolationEntry: A resource that contains a single violation of a +// reported `AssetFrame` resource. +type FrameViolationEntry struct { + // Field: The field of the original frame where the violation occurred. + Field string `json:"field,omitempty"` + + // Violation: A message describing the violation. + Violation string `json:"violation,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Field") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Field") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *FrameViolationEntry) MarshalJSON() ([]byte, error) { + type NoMethod FrameViolationEntry + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Frames: Collection of frame data. type Frames struct { // FramesData: A repeated field of asset data. @@ -2777,6 +2864,45 @@ func (s *ListAssetsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ListErrorFramesResponse: A response for listing error frames. +type ListErrorFramesResponse struct { + // ErrorFrames: The list of error frames. + ErrorFrames []*ErrorFrame `json:"errorFrames,omitempty"` + + // NextPageToken: A token identifying a page of results the server + // should return. + NextPageToken string `json:"nextPageToken,omitempty"` + + // Unreachable: Locations that could not be reached. + 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. "ErrorFrames") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ErrorFrames") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListErrorFramesResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListErrorFramesResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ListGroupsResponse: A response for listing groups. type ListGroupsResponse struct { // Groups: The list of Group @@ -3129,7 +3255,7 @@ func (s *ListSourcesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -5081,6 +5207,10 @@ type Source struct { // DisplayName: User-friendly display name. DisplayName string `json:"displayName,omitempty"` + // ErrorFrameCount: Output only. The number of frames that were reported + // by the source and contained errors. + ErrorFrameCount int64 `json:"errorFrameCount,omitempty"` + // IsManaged: If `true`, the source is managed by other service(s). IsManaged bool `json:"isManaged,omitempty"` @@ -5095,6 +5225,16 @@ type Source struct { // value, the higher the confidence. Priority int64 `json:"priority,omitempty"` + // State: Output only. The state of the source. + // + // Possible values: + // "STATE_UNSPECIFIED" - Unspecified. + // "ACTIVE" - The source is active and ready to be used. + // "DELETING" - In the process of being deleted. + // "INVALID" - Source is in an invalid state. Asset frames reported to + // it will be ignored. + State string `json:"state,omitempty"` + // Type: Data source type. // // Possible values: @@ -14451,3 +14591,414 @@ func (c *ProjectsLocationsSourcesPatchCall) Do(opts ...googleapi.CallOption) (*O // } } + +// method id "migrationcenter.projects.locations.sources.errorFrames.get": + +type ProjectsLocationsSourcesErrorFramesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets the details of an error frame. +// +// - name: The name of the frame to retrieve. Format: +// projects/{project}/locations/{location}/sources/{source}/errorFrames +// /{error_frame}. +func (r *ProjectsLocationsSourcesErrorFramesService) Get(name string) *ProjectsLocationsSourcesErrorFramesGetCall { + c := &ProjectsLocationsSourcesErrorFramesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// View sets the optional parameter "view": An optional view mode to +// control the level of details for the frame. The default is a basic +// frame view. +// +// Possible values: +// +// "ERROR_FRAME_VIEW_UNSPECIFIED" - Value is unset. The system will +// +// fallback to the default value. +// +// "ERROR_FRAME_VIEW_BASIC" - Include basic frame data, but not the +// +// full contents. +// +// "ERROR_FRAME_VIEW_FULL" - Include everything. +func (c *ProjectsLocationsSourcesErrorFramesGetCall) View(view string) *ProjectsLocationsSourcesErrorFramesGetCall { + c.urlParams_.Set("view", view) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsSourcesErrorFramesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsSourcesErrorFramesGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsSourcesErrorFramesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsSourcesErrorFramesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsSourcesErrorFramesGetCall) Context(ctx context.Context) *ProjectsLocationsSourcesErrorFramesGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsSourcesErrorFramesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsSourcesErrorFramesGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "migrationcenter.projects.locations.sources.errorFrames.get" call. +// Exactly one of *ErrorFrame or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *ErrorFrame.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 *ProjectsLocationsSourcesErrorFramesGetCall) Do(opts ...googleapi.CallOption) (*ErrorFrame, 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 := &ErrorFrame{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets the details of an error frame.", + // "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/sources/{sourcesId}/errorFrames/{errorFramesId}", + // "httpMethod": "GET", + // "id": "migrationcenter.projects.locations.sources.errorFrames.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The name of the frame to retrieve. Format: projects/{project}/locations/{location}/sources/{source}/errorFrames/{error_frame}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/sources/[^/]+/errorFrames/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "view": { + // "description": "Optional. An optional view mode to control the level of details for the frame. The default is a basic frame view.", + // "enum": [ + // "ERROR_FRAME_VIEW_UNSPECIFIED", + // "ERROR_FRAME_VIEW_BASIC", + // "ERROR_FRAME_VIEW_FULL" + // ], + // "enumDescriptions": [ + // "Value is unset. The system will fallback to the default value.", + // "Include basic frame data, but not the full contents.", + // "Include everything." + // ], + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1alpha1/{+name}", + // "response": { + // "$ref": "ErrorFrame" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "migrationcenter.projects.locations.sources.errorFrames.list": + +type ProjectsLocationsSourcesErrorFramesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists all error frames in a given source and location. +// +// - parent: Parent value (the source) for `ListErrorFramesRequest`. +func (r *ProjectsLocationsSourcesErrorFramesService) List(parent string) *ProjectsLocationsSourcesErrorFramesListCall { + c := &ProjectsLocationsSourcesErrorFramesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + 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. +func (c *ProjectsLocationsSourcesErrorFramesListCall) PageSize(pageSize int64) *ProjectsLocationsSourcesErrorFramesListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A token +// identifying a page of results the server should return. +func (c *ProjectsLocationsSourcesErrorFramesListCall) PageToken(pageToken string) *ProjectsLocationsSourcesErrorFramesListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// View sets the optional parameter "view": An optional view mode to +// control the level of details of each error frame. The default is a +// BASIC frame view. +// +// Possible values: +// +// "ERROR_FRAME_VIEW_UNSPECIFIED" - Value is unset. The system will +// +// fallback to the default value. +// +// "ERROR_FRAME_VIEW_BASIC" - Include basic frame data, but not the +// +// full contents. +// +// "ERROR_FRAME_VIEW_FULL" - Include everything. +func (c *ProjectsLocationsSourcesErrorFramesListCall) View(view string) *ProjectsLocationsSourcesErrorFramesListCall { + c.urlParams_.Set("view", view) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsSourcesErrorFramesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsSourcesErrorFramesListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsLocationsSourcesErrorFramesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsSourcesErrorFramesListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsSourcesErrorFramesListCall) Context(ctx context.Context) *ProjectsLocationsSourcesErrorFramesListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsSourcesErrorFramesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsSourcesErrorFramesListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha1/{+parent}/errorFrames") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "migrationcenter.projects.locations.sources.errorFrames.list" call. +// Exactly one of *ListErrorFramesResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListErrorFramesResponse.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 *ProjectsLocationsSourcesErrorFramesListCall) Do(opts ...googleapi.CallOption) (*ListErrorFramesResponse, 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 := &ListErrorFramesResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists all error frames in a given source and location.", + // "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/sources/{sourcesId}/errorFrames", + // "httpMethod": "GET", + // "id": "migrationcenter.projects.locations.sources.errorFrames.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "A token identifying a page of results the server should return.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. Parent value (the source) for `ListErrorFramesRequest`.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/sources/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "view": { + // "description": "Optional. An optional view mode to control the level of details of each error frame. The default is a BASIC frame view.", + // "enum": [ + // "ERROR_FRAME_VIEW_UNSPECIFIED", + // "ERROR_FRAME_VIEW_BASIC", + // "ERROR_FRAME_VIEW_FULL" + // ], + // "enumDescriptions": [ + // "Value is unset. The system will fallback to the default value.", + // "Include basic frame data, but not the full contents.", + // "Include everything." + // ], + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1alpha1/{+parent}/errorFrames", + // "response": { + // "$ref": "ListErrorFramesResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsLocationsSourcesErrorFramesListCall) Pages(ctx context.Context, f func(*ListErrorFramesResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} diff --git a/networkmanagement/v1/networkmanagement-api.json b/networkmanagement/v1/networkmanagement-api.json index db2f936f852..93a148df60c 100644 --- a/networkmanagement/v1/networkmanagement-api.json +++ b/networkmanagement/v1/networkmanagement-api.json @@ -591,7 +591,7 @@ } } }, - "revision": "20230313", + "revision": "20230426", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -657,7 +657,7 @@ "type": "object" }, "AppEngineVersionEndpoint": { - "description": "Wrapper for app engine service version attributes.", + "description": "Wrapper for the App Engine service version attributes.", "id": "AppEngineVersionEndpoint", "properties": { "uri": { @@ -1112,8 +1112,8 @@ ], "enumDescriptions": [ "Default type if unspecified.", - "A network hosted within Google Cloud Platform. To receive more detailed output, specify the URI for the source or destination network.", - "A network hosted outside of Google Cloud Platform. This can be an on-premises network, or a network hosted by another cloud provider." + "A network hosted within Google Cloud. To receive more detailed output, specify the URI for the source or destination network.", + "A network hosted outside of Google Cloud. This can be an on-premises network, or a network hosted by another cloud provider." ], "type": "string" }, @@ -1123,7 +1123,7 @@ "type": "integer" }, "projectId": { - "description": "Project ID where the endpoint is located. The Project ID can be derived from the URI if you provide a VM instance or network URI. The following are two cases where you must provide the project ID: 1. Only the IP address is specified, and the IP address is within a GCP project. 2. When you are using Shared VPC and the IP address that you provide is from the service project. In this case, the network that the IP address resides in is defined in the host project.", + "description": "Project ID where the endpoint is located. The Project ID can be derived from the URI if you provide a VM instance or network URI. The following are two cases where you must provide the project ID: 1. Only the IP address is specified, and the IP address is within a Google Cloud project. 2. When you are using Shared VPC and the IP address that you provide is from the service project. In this case, the network that the IP address resides in is defined in the host project.", "type": "string" } }, @@ -1557,7 +1557,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/networkmanagement/v1/networkmanagement-gen.go b/networkmanagement/v1/networkmanagement-gen.go index 6a8518a617e..5000b0f92ab 100644 --- a/networkmanagement/v1/networkmanagement-gen.go +++ b/networkmanagement/v1/networkmanagement-gen.go @@ -278,7 +278,7 @@ func (s *AbortInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// AppEngineVersionEndpoint: Wrapper for app engine service version +// AppEngineVersionEndpoint: Wrapper for the App Engine service version // attributes. type AppEngineVersionEndpoint struct { // Uri: An App Engine (https://cloud.google.com/appengine) [service @@ -1044,12 +1044,12 @@ type Endpoint struct { // // Possible values: // "NETWORK_TYPE_UNSPECIFIED" - Default type if unspecified. - // "GCP_NETWORK" - A network hosted within Google Cloud Platform. To - // receive more detailed output, specify the URI for the source or - // destination network. - // "NON_GCP_NETWORK" - A network hosted outside of Google Cloud - // Platform. This can be an on-premises network, or a network hosted by - // another cloud provider. + // "GCP_NETWORK" - A network hosted within Google Cloud. To receive + // more detailed output, specify the URI for the source or destination + // network. + // "NON_GCP_NETWORK" - A network hosted outside of Google Cloud. This + // can be an on-premises network, or a network hosted by another cloud + // provider. NetworkType string `json:"networkType,omitempty"` // Port: The IP protocol port of the endpoint. Only applicable when @@ -1060,9 +1060,9 @@ type Endpoint struct { // can be derived from the URI if you provide a VM instance or network // URI. The following are two cases where you must provide the project // ID: 1. Only the IP address is specified, and the IP address is within - // a GCP project. 2. When you are using Shared VPC and the IP address - // that you provide is from the service project. In this case, the - // network that the IP address resides in is defined in the host + // a Google Cloud project. 2. When you are using Shared VPC and the IP + // address that you provide is from the service project. In this case, + // the network that the IP address resides in is defined in the host // project. ProjectId string `json:"projectId,omitempty"` @@ -1697,7 +1697,7 @@ func (s *LoadBalancerInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/networkmanagement/v1beta1/networkmanagement-api.json b/networkmanagement/v1beta1/networkmanagement-api.json index 6353900374c..ec7c4a04aa5 100644 --- a/networkmanagement/v1beta1/networkmanagement-api.json +++ b/networkmanagement/v1beta1/networkmanagement-api.json @@ -591,7 +591,7 @@ } } }, - "revision": "20230313", + "revision": "20230426", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -657,7 +657,7 @@ "type": "object" }, "AppEngineVersionEndpoint": { - "description": "Wrapper for app engine service version attributes.", + "description": "Wrapper for the App Engine service version attributes.", "id": "AppEngineVersionEndpoint", "properties": { "uri": { @@ -1193,8 +1193,8 @@ ], "enumDescriptions": [ "Default type if unspecified.", - "A network hosted within Google Cloud Platform. To receive more detailed output, specify the URI for the source or destination network.", - "A network hosted outside of Google Cloud Platform. This can be an on-premises network, or a network hosted by another cloud provider." + "A network hosted within Google Cloud. To receive more detailed output, specify the URI for the source or destination network.", + "A network hosted outside of Google Cloud. This can be an on-premises network, or a network hosted by another cloud provider." ], "type": "string" }, @@ -1204,7 +1204,7 @@ "type": "integer" }, "projectId": { - "description": "Project ID where the endpoint is located. The Project ID can be derived from the URI if you provide a VM instance or network URI. The following are two cases where you must provide the project ID: 1. Only the IP address is specified, and the IP address is within a GCP project. 2. When you are using Shared VPC and the IP address that you provide is from the service project. In this case, the network that the IP address resides in is defined in the host project.", + "description": "Project ID where the endpoint is located. The Project ID can be derived from the URI if you provide a VM instance or network URI. The following are two cases where you must provide the project ID: 1. Only the IP address is specified, and the IP address is within a Google Cloud project. 2. When you are using Shared VPC and the IP address that you provide is from the service project. In this case, the network that the IP address resides in is defined in the host project.", "type": "string" } }, @@ -1673,7 +1673,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/networkmanagement/v1beta1/networkmanagement-gen.go b/networkmanagement/v1beta1/networkmanagement-gen.go index feae93094cc..b63b2c81edd 100644 --- a/networkmanagement/v1beta1/networkmanagement-gen.go +++ b/networkmanagement/v1beta1/networkmanagement-gen.go @@ -278,7 +278,7 @@ func (s *AbortInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// AppEngineVersionEndpoint: Wrapper for app engine service version +// AppEngineVersionEndpoint: Wrapper for the App Engine service version // attributes. type AppEngineVersionEndpoint struct { // Uri: An App Engine (https://cloud.google.com/appengine) [service @@ -1132,12 +1132,12 @@ type Endpoint struct { // // Possible values: // "NETWORK_TYPE_UNSPECIFIED" - Default type if unspecified. - // "GCP_NETWORK" - A network hosted within Google Cloud Platform. To - // receive more detailed output, specify the URI for the source or - // destination network. - // "NON_GCP_NETWORK" - A network hosted outside of Google Cloud - // Platform. This can be an on-premises network, or a network hosted by - // another cloud provider. + // "GCP_NETWORK" - A network hosted within Google Cloud. To receive + // more detailed output, specify the URI for the source or destination + // network. + // "NON_GCP_NETWORK" - A network hosted outside of Google Cloud. This + // can be an on-premises network, or a network hosted by another cloud + // provider. NetworkType string `json:"networkType,omitempty"` // Port: The IP protocol port of the endpoint. Only applicable when @@ -1148,9 +1148,9 @@ type Endpoint struct { // can be derived from the URI if you provide a VM instance or network // URI. The following are two cases where you must provide the project // ID: 1. Only the IP address is specified, and the IP address is within - // a GCP project. 2. When you are using Shared VPC and the IP address - // that you provide is from the service project. In this case, the - // network that the IP address resides in is defined in the host + // a Google Cloud project. 2. When you are using Shared VPC and the IP + // address that you provide is from the service project. In this case, + // the network that the IP address resides in is defined in the host // project. ProjectId string `json:"projectId,omitempty"` @@ -1851,7 +1851,7 @@ func (s *LoadBalancerInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/networksecurity/v1/networksecurity-api.json b/networksecurity/v1/networksecurity-api.json index dec48f110ee..ea8b714cd85 100644 --- a/networksecurity/v1/networksecurity-api.json +++ b/networksecurity/v1/networksecurity-api.json @@ -1672,7 +1672,7 @@ } } }, - "revision": "20230415", + "revision": "20230420", "rootUrl": "https://networksecurity.googleapis.com/", "schemas": { "AuthorizationPolicy": { @@ -2328,7 +2328,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/networksecurity/v1/networksecurity-gen.go b/networksecurity/v1/networksecurity-gen.go index 97ec7dff097..b12d89ce3a0 100644 --- a/networksecurity/v1/networksecurity-gen.go +++ b/networksecurity/v1/networksecurity-gen.go @@ -1538,7 +1538,7 @@ func (s *ListUrlListsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/networksecurity/v1beta1/networksecurity-api.json b/networksecurity/v1beta1/networksecurity-api.json index ab384bb07fd..cd9f4c16ce2 100644 --- a/networksecurity/v1beta1/networksecurity-api.json +++ b/networksecurity/v1beta1/networksecurity-api.json @@ -2474,7 +2474,7 @@ } } }, - "revision": "20230415", + "revision": "20230420", "rootUrl": "https://networksecurity.googleapis.com/", "schemas": { "AddAddressGroupItemsRequest": { @@ -3280,7 +3280,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/networksecurity/v1beta1/networksecurity-gen.go b/networksecurity/v1beta1/networksecurity-gen.go index 36e3658667a..03d15b1a103 100644 --- a/networksecurity/v1beta1/networksecurity-gen.go +++ b/networksecurity/v1beta1/networksecurity-gen.go @@ -1866,7 +1866,7 @@ func (s *ListUrlListsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/networkservices/v1/networkservices-api.json b/networkservices/v1/networkservices-api.json index 96decbd2113..651694a9065 100644 --- a/networkservices/v1/networkservices-api.json +++ b/networkservices/v1/networkservices-api.json @@ -2148,7 +2148,7 @@ } } }, - "revision": "20230404", + "revision": "20230424", "rootUrl": "https://networkservices.googleapis.com/", "schemas": { "AuditConfig": { @@ -2495,7 +2495,7 @@ "type": "array" }, "hostnames": { - "description": "Required. Service hostnames with an optional port for which this route describes traffic. Format: [:] Hostname is the fully qualified domain name of a network host. This matches the RFC 1123 definition of a hostname with 2 notable exceptions: - IPs are not allowed. - A hostname may be prefixed with a wildcard label (*.). The wildcard label must appear by itself as the first label. Hostname can be \"precise\" which is a domain name without the terminating dot of a network host (e.g. \"foo.example.com\") or \"wildcard\", which is a domain name prefixed with a single wildcard label (e.g. *.example.com). Note that as per RFC1035 and RFC1123, a label must consist of lower case alphanumeric characters or '-', and must start and end with an alphanumeric character. No other punctuation is allowed. The routes associated with a Mesh or Gateway must have unique hostnames. If you attempt to attach multiple routes with conflicting hostnames, the configuration will be rejected. For example, while it is acceptable for routes for the hostnames \"*.foo.bar.com\" and \"*.bar.com\" to be associated with the same route, it is not possible to associate two routes both with \"*.bar.com\" or both with \"bar.com\". If a port is specified, then gRPC clients must use the channel URI with the port to match this rule (i.e. \"xds:///service:123\"), otherwise they must supply the URI without a port (i.e. \"xds:///service\").", + "description": "Required. Service hostnames with an optional port for which this route describes traffic. Format: [:] Hostname is the fully qualified domain name of a network host. This matches the RFC 1123 definition of a hostname with 2 notable exceptions: - IPs are not allowed. - A hostname may be prefixed with a wildcard label (`*.`). The wildcard label must appear by itself as the first label. Hostname can be \"precise\" which is a domain name without the terminating dot of a network host (e.g. `foo.example.com`) or \"wildcard\", which is a domain name prefixed with a single wildcard label (e.g. `*.example.com`). Note that as per RFC1035 and RFC1123, a label must consist of lower case alphanumeric characters or '-', and must start and end with an alphanumeric character. No other punctuation is allowed. The routes associated with a Mesh or Gateway must have unique hostnames. If you attempt to attach multiple routes with conflicting hostnames, the configuration will be rejected. For example, while it is acceptable for routes for the hostnames `*.foo.bar.com` and `*.bar.com` to be associated with the same route, it is not possible to associate two routes both with `*.bar.com` or both with `bar.com`. If a port is specified, then gRPC clients must use the channel URI with the port to match this rule (i.e. \"xds:///service:123\"), otherwise they must supply the URI without a port (i.e. \"xds:///service\").", "items": { "type": "string" }, @@ -2771,7 +2771,7 @@ "type": "array" }, "hostnames": { - "description": "Required. Hostnames define a set of hosts that should match against the HTTP host header to select a HttpRoute to process the request. Hostname is the fully qualified domain name of a network host, as defined by RFC 1123 with the exception that: - IPs are not allowed. - A hostname may be prefixed with a wildcard label (*.). The wildcard label must appear by itself as the first label. Hostname can be \"precise\" which is a domain name without the terminating dot of a network host (e.g. \"foo.example.com\") or \"wildcard\", which is a domain name prefixed with a single wildcard label (e.g. *.example.com). Note that as per RFC1035 and RFC1123, a label must consist of lower case alphanumeric characters or '-', and must start and end with an alphanumeric character. No other punctuation is allowed. The routes associated with a Mesh or Gateways must have unique hostnames. If you attempt to attach multiple routes with conflicting hostnames, the configuration will be rejected. For example, while it is acceptable for routes for the hostnames \"*.foo.bar.com\" and \"*.bar.com\" to be associated with the same Mesh (or Gateways under the same scope), it is not possible to associate two routes both with \"*.bar.com\" or both with \"bar.com\".", + "description": "Required. Hostnames define a set of hosts that should match against the HTTP host header to select a HttpRoute to process the request. Hostname is the fully qualified domain name of a network host, as defined by RFC 1123 with the exception that: - IPs are not allowed. - A hostname may be prefixed with a wildcard label (`*.`). The wildcard label must appear by itself as the first label. Hostname can be \"precise\" which is a domain name without the terminating dot of a network host (e.g. `foo.example.com`) or \"wildcard\", which is a domain name prefixed with a single wildcard label (e.g. `*.example.com`). Note that as per RFC1035 and RFC1123, a label must consist of lower case alphanumeric characters or '-', and must start and end with an alphanumeric character. No other punctuation is allowed. The routes associated with a Mesh or Gateways must have unique hostnames. If you attempt to attach multiple routes with conflicting hostnames, the configuration will be rejected. For example, while it is acceptable for routes for the hostnames `*.foo.bar.com` and `*.bar.com` to be associated with the same Mesh (or Gateways under the same scope), it is not possible to associate two routes both with `*.bar.com` or both with `bar.com`.", "items": { "type": "string" }, @@ -3431,7 +3431,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -3764,14 +3764,14 @@ "id": "TcpRouteRouteAction", "properties": { "destinations": { - "description": "Optional. The destination services to which traffic should be forwarded. At least one destination service is required.", + "description": "Optional. The destination services to which traffic should be forwarded. At least one destination service is required. Only one of route destination or original destination can be set.", "items": { "$ref": "TcpRouteRouteDestination" }, "type": "array" }, "originalDestination": { - "description": "Optional. If true, Router will use the destination IP and port of the original connection as the destination of the request. Default is false.", + "description": "Optional. If true, Router will use the destination IP and port of the original connection as the destination of the request. Default is false. Only one of route destinations or original destination can be set.", "type": "boolean" } }, @@ -3949,7 +3949,7 @@ "type": "array" }, "sniHost": { - "description": "Optional. SNI (server name indicator) to match against. SNI will be matched against all wildcard domains, i.e. www.example.com will be first matched against www.example.com, then *.example.com, then *.com. Partial wildcards are not supported, and values like *w.example.com are invalid. At least one of sni_host and alpn is required. Up to 5 sni hosts across all matches can be set.", + "description": "Optional. SNI (server name indicator) to match against. SNI will be matched against all wildcard domains, i.e. `www.example.com` will be first matched against `www.example.com`, then `*.example.com`, then `*.com.` Partial wildcards are not supported, and values like *w.example.com are invalid. At least one of sni_host and alpn is required. Up to 5 sni hosts across all matches can be set.", "items": { "type": "string" }, diff --git a/networkservices/v1/networkservices-gen.go b/networkservices/v1/networkservices-gen.go index abcdf9551c8..7add72c7e8a 100644 --- a/networkservices/v1/networkservices-gen.go +++ b/networkservices/v1/networkservices-gen.go @@ -912,21 +912,21 @@ type GrpcRoute struct { // which this route describes traffic. Format: [:] Hostname is the fully // qualified domain name of a network host. This matches the RFC 1123 // definition of a hostname with 2 notable exceptions: - IPs are not - // allowed. - A hostname may be prefixed with a wildcard label (*.). The - // wildcard label must appear by itself as the first label. Hostname can - // be "precise" which is a domain name without the terminating dot of a - // network host (e.g. "foo.example.com") or "wildcard", which is a + // allowed. - A hostname may be prefixed with a wildcard label (`*.`). + // The wildcard label must appear by itself as the first label. Hostname + // can be "precise" which is a domain name without the terminating dot + // of a network host (e.g. `foo.example.com`) or "wildcard", which is a // domain name prefixed with a single wildcard label (e.g. - // *.example.com). Note that as per RFC1035 and RFC1123, a label must + // `*.example.com`). Note that as per RFC1035 and RFC1123, a label must // consist of lower case alphanumeric characters or '-', and must start // and end with an alphanumeric character. No other punctuation is // allowed. The routes associated with a Mesh or Gateway must have // unique hostnames. If you attempt to attach multiple routes with // conflicting hostnames, the configuration will be rejected. For // example, while it is acceptable for routes for the hostnames - // "*.foo.bar.com" and "*.bar.com" to be associated with the same route, - // it is not possible to associate two routes both with "*.bar.com" or - // both with "bar.com". If a port is specified, then gRPC clients must + // `*.foo.bar.com` and `*.bar.com` to be associated with the same route, + // it is not possible to associate two routes both with `*.bar.com` or + // both with `bar.com`. If a port is specified, then gRPC clients must // use the channel URI with the port to match this rule (i.e. // "xds:///service:123"), otherwise they must supply the URI without a // port (i.e. "xds:///service"). @@ -1405,21 +1405,21 @@ type HttpRoute struct { // match against the HTTP host header to select a HttpRoute to process // the request. Hostname is the fully qualified domain name of a network // host, as defined by RFC 1123 with the exception that: - IPs are not - // allowed. - A hostname may be prefixed with a wildcard label (*.). The - // wildcard label must appear by itself as the first label. Hostname can - // be "precise" which is a domain name without the terminating dot of a - // network host (e.g. "foo.example.com") or "wildcard", which is a + // allowed. - A hostname may be prefixed with a wildcard label (`*.`). + // The wildcard label must appear by itself as the first label. Hostname + // can be "precise" which is a domain name without the terminating dot + // of a network host (e.g. `foo.example.com`) or "wildcard", which is a // domain name prefixed with a single wildcard label (e.g. - // *.example.com). Note that as per RFC1035 and RFC1123, a label must + // `*.example.com`). Note that as per RFC1035 and RFC1123, a label must // consist of lower case alphanumeric characters or '-', and must start // and end with an alphanumeric character. No other punctuation is // allowed. The routes associated with a Mesh or Gateways must have // unique hostnames. If you attempt to attach multiple routes with // conflicting hostnames, the configuration will be rejected. For // example, while it is acceptable for routes for the hostnames - // "*.foo.bar.com" and "*.bar.com" to be associated with the same Mesh + // `*.foo.bar.com` and `*.bar.com` to be associated with the same Mesh // (or Gateways under the same scope), it is not possible to associate - // two routes both with "*.bar.com" or both with "bar.com". + // two routes both with `*.bar.com` or both with `bar.com`. Hostnames []string `json:"hostnames,omitempty"` // Labels: Optional. Set of label tags associated with the HttpRoute @@ -2599,7 +2599,7 @@ func (s *ListTlsRoutesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -3143,11 +3143,13 @@ func (s *TcpRoute) MarshalJSON() ([]byte, error) { type TcpRouteRouteAction struct { // Destinations: Optional. The destination services to which traffic // should be forwarded. At least one destination service is required. + // Only one of route destination or original destination can be set. Destinations []*TcpRouteRouteDestination `json:"destinations,omitempty"` // OriginalDestination: Optional. If true, Router will use the // destination IP and port of the original connection as the destination - // of the request. Default is false. + // of the request. Default is false. Only one of route destinations or + // original destination can be set. OriginalDestination bool `json:"originalDestination,omitempty"` // ForceSendFields is a list of field names (e.g. "Destinations") to @@ -3499,11 +3501,12 @@ type TlsRouteRouteMatch struct { Alpn []string `json:"alpn,omitempty"` // SniHost: Optional. SNI (server name indicator) to match against. SNI - // will be matched against all wildcard domains, i.e. www.example.com - // will be first matched against www.example.com, then *.example.com, - // then *.com. Partial wildcards are not supported, and values like - // *w.example.com are invalid. At least one of sni_host and alpn is - // required. Up to 5 sni hosts across all matches can be set. + // will be matched against all wildcard domains, i.e. `www.example.com` + // will be first matched against `www.example.com`, then + // `*.example.com`, then `*.com.` Partial wildcards are not supported, + // and values like *w.example.com are invalid. At least one of sni_host + // and alpn is required. Up to 5 sni hosts across all matches can be + // set. SniHost []string `json:"sniHost,omitempty"` // ForceSendFields is a list of field names (e.g. "Alpn") to diff --git a/networkservices/v1beta1/networkservices-api.json b/networkservices/v1beta1/networkservices-api.json index 418ce5d8627..200c0de4e98 100644 --- a/networkservices/v1beta1/networkservices-api.json +++ b/networkservices/v1beta1/networkservices-api.json @@ -1875,7 +1875,7 @@ } } }, - "revision": "20230323", + "revision": "20230424", "rootUrl": "https://networkservices.googleapis.com/", "schemas": { "AuditConfig": { @@ -2179,7 +2179,7 @@ "type": "array" }, "hostnames": { - "description": "Required. Service hostnames with an optional port for which this route describes traffic. Format: [:] Hostname is the fully qualified domain name of a network host. This matches the RFC 1123 definition of a hostname with 2 notable exceptions: - IPs are not allowed. - A hostname may be prefixed with a wildcard label (*.). The wildcard label must appear by itself as the first label. Hostname can be \"precise\" which is a domain name without the terminating dot of a network host (e.g. \"foo.example.com\") or \"wildcard\", which is a domain name prefixed with a single wildcard label (e.g. *.example.com). Note that as per RFC1035 and RFC1123, a label must consist of lower case alphanumeric characters or '-', and must start and end with an alphanumeric character. No other punctuation is allowed. The routes associated with a Mesh or Gateway must have unique hostnames. If you attempt to attach multiple routes with conflicting hostnames, the configuration will be rejected. For example, while it is acceptable for routes for the hostnames \"*.foo.bar.com\" and \"*.bar.com\" to be associated with the same route, it is not possible to associate two routes both with \"*.bar.com\" or both with \"bar.com\". If a port is specified, then gRPC clients must use the channel URI with the port to match this rule (i.e. \"xds:///service:123\"), otherwise they must supply the URI without a port (i.e. \"xds:///service\").", + "description": "Required. Service hostnames with an optional port for which this route describes traffic. Format: [:] Hostname is the fully qualified domain name of a network host. This matches the RFC 1123 definition of a hostname with 2 notable exceptions: - IPs are not allowed. - A hostname may be prefixed with a wildcard label (`*.`). The wildcard label must appear by itself as the first label. Hostname can be \"precise\" which is a domain name without the terminating dot of a network host (e.g. `foo.example.com`) or \"wildcard\", which is a domain name prefixed with a single wildcard label (e.g. `*.example.com`). Note that as per RFC1035 and RFC1123, a label must consist of lower case alphanumeric characters or '-', and must start and end with an alphanumeric character. No other punctuation is allowed. The routes associated with a Mesh or Gateway must have unique hostnames. If you attempt to attach multiple routes with conflicting hostnames, the configuration will be rejected. For example, while it is acceptable for routes for the hostnames `*.foo.bar.com` and `*.bar.com` to be associated with the same route, it is not possible to associate two routes both with `*.bar.com` or both with `bar.com`. If a port is specified, then gRPC clients must use the channel URI with the port to match this rule (i.e. \"xds:///service:123\"), otherwise they must supply the URI without a port (i.e. \"xds:///service\").", "items": { "type": "string" }, @@ -2455,7 +2455,7 @@ "type": "array" }, "hostnames": { - "description": "Required. Hostnames define a set of hosts that should match against the HTTP host header to select a HttpRoute to process the request. Hostname is the fully qualified domain name of a network host, as defined by RFC 1123 with the exception that: - IPs are not allowed. - A hostname may be prefixed with a wildcard label (*.). The wildcard label must appear by itself as the first label. Hostname can be \"precise\" which is a domain name without the terminating dot of a network host (e.g. \"foo.example.com\") or \"wildcard\", which is a domain name prefixed with a single wildcard label (e.g. *.example.com). Note that as per RFC1035 and RFC1123, a label must consist of lower case alphanumeric characters or '-', and must start and end with an alphanumeric character. No other punctuation is allowed. The routes associated with a Mesh or Gateways must have unique hostnames. If you attempt to attach multiple routes with conflicting hostnames, the configuration will be rejected. For example, while it is acceptable for routes for the hostnames \"*.foo.bar.com\" and \"*.bar.com\" to be associated with the same Mesh (or Gateways under the same scope), it is not possible to associate two routes both with \"*.bar.com\" or both with \"bar.com\".", + "description": "Required. Hostnames define a set of hosts that should match against the HTTP host header to select a HttpRoute to process the request. Hostname is the fully qualified domain name of a network host, as defined by RFC 1123 with the exception that: - IPs are not allowed. - A hostname may be prefixed with a wildcard label (`*.`). The wildcard label must appear by itself as the first label. Hostname can be \"precise\" which is a domain name without the terminating dot of a network host (e.g. `foo.example.com`) or \"wildcard\", which is a domain name prefixed with a single wildcard label (e.g. `*.example.com`). Note that as per RFC1035 and RFC1123, a label must consist of lower case alphanumeric characters or '-', and must start and end with an alphanumeric character. No other punctuation is allowed. The routes associated with a Mesh or Gateways must have unique hostnames. If you attempt to attach multiple routes with conflicting hostnames, the configuration will be rejected. For example, while it is acceptable for routes for the hostnames `*.foo.bar.com` and `*.bar.com` to be associated with the same Mesh (or Gateways under the same scope), it is not possible to associate two routes both with `*.bar.com` or both with `bar.com`.", "items": { "type": "string" }, @@ -3115,7 +3115,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -3491,14 +3491,14 @@ "id": "TcpRouteRouteAction", "properties": { "destinations": { - "description": "Optional. The destination services to which traffic should be forwarded. At least one destination service is required.", + "description": "Optional. The destination services to which traffic should be forwarded. At least one destination service is required. Only one of route destination or original destination can be set.", "items": { "$ref": "TcpRouteRouteDestination" }, "type": "array" }, "originalDestination": { - "description": "Optional. If true, Router will use the destination IP and port of the original connection as the destination of the request. Default is false.", + "description": "Optional. If true, Router will use the destination IP and port of the original connection as the destination of the request. Default is false. Only one of route destinations or original destination can be set.", "type": "boolean" } }, @@ -3676,7 +3676,7 @@ "type": "array" }, "sniHost": { - "description": "Optional. SNI (server name indicator) to match against. SNI will be matched against all wildcard domains, i.e. www.example.com will be first matched against www.example.com, then *.example.com, then *.com. Partial wildcards are not supported, and values like *w.example.com are invalid. At least one of sni_host and alpn is required. Up to 5 sni hosts across all matches can be set.", + "description": "Optional. SNI (server name indicator) to match against. SNI will be matched against all wildcard domains, i.e. `www.example.com` will be first matched against `www.example.com`, then `*.example.com`, then `*.com.` Partial wildcards are not supported, and values like *w.example.com are invalid. At least one of sni_host and alpn is required. Up to 5 sni hosts across all matches can be set.", "items": { "type": "string" }, diff --git a/networkservices/v1beta1/networkservices-gen.go b/networkservices/v1beta1/networkservices-gen.go index e0268b95b38..a0eb4071a69 100644 --- a/networkservices/v1beta1/networkservices-gen.go +++ b/networkservices/v1beta1/networkservices-gen.go @@ -784,21 +784,21 @@ type GrpcRoute struct { // which this route describes traffic. Format: [:] Hostname is the fully // qualified domain name of a network host. This matches the RFC 1123 // definition of a hostname with 2 notable exceptions: - IPs are not - // allowed. - A hostname may be prefixed with a wildcard label (*.). The - // wildcard label must appear by itself as the first label. Hostname can - // be "precise" which is a domain name without the terminating dot of a - // network host (e.g. "foo.example.com") or "wildcard", which is a + // allowed. - A hostname may be prefixed with a wildcard label (`*.`). + // The wildcard label must appear by itself as the first label. Hostname + // can be "precise" which is a domain name without the terminating dot + // of a network host (e.g. `foo.example.com`) or "wildcard", which is a // domain name prefixed with a single wildcard label (e.g. - // *.example.com). Note that as per RFC1035 and RFC1123, a label must + // `*.example.com`). Note that as per RFC1035 and RFC1123, a label must // consist of lower case alphanumeric characters or '-', and must start // and end with an alphanumeric character. No other punctuation is // allowed. The routes associated with a Mesh or Gateway must have // unique hostnames. If you attempt to attach multiple routes with // conflicting hostnames, the configuration will be rejected. For // example, while it is acceptable for routes for the hostnames - // "*.foo.bar.com" and "*.bar.com" to be associated with the same route, - // it is not possible to associate two routes both with "*.bar.com" or - // both with "bar.com". If a port is specified, then gRPC clients must + // `*.foo.bar.com` and `*.bar.com` to be associated with the same route, + // it is not possible to associate two routes both with `*.bar.com` or + // both with `bar.com`. If a port is specified, then gRPC clients must // use the channel URI with the port to match this rule (i.e. // "xds:///service:123"), otherwise they must supply the URI without a // port (i.e. "xds:///service"). @@ -1277,21 +1277,21 @@ type HttpRoute struct { // match against the HTTP host header to select a HttpRoute to process // the request. Hostname is the fully qualified domain name of a network // host, as defined by RFC 1123 with the exception that: - IPs are not - // allowed. - A hostname may be prefixed with a wildcard label (*.). The - // wildcard label must appear by itself as the first label. Hostname can - // be "precise" which is a domain name without the terminating dot of a - // network host (e.g. "foo.example.com") or "wildcard", which is a + // allowed. - A hostname may be prefixed with a wildcard label (`*.`). + // The wildcard label must appear by itself as the first label. Hostname + // can be "precise" which is a domain name without the terminating dot + // of a network host (e.g. `foo.example.com`) or "wildcard", which is a // domain name prefixed with a single wildcard label (e.g. - // *.example.com). Note that as per RFC1035 and RFC1123, a label must + // `*.example.com`). Note that as per RFC1035 and RFC1123, a label must // consist of lower case alphanumeric characters or '-', and must start // and end with an alphanumeric character. No other punctuation is // allowed. The routes associated with a Mesh or Gateways must have // unique hostnames. If you attempt to attach multiple routes with // conflicting hostnames, the configuration will be rejected. For // example, while it is acceptable for routes for the hostnames - // "*.foo.bar.com" and "*.bar.com" to be associated with the same Mesh + // `*.foo.bar.com` and `*.bar.com` to be associated with the same Mesh // (or Gateways under the same scope), it is not possible to associate - // two routes both with "*.bar.com" or both with "bar.com". + // two routes both with `*.bar.com` or both with `bar.com`. Hostnames []string `json:"hostnames,omitempty"` // Labels: Optional. Set of label tags associated with the HttpRoute @@ -2471,7 +2471,7 @@ func (s *ListTlsRoutesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -3106,11 +3106,13 @@ func (s *TcpRoute) MarshalJSON() ([]byte, error) { type TcpRouteRouteAction struct { // Destinations: Optional. The destination services to which traffic // should be forwarded. At least one destination service is required. + // Only one of route destination or original destination can be set. Destinations []*TcpRouteRouteDestination `json:"destinations,omitempty"` // OriginalDestination: Optional. If true, Router will use the // destination IP and port of the original connection as the destination - // of the request. Default is false. + // of the request. Default is false. Only one of route destinations or + // original destination can be set. OriginalDestination bool `json:"originalDestination,omitempty"` // ForceSendFields is a list of field names (e.g. "Destinations") to @@ -3462,11 +3464,12 @@ type TlsRouteRouteMatch struct { Alpn []string `json:"alpn,omitempty"` // SniHost: Optional. SNI (server name indicator) to match against. SNI - // will be matched against all wildcard domains, i.e. www.example.com - // will be first matched against www.example.com, then *.example.com, - // then *.com. Partial wildcards are not supported, and values like - // *w.example.com are invalid. At least one of sni_host and alpn is - // required. Up to 5 sni hosts across all matches can be set. + // will be matched against all wildcard domains, i.e. `www.example.com` + // will be first matched against `www.example.com`, then + // `*.example.com`, then `*.com.` Partial wildcards are not supported, + // and values like *w.example.com are invalid. At least one of sni_host + // and alpn is required. Up to 5 sni hosts across all matches can be + // set. SniHost []string `json:"sniHost,omitempty"` // ForceSendFields is a list of field names (e.g. "Alpn") to diff --git a/notebooks/v1/notebooks-api.json b/notebooks/v1/notebooks-api.json index c425f731591..4a52db6c7a7 100644 --- a/notebooks/v1/notebooks-api.json +++ b/notebooks/v1/notebooks-api.json @@ -1932,7 +1932,7 @@ } } }, - "revision": "20230307", + "revision": "20230427", "rootUrl": "https://notebooks.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -3057,7 +3057,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/notebooks/v1/notebooks-gen.go b/notebooks/v1/notebooks-gen.go index e54875ef987..a3baa7a4f33 100644 --- a/notebooks/v1/notebooks-gen.go +++ b/notebooks/v1/notebooks-gen.go @@ -1902,7 +1902,7 @@ func (s *LocalDiskInitializeParams) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/notebooks/v2/notebooks-api.json b/notebooks/v2/notebooks-api.json index 3608ffd8874..fc3aa047f7d 100644 --- a/notebooks/v2/notebooks-api.json +++ b/notebooks/v2/notebooks-api.json @@ -396,7 +396,7 @@ } } }, - "revision": "20230307", + "revision": "20230427", "rootUrl": "https://notebooks.googleapis.com/", "schemas": { "Binding": { @@ -493,7 +493,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/notebooks/v2/notebooks-gen.go b/notebooks/v2/notebooks-gen.go index 245282f95b9..5c8ffca4080 100644 --- a/notebooks/v2/notebooks-gen.go +++ b/notebooks/v2/notebooks-gen.go @@ -411,7 +411,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/ondemandscanning/v1/ondemandscanning-api.json b/ondemandscanning/v1/ondemandscanning-api.json index 5277fb283fb..5a799153e68 100644 --- a/ondemandscanning/v1/ondemandscanning-api.json +++ b/ondemandscanning/v1/ondemandscanning-api.json @@ -339,7 +339,7 @@ } } }, - "revision": "20230417", + "revision": "20230501", "rootUrl": "https://ondemandscanning.googleapis.com/", "schemas": { "AliasContext": { @@ -506,18 +506,6 @@ }, "type": "object" }, - "Binary": { - "id": "Binary", - "properties": { - "name": { - "type": "string" - }, - "version": { - "type": "string" - } - }, - "type": "object" - }, "BuildOccurrence": { "description": "Details of a build occurrence.", "id": "BuildOccurrence", @@ -1660,7 +1648,8 @@ "UPGRADE", "COMPLIANCE", "DSSE_ATTESTATION", - "VULNERABILITY_ASSESSMENT" + "VULNERABILITY_ASSESSMENT", + "SBOM_REFERENCE" ], "enumDescriptions": [ "Default value. This value is unused.", @@ -1674,7 +1663,8 @@ "This represents an available package upgrade.", "This represents a Compliance Note", "This represents a DSSE attestation Note", - "This represents a Vulnerability Assessment." + "This represents a Vulnerability Assessment.", + "This represents an SBOM Reference." ], "type": "string" }, @@ -1698,6 +1688,10 @@ "description": "Required. Immutable. A URI that represents the resource for which the occurrence applies. For example, `https://gcr.io/project/image@sha256:123abc` for a Docker image.", "type": "string" }, + "sbomReference": { + "$ref": "SBOMReferenceOccurrence", + "description": "Describes a specific SBOM reference occurrences." + }, "updateTime": { "description": "Output only. The time this occurrence was last updated.", "format": "google-datetime", @@ -1756,8 +1750,8 @@ "description": "The architecture of the package.", "type": "string" }, - "binary": { - "$ref": "Binary", + "binaryVersion": { + "$ref": "PackageVersion", "description": "The binary package. This is significant when the source is different than the binary itself. Historically if they've differed, we've stored the name of the source and its version in the package/version fields, but we should also store the binary package info, as that's what's actually installed. See b/175908657#comment15." }, "cpeUri": { @@ -1827,6 +1821,10 @@ }, "type": "array" }, + "sourceVersion": { + "$ref": "PackageVersion", + "description": "The source package. Similar to the above, this is significant when the source is different than the binary itself. Since the top-level package/version fields are based on an if/else, we need a separate field for both binary and source if we want to know definitively where the data is coming from." + }, "unused": { "type": "string" }, @@ -1957,6 +1955,18 @@ }, "type": "object" }, + "PackageVersion": { + "id": "PackageVersion", + "properties": { + "name": { + "type": "string" + }, + "version": { + "type": "string" + } + }, + "type": "object" + }, "ProjectRepoId": { "description": "Selects a repo using a Google Cloud Platform project ID (e.g., winged-cargo-31) and a repo name within that project.", "id": "ProjectRepoId", @@ -2079,6 +2089,80 @@ }, "type": "object" }, + "SBOMReferenceOccurrence": { + "description": "The occurrence representing an SBOM reference as applied to a specific resource. The occurrence follows the DSSE specification. See https://github.com/secure-systems-lab/dsse/blob/master/envelope.md for more details.", + "id": "SBOMReferenceOccurrence", + "properties": { + "payload": { + "$ref": "SbomReferenceIntotoPayload", + "description": "The actual payload that contains the SBOM reference data." + }, + "payloadType": { + "description": "The kind of payload that SbomReferenceIntotoPayload takes. Since it's in the intoto format, this value is expected to be 'application/vnd.in-toto+json'.", + "type": "string" + }, + "signatures": { + "description": "The signatures over the payload.", + "items": { + "$ref": "EnvelopeSignature" + }, + "type": "array" + } + }, + "type": "object" + }, + "SbomReferenceIntotoPayload": { + "description": "The actual payload that contains the SBOM Reference data. The payload follows the intoto statement specification. See https://github.com/in-toto/attestation/blob/main/spec/v1.0/statement.md for more details.", + "id": "SbomReferenceIntotoPayload", + "properties": { + "_type": { + "description": "Identifier for the schema of the Statement.", + "type": "string" + }, + "predicate": { + "$ref": "SbomReferenceIntotoPredicate", + "description": "Additional parameters of the Predicate. Includes the actual data about the SBOM." + }, + "predicateType": { + "description": "URI identifying the type of the Predicate.", + "type": "string" + }, + "subject": { + "description": "Set of software artifacts that the attestation applies to. Each element represents a single software artifact.", + "items": { + "$ref": "Subject" + }, + "type": "array" + } + }, + "type": "object" + }, + "SbomReferenceIntotoPredicate": { + "description": "A predicate which describes the SBOM being referenced.", + "id": "SbomReferenceIntotoPredicate", + "properties": { + "digest": { + "additionalProperties": { + "type": "string" + }, + "description": "A map of algorithm to digest of the contents of the SBOM.", + "type": "object" + }, + "location": { + "description": "The location of the SBOM.", + "type": "string" + }, + "mimeType": { + "description": "The mime type of the SBOM.", + "type": "string" + }, + "referrerId": { + "description": "The person or system referring this predicate to the consumer.", + "type": "string" + } + }, + "type": "object" + }, "Signature": { "description": "Verifiers (e.g. Kritis implementations) MUST verify signatures with respect to the trust anchors defined in policy (e.g. a Kritis policy). Typically this means that the verifier has been configured with a map from `public_key_id` to public key material (and any required parameters, e.g. signing algorithm). In particular, verification implementations MUST NOT treat the signature `public_key_id` as anything more than a key lookup hint. The `public_key_id` DOES NOT validate or authenticate a public key; it only provides a mechanism for quickly selecting a public key ALREADY CONFIGURED on the verifier through a trusted channel. Verification implementations MUST reject signatures in any of the following circumstances: * The `public_key_id` is not recognized by the verifier. * The public key that `public_key_id` refers to does not verify the signature with respect to the payload. The `signature` contents SHOULD NOT be \"attached\" (where the payload is included with the serialized `signature` bytes). Verifiers MUST ignore any \"attached\" payload and only verify signatures with respect to explicitly provided payload (e.g. a `payload` field on the proto message that holds this Signature, or the canonical serialization of the proto message that holds this signature).", "id": "Signature", diff --git a/ondemandscanning/v1/ondemandscanning-gen.go b/ondemandscanning/v1/ondemandscanning-gen.go index 57f434a5de5..142e8082971 100644 --- a/ondemandscanning/v1/ondemandscanning-gen.go +++ b/ondemandscanning/v1/ondemandscanning-gen.go @@ -517,34 +517,6 @@ func (s *AttestationOccurrence) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -type Binary struct { - Name string `json:"name,omitempty"` - - Version string `json:"version,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. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Name") to include in API - // requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *Binary) MarshalJSON() ([]byte, error) { - type NoMethod Binary - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // BuildOccurrence: Details of a build occurrence. type BuildOccurrence struct { // IntotoProvenance: Deprecated. See InTotoStatement for the @@ -2305,6 +2277,7 @@ type Occurrence struct { // "DSSE_ATTESTATION" - This represents a DSSE attestation Note // "VULNERABILITY_ASSESSMENT" - This represents a Vulnerability // Assessment. + // "SBOM_REFERENCE" - This represents an SBOM Reference. Kind string `json:"kind,omitempty"` // Name: Output only. The name of the occurrence in the form of @@ -2329,6 +2302,9 @@ type Occurrence struct { // `https://gcr.io/project/image@sha256:123abc` for a Docker image. ResourceUri string `json:"resourceUri,omitempty"` + // SbomReference: Describes a specific SBOM reference occurrences. + SbomReference *SBOMReferenceOccurrence `json:"sbomReference,omitempty"` + // UpdateTime: Output only. The time this occurrence was last updated. UpdateTime string `json:"updateTime,omitempty"` @@ -2428,12 +2404,12 @@ type PackageData struct { // Architecture: The architecture of the package. Architecture string `json:"architecture,omitempty"` - // Binary: The binary package. This is significant when the source is - // different than the binary itself. Historically if they've differed, - // we've stored the name of the source and its version in the + // BinaryVersion: The binary package. This is significant when the + // source is different than the binary itself. Historically if they've + // differed, we've stored the name of the source and its version in the // package/version fields, but we should also store the binary package // info, as that's what's actually installed. See b/175908657#comment15. - Binary *Binary `json:"binary,omitempty"` + BinaryVersion *PackageVersion `json:"binaryVersion,omitempty"` // CpeUri: The cpe_uri in [cpe format] // (https://cpe.mitre.org/specification/) in which the vulnerability may @@ -2485,6 +2461,13 @@ type PackageData struct { // go/drydock-dd-custom-binary-scanning PatchedCve []string `json:"patchedCve,omitempty"` + // SourceVersion: The source package. Similar to the above, this is + // significant when the source is different than the binary itself. + // Since the top-level package/version fields are based on an if/else, + // we need a separate field for both binary and source if we want to + // know definitively where the data is coming from. + SourceVersion *PackageVersion `json:"sourceVersion,omitempty"` + Unused string `json:"unused,omitempty"` // Version: The version of the package being analysed @@ -2650,6 +2633,34 @@ func (s *PackageOccurrence) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type PackageVersion struct { + Name string `json:"name,omitempty"` + + Version string `json:"version,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Name") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *PackageVersion) MarshalJSON() ([]byte, error) { + type NoMethod PackageVersion + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ProjectRepoId: Selects a repo using a Google Cloud Platform project // ID (e.g., winged-cargo-31) and a repo name within that project. type ProjectRepoId struct { @@ -2850,6 +2861,128 @@ func (s *RepoId) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// SBOMReferenceOccurrence: The occurrence representing an SBOM +// reference as applied to a specific resource. The occurrence follows +// the DSSE specification. See +// https://github.com/secure-systems-lab/dsse/blob/master/envelope.md +// for more details. +type SBOMReferenceOccurrence struct { + // Payload: The actual payload that contains the SBOM reference data. + Payload *SbomReferenceIntotoPayload `json:"payload,omitempty"` + + // PayloadType: The kind of payload that SbomReferenceIntotoPayload + // takes. Since it's in the intoto format, this value is expected to be + // 'application/vnd.in-toto+json'. + PayloadType string `json:"payloadType,omitempty"` + + // Signatures: The signatures over the payload. + Signatures []*EnvelopeSignature `json:"signatures,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Payload") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Payload") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *SBOMReferenceOccurrence) MarshalJSON() ([]byte, error) { + type NoMethod SBOMReferenceOccurrence + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// SbomReferenceIntotoPayload: The actual payload that contains the SBOM +// Reference data. The payload follows the intoto statement +// specification. See +// https://github.com/in-toto/attestation/blob/main/spec/v1.0/statement.md +// for more details. +type SbomReferenceIntotoPayload struct { + // Type: Identifier for the schema of the Statement. + Type string `json:"_type,omitempty"` + + // Predicate: Additional parameters of the Predicate. Includes the + // actual data about the SBOM. + Predicate *SbomReferenceIntotoPredicate `json:"predicate,omitempty"` + + // PredicateType: URI identifying the type of the Predicate. + PredicateType string `json:"predicateType,omitempty"` + + // Subject: Set of software artifacts that the attestation applies to. + // Each element represents a single software artifact. + Subject []*Subject `json:"subject,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Type") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *SbomReferenceIntotoPayload) MarshalJSON() ([]byte, error) { + type NoMethod SbomReferenceIntotoPayload + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// SbomReferenceIntotoPredicate: A predicate which describes the SBOM +// being referenced. +type SbomReferenceIntotoPredicate struct { + // Digest: A map of algorithm to digest of the contents of the SBOM. + Digest map[string]string `json:"digest,omitempty"` + + // Location: The location of the SBOM. + Location string `json:"location,omitempty"` + + // MimeType: The mime type of the SBOM. + MimeType string `json:"mimeType,omitempty"` + + // ReferrerId: The person or system referring this predicate to the + // consumer. + ReferrerId string `json:"referrerId,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Digest") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Digest") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *SbomReferenceIntotoPredicate) MarshalJSON() ([]byte, error) { + type NoMethod SbomReferenceIntotoPredicate + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Signature: Verifiers (e.g. Kritis implementations) MUST verify // signatures with respect to the trust anchors defined in policy (e.g. // a Kritis policy). Typically this means that the verifier has been diff --git a/ondemandscanning/v1beta1/ondemandscanning-api.json b/ondemandscanning/v1beta1/ondemandscanning-api.json index dba3ecd0006..90c41e85fc1 100644 --- a/ondemandscanning/v1beta1/ondemandscanning-api.json +++ b/ondemandscanning/v1beta1/ondemandscanning-api.json @@ -339,7 +339,7 @@ } } }, - "revision": "20230417", + "revision": "20230501", "rootUrl": "https://ondemandscanning.googleapis.com/", "schemas": { "AliasContext": { @@ -502,18 +502,6 @@ }, "type": "object" }, - "Binary": { - "id": "Binary", - "properties": { - "name": { - "type": "string" - }, - "version": { - "type": "string" - } - }, - "type": "object" - }, "BuildOccurrence": { "description": "Details of a build occurrence.", "id": "BuildOccurrence", @@ -1656,7 +1644,8 @@ "UPGRADE", "COMPLIANCE", "DSSE_ATTESTATION", - "VULNERABILITY_ASSESSMENT" + "VULNERABILITY_ASSESSMENT", + "SBOM_REFERENCE" ], "enumDescriptions": [ "Default value. This value is unused.", @@ -1670,7 +1659,8 @@ "This represents an available package upgrade.", "This represents a Compliance Note", "This represents a DSSE attestation Note", - "This represents a Vulnerability Assessment." + "This represents a Vulnerability Assessment.", + "This represents an SBOM Reference." ], "type": "string" }, @@ -1694,6 +1684,10 @@ "description": "Required. Immutable. A URI that represents the resource for which the occurrence applies. For example, `https://gcr.io/project/image@sha256:123abc` for a Docker image.", "type": "string" }, + "sbomReference": { + "$ref": "SBOMReferenceOccurrence", + "description": "Describes a specific SBOM reference occurrences." + }, "updateTime": { "description": "Output only. The time this occurrence was last updated.", "format": "google-datetime", @@ -1752,8 +1746,8 @@ "description": "The architecture of the package.", "type": "string" }, - "binary": { - "$ref": "Binary", + "binaryVersion": { + "$ref": "PackageVersion", "description": "The binary package. This is significant when the source is different than the binary itself. Historically if they've differed, we've stored the name of the source and its version in the package/version fields, but we should also store the binary package info, as that's what's actually installed. See b/175908657#comment15." }, "cpeUri": { @@ -1823,6 +1817,10 @@ }, "type": "array" }, + "sourceVersion": { + "$ref": "PackageVersion", + "description": "The source package. Similar to the above, this is significant when the source is different than the binary itself. Since the top-level package/version fields are based on an if/else, we need a separate field for both binary and source if we want to know definitively where the data is coming from." + }, "unused": { "type": "string" }, @@ -1953,6 +1951,18 @@ }, "type": "object" }, + "PackageVersion": { + "id": "PackageVersion", + "properties": { + "name": { + "type": "string" + }, + "version": { + "type": "string" + } + }, + "type": "object" + }, "ProjectRepoId": { "description": "Selects a repo using a Google Cloud Platform project ID (e.g., winged-cargo-31) and a repo name within that project.", "id": "ProjectRepoId", @@ -2075,6 +2085,80 @@ }, "type": "object" }, + "SBOMReferenceOccurrence": { + "description": "The occurrence representing an SBOM reference as applied to a specific resource. The occurrence follows the DSSE specification. See https://github.com/secure-systems-lab/dsse/blob/master/envelope.md for more details.", + "id": "SBOMReferenceOccurrence", + "properties": { + "payload": { + "$ref": "SbomReferenceIntotoPayload", + "description": "The actual payload that contains the SBOM reference data." + }, + "payloadType": { + "description": "The kind of payload that SbomReferenceIntotoPayload takes. Since it's in the intoto format, this value is expected to be 'application/vnd.in-toto+json'.", + "type": "string" + }, + "signatures": { + "description": "The signatures over the payload.", + "items": { + "$ref": "EnvelopeSignature" + }, + "type": "array" + } + }, + "type": "object" + }, + "SbomReferenceIntotoPayload": { + "description": "The actual payload that contains the SBOM Reference data. The payload follows the intoto statement specification. See https://github.com/in-toto/attestation/blob/main/spec/v1.0/statement.md for more details.", + "id": "SbomReferenceIntotoPayload", + "properties": { + "_type": { + "description": "Identifier for the schema of the Statement.", + "type": "string" + }, + "predicate": { + "$ref": "SbomReferenceIntotoPredicate", + "description": "Additional parameters of the Predicate. Includes the actual data about the SBOM." + }, + "predicateType": { + "description": "URI identifying the type of the Predicate.", + "type": "string" + }, + "subject": { + "description": "Set of software artifacts that the attestation applies to. Each element represents a single software artifact.", + "items": { + "$ref": "Subject" + }, + "type": "array" + } + }, + "type": "object" + }, + "SbomReferenceIntotoPredicate": { + "description": "A predicate which describes the SBOM being referenced.", + "id": "SbomReferenceIntotoPredicate", + "properties": { + "digest": { + "additionalProperties": { + "type": "string" + }, + "description": "A map of algorithm to digest of the contents of the SBOM.", + "type": "object" + }, + "location": { + "description": "The location of the SBOM.", + "type": "string" + }, + "mimeType": { + "description": "The mime type of the SBOM.", + "type": "string" + }, + "referrerId": { + "description": "The person or system referring this predicate to the consumer.", + "type": "string" + } + }, + "type": "object" + }, "Signature": { "description": "Verifiers (e.g. Kritis implementations) MUST verify signatures with respect to the trust anchors defined in policy (e.g. a Kritis policy). Typically this means that the verifier has been configured with a map from `public_key_id` to public key material (and any required parameters, e.g. signing algorithm). In particular, verification implementations MUST NOT treat the signature `public_key_id` as anything more than a key lookup hint. The `public_key_id` DOES NOT validate or authenticate a public key; it only provides a mechanism for quickly selecting a public key ALREADY CONFIGURED on the verifier through a trusted channel. Verification implementations MUST reject signatures in any of the following circumstances: * The `public_key_id` is not recognized by the verifier. * The public key that `public_key_id` refers to does not verify the signature with respect to the payload. The `signature` contents SHOULD NOT be \"attached\" (where the payload is included with the serialized `signature` bytes). Verifiers MUST ignore any \"attached\" payload and only verify signatures with respect to explicitly provided payload (e.g. a `payload` field on the proto message that holds this Signature, or the canonical serialization of the proto message that holds this signature).", "id": "Signature", diff --git a/ondemandscanning/v1beta1/ondemandscanning-gen.go b/ondemandscanning/v1beta1/ondemandscanning-gen.go index a81830da91a..588f8ed24b0 100644 --- a/ondemandscanning/v1beta1/ondemandscanning-gen.go +++ b/ondemandscanning/v1beta1/ondemandscanning-gen.go @@ -511,34 +511,6 @@ func (s *AttestationOccurrence) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -type Binary struct { - Name string `json:"name,omitempty"` - - Version string `json:"version,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. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Name") to include in API - // requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *Binary) MarshalJSON() ([]byte, error) { - type NoMethod Binary - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // BuildOccurrence: Details of a build occurrence. type BuildOccurrence struct { // IntotoProvenance: Deprecated. See InTotoStatement for the @@ -2299,6 +2271,7 @@ type Occurrence struct { // "DSSE_ATTESTATION" - This represents a DSSE attestation Note // "VULNERABILITY_ASSESSMENT" - This represents a Vulnerability // Assessment. + // "SBOM_REFERENCE" - This represents an SBOM Reference. Kind string `json:"kind,omitempty"` // Name: Output only. The name of the occurrence in the form of @@ -2323,6 +2296,9 @@ type Occurrence struct { // `https://gcr.io/project/image@sha256:123abc` for a Docker image. ResourceUri string `json:"resourceUri,omitempty"` + // SbomReference: Describes a specific SBOM reference occurrences. + SbomReference *SBOMReferenceOccurrence `json:"sbomReference,omitempty"` + // UpdateTime: Output only. The time this occurrence was last updated. UpdateTime string `json:"updateTime,omitempty"` @@ -2422,12 +2398,12 @@ type PackageData struct { // Architecture: The architecture of the package. Architecture string `json:"architecture,omitempty"` - // Binary: The binary package. This is significant when the source is - // different than the binary itself. Historically if they've differed, - // we've stored the name of the source and its version in the + // BinaryVersion: The binary package. This is significant when the + // source is different than the binary itself. Historically if they've + // differed, we've stored the name of the source and its version in the // package/version fields, but we should also store the binary package // info, as that's what's actually installed. See b/175908657#comment15. - Binary *Binary `json:"binary,omitempty"` + BinaryVersion *PackageVersion `json:"binaryVersion,omitempty"` // CpeUri: The cpe_uri in [cpe format] // (https://cpe.mitre.org/specification/) in which the vulnerability may @@ -2479,6 +2455,13 @@ type PackageData struct { // go/drydock-dd-custom-binary-scanning PatchedCve []string `json:"patchedCve,omitempty"` + // SourceVersion: The source package. Similar to the above, this is + // significant when the source is different than the binary itself. + // Since the top-level package/version fields are based on an if/else, + // we need a separate field for both binary and source if we want to + // know definitively where the data is coming from. + SourceVersion *PackageVersion `json:"sourceVersion,omitempty"` + Unused string `json:"unused,omitempty"` // Version: The version of the package being analysed @@ -2644,6 +2627,34 @@ func (s *PackageOccurrence) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type PackageVersion struct { + Name string `json:"name,omitempty"` + + Version string `json:"version,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Name") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *PackageVersion) MarshalJSON() ([]byte, error) { + type NoMethod PackageVersion + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ProjectRepoId: Selects a repo using a Google Cloud Platform project // ID (e.g., winged-cargo-31) and a repo name within that project. type ProjectRepoId struct { @@ -2844,6 +2855,128 @@ func (s *RepoId) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// SBOMReferenceOccurrence: The occurrence representing an SBOM +// reference as applied to a specific resource. The occurrence follows +// the DSSE specification. See +// https://github.com/secure-systems-lab/dsse/blob/master/envelope.md +// for more details. +type SBOMReferenceOccurrence struct { + // Payload: The actual payload that contains the SBOM reference data. + Payload *SbomReferenceIntotoPayload `json:"payload,omitempty"` + + // PayloadType: The kind of payload that SbomReferenceIntotoPayload + // takes. Since it's in the intoto format, this value is expected to be + // 'application/vnd.in-toto+json'. + PayloadType string `json:"payloadType,omitempty"` + + // Signatures: The signatures over the payload. + Signatures []*EnvelopeSignature `json:"signatures,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Payload") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Payload") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *SBOMReferenceOccurrence) MarshalJSON() ([]byte, error) { + type NoMethod SBOMReferenceOccurrence + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// SbomReferenceIntotoPayload: The actual payload that contains the SBOM +// Reference data. The payload follows the intoto statement +// specification. See +// https://github.com/in-toto/attestation/blob/main/spec/v1.0/statement.md +// for more details. +type SbomReferenceIntotoPayload struct { + // Type: Identifier for the schema of the Statement. + Type string `json:"_type,omitempty"` + + // Predicate: Additional parameters of the Predicate. Includes the + // actual data about the SBOM. + Predicate *SbomReferenceIntotoPredicate `json:"predicate,omitempty"` + + // PredicateType: URI identifying the type of the Predicate. + PredicateType string `json:"predicateType,omitempty"` + + // Subject: Set of software artifacts that the attestation applies to. + // Each element represents a single software artifact. + Subject []*Subject `json:"subject,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Type") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *SbomReferenceIntotoPayload) MarshalJSON() ([]byte, error) { + type NoMethod SbomReferenceIntotoPayload + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// SbomReferenceIntotoPredicate: A predicate which describes the SBOM +// being referenced. +type SbomReferenceIntotoPredicate struct { + // Digest: A map of algorithm to digest of the contents of the SBOM. + Digest map[string]string `json:"digest,omitempty"` + + // Location: The location of the SBOM. + Location string `json:"location,omitempty"` + + // MimeType: The mime type of the SBOM. + MimeType string `json:"mimeType,omitempty"` + + // ReferrerId: The person or system referring this predicate to the + // consumer. + ReferrerId string `json:"referrerId,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Digest") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Digest") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *SbomReferenceIntotoPredicate) MarshalJSON() ([]byte, error) { + type NoMethod SbomReferenceIntotoPredicate + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Signature: Verifiers (e.g. Kritis implementations) MUST verify // signatures with respect to the trust anchors defined in policy (e.g. // a Kritis policy). Typically this means that the verifier has been diff --git a/paymentsresellersubscription/v1/paymentsresellersubscription-api.json b/paymentsresellersubscription/v1/paymentsresellersubscription-api.json index 63a96737d67..b27860fdaf3 100644 --- a/paymentsresellersubscription/v1/paymentsresellersubscription-api.json +++ b/paymentsresellersubscription/v1/paymentsresellersubscription-api.json @@ -290,7 +290,7 @@ } }, "extend": { - "description": "[Deprecated] New partners should be on auto-extend by default. Used by partners to extend a subscription service for their customers on an ongoing basis for the subscription to remain active and renewable. It should be called directly by the partner using service accounts.", + "description": "[Opt-in only] Most partners should be on auto-extend by default. Used by partners to extend a subscription service for their customers on an ongoing basis for the subscription to remain active and renewable. It should be called directly by the partner using service accounts.", "flatPath": "v1/partners/{partnersId}/subscriptions/{subscriptionsId}:extend", "httpMethod": "POST", "id": "paymentsresellersubscription.partners.subscriptions.extend", @@ -396,7 +396,7 @@ } } }, - "revision": "20230425", + "revision": "20230507", "rootUrl": "https://paymentsresellersubscription.googleapis.com/", "schemas": { "GoogleCloudPaymentsResellerSubscriptionV1Amount": { @@ -1088,6 +1088,12 @@ "readOnly": true, "type": "string" }, + "lineItemIndex": { + "description": "Output only. A unique index of the subscription line item.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, "lineItemPromotionSpecs": { "description": "Optional. The promotions applied on the line item. It can be: - a free trial promotion, which overrides the subscription-level free trial promotion. - an introductory pricing promotion. When used as input in Create or Provision API, specify its resource name only.", "items": { diff --git a/paymentsresellersubscription/v1/paymentsresellersubscription-gen.go b/paymentsresellersubscription/v1/paymentsresellersubscription-gen.go index e9794d69cd8..de65a55050e 100644 --- a/paymentsresellersubscription/v1/paymentsresellersubscription-gen.go +++ b/paymentsresellersubscription/v1/paymentsresellersubscription-gen.go @@ -1246,6 +1246,10 @@ type GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItem struct { // no free trial promotion is specified. LineItemFreeTrialEndTime string `json:"lineItemFreeTrialEndTime,omitempty"` + // LineItemIndex: Output only. A unique index of the subscription line + // item. + LineItemIndex int64 `json:"lineItemIndex,omitempty"` + // LineItemPromotionSpecs: Optional. The promotions applied on the line // item. It can be: - a free trial promotion, which overrides the // subscription-level free trial promotion. - an introductory pricing @@ -2626,7 +2630,7 @@ type PartnersSubscriptionsExtendCall struct { header_ http.Header } -// Extend: [Deprecated] New partners should be on auto-extend by +// Extend: [Opt-in only] Most partners should be on auto-extend by // default. Used by partners to extend a subscription service for their // customers on an ongoing basis for the subscription to remain active // and renewable. It should be called directly by the partner using @@ -2736,7 +2740,7 @@ func (c *PartnersSubscriptionsExtendCall) Do(opts ...googleapi.CallOption) (*Goo } return ret, nil // { - // "description": "[Deprecated] New partners should be on auto-extend by default. Used by partners to extend a subscription service for their customers on an ongoing basis for the subscription to remain active and renewable. It should be called directly by the partner using service accounts.", + // "description": "[Opt-in only] Most partners should be on auto-extend by default. Used by partners to extend a subscription service for their customers on an ongoing basis for the subscription to remain active and renewable. It should be called directly by the partner using service accounts.", // "flatPath": "v1/partners/{partnersId}/subscriptions/{subscriptionsId}:extend", // "httpMethod": "POST", // "id": "paymentsresellersubscription.partners.subscriptions.extend", diff --git a/playdeveloperreporting/v1alpha1/playdeveloperreporting-api.json b/playdeveloperreporting/v1alpha1/playdeveloperreporting-api.json index 3da3b123bae..62e8d86d009 100644 --- a/playdeveloperreporting/v1alpha1/playdeveloperreporting-api.json +++ b/playdeveloperreporting/v1alpha1/playdeveloperreporting-api.json @@ -337,7 +337,7 @@ ], "parameters": { "filter": { - "description": "A selection predicate to retrieve only a subset of the issues. Counts in the returned error issues will only reflect occurrences that matched the filter. For filtering basics, please check [AIP-160](https://google.aip.dev/160). ** Supported field names:** * `apiLevel`: Matches error issues that occurred in the requested Android versions (specified as the numeric API level) only. Example: `apiLevel = 28 OR apiLevel = 29`. * `versionCode`: Matches error issues that occurred in the requested app version codes only. Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: Matches error issues that occurred in the requested devices. Example: `deviceModel = \"walleye\" OR deviceModel = \"marlin\"`. * `deviceType`: Matches error issues that occurred in the requested device types. Example: `deviceType = \"PHONE\"`. * `errorIssueType`: Matches error issues of the requested types only. Valid candidates: `CRASH`, `ANR`. Example: `errorIssueType = CRASH OR errorIssueType = ANR`. * `appProcessState`: Matches error issues on the process state of an app, indicating whether an app runs in the foreground (user-visible) or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error issues that are user-perceived. It is not accompanied by any operators. Example: `isUserPerceived`. ** Supported operators:** * Comparison operators: The only supported comparison operator is equality. The filtered field must appear on the left hand side of the comparison. * Logical Operators: Logical operators `AND` and `OR` can be used to build complex filters following a conjunctive normal form (CNF), i.e., conjunctions of disjunctions. The `OR` operator takes precedence over `AND` so the use of parenthesis is not necessary when building CNF. The `OR` operator is only supported to build disjunctions that apply to the same field, e.g., `versionCode = 123 OR errorIssueType = ANR` is not a valid filter. ** Examples ** Some valid filtering expressions: * `versionCode = 123 AND errorIssueType = ANR` * `versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH` * `versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)`", + "description": "A selection predicate to retrieve only a subset of the issues. Counts in the returned error issues will only reflect occurrences that matched the filter. For filtering basics, please check [AIP-160](https://google.aip.dev/160). ** Supported field names:** * `apiLevel`: Matches error issues that occurred in the requested Android versions (specified as the numeric API level) only. Example: `apiLevel = 28 OR apiLevel = 29`. * `versionCode`: Matches error issues that occurred in the requested app version codes only. Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: Matches error issues that occurred in the requested devices. Example: `deviceModel = \"walleye\" OR deviceModel = \"marlin\"`. * `deviceBrand`: Matches error issues that occurred in the requested device brands. Example: `deviceBrand = \"Google\". * `deviceType`: Matches error issues that occurred in the requested device types. Example: `deviceType = \"PHONE\"`. * `errorIssueType`: Matches error issues of the requested types only. Valid candidates: `CRASH`, `ANR`. Example: `errorIssueType = CRASH OR errorIssueType = ANR`. * `appProcessState`: Matches error issues on the process state of an app, indicating whether an app runs in the foreground (user-visible) or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error issues that are user-perceived. It is not accompanied by any operators. Example: `isUserPerceived`. ** Supported operators:** * Comparison operators: The only supported comparison operator is equality. The filtered field must appear on the left hand side of the comparison. * Logical Operators: Logical operators `AND` and `OR` can be used to build complex filters following a conjunctive normal form (CNF), i.e., conjunctions of disjunctions. The `OR` operator takes precedence over `AND` so the use of parenthesis is not necessary when building CNF. The `OR` operator is only supported to build disjunctions that apply to the same field, e.g., `versionCode = 123 OR errorIssueType = ANR` is not a valid filter. ** Examples ** Some valid filtering expressions: * `versionCode = 123 AND errorIssueType = ANR` * `versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH` * `versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)`", "location": "query", "type": "string" }, @@ -498,7 +498,7 @@ ], "parameters": { "filter": { - "description": "A selection predicate to retrieve only a subset of the reports. For filtering basics, please check [AIP-160](https://google.aip.dev/160). ** Supported field names:** * `apiLevel`: Matches error reports that occurred in the requested Android versions (specified as the numeric API level) only. Example: `apiLevel = 28 OR apiLevel = 29`. * `versionCode`: Matches error reports that occurred in the requested app version codes only. Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: Matches error reports that occurred in the requested devices. Example: `deviceModel = \"walleye\" OR deviceModel = \"marlin\"`. * `deviceType`: Matches error reports that occurred in the requested device types. Example: `deviceType = \"PHONE\"`. * `errorIssueType`: Matches error reports of the requested types only. Valid candidates: `JAVA_CRASH`, `NATIVE_CRASH`, `ANR`. Example: `errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH`. * `errorIssueId`: Matches error reports belonging to the requested error issue ids only. Example: `errorIssueId = 1234 OR errorIssueId = 4567`. * `appProcessState`: Matches error reports on the process state of an app, indicating whether an app runs in the foreground (user-visible) or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error reports that are user-perceived. It is not accompanied by any operators. Example: `isUserPerceived`. ** Supported operators:** * Comparison operators: The only supported comparison operator is equality. The filtered field must appear on the left hand side of the comparison. * Logical Operators: Logical operators `AND` and `OR` can be used to build complex filters following a conjunctive normal form (CNF), i.e., conjunctions of disjunctions. The `OR` operator takes precedence over `AND` so the use of parenthesis is not necessary when building CNF. The `OR` operator is only supported to build disjunctions that apply to the same field, e.g., `versionCode = 123 OR versionCode = ANR`. The filter expression `versionCode = 123 OR errorIssueType = ANR` is not valid. ** Examples ** Some valid filtering expressions: * `versionCode = 123 AND errorIssueType = ANR` * `versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH` * `versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)`", + "description": "A selection predicate to retrieve only a subset of the reports. For filtering basics, please check [AIP-160](https://google.aip.dev/160). ** Supported field names:** * `apiLevel`: Matches error reports that occurred in the requested Android versions (specified as the numeric API level) only. Example: `apiLevel = 28 OR apiLevel = 29`. * `versionCode`: Matches error reports that occurred in the requested app version codes only. Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: Matches error reports that occurred in the requested devices. Example: `deviceModel = \"walleye\" OR deviceModel = \"marlin\"`. * `deviceBrand`: Matches error issues that occurred in the requested device brands. Example: `deviceBrand = \"Google\". * `deviceType`: Matches error reports that occurred in the requested device types. Example: `deviceType = \"PHONE\"`. * `errorIssueType`: Matches error reports of the requested types only. Valid candidates: `JAVA_CRASH`, `NATIVE_CRASH`, `ANR`. Example: `errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH`. * `errorIssueId`: Matches error reports belonging to the requested error issue ids only. Example: `errorIssueId = 1234 OR errorIssueId = 4567`. * `appProcessState`: Matches error reports on the process state of an app, indicating whether an app runs in the foreground (user-visible) or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error reports that are user-perceived. It is not accompanied by any operators. Example: `isUserPerceived`. ** Supported operators:** * Comparison operators: The only supported comparison operator is equality. The filtered field must appear on the left hand side of the comparison. * Logical Operators: Logical operators `AND` and `OR` can be used to build complex filters following a conjunctive normal form (CNF), i.e., conjunctions of disjunctions. The `OR` operator takes precedence over `AND` so the use of parenthesis is not necessary when building CNF. The `OR` operator is only supported to build disjunctions that apply to the same field, e.g., `versionCode = 123 OR versionCode = ANR`. The filter expression `versionCode = 123 OR errorIssueType = ANR` is not valid. ** Examples ** Some valid filtering expressions: * `versionCode = 123 AND errorIssueType = ANR` * `versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH` * `versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)`", "location": "query", "type": "string" }, @@ -880,7 +880,7 @@ } } }, - "revision": "20230425", + "revision": "20230503", "rootUrl": "https://playdeveloperreporting.googleapis.com/", "schemas": { "GooglePlayDeveloperReportingV1alpha1Anomaly": { @@ -914,7 +914,7 @@ "type": "object" }, "GooglePlayDeveloperReportingV1alpha1AnrRateMetricSet": { - "description": "Singleton resource representing the set of ANR (Application not responding) metrics. This metric set contains ANRs data combined with usage data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. * HOURLY: metrics are aggregated in hourly intervals. The default and only supported timezone is `UTC`. **Supported metrics:** * `anrRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one ANR. * `anrRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `anrRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `anrRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `anrRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `userPerceivedAnrRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one user-perceived ANR. User-perceived ANRs are currently those of 'Input dispatching' type. * `userPerceivedAnrRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedAnrRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `userPerceivedAnrRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedAnrRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `anrRate` and `userPerceivedAnrRate` metrics. A user is counted in this metric if they used the app in the foreground during the aggregation period. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app. **Related metric sets:** * vitals.errors contains unnormalized version (absolute counts) of crashes. * vitals.errors contains normalized metrics about crashes, another stability metric.", + "description": "Singleton resource representing the set of ANR (Application not responding) metrics. This metric set contains ANRs data combined with usage data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. * HOURLY: metrics are aggregated in hourly intervals. The default and only supported timezone is `UTC`. **Supported metrics:** * `anrRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one ANR. * `anrRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `anrRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `anrRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `anrRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `userPerceivedAnrRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one user-perceived ANR. User-perceived ANRs are currently those of 'Input dispatching' type. * `userPerceivedAnrRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedAnrRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `userPerceivedAnrRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedAnrRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `anrRate` and `userPerceivedAnrRate` metrics. A user is counted in this metric if they used the app in the foreground during the aggregation period. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app. **Related metric sets:** * vitals.errors contains unnormalized version (absolute counts) of crashes. * vitals.errors contains normalized metrics about crashes, another stability metric.", "id": "GooglePlayDeveloperReportingV1alpha1AnrRateMetricSet", "properties": { "freshnessInfo": { @@ -929,7 +929,7 @@ "type": "object" }, "GooglePlayDeveloperReportingV1alpha1CrashRateMetricSet": { - "description": "Singleton resource representing the set of crashrate metrics. This metric set contains crashes data combined with usage data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. * HOURLY: metrics are aggregated in hourly intervals. The default and only supported timezone is `UTC`. **Supported metrics:** * `crashRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one crash. * `crashRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `crashRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `crashRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `crashRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `userPerceivedCrashRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one crash while they were actively using your app (a user-perceived crash). An app is considered to be in active use if it is displaying any activity or executing any foreground service. * `userPerceivedCrashRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedCrashRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `userPerceivedCrashRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedCrashRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `crashRate` and `userPerceivedCrashRate` metrics. A user is counted in this metric if they used the app actively during the aggregation period. An app is considered to be in active use if it is displaying any activity or executing any foreground service. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app. **Related metric sets:** * vitals.errors contains unnormalized version (absolute counts) of crashes. * vitals.errors contains normalized metrics about ANRs, another stability metric.", + "description": "Singleton resource representing the set of crashrate metrics. This metric set contains crashes data combined with usage data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. * HOURLY: metrics are aggregated in hourly intervals. The default and only supported timezone is `UTC`. **Supported metrics:** * `crashRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one crash. * `crashRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `crashRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `crashRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `crashRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `userPerceivedCrashRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one crash while they were actively using your app (a user-perceived crash). An app is considered to be in active use if it is displaying any activity or executing any foreground service. * `userPerceivedCrashRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedCrashRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `userPerceivedCrashRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedCrashRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `crashRate` and `userPerceivedCrashRate` metrics. A user is counted in this metric if they used the app actively during the aggregation period. An app is considered to be in active use if it is displaying any activity or executing any foreground service. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app. **Related metric sets:** * vitals.errors contains unnormalized version (absolute counts) of crashes. * vitals.errors contains normalized metrics about ANRs, another stability metric.", "id": "GooglePlayDeveloperReportingV1alpha1CrashRateMetricSet", "properties": { "freshnessInfo": { @@ -1064,7 +1064,7 @@ "type": "object" }, "GooglePlayDeveloperReportingV1alpha1ExcessiveWakeupRateMetricSet": { - "description": "Singleton resource representing the set of Excessive Weakeups metrics. This metric set contains AlarmManager wakeup counts data combined with process state data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `excessiveWakeupRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had more than 10 wakeups per hour. * `excessiveWakeupRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `excessiveWakeupRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `excessiveWakeupRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `excessiveWakeupRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `excessiveWakeupRate` metric. A user is counted in this metric if they app was doing any work on the device, i.e., not just active foreground usage but also background work. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", + "description": "Singleton resource representing the set of Excessive Weakeups metrics. This metric set contains AlarmManager wakeup counts data combined with process state data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `excessiveWakeupRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had more than 10 wakeups per hour. * `excessiveWakeupRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `excessiveWakeupRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `excessiveWakeupRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `excessiveWakeupRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `excessiveWakeupRate` metric. A user is counted in this metric if they app was doing any work on the device, i.e., not just active foreground usage but also background work. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", "id": "GooglePlayDeveloperReportingV1alpha1ExcessiveWakeupRateMetricSet", "properties": { "freshnessInfo": { @@ -1202,7 +1202,7 @@ "id": "GooglePlayDeveloperReportingV1alpha1QueryAnrRateMetricSetRequest", "properties": { "dimensions": { - "description": "Dimensions to slice the metrics by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", + "description": "Dimensions to slice the metrics by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", "items": { "type": "string" }, @@ -1274,7 +1274,7 @@ "id": "GooglePlayDeveloperReportingV1alpha1QueryCrashRateMetricSetRequest", "properties": { "dimensions": { - "description": "Dimensions to slice the metrics by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", + "description": "Dimensions to slice the metrics by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", "items": { "type": "string" }, @@ -1402,7 +1402,7 @@ "id": "GooglePlayDeveloperReportingV1alpha1QueryExcessiveWakeupRateMetricSetRequest", "properties": { "dimensions": { - "description": "Dimensions to slice the data by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", + "description": "Dimensions to slice the data by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", "items": { "type": "string" }, @@ -1474,7 +1474,7 @@ "id": "GooglePlayDeveloperReportingV1alpha1QuerySlowRenderingRateMetricSetRequest", "properties": { "dimensions": { - "description": "Dimensions to slice the data by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", + "description": "Dimensions to slice the data by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", "items": { "type": "string" }, @@ -1546,7 +1546,7 @@ "id": "GooglePlayDeveloperReportingV1alpha1QuerySlowStartRateMetricSetRequest", "properties": { "dimensions": { - "description": "Dimensions to slice the data by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", + "description": "Dimensions to slice the data by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", "items": { "type": "string" }, @@ -1618,7 +1618,7 @@ "id": "GooglePlayDeveloperReportingV1alpha1QueryStuckBackgroundWakelockRateMetricSetRequest", "properties": { "dimensions": { - "description": "Dimensions to slice the data by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", + "description": "Dimensions to slice the data by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", "items": { "type": "string" }, @@ -1722,7 +1722,7 @@ "type": "object" }, "GooglePlayDeveloperReportingV1alpha1SlowRenderingRateMetricSet": { - "description": "Singleton resource representing the set of Slow Rendering metrics. This metric set contains low-level rendering data captured by SurafeFlinger. Sessions are evaluated based on the present-to-present histogram of frames handled by any SurfaceFlinger layer owned by the app. A slow session is a session where more than 25% of frames for the session did not meet the metric's target frame rate (either 20fps, or 30fps). *NOTE:* This metric set is only available for games. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `slowRenderingRate20Fps` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had slow rendering. * `slowRenderingRate20Fps7dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate20Fps` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `slowRenderingRate20Fps28dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate20Fps` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `slowRenderingRate30Fps` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had slow rendering. * `slowRenderingRate30Fps7dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate30Fps` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `slowRenderingRate30Fps28dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate30Fps` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `slowRenderingRate20Fps`/`slowRenderingRate30Fps` metric. A user is counted in this metric if their app rendered any frames. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", + "description": "Singleton resource representing the set of Slow Rendering metrics. This metric set contains low-level rendering data captured by SurafeFlinger. Sessions are evaluated based on the present-to-present histogram of frames handled by any SurfaceFlinger layer owned by the app. A slow session is a session where more than 25% of frames for the session did not meet the metric's target frame rate (either 20fps, or 30fps). *NOTE:* This metric set is only available for games. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `slowRenderingRate20Fps` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had slow rendering. * `slowRenderingRate20Fps7dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate20Fps` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `slowRenderingRate20Fps28dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate20Fps` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `slowRenderingRate30Fps` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had slow rendering. * `slowRenderingRate30Fps7dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate30Fps` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `slowRenderingRate30Fps28dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate30Fps` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `slowRenderingRate20Fps`/`slowRenderingRate30Fps` metric. A user is counted in this metric if their app rendered any frames. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", "id": "GooglePlayDeveloperReportingV1alpha1SlowRenderingRateMetricSet", "properties": { "freshnessInfo": { @@ -1737,7 +1737,7 @@ "type": "object" }, "GooglePlayDeveloperReportingV1alpha1SlowStartRateMetricSet": { - "description": "Singleton resource representing the set of Slow Start metrics. This metric set contains Activity start duration data. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `slowStartRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had a slow start. * `slowStartRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowStartRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `slowStartRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowStartRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `slowStartRate` metric. A user is counted in this metric if their app was launched in the device. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Required dimension:** This dimension must be specified with each request for the request to be valid. * `startType` (string): the type of start that was measured. Valid types are `HOT`, `WARM` and `COLD`. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", + "description": "Singleton resource representing the set of Slow Start metrics. This metric set contains Activity start duration data. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `slowStartRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had a slow start. * `slowStartRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowStartRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `slowStartRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowStartRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `slowStartRate` metric. A user is counted in this metric if their app was launched in the device. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Required dimension:** This dimension must be specified with each request for the request to be valid. * `startType` (string): the type of start that was measured. Valid types are `HOT`, `WARM` and `COLD`. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", "id": "GooglePlayDeveloperReportingV1alpha1SlowStartRateMetricSet", "properties": { "freshnessInfo": { @@ -1752,7 +1752,7 @@ "type": "object" }, "GooglePlayDeveloperReportingV1alpha1StuckBackgroundWakelockRateMetricSet": { - "description": "Singleton resource representing the set of Stuck Background Wakelocks metrics. This metric set contains PowerManager wakelock duration data combined with process state data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `stuckBgWakelockRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had a wakelock held in the background for longer than 1 hour. * `stuckBgWakelockRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `stuckBgWakelockRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `stuckBgWakelockRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `stuckBgWakelockRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `stuckBgWakelockRate` metric. A user is counted in this metric if their app was doing any work on the device, i.e., not just active foreground usage but also background work. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", + "description": "Singleton resource representing the set of Stuck Background Wakelocks metrics. This metric set contains PowerManager wakelock duration data combined with process state data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `stuckBgWakelockRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had a wakelock held in the background for longer than 1 hour. * `stuckBgWakelockRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `stuckBgWakelockRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `stuckBgWakelockRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `stuckBgWakelockRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `stuckBgWakelockRate` metric. A user is counted in this metric if their app was doing any work on the device, i.e., not just active foreground usage but also background work. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", "id": "GooglePlayDeveloperReportingV1alpha1StuckBackgroundWakelockRateMetricSet", "properties": { "freshnessInfo": { diff --git a/playdeveloperreporting/v1alpha1/playdeveloperreporting-gen.go b/playdeveloperreporting/v1alpha1/playdeveloperreporting-gen.go index 0e156a978d1..d0485c5ce06 100644 --- a/playdeveloperreporting/v1alpha1/playdeveloperreporting-gen.go +++ b/playdeveloperreporting/v1alpha1/playdeveloperreporting-gen.go @@ -374,7 +374,8 @@ func (s *GooglePlayDeveloperReportingV1alpha1Anomaly) MarshalJSON() ([]byte, err // was running on the user's device. * `versionCode` (int64): version of // the app that was running on the user's device. * `deviceModel` // (string): unique identifier of the user's device model. * -// `deviceType` (string): the type (also known as form factor) of the +// `deviceBrand` (string): unique identifier of the user's device brand. +// * `deviceType` (string): the type (also known as form factor) of the // user's device. * `countryCode` (string): the country or region of the // user's device based on their IP address, represented as a 2-letter // ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` @@ -478,7 +479,8 @@ func (s *GooglePlayDeveloperReportingV1alpha1AnrRateMetricSet) MarshalJSON() ([] // was running on the user's device. * `versionCode` (int64): version of // the app that was running on the user's device. * `deviceModel` // (string): unique identifier of the user's device model. * -// `deviceType` (string): the type (also known as form factor) of the +// `deviceBrand` (string): unique identifier of the user's device brand. +// * `deviceType` (string): the type (also known as form factor) of the // user's device. * `countryCode` (string): the country or region of the // user's device based on their IP address, represented as a 2-letter // ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` @@ -846,12 +848,13 @@ func (s *GooglePlayDeveloperReportingV1alpha1ErrorReport) MarshalJSON() ([]byte, // Android that was running on the user's device. * `versionCode` // (int64): version of the app that was running on the user's device. * // `deviceModel` (string): unique identifier of the user's device model. -// * `deviceType` (string): the type (also known as form factor) of the -// user's device. * `countryCode` (string): the country or region of the -// user's device based on their IP address, represented as a 2-letter -// ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` -// (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * -// `deviceSocMake` (string): Make of the device's primary +// * `deviceBrand` (string): unique identifier of the user's device +// brand. * `deviceType` (string): the type (also known as form factor) +// of the user's device. * `countryCode` (string): the country or region +// of the user's device based on their IP address, represented as a +// 2-letter ISO-3166 code (e.g. US for the United States). * +// `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, +// 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary // system-on-chip, e.g., Samsung. Reference // (https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) // * `deviceSocModel` (string): Model of the device's primary @@ -1112,7 +1115,8 @@ type GooglePlayDeveloperReportingV1alpha1QueryAnrRateMetricSetRequest struct { // was running on the user's device. * `versionCode` (int64): version of // the app that was running on the user's device. * `deviceModel` // (string): unique identifier of the user's device model. * - // `deviceType` (string): the type (also known as form factor) of the + // `deviceBrand` (string): unique identifier of the user's device brand. + // * `deviceType` (string): the type (also known as form factor) of the // user's device. * `countryCode` (string): the country or region of the // user's device based on their IP address, represented as a 2-letter // ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` @@ -1279,7 +1283,8 @@ type GooglePlayDeveloperReportingV1alpha1QueryCrashRateMetricSetRequest struct { // was running on the user's device. * `versionCode` (int64): version of // the app that was running on the user's device. * `deviceModel` // (string): unique identifier of the user's device model. * - // `deviceType` (string): the type (also known as form factor) of the + // `deviceBrand` (string): unique identifier of the user's device brand. + // * `deviceType` (string): the type (also known as form factor) of the // user's device. * `countryCode` (string): the country or region of the // user's device based on their IP address, represented as a 2-letter // ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` @@ -1571,7 +1576,8 @@ type GooglePlayDeveloperReportingV1alpha1QueryExcessiveWakeupRateMetricSetReques // was running on the user's device. * `versionCode` (int64): version of // the app that was running on the user's device. * `deviceModel` // (string): unique identifier of the user's device model. * - // `deviceType` (string): the type (also known as form factor) of the + // `deviceBrand` (string): unique identifier of the user's device brand. + // * `deviceType` (string): the type (also known as form factor) of the // user's device. * `countryCode` (string): the country or region of the // user's device based on their IP address, represented as a 2-letter // ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` @@ -1725,7 +1731,8 @@ type GooglePlayDeveloperReportingV1alpha1QuerySlowRenderingRateMetricSetRequest // was running on the user's device. * `versionCode` (int64): version of // the app that was running on the user's device. * `deviceModel` // (string): unique identifier of the user's device model. * - // `deviceType` (string): the type (also known as form factor) of the + // `deviceBrand` (string): unique identifier of the user's device brand. + // * `deviceType` (string): the type (also known as form factor) of the // user's device. * `countryCode` (string): the country or region of the // user's device based on their IP address, represented as a 2-letter // ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` @@ -1888,7 +1895,8 @@ type GooglePlayDeveloperReportingV1alpha1QuerySlowStartRateMetricSetRequest stru // was running on the user's device. * `versionCode` (int64): version of // the app that was running on the user's device. * `deviceModel` // (string): unique identifier of the user's device model. * - // `deviceType` (string): the type (also known as form factor) of the + // `deviceBrand` (string): unique identifier of the user's device brand. + // * `deviceType` (string): the type (also known as form factor) of the // user's device. * `countryCode` (string): the country or region of the // user's device based on their IP address, represented as a 2-letter // ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` @@ -2041,7 +2049,8 @@ type GooglePlayDeveloperReportingV1alpha1QueryStuckBackgroundWakelockRateMetricS // was running on the user's device. * `versionCode` (int64): version of // the app that was running on the user's device. * `deviceModel` // (string): unique identifier of the user's device model. * - // `deviceType` (string): the type (also known as form factor) of the + // `deviceBrand` (string): unique identifier of the user's device brand. + // * `deviceType` (string): the type (also known as form factor) of the // user's device. * `countryCode` (string): the country or region of the // user's device based on their IP address, represented as a 2-letter // ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` @@ -2302,9 +2311,10 @@ func (s *GooglePlayDeveloperReportingV1alpha1SearchErrorReportsResponse) Marshal // API level of Android that was running on the user's device. * // `versionCode` (int64): version of the app that was running on the // user's device. * `deviceModel` (string): unique identifier of the -// user's device model. * `deviceType` (string): the type (also known as -// form factor) of the user's device. * `countryCode` (string): the -// country or region of the user's device based on their IP address, +// user's device model. * `deviceBrand` (string): unique identifier of +// the user's device brand. * `deviceType` (string): the type (also +// known as form factor) of the user's device. * `countryCode` (string): +// the country or region of the user's device based on their IP address, // represented as a 2-letter ISO-3166 code (e.g. US for the United // States). * `deviceRamBucket` (int64): RAM of the device, in MB, in // buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the @@ -2388,12 +2398,13 @@ func (s *GooglePlayDeveloperReportingV1alpha1SlowRenderingRateMetricSet) Marshal // Android that was running on the user's device. * `versionCode` // (int64): version of the app that was running on the user's device. * // `deviceModel` (string): unique identifier of the user's device model. -// * `deviceType` (string): the type (also known as form factor) of the -// user's device. * `countryCode` (string): the country or region of the -// user's device based on their IP address, represented as a 2-letter -// ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` -// (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * -// `deviceSocMake` (string): Make of the device's primary +// * `deviceBrand` (string): unique identifier of the user's device +// brand. * `deviceType` (string): the type (also known as form factor) +// of the user's device. * `countryCode` (string): the country or region +// of the user's device based on their IP address, represented as a +// 2-letter ISO-3166 code (e.g. US for the United States). * +// `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, +// 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary // system-on-chip, e.g., Samsung. Reference // (https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) // * `deviceSocModel` (string): Model of the device's primary @@ -2474,12 +2485,13 @@ func (s *GooglePlayDeveloperReportingV1alpha1SlowStartRateMetricSet) MarshalJSON // Android that was running on the user's device. * `versionCode` // (int64): version of the app that was running on the user's device. * // `deviceModel` (string): unique identifier of the user's device model. -// * `deviceType` (string): the type (also known as form factor) of the -// user's device. * `countryCode` (string): the country or region of the -// user's device based on their IP address, represented as a 2-letter -// ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` -// (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * -// `deviceSocMake` (string): Make of the device's primary +// * `deviceBrand` (string): unique identifier of the user's device +// brand. * `deviceType` (string): the type (also known as form factor) +// of the user's device. * `countryCode` (string): the country or region +// of the user's device based on their IP address, represented as a +// 2-letter ISO-3166 code (e.g. US for the United States). * +// `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, +// 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary // system-on-chip, e.g., Samsung. Reference // (https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) // * `deviceSocModel` (string): Model of the device's primary @@ -3984,15 +3996,17 @@ func (r *VitalsErrorsIssuesService) Search(parent string) *VitalsErrorsIssuesSea // app version codes only. Example: `versionCode = 123 OR versionCode = // 456`. * `deviceModel`: Matches error issues that occurred in the // requested devices. Example: `deviceModel = "walleye" OR deviceModel = -// "marlin". * `deviceType`: Matches error issues that occurred in the -// requested device types. Example: `deviceType = "PHONE". * -// `errorIssueType`: Matches error issues of the requested types only. -// Valid candidates: `CRASH`, `ANR`. Example: `errorIssueType = CRASH OR -// errorIssueType = ANR`. * `appProcessState`: Matches error issues on -// the process state of an app, indicating whether an app runs in the -// foreground (user-visible) or background. Valid candidates: -// `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. -// * `isUserPerceived`: Matches error issues that are user-perceived. It +// "marlin". * `deviceBrand`: Matches error issues that occurred in the +// requested device brands. Example: `deviceBrand = "Google". * +// `deviceType`: Matches error issues that occurred in the requested +// device types. Example: `deviceType = "PHONE". * `errorIssueType`: +// Matches error issues of the requested types only. Valid candidates: +// `CRASH`, `ANR`. Example: `errorIssueType = CRASH OR errorIssueType = +// ANR`. * `appProcessState`: Matches error issues on the process state +// of an app, indicating whether an app runs in the foreground +// (user-visible) or background. Valid candidates: `FOREGROUND`, +// `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * +// `isUserPerceived`: Matches error issues that are user-perceived. It // is not accompanied by any operators. Example: `isUserPerceived`. ** // Supported operators:** * Comparison operators: The only supported // comparison operator is equality. The filtered field must appear on @@ -4308,7 +4322,7 @@ func (c *VitalsErrorsIssuesSearchCall) Do(opts ...googleapi.CallOption) (*Google // ], // "parameters": { // "filter": { - // "description": "A selection predicate to retrieve only a subset of the issues. Counts in the returned error issues will only reflect occurrences that matched the filter. For filtering basics, please check [AIP-160](https://google.aip.dev/160). ** Supported field names:** * `apiLevel`: Matches error issues that occurred in the requested Android versions (specified as the numeric API level) only. Example: `apiLevel = 28 OR apiLevel = 29`. * `versionCode`: Matches error issues that occurred in the requested app version codes only. Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: Matches error issues that occurred in the requested devices. Example: `deviceModel = \"walleye\" OR deviceModel = \"marlin\"`. * `deviceType`: Matches error issues that occurred in the requested device types. Example: `deviceType = \"PHONE\"`. * `errorIssueType`: Matches error issues of the requested types only. Valid candidates: `CRASH`, `ANR`. Example: `errorIssueType = CRASH OR errorIssueType = ANR`. * `appProcessState`: Matches error issues on the process state of an app, indicating whether an app runs in the foreground (user-visible) or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error issues that are user-perceived. It is not accompanied by any operators. Example: `isUserPerceived`. ** Supported operators:** * Comparison operators: The only supported comparison operator is equality. The filtered field must appear on the left hand side of the comparison. * Logical Operators: Logical operators `AND` and `OR` can be used to build complex filters following a conjunctive normal form (CNF), i.e., conjunctions of disjunctions. The `OR` operator takes precedence over `AND` so the use of parenthesis is not necessary when building CNF. The `OR` operator is only supported to build disjunctions that apply to the same field, e.g., `versionCode = 123 OR errorIssueType = ANR` is not a valid filter. ** Examples ** Some valid filtering expressions: * `versionCode = 123 AND errorIssueType = ANR` * `versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH` * `versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)`", + // "description": "A selection predicate to retrieve only a subset of the issues. Counts in the returned error issues will only reflect occurrences that matched the filter. For filtering basics, please check [AIP-160](https://google.aip.dev/160). ** Supported field names:** * `apiLevel`: Matches error issues that occurred in the requested Android versions (specified as the numeric API level) only. Example: `apiLevel = 28 OR apiLevel = 29`. * `versionCode`: Matches error issues that occurred in the requested app version codes only. Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: Matches error issues that occurred in the requested devices. Example: `deviceModel = \"walleye\" OR deviceModel = \"marlin\"`. * `deviceBrand`: Matches error issues that occurred in the requested device brands. Example: `deviceBrand = \"Google\". * `deviceType`: Matches error issues that occurred in the requested device types. Example: `deviceType = \"PHONE\"`. * `errorIssueType`: Matches error issues of the requested types only. Valid candidates: `CRASH`, `ANR`. Example: `errorIssueType = CRASH OR errorIssueType = ANR`. * `appProcessState`: Matches error issues on the process state of an app, indicating whether an app runs in the foreground (user-visible) or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error issues that are user-perceived. It is not accompanied by any operators. Example: `isUserPerceived`. ** Supported operators:** * Comparison operators: The only supported comparison operator is equality. The filtered field must appear on the left hand side of the comparison. * Logical Operators: Logical operators `AND` and `OR` can be used to build complex filters following a conjunctive normal form (CNF), i.e., conjunctions of disjunctions. The `OR` operator takes precedence over `AND` so the use of parenthesis is not necessary when building CNF. The `OR` operator is only supported to build disjunctions that apply to the same field, e.g., `versionCode = 123 OR errorIssueType = ANR` is not a valid filter. ** Examples ** Some valid filtering expressions: * `versionCode = 123 AND errorIssueType = ANR` * `versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH` * `versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)`", // "location": "query", // "type": "string" // }, @@ -4510,16 +4524,18 @@ func (r *VitalsErrorsReportsService) Search(parent string) *VitalsErrorsReportsS // Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: // Matches error reports that occurred in the requested devices. // Example: `deviceModel = "walleye" OR deviceModel = "marlin". * -// `deviceType`: Matches error reports that occurred in the requested -// device types. Example: `deviceType = "PHONE". * `errorIssueType`: -// Matches error reports of the requested types only. Valid candidates: -// `JAVA_CRASH`, `NATIVE_CRASH`, `ANR`. Example: `errorIssueType = -// JAVA_CRASH OR errorIssueType = NATIVE_CRASH`. * `errorIssueId`: -// Matches error reports belonging to the requested error issue ids -// only. Example: `errorIssueId = 1234 OR errorIssueId = 4567`. * -// `appProcessState`: Matches error reports on the process state of an -// app, indicating whether an app runs in the foreground (user-visible) -// or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: +// `deviceBrand`: Matches error issues that occurred in the requested +// device brands. Example: `deviceBrand = "Google". * `deviceType`: +// Matches error reports that occurred in the requested device types. +// Example: `deviceType = "PHONE". * `errorIssueType`: Matches error +// reports of the requested types only. Valid candidates: `JAVA_CRASH`, +// `NATIVE_CRASH`, `ANR`. Example: `errorIssueType = JAVA_CRASH OR +// errorIssueType = NATIVE_CRASH`. * `errorIssueId`: Matches error +// reports belonging to the requested error issue ids only. Example: +// `errorIssueId = 1234 OR errorIssueId = 4567`. * `appProcessState`: +// Matches error reports on the process state of an app, indicating +// whether an app runs in the foreground (user-visible) or background. +// Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: // `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error // reports that are user-perceived. It is not accompanied by any // operators. Example: `isUserPerceived`. ** Supported operators:** * @@ -4839,7 +4855,7 @@ func (c *VitalsErrorsReportsSearchCall) Do(opts ...googleapi.CallOption) (*Googl // ], // "parameters": { // "filter": { - // "description": "A selection predicate to retrieve only a subset of the reports. For filtering basics, please check [AIP-160](https://google.aip.dev/160). ** Supported field names:** * `apiLevel`: Matches error reports that occurred in the requested Android versions (specified as the numeric API level) only. Example: `apiLevel = 28 OR apiLevel = 29`. * `versionCode`: Matches error reports that occurred in the requested app version codes only. Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: Matches error reports that occurred in the requested devices. Example: `deviceModel = \"walleye\" OR deviceModel = \"marlin\"`. * `deviceType`: Matches error reports that occurred in the requested device types. Example: `deviceType = \"PHONE\"`. * `errorIssueType`: Matches error reports of the requested types only. Valid candidates: `JAVA_CRASH`, `NATIVE_CRASH`, `ANR`. Example: `errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH`. * `errorIssueId`: Matches error reports belonging to the requested error issue ids only. Example: `errorIssueId = 1234 OR errorIssueId = 4567`. * `appProcessState`: Matches error reports on the process state of an app, indicating whether an app runs in the foreground (user-visible) or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error reports that are user-perceived. It is not accompanied by any operators. Example: `isUserPerceived`. ** Supported operators:** * Comparison operators: The only supported comparison operator is equality. The filtered field must appear on the left hand side of the comparison. * Logical Operators: Logical operators `AND` and `OR` can be used to build complex filters following a conjunctive normal form (CNF), i.e., conjunctions of disjunctions. The `OR` operator takes precedence over `AND` so the use of parenthesis is not necessary when building CNF. The `OR` operator is only supported to build disjunctions that apply to the same field, e.g., `versionCode = 123 OR versionCode = ANR`. The filter expression `versionCode = 123 OR errorIssueType = ANR` is not valid. ** Examples ** Some valid filtering expressions: * `versionCode = 123 AND errorIssueType = ANR` * `versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH` * `versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)`", + // "description": "A selection predicate to retrieve only a subset of the reports. For filtering basics, please check [AIP-160](https://google.aip.dev/160). ** Supported field names:** * `apiLevel`: Matches error reports that occurred in the requested Android versions (specified as the numeric API level) only. Example: `apiLevel = 28 OR apiLevel = 29`. * `versionCode`: Matches error reports that occurred in the requested app version codes only. Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: Matches error reports that occurred in the requested devices. Example: `deviceModel = \"walleye\" OR deviceModel = \"marlin\"`. * `deviceBrand`: Matches error issues that occurred in the requested device brands. Example: `deviceBrand = \"Google\". * `deviceType`: Matches error reports that occurred in the requested device types. Example: `deviceType = \"PHONE\"`. * `errorIssueType`: Matches error reports of the requested types only. Valid candidates: `JAVA_CRASH`, `NATIVE_CRASH`, `ANR`. Example: `errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH`. * `errorIssueId`: Matches error reports belonging to the requested error issue ids only. Example: `errorIssueId = 1234 OR errorIssueId = 4567`. * `appProcessState`: Matches error reports on the process state of an app, indicating whether an app runs in the foreground (user-visible) or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error reports that are user-perceived. It is not accompanied by any operators. Example: `isUserPerceived`. ** Supported operators:** * Comparison operators: The only supported comparison operator is equality. The filtered field must appear on the left hand side of the comparison. * Logical Operators: Logical operators `AND` and `OR` can be used to build complex filters following a conjunctive normal form (CNF), i.e., conjunctions of disjunctions. The `OR` operator takes precedence over `AND` so the use of parenthesis is not necessary when building CNF. The `OR` operator is only supported to build disjunctions that apply to the same field, e.g., `versionCode = 123 OR versionCode = ANR`. The filter expression `versionCode = 123 OR errorIssueType = ANR` is not valid. ** Examples ** Some valid filtering expressions: * `versionCode = 123 AND errorIssueType = ANR` * `versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH` * `versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)`", // "location": "query", // "type": "string" // }, diff --git a/playdeveloperreporting/v1beta1/playdeveloperreporting-api.json b/playdeveloperreporting/v1beta1/playdeveloperreporting-api.json index 640c012128c..d0105afba5c 100644 --- a/playdeveloperreporting/v1beta1/playdeveloperreporting-api.json +++ b/playdeveloperreporting/v1beta1/playdeveloperreporting-api.json @@ -337,7 +337,7 @@ ], "parameters": { "filter": { - "description": "A selection predicate to retrieve only a subset of the issues. Counts in the returned error issues will only reflect occurrences that matched the filter. For filtering basics, please check [AIP-160](https://google.aip.dev/160). ** Supported field names:** * `apiLevel`: Matches error issues that occurred in the requested Android versions (specified as the numeric API level) only. Example: `apiLevel = 28 OR apiLevel = 29`. * `versionCode`: Matches error issues that occurred in the requested app version codes only. Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: Matches error issues that occurred in the requested devices. Example: `deviceModel = \"walleye\" OR deviceModel = \"marlin\"`. * `deviceType`: Matches error issues that occurred in the requested device types. Example: `deviceType = \"PHONE\"`. * `errorIssueType`: Matches error issues of the requested types only. Valid candidates: `CRASH`, `ANR`. Example: `errorIssueType = CRASH OR errorIssueType = ANR`. * `appProcessState`: Matches error issues on the process state of an app, indicating whether an app runs in the foreground (user-visible) or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error issues that are user-perceived. It is not accompanied by any operators. Example: `isUserPerceived`. ** Supported operators:** * Comparison operators: The only supported comparison operator is equality. The filtered field must appear on the left hand side of the comparison. * Logical Operators: Logical operators `AND` and `OR` can be used to build complex filters following a conjunctive normal form (CNF), i.e., conjunctions of disjunctions. The `OR` operator takes precedence over `AND` so the use of parenthesis is not necessary when building CNF. The `OR` operator is only supported to build disjunctions that apply to the same field, e.g., `versionCode = 123 OR errorIssueType = ANR` is not a valid filter. ** Examples ** Some valid filtering expressions: * `versionCode = 123 AND errorIssueType = ANR` * `versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH` * `versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)`", + "description": "A selection predicate to retrieve only a subset of the issues. Counts in the returned error issues will only reflect occurrences that matched the filter. For filtering basics, please check [AIP-160](https://google.aip.dev/160). ** Supported field names:** * `apiLevel`: Matches error issues that occurred in the requested Android versions (specified as the numeric API level) only. Example: `apiLevel = 28 OR apiLevel = 29`. * `versionCode`: Matches error issues that occurred in the requested app version codes only. Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: Matches error issues that occurred in the requested devices. Example: `deviceModel = \"walleye\" OR deviceModel = \"marlin\"`. * `deviceBrand`: Matches error issues that occurred in the requested device brands. Example: `deviceBrand = \"Google\". * `deviceType`: Matches error issues that occurred in the requested device types. Example: `deviceType = \"PHONE\"`. * `errorIssueType`: Matches error issues of the requested types only. Valid candidates: `CRASH`, `ANR`. Example: `errorIssueType = CRASH OR errorIssueType = ANR`. * `appProcessState`: Matches error issues on the process state of an app, indicating whether an app runs in the foreground (user-visible) or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error issues that are user-perceived. It is not accompanied by any operators. Example: `isUserPerceived`. ** Supported operators:** * Comparison operators: The only supported comparison operator is equality. The filtered field must appear on the left hand side of the comparison. * Logical Operators: Logical operators `AND` and `OR` can be used to build complex filters following a conjunctive normal form (CNF), i.e., conjunctions of disjunctions. The `OR` operator takes precedence over `AND` so the use of parenthesis is not necessary when building CNF. The `OR` operator is only supported to build disjunctions that apply to the same field, e.g., `versionCode = 123 OR errorIssueType = ANR` is not a valid filter. ** Examples ** Some valid filtering expressions: * `versionCode = 123 AND errorIssueType = ANR` * `versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH` * `versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)`", "location": "query", "type": "string" }, @@ -498,7 +498,7 @@ ], "parameters": { "filter": { - "description": "A selection predicate to retrieve only a subset of the reports. For filtering basics, please check [AIP-160](https://google.aip.dev/160). ** Supported field names:** * `apiLevel`: Matches error reports that occurred in the requested Android versions (specified as the numeric API level) only. Example: `apiLevel = 28 OR apiLevel = 29`. * `versionCode`: Matches error reports that occurred in the requested app version codes only. Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: Matches error reports that occurred in the requested devices. Example: `deviceModel = \"walleye\" OR deviceModel = \"marlin\"`. * `deviceType`: Matches error reports that occurred in the requested device types. Example: `deviceType = \"PHONE\"`. * `errorIssueType`: Matches error reports of the requested types only. Valid candidates: `JAVA_CRASH`, `NATIVE_CRASH`, `ANR`. Example: `errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH`. * `errorIssueId`: Matches error reports belonging to the requested error issue ids only. Example: `errorIssueId = 1234 OR errorIssueId = 4567`. * `appProcessState`: Matches error reports on the process state of an app, indicating whether an app runs in the foreground (user-visible) or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error reports that are user-perceived. It is not accompanied by any operators. Example: `isUserPerceived`. ** Supported operators:** * Comparison operators: The only supported comparison operator is equality. The filtered field must appear on the left hand side of the comparison. * Logical Operators: Logical operators `AND` and `OR` can be used to build complex filters following a conjunctive normal form (CNF), i.e., conjunctions of disjunctions. The `OR` operator takes precedence over `AND` so the use of parenthesis is not necessary when building CNF. The `OR` operator is only supported to build disjunctions that apply to the same field, e.g., `versionCode = 123 OR versionCode = ANR`. The filter expression `versionCode = 123 OR errorIssueType = ANR` is not valid. ** Examples ** Some valid filtering expressions: * `versionCode = 123 AND errorIssueType = ANR` * `versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH` * `versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)`", + "description": "A selection predicate to retrieve only a subset of the reports. For filtering basics, please check [AIP-160](https://google.aip.dev/160). ** Supported field names:** * `apiLevel`: Matches error reports that occurred in the requested Android versions (specified as the numeric API level) only. Example: `apiLevel = 28 OR apiLevel = 29`. * `versionCode`: Matches error reports that occurred in the requested app version codes only. Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: Matches error reports that occurred in the requested devices. Example: `deviceModel = \"walleye\" OR deviceModel = \"marlin\"`. * `deviceBrand`: Matches error issues that occurred in the requested device brands. Example: `deviceBrand = \"Google\". * `deviceType`: Matches error reports that occurred in the requested device types. Example: `deviceType = \"PHONE\"`. * `errorIssueType`: Matches error reports of the requested types only. Valid candidates: `JAVA_CRASH`, `NATIVE_CRASH`, `ANR`. Example: `errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH`. * `errorIssueId`: Matches error reports belonging to the requested error issue ids only. Example: `errorIssueId = 1234 OR errorIssueId = 4567`. * `appProcessState`: Matches error reports on the process state of an app, indicating whether an app runs in the foreground (user-visible) or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error reports that are user-perceived. It is not accompanied by any operators. Example: `isUserPerceived`. ** Supported operators:** * Comparison operators: The only supported comparison operator is equality. The filtered field must appear on the left hand side of the comparison. * Logical Operators: Logical operators `AND` and `OR` can be used to build complex filters following a conjunctive normal form (CNF), i.e., conjunctions of disjunctions. The `OR` operator takes precedence over `AND` so the use of parenthesis is not necessary when building CNF. The `OR` operator is only supported to build disjunctions that apply to the same field, e.g., `versionCode = 123 OR versionCode = ANR`. The filter expression `versionCode = 123 OR errorIssueType = ANR` is not valid. ** Examples ** Some valid filtering expressions: * `versionCode = 123 AND errorIssueType = ANR` * `versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH` * `versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)`", "location": "query", "type": "string" }, @@ -880,7 +880,7 @@ } } }, - "revision": "20230425", + "revision": "20230503", "rootUrl": "https://playdeveloperreporting.googleapis.com/", "schemas": { "GooglePlayDeveloperReportingV1beta1Anomaly": { @@ -914,7 +914,7 @@ "type": "object" }, "GooglePlayDeveloperReportingV1beta1AnrRateMetricSet": { - "description": "Singleton resource representing the set of ANR (Application not responding) metrics. This metric set contains ANRs data combined with usage data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. * HOURLY: metrics are aggregated in hourly intervals. The default and only supported timezone is `UTC`. **Supported metrics:** * `anrRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one ANR. * `anrRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `anrRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `anrRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `anrRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `userPerceivedAnrRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one user-perceived ANR. User-perceived ANRs are currently those of 'Input dispatching' type. * `userPerceivedAnrRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedAnrRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `userPerceivedAnrRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedAnrRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `anrRate` and `userPerceivedAnrRate` metrics. A user is counted in this metric if they used the app in the foreground during the aggregation period. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app. **Related metric sets:** * vitals.errors contains unnormalized version (absolute counts) of crashes. * vitals.errors contains normalized metrics about crashes, another stability metric.", + "description": "Singleton resource representing the set of ANR (Application not responding) metrics. This metric set contains ANRs data combined with usage data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. * HOURLY: metrics are aggregated in hourly intervals. The default and only supported timezone is `UTC`. **Supported metrics:** * `anrRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one ANR. * `anrRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `anrRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `anrRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `anrRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `userPerceivedAnrRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one user-perceived ANR. User-perceived ANRs are currently those of 'Input dispatching' type. * `userPerceivedAnrRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedAnrRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `userPerceivedAnrRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedAnrRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `anrRate` and `userPerceivedAnrRate` metrics. A user is counted in this metric if they used the app in the foreground during the aggregation period. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app. **Related metric sets:** * vitals.errors contains unnormalized version (absolute counts) of crashes. * vitals.errors contains normalized metrics about crashes, another stability metric.", "id": "GooglePlayDeveloperReportingV1beta1AnrRateMetricSet", "properties": { "freshnessInfo": { @@ -929,7 +929,7 @@ "type": "object" }, "GooglePlayDeveloperReportingV1beta1CrashRateMetricSet": { - "description": "Singleton resource representing the set of crashrate metrics. This metric set contains crashes data combined with usage data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. * HOURLY: metrics are aggregated in hourly intervals. The default and only supported timezone is `UTC`. **Supported metrics:** * `crashRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one crash. * `crashRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `crashRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `crashRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `crashRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `userPerceivedCrashRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one crash while they were actively using your app (a user-perceived crash). An app is considered to be in active use if it is displaying any activity or executing any foreground service. * `userPerceivedCrashRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedCrashRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `userPerceivedCrashRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedCrashRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `crashRate` and `userPerceivedCrashRate` metrics. A user is counted in this metric if they used the app actively during the aggregation period. An app is considered to be in active use if it is displaying any activity or executing any foreground service. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app. **Related metric sets:** * vitals.errors contains unnormalized version (absolute counts) of crashes. * vitals.errors contains normalized metrics about ANRs, another stability metric.", + "description": "Singleton resource representing the set of crashrate metrics. This metric set contains crashes data combined with usage data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. * HOURLY: metrics are aggregated in hourly intervals. The default and only supported timezone is `UTC`. **Supported metrics:** * `crashRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one crash. * `crashRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `crashRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `crashRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `crashRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `userPerceivedCrashRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that experienced at least one crash while they were actively using your app (a user-perceived crash). An app is considered to be in active use if it is displaying any activity or executing any foreground service. * `userPerceivedCrashRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedCrashRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `userPerceivedCrashRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `userPerceivedCrashRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. Not supported in HOURLY granularity. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `crashRate` and `userPerceivedCrashRate` metrics. A user is counted in this metric if they used the app actively during the aggregation period. An app is considered to be in active use if it is displaying any activity or executing any foreground service. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app. **Related metric sets:** * vitals.errors contains unnormalized version (absolute counts) of crashes. * vitals.errors contains normalized metrics about ANRs, another stability metric.", "id": "GooglePlayDeveloperReportingV1beta1CrashRateMetricSet", "properties": { "freshnessInfo": { @@ -1064,7 +1064,7 @@ "type": "object" }, "GooglePlayDeveloperReportingV1beta1ExcessiveWakeupRateMetricSet": { - "description": "Singleton resource representing the set of Excessive Weakeups metrics. This metric set contains AlarmManager wakeup counts data combined with process state data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `excessiveWakeupRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had more than 10 wakeups per hour. * `excessiveWakeupRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `excessiveWakeupRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `excessiveWakeupRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `excessiveWakeupRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `excessiveWakeupRate` metric. A user is counted in this metric if they app was doing any work on the device, i.e., not just active foreground usage but also background work. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", + "description": "Singleton resource representing the set of Excessive Weakeups metrics. This metric set contains AlarmManager wakeup counts data combined with process state data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `excessiveWakeupRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had more than 10 wakeups per hour. * `excessiveWakeupRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `excessiveWakeupRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `excessiveWakeupRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `excessiveWakeupRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `excessiveWakeupRate` metric. A user is counted in this metric if they app was doing any work on the device, i.e., not just active foreground usage but also background work. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", "id": "GooglePlayDeveloperReportingV1beta1ExcessiveWakeupRateMetricSet", "properties": { "freshnessInfo": { @@ -1202,7 +1202,7 @@ "id": "GooglePlayDeveloperReportingV1beta1QueryAnrRateMetricSetRequest", "properties": { "dimensions": { - "description": "Dimensions to slice the metrics by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", + "description": "Dimensions to slice the metrics by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", "items": { "type": "string" }, @@ -1274,7 +1274,7 @@ "id": "GooglePlayDeveloperReportingV1beta1QueryCrashRateMetricSetRequest", "properties": { "dimensions": { - "description": "Dimensions to slice the metrics by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", + "description": "Dimensions to slice the metrics by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", "items": { "type": "string" }, @@ -1402,7 +1402,7 @@ "id": "GooglePlayDeveloperReportingV1beta1QueryExcessiveWakeupRateMetricSetRequest", "properties": { "dimensions": { - "description": "Dimensions to slice the data by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", + "description": "Dimensions to slice the data by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", "items": { "type": "string" }, @@ -1474,7 +1474,7 @@ "id": "GooglePlayDeveloperReportingV1beta1QuerySlowRenderingRateMetricSetRequest", "properties": { "dimensions": { - "description": "Dimensions to slice the data by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", + "description": "Dimensions to slice the data by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", "items": { "type": "string" }, @@ -1546,7 +1546,7 @@ "id": "GooglePlayDeveloperReportingV1beta1QuerySlowStartRateMetricSetRequest", "properties": { "dimensions": { - "description": "Dimensions to slice the data by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", + "description": "Dimensions to slice the data by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", "items": { "type": "string" }, @@ -1618,7 +1618,7 @@ "id": "GooglePlayDeveloperReportingV1beta1QueryStuckBackgroundWakelockRateMetricSetRequest", "properties": { "dimensions": { - "description": "Dimensions to slice the data by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", + "description": "Dimensions to slice the data by. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi.", "items": { "type": "string" }, @@ -1722,7 +1722,7 @@ "type": "object" }, "GooglePlayDeveloperReportingV1beta1SlowRenderingRateMetricSet": { - "description": "Singleton resource representing the set of Slow Rendering metrics. This metric set contains low-level rendering data captured by SurafeFlinger. Sessions are evaluated based on the present-to-present histogram of frames handled by any SurfaceFlinger layer owned by the app. A slow session is a session where more than 25% of frames for the session did not meet the metric's target frame rate (either 20fps, or 30fps). *NOTE:* This metric set is only available for games. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `slowRenderingRate20Fps` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had slow rendering. * `slowRenderingRate20Fps7dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate20Fps` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `slowRenderingRate20Fps28dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate20Fps` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `slowRenderingRate30Fps` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had slow rendering. * `slowRenderingRate30Fps7dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate30Fps` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `slowRenderingRate30Fps28dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate30Fps` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `slowRenderingRate20Fps`/`slowRenderingRate30Fps` metric. A user is counted in this metric if their app rendered any frames. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", + "description": "Singleton resource representing the set of Slow Rendering metrics. This metric set contains low-level rendering data captured by SurafeFlinger. Sessions are evaluated based on the present-to-present histogram of frames handled by any SurfaceFlinger layer owned by the app. A slow session is a session where more than 25% of frames for the session did not meet the metric's target frame rate (either 20fps, or 30fps). *NOTE:* This metric set is only available for games. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `slowRenderingRate20Fps` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had slow rendering. * `slowRenderingRate20Fps7dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate20Fps` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `slowRenderingRate20Fps28dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate20Fps` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `slowRenderingRate30Fps` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had slow rendering. * `slowRenderingRate30Fps7dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate30Fps` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `slowRenderingRate30Fps28dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowRenderingRate30Fps` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `slowRenderingRate20Fps`/`slowRenderingRate30Fps` metric. A user is counted in this metric if their app rendered any frames. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", "id": "GooglePlayDeveloperReportingV1beta1SlowRenderingRateMetricSet", "properties": { "freshnessInfo": { @@ -1737,7 +1737,7 @@ "type": "object" }, "GooglePlayDeveloperReportingV1beta1SlowStartRateMetricSet": { - "description": "Singleton resource representing the set of Slow Start metrics. This metric set contains Activity start duration data. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `slowStartRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had a slow start. * `slowStartRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowStartRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `slowStartRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowStartRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `slowStartRate` metric. A user is counted in this metric if their app was launched in the device. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Required dimension:** This dimension must be specified with each request for the request to be valid. * `startType` (string): the type of start that was measured. Valid types are `HOT`, `WARM` and `COLD`. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", + "description": "Singleton resource representing the set of Slow Start metrics. This metric set contains Activity start duration data. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `slowStartRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had a slow start. * `slowStartRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowStartRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `slowStartRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `slowStartRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `slowStartRate` metric. A user is counted in this metric if their app was launched in the device. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Required dimension:** This dimension must be specified with each request for the request to be valid. * `startType` (string): the type of start that was measured. Valid types are `HOT`, `WARM` and `COLD`. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", "id": "GooglePlayDeveloperReportingV1beta1SlowStartRateMetricSet", "properties": { "freshnessInfo": { @@ -1752,7 +1752,7 @@ "type": "object" }, "GooglePlayDeveloperReportingV1beta1StuckBackgroundWakelockRateMetricSet": { - "description": "Singleton resource representing the set of Stuck Background Wakelocks metrics. This metric set contains PowerManager wakelock duration data combined with process state data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `stuckBgWakelockRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had a wakelock held in the background for longer than 1 hour. * `stuckBgWakelockRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `stuckBgWakelockRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `stuckBgWakelockRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `stuckBgWakelockRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `stuckBgWakelockRate` metric. A user is counted in this metric if their app was doing any work on the device, i.e., not just active foreground usage but also background work. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", + "description": "Singleton resource representing the set of Stuck Background Wakelocks metrics. This metric set contains PowerManager wakelock duration data combined with process state data to produce a normalized metric independent of user counts. **Supported aggregation periods:** * DAILY: metrics are aggregated in calendar date intervals. Due to historical constraints, the only supported timezone is `America/Los_Angeles`. **Supported metrics:** * `stuckBgWakelockRate` (`google.type.Decimal`): Percentage of distinct users in the aggregation period that had a wakelock held in the background for longer than 1 hour. * `stuckBgWakelockRate7dUserWeighted` (`google.type.Decimal`): Rolling average value of `stuckBgWakelockRate` in the last 7 days. The daily values are weighted by the count of distinct users for the day. * `stuckBgWakelockRate28dUserWeighted` (`google.type.Decimal`): Rolling average value of `stuckBgWakelockRate` in the last 28 days. The daily values are weighted by the count of distinct users for the day. * `distinctUsers` (`google.type.Decimal`): Count of distinct users in the aggregation period that were used as normalization value for the `stuckBgWakelockRate` metric. A user is counted in this metric if their app was doing any work on the device, i.e., not just active foreground usage but also background work. Care must be taken not to aggregate this count further, as it may result in users being counted multiple times. The value is rounded to the nearest multiple of 10, 100, 1,000 or 1,000,000, depending on the magnitude of the value. **Supported dimensions:** * `apiLevel` (string): the API level of Android that was running on the user's device. * `versionCode` (int64): version of the app that was running on the user's device. * `deviceModel` (string): unique identifier of the user's device model. * `deviceBrand` (string): unique identifier of the user's device brand. * `deviceType` (string): the type (also known as form factor) of the user's device. * `countryCode` (string): the country or region of the user's device based on their IP address, represented as a 2-letter ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary system-on-chip, e.g., Samsung. [Reference](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) * `deviceSocModel` (string): Model of the device's primary system-on-chip, e.g., \"Exynos 2100\". [Reference](https://developer.android.com/reference/android/os/Build#SOC_MODEL) * `deviceCpuMake` (string): Make of the device's CPU, e.g., Qualcomm. * `deviceCpuModel` (string): Model of the device's CPU, e.g., \"Kryo 240\". * `deviceGpuMake` (string): Make of the device's GPU, e.g., ARM. * `deviceGpuModel` (string): Model of the device's GPU, e.g., Mali. * `deviceGpuVersion` (string): Version of the device's GPU, e.g., T750. * `deviceVulkanVersion` (string): Vulkan version of the device, e.g., \"4198400\". * `deviceGlEsVersion` (string): OpenGL ES version of the device, e.g., \"196610\". * `deviceScreenSize` (string): Screen size of the device, e.g., NORMAL, LARGE. * `deviceScreenDpi` (string): Screen density of the device, e.g., mdpi, hdpi. **Required permissions**: to access this resource, the calling user needs the _View app information (read-only)_ permission for the app.", "id": "GooglePlayDeveloperReportingV1beta1StuckBackgroundWakelockRateMetricSet", "properties": { "freshnessInfo": { diff --git a/playdeveloperreporting/v1beta1/playdeveloperreporting-gen.go b/playdeveloperreporting/v1beta1/playdeveloperreporting-gen.go index 13a94206172..f0f819a7fa8 100644 --- a/playdeveloperreporting/v1beta1/playdeveloperreporting-gen.go +++ b/playdeveloperreporting/v1beta1/playdeveloperreporting-gen.go @@ -374,7 +374,8 @@ func (s *GooglePlayDeveloperReportingV1beta1Anomaly) MarshalJSON() ([]byte, erro // was running on the user's device. * `versionCode` (int64): version of // the app that was running on the user's device. * `deviceModel` // (string): unique identifier of the user's device model. * -// `deviceType` (string): the type (also known as form factor) of the +// `deviceBrand` (string): unique identifier of the user's device brand. +// * `deviceType` (string): the type (also known as form factor) of the // user's device. * `countryCode` (string): the country or region of the // user's device based on their IP address, represented as a 2-letter // ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` @@ -478,7 +479,8 @@ func (s *GooglePlayDeveloperReportingV1beta1AnrRateMetricSet) MarshalJSON() ([]b // was running on the user's device. * `versionCode` (int64): version of // the app that was running on the user's device. * `deviceModel` // (string): unique identifier of the user's device model. * -// `deviceType` (string): the type (also known as form factor) of the +// `deviceBrand` (string): unique identifier of the user's device brand. +// * `deviceType` (string): the type (also known as form factor) of the // user's device. * `countryCode` (string): the country or region of the // user's device based on their IP address, represented as a 2-letter // ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` @@ -846,12 +848,13 @@ func (s *GooglePlayDeveloperReportingV1beta1ErrorReport) MarshalJSON() ([]byte, // Android that was running on the user's device. * `versionCode` // (int64): version of the app that was running on the user's device. * // `deviceModel` (string): unique identifier of the user's device model. -// * `deviceType` (string): the type (also known as form factor) of the -// user's device. * `countryCode` (string): the country or region of the -// user's device based on their IP address, represented as a 2-letter -// ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` -// (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * -// `deviceSocMake` (string): Make of the device's primary +// * `deviceBrand` (string): unique identifier of the user's device +// brand. * `deviceType` (string): the type (also known as form factor) +// of the user's device. * `countryCode` (string): the country or region +// of the user's device based on their IP address, represented as a +// 2-letter ISO-3166 code (e.g. US for the United States). * +// `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, +// 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary // system-on-chip, e.g., Samsung. Reference // (https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) // * `deviceSocModel` (string): Model of the device's primary @@ -1112,7 +1115,8 @@ type GooglePlayDeveloperReportingV1beta1QueryAnrRateMetricSetRequest struct { // was running on the user's device. * `versionCode` (int64): version of // the app that was running on the user's device. * `deviceModel` // (string): unique identifier of the user's device model. * - // `deviceType` (string): the type (also known as form factor) of the + // `deviceBrand` (string): unique identifier of the user's device brand. + // * `deviceType` (string): the type (also known as form factor) of the // user's device. * `countryCode` (string): the country or region of the // user's device based on their IP address, represented as a 2-letter // ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` @@ -1279,7 +1283,8 @@ type GooglePlayDeveloperReportingV1beta1QueryCrashRateMetricSetRequest struct { // was running on the user's device. * `versionCode` (int64): version of // the app that was running on the user's device. * `deviceModel` // (string): unique identifier of the user's device model. * - // `deviceType` (string): the type (also known as form factor) of the + // `deviceBrand` (string): unique identifier of the user's device brand. + // * `deviceType` (string): the type (also known as form factor) of the // user's device. * `countryCode` (string): the country or region of the // user's device based on their IP address, represented as a 2-letter // ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` @@ -1571,7 +1576,8 @@ type GooglePlayDeveloperReportingV1beta1QueryExcessiveWakeupRateMetricSetRequest // was running on the user's device. * `versionCode` (int64): version of // the app that was running on the user's device. * `deviceModel` // (string): unique identifier of the user's device model. * - // `deviceType` (string): the type (also known as form factor) of the + // `deviceBrand` (string): unique identifier of the user's device brand. + // * `deviceType` (string): the type (also known as form factor) of the // user's device. * `countryCode` (string): the country or region of the // user's device based on their IP address, represented as a 2-letter // ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` @@ -1725,7 +1731,8 @@ type GooglePlayDeveloperReportingV1beta1QuerySlowRenderingRateMetricSetRequest s // was running on the user's device. * `versionCode` (int64): version of // the app that was running on the user's device. * `deviceModel` // (string): unique identifier of the user's device model. * - // `deviceType` (string): the type (also known as form factor) of the + // `deviceBrand` (string): unique identifier of the user's device brand. + // * `deviceType` (string): the type (also known as form factor) of the // user's device. * `countryCode` (string): the country or region of the // user's device based on their IP address, represented as a 2-letter // ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` @@ -1889,7 +1896,8 @@ type GooglePlayDeveloperReportingV1beta1QuerySlowStartRateMetricSetRequest struc // was running on the user's device. * `versionCode` (int64): version of // the app that was running on the user's device. * `deviceModel` // (string): unique identifier of the user's device model. * - // `deviceType` (string): the type (also known as form factor) of the + // `deviceBrand` (string): unique identifier of the user's device brand. + // * `deviceType` (string): the type (also known as form factor) of the // user's device. * `countryCode` (string): the country or region of the // user's device based on their IP address, represented as a 2-letter // ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` @@ -2042,7 +2050,8 @@ type GooglePlayDeveloperReportingV1beta1QueryStuckBackgroundWakelockRateMetricSe // was running on the user's device. * `versionCode` (int64): version of // the app that was running on the user's device. * `deviceModel` // (string): unique identifier of the user's device model. * - // `deviceType` (string): the type (also known as form factor) of the + // `deviceBrand` (string): unique identifier of the user's device brand. + // * `deviceType` (string): the type (also known as form factor) of the // user's device. * `countryCode` (string): the country or region of the // user's device based on their IP address, represented as a 2-letter // ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` @@ -2303,9 +2312,10 @@ func (s *GooglePlayDeveloperReportingV1beta1SearchErrorReportsResponse) MarshalJ // API level of Android that was running on the user's device. * // `versionCode` (int64): version of the app that was running on the // user's device. * `deviceModel` (string): unique identifier of the -// user's device model. * `deviceType` (string): the type (also known as -// form factor) of the user's device. * `countryCode` (string): the -// country or region of the user's device based on their IP address, +// user's device model. * `deviceBrand` (string): unique identifier of +// the user's device brand. * `deviceType` (string): the type (also +// known as form factor) of the user's device. * `countryCode` (string): +// the country or region of the user's device based on their IP address, // represented as a 2-letter ISO-3166 code (e.g. US for the United // States). * `deviceRamBucket` (int64): RAM of the device, in MB, in // buckets (3GB, 4GB, etc.). * `deviceSocMake` (string): Make of the @@ -2389,12 +2399,13 @@ func (s *GooglePlayDeveloperReportingV1beta1SlowRenderingRateMetricSet) MarshalJ // Android that was running on the user's device. * `versionCode` // (int64): version of the app that was running on the user's device. * // `deviceModel` (string): unique identifier of the user's device model. -// * `deviceType` (string): the type (also known as form factor) of the -// user's device. * `countryCode` (string): the country or region of the -// user's device based on their IP address, represented as a 2-letter -// ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` -// (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * -// `deviceSocMake` (string): Make of the device's primary +// * `deviceBrand` (string): unique identifier of the user's device +// brand. * `deviceType` (string): the type (also known as form factor) +// of the user's device. * `countryCode` (string): the country or region +// of the user's device based on their IP address, represented as a +// 2-letter ISO-3166 code (e.g. US for the United States). * +// `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, +// 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary // system-on-chip, e.g., Samsung. Reference // (https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) // * `deviceSocModel` (string): Model of the device's primary @@ -2475,12 +2486,13 @@ func (s *GooglePlayDeveloperReportingV1beta1SlowStartRateMetricSet) MarshalJSON( // Android that was running on the user's device. * `versionCode` // (int64): version of the app that was running on the user's device. * // `deviceModel` (string): unique identifier of the user's device model. -// * `deviceType` (string): the type (also known as form factor) of the -// user's device. * `countryCode` (string): the country or region of the -// user's device based on their IP address, represented as a 2-letter -// ISO-3166 code (e.g. US for the United States). * `deviceRamBucket` -// (int64): RAM of the device, in MB, in buckets (3GB, 4GB, etc.). * -// `deviceSocMake` (string): Make of the device's primary +// * `deviceBrand` (string): unique identifier of the user's device +// brand. * `deviceType` (string): the type (also known as form factor) +// of the user's device. * `countryCode` (string): the country or region +// of the user's device based on their IP address, represented as a +// 2-letter ISO-3166 code (e.g. US for the United States). * +// `deviceRamBucket` (int64): RAM of the device, in MB, in buckets (3GB, +// 4GB, etc.). * `deviceSocMake` (string): Make of the device's primary // system-on-chip, e.g., Samsung. Reference // (https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER) // * `deviceSocModel` (string): Model of the device's primary @@ -3984,15 +3996,17 @@ func (r *VitalsErrorsIssuesService) Search(parent string) *VitalsErrorsIssuesSea // app version codes only. Example: `versionCode = 123 OR versionCode = // 456`. * `deviceModel`: Matches error issues that occurred in the // requested devices. Example: `deviceModel = "walleye" OR deviceModel = -// "marlin". * `deviceType`: Matches error issues that occurred in the -// requested device types. Example: `deviceType = "PHONE". * -// `errorIssueType`: Matches error issues of the requested types only. -// Valid candidates: `CRASH`, `ANR`. Example: `errorIssueType = CRASH OR -// errorIssueType = ANR`. * `appProcessState`: Matches error issues on -// the process state of an app, indicating whether an app runs in the -// foreground (user-visible) or background. Valid candidates: -// `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. -// * `isUserPerceived`: Matches error issues that are user-perceived. It +// "marlin". * `deviceBrand`: Matches error issues that occurred in the +// requested device brands. Example: `deviceBrand = "Google". * +// `deviceType`: Matches error issues that occurred in the requested +// device types. Example: `deviceType = "PHONE". * `errorIssueType`: +// Matches error issues of the requested types only. Valid candidates: +// `CRASH`, `ANR`. Example: `errorIssueType = CRASH OR errorIssueType = +// ANR`. * `appProcessState`: Matches error issues on the process state +// of an app, indicating whether an app runs in the foreground +// (user-visible) or background. Valid candidates: `FOREGROUND`, +// `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * +// `isUserPerceived`: Matches error issues that are user-perceived. It // is not accompanied by any operators. Example: `isUserPerceived`. ** // Supported operators:** * Comparison operators: The only supported // comparison operator is equality. The filtered field must appear on @@ -4308,7 +4322,7 @@ func (c *VitalsErrorsIssuesSearchCall) Do(opts ...googleapi.CallOption) (*Google // ], // "parameters": { // "filter": { - // "description": "A selection predicate to retrieve only a subset of the issues. Counts in the returned error issues will only reflect occurrences that matched the filter. For filtering basics, please check [AIP-160](https://google.aip.dev/160). ** Supported field names:** * `apiLevel`: Matches error issues that occurred in the requested Android versions (specified as the numeric API level) only. Example: `apiLevel = 28 OR apiLevel = 29`. * `versionCode`: Matches error issues that occurred in the requested app version codes only. Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: Matches error issues that occurred in the requested devices. Example: `deviceModel = \"walleye\" OR deviceModel = \"marlin\"`. * `deviceType`: Matches error issues that occurred in the requested device types. Example: `deviceType = \"PHONE\"`. * `errorIssueType`: Matches error issues of the requested types only. Valid candidates: `CRASH`, `ANR`. Example: `errorIssueType = CRASH OR errorIssueType = ANR`. * `appProcessState`: Matches error issues on the process state of an app, indicating whether an app runs in the foreground (user-visible) or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error issues that are user-perceived. It is not accompanied by any operators. Example: `isUserPerceived`. ** Supported operators:** * Comparison operators: The only supported comparison operator is equality. The filtered field must appear on the left hand side of the comparison. * Logical Operators: Logical operators `AND` and `OR` can be used to build complex filters following a conjunctive normal form (CNF), i.e., conjunctions of disjunctions. The `OR` operator takes precedence over `AND` so the use of parenthesis is not necessary when building CNF. The `OR` operator is only supported to build disjunctions that apply to the same field, e.g., `versionCode = 123 OR errorIssueType = ANR` is not a valid filter. ** Examples ** Some valid filtering expressions: * `versionCode = 123 AND errorIssueType = ANR` * `versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH` * `versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)`", + // "description": "A selection predicate to retrieve only a subset of the issues. Counts in the returned error issues will only reflect occurrences that matched the filter. For filtering basics, please check [AIP-160](https://google.aip.dev/160). ** Supported field names:** * `apiLevel`: Matches error issues that occurred in the requested Android versions (specified as the numeric API level) only. Example: `apiLevel = 28 OR apiLevel = 29`. * `versionCode`: Matches error issues that occurred in the requested app version codes only. Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: Matches error issues that occurred in the requested devices. Example: `deviceModel = \"walleye\" OR deviceModel = \"marlin\"`. * `deviceBrand`: Matches error issues that occurred in the requested device brands. Example: `deviceBrand = \"Google\". * `deviceType`: Matches error issues that occurred in the requested device types. Example: `deviceType = \"PHONE\"`. * `errorIssueType`: Matches error issues of the requested types only. Valid candidates: `CRASH`, `ANR`. Example: `errorIssueType = CRASH OR errorIssueType = ANR`. * `appProcessState`: Matches error issues on the process state of an app, indicating whether an app runs in the foreground (user-visible) or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error issues that are user-perceived. It is not accompanied by any operators. Example: `isUserPerceived`. ** Supported operators:** * Comparison operators: The only supported comparison operator is equality. The filtered field must appear on the left hand side of the comparison. * Logical Operators: Logical operators `AND` and `OR` can be used to build complex filters following a conjunctive normal form (CNF), i.e., conjunctions of disjunctions. The `OR` operator takes precedence over `AND` so the use of parenthesis is not necessary when building CNF. The `OR` operator is only supported to build disjunctions that apply to the same field, e.g., `versionCode = 123 OR errorIssueType = ANR` is not a valid filter. ** Examples ** Some valid filtering expressions: * `versionCode = 123 AND errorIssueType = ANR` * `versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH` * `versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)`", // "location": "query", // "type": "string" // }, @@ -4510,16 +4524,18 @@ func (r *VitalsErrorsReportsService) Search(parent string) *VitalsErrorsReportsS // Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: // Matches error reports that occurred in the requested devices. // Example: `deviceModel = "walleye" OR deviceModel = "marlin". * -// `deviceType`: Matches error reports that occurred in the requested -// device types. Example: `deviceType = "PHONE". * `errorIssueType`: -// Matches error reports of the requested types only. Valid candidates: -// `JAVA_CRASH`, `NATIVE_CRASH`, `ANR`. Example: `errorIssueType = -// JAVA_CRASH OR errorIssueType = NATIVE_CRASH`. * `errorIssueId`: -// Matches error reports belonging to the requested error issue ids -// only. Example: `errorIssueId = 1234 OR errorIssueId = 4567`. * -// `appProcessState`: Matches error reports on the process state of an -// app, indicating whether an app runs in the foreground (user-visible) -// or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: +// `deviceBrand`: Matches error issues that occurred in the requested +// device brands. Example: `deviceBrand = "Google". * `deviceType`: +// Matches error reports that occurred in the requested device types. +// Example: `deviceType = "PHONE". * `errorIssueType`: Matches error +// reports of the requested types only. Valid candidates: `JAVA_CRASH`, +// `NATIVE_CRASH`, `ANR`. Example: `errorIssueType = JAVA_CRASH OR +// errorIssueType = NATIVE_CRASH`. * `errorIssueId`: Matches error +// reports belonging to the requested error issue ids only. Example: +// `errorIssueId = 1234 OR errorIssueId = 4567`. * `appProcessState`: +// Matches error reports on the process state of an app, indicating +// whether an app runs in the foreground (user-visible) or background. +// Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: // `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error // reports that are user-perceived. It is not accompanied by any // operators. Example: `isUserPerceived`. ** Supported operators:** * @@ -4839,7 +4855,7 @@ func (c *VitalsErrorsReportsSearchCall) Do(opts ...googleapi.CallOption) (*Googl // ], // "parameters": { // "filter": { - // "description": "A selection predicate to retrieve only a subset of the reports. For filtering basics, please check [AIP-160](https://google.aip.dev/160). ** Supported field names:** * `apiLevel`: Matches error reports that occurred in the requested Android versions (specified as the numeric API level) only. Example: `apiLevel = 28 OR apiLevel = 29`. * `versionCode`: Matches error reports that occurred in the requested app version codes only. Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: Matches error reports that occurred in the requested devices. Example: `deviceModel = \"walleye\" OR deviceModel = \"marlin\"`. * `deviceType`: Matches error reports that occurred in the requested device types. Example: `deviceType = \"PHONE\"`. * `errorIssueType`: Matches error reports of the requested types only. Valid candidates: `JAVA_CRASH`, `NATIVE_CRASH`, `ANR`. Example: `errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH`. * `errorIssueId`: Matches error reports belonging to the requested error issue ids only. Example: `errorIssueId = 1234 OR errorIssueId = 4567`. * `appProcessState`: Matches error reports on the process state of an app, indicating whether an app runs in the foreground (user-visible) or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error reports that are user-perceived. It is not accompanied by any operators. Example: `isUserPerceived`. ** Supported operators:** * Comparison operators: The only supported comparison operator is equality. The filtered field must appear on the left hand side of the comparison. * Logical Operators: Logical operators `AND` and `OR` can be used to build complex filters following a conjunctive normal form (CNF), i.e., conjunctions of disjunctions. The `OR` operator takes precedence over `AND` so the use of parenthesis is not necessary when building CNF. The `OR` operator is only supported to build disjunctions that apply to the same field, e.g., `versionCode = 123 OR versionCode = ANR`. The filter expression `versionCode = 123 OR errorIssueType = ANR` is not valid. ** Examples ** Some valid filtering expressions: * `versionCode = 123 AND errorIssueType = ANR` * `versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH` * `versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)`", + // "description": "A selection predicate to retrieve only a subset of the reports. For filtering basics, please check [AIP-160](https://google.aip.dev/160). ** Supported field names:** * `apiLevel`: Matches error reports that occurred in the requested Android versions (specified as the numeric API level) only. Example: `apiLevel = 28 OR apiLevel = 29`. * `versionCode`: Matches error reports that occurred in the requested app version codes only. Example: `versionCode = 123 OR versionCode = 456`. * `deviceModel`: Matches error reports that occurred in the requested devices. Example: `deviceModel = \"walleye\" OR deviceModel = \"marlin\"`. * `deviceBrand`: Matches error issues that occurred in the requested device brands. Example: `deviceBrand = \"Google\". * `deviceType`: Matches error reports that occurred in the requested device types. Example: `deviceType = \"PHONE\"`. * `errorIssueType`: Matches error reports of the requested types only. Valid candidates: `JAVA_CRASH`, `NATIVE_CRASH`, `ANR`. Example: `errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH`. * `errorIssueId`: Matches error reports belonging to the requested error issue ids only. Example: `errorIssueId = 1234 OR errorIssueId = 4567`. * `appProcessState`: Matches error reports on the process state of an app, indicating whether an app runs in the foreground (user-visible) or background. Valid candidates: `FOREGROUND`, `BACKGROUND`. Example: `appProcessState = FOREGROUND`. * `isUserPerceived`: Matches error reports that are user-perceived. It is not accompanied by any operators. Example: `isUserPerceived`. ** Supported operators:** * Comparison operators: The only supported comparison operator is equality. The filtered field must appear on the left hand side of the comparison. * Logical Operators: Logical operators `AND` and `OR` can be used to build complex filters following a conjunctive normal form (CNF), i.e., conjunctions of disjunctions. The `OR` operator takes precedence over `AND` so the use of parenthesis is not necessary when building CNF. The `OR` operator is only supported to build disjunctions that apply to the same field, e.g., `versionCode = 123 OR versionCode = ANR`. The filter expression `versionCode = 123 OR errorIssueType = ANR` is not valid. ** Examples ** Some valid filtering expressions: * `versionCode = 123 AND errorIssueType = ANR` * `versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH` * `versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)`", // "location": "query", // "type": "string" // }, diff --git a/privateca/v1/privateca-api.json b/privateca/v1/privateca-api.json index 66345432278..1e7caa73e3d 100644 --- a/privateca/v1/privateca-api.json +++ b/privateca/v1/privateca-api.json @@ -1605,7 +1605,7 @@ } } }, - "revision": "20230403", + "revision": "20230426", "rootUrl": "https://privateca.googleapis.com/", "schemas": { "AccessUrls": { @@ -2757,7 +2757,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/privateca/v1/privateca-gen.go b/privateca/v1/privateca-gen.go index 0ffccdc84b9..428effd93e8 100644 --- a/privateca/v1/privateca-gen.go +++ b/privateca/v1/privateca-gen.go @@ -2237,7 +2237,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/privateca/v1beta1/privateca-api.json b/privateca/v1beta1/privateca-api.json index fefd3079726..c4156c8e552 100644 --- a/privateca/v1beta1/privateca-api.json +++ b/privateca/v1beta1/privateca-api.json @@ -580,7 +580,7 @@ } } }, - "revision": "20230403", + "revision": "20230426", "rootUrl": "https://privateca.googleapis.com/", "schemas": { "AuditConfig": { @@ -725,7 +725,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/privateca/v1beta1/privateca-gen.go b/privateca/v1beta1/privateca-gen.go index 57e5e7f056c..66f9e19de63 100644 --- a/privateca/v1beta1/privateca-gen.go +++ b/privateca/v1beta1/privateca-gen.go @@ -532,7 +532,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/pubsub/v1/pubsub-api.json b/pubsub/v1/pubsub-api.json index ac519b603f7..bc9be42a9a1 100644 --- a/pubsub/v1/pubsub-api.json +++ b/pubsub/v1/pubsub-api.json @@ -1565,7 +1565,7 @@ } } }, - "revision": "20230218", + "revision": "20230425", "rootUrl": "https://pubsub.googleapis.com/", "schemas": { "AcknowledgeRequest": { @@ -1582,6 +1582,17 @@ }, "type": "object" }, + "AvroConfig": { + "description": "Configuration for writing message data in Avro format. Message payloads and metadata will be written to files as an Avro binary.", + "id": "AvroConfig", + "properties": { + "writeMetadata": { + "description": "When true, write the subscription name, message_id, publish_time, attributes, and ordering_key as additional fields in the output.", + "type": "boolean" + } + }, + "type": "object" + }, "BigQueryConfig": { "description": "Configuration for a BigQuery subscription.", "id": "BigQueryConfig", @@ -1646,6 +1657,60 @@ }, "type": "object" }, + "CloudStorageConfig": { + "description": "Configuration for a Cloud Storage subscription.", + "id": "CloudStorageConfig", + "properties": { + "avroConfig": { + "$ref": "AvroConfig", + "description": "If set, message data will be written to Cloud Storage in Avro format." + }, + "bucket": { + "description": "Required. User-provided name for the Cloud Storage bucket. The bucket must be created by the user. The bucket name must be without any prefix like \"gs://\". See the [bucket naming requirements] (https://cloud.google.com/storage/docs/buckets#naming).", + "type": "string" + }, + "filenamePrefix": { + "description": "User-provided prefix for Cloud Storage filename. See the [object naming requirements](https://cloud.google.com/storage/docs/objects#naming).", + "type": "string" + }, + "filenameSuffix": { + "description": "User-provided suffix for Cloud Storage filename. See the [object naming requirements](https://cloud.google.com/storage/docs/objects#naming).", + "type": "string" + }, + "maxBytes": { + "description": "The maximum bytes that can be written to a Cloud Storage file before a new file is created. Min 1 KB, max 10 GiB. The max_bytes limit may be exceeded in cases where messages are larger than the limit.", + "format": "int64", + "type": "string" + }, + "maxDuration": { + "description": "The maximum duration that can elapse before a new Cloud Storage file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed the subscription's acknowledgement deadline.", + "format": "google-duration", + "type": "string" + }, + "state": { + "description": "Output only. An output-only field that indicates whether or not the subscription can receive messages.", + "enum": [ + "STATE_UNSPECIFIED", + "ACTIVE", + "PERMISSION_DENIED", + "NOT_FOUND" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "The subscription can actively send messages to Cloud Storage.", + "Cannot write to the Cloud Storage bucket because of permission denied errors.", + "Cannot write to the Cloud Storage bucket because it does not exist." + ], + "readOnly": true, + "type": "string" + }, + "textConfig": { + "$ref": "TextConfig", + "description": "If set, message data will be written to Cloud Storage in text format." + } + }, + "type": "object" + }, "CommitSchemaRequest": { "description": "Request for CommitSchema method.", "id": "CommitSchemaRequest", @@ -2240,7 +2305,7 @@ "type": "object" }, "Subscription": { - "description": "A subscription resource. If none of `push_config` or `bigquery_config` is set, then the subscriber will pull and ack messages using API methods. At most one of these fields may be set.", + "description": "A subscription resource. If none of `push_config`, `bigquery_config`, or `cloud_storage_config` is set, then the subscriber will pull and ack messages using API methods. At most one of these fields may be set.", "id": "Subscription", "properties": { "ackDeadlineSeconds": { @@ -2252,6 +2317,10 @@ "$ref": "BigQueryConfig", "description": "If delivery to BigQuery is used with this subscription, this field is used to configure it." }, + "cloudStorageConfig": { + "$ref": "CloudStorageConfig", + "description": "If delivery to Google Cloud Storage is used with this subscription, this field is used to configure it." + }, "deadLetterPolicy": { "$ref": "DeadLetterPolicy", "description": "A policy that specifies the conditions for dead lettering messages in this subscription. If dead_letter_policy is not set, dead lettering is disabled. The Cloud Pub/Sub service account associated with this subscriptions's parent project (i.e., service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have permission to Acknowledge() messages on this subscription." @@ -2360,6 +2429,12 @@ }, "type": "object" }, + "TextConfig": { + "description": "Configuration for writing message data in text format. Message payloads will be written to files as raw text, separated by a newline.", + "id": "TextConfig", + "properties": {}, + "type": "object" + }, "Topic": { "description": "A topic resource.", "id": "Topic", diff --git a/pubsub/v1/pubsub-gen.go b/pubsub/v1/pubsub-gen.go index 10e12148f90..c9b38561407 100644 --- a/pubsub/v1/pubsub-gen.go +++ b/pubsub/v1/pubsub-gen.go @@ -259,6 +259,38 @@ func (s *AcknowledgeRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// AvroConfig: Configuration for writing message data in Avro format. +// Message payloads and metadata will be written to files as an Avro +// binary. +type AvroConfig struct { + // WriteMetadata: When true, write the subscription name, message_id, + // publish_time, attributes, and ordering_key as additional fields in + // the output. + WriteMetadata bool `json:"writeMetadata,omitempty"` + + // ForceSendFields is a list of field names (e.g. "WriteMetadata") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "WriteMetadata") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *AvroConfig) MarshalJSON() ([]byte, error) { + type NoMethod AvroConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // BigQueryConfig: Configuration for a BigQuery subscription. type BigQueryConfig struct { // DropUnknownFields: When true and use_topic_schema is true, any fields @@ -406,6 +438,79 @@ func (s *Binding) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// CloudStorageConfig: Configuration for a Cloud Storage subscription. +type CloudStorageConfig struct { + // AvroConfig: If set, message data will be written to Cloud Storage in + // Avro format. + AvroConfig *AvroConfig `json:"avroConfig,omitempty"` + + // Bucket: Required. User-provided name for the Cloud Storage bucket. + // The bucket must be created by the user. The bucket name must be + // without any prefix like "gs://". See the [bucket naming requirements] + // (https://cloud.google.com/storage/docs/buckets#naming). + Bucket string `json:"bucket,omitempty"` + + // FilenamePrefix: User-provided prefix for Cloud Storage filename. See + // the object naming requirements + // (https://cloud.google.com/storage/docs/objects#naming). + FilenamePrefix string `json:"filenamePrefix,omitempty"` + + // FilenameSuffix: User-provided suffix for Cloud Storage filename. See + // the object naming requirements + // (https://cloud.google.com/storage/docs/objects#naming). + FilenameSuffix string `json:"filenameSuffix,omitempty"` + + // MaxBytes: The maximum bytes that can be written to a Cloud Storage + // file before a new file is created. Min 1 KB, max 10 GiB. The + // max_bytes limit may be exceeded in cases where messages are larger + // than the limit. + MaxBytes int64 `json:"maxBytes,omitempty,string"` + + // MaxDuration: The maximum duration that can elapse before a new Cloud + // Storage file is created. Min 1 minute, max 10 minutes, default 5 + // minutes. May not exceed the subscription's acknowledgement deadline. + MaxDuration string `json:"maxDuration,omitempty"` + + // State: Output only. An output-only field that indicates whether or + // not the subscription can receive messages. + // + // Possible values: + // "STATE_UNSPECIFIED" - Default value. This value is unused. + // "ACTIVE" - The subscription can actively send messages to Cloud + // Storage. + // "PERMISSION_DENIED" - Cannot write to the Cloud Storage bucket + // because of permission denied errors. + // "NOT_FOUND" - Cannot write to the Cloud Storage bucket because it + // does not exist. + State string `json:"state,omitempty"` + + // TextConfig: If set, message data will be written to Cloud Storage in + // text format. + TextConfig *TextConfig `json:"textConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AvroConfig") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AvroConfig") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *CloudStorageConfig) MarshalJSON() ([]byte, error) { + type NoMethod CloudStorageConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // CommitSchemaRequest: Request for CommitSchema method. type CommitSchemaRequest struct { // Schema: Required. The schema revision to commit. @@ -1771,9 +1876,10 @@ func (s *Snapshot) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Subscription: A subscription resource. If none of `push_config` or -// `bigquery_config` is set, then the subscriber will pull and ack -// messages using API methods. At most one of these fields may be set. +// Subscription: A subscription resource. If none of `push_config`, +// `bigquery_config`, or `cloud_storage_config` is set, then the +// subscriber will pull and ack messages using API methods. At most one +// of these fields may be set. type Subscription struct { // AckDeadlineSeconds: The approximate amount of time (on a best-effort // basis) Pub/Sub waits for the subscriber to acknowledge receipt before @@ -1797,6 +1903,10 @@ type Subscription struct { // subscription, this field is used to configure it. BigqueryConfig *BigQueryConfig `json:"bigqueryConfig,omitempty"` + // CloudStorageConfig: If delivery to Google Cloud Storage is used with + // this subscription, this field is used to configure it. + CloudStorageConfig *CloudStorageConfig `json:"cloudStorageConfig,omitempty"` + // DeadLetterPolicy: A policy that specifies the conditions for dead // lettering messages in this subscription. If dead_letter_policy is not // set, dead lettering is disabled. The Cloud Pub/Sub service account @@ -2009,6 +2119,12 @@ func (s *TestIamPermissionsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// TextConfig: Configuration for writing message data in text format. +// Message payloads will be written to files as raw text, separated by a +// newline. +type TextConfig struct { +} + // Topic: A topic resource. type Topic struct { // KmsKeyName: The resource name of the Cloud KMS CryptoKey to be used diff --git a/redis/v1/redis-api.json b/redis/v1/redis-api.json index cc6bcb9e471..00791dfb47d 100644 --- a/redis/v1/redis-api.json +++ b/redis/v1/redis-api.json @@ -624,7 +624,7 @@ } } }, - "revision": "20230418", + "revision": "20230428", "rootUrl": "https://redis.googleapis.com/", "schemas": { "Empty": { @@ -1092,7 +1092,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/redis/v1/redis-gen.go b/redis/v1/redis-gen.go index d33779b9139..62727e53cb4 100644 --- a/redis/v1/redis-gen.go +++ b/redis/v1/redis-gen.go @@ -882,7 +882,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/redis/v1beta1/redis-api.json b/redis/v1beta1/redis-api.json index 464a3b90382..15a0250baa1 100644 --- a/redis/v1beta1/redis-api.json +++ b/redis/v1beta1/redis-api.json @@ -624,7 +624,7 @@ } } }, - "revision": "20230418", + "revision": "20230428", "rootUrl": "https://redis.googleapis.com/", "schemas": { "Empty": { @@ -1099,7 +1099,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/redis/v1beta1/redis-gen.go b/redis/v1beta1/redis-gen.go index ba1c042934d..232b9f31ee2 100644 --- a/redis/v1beta1/redis-gen.go +++ b/redis/v1beta1/redis-gen.go @@ -887,7 +887,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/retail/v2/retail-api.json b/retail/v2/retail-api.json index 629d940c3c5..a6908013ba0 100644 --- a/retail/v2/retail-api.json +++ b/retail/v2/retail-api.json @@ -2031,7 +2031,7 @@ } } }, - "revision": "20230420", + "revision": "20230504", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -3370,11 +3370,11 @@ "type": "object" }, "GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig": { - "description": "More configs of the frequently-bought-together model type.", + "description": "Additional configs for the frequently-bought-together model type.", "id": "GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig", "properties": { "contextProductsType": { - "description": "Optional. Specifies the context of the model when used in predict requests. Only settable for the `frequently-bought-together` type. Will default to MULTI_CONTEXT if not specified.", + "description": "Optional. Specifies the context of the model when it is used in predict requests. Can only be set for the `frequently-bought-together` type. If it isn't specified, it defaults to MULTIPLE_CONTEXT_PRODUCTS.", "enum": [ "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED", "SINGLE_CONTEXT_PRODUCT", @@ -5433,11 +5433,11 @@ "type": "object" }, "GoogleCloudRetailV2alphaMerchantCenterAccountLink": { - "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch.", + "description": "Represents a link between a Merchant Center account and a branch. After a link is established, products from the linked Merchant Center account are streamed to the linked branch.", "id": "GoogleCloudRetailV2alphaMerchantCenterAccountLink", "properties": { "branchId": { - "description": "Required. The branch id (e.g. 0/1/2) within the catalog that products from merchant_center_account_id are streamed to. When updating this field, an empty value will use the currently configured default branch. However, changing the default branch later on won't change the linked branch here. A single branch id can only have one linked merchant center account id.", + "description": "Required. The branch ID (e.g. 0/1/2) within the catalog that products from merchant_center_account_id are streamed to. When updating this field, an empty value will use the currently configured default branch. However, changing the default branch later on won't change the linked branch here. A single branch ID can only have one linked Merchant Center account ID.", "type": "string" }, "feedFilters": { @@ -5650,11 +5650,11 @@ "type": "object" }, "GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig": { - "description": "More configs of the frequently-bought-together model type.", + "description": "Additional configs for the frequently-bought-together model type.", "id": "GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig", "properties": { "contextProductsType": { - "description": "Optional. Specifies the context of the model when used in predict requests. Only settable for the `frequently-bought-together` type. Will default to MULTI_CONTEXT if not specified.", + "description": "Optional. Specifies the context of the model when it is used in predict requests. Can only be set for the `frequently-bought-together` type. If it isn't specified, it defaults to MULTIPLE_CONTEXT_PRODUCTS.", "enum": [ "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED", "SINGLE_CONTEXT_PRODUCT", @@ -6205,11 +6205,11 @@ "type": "object" }, "GoogleCloudRetailV2betaMerchantCenterAccountLink": { - "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch.", + "description": "Represents a link between a Merchant Center account and a branch. After a link is established, products from the linked Merchant Center account are streamed to the linked branch.", "id": "GoogleCloudRetailV2betaMerchantCenterAccountLink", "properties": { "branchId": { - "description": "Required. The branch id (e.g. 0/1/2) within the catalog that products from merchant_center_account_id are streamed to. When updating this field, an empty value will use the currently configured default branch. However, changing the default branch later on won't change the linked branch here. A single branch id can only have one linked merchant center account id.", + "description": "Required. The branch ID (e.g. 0/1/2) within the catalog that products from merchant_center_account_id are streamed to. When updating this field, an empty value will use the currently configured default branch. However, changing the default branch later on won't change the linked branch here. A single branch ID can only have one linked Merchant Center account ID.", "type": "string" }, "feedFilters": { @@ -6418,11 +6418,11 @@ "type": "object" }, "GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig": { - "description": "More configs of the frequently-bought-together model type.", + "description": "Additional configs for the frequently-bought-together model type.", "id": "GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig", "properties": { "contextProductsType": { - "description": "Optional. Specifies the context of the model when used in predict requests. Only settable for the `frequently-bought-together` type. Will default to MULTI_CONTEXT if not specified.", + "description": "Optional. Specifies the context of the model when it is used in predict requests. Can only be set for the `frequently-bought-together` type. If it isn't specified, it defaults to MULTIPLE_CONTEXT_PRODUCTS.", "enum": [ "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED", "SINGLE_CONTEXT_PRODUCT", diff --git a/retail/v2/retail-gen.go b/retail/v2/retail-gen.go index 07cdb85c73e..513f742d60a 100644 --- a/retail/v2/retail-gen.go +++ b/retail/v2/retail-gen.go @@ -2849,13 +2849,13 @@ func (s *GoogleCloudRetailV2Model) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig: More -// configs of the frequently-bought-together model type. +// GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig: +// Additional configs for the frequently-bought-together model type. type GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig struct { // ContextProductsType: Optional. Specifies the context of the model - // when used in predict requests. Only settable for the - // `frequently-bought-together` type. Will default to MULTI_CONTEXT if - // not specified. + // when it is used in predict requests. Can only be set for the + // `frequently-bought-together` type. If it isn't specified, it defaults + // to MULTIPLE_CONTEXT_PRODUCTS. // // Possible values: // "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED" - Unspecified default value, @@ -6933,16 +6933,16 @@ func (s *GoogleCloudRetailV2alphaImportUserEventsResponse) MarshalJSON() ([]byte } // GoogleCloudRetailV2alphaMerchantCenterAccountLink: Represents a link -// between a Merchant Center account and a branch. Once a link is -// established, products from the linked merchant center account will be +// between a Merchant Center account and a branch. After a link is +// established, products from the linked Merchant Center account are // streamed to the linked branch. type GoogleCloudRetailV2alphaMerchantCenterAccountLink struct { - // BranchId: Required. The branch id (e.g. 0/1/2) within the catalog + // BranchId: Required. The branch ID (e.g. 0/1/2) within the catalog // that products from merchant_center_account_id are streamed to. When // updating this field, an empty value will use the currently configured // default branch. However, changing the default branch later on won't - // change the linked branch here. A single branch id can only have one - // linked merchant center account id. + // change the linked branch here. A single branch ID can only have one + // linked Merchant Center account ID. BranchId string `json:"branchId,omitempty"` // FeedFilters: Criteria for the Merchant Center feeds to be ingested @@ -7221,12 +7221,12 @@ func (s *GoogleCloudRetailV2alphaModel) MarshalJSON() ([]byte, error) { } // GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig: -// More configs of the frequently-bought-together model type. +// Additional configs for the frequently-bought-together model type. type GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig struct { // ContextProductsType: Optional. Specifies the context of the model - // when used in predict requests. Only settable for the - // `frequently-bought-together` type. Will default to MULTI_CONTEXT if - // not specified. + // when it is used in predict requests. Can only be set for the + // `frequently-bought-together` type. If it isn't specified, it defaults + // to MULTIPLE_CONTEXT_PRODUCTS. // // Possible values: // "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED" - Unspecified default value, @@ -8338,16 +8338,16 @@ func (s *GoogleCloudRetailV2betaImportUserEventsResponse) MarshalJSON() ([]byte, } // GoogleCloudRetailV2betaMerchantCenterAccountLink: Represents a link -// between a Merchant Center account and a branch. Once a link is -// established, products from the linked merchant center account will be +// between a Merchant Center account and a branch. After a link is +// established, products from the linked Merchant Center account are // streamed to the linked branch. type GoogleCloudRetailV2betaMerchantCenterAccountLink struct { - // BranchId: Required. The branch id (e.g. 0/1/2) within the catalog + // BranchId: Required. The branch ID (e.g. 0/1/2) within the catalog // that products from merchant_center_account_id are streamed to. When // updating this field, an empty value will use the currently configured // default branch. However, changing the default branch later on won't - // change the linked branch here. A single branch id can only have one - // linked merchant center account id. + // change the linked branch here. A single branch ID can only have one + // linked Merchant Center account ID. BranchId string `json:"branchId,omitempty"` // FeedFilters: Criteria for the Merchant Center feeds to be ingested @@ -8623,12 +8623,12 @@ func (s *GoogleCloudRetailV2betaModel) MarshalJSON() ([]byte, error) { } // GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig: -// More configs of the frequently-bought-together model type. +// Additional configs for the frequently-bought-together model type. type GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig struct { // ContextProductsType: Optional. Specifies the context of the model - // when used in predict requests. Only settable for the - // `frequently-bought-together` type. Will default to MULTI_CONTEXT if - // not specified. + // when it is used in predict requests. Can only be set for the + // `frequently-bought-together` type. If it isn't specified, it defaults + // to MULTIPLE_CONTEXT_PRODUCTS. // // Possible values: // "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED" - Unspecified default value, diff --git a/retail/v2alpha/retail-api.json b/retail/v2alpha/retail-api.json index e59366ef6b6..eb38ede72a4 100644 --- a/retail/v2alpha/retail-api.json +++ b/retail/v2alpha/retail-api.json @@ -1188,7 +1188,7 @@ ], "parameters": { "parent": { - "description": "Required. The branch resource where this MerchantCenterAccountLink will be created. Format: projects/{PROJECT_NUMBER}/locations/global/catalogs/{CATALOG_ID}}", + "description": "Required. The branch resource where this MerchantCenterAccountLink will be created. Format: `projects/{PROJECT_NUMBER}/locations/global/catalogs/{CATALOG_ID}`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$", "required": true, @@ -1216,7 +1216,7 @@ ], "parameters": { "name": { - "description": "Required. Full resource name. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/merchantCenterAccountLinks/{merchant_center_account_link_id}", + "description": "Required. Full resource name. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/merchantCenterAccountLinks/{merchant_center_account_link_id}`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/merchantCenterAccountLinks/[^/]+$", "required": true, @@ -1241,7 +1241,7 @@ ], "parameters": { "parent": { - "description": "Required. The parent Catalog of the resource. It must match this format: projects/{PROJECT_NUMBER}/locations/global/catalogs/{CATALOG_ID}", + "description": "Required. The parent Catalog of the resource. It must match this format: `projects/{PROJECT_NUMBER}/locations/global/catalogs/{CATALOG_ID}`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$", "required": true, @@ -2217,7 +2217,7 @@ } } }, - "revision": "20230420", + "revision": "20230504", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -2640,11 +2640,11 @@ "type": "object" }, "GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig": { - "description": "More configs of the frequently-bought-together model type.", + "description": "Additional configs for the frequently-bought-together model type.", "id": "GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig", "properties": { "contextProductsType": { - "description": "Optional. Specifies the context of the model when used in predict requests. Only settable for the `frequently-bought-together` type. Will default to MULTI_CONTEXT if not specified.", + "description": "Optional. Specifies the context of the model when it is used in predict requests. Can only be set for the `frequently-bought-together` type. If it isn't specified, it defaults to MULTIPLE_CONTEXT_PRODUCTS.", "enum": [ "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED", "SINGLE_CONTEXT_PRODUCT", @@ -3037,7 +3037,7 @@ }, "merchantCenterLinkingConfig": { "$ref": "GoogleCloudRetailV2alphaMerchantCenterLinkingConfig", - "description": "The Merchant Center linking configuration. Once a link is added, the data stream from Merchant Center to Cloud Retail will be enabled automatically. The requester must have access to the merchant center account in order to make changes to this field." + "description": "The Merchant Center linking configuration. After a link is added, the data stream from Merchant Center to Cloud Retail will be enabled automatically. The requester must have access to the Merchant Center account in order to make changes to this field." }, "name": { "description": "Required. Immutable. The fully qualified resource name of the catalog.", @@ -3082,20 +3082,6 @@ ], "type": "string" }, - "facetIntervals": { - "description": "Set manually for numerical attributes only. If the facet SearchResponse.FacetSpec.intervals are not set by the customer for a numerical attribute, then a weekly pipeline will calculate some intervals using some percentiles on the distribution of all its product numerical attribute values. The latter computed intervals might not be ideal for the use case of that attribute. For this reason, the customer can set them manually. As another option, for any numerical attribute that is passed as a facet key in the request along with some given intervals, then these given intervals will be the facet intervals returned in the response.", - "items": { - "$ref": "GoogleCloudRetailV2alphaInterval" - }, - "type": "array" - }, - "ignoredFacetValues": { - "description": "Each instance represents a list of attribute values to ignore as facet values for a specific time range.", - "items": { - "$ref": "GoogleCloudRetailV2alphaCatalogAttributeIgnoredFacetValues" - }, - "type": "array" - }, "inUse": { "description": "Output only. Indicates whether this attribute has been used by any products. `True` if at least one Product is using this attribute in Product.attributes. Otherwise, this field is `False`. CatalogAttribute can be pre-loaded by using CatalogService.AddCatalogAttribute, CatalogService.ImportCatalogAttributes, or CatalogService.UpdateAttributesConfig APIs. This field is `False` for pre-loaded CatalogAttributes. Only pre-loaded catalog attributes that are neither in use by products nor predefined can be deleted. Catalog attributes that are either in use by products or are predefined attributes cannot be deleted; however, their configuration properties will reset to default values upon removal request. After catalog changes, it takes about 10 minutes for this field to update.", "readOnly": true, @@ -3179,30 +3165,6 @@ }, "type": "object" }, - "GoogleCloudRetailV2alphaCatalogAttributeIgnoredFacetValues": { - "description": "Facet values to ignore on facets during the specified time range for the given SearchResponse.Facet.key attribute.", - "id": "GoogleCloudRetailV2alphaCatalogAttributeIgnoredFacetValues", - "properties": { - "endTime": { - "description": "If start time is empty and end time is not empty, then ignore these facet values before end time.", - "format": "google-datetime", - "type": "string" - }, - "startTime": { - "description": "Time range for the current list of facet values to ignore. If multiple time ranges are specified for an facet value for the current attribute, consider all of them. If both are empty, ignore always. If start time and end time are set, then start time must be before end time. If start time is not empty and end time is empty, then will ignore these facet values after the start time.", - "format": "google-datetime", - "type": "string" - }, - "values": { - "description": "List of facet values to ignore for the following time range. The facet values are the same as the attribute values.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudRetailV2alphaColorInfo": { "description": "The color information of a Product.", "id": "GoogleCloudRetailV2alphaColorInfo", @@ -4113,11 +4075,11 @@ "type": "object" }, "GoogleCloudRetailV2alphaMerchantCenterAccountLink": { - "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch.", + "description": "Represents a link between a Merchant Center account and a branch. After a link is established, products from the linked Merchant Center account are streamed to the linked branch.", "id": "GoogleCloudRetailV2alphaMerchantCenterAccountLink", "properties": { "branchId": { - "description": "Required. The branch id (e.g. 0/1/2) within the catalog that products from merchant_center_account_id are streamed to. When updating this field, an empty value will use the currently configured default branch. However, changing the default branch later on won't change the linked branch here. A single branch id can only have one linked merchant center account id.", + "description": "Required. The branch ID (e.g. 0/1/2) within the catalog that products from merchant_center_account_id are streamed to. When updating this field, an empty value will use the currently configured default branch. However, changing the default branch later on won't change the linked branch here. A single branch ID can only have one linked Merchant Center account ID.", "type": "string" }, "feedFilters": { @@ -4208,11 +4170,11 @@ "type": "object" }, "GoogleCloudRetailV2alphaMerchantCenterLink": { - "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch.", + "description": "Represents a link between a Merchant Center account and a branch. After a link is established, products from the linked Merchant Center account are streamed to the linked branch.", "id": "GoogleCloudRetailV2alphaMerchantCenterLink", "properties": { "branchId": { - "description": "The branch ID (e.g. 0/1/2) within this catalog that products from merchant_center_account_id are streamed to. When updating this field, an empty value will use the currently configured default branch. However, changing the default branch later on won't change the linked branch here. A single branch ID can only have one linked merchant center account ID.", + "description": "The branch ID (e.g. 0/1/2) within this catalog that products from merchant_center_account_id are streamed to. When updating this field, an empty value will use the currently configured default branch. However, changing the default branch later on won't change the linked branch here. A single branch ID can only have one linked Merchant Center account ID.", "type": "string" }, "destinations": { @@ -4234,7 +4196,7 @@ "type": "string" }, "merchantCenterAccountId": { - "description": "Required. The linked [Merchant center account ID](https://developers.google.com/shopping-content/guides/accountstatuses). The account must be a standalone account or a sub-account of a MCA.", + "description": "Required. The linked [Merchant Center account ID](https://developers.google.com/shopping-content/guides/accountstatuses). The account must be a standalone account or a sub-account of a MCA.", "format": "int64", "type": "string" }, @@ -4398,11 +4360,11 @@ "type": "object" }, "GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig": { - "description": "More configs of the frequently-bought-together model type.", + "description": "Additional configs for the frequently-bought-together model type.", "id": "GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig", "properties": { "contextProductsType": { - "description": "Optional. Specifies the context of the model when used in predict requests. Only settable for the `frequently-bought-together` type. Will default to MULTI_CONTEXT if not specified.", + "description": "Optional. Specifies the context of the model when it is used in predict requests. Can only be set for the `frequently-bought-together` type. If it isn't specified, it defaults to MULTIPLE_CONTEXT_PRODUCTS.", "enum": [ "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED", "SINGLE_CONTEXT_PRODUCT", @@ -6643,11 +6605,11 @@ "type": "object" }, "GoogleCloudRetailV2betaMerchantCenterAccountLink": { - "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch.", + "description": "Represents a link between a Merchant Center account and a branch. After a link is established, products from the linked Merchant Center account are streamed to the linked branch.", "id": "GoogleCloudRetailV2betaMerchantCenterAccountLink", "properties": { "branchId": { - "description": "Required. The branch id (e.g. 0/1/2) within the catalog that products from merchant_center_account_id are streamed to. When updating this field, an empty value will use the currently configured default branch. However, changing the default branch later on won't change the linked branch here. A single branch id can only have one linked merchant center account id.", + "description": "Required. The branch ID (e.g. 0/1/2) within the catalog that products from merchant_center_account_id are streamed to. When updating this field, an empty value will use the currently configured default branch. However, changing the default branch later on won't change the linked branch here. A single branch ID can only have one linked Merchant Center account ID.", "type": "string" }, "feedFilters": { @@ -6856,11 +6818,11 @@ "type": "object" }, "GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig": { - "description": "More configs of the frequently-bought-together model type.", + "description": "Additional configs for the frequently-bought-together model type.", "id": "GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig", "properties": { "contextProductsType": { - "description": "Optional. Specifies the context of the model when used in predict requests. Only settable for the `frequently-bought-together` type. Will default to MULTI_CONTEXT if not specified.", + "description": "Optional. Specifies the context of the model when it is used in predict requests. Can only be set for the `frequently-bought-together` type. If it isn't specified, it defaults to MULTIPLE_CONTEXT_PRODUCTS.", "enum": [ "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED", "SINGLE_CONTEXT_PRODUCT", diff --git a/retail/v2alpha/retail-gen.go b/retail/v2alpha/retail-gen.go index 90c6a5a0d92..7cd59bed0d1 100644 --- a/retail/v2alpha/retail-gen.go +++ b/retail/v2alpha/retail-gen.go @@ -1074,13 +1074,13 @@ func (s *GoogleCloudRetailV2Model) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig: More -// configs of the frequently-bought-together model type. +// GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig: +// Additional configs for the frequently-bought-together model type. type GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig struct { // ContextProductsType: Optional. Specifies the context of the model - // when used in predict requests. Only settable for the - // `frequently-bought-together` type. Will default to MULTI_CONTEXT if - // not specified. + // when it is used in predict requests. Can only be set for the + // `frequently-bought-together` type. If it isn't specified, it defaults + // to MULTIPLE_CONTEXT_PRODUCTS. // // Possible values: // "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED" - Unspecified default value, @@ -1860,9 +1860,9 @@ type GoogleCloudRetailV2alphaCatalog struct { DisplayName string `json:"displayName,omitempty"` // MerchantCenterLinkingConfig: The Merchant Center linking - // configuration. Once a link is added, the data stream from Merchant + // configuration. After a link is added, the data stream from Merchant // Center to Cloud Retail will be enabled automatically. The requester - // must have access to the merchant center account in order to make + // must have access to the Merchant Center account in order to make // changes to this field. MerchantCenterLinkingConfig *GoogleCloudRetailV2alphaMerchantCenterLinkingConfig `json:"merchantCenterLinkingConfig,omitempty"` @@ -1932,22 +1932,6 @@ type GoogleCloudRetailV2alphaCatalogAttribute struct { // an attribute. ExactSearchableOption string `json:"exactSearchableOption,omitempty"` - // FacetIntervals: Set manually for numerical attributes only. If the - // facet SearchResponse.FacetSpec.intervals are not set by the customer - // for a numerical attribute, then a weekly pipeline will calculate some - // intervals using some percentiles on the distribution of all its - // product numerical attribute values. The latter computed intervals - // might not be ideal for the use case of that attribute. For this - // reason, the customer can set them manually. As another option, for - // any numerical attribute that is passed as a facet key in the request - // along with some given intervals, then these given intervals will be - // the facet intervals returned in the response. - FacetIntervals []*GoogleCloudRetailV2alphaInterval `json:"facetIntervals,omitempty"` - - // IgnoredFacetValues: Each instance represents a list of attribute - // values to ignore as facet values for a specific time range. - IgnoredFacetValues []*GoogleCloudRetailV2alphaCatalogAttributeIgnoredFacetValues `json:"ignoredFacetValues,omitempty"` - // InUse: Output only. Indicates whether this attribute has been used by // any products. `True` if at least one Product is using this attribute // in Product.attributes. Otherwise, this field is `False`. @@ -2065,49 +2049,6 @@ func (s *GoogleCloudRetailV2alphaCatalogAttribute) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudRetailV2alphaCatalogAttributeIgnoredFacetValues: Facet -// values to ignore on facets during the specified time range for the -// given SearchResponse.Facet.key attribute. -type GoogleCloudRetailV2alphaCatalogAttributeIgnoredFacetValues struct { - // EndTime: If start time is empty and end time is not empty, then - // ignore these facet values before end time. - EndTime string `json:"endTime,omitempty"` - - // StartTime: Time range for the current list of facet values to ignore. - // If multiple time ranges are specified for an facet value for the - // current attribute, consider all of them. If both are empty, ignore - // always. If start time and end time are set, then start time must be - // before end time. If start time is not empty and end time is empty, - // then will ignore these facet values after the start time. - StartTime string `json:"startTime,omitempty"` - - // Values: List of facet values to ignore for the following time range. - // The facet values are the same as the attribute values. - Values []string `json:"values,omitempty"` - - // ForceSendFields is a list of field names (e.g. "EndTime") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "EndTime") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *GoogleCloudRetailV2alphaCatalogAttributeIgnoredFacetValues) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudRetailV2alphaCatalogAttributeIgnoredFacetValues - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleCloudRetailV2alphaColorInfo: The color information of a // Product. type GoogleCloudRetailV2alphaColorInfo struct { @@ -3941,16 +3882,16 @@ func (s *GoogleCloudRetailV2alphaLocalInventory) MarshalJSON() ([]byte, error) { } // GoogleCloudRetailV2alphaMerchantCenterAccountLink: Represents a link -// between a Merchant Center account and a branch. Once a link is -// established, products from the linked merchant center account will be +// between a Merchant Center account and a branch. After a link is +// established, products from the linked Merchant Center account are // streamed to the linked branch. type GoogleCloudRetailV2alphaMerchantCenterAccountLink struct { - // BranchId: Required. The branch id (e.g. 0/1/2) within the catalog + // BranchId: Required. The branch ID (e.g. 0/1/2) within the catalog // that products from merchant_center_account_id are streamed to. When // updating this field, an empty value will use the currently configured // default branch. However, changing the default branch later on won't - // change the linked branch here. A single branch id can only have one - // linked merchant center account id. + // change the linked branch here. A single branch ID can only have one + // linked Merchant Center account ID. BranchId string `json:"branchId,omitempty"` // FeedFilters: Criteria for the Merchant Center feeds to be ingested @@ -4093,16 +4034,16 @@ func (s *GoogleCloudRetailV2alphaMerchantCenterFeedFilter) MarshalJSON() ([]byte } // GoogleCloudRetailV2alphaMerchantCenterLink: Represents a link between -// a Merchant Center account and a branch. Once a link is established, -// products from the linked merchant center account will be streamed to -// the linked branch. +// a Merchant Center account and a branch. After a link is established, +// products from the linked Merchant Center account are streamed to the +// linked branch. type GoogleCloudRetailV2alphaMerchantCenterLink struct { // BranchId: The branch ID (e.g. 0/1/2) within this catalog that // products from merchant_center_account_id are streamed to. When // updating this field, an empty value will use the currently configured // default branch. However, changing the default branch later on won't // change the linked branch here. A single branch ID can only have one - // linked merchant center account ID. + // linked Merchant Center account ID. BranchId string `json:"branchId,omitempty"` // Destinations: String representing the destination to import for, all @@ -4127,7 +4068,7 @@ type GoogleCloudRetailV2alphaMerchantCenterLink struct { // value: `en`. LanguageCode string `json:"languageCode,omitempty"` - // MerchantCenterAccountId: Required. The linked Merchant center account + // MerchantCenterAccountId: Required. The linked Merchant Center account // ID // (https://developers.google.com/shopping-content/guides/accountstatuses). // The account must be a standalone account or a sub-account of a MCA. @@ -4367,12 +4308,12 @@ func (s *GoogleCloudRetailV2alphaModel) MarshalJSON() ([]byte, error) { } // GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig: -// More configs of the frequently-bought-together model type. +// Additional configs for the frequently-bought-together model type. type GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig struct { // ContextProductsType: Optional. Specifies the context of the model - // when used in predict requests. Only settable for the - // `frequently-bought-together` type. Will default to MULTI_CONTEXT if - // not specified. + // when it is used in predict requests. Can only be set for the + // `frequently-bought-together` type. If it isn't specified, it defaults + // to MULTIPLE_CONTEXT_PRODUCTS. // // Possible values: // "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED" - Unspecified default value, @@ -8840,16 +8781,16 @@ func (s *GoogleCloudRetailV2betaImportUserEventsResponse) MarshalJSON() ([]byte, } // GoogleCloudRetailV2betaMerchantCenterAccountLink: Represents a link -// between a Merchant Center account and a branch. Once a link is -// established, products from the linked merchant center account will be +// between a Merchant Center account and a branch. After a link is +// established, products from the linked Merchant Center account are // streamed to the linked branch. type GoogleCloudRetailV2betaMerchantCenterAccountLink struct { - // BranchId: Required. The branch id (e.g. 0/1/2) within the catalog + // BranchId: Required. The branch ID (e.g. 0/1/2) within the catalog // that products from merchant_center_account_id are streamed to. When // updating this field, an empty value will use the currently configured // default branch. However, changing the default branch later on won't - // change the linked branch here. A single branch id can only have one - // linked merchant center account id. + // change the linked branch here. A single branch ID can only have one + // linked Merchant Center account ID. BranchId string `json:"branchId,omitempty"` // FeedFilters: Criteria for the Merchant Center feeds to be ingested @@ -9125,12 +9066,12 @@ func (s *GoogleCloudRetailV2betaModel) MarshalJSON() ([]byte, error) { } // GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig: -// More configs of the frequently-bought-together model type. +// Additional configs for the frequently-bought-together model type. type GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig struct { // ContextProductsType: Optional. Specifies the context of the model - // when used in predict requests. Only settable for the - // `frequently-bought-together` type. Will default to MULTI_CONTEXT if - // not specified. + // when it is used in predict requests. Can only be set for the + // `frequently-bought-together` type. If it isn't specified, it defaults + // to MULTIPLE_CONTEXT_PRODUCTS. // // Possible values: // "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED" - Unspecified default value, @@ -15126,7 +15067,7 @@ type ProjectsLocationsCatalogsMerchantCenterAccountLinksCreateCall struct { // // - parent: The branch resource where this MerchantCenterAccountLink // will be created. Format: -// projects/{PROJECT_NUMBER}/locations/global/catalogs/{CATALOG_ID}}. +// `projects/{PROJECT_NUMBER}/locations/global/catalogs/{CATALOG_ID}`. func (r *ProjectsLocationsCatalogsMerchantCenterAccountLinksService) Create(parent string, googlecloudretailv2alphamerchantcenteraccountlink *GoogleCloudRetailV2alphaMerchantCenterAccountLink) *ProjectsLocationsCatalogsMerchantCenterAccountLinksCreateCall { c := &ProjectsLocationsCatalogsMerchantCenterAccountLinksCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -15234,7 +15175,7 @@ func (c *ProjectsLocationsCatalogsMerchantCenterAccountLinksCreateCall) Do(opts // ], // "parameters": { // "parent": { - // "description": "Required. The branch resource where this MerchantCenterAccountLink will be created. Format: projects/{PROJECT_NUMBER}/locations/global/catalogs/{CATALOG_ID}}", + // "description": "Required. The branch resource where this MerchantCenterAccountLink will be created. Format: `projects/{PROJECT_NUMBER}/locations/global/catalogs/{CATALOG_ID}`", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$", // "required": true, @@ -15270,8 +15211,8 @@ type ProjectsLocationsCatalogsMerchantCenterAccountLinksDeleteCall struct { // is returned. // // - name: Full resource name. Format: -// projects/{project_number}/locations/{location_id}/catalogs/{catalog_ -// id}/merchantCenterAccountLinks/{merchant_center_account_link_id}. +// `projects/{project_number}/locations/{location_id}/catalogs/{catalog +// _id}/merchantCenterAccountLinks/{merchant_center_account_link_id}`. func (r *ProjectsLocationsCatalogsMerchantCenterAccountLinksService) Delete(name string) *ProjectsLocationsCatalogsMerchantCenterAccountLinksDeleteCall { c := &ProjectsLocationsCatalogsMerchantCenterAccountLinksDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -15373,7 +15314,7 @@ func (c *ProjectsLocationsCatalogsMerchantCenterAccountLinksDeleteCall) Do(opts // ], // "parameters": { // "name": { - // "description": "Required. Full resource name. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/merchantCenterAccountLinks/{merchant_center_account_link_id}", + // "description": "Required. Full resource name. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/merchantCenterAccountLinks/{merchant_center_account_link_id}`", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/merchantCenterAccountLinks/[^/]+$", // "required": true, @@ -15407,7 +15348,7 @@ type ProjectsLocationsCatalogsMerchantCenterAccountLinksListCall struct { // // - parent: The parent Catalog of the resource. It must match this // format: -// projects/{PROJECT_NUMBER}/locations/global/catalogs/{CATALOG_ID}. +// `projects/{PROJECT_NUMBER}/locations/global/catalogs/{CATALOG_ID}`. func (r *ProjectsLocationsCatalogsMerchantCenterAccountLinksService) List(parent string) *ProjectsLocationsCatalogsMerchantCenterAccountLinksListCall { c := &ProjectsLocationsCatalogsMerchantCenterAccountLinksListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -15525,7 +15466,7 @@ func (c *ProjectsLocationsCatalogsMerchantCenterAccountLinksListCall) Do(opts .. // ], // "parameters": { // "parent": { - // "description": "Required. The parent Catalog of the resource. It must match this format: projects/{PROJECT_NUMBER}/locations/global/catalogs/{CATALOG_ID}", + // "description": "Required. The parent Catalog of the resource. It must match this format: `projects/{PROJECT_NUMBER}/locations/global/catalogs/{CATALOG_ID}`", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$", // "required": true, diff --git a/retail/v2beta/retail-api.json b/retail/v2beta/retail-api.json index 0bb08a2877f..1cf2d262e5c 100644 --- a/retail/v2beta/retail-api.json +++ b/retail/v2beta/retail-api.json @@ -2059,7 +2059,7 @@ } } }, - "revision": "20230420", + "revision": "20230504", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -2482,11 +2482,11 @@ "type": "object" }, "GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig": { - "description": "More configs of the frequently-bought-together model type.", + "description": "Additional configs for the frequently-bought-together model type.", "id": "GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig", "properties": { "contextProductsType": { - "description": "Optional. Specifies the context of the model when used in predict requests. Only settable for the `frequently-bought-together` type. Will default to MULTI_CONTEXT if not specified.", + "description": "Optional. Specifies the context of the model when it is used in predict requests. Can only be set for the `frequently-bought-together` type. If it isn't specified, it defaults to MULTIPLE_CONTEXT_PRODUCTS.", "enum": [ "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED", "SINGLE_CONTEXT_PRODUCT", @@ -2888,11 +2888,11 @@ "type": "object" }, "GoogleCloudRetailV2alphaMerchantCenterAccountLink": { - "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch.", + "description": "Represents a link between a Merchant Center account and a branch. After a link is established, products from the linked Merchant Center account are streamed to the linked branch.", "id": "GoogleCloudRetailV2alphaMerchantCenterAccountLink", "properties": { "branchId": { - "description": "Required. The branch id (e.g. 0/1/2) within the catalog that products from merchant_center_account_id are streamed to. When updating this field, an empty value will use the currently configured default branch. However, changing the default branch later on won't change the linked branch here. A single branch id can only have one linked merchant center account id.", + "description": "Required. The branch ID (e.g. 0/1/2) within the catalog that products from merchant_center_account_id are streamed to. When updating this field, an empty value will use the currently configured default branch. However, changing the default branch later on won't change the linked branch here. A single branch ID can only have one linked Merchant Center account ID.", "type": "string" }, "feedFilters": { @@ -3105,11 +3105,11 @@ "type": "object" }, "GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig": { - "description": "More configs of the frequently-bought-together model type.", + "description": "Additional configs for the frequently-bought-together model type.", "id": "GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig", "properties": { "contextProductsType": { - "description": "Optional. Specifies the context of the model when used in predict requests. Only settable for the `frequently-bought-together` type. Will default to MULTI_CONTEXT if not specified.", + "description": "Optional. Specifies the context of the model when it is used in predict requests. Can only be set for the `frequently-bought-together` type. If it isn't specified, it defaults to MULTIPLE_CONTEXT_PRODUCTS.", "enum": [ "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED", "SINGLE_CONTEXT_PRODUCT", @@ -3655,7 +3655,7 @@ }, "merchantCenterLinkingConfig": { "$ref": "GoogleCloudRetailV2betaMerchantCenterLinkingConfig", - "description": "The Merchant Center linking configuration. Once a link is added, the data stream from Merchant Center to Cloud Retail will be enabled automatically. The requester must have access to the merchant center account in order to make changes to this field." + "description": "The Merchant Center linking configuration. After a link is added, the data stream from Merchant Center to Cloud Retail will be enabled automatically. The requester must have access to the Merchant Center account in order to make changes to this field." }, "name": { "description": "Required. Immutable. The fully qualified resource name of the catalog.", @@ -4633,11 +4633,11 @@ "type": "object" }, "GoogleCloudRetailV2betaMerchantCenterAccountLink": { - "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch.", + "description": "Represents a link between a Merchant Center account and a branch. After a link is established, products from the linked Merchant Center account are streamed to the linked branch.", "id": "GoogleCloudRetailV2betaMerchantCenterAccountLink", "properties": { "branchId": { - "description": "Required. The branch id (e.g. 0/1/2) within the catalog that products from merchant_center_account_id are streamed to. When updating this field, an empty value will use the currently configured default branch. However, changing the default branch later on won't change the linked branch here. A single branch id can only have one linked merchant center account id.", + "description": "Required. The branch ID (e.g. 0/1/2) within the catalog that products from merchant_center_account_id are streamed to. When updating this field, an empty value will use the currently configured default branch. However, changing the default branch later on won't change the linked branch here. A single branch ID can only have one linked Merchant Center account ID.", "type": "string" }, "feedFilters": { @@ -4728,11 +4728,11 @@ "type": "object" }, "GoogleCloudRetailV2betaMerchantCenterLink": { - "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch.", + "description": "Represents a link between a Merchant Center account and a branch. After a link is established, products from the linked Merchant Center account are streamed to the linked branch.", "id": "GoogleCloudRetailV2betaMerchantCenterLink", "properties": { "branchId": { - "description": "The branch ID (e.g. 0/1/2) within this catalog that products from merchant_center_account_id are streamed to. When updating this field, an empty value will use the currently configured default branch. However, changing the default branch later on won't change the linked branch here. A single branch ID can only have one linked merchant center account ID.", + "description": "The branch ID (e.g. 0/1/2) within this catalog that products from merchant_center_account_id are streamed to. When updating this field, an empty value will use the currently configured default branch. However, changing the default branch later on won't change the linked branch here. A single branch ID can only have one linked Merchant Center account ID.", "type": "string" }, "destinations": { @@ -4754,7 +4754,7 @@ "type": "string" }, "merchantCenterAccountId": { - "description": "Required. The linked [Merchant center account ID](https://developers.google.com/shopping-content/guides/accountstatuses). The account must be a standalone account or a sub-account of a MCA.", + "description": "Required. The linked [Merchant Center account ID](https://developers.google.com/shopping-content/guides/accountstatuses). The account must be a standalone account or a sub-account of a MCA.", "format": "int64", "type": "string" }, @@ -4914,11 +4914,11 @@ "type": "object" }, "GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig": { - "description": "More configs of the frequently-bought-together model type.", + "description": "Additional configs for the frequently-bought-together model type.", "id": "GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig", "properties": { "contextProductsType": { - "description": "Optional. Specifies the context of the model when used in predict requests. Only settable for the `frequently-bought-together` type. Will default to MULTI_CONTEXT if not specified.", + "description": "Optional. Specifies the context of the model when it is used in predict requests. Can only be set for the `frequently-bought-together` type. If it isn't specified, it defaults to MULTIPLE_CONTEXT_PRODUCTS.", "enum": [ "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED", "SINGLE_CONTEXT_PRODUCT", diff --git a/retail/v2beta/retail-gen.go b/retail/v2beta/retail-gen.go index a22893c2f9c..0028e39bb15 100644 --- a/retail/v2beta/retail-gen.go +++ b/retail/v2beta/retail-gen.go @@ -1038,13 +1038,13 @@ func (s *GoogleCloudRetailV2Model) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig: More -// configs of the frequently-bought-together model type. +// GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig: +// Additional configs for the frequently-bought-together model type. type GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig struct { // ContextProductsType: Optional. Specifies the context of the model - // when used in predict requests. Only settable for the - // `frequently-bought-together` type. Will default to MULTI_CONTEXT if - // not specified. + // when it is used in predict requests. Can only be set for the + // `frequently-bought-together` type. If it isn't specified, it defaults + // to MULTIPLE_CONTEXT_PRODUCTS. // // Possible values: // "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED" - Unspecified default value, @@ -1833,16 +1833,16 @@ func (s *GoogleCloudRetailV2alphaImportUserEventsResponse) MarshalJSON() ([]byte } // GoogleCloudRetailV2alphaMerchantCenterAccountLink: Represents a link -// between a Merchant Center account and a branch. Once a link is -// established, products from the linked merchant center account will be +// between a Merchant Center account and a branch. After a link is +// established, products from the linked Merchant Center account are // streamed to the linked branch. type GoogleCloudRetailV2alphaMerchantCenterAccountLink struct { - // BranchId: Required. The branch id (e.g. 0/1/2) within the catalog + // BranchId: Required. The branch ID (e.g. 0/1/2) within the catalog // that products from merchant_center_account_id are streamed to. When // updating this field, an empty value will use the currently configured // default branch. However, changing the default branch later on won't - // change the linked branch here. A single branch id can only have one - // linked merchant center account id. + // change the linked branch here. A single branch ID can only have one + // linked Merchant Center account ID. BranchId string `json:"branchId,omitempty"` // FeedFilters: Criteria for the Merchant Center feeds to be ingested @@ -2121,12 +2121,12 @@ func (s *GoogleCloudRetailV2alphaModel) MarshalJSON() ([]byte, error) { } // GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig: -// More configs of the frequently-bought-together model type. +// Additional configs for the frequently-bought-together model type. type GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig struct { // ContextProductsType: Optional. Specifies the context of the model - // when used in predict requests. Only settable for the - // `frequently-bought-together` type. Will default to MULTI_CONTEXT if - // not specified. + // when it is used in predict requests. Can only be set for the + // `frequently-bought-together` type. If it isn't specified, it defaults + // to MULTIPLE_CONTEXT_PRODUCTS. // // Possible values: // "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED" - Unspecified default value, @@ -3233,9 +3233,9 @@ type GoogleCloudRetailV2betaCatalog struct { DisplayName string `json:"displayName,omitempty"` // MerchantCenterLinkingConfig: The Merchant Center linking - // configuration. Once a link is added, the data stream from Merchant + // configuration. After a link is added, the data stream from Merchant // Center to Cloud Retail will be enabled automatically. The requester - // must have access to the merchant center account in order to make + // must have access to the Merchant Center account in order to make // changes to this field. MerchantCenterLinkingConfig *GoogleCloudRetailV2betaMerchantCenterLinkingConfig `json:"merchantCenterLinkingConfig,omitempty"` @@ -5152,16 +5152,16 @@ func (s *GoogleCloudRetailV2betaLocalInventory) MarshalJSON() ([]byte, error) { } // GoogleCloudRetailV2betaMerchantCenterAccountLink: Represents a link -// between a Merchant Center account and a branch. Once a link is -// established, products from the linked merchant center account will be +// between a Merchant Center account and a branch. After a link is +// established, products from the linked Merchant Center account are // streamed to the linked branch. type GoogleCloudRetailV2betaMerchantCenterAccountLink struct { - // BranchId: Required. The branch id (e.g. 0/1/2) within the catalog + // BranchId: Required. The branch ID (e.g. 0/1/2) within the catalog // that products from merchant_center_account_id are streamed to. When // updating this field, an empty value will use the currently configured // default branch. However, changing the default branch later on won't - // change the linked branch here. A single branch id can only have one - // linked merchant center account id. + // change the linked branch here. A single branch ID can only have one + // linked Merchant Center account ID. BranchId string `json:"branchId,omitempty"` // FeedFilters: Criteria for the Merchant Center feeds to be ingested @@ -5304,16 +5304,16 @@ func (s *GoogleCloudRetailV2betaMerchantCenterFeedFilter) MarshalJSON() ([]byte, } // GoogleCloudRetailV2betaMerchantCenterLink: Represents a link between -// a Merchant Center account and a branch. Once a link is established, -// products from the linked merchant center account will be streamed to -// the linked branch. +// a Merchant Center account and a branch. After a link is established, +// products from the linked Merchant Center account are streamed to the +// linked branch. type GoogleCloudRetailV2betaMerchantCenterLink struct { // BranchId: The branch ID (e.g. 0/1/2) within this catalog that // products from merchant_center_account_id are streamed to. When // updating this field, an empty value will use the currently configured // default branch. However, changing the default branch later on won't // change the linked branch here. A single branch ID can only have one - // linked merchant center account ID. + // linked Merchant Center account ID. BranchId string `json:"branchId,omitempty"` // Destinations: String representing the destination to import for, all @@ -5338,7 +5338,7 @@ type GoogleCloudRetailV2betaMerchantCenterLink struct { // value: `en`. LanguageCode string `json:"languageCode,omitempty"` - // MerchantCenterAccountId: Required. The linked Merchant center account + // MerchantCenterAccountId: Required. The linked Merchant Center account // ID // (https://developers.google.com/shopping-content/guides/accountstatuses). // The account must be a standalone account or a sub-account of a MCA. @@ -5575,12 +5575,12 @@ func (s *GoogleCloudRetailV2betaModel) MarshalJSON() ([]byte, error) { } // GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig: -// More configs of the frequently-bought-together model type. +// Additional configs for the frequently-bought-together model type. type GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig struct { // ContextProductsType: Optional. Specifies the context of the model - // when used in predict requests. Only settable for the - // `frequently-bought-together` type. Will default to MULTI_CONTEXT if - // not specified. + // when it is used in predict requests. Can only be set for the + // `frequently-bought-together` type. If it isn't specified, it defaults + // to MULTIPLE_CONTEXT_PRODUCTS. // // Possible values: // "CONTEXT_PRODUCTS_TYPE_UNSPECIFIED" - Unspecified default value, diff --git a/run/v1/run-api.json b/run/v1/run-api.json index b9ecdcaa2ba..3fbe19c72e1 100644 --- a/run/v1/run-api.json +++ b/run/v1/run-api.json @@ -2289,7 +2289,7 @@ } } }, - "revision": "20230416", + "revision": "20230430", "rootUrl": "https://run.googleapis.com/", "schemas": { "Addressable": { @@ -2755,6 +2755,21 @@ }, "type": "object" }, + "EmptyDirVolumeSource": { + "description": "Ephemeral storage which can be backed by real disks (HD, SSD), network storage or memory (i.e. tmpfs). For now only in memory (tmpfs) is supported. It is ephemeral in the sense that when the sandbox is taken down, the data is destroyed with it (it does not persist across sandbox runs).", + "id": "EmptyDirVolumeSource", + "properties": { + "medium": { + "description": "The medium on which the data is stored. The default is \"\" which means to use the node's default medium. Must be an empty string (default) or Memory. More info: https://kubernetes.io/docs/concepts/storage/volumes#emptydir +optional", + "type": "string" + }, + "sizeLimit": { + "description": "Limit on the storage usable by this EmptyDir volume. The size limit is also applicable for memory medium. The maximum usage on memory medium EmptyDir would be the minimum value between the SizeLimit specified here and the sum of memory limits of all containers in a pod. This field's values are of the 'Quantity' k8s type: https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/quantity/. The default is nil which means that the limit is undefined. More info: http://kubernetes.io/docs/user-guide/volumes#emptydir +optional", + "type": "string" + } + }, + "type": "object" + }, "EnvFromSource": { "description": "Not supported by Cloud Run. EnvFromSource represents the source of a set of ConfigMaps", "id": "EnvFromSource", @@ -3527,7 +3542,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -4525,6 +4540,10 @@ "$ref": "ConfigMapVolumeSource", "description": "Not supported in Cloud Run." }, + "emptyDir": { + "$ref": "EmptyDirVolumeSource", + "description": "Ephemeral storage used as a shared volume." + }, "name": { "description": "Volume's name. In Cloud Run Fully Managed, the name 'cloudsql' is reserved.", "type": "string" diff --git a/run/v1/run-gen.go b/run/v1/run-gen.go index a6046a4381b..cb1e16385dc 100644 --- a/run/v1/run-gen.go +++ b/run/v1/run-gen.go @@ -1218,6 +1218,53 @@ func (s *DomainMappingStatus) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// EmptyDirVolumeSource: Ephemeral storage which can be backed by real +// disks (HD, SSD), network storage or memory (i.e. tmpfs). For now only +// in memory (tmpfs) is supported. It is ephemeral in the sense that +// when the sandbox is taken down, the data is destroyed with it (it +// does not persist across sandbox runs). +type EmptyDirVolumeSource struct { + // Medium: The medium on which the data is stored. The default is "" + // which means to use the node's default medium. Must be an empty string + // (default) or Memory. More info: + // https://kubernetes.io/docs/concepts/storage/volumes#emptydir + // +optional + Medium string `json:"medium,omitempty"` + + // SizeLimit: Limit on the storage usable by this EmptyDir volume. The + // size limit is also applicable for memory medium. The maximum usage on + // memory medium EmptyDir would be the minimum value between the + // SizeLimit specified here and the sum of memory limits of all + // containers in a pod. This field's values are of the 'Quantity' k8s + // type: + // https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/quantity/. + // The default is nil which means that the limit is undefined. More + // info: http://kubernetes.io/docs/user-guide/volumes#emptydir +optional + SizeLimit string `json:"sizeLimit,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Medium") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Medium") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *EmptyDirVolumeSource) MarshalJSON() ([]byte, error) { + type NoMethod EmptyDirVolumeSource + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // EnvFromSource: Not supported by Cloud Run. EnvFromSource represents // the source of a set of ConfigMaps type EnvFromSource struct { @@ -2564,7 +2611,7 @@ func (s *LocalObjectReference) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -4405,6 +4452,9 @@ type Volume struct { // ConfigMap: Not supported in Cloud Run. ConfigMap *ConfigMapVolumeSource `json:"configMap,omitempty"` + // EmptyDir: Ephemeral storage used as a shared volume. + EmptyDir *EmptyDirVolumeSource `json:"emptyDir,omitempty"` + // Name: Volume's name. In Cloud Run Fully Managed, the name 'cloudsql' // is reserved. Name string `json:"name,omitempty"` diff --git a/run/v2/run-api.json b/run/v2/run-api.json index 262f18650ba..2501308c87f 100644 --- a/run/v2/run-api.json +++ b/run/v2/run-api.json @@ -889,7 +889,7 @@ ], "parameters": { "allowMissing": { - "description": "This field is currently not used by Cloud Run; setting it does not have any effect.", + "description": "If set to true, and if the Service does not exist, it will create a new one. The caller must have 'run.services.create' permissions if this is set to true and the Service does not exist.", "location": "query", "type": "boolean" }, @@ -1087,7 +1087,7 @@ } } }, - "revision": "20230416", + "revision": "20230430", "rootUrl": "https://run.googleapis.com/", "schemas": { "GoogleCloudRunV2BinaryAuthorization": { @@ -1281,6 +1281,13 @@ }, "type": "array" }, + "dependsOn": { + "description": "Container names which must start before this container.", + "items": { + "type": "string" + }, + "type": "array" + }, "env": { "description": "List of environment variables to set in the container.", "items": { @@ -1345,6 +1352,29 @@ }, "type": "object" }, + "GoogleCloudRunV2EmptyDirVolumeSource": { + "description": "Ephemeral storage which can be backed by real disks (HD, SSD), network storage or memory (i.e. tmpfs). For now only in memory (tmpfs) is supported. It is ephemeral in the sense that when the sandbox is taken down, the data is destroyed with it (it does not persist across sandbox runs).", + "id": "GoogleCloudRunV2EmptyDirVolumeSource", + "properties": { + "medium": { + "description": "The medium on which the data is stored. Acceptable values today is only MEMORY or none. When none, the default will currently be backed by memory but could change over time. +optional", + "enum": [ + "MEDIUM_UNSPECIFIED", + "MEMORY" + ], + "enumDescriptions": [ + "When not specified, falls back to the default implementation which is currently in memory (this may change over time).", + "Explicitly set the EmptyDir to be in memory. Uses tmpfs." + ], + "type": "string" + }, + "sizeLimit": { + "description": "Limit on the storage usable by this EmptyDir volume. The size limit is also applicable for memory medium. The maximum usage on memory medium EmptyDir would be the minimum value between the SizeLimit specified here and the sum of memory limits of all containers in a pod. This field's values are of the 'Quantity' k8s type: https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/quantity/. The default is nil which means that the limit is undefined. More info: http://kubernetes.io/docs/user-guide/volumes#emptydir +optional", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudRunV2EnvVar": { "description": "EnvVar represents an environment variable present in a Container.", "id": "GoogleCloudRunV2EnvVar", @@ -1383,7 +1413,8 @@ "additionalProperties": { "type": "string" }, - "description": "KRM-style annotations for the resource.", + "description": "Output only. Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects.", + "readOnly": true, "type": "object" }, "cancelledCount": { @@ -1450,7 +1481,8 @@ "additionalProperties": { "type": "string" }, - "description": "KRM-style labels for the resource. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels", + "description": "Output only. Unstructured key value map that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels", + "readOnly": true, "type": "object" }, "launchStage": { @@ -1587,14 +1619,14 @@ "additionalProperties": { "type": "string" }, - "description": "KRM-style annotations for the resource. Cloud Run API v2 does not support annotations with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected. All system annotations in v1 now have a corresponding field in v2 ExecutionTemplate.", + "description": "Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects. Cloud Run API v2 does not support annotations with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected. All system annotations in v1 now have a corresponding field in v2 ExecutionTemplate. This field follows Kubernetes annotations' namespacing, limits, and rules.", "type": "object" }, "labels": { "additionalProperties": { "type": "string" }, - "description": "KRM-style labels for the resource. Cloud Run API v2 does not support labels with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected. All system labels in v1 now have a corresponding field in v2 ExecutionTemplate.", + "description": "Unstructured key value map that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels. Cloud Run API v2 does not support labels with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected. All system labels in v1 now have a corresponding field in v2 ExecutionTemplate.", "type": "object" }, "parallelism": { @@ -1676,7 +1708,7 @@ "additionalProperties": { "type": "string" }, - "description": "KRM-style annotations for the resource. Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects. Cloud Run API v2 does not support annotations with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected on new resources. All system annotations in v1 now have a corresponding field in v2 Job. This field follows Kubernetes annotations' namespacing, limits, and rules.", + "description": "Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects. Cloud Run API v2 does not support annotations with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected on new resources. All system annotations in v1 now have a corresponding field in v2 Job. This field follows Kubernetes annotations' namespacing, limits, and rules.", "type": "object" }, "binaryAuthorization": { @@ -1743,7 +1775,7 @@ "additionalProperties": { "type": "string" }, - "description": "KRM-style labels for the resource. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels Cloud Run API v2 does not support labels with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected. All system labels in v1 now have a corresponding field in v2 Job.", + "description": "Unstructured key value map that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels. Cloud Run API v2 does not support labels with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected. All system labels in v1 now have a corresponding field in v2 Job.", "type": "object" }, "lastModifier": { @@ -1982,7 +2014,8 @@ "additionalProperties": { "type": "string" }, - "description": "KRM-style annotations for the resource.", + "description": "Output only. Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects.", + "readOnly": true, "type": "object" }, "conditions": { @@ -2070,7 +2103,8 @@ "additionalProperties": { "type": "string" }, - "description": "KRM-style labels for the resource. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels", + "description": "Output only. Unstructured key value map that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels.", + "readOnly": true, "type": "object" }, "launchStage": { @@ -2141,6 +2175,10 @@ "description": "Email address of the IAM service account associated with the revision of the service. The service account represents the identity of the running revision, and determines what permissions the revision has.", "type": "string" }, + "sessionAffinity": { + "description": "Enable session affinity.", + "type": "boolean" + }, "timeout": { "description": "Max allowed time for an instance to respond to a request.", "format": "google-duration", @@ -2196,7 +2234,7 @@ "additionalProperties": { "type": "string" }, - "description": "KRM-style annotations for the resource. Cloud Run API v2 does not support annotations with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected. All system annotations in v1 now have a corresponding field in v2 RevisionTemplate.", + "description": "Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects. Cloud Run API v2 does not support annotations with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected. All system annotations in v1 now have a corresponding field in v2 RevisionTemplate. This field follows Kubernetes annotations' namespacing, limits, and rules.", "type": "object" }, "containers": { @@ -2228,7 +2266,7 @@ "additionalProperties": { "type": "string" }, - "description": "KRM-style labels for the resource. Cloud Run API v2 does not support labels with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected. All system labels in v1 now have a corresponding field in v2 RevisionTemplate.", + "description": "Unstructured key value map that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels. Cloud Run API v2 does not support labels with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected. All system labels in v1 now have a corresponding field in v2 RevisionTemplate.", "type": "object" }, "maxInstanceRequestConcurrency": { @@ -2248,6 +2286,10 @@ "description": "Email address of the IAM service account associated with the revision of the service. The service account represents the identity of the running revision, and determines what permissions the revision has. If not provided, the revision will use the project's default service account.", "type": "string" }, + "sessionAffinity": { + "description": "Enable session affinity.", + "type": "boolean" + }, "timeout": { "description": "Max allowed time for an instance to respond to a request.", "format": "google-duration", @@ -2409,7 +2451,7 @@ "additionalProperties": { "type": "string" }, - "description": "Map of string keys and values that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels Cloud Run API v2 does not support labels with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected. All system labels in v1 now have a corresponding field in v2 Service.", + "description": "Unstructured key value map that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels. Cloud Run API v2 does not support labels with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected. All system labels in v1 now have a corresponding field in v2 Service.", "type": "object" }, "lastModifier": { @@ -2534,7 +2576,8 @@ "additionalProperties": { "type": "string" }, - "description": "KRM-style annotations for the resource.", + "description": "Output only. Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects.", + "readOnly": true, "type": "object" }, "completionTime": { @@ -2626,7 +2669,8 @@ "additionalProperties": { "type": "string" }, - "description": "KRM-style labels for the resource. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels", + "description": "Output only. Unstructured key value map that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels", + "readOnly": true, "type": "object" }, "lastAttemptResult": { @@ -2887,6 +2931,10 @@ "$ref": "GoogleCloudRunV2CloudSqlInstance", "description": "For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run." }, + "emptyDir": { + "$ref": "GoogleCloudRunV2EmptyDirVolumeSource", + "description": "Ephemeral storage used as a shared volume." + }, "name": { "description": "Required. Volume's name.", "type": "string" diff --git a/run/v2/run-gen.go b/run/v2/run-gen.go index 1464b2f7438..1e0eb2e7b97 100644 --- a/run/v2/run-gen.go +++ b/run/v2/run-gen.go @@ -454,6 +454,9 @@ type GoogleCloudRunV2Container struct { // image's ENTRYPOINT is used if this is not provided. Command []string `json:"command,omitempty"` + // DependsOn: Container names which must start before this container. + DependsOn []string `json:"dependsOn,omitempty"` + // Env: List of environment variables to set in the container. Env []*GoogleCloudRunV2EnvVar `json:"env,omitempty"` @@ -550,6 +553,57 @@ func (s *GoogleCloudRunV2ContainerPort) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudRunV2EmptyDirVolumeSource: Ephemeral storage which can be +// backed by real disks (HD, SSD), network storage or memory (i.e. +// tmpfs). For now only in memory (tmpfs) is supported. It is ephemeral +// in the sense that when the sandbox is taken down, the data is +// destroyed with it (it does not persist across sandbox runs). +type GoogleCloudRunV2EmptyDirVolumeSource struct { + // Medium: The medium on which the data is stored. Acceptable values + // today is only MEMORY or none. When none, the default will currently + // be backed by memory but could change over time. +optional + // + // Possible values: + // "MEDIUM_UNSPECIFIED" - When not specified, falls back to the + // default implementation which is currently in memory (this may change + // over time). + // "MEMORY" - Explicitly set the EmptyDir to be in memory. Uses tmpfs. + Medium string `json:"medium,omitempty"` + + // SizeLimit: Limit on the storage usable by this EmptyDir volume. The + // size limit is also applicable for memory medium. The maximum usage on + // memory medium EmptyDir would be the minimum value between the + // SizeLimit specified here and the sum of memory limits of all + // containers in a pod. This field's values are of the 'Quantity' k8s + // type: + // https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/quantity/. + // The default is nil which means that the limit is undefined. More + // info: http://kubernetes.io/docs/user-guide/volumes#emptydir +optional + SizeLimit string `json:"sizeLimit,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Medium") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Medium") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudRunV2EmptyDirVolumeSource) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRunV2EmptyDirVolumeSource + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudRunV2EnvVar: EnvVar represents an environment variable // present in a Container. type GoogleCloudRunV2EnvVar struct { @@ -626,7 +680,9 @@ func (s *GoogleCloudRunV2EnvVarSource) MarshalJSON() ([]byte, error) { // a single execution. A execution an immutable resource that references // a container image which is run to completion. type GoogleCloudRunV2Execution struct { - // Annotations: KRM-style annotations for the resource. + // Annotations: Output only. Unstructured key value map that may be set + // by external tools to store and arbitrary metadata. They are not + // queryable and should be preserved when modifying objects. Annotations map[string]string `json:"annotations,omitempty"` // CancelledCount: Output only. The number of tasks which reached phase @@ -673,10 +729,11 @@ type GoogleCloudRunV2Execution struct { // Job: Output only. The name of the parent Job. Job string `json:"job,omitempty"` - // Labels: KRM-style labels for the resource. User-provided labels are - // shared with Google's billing system, so they can be used to filter, - // or break down billing charges by team, component, environment, state, - // etc. For more information, visit + // Labels: Output only. Unstructured key value map that can be used to + // organize and categorize objects. User-provided labels are shared with + // Google's billing system, so they can be used to filter, or break down + // billing charges by team, component, environment, state, etc. For more + // information, visit // https://cloud.google.com/resource-manager/docs/creating-managing-labels // or https://cloud.google.com/run/docs/configuring/labels Labels map[string]string `json:"labels,omitempty"` @@ -854,19 +911,29 @@ func (s *GoogleCloudRunV2ExecutionReference) MarshalJSON() ([]byte, error) { // GoogleCloudRunV2ExecutionTemplate: ExecutionTemplate describes the // data an execution should have when created from a template. type GoogleCloudRunV2ExecutionTemplate struct { - // Annotations: KRM-style annotations for the resource. Cloud Run API v2 - // does not support annotations with `run.googleapis.com`, + // Annotations: Unstructured key value map that may be set by external + // tools to store and arbitrary metadata. They are not queryable and + // should be preserved when modifying objects. Cloud Run API v2 does not + // support annotations with `run.googleapis.com`, // `cloud.googleapis.com`, `serving.knative.dev`, or // `autoscaling.knative.dev` namespaces, and they will be rejected. All // system annotations in v1 now have a corresponding field in v2 - // ExecutionTemplate. + // ExecutionTemplate. This field follows Kubernetes annotations' + // namespacing, limits, and rules. Annotations map[string]string `json:"annotations,omitempty"` - // Labels: KRM-style labels for the resource. Cloud Run API v2 does not - // support labels with `run.googleapis.com`, `cloud.googleapis.com`, - // `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and - // they will be rejected. All system labels in v1 now have a - // corresponding field in v2 ExecutionTemplate. + // Labels: Unstructured key value map that can be used to organize and + // categorize objects. User-provided labels are shared with Google's + // billing system, so they can be used to filter, or break down billing + // charges by team, component, environment, state, etc. For more + // information, visit + // https://cloud.google.com/resource-manager/docs/creating-managing-labels + // or https://cloud.google.com/run/docs/configuring/labels. Cloud Run + // API v2 does not support labels with `run.googleapis.com`, + // `cloud.googleapis.com`, `serving.knative.dev`, or + // `autoscaling.knative.dev` namespaces, and they will be rejected. All + // system labels in v1 now have a corresponding field in v2 + // ExecutionTemplate. Labels map[string]string `json:"labels,omitempty"` // Parallelism: Specifies the maximum desired number of tasks the @@ -1021,12 +1088,12 @@ func (s *GoogleCloudRunV2HTTPHeader) MarshalJSON() ([]byte, error) { // GoogleCloudRunV2Job: Job represents the configuration of a single // job, which references a container image that is run to completion. type GoogleCloudRunV2Job struct { - // Annotations: KRM-style annotations for the resource. Unstructured key - // value map that may be set by external tools to store and arbitrary - // metadata. They are not queryable and should be preserved when - // modifying objects. Cloud Run API v2 does not support annotations with - // `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, - // or `autoscaling.knative.dev` namespaces, and they will be rejected on + // Annotations: Unstructured key value map that may be set by external + // tools to store and arbitrary metadata. They are not queryable and + // should be preserved when modifying objects. Cloud Run API v2 does not + // support annotations with `run.googleapis.com`, + // `cloud.googleapis.com`, `serving.knative.dev`, or + // `autoscaling.knative.dev` namespaces, and they will be rejected on // new resources. All system annotations in v1 now have a corresponding // field in v2 Job. This field follows Kubernetes annotations' // namespacing, limits, and rules. @@ -1074,13 +1141,14 @@ type GoogleCloudRunV2Job struct { // time the user modifies the desired state. Generation int64 `json:"generation,omitempty,string"` - // Labels: KRM-style labels for the resource. User-provided labels are - // shared with Google's billing system, so they can be used to filter, - // or break down billing charges by team, component, environment, state, - // etc. For more information, visit + // Labels: Unstructured key value map that can be used to organize and + // categorize objects. User-provided labels are shared with Google's + // billing system, so they can be used to filter, or break down billing + // charges by team, component, environment, state, etc. For more + // information, visit // https://cloud.google.com/resource-manager/docs/creating-managing-labels - // or https://cloud.google.com/run/docs/configuring/labels Cloud Run API - // v2 does not support labels with `run.googleapis.com`, + // or https://cloud.google.com/run/docs/configuring/labels. Cloud Run + // API v2 does not support labels with `run.googleapis.com`, // `cloud.googleapis.com`, `serving.knative.dev`, or // `autoscaling.knative.dev` namespaces, and they will be rejected. All // system labels in v1 now have a corresponding field in v2 Job. @@ -1509,7 +1577,9 @@ func (s *GoogleCloudRunV2ResourceRequirements) MarshalJSON() ([]byte, error) { // and configuration. A Revision references a container image. Revisions // are only created by updates to its parent Service. type GoogleCloudRunV2Revision struct { - // Annotations: KRM-style annotations for the resource. + // Annotations: Output only. Unstructured key value map that may be set + // by external tools to store and arbitrary metadata. They are not + // queryable and should be preserved when modifying objects. Annotations map[string]string `json:"annotations,omitempty"` // Conditions: Output only. The Condition of this Revision, containing @@ -1572,12 +1642,13 @@ type GoogleCloudRunV2Revision struct { // time the user modifies the desired state. Generation int64 `json:"generation,omitempty,string"` - // Labels: KRM-style labels for the resource. User-provided labels are - // shared with Google's billing system, so they can be used to filter, - // or break down billing charges by team, component, environment, state, - // etc. For more information, visit + // Labels: Output only. Unstructured key value map that can be used to + // organize and categorize objects. User-provided labels are shared with + // Google's billing system, so they can be used to filter, or break down + // billing charges by team, component, environment, state, etc. For more + // information, visit // https://cloud.google.com/resource-manager/docs/creating-managing-labels - // or https://cloud.google.com/run/docs/configuring/labels + // or https://cloud.google.com/run/docs/configuring/labels. Labels map[string]string `json:"labels,omitempty"` // LaunchStage: The least stable launch stage needed to create this @@ -1660,6 +1731,9 @@ type GoogleCloudRunV2Revision struct { // revision has. ServiceAccount string `json:"serviceAccount,omitempty"` + // SessionAffinity: Enable session affinity. + SessionAffinity bool `json:"sessionAffinity,omitempty"` + // Timeout: Max allowed time for an instance to respond to a request. Timeout string `json:"timeout,omitempty"` @@ -1744,12 +1818,15 @@ func (s *GoogleCloudRunV2RevisionScaling) MarshalJSON() ([]byte, error) { // GoogleCloudRunV2RevisionTemplate: RevisionTemplate describes the data // a revision should have when created from a template. type GoogleCloudRunV2RevisionTemplate struct { - // Annotations: KRM-style annotations for the resource. Cloud Run API v2 - // does not support annotations with `run.googleapis.com`, + // Annotations: Unstructured key value map that may be set by external + // tools to store and arbitrary metadata. They are not queryable and + // should be preserved when modifying objects. Cloud Run API v2 does not + // support annotations with `run.googleapis.com`, // `cloud.googleapis.com`, `serving.knative.dev`, or // `autoscaling.knative.dev` namespaces, and they will be rejected. All // system annotations in v1 now have a corresponding field in v2 - // RevisionTemplate. + // RevisionTemplate. This field follows Kubernetes annotations' + // namespacing, limits, and rules. Annotations map[string]string `json:"annotations,omitempty"` // Containers: Holds the single container that defines the unit of @@ -1770,11 +1847,18 @@ type GoogleCloudRunV2RevisionTemplate struct { // "EXECUTION_ENVIRONMENT_GEN2" - Uses Second Generation environment. ExecutionEnvironment string `json:"executionEnvironment,omitempty"` - // Labels: KRM-style labels for the resource. Cloud Run API v2 does not - // support labels with `run.googleapis.com`, `cloud.googleapis.com`, - // `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and - // they will be rejected. All system labels in v1 now have a - // corresponding field in v2 RevisionTemplate. + // Labels: Unstructured key value map that can be used to organize and + // categorize objects. User-provided labels are shared with Google's + // billing system, so they can be used to filter, or break down billing + // charges by team, component, environment, state, etc. For more + // information, visit + // https://cloud.google.com/resource-manager/docs/creating-managing-labels + // or https://cloud.google.com/run/docs/configuring/labels. Cloud Run + // API v2 does not support labels with `run.googleapis.com`, + // `cloud.googleapis.com`, `serving.knative.dev`, or + // `autoscaling.knative.dev` namespaces, and they will be rejected. All + // system labels in v1 now have a corresponding field in v2 + // RevisionTemplate. Labels map[string]string `json:"labels,omitempty"` // MaxInstanceRequestConcurrency: Sets the maximum number of requests @@ -1795,6 +1879,9 @@ type GoogleCloudRunV2RevisionTemplate struct { // default service account. ServiceAccount string `json:"serviceAccount,omitempty"` + // SessionAffinity: Enable session affinity. + SessionAffinity bool `json:"sessionAffinity,omitempty"` + // Timeout: Max allowed time for an instance to respond to a request. Timeout string `json:"timeout,omitempty"` @@ -2030,14 +2117,14 @@ type GoogleCloudRunV2Service struct { // Cloud Load Balancer traffic is allowed. Ingress string `json:"ingress,omitempty"` - // Labels: Map of string keys and values that can be used to organize - // and categorize objects. User-provided labels are shared with Google's + // Labels: Unstructured key value map that can be used to organize and + // categorize objects. User-provided labels are shared with Google's // billing system, so they can be used to filter, or break down billing // charges by team, component, environment, state, etc. For more // information, visit // https://cloud.google.com/resource-manager/docs/creating-managing-labels - // or https://cloud.google.com/run/docs/configuring/labels Cloud Run API - // v2 does not support labels with `run.googleapis.com`, + // or https://cloud.google.com/run/docs/configuring/labels. Cloud Run + // API v2 does not support labels with `run.googleapis.com`, // `cloud.googleapis.com`, `serving.knative.dev`, or // `autoscaling.knative.dev` namespaces, and they will be rejected. All // system labels in v1 now have a corresponding field in v2 Service. @@ -2232,7 +2319,9 @@ func (s *GoogleCloudRunV2TCPSocketAction) MarshalJSON() ([]byte, error) { // GoogleCloudRunV2Task: Task represents a single run of a container to // completion. type GoogleCloudRunV2Task struct { - // Annotations: KRM-style annotations for the resource. + // Annotations: Output only. Unstructured key value map that may be set + // by external tools to store and arbitrary metadata. They are not + // queryable and should be preserved when modifying objects. Annotations map[string]string `json:"annotations,omitempty"` // CompletionTime: Output only. Represents time when the Task was @@ -2298,10 +2387,11 @@ type GoogleCloudRunV2Task struct { // Job: Output only. The name of the parent Job. Job string `json:"job,omitempty"` - // Labels: KRM-style labels for the resource. User-provided labels are - // shared with Google's billing system, so they can be used to filter, - // or break down billing charges by team, component, environment, state, - // etc. For more information, visit + // Labels: Output only. Unstructured key value map that can be used to + // organize and categorize objects. User-provided labels are shared with + // Google's billing system, so they can be used to filter, or break down + // billing charges by team, component, environment, state, etc. For more + // information, visit // https://cloud.google.com/resource-manager/docs/creating-managing-labels // or https://cloud.google.com/run/docs/configuring/labels Labels map[string]string `json:"labels,omitempty"` @@ -2661,6 +2751,9 @@ type GoogleCloudRunV2Volume struct { // information on how to connect Cloud SQL and Cloud Run. CloudSqlInstance *GoogleCloudRunV2CloudSqlInstance `json:"cloudSqlInstance,omitempty"` + // EmptyDir: Ephemeral storage used as a shared volume. + EmptyDir *GoogleCloudRunV2EmptyDirVolumeSource `json:"emptyDir,omitempty"` + // Name: Required. Volume's name. Name string `json:"name,omitempty"` @@ -7290,9 +7383,10 @@ func (r *ProjectsLocationsServicesService) Patch(name string, googlecloudrunv2se return c } -// AllowMissing sets the optional parameter "allowMissing": This field -// is currently not used by Cloud Run; setting it does not have any -// effect. +// AllowMissing sets the optional parameter "allowMissing": If set to +// true, and if the Service does not exist, it will create a new one. +// The caller must have 'run.services.create' permissions if this is set +// to true and the Service does not exist. func (c *ProjectsLocationsServicesPatchCall) AllowMissing(allowMissing bool) *ProjectsLocationsServicesPatchCall { c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) return c @@ -7406,7 +7500,7 @@ func (c *ProjectsLocationsServicesPatchCall) Do(opts ...googleapi.CallOption) (* // ], // "parameters": { // "allowMissing": { - // "description": "This field is currently not used by Cloud Run; setting it does not have any effect.", + // "description": "If set to true, and if the Service does not exist, it will create a new one. The caller must have 'run.services.create' permissions if this is set to true and the Service does not exist.", // "location": "query", // "type": "boolean" // }, diff --git a/searchads360/v0/searchads360-api.json b/searchads360/v0/searchads360-api.json index e03c32afa18..c05106c26f7 100644 --- a/searchads360/v0/searchads360-api.json +++ b/searchads360/v0/searchads360-api.json @@ -190,34 +190,6 @@ "scopes": [ "https://www.googleapis.com/auth/doubleclicksearch" ] - }, - "searchStream": { - "description": "Returns all rows that match the search stream query. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QueryError]() [QuotaError]() [RequestError]()", - "flatPath": "v0/customers/{customersId}/searchAds360:searchStream", - "httpMethod": "POST", - "id": "searchads360.customers.searchAds360.searchStream", - "parameterOrder": [ - "customerId" - ], - "parameters": { - "customerId": { - "description": "Required. The ID of the customer being queried.", - "location": "path", - "pattern": "^[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v0/customers/{+customerId}/searchAds360:searchStream", - "request": { - "$ref": "GoogleAdsSearchads360V0Services__SearchSearchAds360StreamRequest" - }, - "response": { - "$ref": "GoogleAdsSearchads360V0Services__SearchSearchAds360StreamResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/doubleclicksearch" - ] } } } @@ -271,7 +243,7 @@ } } }, - "revision": "20230405", + "revision": "20230504", "rootUrl": "https://searchads360.googleapis.com/", "schemas": { "GoogleAdsSearchads360V0Common__AgeRangeInfo": { @@ -388,6 +360,21 @@ }, "type": "object" }, + "GoogleAdsSearchads360V0Common__Keyword": { + "description": "A Keyword criterion segment.", + "id": "GoogleAdsSearchads360V0Common__Keyword", + "properties": { + "adGroupCriterion": { + "description": "The AdGroupCriterion resource name.", + "type": "string" + }, + "info": { + "$ref": "GoogleAdsSearchads360V0Common__KeywordInfo", + "description": "Keyword info." + } + }, + "type": "object" + }, "GoogleAdsSearchads360V0Common__KeywordInfo": { "description": "A keyword criterion.", "id": "GoogleAdsSearchads360V0Common__KeywordInfo", @@ -999,6 +986,124 @@ }, "type": "object" }, + "GoogleAdsSearchads360V0Common__SearchAds360ExpandedDynamicSearchAdInfo": { + "description": "An expanded dynamic search ad.", + "id": "GoogleAdsSearchads360V0Common__SearchAds360ExpandedDynamicSearchAdInfo", + "properties": { + "adTrackingId": { + "description": "The tracking id of the ad.", + "format": "int64", + "type": "string" + }, + "description1": { + "description": "The first line of the ad's description.", + "type": "string" + }, + "description2": { + "description": "The second line of the ad's description.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleAdsSearchads360V0Common__SearchAds360ExpandedTextAdInfo": { + "description": "A Search Ads 360 expanded text ad.", + "id": "GoogleAdsSearchads360V0Common__SearchAds360ExpandedTextAdInfo", + "properties": { + "adTrackingId": { + "description": "The tracking id of the ad.", + "format": "int64", + "type": "string" + }, + "description1": { + "description": "The first line of the ad's description.", + "type": "string" + }, + "description2": { + "description": "The second line of the ad's description.", + "type": "string" + }, + "headline": { + "description": "The headline of the ad.", + "type": "string" + }, + "headline2": { + "description": "The second headline of the ad.", + "type": "string" + }, + "headline3": { + "description": "The third headline of the ad.", + "type": "string" + }, + "path1": { + "description": "Text appended to the auto-generated visible URL with a delimiter.", + "type": "string" + }, + "path2": { + "description": "Text appended to path1 with a delimiter.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleAdsSearchads360V0Common__SearchAds360ProductAdInfo": { + "description": "A Search Ads 360 product ad.", + "id": "GoogleAdsSearchads360V0Common__SearchAds360ProductAdInfo", + "properties": {}, + "type": "object" + }, + "GoogleAdsSearchads360V0Common__SearchAds360ResponsiveSearchAdInfo": { + "description": "A Search Ads 360 responsive search ad.", + "id": "GoogleAdsSearchads360V0Common__SearchAds360ResponsiveSearchAdInfo", + "properties": { + "adTrackingId": { + "description": "The tracking id of the ad.", + "format": "int64", + "type": "string" + }, + "path1": { + "description": "Text appended to the auto-generated visible URL with a delimiter.", + "type": "string" + }, + "path2": { + "description": "Text appended to path1 with a delimiter.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleAdsSearchads360V0Common__SearchAds360TextAdInfo": { + "description": "A Search Ads 360 text ad.", + "id": "GoogleAdsSearchads360V0Common__SearchAds360TextAdInfo", + "properties": { + "adTrackingId": { + "description": "The tracking id of the ad.", + "format": "int64", + "type": "string" + }, + "description1": { + "description": "The first line of the ad's description.", + "type": "string" + }, + "description2": { + "description": "The second line of the ad's description.", + "type": "string" + }, + "displayMobileUrl": { + "description": "The displayed mobile URL of the ad.", + "type": "string" + }, + "displayUrl": { + "description": "The displayed URL of the ad.", + "type": "string" + }, + "headline": { + "description": "The headline of the ad.", + "type": "string" + } + }, + "type": "object" + }, "GoogleAdsSearchads360V0Common__Segments": { "description": "Segment only fields.", "id": "GoogleAdsSearchads360V0Common__Segments", @@ -1119,6 +1224,10 @@ ], "type": "string" }, + "keyword": { + "$ref": "GoogleAdsSearchads360V0Common__Keyword", + "description": "Keyword criterion." + }, "month": { "description": "Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.", "type": "string" @@ -2255,6 +2364,14 @@ "description": "The URL that appears in the ad description for some ad formats.", "type": "string" }, + "expandedDynamicSearchAd": { + "$ref": "GoogleAdsSearchads360V0Common__SearchAds360ExpandedDynamicSearchAdInfo", + "description": "Immutable. Details pertaining to an expanded dynamic search ad." + }, + "expandedTextAd": { + "$ref": "GoogleAdsSearchads360V0Common__SearchAds360ExpandedTextAdInfo", + "description": "Immutable. Details pertaining to an expanded text ad." + }, "finalUrls": { "description": "The list of possible final URLs after all cross-domain redirects for the ad.", "items": { @@ -2272,10 +2389,22 @@ "description": "Immutable. The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd.", "type": "string" }, + "productAd": { + "$ref": "GoogleAdsSearchads360V0Common__SearchAds360ProductAdInfo", + "description": "Immutable. Details pertaining to a product ad." + }, "resourceName": { "description": "Immutable. The resource name of the ad. Ad resource names have the form: `customers/{customer_id}/ads/{ad_id}`", "type": "string" }, + "responsiveSearchAd": { + "$ref": "GoogleAdsSearchads360V0Common__SearchAds360ResponsiveSearchAdInfo", + "description": "Immutable. Details pertaining to a responsive search ad." + }, + "textAd": { + "$ref": "GoogleAdsSearchads360V0Common__SearchAds360TextAdInfo", + "description": "Immutable. Details pertaining to a text ad." + }, "type": { "description": "Output only. The type of ad.", "enum": [ @@ -2822,7 +2951,8 @@ }, "location": { "$ref": "GoogleAdsSearchads360V0Common__LocationInfo", - "description": "Immutable. Location." + "description": "Output only. Location.", + "readOnly": true }, "negative": { "description": "Immutable. Whether to target (`false`) or exclude (`true`) the criterion. This field is immutable. To switch a criterion from positive to negative, remove then re-add it.", @@ -3442,7 +3572,7 @@ "The asset is linked for use as a Promotion extension.", "The asset is linked for use as a Callout extension.", "The asset is linked for use as a Structured Snippet extension.", - "The asset is linked for use as a Sitelink extension.", + "The asset is linked for use as a Sitelink.", "The asset is linked for use as a Mobile App extension.", "The asset is linked for use as a Hotel Callout extension.", "The asset is linked for use as a Call extension.", @@ -5141,74 +5271,6 @@ } }, "type": "object" - }, - "GoogleAdsSearchads360V0Services__SearchSearchAds360StreamRequest": { - "description": "Request message for SearchAds360Service.SearchStream.", - "id": "GoogleAdsSearchads360V0Services__SearchSearchAds360StreamRequest", - "properties": { - "batchSize": { - "description": "The number of rows that are returned in each stream response batch. When too large batch is requested, the server may decide to further limit the number of returned rows.", - "format": "int32", - "type": "integer" - }, - "query": { - "description": "Required. The query string.", - "type": "string" - }, - "summaryRowSetting": { - "description": "Determines whether a summary row will be returned. By default, summary row is not returned. If requested, the summary row will be sent in a response by itself after all other query results are returned.", - "enum": [ - "UNSPECIFIED", - "UNKNOWN", - "NO_SUMMARY_ROW", - "SUMMARY_ROW_WITH_RESULTS", - "SUMMARY_ROW_ONLY" - ], - "enumDescriptions": [ - "Not specified.", - "Represent unknown values of return summary row.", - "Do not return summary row.", - "Return summary row along with results. The summary row will be returned in the last batch alone (last batch will contain no results).", - "Return summary row only and return no results." - ], - "type": "string" - } - }, - "type": "object" - }, - "GoogleAdsSearchads360V0Services__SearchSearchAds360StreamResponse": { - "description": "Response message for SearchAds360Service.SearchStream.", - "id": "GoogleAdsSearchads360V0Services__SearchSearchAds360StreamResponse", - "properties": { - "customColumnHeaders": { - "description": "The headers of the custom columns in the results.", - "items": { - "$ref": "GoogleAdsSearchads360V0Services__CustomColumnHeader" - }, - "type": "array" - }, - "fieldMask": { - "description": "FieldMask that represents what fields were requested by the user.", - "format": "google-fieldmask", - "type": "string" - }, - "requestId": { - "description": "The unique id of the request that is used for debugging purposes.", - "type": "string" - }, - "results": { - "description": "The list of rows that matched the query.", - "items": { - "$ref": "GoogleAdsSearchads360V0Services__SearchAds360Row" - }, - "type": "array" - }, - "summaryRow": { - "$ref": "GoogleAdsSearchads360V0Services__SearchAds360Row", - "description": "Summary row that contains summary of metrics in results. Summary of metrics means aggregation of metrics across all results, here aggregation could be sum, average, rate, etc." - } - }, - "type": "object" } }, "servicePath": "", diff --git a/searchads360/v0/searchads360-gen.go b/searchads360/v0/searchads360-gen.go index d8508c6170d..0500dcca483 100644 --- a/searchads360/v0/searchads360-gen.go +++ b/searchads360/v0/searchads360-gen.go @@ -343,6 +343,38 @@ func (s *GoogleAdsSearchads360V0Common__GenderInfo) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleAdsSearchads360V0Common__Keyword: A Keyword criterion segment. +type GoogleAdsSearchads360V0Common__Keyword struct { + // AdGroupCriterion: The AdGroupCriterion resource name. + AdGroupCriterion string `json:"adGroupCriterion,omitempty"` + + // Info: Keyword info. + Info *GoogleAdsSearchads360V0Common__KeywordInfo `json:"info,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AdGroupCriterion") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AdGroupCriterion") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleAdsSearchads360V0Common__Keyword) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAdsSearchads360V0Common__Keyword + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleAdsSearchads360V0Common__KeywordInfo: A keyword criterion. type GoogleAdsSearchads360V0Common__KeywordInfo struct { // MatchType: The match type of the keyword. @@ -1294,6 +1326,177 @@ func (s *GoogleAdsSearchads360V0Common__RealTimeBiddingSetting) MarshalJSON() ([ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleAdsSearchads360V0Common__SearchAds360ExpandedDynamicSearchAdInfo +// : An expanded dynamic search ad. +type GoogleAdsSearchads360V0Common__SearchAds360ExpandedDynamicSearchAdInfo struct { + // AdTrackingId: The tracking id of the ad. + AdTrackingId int64 `json:"adTrackingId,omitempty,string"` + + // Description1: The first line of the ad's description. + Description1 string `json:"description1,omitempty"` + + // Description2: The second line of the ad's description. + Description2 string `json:"description2,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AdTrackingId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AdTrackingId") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleAdsSearchads360V0Common__SearchAds360ExpandedDynamicSearchAdInfo) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAdsSearchads360V0Common__SearchAds360ExpandedDynamicSearchAdInfo + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleAdsSearchads360V0Common__SearchAds360ExpandedTextAdInfo: A +// Search Ads 360 expanded text ad. +type GoogleAdsSearchads360V0Common__SearchAds360ExpandedTextAdInfo struct { + // AdTrackingId: The tracking id of the ad. + AdTrackingId int64 `json:"adTrackingId,omitempty,string"` + + // Description1: The first line of the ad's description. + Description1 string `json:"description1,omitempty"` + + // Description2: The second line of the ad's description. + Description2 string `json:"description2,omitempty"` + + // Headline: The headline of the ad. + Headline string `json:"headline,omitempty"` + + // Headline2: The second headline of the ad. + Headline2 string `json:"headline2,omitempty"` + + // Headline3: The third headline of the ad. + Headline3 string `json:"headline3,omitempty"` + + // Path1: Text appended to the auto-generated visible URL with a + // delimiter. + Path1 string `json:"path1,omitempty"` + + // Path2: Text appended to path1 with a delimiter. + Path2 string `json:"path2,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AdTrackingId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AdTrackingId") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleAdsSearchads360V0Common__SearchAds360ExpandedTextAdInfo) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAdsSearchads360V0Common__SearchAds360ExpandedTextAdInfo + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleAdsSearchads360V0Common__SearchAds360ProductAdInfo: A Search +// Ads 360 product ad. +type GoogleAdsSearchads360V0Common__SearchAds360ProductAdInfo struct { +} + +// GoogleAdsSearchads360V0Common__SearchAds360ResponsiveSearchAdInfo: A +// Search Ads 360 responsive search ad. +type GoogleAdsSearchads360V0Common__SearchAds360ResponsiveSearchAdInfo struct { + // AdTrackingId: The tracking id of the ad. + AdTrackingId int64 `json:"adTrackingId,omitempty,string"` + + // Path1: Text appended to the auto-generated visible URL with a + // delimiter. + Path1 string `json:"path1,omitempty"` + + // Path2: Text appended to path1 with a delimiter. + Path2 string `json:"path2,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AdTrackingId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AdTrackingId") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleAdsSearchads360V0Common__SearchAds360ResponsiveSearchAdInfo) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAdsSearchads360V0Common__SearchAds360ResponsiveSearchAdInfo + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleAdsSearchads360V0Common__SearchAds360TextAdInfo: A Search Ads +// 360 text ad. +type GoogleAdsSearchads360V0Common__SearchAds360TextAdInfo struct { + // AdTrackingId: The tracking id of the ad. + AdTrackingId int64 `json:"adTrackingId,omitempty,string"` + + // Description1: The first line of the ad's description. + Description1 string `json:"description1,omitempty"` + + // Description2: The second line of the ad's description. + Description2 string `json:"description2,omitempty"` + + // DisplayMobileUrl: The displayed mobile URL of the ad. + DisplayMobileUrl string `json:"displayMobileUrl,omitempty"` + + // DisplayUrl: The displayed URL of the ad. + DisplayUrl string `json:"displayUrl,omitempty"` + + // Headline: The headline of the ad. + Headline string `json:"headline,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AdTrackingId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AdTrackingId") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleAdsSearchads360V0Common__SearchAds360TextAdInfo) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAdsSearchads360V0Common__SearchAds360TextAdInfo + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleAdsSearchads360V0Common__Segments: Segment only fields. type GoogleAdsSearchads360V0Common__Segments struct { // ConversionAction: Resource name of the conversion action. @@ -1380,6 +1583,9 @@ type GoogleAdsSearchads360V0Common__Segments struct { // "OTHER" - Other device types. Device string `json:"device,omitempty"` + // Keyword: Keyword criterion. + Keyword *GoogleAdsSearchads360V0Common__Keyword `json:"keyword,omitempty"` + // Month: Month as represented by the date of the first day of a month. // Formatted as yyyy-MM-dd. Month string `json:"month,omitempty"` @@ -3082,6 +3288,13 @@ type GoogleAdsSearchads360V0Resources__Ad struct { // formats. DisplayUrl string `json:"displayUrl,omitempty"` + // ExpandedDynamicSearchAd: Immutable. Details pertaining to an expanded + // dynamic search ad. + ExpandedDynamicSearchAd *GoogleAdsSearchads360V0Common__SearchAds360ExpandedDynamicSearchAdInfo `json:"expandedDynamicSearchAd,omitempty"` + + // ExpandedTextAd: Immutable. Details pertaining to an expanded text ad. + ExpandedTextAd *GoogleAdsSearchads360V0Common__SearchAds360ExpandedTextAdInfo `json:"expandedTextAd,omitempty"` + // FinalUrls: The list of possible final URLs after all cross-domain // redirects for the ad. FinalUrls []string `json:"finalUrls,omitempty"` @@ -3095,10 +3308,20 @@ type GoogleAdsSearchads360V0Resources__Ad struct { // DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd. Name string `json:"name,omitempty"` + // ProductAd: Immutable. Details pertaining to a product ad. + ProductAd *GoogleAdsSearchads360V0Common__SearchAds360ProductAdInfo `json:"productAd,omitempty"` + // ResourceName: Immutable. The resource name of the ad. Ad resource // names have the form: `customers/{customer_id}/ads/{ad_id}` ResourceName string `json:"resourceName,omitempty"` + // ResponsiveSearchAd: Immutable. Details pertaining to a responsive + // search ad. + ResponsiveSearchAd *GoogleAdsSearchads360V0Common__SearchAds360ResponsiveSearchAdInfo `json:"responsiveSearchAd,omitempty"` + + // TextAd: Immutable. Details pertaining to a text ad. + TextAd *GoogleAdsSearchads360V0Common__SearchAds360TextAdInfo `json:"textAd,omitempty"` + // Type: Output only. The type of ad. // // Possible values: @@ -3662,7 +3885,7 @@ type GoogleAdsSearchads360V0Resources__AdGroupCriterion struct { // ListingGroup: Immutable. Listing group. ListingGroup *GoogleAdsSearchads360V0Common__ListingGroupInfo `json:"listingGroup,omitempty"` - // Location: Immutable. Location. + // Location: Output only. Location. Location *GoogleAdsSearchads360V0Common__LocationInfo `json:"location,omitempty"` // Negative: Immutable. Whether to target (`false`) or exclude (`true`) @@ -4344,7 +4567,7 @@ type GoogleAdsSearchads360V0Resources__Campaign struct { // "CALLOUT" - The asset is linked for use as a Callout extension. // "STRUCTURED_SNIPPET" - The asset is linked for use as a Structured // Snippet extension. - // "SITELINK" - The asset is linked for use as a Sitelink extension. + // "SITELINK" - The asset is linked for use as a Sitelink. // "MOBILE_APP" - The asset is linked for use as a Mobile App // extension. // "HOTEL_CALLOUT" - The asset is linked for use as a Hotel Callout @@ -6381,106 +6604,6 @@ func (s *GoogleAdsSearchads360V0Services__SearchSearchAds360Response) MarshalJSO return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleAdsSearchads360V0Services__SearchSearchAds360StreamRequest: -// Request message for SearchAds360Service.SearchStream. -type GoogleAdsSearchads360V0Services__SearchSearchAds360StreamRequest struct { - // BatchSize: The number of rows that are returned in each stream - // response batch. When too large batch is requested, the server may - // decide to further limit the number of returned rows. - BatchSize int64 `json:"batchSize,omitempty"` - - // Query: Required. The query string. - Query string `json:"query,omitempty"` - - // SummaryRowSetting: Determines whether a summary row will be returned. - // By default, summary row is not returned. If requested, the summary - // row will be sent in a response by itself after all other query - // results are returned. - // - // Possible values: - // "UNSPECIFIED" - Not specified. - // "UNKNOWN" - Represent unknown values of return summary row. - // "NO_SUMMARY_ROW" - Do not return summary row. - // "SUMMARY_ROW_WITH_RESULTS" - Return summary row along with results. - // The summary row will be returned in the last batch alone (last batch - // will contain no results). - // "SUMMARY_ROW_ONLY" - Return summary row only and return no results. - SummaryRowSetting string `json:"summaryRowSetting,omitempty"` - - // ForceSendFields is a list of field names (e.g. "BatchSize") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "BatchSize") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *GoogleAdsSearchads360V0Services__SearchSearchAds360StreamRequest) MarshalJSON() ([]byte, error) { - type NoMethod GoogleAdsSearchads360V0Services__SearchSearchAds360StreamRequest - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - -// GoogleAdsSearchads360V0Services__SearchSearchAds360StreamResponse: -// Response message for SearchAds360Service.SearchStream. -type GoogleAdsSearchads360V0Services__SearchSearchAds360StreamResponse struct { - // CustomColumnHeaders: The headers of the custom columns in the - // results. - CustomColumnHeaders []*GoogleAdsSearchads360V0Services__CustomColumnHeader `json:"customColumnHeaders,omitempty"` - - // FieldMask: FieldMask that represents what fields were requested by - // the user. - FieldMask string `json:"fieldMask,omitempty"` - - // RequestId: The unique id of the request that is used for debugging - // purposes. - RequestId string `json:"requestId,omitempty"` - - // Results: The list of rows that matched the query. - Results []*GoogleAdsSearchads360V0Services__SearchAds360Row `json:"results,omitempty"` - - // SummaryRow: Summary row that contains summary of metrics in results. - // Summary of metrics means aggregation of metrics across all results, - // here aggregation could be sum, average, rate, etc. - SummaryRow *GoogleAdsSearchads360V0Services__SearchAds360Row `json:"summaryRow,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the - // server. - googleapi.ServerResponse `json:"-"` - - // ForceSendFields is a list of field names (e.g. "CustomColumnHeaders") - // to unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "CustomColumnHeaders") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the - // server as null. It is an error if a field in this list has a - // non-empty value. This may be used to include null fields in Patch - // requests. - NullFields []string `json:"-"` -} - -func (s *GoogleAdsSearchads360V0Services__SearchSearchAds360StreamResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleAdsSearchads360V0Services__SearchSearchAds360StreamResponse - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // method id "searchads360.customers.customColumns.get": type CustomersCustomColumnsGetCall struct { @@ -6948,154 +7071,6 @@ func (c *CustomersSearchAds360SearchCall) Pages(ctx context.Context, f func(*Goo } } -// method id "searchads360.customers.searchAds360.searchStream": - -type CustomersSearchAds360SearchStreamCall struct { - s *Service - customerId string - googleadssearchads360v0services__searchsearchads360streamrequest *GoogleAdsSearchads360V0Services__SearchSearchAds360StreamRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// SearchStream: Returns all rows that match the search stream query. -// List of thrown errors: AuthenticationError () [AuthorizationError]() -// HeaderError () [InternalError]() QueryError () [QuotaError]() -// RequestError () -// -// - customerId: The ID of the customer being queried. -func (r *CustomersSearchAds360Service) SearchStream(customerId string, googleadssearchads360v0services__searchsearchads360streamrequest *GoogleAdsSearchads360V0Services__SearchSearchAds360StreamRequest) *CustomersSearchAds360SearchStreamCall { - c := &CustomersSearchAds360SearchStreamCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.customerId = customerId - c.googleadssearchads360v0services__searchsearchads360streamrequest = googleadssearchads360v0services__searchsearchads360streamrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse -// for more information. -func (c *CustomersSearchAds360SearchStreamCall) Fields(s ...googleapi.Field) *CustomersSearchAds360SearchStreamCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. Any -// pending HTTP request will be aborted if the provided context is -// canceled. -func (c *CustomersSearchAds360SearchStreamCall) Context(ctx context.Context) *CustomersSearchAds360SearchStreamCall { - c.ctx_ = ctx - return c -} - -// Header returns an http.Header that can be modified by the caller to -// add HTTP headers to the request. -func (c *CustomersSearchAds360SearchStreamCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *CustomersSearchAds360SearchStreamCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) - for k, v := range c.header_ { - reqHeaders[k] = v - } - reqHeaders.Set("User-Agent", c.s.userAgent()) - var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleadssearchads360v0services__searchsearchads360streamrequest) - if err != nil { - return nil, err - } - reqHeaders.Set("Content-Type", "application/json") - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v0/customers/{+customerId}/searchAds360:searchStream") - 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{ - "customerId": c.customerId, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "searchads360.customers.searchAds360.searchStream" call. -// Exactly one of -// *GoogleAdsSearchads360V0Services__SearchSearchAds360StreamResponse or -// error will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleAdsSearchads360V0Services__SearchSearchAds360StreamResponse.Ser -// verResponse.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 *CustomersSearchAds360SearchStreamCall) Do(opts ...googleapi.CallOption) (*GoogleAdsSearchads360V0Services__SearchSearchAds360StreamResponse, 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 := &GoogleAdsSearchads360V0Services__SearchSearchAds360StreamResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - if err := gensupport.DecodeResponse(target, res); err != nil { - return nil, err - } - return ret, nil - // { - // "description": "Returns all rows that match the search stream query. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QueryError]() [QuotaError]() [RequestError]()", - // "flatPath": "v0/customers/{customersId}/searchAds360:searchStream", - // "httpMethod": "POST", - // "id": "searchads360.customers.searchAds360.searchStream", - // "parameterOrder": [ - // "customerId" - // ], - // "parameters": { - // "customerId": { - // "description": "Required. The ID of the customer being queried.", - // "location": "path", - // "pattern": "^[^/]+$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v0/customers/{+customerId}/searchAds360:searchStream", - // "request": { - // "$ref": "GoogleAdsSearchads360V0Services__SearchSearchAds360StreamRequest" - // }, - // "response": { - // "$ref": "GoogleAdsSearchads360V0Services__SearchSearchAds360StreamResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/doubleclicksearch" - // ] - // } - -} - // method id "searchads360.searchAds360Fields.get": type SearchAds360FieldsGetCall struct { diff --git a/secretmanager/v1/secretmanager-api.json b/secretmanager/v1/secretmanager-api.json index c1e4267242d..4e760244392 100644 --- a/secretmanager/v1/secretmanager-api.json +++ b/secretmanager/v1/secretmanager-api.json @@ -643,7 +643,7 @@ } } }, - "revision": "20230407", + "revision": "20230428", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { @@ -914,7 +914,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/secretmanager/v1/secretmanager-gen.go b/secretmanager/v1/secretmanager-gen.go index 5b56c6fe114..f45dd07c751 100644 --- a/secretmanager/v1/secretmanager-gen.go +++ b/secretmanager/v1/secretmanager-gen.go @@ -848,7 +848,7 @@ func (s *ListSecretsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/secretmanager/v1beta1/secretmanager-api.json b/secretmanager/v1beta1/secretmanager-api.json index 437825fbdb0..7e21cca6960 100644 --- a/secretmanager/v1beta1/secretmanager-api.json +++ b/secretmanager/v1beta1/secretmanager-api.json @@ -628,7 +628,7 @@ } } }, - "revision": "20230204", + "revision": "20230428", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { @@ -845,7 +845,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/secretmanager/v1beta1/secretmanager-gen.go b/secretmanager/v1beta1/secretmanager-gen.go index 4fe767fd9dd..435c649f38b 100644 --- a/secretmanager/v1beta1/secretmanager-gen.go +++ b/secretmanager/v1beta1/secretmanager-gen.go @@ -636,7 +636,7 @@ func (s *ListSecretsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/securitycenter/v1/securitycenter-api.json b/securitycenter/v1/securitycenter-api.json index 9aa44b95a05..150a3788ac5 100644 --- a/securitycenter/v1/securitycenter-api.json +++ b/securitycenter/v1/securitycenter-api.json @@ -255,7 +255,7 @@ ], "parameters": { "bigQueryExportId": { - "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.", + "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.", "location": "query", "type": "string" }, @@ -444,7 +444,7 @@ ], "parameters": { "muteConfigId": { - "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.", + "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.", "location": "query", "type": "string" }, @@ -1552,7 +1552,7 @@ ], "parameters": { "bigQueryExportId": { - "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.", + "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.", "location": "query", "type": "string" }, @@ -1741,7 +1741,7 @@ ], "parameters": { "muteConfigId": { - "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.", + "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.", "location": "query", "type": "string" }, @@ -3084,7 +3084,7 @@ ], "parameters": { "bigQueryExportId": { - "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.", + "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.", "location": "query", "type": "string" }, @@ -3273,7 +3273,7 @@ ], "parameters": { "muteConfigId": { - "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.", + "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.", "location": "query", "type": "string" }, @@ -4143,7 +4143,7 @@ } } }, - "revision": "20230420", + "revision": "20230504", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { diff --git a/securitycenter/v1/securitycenter-gen.go b/securitycenter/v1/securitycenter-gen.go index f696137b4ff..b980894a8a0 100644 --- a/securitycenter/v1/securitycenter-gen.go +++ b/securitycenter/v1/securitycenter-gen.go @@ -6497,9 +6497,9 @@ func (r *FoldersBigQueryExportsService) Create(parent string, googlecloudsecurit // BigQueryExportId sets the optional parameter "bigQueryExportId": // Required. Unique identifier provided by the client within the parent -// scope. It must consist of lower case letters, numbers, and hyphen, -// with the first character a letter, the last a letter or a number, and -// a 63 character maximum. +// scope. It must consist of only lowercase letters, numbers, and +// hyphens, must start with a letter, must end with either a letter or a +// number, and must be 63 characters or less. func (c *FoldersBigQueryExportsCreateCall) BigQueryExportId(bigQueryExportId string) *FoldersBigQueryExportsCreateCall { c.urlParams_.Set("bigQueryExportId", bigQueryExportId) return c @@ -6607,7 +6607,7 @@ func (c *FoldersBigQueryExportsCreateCall) Do(opts ...googleapi.CallOption) (*Go // ], // "parameters": { // "bigQueryExportId": { - // "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.", + // "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.", // "location": "query", // "type": "string" // }, @@ -7458,9 +7458,9 @@ func (r *FoldersMuteConfigsService) Create(parent string, googlecloudsecuritycen // MuteConfigId sets the optional parameter "muteConfigId": Required. // Unique identifier provided by the client within the parent scope. It -// must consist of lower case letters, numbers, and hyphen, with the -// first character a letter, the last a letter or a number, and a 63 -// character maximum. +// must consist of only lowercase letters, numbers, and hyphens, must +// start with a letter, must end with either a letter or a number, and +// must be 63 characters or less. func (c *FoldersMuteConfigsCreateCall) MuteConfigId(muteConfigId string) *FoldersMuteConfigsCreateCall { c.urlParams_.Set("muteConfigId", muteConfigId) return c @@ -7567,7 +7567,7 @@ func (c *FoldersMuteConfigsCreateCall) Do(opts ...googleapi.CallOption) (*Google // ], // "parameters": { // "muteConfigId": { - // "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.", + // "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.", // "location": "query", // "type": "string" // }, @@ -13069,9 +13069,9 @@ func (r *OrganizationsBigQueryExportsService) Create(parent string, googleclouds // BigQueryExportId sets the optional parameter "bigQueryExportId": // Required. Unique identifier provided by the client within the parent -// scope. It must consist of lower case letters, numbers, and hyphen, -// with the first character a letter, the last a letter or a number, and -// a 63 character maximum. +// scope. It must consist of only lowercase letters, numbers, and +// hyphens, must start with a letter, must end with either a letter or a +// number, and must be 63 characters or less. func (c *OrganizationsBigQueryExportsCreateCall) BigQueryExportId(bigQueryExportId string) *OrganizationsBigQueryExportsCreateCall { c.urlParams_.Set("bigQueryExportId", bigQueryExportId) return c @@ -13179,7 +13179,7 @@ func (c *OrganizationsBigQueryExportsCreateCall) Do(opts ...googleapi.CallOption // ], // "parameters": { // "bigQueryExportId": { - // "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.", + // "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.", // "location": "query", // "type": "string" // }, @@ -14030,9 +14030,9 @@ func (r *OrganizationsMuteConfigsService) Create(parent string, googlecloudsecur // MuteConfigId sets the optional parameter "muteConfigId": Required. // Unique identifier provided by the client within the parent scope. It -// must consist of lower case letters, numbers, and hyphen, with the -// first character a letter, the last a letter or a number, and a 63 -// character maximum. +// must consist of only lowercase letters, numbers, and hyphens, must +// start with a letter, must end with either a letter or a number, and +// must be 63 characters or less. func (c *OrganizationsMuteConfigsCreateCall) MuteConfigId(muteConfigId string) *OrganizationsMuteConfigsCreateCall { c.urlParams_.Set("muteConfigId", muteConfigId) return c @@ -14139,7 +14139,7 @@ func (c *OrganizationsMuteConfigsCreateCall) Do(opts ...googleapi.CallOption) (* // ], // "parameters": { // "muteConfigId": { - // "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.", + // "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.", // "location": "query", // "type": "string" // }, @@ -20861,9 +20861,9 @@ func (r *ProjectsBigQueryExportsService) Create(parent string, googlecloudsecuri // BigQueryExportId sets the optional parameter "bigQueryExportId": // Required. Unique identifier provided by the client within the parent -// scope. It must consist of lower case letters, numbers, and hyphen, -// with the first character a letter, the last a letter or a number, and -// a 63 character maximum. +// scope. It must consist of only lowercase letters, numbers, and +// hyphens, must start with a letter, must end with either a letter or a +// number, and must be 63 characters or less. func (c *ProjectsBigQueryExportsCreateCall) BigQueryExportId(bigQueryExportId string) *ProjectsBigQueryExportsCreateCall { c.urlParams_.Set("bigQueryExportId", bigQueryExportId) return c @@ -20971,7 +20971,7 @@ func (c *ProjectsBigQueryExportsCreateCall) Do(opts ...googleapi.CallOption) (*G // ], // "parameters": { // "bigQueryExportId": { - // "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.", + // "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.", // "location": "query", // "type": "string" // }, @@ -21822,9 +21822,9 @@ func (r *ProjectsMuteConfigsService) Create(parent string, googlecloudsecurityce // MuteConfigId sets the optional parameter "muteConfigId": Required. // Unique identifier provided by the client within the parent scope. It -// must consist of lower case letters, numbers, and hyphen, with the -// first character a letter, the last a letter or a number, and a 63 -// character maximum. +// must consist of only lowercase letters, numbers, and hyphens, must +// start with a letter, must end with either a letter or a number, and +// must be 63 characters or less. func (c *ProjectsMuteConfigsCreateCall) MuteConfigId(muteConfigId string) *ProjectsMuteConfigsCreateCall { c.urlParams_.Set("muteConfigId", muteConfigId) return c @@ -21931,7 +21931,7 @@ func (c *ProjectsMuteConfigsCreateCall) Do(opts ...googleapi.CallOption) (*Googl // ], // "parameters": { // "muteConfigId": { - // "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of lower case letters, numbers, and hyphen, with the first character a letter, the last a letter or a number, and a 63 character maximum.", + // "description": "Required. Unique identifier provided by the client within the parent scope. It must consist of only lowercase letters, numbers, and hyphens, must start with a letter, must end with either a letter or a number, and must be 63 characters or less.", // "location": "query", // "type": "string" // }, diff --git a/serviceconsumermanagement/v1/serviceconsumermanagement-api.json b/serviceconsumermanagement/v1/serviceconsumermanagement-api.json index bc4f9655577..f4c7eba8688 100644 --- a/serviceconsumermanagement/v1/serviceconsumermanagement-api.json +++ b/serviceconsumermanagement/v1/serviceconsumermanagement-api.json @@ -542,7 +542,7 @@ } } }, - "revision": "20230425", + "revision": "20230503", "rootUrl": "https://serviceconsumermanagement.googleapis.com/", "schemas": { "AddTenantProjectRequest": { @@ -1165,6 +1165,10 @@ "description": "Description of the selected proto element (e.g. a message, a method, a 'service' definition, or a field). Defaults to leading \u0026 trailing comments taken from the proto source definition of the proto element.", "type": "string" }, + "disableReplacementWords": { + "description": "String of comma or space separated case-sensitive words for which method/field name replacement will be disabled by go/api-docgen.", + "type": "string" + }, "selector": { "description": "The selector is a comma-separated list of patterns for any element such as a method, a field, an enum value. Each pattern is a qualified name of the element which may end in \"*\", indicating a wildcard. Wildcards are only allowed at the end and for a whole component of the qualified name, i.e. \"foo.*\" is ok, but not \"foo.b*\" or \"foo.*.bar\". A wildcard will match one or more components. To specify a default for all applicable elements, the whole pattern \"*\" is used.", "type": "string" @@ -2226,7 +2230,8 @@ "PHOTOS", "STREET_VIEW", "SHOPPING", - "GEO" + "GEO", + "GENERATIVE_AI" ], "enumDescriptions": [ "Not useful.", @@ -2235,7 +2240,8 @@ "Photos Org.", "Street View Org.", "Shopping Org.", - "Geo Org." + "Geo Org.", + "Generative AI - https://developers.generativeai.google" ], "type": "string" }, diff --git a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go index 7e35b2c9721..59182519467 100644 --- a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go @@ -1406,6 +1406,11 @@ type DocumentationRule struct { // the proto element. Description string `json:"description,omitempty"` + // DisableReplacementWords: String of comma or space separated + // case-sensitive words for which method/field name replacement will be + // disabled by go/api-docgen. + DisableReplacementWords string `json:"disableReplacementWords,omitempty"` + // Selector: The selector is a comma-separated list of patterns for any // element such as a method, a field, an enum value. Each pattern is a // qualified name of the element which may end in "*", indicating a @@ -3431,6 +3436,8 @@ type Publishing struct { // "STREET_VIEW" - Street View Org. // "SHOPPING" - Shopping Org. // "GEO" - Geo Org. + // "GENERATIVE_AI" - Generative AI - + // https://developers.generativeai.google Organization string `json:"organization,omitempty"` // ProtoReferenceDocumentationUri: Optional link to proto reference diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json index 3d04833b015..33e56e63e75 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json @@ -500,7 +500,7 @@ } } }, - "revision": "20230425", + "revision": "20230503", "rootUrl": "https://serviceconsumermanagement.googleapis.com/", "schemas": { "Api": { @@ -1035,6 +1035,10 @@ "description": "Description of the selected proto element (e.g. a message, a method, a 'service' definition, or a field). Defaults to leading \u0026 trailing comments taken from the proto source definition of the proto element.", "type": "string" }, + "disableReplacementWords": { + "description": "String of comma or space separated case-sensitive words for which method/field name replacement will be disabled by go/api-docgen.", + "type": "string" + }, "selector": { "description": "The selector is a comma-separated list of patterns for any element such as a method, a field, an enum value. Each pattern is a qualified name of the element which may end in \"*\", indicating a wildcard. Wildcards are only allowed at the end and for a whole component of the qualified name, i.e. \"foo.*\" is ok, but not \"foo.b*\" or \"foo.*.bar\". A wildcard will match one or more components. To specify a default for all applicable elements, the whole pattern \"*\" is used.", "type": "string" @@ -2042,7 +2046,8 @@ "PHOTOS", "STREET_VIEW", "SHOPPING", - "GEO" + "GEO", + "GENERATIVE_AI" ], "enumDescriptions": [ "Not useful.", @@ -2051,7 +2056,8 @@ "Photos Org.", "Street View Org.", "Shopping Org.", - "Geo Org." + "Geo Org.", + "Generative AI - https://developers.generativeai.google" ], "type": "string" }, diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go index 526604b1003..754f5db233a 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go @@ -1220,6 +1220,11 @@ type DocumentationRule struct { // the proto element. Description string `json:"description,omitempty"` + // DisableReplacementWords: String of comma or space separated + // case-sensitive words for which method/field name replacement will be + // disabled by go/api-docgen. + DisableReplacementWords string `json:"disableReplacementWords,omitempty"` + // Selector: The selector is a comma-separated list of patterns for any // element such as a method, a field, an enum value. Each pattern is a // qualified name of the element which may end in "*", indicating a @@ -3135,6 +3140,8 @@ type Publishing struct { // "STREET_VIEW" - Street View Org. // "SHOPPING" - Shopping Org. // "GEO" - Geo Org. + // "GENERATIVE_AI" - Generative AI - + // https://developers.generativeai.google Organization string `json:"organization,omitempty"` // ProtoReferenceDocumentationUri: Optional link to proto reference diff --git a/servicemanagement/v1/servicemanagement-api.json b/servicemanagement/v1/servicemanagement-api.json index a3080dbf0ed..be255f4c0cf 100644 --- a/servicemanagement/v1/servicemanagement-api.json +++ b/servicemanagement/v1/servicemanagement-api.json @@ -829,7 +829,7 @@ } } }, - "revision": "20230414", + "revision": "20230428", "rootUrl": "https://servicemanagement.googleapis.com/", "schemas": { "Advice": { @@ -1599,6 +1599,10 @@ "description": "Description of the selected proto element (e.g. a message, a method, a 'service' definition, or a field). Defaults to leading \u0026 trailing comments taken from the proto source definition of the proto element.", "type": "string" }, + "disableReplacementWords": { + "description": "String of comma or space separated case-sensitive words for which method/field name replacement will be disabled by go/api-docgen.", + "type": "string" + }, "selector": { "description": "The selector is a comma-separated list of patterns for any element such as a method, a field, an enum value. Each pattern is a qualified name of the element which may end in \"*\", indicating a wildcard. Wildcards are only allowed at the end and for a whole component of the qualified name, i.e. \"foo.*\" is ok, but not \"foo.b*\" or \"foo.*.bar\". A wildcard will match one or more components. To specify a default for all applicable elements, the whole pattern \"*\" is used.", "type": "string" @@ -2882,7 +2886,9 @@ "ADS", "PHOTOS", "STREET_VIEW", - "SHOPPING" + "SHOPPING", + "GEO", + "GENERATIVE_AI" ], "enumDescriptions": [ "Not useful.", @@ -2890,7 +2896,9 @@ "Ads (Advertising) Org.", "Photos Org.", "Street View Org.", - "Shopping Org." + "Shopping Org.", + "Geo Org.", + "Generative AI - https://developers.generativeai.google" ], "type": "string" }, diff --git a/servicemanagement/v1/servicemanagement-gen.go b/servicemanagement/v1/servicemanagement-gen.go index 1afe01f851e..460b4e9a108 100644 --- a/servicemanagement/v1/servicemanagement-gen.go +++ b/servicemanagement/v1/servicemanagement-gen.go @@ -1702,6 +1702,11 @@ type DocumentationRule struct { // the proto element. Description string `json:"description,omitempty"` + // DisableReplacementWords: String of comma or space separated + // case-sensitive words for which method/field name replacement will be + // disabled by go/api-docgen. + DisableReplacementWords string `json:"disableReplacementWords,omitempty"` + // Selector: The selector is a comma-separated list of patterns for any // element such as a method, a field, an enum value. Each pattern is a // qualified name of the element which may end in "*", indicating a @@ -4238,6 +4243,9 @@ type Publishing struct { // "PHOTOS" - Photos Org. // "STREET_VIEW" - Street View Org. // "SHOPPING" - Shopping Org. + // "GEO" - Geo Org. + // "GENERATIVE_AI" - Generative AI - + // https://developers.generativeai.google Organization string `json:"organization,omitempty"` // ProtoReferenceDocumentationUri: Optional link to proto reference diff --git a/servicenetworking/v1/servicenetworking-api.json b/servicenetworking/v1/servicenetworking-api.json index b81af8bb83e..857c0f784c8 100644 --- a/servicenetworking/v1/servicenetworking-api.json +++ b/servicenetworking/v1/servicenetworking-api.json @@ -865,7 +865,7 @@ } } }, - "revision": "20230419", + "revision": "20230507", "rootUrl": "https://servicenetworking.googleapis.com/", "schemas": { "AddDnsRecordSetMetadata": { @@ -1813,6 +1813,10 @@ "description": "Description of the selected proto element (e.g. a message, a method, a 'service' definition, or a field). Defaults to leading \u0026 trailing comments taken from the proto source definition of the proto element.", "type": "string" }, + "disableReplacementWords": { + "description": "String of comma or space separated case-sensitive words for which method/field name replacement will be disabled by go/api-docgen.", + "type": "string" + }, "selector": { "description": "The selector is a comma-separated list of patterns for any element such as a method, a field, an enum value. Each pattern is a qualified name of the element which may end in \"*\", indicating a wildcard. Wildcards are only allowed at the end and for a whole component of the qualified name, i.e. \"foo.*\" is ok, but not \"foo.b*\" or \"foo.*.bar\". A wildcard will match one or more components. To specify a default for all applicable elements, the whole pattern \"*\" is used.", "type": "string" @@ -2987,7 +2991,9 @@ "ADS", "PHOTOS", "STREET_VIEW", - "SHOPPING" + "SHOPPING", + "GEO", + "GENERATIVE_AI" ], "enumDescriptions": [ "Not useful.", @@ -2995,7 +3001,9 @@ "Ads (Advertising) Org.", "Photos Org.", "Street View Org.", - "Shopping Org." + "Shopping Org.", + "Geo Org.", + "Generative AI - https://developers.generativeai.google" ], "type": "string" }, diff --git a/servicenetworking/v1/servicenetworking-gen.go b/servicenetworking/v1/servicenetworking-gen.go index 0a979845fd3..e668b32c653 100644 --- a/servicenetworking/v1/servicenetworking-gen.go +++ b/servicenetworking/v1/servicenetworking-gen.go @@ -2010,6 +2010,11 @@ type DocumentationRule struct { // the proto element. Description string `json:"description,omitempty"` + // DisableReplacementWords: String of comma or space separated + // case-sensitive words for which method/field name replacement will be + // disabled by go/api-docgen. + DisableReplacementWords string `json:"disableReplacementWords,omitempty"` + // Selector: The selector is a comma-separated list of patterns for any // element such as a method, a field, an enum value. Each pattern is a // qualified name of the element which may end in "*", indicating a @@ -4281,6 +4286,9 @@ type Publishing struct { // "PHOTOS" - Photos Org. // "STREET_VIEW" - Street View Org. // "SHOPPING" - Shopping Org. + // "GEO" - Geo Org. + // "GENERATIVE_AI" - Generative AI - + // https://developers.generativeai.google Organization string `json:"organization,omitempty"` // ProtoReferenceDocumentationUri: Optional link to proto reference diff --git a/servicenetworking/v1beta/servicenetworking-api.json b/servicenetworking/v1beta/servicenetworking-api.json index 6cd4ca77242..835f69b34f3 100644 --- a/servicenetworking/v1beta/servicenetworking-api.json +++ b/servicenetworking/v1beta/servicenetworking-api.json @@ -307,7 +307,7 @@ } } }, - "revision": "20230419", + "revision": "20230507", "rootUrl": "https://servicenetworking.googleapis.com/", "schemas": { "AddDnsRecordSetMetadata": { @@ -1112,6 +1112,10 @@ "description": "Description of the selected proto element (e.g. a message, a method, a 'service' definition, or a field). Defaults to leading \u0026 trailing comments taken from the proto source definition of the proto element.", "type": "string" }, + "disableReplacementWords": { + "description": "String of comma or space separated case-sensitive words for which method/field name replacement will be disabled by go/api-docgen.", + "type": "string" + }, "selector": { "description": "The selector is a comma-separated list of patterns for any element such as a method, a field, an enum value. Each pattern is a qualified name of the element which may end in \"*\", indicating a wildcard. Wildcards are only allowed at the end and for a whole component of the qualified name, i.e. \"foo.*\" is ok, but not \"foo.b*\" or \"foo.*.bar\". A wildcard will match one or more components. To specify a default for all applicable elements, the whole pattern \"*\" is used.", "type": "string" @@ -2237,7 +2241,9 @@ "ADS", "PHOTOS", "STREET_VIEW", - "SHOPPING" + "SHOPPING", + "GEO", + "GENERATIVE_AI" ], "enumDescriptions": [ "Not useful.", @@ -2245,7 +2251,9 @@ "Ads (Advertising) Org.", "Photos Org.", "Street View Org.", - "Shopping Org." + "Shopping Org.", + "Geo Org.", + "Generative AI - https://developers.generativeai.google" ], "type": "string" }, diff --git a/servicenetworking/v1beta/servicenetworking-gen.go b/servicenetworking/v1beta/servicenetworking-gen.go index 6761f9669d5..016661686c1 100644 --- a/servicenetworking/v1beta/servicenetworking-gen.go +++ b/servicenetworking/v1beta/servicenetworking-gen.go @@ -1622,6 +1622,11 @@ type DocumentationRule struct { // the proto element. Description string `json:"description,omitempty"` + // DisableReplacementWords: String of comma or space separated + // case-sensitive words for which method/field name replacement will be + // disabled by go/api-docgen. + DisableReplacementWords string `json:"disableReplacementWords,omitempty"` + // Selector: The selector is a comma-separated list of patterns for any // element such as a method, a field, an enum value. Each pattern is a // qualified name of the element which may end in "*", indicating a @@ -3778,6 +3783,9 @@ type Publishing struct { // "PHOTOS" - Photos Org. // "STREET_VIEW" - Street View Org. // "SHOPPING" - Shopping Org. + // "GEO" - Geo Org. + // "GENERATIVE_AI" - Generative AI - + // https://developers.generativeai.google Organization string `json:"organization,omitempty"` // ProtoReferenceDocumentationUri: Optional link to proto reference diff --git a/serviceusage/v1/serviceusage-api.json b/serviceusage/v1/serviceusage-api.json index eabbb817e35..9dfccf17468 100644 --- a/serviceusage/v1/serviceusage-api.json +++ b/serviceusage/v1/serviceusage-api.json @@ -426,7 +426,7 @@ } } }, - "revision": "20230425", + "revision": "20230503", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AdminQuotaPolicy": { @@ -1162,6 +1162,10 @@ "description": "Description of the selected proto element (e.g. a message, a method, a 'service' definition, or a field). Defaults to leading \u0026 trailing comments taken from the proto source definition of the proto element.", "type": "string" }, + "disableReplacementWords": { + "description": "String of comma or space separated case-sensitive words for which method/field name replacement will be disabled by go/api-docgen.", + "type": "string" + }, "selector": { "description": "The selector is a comma-separated list of patterns for any element such as a method, a field, an enum value. Each pattern is a qualified name of the element which may end in \"*\", indicating a wildcard. Wildcards are only allowed at the end and for a whole component of the qualified name, i.e. \"foo.*\" is ok, but not \"foo.b*\" or \"foo.*.bar\". A wildcard will match one or more components. To specify a default for all applicable elements, the whole pattern \"*\" is used.", "type": "string" @@ -2669,7 +2673,8 @@ "PHOTOS", "STREET_VIEW", "SHOPPING", - "GEO" + "GEO", + "GENERATIVE_AI" ], "enumDescriptions": [ "Not useful.", @@ -2678,7 +2683,8 @@ "Photos Org.", "Street View Org.", "Shopping Org.", - "Geo Org." + "Geo Org.", + "Generative AI - https://developers.generativeai.google" ], "type": "string" }, diff --git a/serviceusage/v1/serviceusage-gen.go b/serviceusage/v1/serviceusage-gen.go index e16144343ce..5ec5276dffc 100644 --- a/serviceusage/v1/serviceusage-gen.go +++ b/serviceusage/v1/serviceusage-gen.go @@ -1565,6 +1565,11 @@ type DocumentationRule struct { // the proto element. Description string `json:"description,omitempty"` + // DisableReplacementWords: String of comma or space separated + // case-sensitive words for which method/field name replacement will be + // disabled by go/api-docgen. + DisableReplacementWords string `json:"disableReplacementWords,omitempty"` + // Selector: The selector is a comma-separated list of patterns for any // element such as a method, a field, an enum value. Each pattern is a // qualified name of the element which may end in "*", indicating a @@ -4245,6 +4250,8 @@ type Publishing struct { // "STREET_VIEW" - Street View Org. // "SHOPPING" - Shopping Org. // "GEO" - Geo Org. + // "GENERATIVE_AI" - Generative AI - + // https://developers.generativeai.google Organization string `json:"organization,omitempty"` // ProtoReferenceDocumentationUri: Optional link to proto reference diff --git a/serviceusage/v1beta1/serviceusage-api.json b/serviceusage/v1beta1/serviceusage-api.json index 91a34f6b36d..ad7bd486c56 100644 --- a/serviceusage/v1beta1/serviceusage-api.json +++ b/serviceusage/v1beta1/serviceusage-api.json @@ -964,7 +964,7 @@ } } }, - "revision": "20230425", + "revision": "20230503", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AdminQuotaPolicy": { @@ -1739,6 +1739,10 @@ "description": "Description of the selected proto element (e.g. a message, a method, a 'service' definition, or a field). Defaults to leading \u0026 trailing comments taken from the proto source definition of the proto element.", "type": "string" }, + "disableReplacementWords": { + "description": "String of comma or space separated case-sensitive words for which method/field name replacement will be disabled by go/api-docgen.", + "type": "string" + }, "selector": { "description": "The selector is a comma-separated list of patterns for any element such as a method, a field, an enum value. Each pattern is a qualified name of the element which may end in \"*\", indicating a wildcard. Wildcards are only allowed at the end and for a whole component of the qualified name, i.e. \"foo.*\" is ok, but not \"foo.b*\" or \"foo.*.bar\". A wildcard will match one or more components. To specify a default for all applicable elements, the whole pattern \"*\" is used.", "type": "string" @@ -3378,7 +3382,8 @@ "PHOTOS", "STREET_VIEW", "SHOPPING", - "GEO" + "GEO", + "GENERATIVE_AI" ], "enumDescriptions": [ "Not useful.", @@ -3387,7 +3392,8 @@ "Photos Org.", "Street View Org.", "Shopping Org.", - "Geo Org." + "Geo Org.", + "Generative AI - https://developers.generativeai.google" ], "type": "string" }, diff --git a/serviceusage/v1beta1/serviceusage-gen.go b/serviceusage/v1beta1/serviceusage-gen.go index 2d42dac97fb..69e76dd0bf6 100644 --- a/serviceusage/v1beta1/serviceusage-gen.go +++ b/serviceusage/v1beta1/serviceusage-gen.go @@ -1660,6 +1660,11 @@ type DocumentationRule struct { // the proto element. Description string `json:"description,omitempty"` + // DisableReplacementWords: String of comma or space separated + // case-sensitive words for which method/field name replacement will be + // disabled by go/api-docgen. + DisableReplacementWords string `json:"disableReplacementWords,omitempty"` + // Selector: The selector is a comma-separated list of patterns for any // element such as a method, a field, an enum value. Each pattern is a // qualified name of the element which may end in "*", indicating a @@ -4575,6 +4580,8 @@ type Publishing struct { // "STREET_VIEW" - Street View Org. // "SHOPPING" - Shopping Org. // "GEO" - Geo Org. + // "GENERATIVE_AI" - Generative AI - + // https://developers.generativeai.google Organization string `json:"organization,omitempty"` // ProtoReferenceDocumentationUri: Optional link to proto reference diff --git a/spanner/v1/spanner-api.json b/spanner/v1/spanner-api.json index 504400fa9be..ac149eed2e8 100644 --- a/spanner/v1/spanner-api.json +++ b/spanner/v1/spanner-api.json @@ -2247,6 +2247,134 @@ } } }, + "instancePartitions": { + "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}/instances/{instancesId}/instancePartitions/{instancePartitionsId}/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "spanner.projects.instances.instancePartitions.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^projects/[^/]+/instances/[^/]+/instancePartitions/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:cancel", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/spanner.admin" + ] + }, + "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}/instances/{instancesId}/instancePartitions/{instancePartitionsId}/operations/{operationsId}", + "httpMethod": "DELETE", + "id": "spanner.projects.instances.instancePartitions.operations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be deleted.", + "location": "path", + "pattern": "^projects/[^/]+/instances/[^/]+/instancePartitions/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/spanner.admin" + ] + }, + "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}/instances/{instancesId}/instancePartitions/{instancePartitionsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "spanner.projects.instances.instancePartitions.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/instances/[^/]+/instancePartitions/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/spanner.admin" + ] + }, + "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}/instances/{instancesId}/instancePartitions/{instancePartitionsId}/operations", + "httpMethod": "GET", + "id": "spanner.projects.instances.instancePartitions.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/[^/]+/instances/[^/]+/instancePartitions/[^/]+/operations$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/spanner.admin" + ] + } + } + } + } + }, "operations": { "methods": { "cancel": { @@ -2437,7 +2565,7 @@ } } }, - "revision": "20230403", + "revision": "20230429", "rootUrl": "https://spanner.googleapis.com/", "schemas": { "Backup": { diff --git a/spanner/v1/spanner-gen.go b/spanner/v1/spanner-gen.go index fd2868d3d5a..da2ea4b4b37 100644 --- a/spanner/v1/spanner-gen.go +++ b/spanner/v1/spanner-gen.go @@ -209,6 +209,7 @@ func NewProjectsInstancesService(s *Service) *ProjectsInstancesService { rs.Backups = NewProjectsInstancesBackupsService(s) rs.DatabaseOperations = NewProjectsInstancesDatabaseOperationsService(s) rs.Databases = NewProjectsInstancesDatabasesService(s) + rs.InstancePartitions = NewProjectsInstancesInstancePartitionsService(s) rs.Operations = NewProjectsInstancesOperationsService(s) return rs } @@ -224,6 +225,8 @@ type ProjectsInstancesService struct { Databases *ProjectsInstancesDatabasesService + InstancePartitions *ProjectsInstancesInstancePartitionsService + Operations *ProjectsInstancesOperationsService } @@ -311,6 +314,27 @@ type ProjectsInstancesDatabasesSessionsService struct { s *Service } +func NewProjectsInstancesInstancePartitionsService(s *Service) *ProjectsInstancesInstancePartitionsService { + rs := &ProjectsInstancesInstancePartitionsService{s: s} + rs.Operations = NewProjectsInstancesInstancePartitionsOperationsService(s) + return rs +} + +type ProjectsInstancesInstancePartitionsService struct { + s *Service + + Operations *ProjectsInstancesInstancePartitionsOperationsService +} + +func NewProjectsInstancesInstancePartitionsOperationsService(s *Service) *ProjectsInstancesInstancePartitionsOperationsService { + rs := &ProjectsInstancesInstancePartitionsOperationsService{s: s} + return rs +} + +type ProjectsInstancesInstancePartitionsOperationsService struct { + s *Service +} + func NewProjectsInstancesOperationsService(s *Service) *ProjectsInstancesOperationsService { rs := &ProjectsInstancesOperationsService{s: s} return rs @@ -17092,6 +17116,640 @@ func (c *ProjectsInstancesDatabasesSessionsStreamingReadCall) Do(opts ...googlea } +// method id "spanner.projects.instances.instancePartitions.operations.cancel": + +type ProjectsInstancesInstancePartitionsOperationsCancelCall 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 *ProjectsInstancesInstancePartitionsOperationsService) Cancel(name string) *ProjectsInstancesInstancePartitionsOperationsCancelCall { + c := &ProjectsInstancesInstancePartitionsOperationsCancelCall{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 information. +func (c *ProjectsInstancesInstancePartitionsOperationsCancelCall) Fields(s ...googleapi.Field) *ProjectsInstancesInstancePartitionsOperationsCancelCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsInstancesInstancePartitionsOperationsCancelCall) Context(ctx context.Context) *ProjectsInstancesInstancePartitionsOperationsCancelCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsInstancesInstancePartitionsOperationsCancelCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsInstancesInstancePartitionsOperationsCancelCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "spanner.projects.instances.instancePartitions.operations.cancel" call. +// Exactly one of *Empty or error will be non-nil. 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 *ProjectsInstancesInstancePartitionsOperationsCancelCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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}/instances/{instancesId}/instancePartitions/{instancePartitionsId}/operations/{operationsId}:cancel", + // "httpMethod": "POST", + // "id": "spanner.projects.instances.instancePartitions.operations.cancel", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource to be cancelled.", + // "location": "path", + // "pattern": "^projects/[^/]+/instances/[^/]+/instancePartitions/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}:cancel", + // "response": { + // "$ref": "Empty" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/spanner.admin" + // ] + // } + +} + +// method id "spanner.projects.instances.instancePartitions.operations.delete": + +type ProjectsInstancesInstancePartitionsOperationsDeleteCall 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 *ProjectsInstancesInstancePartitionsOperationsService) Delete(name string) *ProjectsInstancesInstancePartitionsOperationsDeleteCall { + c := &ProjectsInstancesInstancePartitionsOperationsDeleteCall{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 information. +func (c *ProjectsInstancesInstancePartitionsOperationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsInstancesInstancePartitionsOperationsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsInstancesInstancePartitionsOperationsDeleteCall) Context(ctx context.Context) *ProjectsInstancesInstancePartitionsOperationsDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsInstancesInstancePartitionsOperationsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsInstancesInstancePartitionsOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "spanner.projects.instances.instancePartitions.operations.delete" call. +// Exactly one of *Empty or error will be non-nil. 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 *ProjectsInstancesInstancePartitionsOperationsDeleteCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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}/instances/{instancesId}/instancePartitions/{instancePartitionsId}/operations/{operationsId}", + // "httpMethod": "DELETE", + // "id": "spanner.projects.instances.instancePartitions.operations.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource to be deleted.", + // "location": "path", + // "pattern": "^projects/[^/]+/instances/[^/]+/instancePartitions/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Empty" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/spanner.admin" + // ] + // } + +} + +// method id "spanner.projects.instances.instancePartitions.operations.get": + +type ProjectsInstancesInstancePartitionsOperationsGetCall 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 *ProjectsInstancesInstancePartitionsOperationsService) Get(name string) *ProjectsInstancesInstancePartitionsOperationsGetCall { + c := &ProjectsInstancesInstancePartitionsOperationsGetCall{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 information. +func (c *ProjectsInstancesInstancePartitionsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsInstancesInstancePartitionsOperationsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsInstancesInstancePartitionsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsInstancesInstancePartitionsOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsInstancesInstancePartitionsOperationsGetCall) Context(ctx context.Context) *ProjectsInstancesInstancePartitionsOperationsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsInstancesInstancePartitionsOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsInstancesInstancePartitionsOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "spanner.projects.instances.instancePartitions.operations.get" call. +// Exactly one of *Operation or error will be non-nil. 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 *ProjectsInstancesInstancePartitionsOperationsGetCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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}/instances/{instancesId}/instancePartitions/{instancePartitionsId}/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "spanner.projects.instances.instancePartitions.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/instances/[^/]+/instancePartitions/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/spanner.admin" + // ] + // } + +} + +// method id "spanner.projects.instances.instancePartitions.operations.list": + +type ProjectsInstancesInstancePartitionsOperationsListCall 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 *ProjectsInstancesInstancePartitionsOperationsService) List(name string) *ProjectsInstancesInstancePartitionsOperationsListCall { + c := &ProjectsInstancesInstancePartitionsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *ProjectsInstancesInstancePartitionsOperationsListCall) Filter(filter string) *ProjectsInstancesInstancePartitionsOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *ProjectsInstancesInstancePartitionsOperationsListCall) PageSize(pageSize int64) *ProjectsInstancesInstancePartitionsOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *ProjectsInstancesInstancePartitionsOperationsListCall) PageToken(pageToken string) *ProjectsInstancesInstancePartitionsOperationsListCall { + 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 information. +func (c *ProjectsInstancesInstancePartitionsOperationsListCall) Fields(s ...googleapi.Field) *ProjectsInstancesInstancePartitionsOperationsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsInstancesInstancePartitionsOperationsListCall) IfNoneMatch(entityTag string) *ProjectsInstancesInstancePartitionsOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsInstancesInstancePartitionsOperationsListCall) Context(ctx context.Context) *ProjectsInstancesInstancePartitionsOperationsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsInstancesInstancePartitionsOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsInstancesInstancePartitionsOperationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + 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, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "spanner.projects.instances.instancePartitions.operations.list" call. +// Exactly one of *ListOperationsResponse or error will be non-nil. 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 *ProjectsInstancesInstancePartitionsOperationsListCall) 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 + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "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}/instances/{instancesId}/instancePartitions/{instancePartitionsId}/operations", + // "httpMethod": "GET", + // "id": "spanner.projects.instances.instancePartitions.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/[^/]+/instances/[^/]+/instancePartitions/[^/]+/operations$", + // "required": true, + // "type": "string" + // }, + // "pageSize": { + // "description": "The standard list page size.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The standard list page token.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "ListOperationsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/spanner.admin" + // ] + // } + +} + +// 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 *ProjectsInstancesInstancePartitionsOperationsListCall) Pages(ctx context.Context, f func(*ListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + // method id "spanner.projects.instances.operations.cancel": type ProjectsInstancesOperationsCancelCall struct { diff --git a/sqladmin/v1/sqladmin-api.json b/sqladmin/v1/sqladmin-api.json index 9c5c788090f..b3ad8a20681 100644 --- a/sqladmin/v1/sqladmin-api.json +++ b/sqladmin/v1/sqladmin-api.json @@ -428,7 +428,7 @@ ] }, "insert": { - "description": "Inserts a resource containing information about a database inside a Cloud SQL instance.", + "description": "Inserts a resource containing information about a database inside a Cloud SQL instance. **Note:** You can't modify the default character set and collation.", "flatPath": "v1/projects/{project}/instances/{instance}/databases", "httpMethod": "POST", "id": "sql.databases.insert", @@ -2023,7 +2023,7 @@ } } }, - "revision": "20230405", + "revision": "20230422", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -2377,6 +2377,10 @@ "description": "Timestamp, if specified, identifies the time to which the source instance is cloned.", "format": "google-datetime", "type": "string" + }, + "preferredZone": { + "description": "(Point-in-time recovery for PostgreSQL only) Clone to an instance in the specified zone. If no zone is specified, clone to the same zone as the source instance.", + "type": "string" } }, "type": "object" @@ -2419,6 +2423,7 @@ "POSTGRES_12", "POSTGRES_13", "POSTGRES_14", + "POSTGRES_15", "MYSQL_8_0", "MYSQL_8_0_18", "MYSQL_8_0_26", @@ -2453,6 +2458,7 @@ "The database version is PostgreSQL 12.", "The database version is PostgreSQL 13.", "The database version is PostgreSQL 14.", + "The database version is PostgreSQL 15.", "The database version is MySQL 8.", "The database major version is MySQL 8.0 and the minor version is 18.", "The database major version is MySQL 8.0 and the minor version is 26.", @@ -2618,6 +2624,7 @@ "POSTGRES_12", "POSTGRES_13", "POSTGRES_14", + "POSTGRES_15", "MYSQL_8_0", "MYSQL_8_0_18", "MYSQL_8_0_26", @@ -2652,6 +2659,7 @@ "The database version is PostgreSQL 12.", "The database version is PostgreSQL 13.", "The database version is PostgreSQL 14.", + "The database version is PostgreSQL 15.", "The database version is MySQL 8.", "The database major version is MySQL 8.0 and the minor version is 18.", "The database major version is MySQL 8.0 and the minor version is 26.", @@ -3162,6 +3170,7 @@ "POSTGRES_12", "POSTGRES_13", "POSTGRES_14", + "POSTGRES_15", "MYSQL_8_0", "MYSQL_8_0_18", "MYSQL_8_0_26", @@ -3196,6 +3205,7 @@ "The database version is PostgreSQL 12.", "The database version is PostgreSQL 13.", "The database version is PostgreSQL 14.", + "The database version is PostgreSQL 15.", "The database version is MySQL 8.", "The database major version is MySQL 8.0 and the minor version is 18.", "The database major version is MySQL 8.0 and the minor version is 26.", @@ -4579,6 +4589,10 @@ "description": "This is always `sql#getDiskShrinkConfig`.", "type": "string" }, + "message": { + "description": "Additional message to customers.", + "type": "string" + }, "minimalTargetSizeGb": { "description": "The minimum size to which a disk can be shrunk in GigaBytes.", "format": "int64", diff --git a/sqladmin/v1/sqladmin-gen.go b/sqladmin/v1/sqladmin-gen.go index 3413cd374ed..76c67454476 100644 --- a/sqladmin/v1/sqladmin-gen.go +++ b/sqladmin/v1/sqladmin-gen.go @@ -753,6 +753,11 @@ type CloneContext struct { // the source instance is cloned. PointInTime string `json:"pointInTime,omitempty"` + // PreferredZone: (Point-in-time recovery for PostgreSQL only) Clone to + // an instance in the specified zone. If no zone is specified, clone to + // the same zone as the source instance. + PreferredZone string `json:"preferredZone,omitempty"` + // ForceSendFields is a list of field names (e.g. "AllocatedIpRange") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -823,6 +828,7 @@ type ConnectSettings struct { // "POSTGRES_12" - The database version is PostgreSQL 12. // "POSTGRES_13" - The database version is PostgreSQL 13. // "POSTGRES_14" - The database version is PostgreSQL 14. + // "POSTGRES_15" - The database version is PostgreSQL 15. // "MYSQL_8_0" - The database version is MySQL 8. // "MYSQL_8_0_18" - The database major version is MySQL 8.0 and the // minor version is 18. @@ -1059,6 +1065,7 @@ type DatabaseInstance struct { // "POSTGRES_12" - The database version is PostgreSQL 12. // "POSTGRES_13" - The database version is PostgreSQL 13. // "POSTGRES_14" - The database version is PostgreSQL 14. + // "POSTGRES_15" - The database version is PostgreSQL 15. // "MYSQL_8_0" - The database version is MySQL 8. // "MYSQL_8_0_18" - The database major version is MySQL 8.0 and the // minor version is 18. @@ -1885,6 +1892,7 @@ type Flag struct { // "POSTGRES_12" - The database version is PostgreSQL 12. // "POSTGRES_13" - The database version is PostgreSQL 13. // "POSTGRES_14" - The database version is PostgreSQL 14. + // "POSTGRES_15" - The database version is PostgreSQL 15. // "MYSQL_8_0" - The database version is MySQL 8. // "MYSQL_8_0_18" - The database major version is MySQL 8.0 and the // minor version is 18. @@ -3958,6 +3966,9 @@ type SqlInstancesGetDiskShrinkConfigResponse struct { // Kind: This is always `sql#getDiskShrinkConfig`. Kind string `json:"kind,omitempty"` + // Message: Additional message to customers. + Message string `json:"message,omitempty"` + // MinimalTargetSizeGb: The minimum size to which a disk can be shrunk // in GigaBytes. MinimalTargetSizeGb int64 `json:"minimalTargetSizeGb,omitempty,string"` @@ -6243,7 +6254,8 @@ type DatabasesInsertCall struct { } // Insert: Inserts a resource containing information about a database -// inside a Cloud SQL instance. +// inside a Cloud SQL instance. **Note:** You can't modify the default +// character set and collation. // // - instance: Database instance ID. This does not include the project // ID. @@ -6348,7 +6360,7 @@ func (c *DatabasesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, erro } return ret, nil // { - // "description": "Inserts a resource containing information about a database inside a Cloud SQL instance.", + // "description": "Inserts a resource containing information about a database inside a Cloud SQL instance. **Note:** You can't modify the default character set and collation.", // "flatPath": "v1/projects/{project}/instances/{instance}/databases", // "httpMethod": "POST", // "id": "sql.databases.insert", diff --git a/sqladmin/v1beta4/sqladmin-api.json b/sqladmin/v1beta4/sqladmin-api.json index a6399f5ec0d..11be0934b0c 100644 --- a/sqladmin/v1beta4/sqladmin-api.json +++ b/sqladmin/v1beta4/sqladmin-api.json @@ -428,7 +428,7 @@ ] }, "insert": { - "description": "Inserts a resource containing information about a database inside a Cloud SQL instance.", + "description": "Inserts a resource containing information about a database inside a Cloud SQL instance. **Note:** You can't modify the default character set and collation.", "flatPath": "sql/v1beta4/projects/{project}/instances/{instance}/databases", "httpMethod": "POST", "id": "sql.databases.insert", @@ -2023,7 +2023,7 @@ } } }, - "revision": "20230405", + "revision": "20230422", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -2377,6 +2377,10 @@ "description": "Timestamp, if specified, identifies the time to which the source instance is cloned.", "format": "google-datetime", "type": "string" + }, + "preferredZone": { + "description": "(Point-in-time recovery for PostgreSQL only) Clone to an instance in the specified zone. If no zone is specified, clone to the same zone as the source instance.", + "type": "string" } }, "type": "object" @@ -2419,6 +2423,7 @@ "POSTGRES_12", "POSTGRES_13", "POSTGRES_14", + "POSTGRES_15", "MYSQL_8_0", "MYSQL_8_0_18", "MYSQL_8_0_26", @@ -2453,6 +2458,7 @@ "The database version is PostgreSQL 12.", "The database version is PostgreSQL 13.", "The database version is PostgreSQL 14.", + "The database version is PostgreSQL 15.", "The database version is MySQL 8.", "The database major version is MySQL 8.0 and the minor version is 18.", "The database major version is MySQL 8.0 and the minor version is 26.", @@ -2618,6 +2624,7 @@ "POSTGRES_12", "POSTGRES_13", "POSTGRES_14", + "POSTGRES_15", "MYSQL_8_0", "MYSQL_8_0_18", "MYSQL_8_0_26", @@ -2652,6 +2659,7 @@ "The database version is PostgreSQL 12.", "The database version is PostgreSQL 13.", "The database version is PostgreSQL 14.", + "The database version is PostgreSQL 15.", "The database version is MySQL 8.", "The database major version is MySQL 8.0 and the minor version is 18.", "The database major version is MySQL 8.0 and the minor version is 26.", @@ -3162,6 +3170,7 @@ "POSTGRES_12", "POSTGRES_13", "POSTGRES_14", + "POSTGRES_15", "MYSQL_8_0", "MYSQL_8_0_18", "MYSQL_8_0_26", @@ -3196,6 +3205,7 @@ "The database version is PostgreSQL 12.", "The database version is PostgreSQL 13.", "The database version is PostgreSQL 14.", + "The database version is PostgreSQL 15.", "The database version is MySQL 8.", "The database major version is MySQL 8.0 and the minor version is 18.", "The database major version is MySQL 8.0 and the minor version is 26.", @@ -4579,6 +4589,10 @@ "description": "This is always `sql#getDiskShrinkConfig`.", "type": "string" }, + "message": { + "description": "Additional message to customers.", + "type": "string" + }, "minimalTargetSizeGb": { "description": "The minimum size to which a disk can be shrunk in GigaBytes.", "format": "int64", diff --git a/sqladmin/v1beta4/sqladmin-gen.go b/sqladmin/v1beta4/sqladmin-gen.go index e03d5fdefbc..79b80f4ecca 100644 --- a/sqladmin/v1beta4/sqladmin-gen.go +++ b/sqladmin/v1beta4/sqladmin-gen.go @@ -753,6 +753,11 @@ type CloneContext struct { // the source instance is cloned. PointInTime string `json:"pointInTime,omitempty"` + // PreferredZone: (Point-in-time recovery for PostgreSQL only) Clone to + // an instance in the specified zone. If no zone is specified, clone to + // the same zone as the source instance. + PreferredZone string `json:"preferredZone,omitempty"` + // ForceSendFields is a list of field names (e.g. "AllocatedIpRange") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -823,6 +828,7 @@ type ConnectSettings struct { // "POSTGRES_12" - The database version is PostgreSQL 12. // "POSTGRES_13" - The database version is PostgreSQL 13. // "POSTGRES_14" - The database version is PostgreSQL 14. + // "POSTGRES_15" - The database version is PostgreSQL 15. // "MYSQL_8_0" - The database version is MySQL 8. // "MYSQL_8_0_18" - The database major version is MySQL 8.0 and the // minor version is 18. @@ -1058,6 +1064,7 @@ type DatabaseInstance struct { // "POSTGRES_12" - The database version is PostgreSQL 12. // "POSTGRES_13" - The database version is PostgreSQL 13. // "POSTGRES_14" - The database version is PostgreSQL 14. + // "POSTGRES_15" - The database version is PostgreSQL 15. // "MYSQL_8_0" - The database version is MySQL 8. // "MYSQL_8_0_18" - The database major version is MySQL 8.0 and the // minor version is 18. @@ -1884,6 +1891,7 @@ type Flag struct { // "POSTGRES_12" - The database version is PostgreSQL 12. // "POSTGRES_13" - The database version is PostgreSQL 13. // "POSTGRES_14" - The database version is PostgreSQL 14. + // "POSTGRES_15" - The database version is PostgreSQL 15. // "MYSQL_8_0" - The database version is MySQL 8. // "MYSQL_8_0_18" - The database major version is MySQL 8.0 and the // minor version is 18. @@ -3957,6 +3965,9 @@ type SqlInstancesGetDiskShrinkConfigResponse struct { // Kind: This is always `sql#getDiskShrinkConfig`. Kind string `json:"kind,omitempty"` + // Message: Additional message to customers. + Message string `json:"message,omitempty"` + // MinimalTargetSizeGb: The minimum size to which a disk can be shrunk // in GigaBytes. MinimalTargetSizeGb int64 `json:"minimalTargetSizeGb,omitempty,string"` @@ -6238,7 +6249,8 @@ type DatabasesInsertCall struct { } // Insert: Inserts a resource containing information about a database -// inside a Cloud SQL instance. +// inside a Cloud SQL instance. **Note:** You can't modify the default +// character set and collation. // // - instance: Database instance ID. This does not include the project // ID. @@ -6343,7 +6355,7 @@ func (c *DatabasesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, erro } return ret, nil // { - // "description": "Inserts a resource containing information about a database inside a Cloud SQL instance.", + // "description": "Inserts a resource containing information about a database inside a Cloud SQL instance. **Note:** You can't modify the default character set and collation.", // "flatPath": "sql/v1beta4/projects/{project}/instances/{instance}/databases", // "httpMethod": "POST", // "id": "sql.databases.insert", diff --git a/testing/v1/testing-api.json b/testing/v1/testing-api.json index a116723ad72..e5768b7aa7d 100644 --- a/testing/v1/testing-api.json +++ b/testing/v1/testing-api.json @@ -282,7 +282,7 @@ } } }, - "revision": "20230411", + "revision": "20230503", "rootUrl": "https://testing.googleapis.com/", "schemas": { "Account": { @@ -1721,6 +1721,10 @@ "$ref": "ManualSharding", "description": "Shards test cases into the specified groups of packages, classes, and/or methods." }, + "smartSharding": { + "$ref": "SmartSharding", + "description": "Shards test based on previous test case timing records." + }, "uniformSharding": { "$ref": "UniformSharding", "description": "Uniformly shards test cases given a total number of shards." @@ -1728,6 +1732,18 @@ }, "type": "object" }, + "SmartSharding": { + "description": "Shards test based on previous test case timing records.", + "id": "SmartSharding", + "properties": { + "targetedShardDuration": { + "description": "The amount of time tests within a shard should take. Default: 300 seconds (5 minutes). The minimum allowed: 120 seconds (2 minutes). The shard count is dynamically set based on time, up to the maximum shard limit (described below). To guarantee at least one test case for each shard, the number of shards will not exceed the number of test cases. Shard duration will be exceeded if: - The maximum shard limit is reached and there is more calculated test time remaining to allocate into shards. - Any individual test is estimated to be longer than the targeted shard duration. Shard duration is not guaranteed because smart sharding uses test case history and default durations which may not be accurate. The rules for finding the test case timing records are: - If the service has seen a test case in the last 30 days, the record of the latest successful one will be used. - For new test cases, the average duration of other known test cases will be used. - If there are no previous test case timing records available, the test case is considered to be 15 seconds long by default. Because the actual shard duration can exceed the targeted shard duration, we recommend setting the targeted value at least 5 minutes less than the maximum allowed test timeout (45 minutes for physical devices and 60 minutes for virtual), or using the custom test timeout value you set. This approach avoids cancelling the shard before all tests can finish. Note that there is a limit for maximum number of shards. When you select one or more physical devices, the number of shards must be \u003c= 50. When you select one or more ARM virtual devices, it must be \u003c= 100. When you select only x86 virtual devices, it must be \u003c= 500. To guarantee at least one test case for per shard, the number of shards will not exceed the number of test cases. Each shard created will count toward daily test quota.", + "format": "google-duration", + "type": "string" + } + }, + "type": "object" + }, "StartActivityIntent": { "description": "A starting intent specified by an action, uri, and categories.", "id": "StartActivityIntent", diff --git a/testing/v1/testing-gen.go b/testing/v1/testing-gen.go index 203a3148a4b..f39f999e859 100644 --- a/testing/v1/testing-gen.go +++ b/testing/v1/testing-gen.go @@ -2556,6 +2556,10 @@ type ShardingOption struct { // packages, classes, and/or methods. ManualSharding *ManualSharding `json:"manualSharding,omitempty"` + // SmartSharding: Shards test based on previous test case timing + // records. + SmartSharding *SmartSharding `json:"smartSharding,omitempty"` + // UniformSharding: Uniformly shards test cases given a total number of // shards. UniformSharding *UniformSharding `json:"uniformSharding,omitempty"` @@ -2584,6 +2588,65 @@ func (s *ShardingOption) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// SmartSharding: Shards test based on previous test case timing +// records. +type SmartSharding struct { + // TargetedShardDuration: The amount of time tests within a shard should + // take. Default: 300 seconds (5 minutes). The minimum allowed: 120 + // seconds (2 minutes). The shard count is dynamically set based on + // time, up to the maximum shard limit (described below). To guarantee + // at least one test case for each shard, the number of shards will not + // exceed the number of test cases. Shard duration will be exceeded if: + // - The maximum shard limit is reached and there is more calculated + // test time remaining to allocate into shards. - Any individual test is + // estimated to be longer than the targeted shard duration. Shard + // duration is not guaranteed because smart sharding uses test case + // history and default durations which may not be accurate. The rules + // for finding the test case timing records are: - If the service has + // seen a test case in the last 30 days, the record of the latest + // successful one will be used. - For new test cases, the average + // duration of other known test cases will be used. - If there are no + // previous test case timing records available, the test case is + // considered to be 15 seconds long by default. Because the actual shard + // duration can exceed the targeted shard duration, we recommend setting + // the targeted value at least 5 minutes less than the maximum allowed + // test timeout (45 minutes for physical devices and 60 minutes for + // virtual), or using the custom test timeout value you set. This + // approach avoids cancelling the shard before all tests can finish. + // Note that there is a limit for maximum number of shards. When you + // select one or more physical devices, the number of shards must be <= + // 50. When you select one or more ARM virtual devices, it must be <= + // 100. When you select only x86 virtual devices, it must be <= 500. To + // guarantee at least one test case for per shard, the number of shards + // will not exceed the number of test cases. Each shard created will + // count toward daily test quota. + TargetedShardDuration string `json:"targetedShardDuration,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "TargetedShardDuration") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "TargetedShardDuration") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *SmartSharding) MarshalJSON() ([]byte, error) { + type NoMethod SmartSharding + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // StartActivityIntent: A starting intent specified by an action, uri, // and categories. type StartActivityIntent struct { diff --git a/texttospeech/v1/texttospeech-api.json b/texttospeech/v1/texttospeech-api.json index cbecb52ee58..1a8d88cc27c 100644 --- a/texttospeech/v1/texttospeech-api.json +++ b/texttospeech/v1/texttospeech-api.json @@ -318,7 +318,7 @@ } } }, - "revision": "20230403", + "revision": "20230427", "rootUrl": "https://texttospeech.googleapis.com/", "schemas": { "AudioConfig": { @@ -565,15 +565,15 @@ }, "input": { "$ref": "SynthesisInput", - "description": "Required. The Synthesizer requires either plain text or SSML as input." + "description": "Required. The Synthesizer requires either plain text or SSML as input. While Long Audio is in preview, SSML is temporarily unsupported." }, "outputGcsUri": { - "description": "Specifies a Cloud Storage URI for the synthesis results. Must be specified in the format: `gs://bucket_name/object_name`, and the bucket must already exist.", + "description": "Required. Specifies a Cloud Storage URI for the synthesis results. Must be specified in the format: `gs://bucket_name/object_name`, and the bucket must already exist.", "type": "string" }, "voice": { "$ref": "VoiceSelectionParams", - "description": "The desired voice of the synthesized audio." + "description": "Required. The desired voice of the synthesized audio." } }, "type": "object" diff --git a/texttospeech/v1/texttospeech-gen.go b/texttospeech/v1/texttospeech-gen.go index e0bed256776..4f2b1525218 100644 --- a/texttospeech/v1/texttospeech-gen.go +++ b/texttospeech/v1/texttospeech-gen.go @@ -690,15 +690,16 @@ type SynthesizeLongAudioRequest struct { AudioConfig *AudioConfig `json:"audioConfig,omitempty"` // Input: Required. The Synthesizer requires either plain text or SSML - // as input. + // as input. While Long Audio is in preview, SSML is temporarily + // unsupported. Input *SynthesisInput `json:"input,omitempty"` - // OutputGcsUri: Specifies a Cloud Storage URI for the synthesis - // results. Must be specified in the format: + // OutputGcsUri: Required. Specifies a Cloud Storage URI for the + // synthesis results. Must be specified in the format: // `gs://bucket_name/object_name`, and the bucket must already exist. OutputGcsUri string `json:"outputGcsUri,omitempty"` - // Voice: The desired voice of the synthesized audio. + // Voice: Required. The desired voice of the synthesized audio. Voice *VoiceSelectionParams `json:"voice,omitempty"` // ForceSendFields is a list of field names (e.g. "AudioConfig") to diff --git a/texttospeech/v1beta1/texttospeech-api.json b/texttospeech/v1beta1/texttospeech-api.json index 6148dd69dc9..dccbbe40f7a 100644 --- a/texttospeech/v1beta1/texttospeech-api.json +++ b/texttospeech/v1beta1/texttospeech-api.json @@ -261,7 +261,7 @@ } } }, - "revision": "20230403", + "revision": "20230427", "rootUrl": "https://texttospeech.googleapis.com/", "schemas": { "AudioConfig": { @@ -498,15 +498,15 @@ }, "input": { "$ref": "SynthesisInput", - "description": "Required. The Synthesizer requires either plain text or SSML as input." + "description": "Required. The Synthesizer requires either plain text or SSML as input. While Long Audio is in preview, SSML is temporarily unsupported." }, "outputGcsUri": { - "description": "Specifies a Cloud Storage URI for the synthesis results. Must be specified in the format: `gs://bucket_name/object_name`, and the bucket must already exist.", + "description": "Required. Specifies a Cloud Storage URI for the synthesis results. Must be specified in the format: `gs://bucket_name/object_name`, and the bucket must already exist.", "type": "string" }, "voice": { "$ref": "VoiceSelectionParams", - "description": "The desired voice of the synthesized audio." + "description": "Required. The desired voice of the synthesized audio." } }, "type": "object" diff --git a/texttospeech/v1beta1/texttospeech-gen.go b/texttospeech/v1beta1/texttospeech-gen.go index 15609a3f5e5..49d62bd7242 100644 --- a/texttospeech/v1beta1/texttospeech-gen.go +++ b/texttospeech/v1beta1/texttospeech-gen.go @@ -663,15 +663,16 @@ type SynthesizeLongAudioRequest struct { AudioConfig *AudioConfig `json:"audioConfig,omitempty"` // Input: Required. The Synthesizer requires either plain text or SSML - // as input. + // as input. While Long Audio is in preview, SSML is temporarily + // unsupported. Input *SynthesisInput `json:"input,omitempty"` - // OutputGcsUri: Specifies a Cloud Storage URI for the synthesis - // results. Must be specified in the format: + // OutputGcsUri: Required. Specifies a Cloud Storage URI for the + // synthesis results. Must be specified in the format: // `gs://bucket_name/object_name`, and the bucket must already exist. OutputGcsUri string `json:"outputGcsUri,omitempty"` - // Voice: The desired voice of the synthesized audio. + // Voice: Required. The desired voice of the synthesized audio. Voice *VoiceSelectionParams `json:"voice,omitempty"` // ForceSendFields is a list of field names (e.g. "AudioConfig") to diff --git a/tpu/v1/tpu-api.json b/tpu/v1/tpu-api.json index ab54ab2abad..820cbf9681d 100644 --- a/tpu/v1/tpu-api.json +++ b/tpu/v1/tpu-api.json @@ -659,7 +659,7 @@ } } }, - "revision": "20230323", + "revision": "20230420", "rootUrl": "https://tpu.googleapis.com/", "schemas": { "AcceleratorType": { @@ -795,7 +795,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/tpu/v1/tpu-gen.go b/tpu/v1/tpu-gen.go index fd9e88e8700..733464667d2 100644 --- a/tpu/v1/tpu-gen.go +++ b/tpu/v1/tpu-gen.go @@ -443,7 +443,7 @@ func (s *ListTensorFlowVersionsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/tpu/v1alpha1/tpu-api.json b/tpu/v1alpha1/tpu-api.json index e9913ac7c7d..a44f9d34351 100644 --- a/tpu/v1alpha1/tpu-api.json +++ b/tpu/v1alpha1/tpu-api.json @@ -669,7 +669,7 @@ } } }, - "revision": "20230323", + "revision": "20230420", "rootUrl": "https://tpu.googleapis.com/", "schemas": { "AcceleratorType": { @@ -805,7 +805,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/tpu/v1alpha1/tpu-gen.go b/tpu/v1alpha1/tpu-gen.go index cc72d07b3f4..1620bebe7f1 100644 --- a/tpu/v1alpha1/tpu-gen.go +++ b/tpu/v1alpha1/tpu-gen.go @@ -443,7 +443,7 @@ func (s *ListTensorFlowVersionsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/tpu/v2/tpu-api.json b/tpu/v2/tpu-api.json index 1ba4ef4dde9..10902216e88 100644 --- a/tpu/v2/tpu-api.json +++ b/tpu/v2/tpu-api.json @@ -721,7 +721,7 @@ } } }, - "revision": "20230323", + "revision": "20230420", "rootUrl": "https://tpu.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -1025,7 +1025,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/tpu/v2/tpu-gen.go b/tpu/v2/tpu-gen.go index 1f34fbaec51..5e91fe545a0 100644 --- a/tpu/v2/tpu-gen.go +++ b/tpu/v2/tpu-gen.go @@ -750,7 +750,7 @@ func (s *ListRuntimeVersionsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/tpu/v2alpha1/tpu-api.json b/tpu/v2alpha1/tpu-api.json index 1ecf9c95719..7988a95cd17 100644 --- a/tpu/v2alpha1/tpu-api.json +++ b/tpu/v2alpha1/tpu-api.json @@ -892,7 +892,7 @@ } } }, - "revision": "20230410", + "revision": "20230420", "rootUrl": "https://tpu.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -1295,7 +1295,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/tpu/v2alpha1/tpu-gen.go b/tpu/v2alpha1/tpu-gen.go index af00a67ee35..5224890519b 100644 --- a/tpu/v2alpha1/tpu-gen.go +++ b/tpu/v2alpha1/tpu-gen.go @@ -921,7 +921,7 @@ func (s *ListRuntimeVersionsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/transcoder/v1/transcoder-api.json b/transcoder/v1/transcoder-api.json index 9c129a987ac..f9288e57eda 100644 --- a/transcoder/v1/transcoder-api.json +++ b/transcoder/v1/transcoder-api.json @@ -385,7 +385,7 @@ } } }, - "revision": "20230412", + "revision": "20230426", "rootUrl": "https://transcoder.googleapis.com/", "schemas": { "AdBreak": { @@ -1242,7 +1242,7 @@ "type": "array" }, "type": { - "description": "Required. Type of the manifest, can be `HLS` or `DASH`.", + "description": "Required. Type of the manifest.", "enum": [ "MANIFEST_TYPE_UNSPECIFIED", "HLS", @@ -1250,8 +1250,8 @@ ], "enumDescriptions": [ "The manifest type is not specified.", - "Create `HLS` manifest. The corresponding file extension is `.m3u8`.", - "Create `DASH` manifest. The corresponding file extension is `.mpd`." + "Create an HLS manifest. The corresponding file extension is `.m3u8`.", + "Create an MPEG-DASH manifest. The corresponding file extension is `.mpd`." ], "type": "string" } diff --git a/transcoder/v1/transcoder-gen.go b/transcoder/v1/transcoder-gen.go index a8d3a3aba85..d4d171bbe02 100644 --- a/transcoder/v1/transcoder-gen.go +++ b/transcoder/v1/transcoder-gen.go @@ -1623,14 +1623,14 @@ type Manifest struct { // for each element of the `Manifest.mux_streams`. MuxStreams []string `json:"muxStreams,omitempty"` - // Type: Required. Type of the manifest, can be `HLS` or `DASH`. + // Type: Required. Type of the manifest. // // Possible values: // "MANIFEST_TYPE_UNSPECIFIED" - The manifest type is not specified. - // "HLS" - Create `HLS` manifest. The corresponding file extension is + // "HLS" - Create an HLS manifest. The corresponding file extension is // `.m3u8`. - // "DASH" - Create `DASH` manifest. The corresponding file extension - // is `.mpd`. + // "DASH" - Create an MPEG-DASH manifest. The corresponding file + // extension is `.mpd`. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "FileName") to diff --git a/translate/v3/translate-api.json b/translate/v3/translate-api.json index 6b359b60af7..5dce3ab704e 100644 --- a/translate/v3/translate-api.json +++ b/translate/v3/translate-api.json @@ -1286,7 +1286,7 @@ } } }, - "revision": "20230407", + "revision": "20230428", "rootUrl": "https://translation.googleapis.com/", "schemas": { "BatchDocumentInputConfig": { @@ -2029,7 +2029,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/translate/v3/translate-gen.go b/translate/v3/translate-gen.go index 97e54c698e9..de5467271fb 100644 --- a/translate/v3/translate-gen.go +++ b/translate/v3/translate-gen.go @@ -1786,7 +1786,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/translate/v3beta1/translate-api.json b/translate/v3beta1/translate-api.json index 536aef1f4f3..8d3c66086e6 100644 --- a/translate/v3beta1/translate-api.json +++ b/translate/v3beta1/translate-api.json @@ -744,7 +744,7 @@ } } }, - "revision": "20230403", + "revision": "20230428", "rootUrl": "https://translation.googleapis.com/", "schemas": { "BatchDocumentInputConfig": { @@ -1176,7 +1176,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/translate/v3beta1/translate-gen.go b/translate/v3beta1/translate-gen.go index 4c2c42d61bf..c9641701d9b 100644 --- a/translate/v3beta1/translate-gen.go +++ b/translate/v3beta1/translate-gen.go @@ -1129,7 +1129,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/verifiedaccess/v2/verifiedaccess-api.json b/verifiedaccess/v2/verifiedaccess-api.json index 6b8a75cc23a..978af9c1278 100644 --- a/verifiedaccess/v2/verifiedaccess-api.json +++ b/verifiedaccess/v2/verifiedaccess-api.json @@ -146,18 +146,13 @@ } } }, - "revision": "20221004", + "revision": "20230503", "rootUrl": "https://verifiedaccess.googleapis.com/", "schemas": { "Challenge": { "description": "Result message for VerifiedAccess.GenerateChallenge.", "id": "Challenge", "properties": { - "alternativeChallenge": { - "description": "Challenge generated with the old signing key, the bytes representation of SignedData (this will only be present during key rotation).", - "format": "byte", - "type": "string" - }, "challenge": { "description": "Generated challenge, the bytes representation of SignedData.", "format": "byte", @@ -166,6 +161,266 @@ }, "type": "object" }, + "CrowdStrikeAgent": { + "description": "Properties of the CrowdStrike agent installed on a device.", + "id": "CrowdStrikeAgent", + "properties": { + "agentId": { + "description": "The Agent ID of the Crowdstrike agent.", + "type": "string" + }, + "customerId": { + "description": "The Customer ID to which the agent belongs to.", + "type": "string" + } + }, + "type": "object" + }, + "DeviceSignals": { + "description": "The device signals as reported by Chrome.", + "id": "DeviceSignals", + "properties": { + "allowScreenLock": { + "description": "Value of the AllowScreenLock policy on the device. See https://chromeenterprise.google/policies/?policy=AllowScreenLock for more details.", + "type": "boolean" + }, + "browserVersion": { + "description": "Current version of the Chrome browser which generated this set of signals. Example value: \"107.0.5286.0\".", + "type": "string" + }, + "builtInDnsClientEnabled": { + "description": "Whether Chrome's built-in DNS client is used. The OS DNS client is otherwise used. This value may be controlled by an enterprise policy: https://chromeenterprise.google/policies/#BuiltInDnsClientEnabled.", + "type": "boolean" + }, + "chromeRemoteDesktopAppBlocked": { + "description": "Whether access to the Chrome Remote Desktop application is blocked via a policy.", + "type": "boolean" + }, + "crowdStrikeAgent": { + "$ref": "CrowdStrikeAgent", + "description": "Crowdstrike agent properties installed on the device, if any." + }, + "deviceAffiliationIds": { + "description": "Affiliation IDs of the organizations that are affiliated with the organization that is currently managing the device. When the sets of device and profile affiliation IDs overlap, it means that the organizations managing the device and user are affiliated. To learn more about user affiliation, visit https://support.google.com/chrome/a/answer/12801245?ref_topic=9027936.", + "items": { + "type": "string" + }, + "type": "array" + }, + "deviceEnrollmentDomain": { + "description": "Enrollment domain of the customer which is currently managing the device.", + "type": "string" + }, + "deviceManufacturer": { + "description": "The name of the device's manufacturer.", + "type": "string" + }, + "deviceModel": { + "description": "The name of the device's model.", + "type": "string" + }, + "diskEncryption": { + "description": "The encryption state of the disk. On ChromeOS, the main disk is always ENCRYPTED.", + "enum": [ + "DISK_ENCRYPTION_UNSPECIFIED", + "DISK_ENCRYPTION_UNKNOWN", + "DISK_ENCRYPTION_DISABLED", + "DISK_ENCRYPTION_ENCRYPTED" + ], + "enumDescriptions": [ + "Unspecified.", + "Chrome could not evaluate the encryption state.", + "The main disk is not encrypted.", + "The main disk is encrypted." + ], + "type": "string" + }, + "displayName": { + "description": "The display name of the device, as defined by the user.", + "type": "string" + }, + "hostname": { + "description": "Hostname of the device.", + "type": "string" + }, + "imei": { + "description": "International Mobile Equipment Identity (IMEI) of the device.", + "items": { + "type": "string" + }, + "type": "array" + }, + "macAddresses": { + "description": "MAC addresses of the device.", + "items": { + "type": "string" + }, + "type": "array" + }, + "meid": { + "description": "Mobile Equipment Identifier (MEID) of the device.", + "items": { + "type": "string" + }, + "type": "array" + }, + "operatingSystem": { + "description": "The type of the Operating System currently running on the device.", + "enum": [ + "OPERATING_SYSTEM_UNSPECIFIED", + "CHROME_OS", + "CHROMIUM_OS", + "WINDOWS", + "MAC_OS_X", + "LINUX" + ], + "enumDescriptions": [ + "UNSPECIFIED.", + "ChromeOS.", + "ChromiumOS.", + "Windows.", + "Mac Os X.", + "Linux" + ], + "type": "string" + }, + "osFirewall": { + "description": "The state of the OS level firewall. On ChromeOS, the value will always be ENABLED on regular devices and UNKNOWN on devices in developer mode.", + "enum": [ + "OS_FIREWALL_UNSPECIFIED", + "OS_FIREWALL_UNKNOWN", + "OS_FIREWALL_DISABLED", + "OS_FIREWALL_ENABLED" + ], + "enumDescriptions": [ + "Unspecified.", + "Chrome could not evaluate the OS firewall state.", + "The OS firewall is disabled.", + "The OS firewall is enabled." + ], + "type": "string" + }, + "osVersion": { + "description": "The current version of the Operating System. On Windows and linux, the value will also include the security patch information.", + "type": "string" + }, + "passwordProtectionWarningTrigger": { + "description": "Whether the Password Protection Warning feature is enabled or not. Password protection alerts users when they reuse their protected password on potentially suspicious sites. This setting is controlled by an enterprise policy: https://chromeenterprise.google/policies/#PasswordProtectionWarningTrigger. Note that the policy unset does not have the same effects as having the policy explicitly set to `PASSWORD_PROTECTION_OFF`.", + "enum": [ + "PASSWORD_PROTECTION_WARNING_TRIGGER_UNSPECIFIED", + "POLICY_UNSET", + "PASSWORD_PROTECTION_OFF", + "PASSWORD_REUSE", + "PHISHING_REUSE" + ], + "enumDescriptions": [ + "Unspecified.", + "The policy is not set.", + "No password protection warning will be shown.", + "Password protection warning is shown if a protected password is re-used.", + "Password protection warning is shown if a protected password is re-used on a known phishing website." + ], + "type": "string" + }, + "profileAffiliationIds": { + "description": "Affiliation IDs of the organizations that are affiliated with the organization that is currently managing the Chrome Profile’s user or ChromeOS user.", + "items": { + "type": "string" + }, + "type": "array" + }, + "realtimeUrlCheckMode": { + "description": "Whether Enterprise-grade (i.e. custom) unsafe URL scanning is enabled or not. This setting may be controlled by an enterprise policy: https://chromeenterprise.google/policies/#EnterpriseRealTimeUrlCheckMode", + "enum": [ + "REALTIME_URL_CHECK_MODE_UNSPECIFIED", + "REALTIME_URL_CHECK_MODE_DISABLED", + "REALTIME_URL_CHECK_MODE_ENABLED_MAIN_FRAME" + ], + "enumDescriptions": [ + "Unspecified.", + "Disabled. Consumer Safe Browsing checks are applied.", + "Realtime check for main frame URLs is enabled." + ], + "type": "string" + }, + "safeBrowsingProtectionLevel": { + "description": "Safe Browsing Protection Level. That setting may be controlled by an enterprise policy: https://chromeenterprise.google/policies/#SafeBrowsingProtectionLevel.", + "enum": [ + "SAFE_BROWSING_PROTECTION_LEVEL_UNSPECIFIED", + "INACTIVE", + "STANDARD", + "ENHANCED" + ], + "enumDescriptions": [ + "Unspecified.", + "Safe Browsing is disabled.", + "Safe Browsing is active in the standard mode.", + "Safe Browsing is active in the enhanced mode." + ], + "type": "string" + }, + "screenLockSecured": { + "description": "The state of the Screen Lock password protection. On ChromeOS, this value will always be ENABLED as there is not way to disable requiring a password or pin when unlocking the device.", + "enum": [ + "SCREEN_LOCK_SECURED_UNSPECIFIED", + "SCREEN_LOCK_SECURED_UNKNOWN", + "SCREEN_LOCK_SECURED_DISABLED", + "SCREEN_LOCK_SECURED_ENABLED" + ], + "enumDescriptions": [ + "Unspecified.", + "Chrome could not evaluate the state of the Screen Lock mechanism.", + "The Screen Lock is not password-protected.", + "The Screen Lock is password-protected." + ], + "type": "string" + }, + "secureBootMode": { + "description": "Whether the device's startup software has its Secure Boot feature enabled.", + "enum": [ + "SECURE_BOOT_MODE_UNSPECIFIED", + "SECURE_BOOT_MODE_UNKNOWN", + "SECURE_BOOT_MODE_DISABLED", + "SECURE_BOOT_MODE_ENABLED" + ], + "enumDescriptions": [ + "Unspecified.", + "Chrome was unable to determine the Secure Boot mode.", + "Secure Boot was disabled on the startup software.", + "Secure Boot was enabled on the startup software." + ], + "type": "string" + }, + "serialNumber": { + "description": "The serial number of the device. On Windows, this represents the BIOS's serial number.", + "type": "string" + }, + "siteIsolationEnabled": { + "description": "Whether the Site Isolation (a.k.a Site Per Process) setting is enabled. That setting may be controlled by an enterprise policy: https://chromeenterprise.google/policies/#SitePerProcess", + "type": "boolean" + }, + "systemDnsServers": { + "description": "List of the addesses of all OS level DNS servers configured in the device's network settings.", + "items": { + "type": "string" + }, + "type": "array" + }, + "thirdPartyBlockingEnabled": { + "description": "Whether Chrome is blocking third-party software injection or not. This setting may be controlled by an enterprise policy: https://chromeenterprise.google/policies/?policy=ThirdPartyBlockingEnabled", + "type": "boolean" + }, + "windowsMachineDomain": { + "description": "Windows domain that the current machine has joined.", + "type": "string" + }, + "windowsUserDomain": { + "description": "Windows domain for the current OS user.", + "type": "string" + } + }, + "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", @@ -201,9 +456,13 @@ "type": "string" }, "deviceSignal": { - "description": "Device signal in json string representation.", + "description": "Deprecated. Device signal in json string representation. Prefer using `device_signals` instead.", "type": "string" }, + "deviceSignals": { + "$ref": "DeviceSignals", + "description": "Device signals." + }, "keyTrustLevel": { "description": "Device attested key trust level.", "enum": [ diff --git a/verifiedaccess/v2/verifiedaccess-gen.go b/verifiedaccess/v2/verifiedaccess-gen.go index 2eebd26bd36..b488437da63 100644 --- a/verifiedaccess/v2/verifiedaccess-gen.go +++ b/verifiedaccess/v2/verifiedaccess-gen.go @@ -148,11 +148,6 @@ type ChallengeService struct { // Challenge: Result message for VerifiedAccess.GenerateChallenge. type Challenge struct { - // AlternativeChallenge: Challenge generated with the old signing key, - // the bytes representation of SignedData (this will only be present - // during key rotation). - AlternativeChallenge string `json:"alternativeChallenge,omitempty"` - // Challenge: Generated challenge, the bytes representation of // SignedData. Challenge string `json:"challenge,omitempty"` @@ -161,16 +156,270 @@ type Challenge struct { // server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. - // "AlternativeChallenge") to unconditionally include in API requests. - // By default, fields with empty or default values are omitted from API - // requests. However, any non-pointer, non-interface field appearing in - // ForceSendFields will be sent to the server regardless of whether the - // field is empty or not. This may be used to include empty fields in - // Patch requests. + // ForceSendFields is a list of field names (e.g. "Challenge") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Challenge") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Challenge) MarshalJSON() ([]byte, error) { + type NoMethod Challenge + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// CrowdStrikeAgent: Properties of the CrowdStrike agent installed on a +// device. +type CrowdStrikeAgent struct { + // AgentId: The Agent ID of the Crowdstrike agent. + AgentId string `json:"agentId,omitempty"` + + // CustomerId: The Customer ID to which the agent belongs to. + CustomerId string `json:"customerId,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AgentId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AgentId") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *CrowdStrikeAgent) MarshalJSON() ([]byte, error) { + type NoMethod CrowdStrikeAgent + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// DeviceSignals: The device signals as reported by Chrome. +type DeviceSignals struct { + // AllowScreenLock: Value of the AllowScreenLock policy on the device. + // See https://chromeenterprise.google/policies/?policy=AllowScreenLock + // for more details. + AllowScreenLock bool `json:"allowScreenLock,omitempty"` + + // BrowserVersion: Current version of the Chrome browser which generated + // this set of signals. Example value: "107.0.5286.0". + BrowserVersion string `json:"browserVersion,omitempty"` + + // BuiltInDnsClientEnabled: Whether Chrome's built-in DNS client is + // used. The OS DNS client is otherwise used. This value may be + // controlled by an enterprise policy: + // https://chromeenterprise.google/policies/#BuiltInDnsClientEnabled. + BuiltInDnsClientEnabled bool `json:"builtInDnsClientEnabled,omitempty"` + + // ChromeRemoteDesktopAppBlocked: Whether access to the Chrome Remote + // Desktop application is blocked via a policy. + ChromeRemoteDesktopAppBlocked bool `json:"chromeRemoteDesktopAppBlocked,omitempty"` + + // CrowdStrikeAgent: Crowdstrike agent properties installed on the + // device, if any. + CrowdStrikeAgent *CrowdStrikeAgent `json:"crowdStrikeAgent,omitempty"` + + // DeviceAffiliationIds: Affiliation IDs of the organizations that are + // affiliated with the organization that is currently managing the + // device. When the sets of device and profile affiliation IDs overlap, + // it means that the organizations managing the device and user are + // affiliated. To learn more about user affiliation, visit + // https://support.google.com/chrome/a/answer/12801245?ref_topic=9027936. + DeviceAffiliationIds []string `json:"deviceAffiliationIds,omitempty"` + + // DeviceEnrollmentDomain: Enrollment domain of the customer which is + // currently managing the device. + DeviceEnrollmentDomain string `json:"deviceEnrollmentDomain,omitempty"` + + // DeviceManufacturer: The name of the device's manufacturer. + DeviceManufacturer string `json:"deviceManufacturer,omitempty"` + + // DeviceModel: The name of the device's model. + DeviceModel string `json:"deviceModel,omitempty"` + + // DiskEncryption: The encryption state of the disk. On ChromeOS, the + // main disk is always ENCRYPTED. + // + // Possible values: + // "DISK_ENCRYPTION_UNSPECIFIED" - Unspecified. + // "DISK_ENCRYPTION_UNKNOWN" - Chrome could not evaluate the + // encryption state. + // "DISK_ENCRYPTION_DISABLED" - The main disk is not encrypted. + // "DISK_ENCRYPTION_ENCRYPTED" - The main disk is encrypted. + DiskEncryption string `json:"diskEncryption,omitempty"` + + // DisplayName: The display name of the device, as defined by the user. + DisplayName string `json:"displayName,omitempty"` + + // Hostname: Hostname of the device. + Hostname string `json:"hostname,omitempty"` + + // Imei: International Mobile Equipment Identity (IMEI) of the device. + Imei []string `json:"imei,omitempty"` + + // MacAddresses: MAC addresses of the device. + MacAddresses []string `json:"macAddresses,omitempty"` + + // Meid: Mobile Equipment Identifier (MEID) of the device. + Meid []string `json:"meid,omitempty"` + + // OperatingSystem: The type of the Operating System currently running + // on the device. + // + // Possible values: + // "OPERATING_SYSTEM_UNSPECIFIED" - UNSPECIFIED. + // "CHROME_OS" - ChromeOS. + // "CHROMIUM_OS" - ChromiumOS. + // "WINDOWS" - Windows. + // "MAC_OS_X" - Mac Os X. + // "LINUX" - Linux + OperatingSystem string `json:"operatingSystem,omitempty"` + + // OsFirewall: The state of the OS level firewall. On ChromeOS, the + // value will always be ENABLED on regular devices and UNKNOWN on + // devices in developer mode. + // + // Possible values: + // "OS_FIREWALL_UNSPECIFIED" - Unspecified. + // "OS_FIREWALL_UNKNOWN" - Chrome could not evaluate the OS firewall + // state. + // "OS_FIREWALL_DISABLED" - The OS firewall is disabled. + // "OS_FIREWALL_ENABLED" - The OS firewall is enabled. + OsFirewall string `json:"osFirewall,omitempty"` + + // OsVersion: The current version of the Operating System. On Windows + // and linux, the value will also include the security patch + // information. + OsVersion string `json:"osVersion,omitempty"` + + // PasswordProtectionWarningTrigger: Whether the Password Protection + // Warning feature is enabled or not. Password protection alerts users + // when they reuse their protected password on potentially suspicious + // sites. This setting is controlled by an enterprise policy: + // https://chromeenterprise.google/policies/#PasswordProtectionWarningTrigger. + // Note that the policy unset does not have the same effects as having + // the policy explicitly set to `PASSWORD_PROTECTION_OFF`. + // + // Possible values: + // "PASSWORD_PROTECTION_WARNING_TRIGGER_UNSPECIFIED" - Unspecified. + // "POLICY_UNSET" - The policy is not set. + // "PASSWORD_PROTECTION_OFF" - No password protection warning will be + // shown. + // "PASSWORD_REUSE" - Password protection warning is shown if a + // protected password is re-used. + // "PHISHING_REUSE" - Password protection warning is shown if a + // protected password is re-used on a known phishing website. + PasswordProtectionWarningTrigger string `json:"passwordProtectionWarningTrigger,omitempty"` + + // ProfileAffiliationIds: Affiliation IDs of the organizations that are + // affiliated with the organization that is currently managing the + // Chrome Profile’s user or ChromeOS user. + ProfileAffiliationIds []string `json:"profileAffiliationIds,omitempty"` + + // RealtimeUrlCheckMode: Whether Enterprise-grade (i.e. custom) unsafe + // URL scanning is enabled or not. This setting may be controlled by an + // enterprise policy: + // https://chromeenterprise.google/policies/#EnterpriseRealTimeUrlCheckMode + // + // Possible values: + // "REALTIME_URL_CHECK_MODE_UNSPECIFIED" - Unspecified. + // "REALTIME_URL_CHECK_MODE_DISABLED" - Disabled. Consumer Safe + // Browsing checks are applied. + // "REALTIME_URL_CHECK_MODE_ENABLED_MAIN_FRAME" - Realtime check for + // main frame URLs is enabled. + RealtimeUrlCheckMode string `json:"realtimeUrlCheckMode,omitempty"` + + // SafeBrowsingProtectionLevel: Safe Browsing Protection Level. That + // setting may be controlled by an enterprise policy: + // https://chromeenterprise.google/policies/#SafeBrowsingProtectionLevel. + // + // Possible values: + // "SAFE_BROWSING_PROTECTION_LEVEL_UNSPECIFIED" - Unspecified. + // "INACTIVE" - Safe Browsing is disabled. + // "STANDARD" - Safe Browsing is active in the standard mode. + // "ENHANCED" - Safe Browsing is active in the enhanced mode. + SafeBrowsingProtectionLevel string `json:"safeBrowsingProtectionLevel,omitempty"` + + // ScreenLockSecured: The state of the Screen Lock password protection. + // On ChromeOS, this value will always be ENABLED as there is not way to + // disable requiring a password or pin when unlocking the device. + // + // Possible values: + // "SCREEN_LOCK_SECURED_UNSPECIFIED" - Unspecified. + // "SCREEN_LOCK_SECURED_UNKNOWN" - Chrome could not evaluate the state + // of the Screen Lock mechanism. + // "SCREEN_LOCK_SECURED_DISABLED" - The Screen Lock is not + // password-protected. + // "SCREEN_LOCK_SECURED_ENABLED" - The Screen Lock is + // password-protected. + ScreenLockSecured string `json:"screenLockSecured,omitempty"` + + // SecureBootMode: Whether the device's startup software has its Secure + // Boot feature enabled. + // + // Possible values: + // "SECURE_BOOT_MODE_UNSPECIFIED" - Unspecified. + // "SECURE_BOOT_MODE_UNKNOWN" - Chrome was unable to determine the + // Secure Boot mode. + // "SECURE_BOOT_MODE_DISABLED" - Secure Boot was disabled on the + // startup software. + // "SECURE_BOOT_MODE_ENABLED" - Secure Boot was enabled on the startup + // software. + SecureBootMode string `json:"secureBootMode,omitempty"` + + // SerialNumber: The serial number of the device. On Windows, this + // represents the BIOS's serial number. + SerialNumber string `json:"serialNumber,omitempty"` + + // SiteIsolationEnabled: Whether the Site Isolation (a.k.a Site Per + // Process) setting is enabled. That setting may be controlled by an + // enterprise policy: + // https://chromeenterprise.google/policies/#SitePerProcess + SiteIsolationEnabled bool `json:"siteIsolationEnabled,omitempty"` + + // SystemDnsServers: List of the addesses of all OS level DNS servers + // configured in the device's network settings. + SystemDnsServers []string `json:"systemDnsServers,omitempty"` + + // ThirdPartyBlockingEnabled: Whether Chrome is blocking third-party + // software injection or not. This setting may be controlled by an + // enterprise policy: + // https://chromeenterprise.google/policies/?policy=ThirdPartyBlockingEnabled + ThirdPartyBlockingEnabled bool `json:"thirdPartyBlockingEnabled,omitempty"` + + // WindowsMachineDomain: Windows domain that the current machine has + // joined. + WindowsMachineDomain string `json:"windowsMachineDomain,omitempty"` + + // WindowsUserDomain: Windows domain for the current OS user. + WindowsUserDomain string `json:"windowsUserDomain,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AllowScreenLock") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AlternativeChallenge") to + // NullFields is a list of field names (e.g. "AllowScreenLock") to // include in API requests with the JSON null value. By default, fields // with empty values are omitted from API requests. However, any field // with an empty value appearing in NullFields will be sent to the @@ -180,8 +429,8 @@ type Challenge struct { NullFields []string `json:"-"` } -func (s *Challenge) MarshalJSON() ([]byte, error) { - type NoMethod Challenge +func (s *DeviceSignals) MarshalJSON() ([]byte, error) { + type NoMethod DeviceSignals raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } @@ -244,9 +493,13 @@ type VerifyChallengeResponseResult struct { // the machine response only). DevicePermanentId string `json:"devicePermanentId,omitempty"` - // DeviceSignal: Device signal in json string representation. + // DeviceSignal: Deprecated. Device signal in json string + // representation. Prefer using `device_signals` instead. DeviceSignal string `json:"deviceSignal,omitempty"` + // DeviceSignals: Device signals. + DeviceSignals *DeviceSignals `json:"deviceSignals,omitempty"` + // KeyTrustLevel: Device attested key trust level. // // Possible values: diff --git a/vmmigration/v1/vmmigration-api.json b/vmmigration/v1/vmmigration-api.json index b664a5090c2..e66717077b3 100644 --- a/vmmigration/v1/vmmigration-api.json +++ b/vmmigration/v1/vmmigration-api.json @@ -1972,7 +1972,7 @@ } } }, - "revision": "20230330", + "revision": "20230420", "rootUrl": "https://vmmigration.googleapis.com/", "schemas": { "AccessKeyCredentials": { @@ -3408,7 +3408,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/vmmigration/v1/vmmigration-gen.go b/vmmigration/v1/vmmigration-gen.go index e1c73837406..178b5c5e58c 100644 --- a/vmmigration/v1/vmmigration-gen.go +++ b/vmmigration/v1/vmmigration-gen.go @@ -2081,7 +2081,7 @@ func (s *LocalizedMessage) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/vmmigration/v1alpha1/vmmigration-api.json b/vmmigration/v1alpha1/vmmigration-api.json index a1435df06d1..7b59c0d92e1 100644 --- a/vmmigration/v1alpha1/vmmigration-api.json +++ b/vmmigration/v1alpha1/vmmigration-api.json @@ -1972,7 +1972,7 @@ } } }, - "revision": "20230330", + "revision": "20230420", "rootUrl": "https://vmmigration.googleapis.com/", "schemas": { "AccessKeyCredentials": { @@ -3437,7 +3437,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/vmmigration/v1alpha1/vmmigration-gen.go b/vmmigration/v1alpha1/vmmigration-gen.go index 1f2a029d630..3c3a39544af 100644 --- a/vmmigration/v1alpha1/vmmigration-gen.go +++ b/vmmigration/v1alpha1/vmmigration-gen.go @@ -2106,7 +2106,7 @@ func (s *LocalizedMessage) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/vpcaccess/v1/vpcaccess-api.json b/vpcaccess/v1/vpcaccess-api.json index 94b82cb0026..4e403c7a651 100644 --- a/vpcaccess/v1/vpcaccess-api.json +++ b/vpcaccess/v1/vpcaccess-api.json @@ -384,7 +384,7 @@ } } }, - "revision": "20230418", + "revision": "20230427", "rootUrl": "https://vpcaccess.googleapis.com/", "schemas": { "Connector": { @@ -518,7 +518,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/vpcaccess/v1/vpcaccess-gen.go b/vpcaccess/v1/vpcaccess-gen.go index f5e33984730..d81c7bf1bc1 100644 --- a/vpcaccess/v1/vpcaccess-gen.go +++ b/vpcaccess/v1/vpcaccess-gen.go @@ -373,7 +373,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/vpcaccess/v1beta1/vpcaccess-api.json b/vpcaccess/v1beta1/vpcaccess-api.json index 8be29898f0f..f7e1deea564 100644 --- a/vpcaccess/v1beta1/vpcaccess-api.json +++ b/vpcaccess/v1beta1/vpcaccess-api.json @@ -384,7 +384,7 @@ } } }, - "revision": "20230418", + "revision": "20230427", "rootUrl": "https://vpcaccess.googleapis.com/", "schemas": { "Connector": { @@ -518,7 +518,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/vpcaccess/v1beta1/vpcaccess-gen.go b/vpcaccess/v1beta1/vpcaccess-gen.go index a387c464fbd..6976dd288fc 100644 --- a/vpcaccess/v1beta1/vpcaccess-gen.go +++ b/vpcaccess/v1beta1/vpcaccess-gen.go @@ -373,7 +373,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/workflows/v1/workflows-api.json b/workflows/v1/workflows-api.json index 17d16b99833..7110172631a 100644 --- a/workflows/v1/workflows-api.json +++ b/workflows/v1/workflows-api.json @@ -449,7 +449,7 @@ } } }, - "revision": "20230329", + "revision": "20230426", "rootUrl": "https://workflows.googleapis.com/", "schemas": { "Empty": { @@ -520,7 +520,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/workflows/v1/workflows-gen.go b/workflows/v1/workflows-gen.go index 857c418be67..4ce91c2c3c2 100644 --- a/workflows/v1/workflows-gen.go +++ b/workflows/v1/workflows-gen.go @@ -308,7 +308,7 @@ func (s *ListWorkflowsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/workflows/v1beta/workflows-api.json b/workflows/v1beta/workflows-api.json index 84f7fa6a3e8..eb3bf106c06 100644 --- a/workflows/v1beta/workflows-api.json +++ b/workflows/v1beta/workflows-api.json @@ -444,7 +444,7 @@ } } }, - "revision": "20230308", + "revision": "20230426", "rootUrl": "https://workflows.googleapis.com/", "schemas": { "Empty": { @@ -515,7 +515,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { diff --git a/workflows/v1beta/workflows-gen.go b/workflows/v1beta/workflows-gen.go index fea6613bf63..9e2e448b38c 100644 --- a/workflows/v1beta/workflows-gen.go +++ b/workflows/v1beta/workflows-gen.go @@ -308,7 +308,7 @@ func (s *ListWorkflowsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". diff --git a/workstations/v1beta/workstations-api.json b/workstations/v1beta/workstations-api.json index 26a7f60f4ec..001515e2d5d 100644 --- a/workstations/v1beta/workstations-api.json +++ b/workstations/v1beta/workstations-api.json @@ -282,7 +282,7 @@ ], "parameters": { "etag": { - "description": "If set, the request will be rejected if the latest version of the workstation cluster on the server does not have this etag.", + "description": "If set, the request will be rejected if the latest version of the workstation cluster on the server does not have this ETag.", "location": "query", "type": "string" }, @@ -469,7 +469,7 @@ ], "parameters": { "etag": { - "description": "If set, the request is rejected if the latest version of the workstation configuration on the server does not have this etag.", + "description": "If set, the request is rejected if the latest version of the workstation configuration on the server does not have this ETag.", "location": "query", "type": "string" }, @@ -779,7 +779,7 @@ ], "parameters": { "etag": { - "description": "If set, the request will be rejected if the latest version of the workstation on the server does not have this etag.", + "description": "If set, the request will be rejected if the latest version of the workstation on the server does not have this ETag.", "location": "query", "type": "string" }, @@ -1127,9 +1127,25 @@ } } }, - "revision": "20230412", + "revision": "20230501", "rootUrl": "https://workstations.googleapis.com/", "schemas": { + "Accelerator": { + "description": "An accelerator card attached to the instance.", + "id": "Accelerator", + "properties": { + "count": { + "description": "Number of accelerator cards exposed to the instance.", + "format": "int32", + "type": "integer" + }, + "type": { + "description": "Type of accelerator resource to attach to the instance, for example, \"nvidia-tesla-p100\".", + "type": "string" + } + }, + "type": "object" + }, "AuditConfig": { "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.", "id": "AuditConfig", @@ -1228,7 +1244,7 @@ "additionalProperties": { "type": "string" }, - "description": "Environment variables passed to the container.", + "description": "Environment variables passed to the container's entrypoint.", "type": "object" }, "image": { @@ -1300,6 +1316,13 @@ "description": "A runtime using a Compute Engine instance.", "id": "GceInstance", "properties": { + "accelerators": { + "description": "A list of the type and count of accelerator cards attached to the instance.", + "items": { + "$ref": "Accelerator" + }, + "type": "array" + }, "bootDiskSizeGb": { "description": "Size of the boot disk in GB. Defaults to 50.", "format": "int32", @@ -1318,8 +1341,14 @@ "type": "string" }, "poolSize": { - "description": "Number of instances to pool for faster workstation starup.", + "description": "Number of instances to pool for faster workstation startup.", + "format": "int32", + "type": "integer" + }, + "pooledInstances": { + "description": "Output only. Number of instances currently available in the pool for faster workstation startup.", "format": "int32", + "readOnly": true, "type": "integer" }, "serviceAccount": { @@ -1419,7 +1448,7 @@ "id": "GenerateAccessTokenResponse", "properties": { "accessToken": { - "description": "The generated bearer access token. To use this token, include it in an Authorization header of an HTTP request sent to the associated workstation's hostname, for example, `Authorization: Bearer `.", + "description": "The generated bearer access token. To use this token, include it in an Authorization header of an HTTP request sent to the associated workstation's hostname—for example, `Authorization: Bearer `.", "type": "string" }, "expireTime": { @@ -1743,6 +1772,22 @@ }, "type": "object" }, + "ReadinessCheck": { + "description": "A readiness check to be performed on a workstation.", + "id": "ReadinessCheck", + "properties": { + "path": { + "description": "Path to which the request should be sent.", + "type": "string" + }, + "port": { + "description": "Port to which the request should be sent.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "SetIamPolicyRequest": { "description": "Request message for `SetIamPolicy` method.", "id": "SetIamPolicyRequest", @@ -1764,7 +1809,7 @@ "id": "StartWorkstationRequest", "properties": { "etag": { - "description": "If set, the request will be rejected if the latest version of the workstation on the server does not have this etag.", + "description": "If set, the request will be rejected if the latest version of the workstation on the server does not have this ETag.", "type": "string" }, "validateOnly": { @@ -1806,7 +1851,7 @@ "id": "StopWorkstationRequest", "properties": { "etag": { - "description": "If set, the request will be rejected if the latest version of the workstation on the server does not have this etag.", + "description": "If set, the request will be rejected if the latest version of the workstation on the server does not have this ETag.", "type": "string" }, "validateOnly": { @@ -1875,7 +1920,7 @@ "additionalProperties": { "type": "string" }, - "description": "Environment variables passed to the workstation container.", + "description": "Environment variables passed to the workstation container's entrypoint.", "type": "object" }, "etag": { @@ -2110,6 +2155,13 @@ }, "type": "array" }, + "readinessChecks": { + "description": "Readiness checks to perform when starting a workstation using this workstation configuration. Mark a workstation as running only after all specified readiness checks return 200 status codes.", + "items": { + "$ref": "ReadinessCheck" + }, + "type": "array" + }, "reconciling": { "description": "Output only. Indicates whether this resource is currently being updated to match its intended state.", "readOnly": true, diff --git a/workstations/v1beta/workstations-gen.go b/workstations/v1beta/workstations-gen.go index cb2241cb1fe..7ff45ae9d57 100644 --- a/workstations/v1beta/workstations-gen.go +++ b/workstations/v1beta/workstations-gen.go @@ -207,6 +207,38 @@ type ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsService s s *Service } +// Accelerator: An accelerator card attached to the instance. +type Accelerator struct { + // Count: Number of accelerator cards exposed to the instance. + Count int64 `json:"count,omitempty"` + + // Type: Type of accelerator resource to attach to the instance, for + // example, "nvidia-tesla-p100". + Type string `json:"type,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Count") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Count") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Accelerator) MarshalJSON() ([]byte, error) { + type NoMethod Accelerator + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // AuditConfig: Specifies the audit configuration for a service. The // configuration determines which permission types are logged, and what // identities, if any, are exempted from logging. An AuditConfig must @@ -396,7 +428,7 @@ type Container struct { // image. Command []string `json:"command,omitempty"` - // Env: Environment variables passed to the container. + // Env: Environment variables passed to the container's entrypoint. Env map[string]string `json:"env,omitempty"` // Image: Docker image defining the container. This image must be @@ -569,6 +601,10 @@ func (s *GceConfidentialInstanceConfig) MarshalJSON() ([]byte, error) { // GceInstance: A runtime using a Compute Engine instance. type GceInstance struct { + // Accelerators: A list of the type and count of accelerator cards + // attached to the instance. + Accelerators []*Accelerator `json:"accelerators,omitempty"` + // BootDiskSizeGb: Size of the boot disk in GB. Defaults to 50. BootDiskSizeGb int64 `json:"bootDiskSizeGb,omitempty"` @@ -583,9 +619,13 @@ type GceInstance struct { // MachineType: The name of a Compute Engine machine type. MachineType string `json:"machineType,omitempty"` - // PoolSize: Number of instances to pool for faster workstation starup. + // PoolSize: Number of instances to pool for faster workstation startup. PoolSize int64 `json:"poolSize,omitempty"` + // PooledInstances: Output only. Number of instances currently available + // in the pool for faster workstation startup. + PooledInstances int64 `json:"pooledInstances,omitempty"` + // ServiceAccount: Email address of the service account used on VM // instances used to support this configuration. If not set, VMs run // with a Google-managed service account. This service account must have @@ -601,7 +641,7 @@ type GceInstance struct { // Workstations. Tags []string `json:"tags,omitempty"` - // ForceSendFields is a list of field names (e.g. "BootDiskSizeGb") to + // ForceSendFields is a list of field names (e.g. "Accelerators") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -609,13 +649,12 @@ type GceInstance struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BootDiskSizeGb") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the - // server as null. It is an error if a field in this list has a - // non-empty value. This may be used to include null fields in Patch - // requests. + // NullFields is a list of field names (e.g. "Accelerators") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } @@ -757,7 +796,7 @@ func (s *GenerateAccessTokenRequest) MarshalJSON() ([]byte, error) { type GenerateAccessTokenResponse struct { // AccessToken: The generated bearer access token. To use this token, // include it in an Authorization header of an HTTP request sent to the - // associated workstation's hostname, for example, `Authorization: + // associated workstation's hostname—for example, `Authorization: // Bearer `. AccessToken string `json:"accessToken,omitempty"` @@ -1370,6 +1409,37 @@ func (s *PrivateClusterConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ReadinessCheck: A readiness check to be performed on a workstation. +type ReadinessCheck struct { + // Path: Path to which the request should be sent. + Path string `json:"path,omitempty"` + + // Port: Port to which the request should be sent. + Port int64 `json:"port,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Path") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Path") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ReadinessCheck) MarshalJSON() ([]byte, error) { + type NoMethod ReadinessCheck + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SetIamPolicyRequest: Request message for `SetIamPolicy` method. type SetIamPolicyRequest struct { // Policy: REQUIRED: The complete policy to be applied to the @@ -1410,7 +1480,7 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // StartWorkstationRequest: Request message for StartWorkstation. type StartWorkstationRequest struct { // Etag: If set, the request will be rejected if the latest version of - // the workstation on the server does not have this etag. + // the workstation on the server does not have this ETag. Etag string `json:"etag,omitempty"` // ValidateOnly: If set, validate the request and preview the review, @@ -1487,7 +1557,7 @@ func (s *Status) MarshalJSON() ([]byte, error) { // StopWorkstationRequest: Request message for StopWorkstation. type StopWorkstationRequest struct { // Etag: If set, the request will be rejected if the latest version of - // the workstation on the server does not have this etag. + // the workstation on the server does not have this ETag. Etag string `json:"etag,omitempty"` // ValidateOnly: If set, validate the request and preview the review, @@ -1598,7 +1668,8 @@ type Workstation struct { // DisplayName: Human-readable name for this resource. DisplayName string `json:"displayName,omitempty"` - // Env: Environment variables passed to the workstation container. + // Env: Environment variables passed to the workstation container's + // entrypoint. Env map[string]string `json:"env,omitempty"` // Etag: Checksum computed by the server. May be sent on update and @@ -1841,6 +1912,12 @@ type WorkstationConfig struct { // sessions. PersistentDirectories []*PersistentDirectory `json:"persistentDirectories,omitempty"` + // ReadinessChecks: Readiness checks to perform when starting a + // workstation using this workstation configuration. Mark a workstation + // as running only after all specified readiness checks return 200 + // status codes. + ReadinessChecks []*ReadinessCheck `json:"readinessChecks,omitempty"` + // Reconciling: Output only. Indicates whether this resource is // currently being updated to match its intended state. Reconciling bool `json:"reconciling,omitempty"` @@ -2716,7 +2793,7 @@ func (r *ProjectsLocationsWorkstationClustersService) Delete(name string) *Proje // Etag sets the optional parameter "etag": If set, the request will be // rejected if the latest version of the workstation cluster on the -// server does not have this etag. +// server does not have this ETag. func (c *ProjectsLocationsWorkstationClustersDeleteCall) Etag(etag string) *ProjectsLocationsWorkstationClustersDeleteCall { c.urlParams_.Set("etag", etag) return c @@ -2833,7 +2910,7 @@ func (c *ProjectsLocationsWorkstationClustersDeleteCall) Do(opts ...googleapi.Ca // ], // "parameters": { // "etag": { - // "description": "If set, the request will be rejected if the latest version of the workstation cluster on the server does not have this etag.", + // "description": "If set, the request will be rejected if the latest version of the workstation cluster on the server does not have this ETag.", // "location": "query", // "type": "string" // }, @@ -3575,7 +3652,7 @@ func (r *ProjectsLocationsWorkstationClustersWorkstationConfigsService) Delete(n // Etag sets the optional parameter "etag": If set, the request is // rejected if the latest version of the workstation configuration on -// the server does not have this etag. +// the server does not have this ETag. func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsDeleteCall) Etag(etag string) *ProjectsLocationsWorkstationClustersWorkstationConfigsDeleteCall { c.urlParams_.Set("etag", etag) return c @@ -3693,7 +3770,7 @@ func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsDeleteCall) Do(op // ], // "parameters": { // "etag": { - // "description": "If set, the request is rejected if the latest version of the workstation configuration on the server does not have this etag.", + // "description": "If set, the request is rejected if the latest version of the workstation configuration on the server does not have this ETag.", // "location": "query", // "type": "string" // }, @@ -5103,7 +5180,7 @@ func (r *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsServi // Etag sets the optional parameter "etag": If set, the request will be // rejected if the latest version of the workstation on the server does -// not have this etag. +// not have this ETag. func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsDeleteCall) Etag(etag string) *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsDeleteCall { c.urlParams_.Set("etag", etag) return c @@ -5212,7 +5289,7 @@ func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsDelet // ], // "parameters": { // "etag": { - // "description": "If set, the request will be rejected if the latest version of the workstation on the server does not have this etag.", + // "description": "If set, the request will be rejected if the latest version of the workstation on the server does not have this ETag.", // "location": "query", // "type": "string" // }, diff --git a/youtube/v3/youtube-api.json b/youtube/v3/youtube-api.json index cf652407d51..1855a54d3ab 100644 --- a/youtube/v3/youtube-api.json +++ b/youtube/v3/youtube-api.json @@ -1131,7 +1131,7 @@ "type": "string" }, "moderationStatus": { - "description": "Specifies the requested moderation status. Note, comments can be in statuses, which are not available through this call. For example, this call does not allow to mark a comment as 'likely spam'. Valid values: MODERATION_STATUS_PUBLISHED, MODERATION_STATUS_HELD_FOR_REVIEW, MODERATION_STATUS_REJECTED.", + "description": "Specifies the requested moderation status. Note, comments can be in statuses, which are not available through this call. For example, this call does not allow to mark a comment as 'likely spam'. Valid values: 'heldForReview', 'published' or 'rejected'.", "enum": [ "published", "heldForReview", @@ -3831,7 +3831,7 @@ } } }, - "revision": "20230330", + "revision": "20230505", "rootUrl": "https://youtube.googleapis.com/", "schemas": { "AbuseReport": { diff --git a/youtube/v3/youtube-gen.go b/youtube/v3/youtube-gen.go index 9745b72ff8f..fb0a1f80a9a 100644 --- a/youtube/v3/youtube-gen.go +++ b/youtube/v3/youtube-gen.go @@ -14467,8 +14467,8 @@ type CommentsSetModerationStatusCall struct { // - moderationStatus: Specifies the requested moderation status. Note, // comments can be in statuses, which are not available through this // call. For example, this call does not allow to mark a comment as -// 'likely spam'. Valid values: MODERATION_STATUS_PUBLISHED, -// MODERATION_STATUS_HELD_FOR_REVIEW, MODERATION_STATUS_REJECTED. +// 'likely spam'. Valid values: 'heldForReview', 'published' or +// 'rejected'. func (r *CommentsService) SetModerationStatus(id []string, moderationStatus string) *CommentsSetModerationStatusCall { c := &CommentsSetModerationStatusCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.urlParams_.SetMulti("id", append([]string{}, id...)) @@ -14566,7 +14566,7 @@ func (c *CommentsSetModerationStatusCall) Do(opts ...googleapi.CallOption) error // "type": "string" // }, // "moderationStatus": { - // "description": "Specifies the requested moderation status. Note, comments can be in statuses, which are not available through this call. For example, this call does not allow to mark a comment as 'likely spam'. Valid values: MODERATION_STATUS_PUBLISHED, MODERATION_STATUS_HELD_FOR_REVIEW, MODERATION_STATUS_REJECTED.", + // "description": "Specifies the requested moderation status. Note, comments can be in statuses, which are not available through this call. For example, this call does not allow to mark a comment as 'likely spam'. Valid values: 'heldForReview', 'published' or 'rejected'.", // "enum": [ // "published", // "heldForReview",