diff --git a/api-list.json b/api-list.json index 8997d9876a1..12db022b9ec 100644 --- a/api-list.json +++ b/api-list.json @@ -4342,6 +4342,21 @@ "documentationLink": "https://developers.google.com/people/", "preferred": true }, + { + "kind": "discovery#directoryItem", + "id": "places:v1", + "name": "places", + "version": "v1", + "title": "Places API (New)", + "description": "", + "discoveryRestUrl": "https://places.googleapis.com/$discovery/rest?version=v1", + "icons": { + "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", + "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" + }, + "documentationLink": "https://mapsplatform.google.com/maps-products/#places-section", + "preferred": true + }, { "kind": "discovery#directoryItem", "id": "playcustomapp:v1", diff --git a/cloudbuild/v1/cloudbuild-api.json b/cloudbuild/v1/cloudbuild-api.json index 6f4697b9d3d..79515d82888 100644 --- a/cloudbuild/v1/cloudbuild-api.json +++ b/cloudbuild/v1/cloudbuild-api.json @@ -2319,7 +2319,7 @@ } } }, - "revision": "20230626", + "revision": "20230713", "rootUrl": "https://cloudbuild.googleapis.com/", "schemas": { "ApprovalConfig": { @@ -2982,7 +2982,7 @@ ], "enumDescriptions": [ "Unspecified.", - "Bucket is located in user-owned project in the same region as the build. The builder service account must have access to create and write to GCS buckets in the build project." + "Bucket is located in user-owned project in the same region as the build. The builder service account must have access to create and write to Cloud Storage buckets in the build project." ], "type": "string" }, @@ -3026,6 +3026,14 @@ "CLOUD_LOGGING_ONLY", "NONE" ], + "enumDeprecated": [ + false, + false, + false, + true, + false, + false + ], "enumDescriptions": [ "The service determines the logging mode. The default is `LEGACY`. Do not rely on the default logging behavior as it may change in the future.", "Build logs are stored in Cloud Logging and Cloud Storage.", @@ -3118,6 +3126,7 @@ "type": "array" }, "workerPool": { + "deprecated": true, "description": "This field deprecated; please use `pool.name` instead.", "type": "string" } @@ -3796,6 +3805,7 @@ "id": "GitHubEnterpriseSecrets", "properties": { "oauthClientIdName": { + "deprecated": true, "description": "The resource name for the OAuth client ID secret in Secret Manager.", "type": "string" }, @@ -3804,6 +3814,7 @@ "type": "string" }, "oauthSecretName": { + "deprecated": true, "description": "The resource name for the OAuth secret in Secret Manager.", "type": "string" }, @@ -3812,6 +3823,7 @@ "type": "string" }, "privateKeyName": { + "deprecated": true, "description": "The resource name for the private key secret.", "type": "string" }, @@ -3820,6 +3832,7 @@ "type": "string" }, "webhookSecretName": { + "deprecated": true, "description": "The resource name for the webhook secret in Secret Manager.", "type": "string" }, @@ -3839,6 +3852,7 @@ "type": "string" }, "installationId": { + "deprecated": true, "description": "The installationID that emits the GitHub event.", "format": "int64", "type": "string" diff --git a/cloudbuild/v1/cloudbuild-gen.go b/cloudbuild/v1/cloudbuild-gen.go index 5ea57d4035d..27e8d6c7578 100644 --- a/cloudbuild/v1/cloudbuild-gen.go +++ b/cloudbuild/v1/cloudbuild-gen.go @@ -1384,8 +1384,8 @@ type BuildOptions struct { // "DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED" - Unspecified. // "REGIONAL_USER_OWNED_BUCKET" - Bucket is located in user-owned // project in the same region as the build. The builder service account - // must have access to create and write to GCS buckets in the build - // project. + // must have access to create and write to Cloud Storage buckets in the + // build project. DefaultLogsBucketBehavior string `json:"defaultLogsBucketBehavior,omitempty"` // DiskSizeGb: Requested disk size for the VM that runs the build. Note diff --git a/cloudchannel/v1/cloudchannel-api.json b/cloudchannel/v1/cloudchannel-api.json index ea39aaa1576..7c302ebe08f 100644 --- a/cloudchannel/v1/cloudchannel-api.json +++ b/cloudchannel/v1/cloudchannel-api.json @@ -442,7 +442,7 @@ "channelPartnerRepricingConfigs": { "methods": { "create": { - "description": "Creates a ChannelPartnerRepricingConfig. Call this method to set modifications for a specific ChannelPartner's bill. You can only create configs if the RepricingConfig.effective_invoice_month is a future month. If needed, you can create a config for the current month, with some restrictions. When creating a config for a future month, make sure there are no existing configs for that RepricingConfig.effective_invoice_month. The following restrictions are for creating configs in the current month. * This functionality is reserved for recovering from an erroneous config, and should not be used for regular business cases. * The new config will not modify exports used with other configs. Changes to the config may be immediate, but may take up to 24 hours. * There is a limit of ten configs for any ChannelPartner or RepricingConfig.effective_invoice_month. * The contained ChannelPartnerRepricingConfig.repricing_config vaule must be different from the value used in the current config for a ChannelPartner. Possible Error Codes: * PERMISSION_DENIED: If the account making the request and the account being queried are different. * INVALID_ARGUMENT: Missing or invalid required parameters in the request. Also displays if the updated config is for the current month or past months. * NOT_FOUND: The ChannelPartnerRepricingConfig specified does not exist or is not associated with the given account. * INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. Return Value: If successful, the updated ChannelPartnerRepricingConfig resource, otherwise returns an error.", + "description": "Creates a ChannelPartnerRepricingConfig. Call this method to set modifications for a specific ChannelPartner's bill. You can only create configs if the RepricingConfig.effective_invoice_month is a future month. If needed, you can create a config for the current month, with some restrictions. When creating a config for a future month, make sure there are no existing configs for that RepricingConfig.effective_invoice_month. The following restrictions are for creating configs in the current month. * This functionality is reserved for recovering from an erroneous config, and should not be used for regular business cases. * The new config will not modify exports used with other configs. Changes to the config may be immediate, but may take up to 24 hours. * There is a limit of ten configs for any ChannelPartner or RepricingConfig.EntitlementGranularity.entitlement, for any RepricingConfig.effective_invoice_month. * The contained ChannelPartnerRepricingConfig.repricing_config value must be different from the value used in the current config for a ChannelPartner. Possible Error Codes: * PERMISSION_DENIED: If the account making the request and the account being queried are different. * INVALID_ARGUMENT: Missing or invalid required parameters in the request. Also displays if the updated config is for the current month or past months. * NOT_FOUND: The ChannelPartnerRepricingConfig specified does not exist or is not associated with the given account. * INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. Return Value: If successful, the updated ChannelPartnerRepricingConfig resource, otherwise returns an error.", "flatPath": "v1/accounts/{accountsId}/channelPartnerLinks/{channelPartnerLinksId}/channelPartnerRepricingConfigs", "httpMethod": "POST", "id": "cloudchannel.accounts.channelPartnerLinks.channelPartnerRepricingConfigs.create", @@ -1212,7 +1212,7 @@ "customerRepricingConfigs": { "methods": { "create": { - "description": "Creates a CustomerRepricingConfig. Call this method to set modifications for a specific customer's bill. You can only create configs if the RepricingConfig.effective_invoice_month is a future month. If needed, you can create a config for the current month, with some restrictions. When creating a config for a future month, make sure there are no existing configs for that RepricingConfig.effective_invoice_month. The following restrictions are for creating configs in the current month. * This functionality is reserved for recovering from an erroneous config, and should not be used for regular business cases. * The new config will not modify exports used with other configs. Changes to the config may be immediate, but may take up to 24 hours. * There is a limit of ten configs for any RepricingConfig.EntitlementGranularity.entitlement or RepricingConfig.effective_invoice_month. * The contained CustomerRepricingConfig.repricing_config vaule must be different from the value used in the current config for a RepricingConfig.EntitlementGranularity.entitlement. Possible Error Codes: * PERMISSION_DENIED: If the account making the request and the account being queried are different. * INVALID_ARGUMENT: Missing or invalid required parameters in the request. Also displays if the updated config is for the current month or past months. * NOT_FOUND: The CustomerRepricingConfig specified does not exist or is not associated with the given account. * INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. Return Value: If successful, the updated CustomerRepricingConfig resource, otherwise returns an error.", + "description": "Creates a CustomerRepricingConfig. Call this method to set modifications for a specific customer's bill. You can only create configs if the RepricingConfig.effective_invoice_month is a future month. If needed, you can create a config for the current month, with some restrictions. When creating a config for a future month, make sure there are no existing configs for that RepricingConfig.effective_invoice_month. The following restrictions are for creating configs in the current month. * This functionality is reserved for recovering from an erroneous config, and should not be used for regular business cases. * The new config will not modify exports used with other configs. Changes to the config may be immediate, but may take up to 24 hours. * There is a limit of ten configs for any RepricingConfig.EntitlementGranularity.entitlement, for any RepricingConfig.effective_invoice_month. * The contained CustomerRepricingConfig.repricing_config value must be different from the value used in the current config for a RepricingConfig.EntitlementGranularity.entitlement. Possible Error Codes: * PERMISSION_DENIED: If the account making the request and the account being queried are different. * INVALID_ARGUMENT: Missing or invalid required parameters in the request. Also displays if the updated config is for the current month or past months. * NOT_FOUND: The CustomerRepricingConfig specified does not exist or is not associated with the given account. * INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. Return Value: If successful, the updated CustomerRepricingConfig resource, otherwise returns an error.", "flatPath": "v1/accounts/{accountsId}/customers/{customersId}/customerRepricingConfigs", "httpMethod": "POST", "id": "cloudchannel.accounts.customers.customerRepricingConfigs.create", @@ -2178,7 +2178,7 @@ } } }, - "revision": "20230711", + "revision": "20230718", "rootUrl": "https://cloudchannel.googleapis.com/", "schemas": { "GoogleCloudChannelV1ActivateEntitlementRequest": { @@ -4428,7 +4428,7 @@ }, "channelPartnerGranularity": { "$ref": "GoogleCloudChannelV1RepricingConfigChannelPartnerGranularity", - "description": "Applies the repricing configuration at the channel partner level. This is the only supported value for ChannelPartnerRepricingConfig." + "description": "Applies the repricing configuration at the channel partner level. Only ChannelPartnerRepricingConfig supports this value." }, "conditionalOverrides": { "description": "The conditional overrides to apply for this configuration. If you list multiple overrides, only the first valid override is used. If you don't list any overrides, the API uses the normal adjustment and rebilling basis.", @@ -4443,7 +4443,7 @@ }, "entitlementGranularity": { "$ref": "GoogleCloudChannelV1RepricingConfigEntitlementGranularity", - "description": "Applies the repricing configuration at the entitlement level. This is the only supported value for CustomerRepricingConfig." + "description": "Applies the repricing configuration at the entitlement level. Note: If a ChannelPartnerRepricingConfig using RepricingConfig.EntitlementGranularity becomes effective, then no existing or future RepricingConfig.ChannelPartnerGranularity will apply to the RepricingConfig.EntitlementGranularity.entitlement. This is the recommended value for both CustomerRepricingConfig and ChannelPartnerRepricingConfig." }, "rebillingBasis": { "description": "Required. The RebillingBasis to use for this bill. Specifies the relative cost based on repricing costs you will apply.", diff --git a/cloudchannel/v1/cloudchannel-gen.go b/cloudchannel/v1/cloudchannel-gen.go index 393000d854d..be11b7a30cb 100644 --- a/cloudchannel/v1/cloudchannel-gen.go +++ b/cloudchannel/v1/cloudchannel-gen.go @@ -4002,8 +4002,8 @@ type GoogleCloudChannelV1RepricingConfig struct { Adjustment *GoogleCloudChannelV1RepricingAdjustment `json:"adjustment,omitempty"` // ChannelPartnerGranularity: Applies the repricing configuration at the - // channel partner level. This is the only supported value for - // ChannelPartnerRepricingConfig. + // channel partner level. Only ChannelPartnerRepricingConfig supports + // this value. ChannelPartnerGranularity *GoogleCloudChannelV1RepricingConfigChannelPartnerGranularity `json:"channelPartnerGranularity,omitempty"` // ConditionalOverrides: The conditional overrides to apply for this @@ -4018,8 +4018,12 @@ type GoogleCloudChannelV1RepricingConfig struct { EffectiveInvoiceMonth *GoogleTypeDate `json:"effectiveInvoiceMonth,omitempty"` // EntitlementGranularity: Applies the repricing configuration at the - // entitlement level. This is the only supported value for - // CustomerRepricingConfig. + // entitlement level. Note: If a ChannelPartnerRepricingConfig using + // RepricingConfig.EntitlementGranularity becomes effective, then no + // existing or future RepricingConfig.ChannelPartnerGranularity will + // apply to the RepricingConfig.EntitlementGranularity.entitlement. This + // is the recommended value for both CustomerRepricingConfig and + // ChannelPartnerRepricingConfig. EntitlementGranularity *GoogleCloudChannelV1RepricingConfigEntitlementGranularity `json:"entitlementGranularity,omitempty"` // RebillingBasis: Required. The RebillingBasis to use for this bill. @@ -8273,8 +8277,9 @@ type AccountsChannelPartnerLinksChannelPartnerRepricingConfigsCreateCall struct // exports used with other configs. Changes to the config may be // immediate, but may take up to 24 hours. * There is a limit of ten // configs for any ChannelPartner or +// RepricingConfig.EntitlementGranularity.entitlement, for any // RepricingConfig.effective_invoice_month. * The contained -// ChannelPartnerRepricingConfig.repricing_config vaule must be +// ChannelPartnerRepricingConfig.repricing_config value must be // different from the value used in the current config for a // ChannelPartner. Possible Error Codes: * PERMISSION_DENIED: If the // account making the request and the account being queried are @@ -8390,7 +8395,7 @@ func (c *AccountsChannelPartnerLinksChannelPartnerRepricingConfigsCreateCall) Do } return ret, nil // { - // "description": "Creates a ChannelPartnerRepricingConfig. Call this method to set modifications for a specific ChannelPartner's bill. You can only create configs if the RepricingConfig.effective_invoice_month is a future month. If needed, you can create a config for the current month, with some restrictions. When creating a config for a future month, make sure there are no existing configs for that RepricingConfig.effective_invoice_month. The following restrictions are for creating configs in the current month. * This functionality is reserved for recovering from an erroneous config, and should not be used for regular business cases. * The new config will not modify exports used with other configs. Changes to the config may be immediate, but may take up to 24 hours. * There is a limit of ten configs for any ChannelPartner or RepricingConfig.effective_invoice_month. * The contained ChannelPartnerRepricingConfig.repricing_config vaule must be different from the value used in the current config for a ChannelPartner. Possible Error Codes: * PERMISSION_DENIED: If the account making the request and the account being queried are different. * INVALID_ARGUMENT: Missing or invalid required parameters in the request. Also displays if the updated config is for the current month or past months. * NOT_FOUND: The ChannelPartnerRepricingConfig specified does not exist or is not associated with the given account. * INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. Return Value: If successful, the updated ChannelPartnerRepricingConfig resource, otherwise returns an error.", + // "description": "Creates a ChannelPartnerRepricingConfig. Call this method to set modifications for a specific ChannelPartner's bill. You can only create configs if the RepricingConfig.effective_invoice_month is a future month. If needed, you can create a config for the current month, with some restrictions. When creating a config for a future month, make sure there are no existing configs for that RepricingConfig.effective_invoice_month. The following restrictions are for creating configs in the current month. * This functionality is reserved for recovering from an erroneous config, and should not be used for regular business cases. * The new config will not modify exports used with other configs. Changes to the config may be immediate, but may take up to 24 hours. * There is a limit of ten configs for any ChannelPartner or RepricingConfig.EntitlementGranularity.entitlement, for any RepricingConfig.effective_invoice_month. * The contained ChannelPartnerRepricingConfig.repricing_config value must be different from the value used in the current config for a ChannelPartner. Possible Error Codes: * PERMISSION_DENIED: If the account making the request and the account being queried are different. * INVALID_ARGUMENT: Missing or invalid required parameters in the request. Also displays if the updated config is for the current month or past months. * NOT_FOUND: The ChannelPartnerRepricingConfig specified does not exist or is not associated with the given account. * INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. Return Value: If successful, the updated ChannelPartnerRepricingConfig resource, otherwise returns an error.", // "flatPath": "v1/accounts/{accountsId}/channelPartnerLinks/{channelPartnerLinksId}/channelPartnerRepricingConfigs", // "httpMethod": "POST", // "id": "cloudchannel.accounts.channelPartnerLinks.channelPartnerRepricingConfigs.create", @@ -12294,9 +12299,9 @@ type AccountsCustomersCustomerRepricingConfigsCreateCall struct { // be used for regular business cases. * The new config will not modify // exports used with other configs. Changes to the config may be // immediate, but may take up to 24 hours. * There is a limit of ten -// configs for any RepricingConfig.EntitlementGranularity.entitlement or -// RepricingConfig.effective_invoice_month. * The contained -// CustomerRepricingConfig.repricing_config vaule must be different from +// configs for any RepricingConfig.EntitlementGranularity.entitlement, +// for any RepricingConfig.effective_invoice_month. * The contained +// CustomerRepricingConfig.repricing_config value must be different from // the value used in the current config for a // RepricingConfig.EntitlementGranularity.entitlement. Possible Error // Codes: * PERMISSION_DENIED: If the account making the request and the @@ -12412,7 +12417,7 @@ func (c *AccountsCustomersCustomerRepricingConfigsCreateCall) Do(opts ...googlea } return ret, nil // { - // "description": "Creates a CustomerRepricingConfig. Call this method to set modifications for a specific customer's bill. You can only create configs if the RepricingConfig.effective_invoice_month is a future month. If needed, you can create a config for the current month, with some restrictions. When creating a config for a future month, make sure there are no existing configs for that RepricingConfig.effective_invoice_month. The following restrictions are for creating configs in the current month. * This functionality is reserved for recovering from an erroneous config, and should not be used for regular business cases. * The new config will not modify exports used with other configs. Changes to the config may be immediate, but may take up to 24 hours. * There is a limit of ten configs for any RepricingConfig.EntitlementGranularity.entitlement or RepricingConfig.effective_invoice_month. * The contained CustomerRepricingConfig.repricing_config vaule must be different from the value used in the current config for a RepricingConfig.EntitlementGranularity.entitlement. Possible Error Codes: * PERMISSION_DENIED: If the account making the request and the account being queried are different. * INVALID_ARGUMENT: Missing or invalid required parameters in the request. Also displays if the updated config is for the current month or past months. * NOT_FOUND: The CustomerRepricingConfig specified does not exist or is not associated with the given account. * INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. Return Value: If successful, the updated CustomerRepricingConfig resource, otherwise returns an error.", + // "description": "Creates a CustomerRepricingConfig. Call this method to set modifications for a specific customer's bill. You can only create configs if the RepricingConfig.effective_invoice_month is a future month. If needed, you can create a config for the current month, with some restrictions. When creating a config for a future month, make sure there are no existing configs for that RepricingConfig.effective_invoice_month. The following restrictions are for creating configs in the current month. * This functionality is reserved for recovering from an erroneous config, and should not be used for regular business cases. * The new config will not modify exports used with other configs. Changes to the config may be immediate, but may take up to 24 hours. * There is a limit of ten configs for any RepricingConfig.EntitlementGranularity.entitlement, for any RepricingConfig.effective_invoice_month. * The contained CustomerRepricingConfig.repricing_config value must be different from the value used in the current config for a RepricingConfig.EntitlementGranularity.entitlement. Possible Error Codes: * PERMISSION_DENIED: If the account making the request and the account being queried are different. * INVALID_ARGUMENT: Missing or invalid required parameters in the request. Also displays if the updated config is for the current month or past months. * NOT_FOUND: The CustomerRepricingConfig specified does not exist or is not associated with the given account. * INTERNAL: Any non-user error related to technical issues in the backend. In this case, contact Cloud Channel support. Return Value: If successful, the updated CustomerRepricingConfig resource, otherwise returns an error.", // "flatPath": "v1/accounts/{accountsId}/customers/{customersId}/customerRepricingConfigs", // "httpMethod": "POST", // "id": "cloudchannel.accounts.customers.customerRepricingConfigs.create", diff --git a/cloudfunctions/v1/cloudfunctions-api.json b/cloudfunctions/v1/cloudfunctions-api.json index 2e184fa0ebe..e5d423bbe9b 100644 --- a/cloudfunctions/v1/cloudfunctions-api.json +++ b/cloudfunctions/v1/cloudfunctions-api.json @@ -546,7 +546,7 @@ } } }, - "revision": "20230608", + "revision": "20230713", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AuditConfig": { @@ -1018,6 +1018,10 @@ "description": "The original request that started the operation.", "type": "object" }, + "sourceToken": { + "description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.", + "type": "string" + }, "stages": { "description": "Mechanism for reporting in-progress stages", "items": { @@ -1189,6 +1193,10 @@ "description": "The original request that started the operation.", "type": "object" }, + "sourceToken": { + "description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.", + "type": "string" + }, "stages": { "description": "Mechanism for reporting in-progress stages", "items": { @@ -1360,6 +1368,10 @@ "description": "The original request that started the operation.", "type": "object" }, + "sourceToken": { + "description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.", + "type": "string" + }, "stages": { "description": "Mechanism for reporting in-progress stages", "items": { diff --git a/cloudfunctions/v1/cloudfunctions-gen.go b/cloudfunctions/v1/cloudfunctions-gen.go index a5b2c153c9d..9e8b739f82f 100644 --- a/cloudfunctions/v1/cloudfunctions-gen.go +++ b/cloudfunctions/v1/cloudfunctions-gen.go @@ -1044,6 +1044,10 @@ type GoogleCloudFunctionsV2OperationMetadata struct { // RequestResource: The original request that started the operation. RequestResource googleapi.RawMessage `json:"requestResource,omitempty"` + // SourceToken: An identifier for Firebase function sources. Disclaimer: + // This field is only supported for Firebase function deployments. + SourceToken string `json:"sourceToken,omitempty"` + // Stages: Mechanism for reporting in-progress stages Stages []*GoogleCloudFunctionsV2Stage `json:"stages,omitempty"` @@ -1233,6 +1237,10 @@ type GoogleCloudFunctionsV2alphaOperationMetadata struct { // RequestResource: The original request that started the operation. RequestResource googleapi.RawMessage `json:"requestResource,omitempty"` + // SourceToken: An identifier for Firebase function sources. Disclaimer: + // This field is only supported for Firebase function deployments. + SourceToken string `json:"sourceToken,omitempty"` + // Stages: Mechanism for reporting in-progress stages Stages []*GoogleCloudFunctionsV2alphaStage `json:"stages,omitempty"` @@ -1423,6 +1431,10 @@ type GoogleCloudFunctionsV2betaOperationMetadata struct { // RequestResource: The original request that started the operation. RequestResource googleapi.RawMessage `json:"requestResource,omitempty"` + // SourceToken: An identifier for Firebase function sources. Disclaimer: + // This field is only supported for Firebase function deployments. + SourceToken string `json:"sourceToken,omitempty"` + // Stages: Mechanism for reporting in-progress stages Stages []*GoogleCloudFunctionsV2betaStage `json:"stages,omitempty"` diff --git a/cloudfunctions/v2/cloudfunctions-api.json b/cloudfunctions/v2/cloudfunctions-api.json index 930040adbec..12ee3248d26 100644 --- a/cloudfunctions/v2/cloudfunctions-api.json +++ b/cloudfunctions/v2/cloudfunctions-api.json @@ -571,7 +571,7 @@ } } }, - "revision": "20230622", + "revision": "20230713", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AuditConfig": { @@ -695,6 +695,10 @@ "description": "Output only. A permanent fixed identifier for source.", "readOnly": true }, + "sourceToken": { + "description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.", + "type": "string" + }, "workerPool": { "description": "Name of the Cloud Build Custom Worker Pool that should be used to build the function. The format of this field is `projects/{project}/locations/{region}/workerPools/{workerPool}` where {project} and {region} are the project id and region respectively where the worker pool is defined and {workerPool} is the short name of the worker pool. If the project id is not the same as the function, then the Cloud Functions Service Agent (service-@gcf-admin-robot.iam.gserviceaccount.com) must be granted the role Cloud Build Custom Workers Builder (roles/cloudbuild.customworkers.builder) in the project.", "type": "string" @@ -991,6 +995,10 @@ "description": "The original request that started the operation.", "type": "object" }, + "sourceToken": { + "description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.", + "type": "string" + }, "stages": { "description": "Mechanism for reporting in-progress stages", "items": { @@ -1162,6 +1170,10 @@ "description": "The original request that started the operation.", "type": "object" }, + "sourceToken": { + "description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.", + "type": "string" + }, "stages": { "description": "Mechanism for reporting in-progress stages", "items": { @@ -1333,6 +1345,10 @@ "description": "The original request that started the operation.", "type": "object" }, + "sourceToken": { + "description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.", + "type": "string" + }, "stages": { "description": "Mechanism for reporting in-progress stages", "items": { diff --git a/cloudfunctions/v2/cloudfunctions-gen.go b/cloudfunctions/v2/cloudfunctions-gen.go index 7386d5430cf..2c74b3b9d77 100644 --- a/cloudfunctions/v2/cloudfunctions-gen.go +++ b/cloudfunctions/v2/cloudfunctions-gen.go @@ -433,6 +433,10 @@ type BuildConfig struct { // source. SourceProvenance *SourceProvenance `json:"sourceProvenance,omitempty"` + // SourceToken: An identifier for Firebase function sources. Disclaimer: + // This field is only supported for Firebase function deployments. + SourceToken string `json:"sourceToken,omitempty"` + // WorkerPool: Name of the Cloud Build Custom Worker Pool that should be // used to build the function. The format of this field is // `projects/{project}/locations/{region}/workerPools/{workerPool}` @@ -917,6 +921,10 @@ type GoogleCloudFunctionsV2OperationMetadata struct { // RequestResource: The original request that started the operation. RequestResource googleapi.RawMessage `json:"requestResource,omitempty"` + // SourceToken: An identifier for Firebase function sources. Disclaimer: + // This field is only supported for Firebase function deployments. + SourceToken string `json:"sourceToken,omitempty"` + // Stages: Mechanism for reporting in-progress stages Stages []*GoogleCloudFunctionsV2Stage `json:"stages,omitempty"` @@ -1106,6 +1114,10 @@ type GoogleCloudFunctionsV2alphaOperationMetadata struct { // RequestResource: The original request that started the operation. RequestResource googleapi.RawMessage `json:"requestResource,omitempty"` + // SourceToken: An identifier for Firebase function sources. Disclaimer: + // This field is only supported for Firebase function deployments. + SourceToken string `json:"sourceToken,omitempty"` + // Stages: Mechanism for reporting in-progress stages Stages []*GoogleCloudFunctionsV2alphaStage `json:"stages,omitempty"` @@ -1296,6 +1308,10 @@ type GoogleCloudFunctionsV2betaOperationMetadata struct { // RequestResource: The original request that started the operation. RequestResource googleapi.RawMessage `json:"requestResource,omitempty"` + // SourceToken: An identifier for Firebase function sources. Disclaimer: + // This field is only supported for Firebase function deployments. + SourceToken string `json:"sourceToken,omitempty"` + // Stages: Mechanism for reporting in-progress stages Stages []*GoogleCloudFunctionsV2betaStage `json:"stages,omitempty"` diff --git a/cloudfunctions/v2alpha/cloudfunctions-api.json b/cloudfunctions/v2alpha/cloudfunctions-api.json index 5c246d8c26c..ec1984f0b91 100644 --- a/cloudfunctions/v2alpha/cloudfunctions-api.json +++ b/cloudfunctions/v2alpha/cloudfunctions-api.json @@ -571,7 +571,7 @@ } } }, - "revision": "20230622", + "revision": "20230713", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AuditConfig": { @@ -695,6 +695,10 @@ "description": "Output only. A permanent fixed identifier for source.", "readOnly": true }, + "sourceToken": { + "description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.", + "type": "string" + }, "workerPool": { "description": "Name of the Cloud Build Custom Worker Pool that should be used to build the function. The format of this field is `projects/{project}/locations/{region}/workerPools/{workerPool}` where {project} and {region} are the project id and region respectively where the worker pool is defined and {workerPool} is the short name of the worker pool. If the project id is not the same as the function, then the Cloud Functions Service Agent (service-@gcf-admin-robot.iam.gserviceaccount.com) must be granted the role Cloud Build Custom Workers Builder (roles/cloudbuild.customworkers.builder) in the project.", "type": "string" @@ -991,6 +995,10 @@ "description": "The original request that started the operation.", "type": "object" }, + "sourceToken": { + "description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.", + "type": "string" + }, "stages": { "description": "Mechanism for reporting in-progress stages", "items": { @@ -1162,6 +1170,10 @@ "description": "The original request that started the operation.", "type": "object" }, + "sourceToken": { + "description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.", + "type": "string" + }, "stages": { "description": "Mechanism for reporting in-progress stages", "items": { @@ -1333,6 +1345,10 @@ "description": "The original request that started the operation.", "type": "object" }, + "sourceToken": { + "description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.", + "type": "string" + }, "stages": { "description": "Mechanism for reporting in-progress stages", "items": { diff --git a/cloudfunctions/v2alpha/cloudfunctions-gen.go b/cloudfunctions/v2alpha/cloudfunctions-gen.go index 1c0420b5165..2f6d15dc3e9 100644 --- a/cloudfunctions/v2alpha/cloudfunctions-gen.go +++ b/cloudfunctions/v2alpha/cloudfunctions-gen.go @@ -433,6 +433,10 @@ type BuildConfig struct { // source. SourceProvenance *SourceProvenance `json:"sourceProvenance,omitempty"` + // SourceToken: An identifier for Firebase function sources. Disclaimer: + // This field is only supported for Firebase function deployments. + SourceToken string `json:"sourceToken,omitempty"` + // WorkerPool: Name of the Cloud Build Custom Worker Pool that should be // used to build the function. The format of this field is // `projects/{project}/locations/{region}/workerPools/{workerPool}` @@ -917,6 +921,10 @@ type GoogleCloudFunctionsV2OperationMetadata struct { // RequestResource: The original request that started the operation. RequestResource googleapi.RawMessage `json:"requestResource,omitempty"` + // SourceToken: An identifier for Firebase function sources. Disclaimer: + // This field is only supported for Firebase function deployments. + SourceToken string `json:"sourceToken,omitempty"` + // Stages: Mechanism for reporting in-progress stages Stages []*GoogleCloudFunctionsV2Stage `json:"stages,omitempty"` @@ -1106,6 +1114,10 @@ type GoogleCloudFunctionsV2alphaOperationMetadata struct { // RequestResource: The original request that started the operation. RequestResource googleapi.RawMessage `json:"requestResource,omitempty"` + // SourceToken: An identifier for Firebase function sources. Disclaimer: + // This field is only supported for Firebase function deployments. + SourceToken string `json:"sourceToken,omitempty"` + // Stages: Mechanism for reporting in-progress stages Stages []*GoogleCloudFunctionsV2alphaStage `json:"stages,omitempty"` @@ -1296,6 +1308,10 @@ type GoogleCloudFunctionsV2betaOperationMetadata struct { // RequestResource: The original request that started the operation. RequestResource googleapi.RawMessage `json:"requestResource,omitempty"` + // SourceToken: An identifier for Firebase function sources. Disclaimer: + // This field is only supported for Firebase function deployments. + SourceToken string `json:"sourceToken,omitempty"` + // Stages: Mechanism for reporting in-progress stages Stages []*GoogleCloudFunctionsV2betaStage `json:"stages,omitempty"` diff --git a/cloudfunctions/v2beta/cloudfunctions-api.json b/cloudfunctions/v2beta/cloudfunctions-api.json index 8c2be7c38da..bcebc292788 100644 --- a/cloudfunctions/v2beta/cloudfunctions-api.json +++ b/cloudfunctions/v2beta/cloudfunctions-api.json @@ -571,7 +571,7 @@ } } }, - "revision": "20230622", + "revision": "20230713", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AuditConfig": { @@ -695,6 +695,10 @@ "description": "Output only. A permanent fixed identifier for source.", "readOnly": true }, + "sourceToken": { + "description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.", + "type": "string" + }, "workerPool": { "description": "Name of the Cloud Build Custom Worker Pool that should be used to build the function. The format of this field is `projects/{project}/locations/{region}/workerPools/{workerPool}` where {project} and {region} are the project id and region respectively where the worker pool is defined and {workerPool} is the short name of the worker pool. If the project id is not the same as the function, then the Cloud Functions Service Agent (service-@gcf-admin-robot.iam.gserviceaccount.com) must be granted the role Cloud Build Custom Workers Builder (roles/cloudbuild.customworkers.builder) in the project.", "type": "string" @@ -991,6 +995,10 @@ "description": "The original request that started the operation.", "type": "object" }, + "sourceToken": { + "description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.", + "type": "string" + }, "stages": { "description": "Mechanism for reporting in-progress stages", "items": { @@ -1162,6 +1170,10 @@ "description": "The original request that started the operation.", "type": "object" }, + "sourceToken": { + "description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.", + "type": "string" + }, "stages": { "description": "Mechanism for reporting in-progress stages", "items": { @@ -1333,6 +1345,10 @@ "description": "The original request that started the operation.", "type": "object" }, + "sourceToken": { + "description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.", + "type": "string" + }, "stages": { "description": "Mechanism for reporting in-progress stages", "items": { diff --git a/cloudfunctions/v2beta/cloudfunctions-gen.go b/cloudfunctions/v2beta/cloudfunctions-gen.go index 821607c0545..705bfa600f2 100644 --- a/cloudfunctions/v2beta/cloudfunctions-gen.go +++ b/cloudfunctions/v2beta/cloudfunctions-gen.go @@ -433,6 +433,10 @@ type BuildConfig struct { // source. SourceProvenance *SourceProvenance `json:"sourceProvenance,omitempty"` + // SourceToken: An identifier for Firebase function sources. Disclaimer: + // This field is only supported for Firebase function deployments. + SourceToken string `json:"sourceToken,omitempty"` + // WorkerPool: Name of the Cloud Build Custom Worker Pool that should be // used to build the function. The format of this field is // `projects/{project}/locations/{region}/workerPools/{workerPool}` @@ -917,6 +921,10 @@ type GoogleCloudFunctionsV2OperationMetadata struct { // RequestResource: The original request that started the operation. RequestResource googleapi.RawMessage `json:"requestResource,omitempty"` + // SourceToken: An identifier for Firebase function sources. Disclaimer: + // This field is only supported for Firebase function deployments. + SourceToken string `json:"sourceToken,omitempty"` + // Stages: Mechanism for reporting in-progress stages Stages []*GoogleCloudFunctionsV2Stage `json:"stages,omitempty"` @@ -1106,6 +1114,10 @@ type GoogleCloudFunctionsV2alphaOperationMetadata struct { // RequestResource: The original request that started the operation. RequestResource googleapi.RawMessage `json:"requestResource,omitempty"` + // SourceToken: An identifier for Firebase function sources. Disclaimer: + // This field is only supported for Firebase function deployments. + SourceToken string `json:"sourceToken,omitempty"` + // Stages: Mechanism for reporting in-progress stages Stages []*GoogleCloudFunctionsV2alphaStage `json:"stages,omitempty"` @@ -1296,6 +1308,10 @@ type GoogleCloudFunctionsV2betaOperationMetadata struct { // RequestResource: The original request that started the operation. RequestResource googleapi.RawMessage `json:"requestResource,omitempty"` + // SourceToken: An identifier for Firebase function sources. Disclaimer: + // This field is only supported for Firebase function deployments. + SourceToken string `json:"sourceToken,omitempty"` + // Stages: Mechanism for reporting in-progress stages Stages []*GoogleCloudFunctionsV2betaStage `json:"stages,omitempty"` diff --git a/connectors/v1/connectors-api.json b/connectors/v1/connectors-api.json index ea85f5d9041..ea812fbae7a 100644 --- a/connectors/v1/connectors-api.json +++ b/connectors/v1/connectors-api.json @@ -436,7 +436,7 @@ "type": "string" }, "updateMask": { - "description": "Required. You can modify only the fields listed below. To lock/unlock a connection: * `lock_config` To suspend/resume a connection: * `suspended` To update the connection details: * `description` * `labels` * `connector_version` * `config_variables` * `auth_config` * `destination_configs` * `node_config`", + "description": "Required. You can modify only the fields listed below. To lock/unlock a connection: * `lock_config` To suspend/resume a connection: * `suspended` To update the connection details: * `description` * `labels` * `connector_version` * `config_variables` * `auth_config` * `destination_configs` * `node_config` * `log_config` * `ssl_config` * `eventing_enablement_type` * `eventing_config`", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1773,7 +1773,7 @@ } } }, - "revision": "20230706", + "revision": "20230712", "rootUrl": "https://connectors.googleapis.com/", "schemas": { "AuditConfig": { diff --git a/connectors/v1/connectors-gen.go b/connectors/v1/connectors-gen.go index b8e3a20c480..6cce3145389 100644 --- a/connectors/v1/connectors-gen.go +++ b/connectors/v1/connectors-gen.go @@ -5984,7 +5984,8 @@ func (r *ProjectsLocationsConnectionsService) Patch(name string, connection *Con // * `lock_config` To suspend/resume a connection: * `suspended` To // update the connection details: * `description` * `labels` * // `connector_version` * `config_variables` * `auth_config` * -// `destination_configs` * `node_config` +// `destination_configs` * `node_config` * `log_config` * `ssl_config` * +// `eventing_enablement_type` * `eventing_config` func (c *ProjectsLocationsConnectionsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsConnectionsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -6097,7 +6098,7 @@ func (c *ProjectsLocationsConnectionsPatchCall) Do(opts ...googleapi.CallOption) // "type": "string" // }, // "updateMask": { - // "description": "Required. You can modify only the fields listed below. To lock/unlock a connection: * `lock_config` To suspend/resume a connection: * `suspended` To update the connection details: * `description` * `labels` * `connector_version` * `config_variables` * `auth_config` * `destination_configs` * `node_config`", + // "description": "Required. You can modify only the fields listed below. To lock/unlock a connection: * `lock_config` To suspend/resume a connection: * `suspended` To update the connection details: * `description` * `labels` * `connector_version` * `config_variables` * `auth_config` * `destination_configs` * `node_config` * `log_config` * `ssl_config` * `eventing_enablement_type` * `eventing_config`", // "format": "google-fieldmask", // "location": "query", // "type": "string" diff --git a/datastore/v1/datastore-api.json b/datastore/v1/datastore-api.json index a9d608e2665..f8c9b9ad3ce 100644 --- a/datastore/v1/datastore-api.json +++ b/datastore/v1/datastore-api.json @@ -654,7 +654,7 @@ } } }, - "revision": "20230508", + "revision": "20230716", "rootUrl": "https://datastore.googleapis.com/", "schemas": { "Aggregation": { @@ -2178,7 +2178,7 @@ "id": "ReadOnly", "properties": { "readTime": { - "description": "Reads entities at the given time. This may not be older than 60 seconds.", + "description": "Reads entities at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "type": "string" } @@ -2208,7 +2208,7 @@ "type": "string" }, "readTime": { - "description": "Reads entities as they were at the given time. This may not be older than 270 seconds. This value is only supported for Cloud Firestore in Datastore mode.", + "description": "Reads entities as they were at the given time. This value is only supported for Cloud Firestore in Datastore mode. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "type": "string" }, diff --git a/datastore/v1/datastore-gen.go b/datastore/v1/datastore-gen.go index 697648e459f..00be8667cc2 100644 --- a/datastore/v1/datastore-gen.go +++ b/datastore/v1/datastore-gen.go @@ -2758,8 +2758,10 @@ func (s *QueryResultBatch) MarshalJSON() ([]byte, error) { // ReadOnly: Options specific to read-only transactions. type ReadOnly struct { - // ReadTime: Reads entities at the given time. This may not be older - // than 60 seconds. + // ReadTime: Reads entities at the given time. This must be a + // microsecond precision timestamp within the past one hour, or if + // Point-in-Time Recovery is enabled, can additionally be a whole minute + // timestamp within the past 7 days. ReadTime string `json:"readTime,omitempty"` // ForceSendFields is a list of field names (e.g. "ReadTime") to @@ -2802,9 +2804,11 @@ type ReadOptions struct { // "EVENTUAL" - Eventual consistency. ReadConsistency string `json:"readConsistency,omitempty"` - // ReadTime: Reads entities as they were at the given time. This may not - // be older than 270 seconds. This value is only supported for Cloud - // Firestore in Datastore mode. + // ReadTime: Reads entities as they were at the given time. This value + // is only supported for Cloud Firestore in Datastore mode. This must be + // a microsecond precision timestamp within the past one hour, or if + // Point-in-Time Recovery is enabled, can additionally be a whole minute + // timestamp within the past 7 days. ReadTime string `json:"readTime,omitempty"` // Transaction: The identifier of the transaction in which to read. A diff --git a/datastore/v1beta3/datastore-api.json b/datastore/v1beta3/datastore-api.json index 79de25e284c..d2542dd8095 100644 --- a/datastore/v1beta3/datastore-api.json +++ b/datastore/v1beta3/datastore-api.json @@ -336,7 +336,7 @@ } } }, - "revision": "20230508", + "revision": "20230716", "rootUrl": "https://datastore.googleapis.com/", "schemas": { "Aggregation": { @@ -1624,7 +1624,7 @@ "id": "ReadOnly", "properties": { "readTime": { - "description": "Reads entities at the given time. This may not be older than 60 seconds.", + "description": "Reads entities at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "type": "string" } @@ -1650,7 +1650,7 @@ "type": "string" }, "readTime": { - "description": "Reads entities as they were at the given time. This may not be older than 270 seconds. This value is only supported for Cloud Firestore in Datastore mode.", + "description": "Reads entities as they were at the given time. This value is only supported for Cloud Firestore in Datastore mode. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "type": "string" }, diff --git a/datastore/v1beta3/datastore-gen.go b/datastore/v1beta3/datastore-gen.go index 7d8ef5a209d..61da21a94dd 100644 --- a/datastore/v1beta3/datastore-gen.go +++ b/datastore/v1beta3/datastore-gen.go @@ -2341,8 +2341,10 @@ func (s *QueryResultBatch) MarshalJSON() ([]byte, error) { // ReadOnly: Options specific to read-only transactions. type ReadOnly struct { - // ReadTime: Reads entities at the given time. This may not be older - // than 60 seconds. + // ReadTime: Reads entities at the given time. This must be a + // microsecond precision timestamp within the past one hour, or if + // Point-in-Time Recovery is enabled, can additionally be a whole minute + // timestamp within the past 7 days. ReadTime string `json:"readTime,omitempty"` // ForceSendFields is a list of field names (e.g. "ReadTime") to @@ -2379,9 +2381,11 @@ type ReadOptions struct { // "EVENTUAL" - Eventual consistency. ReadConsistency string `json:"readConsistency,omitempty"` - // ReadTime: Reads entities as they were at the given time. This may not - // be older than 270 seconds. This value is only supported for Cloud - // Firestore in Datastore mode. + // ReadTime: Reads entities as they were at the given time. This value + // is only supported for Cloud Firestore in Datastore mode. This must be + // a microsecond precision timestamp within the past one hour, or if + // Point-in-Time Recovery is enabled, can additionally be a whole minute + // timestamp within the past 7 days. ReadTime string `json:"readTime,omitempty"` // Transaction: The identifier of the transaction in which to read. A diff --git a/datastream/v1/datastream-api.json b/datastream/v1/datastream-api.json index 7db2154b3a5..5bdbf66f4b8 100644 --- a/datastream/v1/datastream-api.json +++ b/datastream/v1/datastream-api.json @@ -1233,7 +1233,7 @@ } } }, - "revision": "20230611", + "revision": "20230630", "rootUrl": "https://datastream.googleapis.com/", "schemas": { "AvroFileFormat": { @@ -1922,9 +1922,19 @@ "format": "int32", "type": "integer" }, + "precision": { + "description": "Column precision.", + "format": "int32", + "type": "integer" + }, "primaryKey": { "description": "Whether or not the column represents a primary key.", "type": "boolean" + }, + "scale": { + "description": "Column scale.", + "format": "int32", + "type": "integer" } }, "type": "object" diff --git a/datastream/v1/datastream-gen.go b/datastream/v1/datastream-gen.go index 7b3ce7d6a5e..b8c83a34a99 100644 --- a/datastream/v1/datastream-gen.go +++ b/datastream/v1/datastream-gen.go @@ -1260,9 +1260,15 @@ type MysqlColumn struct { // OrdinalPosition: The ordinal position of the column in the table. OrdinalPosition int64 `json:"ordinalPosition,omitempty"` + // Precision: Column precision. + Precision int64 `json:"precision,omitempty"` + // PrimaryKey: Whether or not the column represents a primary key. PrimaryKey bool `json:"primaryKey,omitempty"` + // Scale: Column scale. + Scale int64 `json:"scale,omitempty"` + // ForceSendFields is a list of field names (e.g. "Collation") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any diff --git a/discoveryengine/v1alpha/discoveryengine-api.json b/discoveryengine/v1alpha/discoveryengine-api.json index 7d31d4ea8f3..db763e7ebae 100644 --- a/discoveryengine/v1alpha/discoveryengine-api.json +++ b/discoveryengine/v1alpha/discoveryengine-api.json @@ -649,6 +649,154 @@ } } }, + "siteSearchEngine": { + "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": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/siteSearchEngine/operations/{operationsId}", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/siteSearchEngine/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "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}/dataStores/{dataStoresId}/siteSearchEngine/operations", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.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/[^/]+/dataStores/[^/]+/siteSearchEngine$", + "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" + ] + } + } + }, + "targetSites": { + "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": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/siteSearchEngine/targetSites/operations/{operationsId}", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/siteSearchEngine/targetSites/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "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}/dataStores/{dataStoresId}/siteSearchEngine/targetSites/operations", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.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/[^/]+/dataStores/[^/]+/siteSearchEngine/targetSites$", + "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" + ] + } + } + } + } + } + } + }, "userEvents": { "methods": { "collect": { @@ -1666,7 +1814,7 @@ } } }, - "revision": "20230629", + "revision": "20230713", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiHttpBody": { diff --git a/discoveryengine/v1alpha/discoveryengine-gen.go b/discoveryengine/v1alpha/discoveryengine-gen.go index fd6b9a91856..fa0fee26381 100644 --- a/discoveryengine/v1alpha/discoveryengine-gen.go +++ b/discoveryengine/v1alpha/discoveryengine-gen.go @@ -196,6 +196,7 @@ func NewProjectsLocationsCollectionsDataStoresService(s *Service) *ProjectsLocat rs.Operations = NewProjectsLocationsCollectionsDataStoresOperationsService(s) rs.Schemas = NewProjectsLocationsCollectionsDataStoresSchemasService(s) rs.ServingConfigs = NewProjectsLocationsCollectionsDataStoresServingConfigsService(s) + rs.SiteSearchEngine = NewProjectsLocationsCollectionsDataStoresSiteSearchEngineService(s) rs.UserEvents = NewProjectsLocationsCollectionsDataStoresUserEventsService(s) return rs } @@ -213,6 +214,8 @@ type ProjectsLocationsCollectionsDataStoresService struct { ServingConfigs *ProjectsLocationsCollectionsDataStoresServingConfigsService + SiteSearchEngine *ProjectsLocationsCollectionsDataStoresSiteSearchEngineService + UserEvents *ProjectsLocationsCollectionsDataStoresUserEventsService } @@ -309,6 +312,51 @@ type ProjectsLocationsCollectionsDataStoresServingConfigsService struct { s *Service } +func NewProjectsLocationsCollectionsDataStoresSiteSearchEngineService(s *Service) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineService { + rs := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineService{s: s} + rs.Operations = NewProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService(s) + rs.TargetSites = NewProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService(s) + return rs +} + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineService struct { + s *Service + + Operations *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService + + TargetSites *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService +} + +func NewProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService(s *Service) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService { + rs := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService{s: s} + return rs +} + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService struct { + s *Service +} + +func NewProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService(s *Service) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService { + rs := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService{s: s} + rs.Operations = NewProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService(s) + return rs +} + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService struct { + s *Service + + Operations *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService +} + +func NewProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService(s *Service) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService { + rs := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService{s: s} + return rs +} + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService struct { + s *Service +} + func NewProjectsLocationsCollectionsDataStoresUserEventsService(s *Service) *ProjectsLocationsCollectionsDataStoresUserEventsService { rs := &ProjectsLocationsCollectionsDataStoresUserEventsService{s: s} return rs @@ -6060,6 +6108,716 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall) Do(o } +// method id "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.get": + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall{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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) 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 "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) 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}/siteSearchEngine/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/siteSearchEngine/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.siteSearchEngine.operations.list": + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) 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.siteSearchEngine.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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) 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}/dataStores/{dataStoresId}/siteSearchEngine/operations", + // "httpMethod": "GET", + // "id": "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.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/[^/]+/dataStores/[^/]+/siteSearchEngine$", + // "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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) 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.dataStores.siteSearchEngine.targetSites.operations.get": + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall{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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := 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 "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) 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}/siteSearchEngine/targetSites/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/siteSearchEngine/targetSites/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.siteSearchEngine.targetSites.operations.list": + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) 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.siteSearchEngine.targetSites.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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) 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}/dataStores/{dataStoresId}/siteSearchEngine/targetSites/operations", + // "httpMethod": "GET", + // "id": "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.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/[^/]+/dataStores/[^/]+/siteSearchEngine/targetSites$", + // "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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) 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.dataStores.userEvents.collect": type ProjectsLocationsCollectionsDataStoresUserEventsCollectCall struct { diff --git a/discoveryengine/v1beta/discoveryengine-api.json b/discoveryengine/v1beta/discoveryengine-api.json index 3dc6e3c6ce9..f1c28f961f2 100644 --- a/discoveryengine/v1beta/discoveryengine-api.json +++ b/discoveryengine/v1beta/discoveryengine-api.json @@ -649,6 +649,154 @@ } } }, + "siteSearchEngine": { + "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": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/siteSearchEngine/operations/{operationsId}", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/siteSearchEngine/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "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}/dataStores/{dataStoresId}/siteSearchEngine/operations", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.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/[^/]+/dataStores/[^/]+/siteSearchEngine$", + "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" + ] + } + } + }, + "targetSites": { + "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": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/siteSearchEngine/targetSites/operations/{operationsId}", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/siteSearchEngine/targetSites/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "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}/dataStores/{dataStoresId}/siteSearchEngine/targetSites/operations", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.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/[^/]+/dataStores/[^/]+/siteSearchEngine/targetSites$", + "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" + ] + } + } + } + } + } + } + }, "userEvents": { "methods": { "collect": { @@ -1610,7 +1758,7 @@ } } }, - "revision": "20230629", + "revision": "20230713", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiHttpBody": { diff --git a/discoveryengine/v1beta/discoveryengine-gen.go b/discoveryengine/v1beta/discoveryengine-gen.go index e9fb7130b78..2bb49a1b824 100644 --- a/discoveryengine/v1beta/discoveryengine-gen.go +++ b/discoveryengine/v1beta/discoveryengine-gen.go @@ -196,6 +196,7 @@ func NewProjectsLocationsCollectionsDataStoresService(s *Service) *ProjectsLocat rs.Operations = NewProjectsLocationsCollectionsDataStoresOperationsService(s) rs.Schemas = NewProjectsLocationsCollectionsDataStoresSchemasService(s) rs.ServingConfigs = NewProjectsLocationsCollectionsDataStoresServingConfigsService(s) + rs.SiteSearchEngine = NewProjectsLocationsCollectionsDataStoresSiteSearchEngineService(s) rs.UserEvents = NewProjectsLocationsCollectionsDataStoresUserEventsService(s) return rs } @@ -213,6 +214,8 @@ type ProjectsLocationsCollectionsDataStoresService struct { ServingConfigs *ProjectsLocationsCollectionsDataStoresServingConfigsService + SiteSearchEngine *ProjectsLocationsCollectionsDataStoresSiteSearchEngineService + UserEvents *ProjectsLocationsCollectionsDataStoresUserEventsService } @@ -309,6 +312,51 @@ type ProjectsLocationsCollectionsDataStoresServingConfigsService struct { s *Service } +func NewProjectsLocationsCollectionsDataStoresSiteSearchEngineService(s *Service) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineService { + rs := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineService{s: s} + rs.Operations = NewProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService(s) + rs.TargetSites = NewProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService(s) + return rs +} + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineService struct { + s *Service + + Operations *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService + + TargetSites *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService +} + +func NewProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService(s *Service) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService { + rs := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService{s: s} + return rs +} + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService struct { + s *Service +} + +func NewProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService(s *Service) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService { + rs := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService{s: s} + rs.Operations = NewProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService(s) + return rs +} + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesService struct { + s *Service + + Operations *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService +} + +func NewProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService(s *Service) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService { + rs := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService{s: s} + return rs +} + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService struct { + s *Service +} + func NewProjectsLocationsCollectionsDataStoresUserEventsService(s *Service) *ProjectsLocationsCollectionsDataStoresUserEventsService { rs := &ProjectsLocationsCollectionsDataStoresUserEventsService{s: s} return rs @@ -6012,6 +6060,716 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsRecommendCall) Do(o } +// method id "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.get": + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall{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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) 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}") + 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.siteSearchEngine.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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsGetCall) 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}/siteSearchEngine/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/siteSearchEngine/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.siteSearchEngine.operations.list": + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) 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.siteSearchEngine.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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) 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}/dataStores/{dataStoresId}/siteSearchEngine/operations", + // "httpMethod": "GET", + // "id": "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.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/[^/]+/dataStores/[^/]+/siteSearchEngine$", + // "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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineOperationsListCall) 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.dataStores.siteSearchEngine.targetSites.operations.get": + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService) Get(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall{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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := 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}") + 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.siteSearchEngine.targetSites.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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsGetCall) 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}/siteSearchEngine/targetSites/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/siteSearchEngine/targetSites/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.siteSearchEngine.targetSites.operations.list": + +type ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsService) List(name string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { + c := &ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Filter(filter string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) PageToken(pageToken string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall { + 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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) 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.siteSearchEngine.targetSites.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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) 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}/dataStores/{dataStoresId}/siteSearchEngine/targetSites/operations", + // "httpMethod": "GET", + // "id": "discoveryengine.projects.locations.collections.dataStores.siteSearchEngine.targetSites.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/[^/]+/dataStores/[^/]+/siteSearchEngine/targetSites$", + // "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 *ProjectsLocationsCollectionsDataStoresSiteSearchEngineTargetSitesOperationsListCall) 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.dataStores.userEvents.collect": type ProjectsLocationsCollectionsDataStoresUserEventsCollectCall struct { diff --git a/documentai/v1/documentai-api.json b/documentai/v1/documentai-api.json index 8ce800ceb15..74f00c5141a 100644 --- a/documentai/v1/documentai-api.json +++ b/documentai/v1/documentai-api.json @@ -1042,7 +1042,7 @@ } } }, - "revision": "20230712", + "revision": "20230714", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -1928,10 +1928,6 @@ "gcsPrefix": { "$ref": "GoogleCloudDocumentaiV1GcsPrefix", "description": "The set of documents that match the specified Cloud Storage `gcs_prefix`." - }, - "rawDocuments": { - "$ref": "GoogleCloudDocumentaiV1RawDocuments", - "description": "The set of documents specified inline." } }, "type": "object" @@ -4241,8 +4237,7 @@ "description": "The schema of the processor version. Describes the output." }, "googleManaged": { - "description": "Output only. Denotes that this `ProcessorVersion` is managed by Google.", - "readOnly": true, + "description": "Denotes that this `ProcessorVersion` is managed by Google.", "type": "boolean" }, "kmsKeyName": { @@ -4322,20 +4317,6 @@ }, "type": "object" }, - "GoogleCloudDocumentaiV1RawDocuments": { - "description": "Specifies a set of raw documents.", - "id": "GoogleCloudDocumentaiV1RawDocuments", - "properties": { - "documents": { - "description": "Specifies raw document content and mime type.", - "items": { - "$ref": "GoogleCloudDocumentaiV1RawDocument" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata": { "description": "The long-running operation metadata for the ReviewDocument method.", "id": "GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata", diff --git a/documentai/v1/documentai-gen.go b/documentai/v1/documentai-gen.go index 8c20c8c7197..dd7453c6c8e 100644 --- a/documentai/v1/documentai-gen.go +++ b/documentai/v1/documentai-gen.go @@ -1907,9 +1907,6 @@ type GoogleCloudDocumentaiV1BatchDocumentsInputConfig struct { // Storage `gcs_prefix`. GcsPrefix *GoogleCloudDocumentaiV1GcsPrefix `json:"gcsPrefix,omitempty"` - // RawDocuments: The set of documents specified inline. - RawDocuments *GoogleCloudDocumentaiV1RawDocuments `json:"rawDocuments,omitempty"` - // ForceSendFields is a list of field names (e.g. "GcsDocuments") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -5710,8 +5707,8 @@ type GoogleCloudDocumentaiV1ProcessorVersion struct { // output. DocumentSchema *GoogleCloudDocumentaiV1DocumentSchema `json:"documentSchema,omitempty"` - // GoogleManaged: Output only. Denotes that this `ProcessorVersion` is - // managed by Google. + // GoogleManaged: Denotes that this `ProcessorVersion` is managed by + // Google. GoogleManaged bool `json:"googleManaged,omitempty"` // KmsKeyName: The KMS key name used for encryption. @@ -5842,35 +5839,6 @@ func (s *GoogleCloudDocumentaiV1RawDocument) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudDocumentaiV1RawDocuments: Specifies a set of raw -// documents. -type GoogleCloudDocumentaiV1RawDocuments struct { - // Documents: Specifies raw document content and mime type. - Documents []*GoogleCloudDocumentaiV1RawDocument `json:"documents,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Documents") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Documents") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *GoogleCloudDocumentaiV1RawDocuments) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDocumentaiV1RawDocuments - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata: The // long-running operation metadata for the ReviewDocument method. type GoogleCloudDocumentaiV1ReviewDocumentOperationMetadata struct { diff --git a/documentai/v1beta3/documentai-api.json b/documentai/v1beta3/documentai-api.json index 5c25e4f57a8..df609cd49aa 100644 --- a/documentai/v1beta3/documentai-api.json +++ b/documentai/v1beta3/documentai-api.json @@ -1256,7 +1256,7 @@ } } }, - "revision": "20230712", + "revision": "20230714", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -5400,10 +5400,6 @@ "gcsPrefix": { "$ref": "GoogleCloudDocumentaiV1beta3GcsPrefix", "description": "The set of documents that match the specified Cloud Storage `gcs_prefix`." - }, - "rawDocuments": { - "$ref": "GoogleCloudDocumentaiV1beta3RawDocuments", - "description": "The set of documents specified inline." } }, "type": "object" @@ -8100,8 +8096,7 @@ "description": "The schema of the processor version. Describes the output." }, "googleManaged": { - "description": "Output only. Denotes that this `ProcessorVersion` is managed by Google.", - "readOnly": true, + "description": "Denotes that this `ProcessorVersion` is managed by Google.", "type": "boolean" }, "kmsKeyName": { @@ -8192,20 +8187,6 @@ }, "type": "object" }, - "GoogleCloudDocumentaiV1beta3RawDocuments": { - "description": "Specifies a set of raw documents.", - "id": "GoogleCloudDocumentaiV1beta3RawDocuments", - "properties": { - "documents": { - "description": "Specifies raw document content and mime type.", - "items": { - "$ref": "GoogleCloudDocumentaiV1beta3RawDocument" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata": { "description": "The long-running operation metadata for the ReviewDocument method.", "id": "GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata", diff --git a/documentai/v1beta3/documentai-gen.go b/documentai/v1beta3/documentai-gen.go index 1ecd354dfaf..3050f1d4e27 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -7254,9 +7254,6 @@ type GoogleCloudDocumentaiV1beta3BatchDocumentsInputConfig struct { // Storage `gcs_prefix`. GcsPrefix *GoogleCloudDocumentaiV1beta3GcsPrefix `json:"gcsPrefix,omitempty"` - // RawDocuments: The set of documents specified inline. - RawDocuments *GoogleCloudDocumentaiV1beta3RawDocuments `json:"rawDocuments,omitempty"` - // ForceSendFields is a list of field names (e.g. "GcsDocuments") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -11835,8 +11832,8 @@ type GoogleCloudDocumentaiV1beta3ProcessorVersion struct { // output. DocumentSchema *GoogleCloudDocumentaiV1beta3DocumentSchema `json:"documentSchema,omitempty"` - // GoogleManaged: Output only. Denotes that this `ProcessorVersion` is - // managed by Google. + // GoogleManaged: Denotes that this `ProcessorVersion` is managed by + // Google. GoogleManaged bool `json:"googleManaged,omitempty"` // KmsKeyName: The KMS key name used for encryption. @@ -11996,35 +11993,6 @@ func (s *GoogleCloudDocumentaiV1beta3RawDocument) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudDocumentaiV1beta3RawDocuments: Specifies a set of raw -// documents. -type GoogleCloudDocumentaiV1beta3RawDocuments struct { - // Documents: Specifies raw document content and mime type. - Documents []*GoogleCloudDocumentaiV1beta3RawDocument `json:"documents,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Documents") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Documents") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *GoogleCloudDocumentaiV1beta3RawDocuments) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDocumentaiV1beta3RawDocuments - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata: The // long-running operation metadata for the ReviewDocument method. type GoogleCloudDocumentaiV1beta3ReviewDocumentOperationMetadata struct { diff --git a/firestore/v1/firestore-api.json b/firestore/v1/firestore-api.json index e3f992062ed..8570cd43692 100644 --- a/firestore/v1/firestore-api.json +++ b/firestore/v1/firestore-api.json @@ -962,7 +962,7 @@ "type": "string" }, "readTime": { - "description": "Reads the version of the document at the given time. This may not be older than 270 seconds.", + "description": "Reads the version of the document at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "location": "query", "type": "string" @@ -1029,7 +1029,7 @@ "type": "string" }, "readTime": { - "description": "Perform the read at the provided time. This may not be older than 270 seconds.", + "description": "Perform the read at the provided time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "location": "query", "type": "string" @@ -1130,7 +1130,7 @@ "type": "string" }, "readTime": { - "description": "Perform the read at the provided time. This may not be older than 270 seconds.", + "description": "Perform the read at the provided time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "location": "query", "type": "string" @@ -1672,7 +1672,7 @@ } } }, - "revision": "20230708", + "revision": "20230716", "rootUrl": "https://firestore.googleapis.com/", "schemas": { "Aggregation": { @@ -1738,7 +1738,7 @@ "description": "Starts a new transaction and reads the documents. Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream." }, "readTime": { - "description": "Reads documents as they were at the given time. This may not be older than 270 seconds.", + "description": "Reads documents as they were at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "type": "string" }, @@ -2561,6 +2561,11 @@ "$ref": "GoogleFirestoreAdminV1Progress", "description": "The progress, in documents, of this operation." }, + "snapshotTime": { + "description": "The timestamp that corresponds to the version of the database that is being exported. If unspecified, there are no guarantees about the consistency of the documents being exported.", + "format": "google-datetime", + "type": "string" + }, "startTime": { "description": "The time this operation started.", "format": "google-datetime", @@ -3357,7 +3362,7 @@ "type": "string" }, "readTime": { - "description": "Reads documents as they were at the given time. This may not be older than 270 seconds.", + "description": "Reads documents as they were at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "type": "string" } @@ -3560,7 +3565,7 @@ "type": "string" }, "readTime": { - "description": "Reads documents as they were at the given time. This may not be older than 270 seconds.", + "description": "Reads documents as they were at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "type": "string" }, @@ -3639,7 +3644,7 @@ "id": "ReadOnly", "properties": { "readTime": { - "description": "Reads documents at the given time. This may not be older than 60 seconds.", + "description": "Reads documents at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "type": "string" } @@ -3679,7 +3684,7 @@ "description": "Starts a new transaction as part of the query, defaulting to read-only. The new transaction ID will be returned as the first response in the stream." }, "readTime": { - "description": "Executes the query at the given timestamp. Requires: * Cannot be more than 270 seconds in the past.", + "description": "Executes the query at the given timestamp. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "type": "string" }, @@ -3725,7 +3730,7 @@ "description": "Starts a new transaction and reads the documents. Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream." }, "readTime": { - "description": "Reads documents as they were at the given time. This may not be older than 270 seconds.", + "description": "Reads documents as they were at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "type": "string" }, diff --git a/firestore/v1/firestore-gen.go b/firestore/v1/firestore-gen.go index 7f465d5e0b2..94948f8b05d 100644 --- a/firestore/v1/firestore-gen.go +++ b/firestore/v1/firestore-gen.go @@ -386,8 +386,10 @@ type BatchGetDocumentsRequest struct { // returned as the first response in the stream. NewTransaction *TransactionOptions `json:"newTransaction,omitempty"` - // ReadTime: Reads documents as they were at the given time. This may - // not be older than 270 seconds. + // ReadTime: Reads documents as they were at the given time. This must + // be a microsecond precision timestamp within the past one hour, or if + // Point-in-Time Recovery is enabled, can additionally be a whole minute + // timestamp within the past 7 days. ReadTime string `json:"readTime,omitempty"` // Transaction: Reads documents in a transaction. @@ -1792,6 +1794,11 @@ type GoogleFirestoreAdminV1ExportDocumentsMetadata struct { // ProgressDocuments: The progress, in documents, of this operation. ProgressDocuments *GoogleFirestoreAdminV1Progress `json:"progressDocuments,omitempty"` + // SnapshotTime: The timestamp that corresponds to the version of the + // database that is being exported. If unspecified, there are no + // guarantees about the consistency of the documents being exported. + SnapshotTime string `json:"snapshotTime,omitempty"` + // StartTime: The time this operation started. StartTime string `json:"startTime,omitempty"` @@ -3095,8 +3102,10 @@ type ListCollectionIdsRequest struct { // ListCollectionIdsResponse. PageToken string `json:"pageToken,omitempty"` - // ReadTime: Reads documents as they were at the given time. This may - // not be older than 270 seconds. + // ReadTime: Reads documents as they were at the given time. This must + // be a microsecond precision timestamp within the past one hour, or if + // Point-in-Time Recovery is enabled, can additionally be a whole minute + // timestamp within the past 7 days. ReadTime string `json:"readTime,omitempty"` // ForceSendFields is a list of field names (e.g. "PageSize") to @@ -3461,8 +3470,10 @@ type PartitionQueryRequest struct { // fewer than the number of workers or compute instances available. PartitionCount int64 `json:"partitionCount,omitempty,string"` - // ReadTime: Reads documents as they were at the given time. This may - // not be older than 270 seconds. + // ReadTime: Reads documents as they were at the given time. This must + // be a microsecond precision timestamp within the past one hour, or if + // Point-in-Time Recovery is enabled, can additionally be a whole minute + // timestamp within the past 7 days. ReadTime string `json:"readTime,omitempty"` // StructuredQuery: A structured query. Query must specify collection @@ -3643,8 +3654,10 @@ func (s *QueryTarget) MarshalJSON() ([]byte, error) { // ReadOnly: Options for a transaction that can only be used to read // documents. type ReadOnly struct { - // ReadTime: Reads documents at the given time. This may not be older - // than 60 seconds. + // ReadTime: Reads documents at the given time. This must be a + // microsecond precision timestamp within the past one hour, or if + // Point-in-Time Recovery is enabled, can additionally be a whole minute + // timestamp within the past 7 days. ReadTime string `json:"readTime,omitempty"` // ForceSendFields is a list of field names (e.g. "ReadTime") to @@ -3737,8 +3750,10 @@ type RunAggregationQueryRequest struct { // the first response in the stream. NewTransaction *TransactionOptions `json:"newTransaction,omitempty"` - // ReadTime: Executes the query at the given timestamp. Requires: * - // Cannot be more than 270 seconds in the past. + // ReadTime: Executes the query at the given timestamp. This must be a + // microsecond precision timestamp within the past one hour, or if + // Point-in-Time Recovery is enabled, can additionally be a whole minute + // timestamp within the past 7 days. ReadTime string `json:"readTime,omitempty"` // StructuredAggregationQuery: An aggregation query. @@ -3827,8 +3842,10 @@ type RunQueryRequest struct { // returned as the first response in the stream. NewTransaction *TransactionOptions `json:"newTransaction,omitempty"` - // ReadTime: Reads documents as they were at the given time. This may - // not be older than 270 seconds. + // ReadTime: Reads documents as they were at the given time. This must + // be a microsecond precision timestamp within the past one hour, or if + // Point-in-Time Recovery is enabled, can additionally be a whole minute + // timestamp within the past 7 days. ReadTime string `json:"readTime,omitempty"` // StructuredQuery: A structured query. @@ -8678,8 +8695,10 @@ func (c *ProjectsDatabasesDocumentsGetCall) MaskFieldPaths(maskFieldPaths ...str } // ReadTime sets the optional parameter "readTime": Reads the version of -// the document at the given time. This may not be older than 270 -// seconds. +// the document at the given time. This must be a microsecond precision +// timestamp within the past one hour, or if Point-in-Time Recovery is +// enabled, can additionally be a whole minute timestamp within the past +// 7 days. func (c *ProjectsDatabasesDocumentsGetCall) ReadTime(readTime string) *ProjectsDatabasesDocumentsGetCall { c.urlParams_.Set("readTime", readTime) return c @@ -8813,7 +8832,7 @@ func (c *ProjectsDatabasesDocumentsGetCall) Do(opts ...googleapi.CallOption) (*D // "type": "string" // }, // "readTime": { - // "description": "Reads the version of the document at the given time. This may not be older than 270 seconds.", + // "description": "Reads the version of the document at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", // "format": "google-datetime", // "location": "query", // "type": "string" @@ -8906,7 +8925,9 @@ func (c *ProjectsDatabasesDocumentsListCall) PageToken(pageToken string) *Projec } // ReadTime sets the optional parameter "readTime": Perform the read at -// the provided time. This may not be older than 270 seconds. +// the provided time. This must be a microsecond precision timestamp +// within the past one hour, or if Point-in-Time Recovery is enabled, +// can additionally be a whole minute timestamp within the past 7 days. func (c *ProjectsDatabasesDocumentsListCall) ReadTime(readTime string) *ProjectsDatabasesDocumentsListCall { c.urlParams_.Set("readTime", readTime) return c @@ -9075,7 +9096,7 @@ func (c *ProjectsDatabasesDocumentsListCall) Do(opts ...googleapi.CallOption) (* // "type": "string" // }, // "readTime": { - // "description": "Perform the read at the provided time. This may not be older than 270 seconds.", + // "description": "Perform the read at the provided time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", // "format": "google-datetime", // "location": "query", // "type": "string" @@ -9363,7 +9384,9 @@ func (c *ProjectsDatabasesDocumentsListDocumentsCall) PageToken(pageToken string } // ReadTime sets the optional parameter "readTime": Perform the read at -// the provided time. This may not be older than 270 seconds. +// the provided time. This must be a microsecond precision timestamp +// within the past one hour, or if Point-in-Time Recovery is enabled, +// can additionally be a whole minute timestamp within the past 7 days. func (c *ProjectsDatabasesDocumentsListDocumentsCall) ReadTime(readTime string) *ProjectsDatabasesDocumentsListDocumentsCall { c.urlParams_.Set("readTime", readTime) return c @@ -9532,7 +9555,7 @@ func (c *ProjectsDatabasesDocumentsListDocumentsCall) Do(opts ...googleapi.CallO // "type": "string" // }, // "readTime": { - // "description": "Perform the read at the provided time. This may not be older than 270 seconds.", + // "description": "Perform the read at the provided time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", // "format": "google-datetime", // "location": "query", // "type": "string" diff --git a/firestore/v1beta1/firestore-api.json b/firestore/v1beta1/firestore-api.json index 671eb0282b2..19c2d8a0163 100644 --- a/firestore/v1beta1/firestore-api.json +++ b/firestore/v1beta1/firestore-api.json @@ -397,7 +397,7 @@ "type": "string" }, "readTime": { - "description": "Reads the version of the document at the given time. This may not be older than 270 seconds.", + "description": "Reads the version of the document at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "location": "query", "type": "string" @@ -464,7 +464,7 @@ "type": "string" }, "readTime": { - "description": "Perform the read at the provided time. This may not be older than 270 seconds.", + "description": "Perform the read at the provided time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "location": "query", "type": "string" @@ -565,7 +565,7 @@ "type": "string" }, "readTime": { - "description": "Perform the read at the provided time. This may not be older than 270 seconds.", + "description": "Perform the read at the provided time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "location": "query", "type": "string" @@ -950,7 +950,7 @@ } } }, - "revision": "20230621", + "revision": "20230716", "rootUrl": "https://firestore.googleapis.com/", "schemas": { "Aggregation": { @@ -1016,7 +1016,7 @@ "description": "Starts a new transaction and reads the documents. Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream." }, "readTime": { - "description": "Reads documents as they were at the given time. This may not be older than 270 seconds.", + "description": "Reads documents as they were at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "type": "string" }, @@ -1991,7 +1991,7 @@ "type": "string" }, "readTime": { - "description": "Reads documents as they were at the given time. This may not be older than 270 seconds.", + "description": "Reads documents as they were at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "type": "string" } @@ -2142,7 +2142,7 @@ "type": "string" }, "readTime": { - "description": "Reads documents as they were at the given time. This may not be older than 270 seconds.", + "description": "Reads documents as they were at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "type": "string" }, @@ -2221,7 +2221,7 @@ "id": "ReadOnly", "properties": { "readTime": { - "description": "Reads documents at the given time. This may not be older than 60 seconds.", + "description": "Reads documents at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "type": "string" } @@ -2261,7 +2261,7 @@ "description": "Starts a new transaction as part of the query, defaulting to read-only. The new transaction ID will be returned as the first response in the stream." }, "readTime": { - "description": "Executes the query at the given timestamp. Requires: * Cannot be more than 270 seconds in the past.", + "description": "Executes the query at the given timestamp. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "type": "string" }, @@ -2307,7 +2307,7 @@ "description": "Starts a new transaction and reads the documents. Defaults to a read-only transaction. The new transaction ID will be returned as the first response in the stream." }, "readTime": { - "description": "Reads documents as they were at the given time. This may not be older than 270 seconds.", + "description": "Reads documents as they were at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", "format": "google-datetime", "type": "string" }, diff --git a/firestore/v1beta1/firestore-gen.go b/firestore/v1beta1/firestore-gen.go index b28bb88e92b..a7a3b4cc7f2 100644 --- a/firestore/v1beta1/firestore-gen.go +++ b/firestore/v1beta1/firestore-gen.go @@ -314,8 +314,10 @@ type BatchGetDocumentsRequest struct { // returned as the first response in the stream. NewTransaction *TransactionOptions `json:"newTransaction,omitempty"` - // ReadTime: Reads documents as they were at the given time. This may - // not be older than 270 seconds. + // ReadTime: Reads documents as they were at the given time. This must + // be a microsecond precision timestamp within the past one hour, or if + // Point-in-Time Recovery is enabled, can additionally be a whole minute + // timestamp within the past 7 days. ReadTime string `json:"readTime,omitempty"` // Transaction: Reads documents in a transaction. @@ -2050,8 +2052,10 @@ type ListCollectionIdsRequest struct { // ListCollectionIdsResponse. PageToken string `json:"pageToken,omitempty"` - // ReadTime: Reads documents as they were at the given time. This may - // not be older than 270 seconds. + // ReadTime: Reads documents as they were at the given time. This must + // be a microsecond precision timestamp within the past one hour, or if + // Point-in-Time Recovery is enabled, can additionally be a whole minute + // timestamp within the past 7 days. ReadTime string `json:"readTime,omitempty"` // ForceSendFields is a list of field names (e.g. "PageSize") to @@ -2329,8 +2333,10 @@ type PartitionQueryRequest struct { // fewer than the number of workers or compute instances available. PartitionCount int64 `json:"partitionCount,omitempty,string"` - // ReadTime: Reads documents as they were at the given time. This may - // not be older than 270 seconds. + // ReadTime: Reads documents as they were at the given time. This must + // be a microsecond precision timestamp within the past one hour, or if + // Point-in-Time Recovery is enabled, can additionally be a whole minute + // timestamp within the past 7 days. ReadTime string `json:"readTime,omitempty"` // StructuredQuery: A structured query. Query must specify collection @@ -2511,8 +2517,10 @@ func (s *QueryTarget) MarshalJSON() ([]byte, error) { // ReadOnly: Options for a transaction that can only be used to read // documents. type ReadOnly struct { - // ReadTime: Reads documents at the given time. This may not be older - // than 60 seconds. + // ReadTime: Reads documents at the given time. This must be a + // microsecond precision timestamp within the past one hour, or if + // Point-in-Time Recovery is enabled, can additionally be a whole minute + // timestamp within the past 7 days. ReadTime string `json:"readTime,omitempty"` // ForceSendFields is a list of field names (e.g. "ReadTime") to @@ -2605,8 +2613,10 @@ type RunAggregationQueryRequest struct { // the first response in the stream. NewTransaction *TransactionOptions `json:"newTransaction,omitempty"` - // ReadTime: Executes the query at the given timestamp. Requires: * - // Cannot be more than 270 seconds in the past. + // ReadTime: Executes the query at the given timestamp. This must be a + // microsecond precision timestamp within the past one hour, or if + // Point-in-Time Recovery is enabled, can additionally be a whole minute + // timestamp within the past 7 days. ReadTime string `json:"readTime,omitempty"` // StructuredAggregationQuery: An aggregation query. @@ -2695,8 +2705,10 @@ type RunQueryRequest struct { // returned as the first response in the stream. NewTransaction *TransactionOptions `json:"newTransaction,omitempty"` - // ReadTime: Reads documents as they were at the given time. This may - // not be older than 270 seconds. + // ReadTime: Reads documents as they were at the given time. This must + // be a microsecond precision timestamp within the past one hour, or if + // Point-in-Time Recovery is enabled, can additionally be a whole minute + // timestamp within the past 7 days. ReadTime string `json:"readTime,omitempty"` // StructuredQuery: A structured query. @@ -4686,8 +4698,10 @@ func (c *ProjectsDatabasesDocumentsGetCall) MaskFieldPaths(maskFieldPaths ...str } // ReadTime sets the optional parameter "readTime": Reads the version of -// the document at the given time. This may not be older than 270 -// seconds. +// the document at the given time. This must be a microsecond precision +// timestamp within the past one hour, or if Point-in-Time Recovery is +// enabled, can additionally be a whole minute timestamp within the past +// 7 days. func (c *ProjectsDatabasesDocumentsGetCall) ReadTime(readTime string) *ProjectsDatabasesDocumentsGetCall { c.urlParams_.Set("readTime", readTime) return c @@ -4821,7 +4835,7 @@ func (c *ProjectsDatabasesDocumentsGetCall) Do(opts ...googleapi.CallOption) (*D // "type": "string" // }, // "readTime": { - // "description": "Reads the version of the document at the given time. This may not be older than 270 seconds.", + // "description": "Reads the version of the document at the given time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", // "format": "google-datetime", // "location": "query", // "type": "string" @@ -4914,7 +4928,9 @@ func (c *ProjectsDatabasesDocumentsListCall) PageToken(pageToken string) *Projec } // ReadTime sets the optional parameter "readTime": Perform the read at -// the provided time. This may not be older than 270 seconds. +// the provided time. This must be a microsecond precision timestamp +// within the past one hour, or if Point-in-Time Recovery is enabled, +// can additionally be a whole minute timestamp within the past 7 days. func (c *ProjectsDatabasesDocumentsListCall) ReadTime(readTime string) *ProjectsDatabasesDocumentsListCall { c.urlParams_.Set("readTime", readTime) return c @@ -5083,7 +5099,7 @@ func (c *ProjectsDatabasesDocumentsListCall) Do(opts ...googleapi.CallOption) (* // "type": "string" // }, // "readTime": { - // "description": "Perform the read at the provided time. This may not be older than 270 seconds.", + // "description": "Perform the read at the provided time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", // "format": "google-datetime", // "location": "query", // "type": "string" @@ -5371,7 +5387,9 @@ func (c *ProjectsDatabasesDocumentsListDocumentsCall) PageToken(pageToken string } // ReadTime sets the optional parameter "readTime": Perform the read at -// the provided time. This may not be older than 270 seconds. +// the provided time. This must be a microsecond precision timestamp +// within the past one hour, or if Point-in-Time Recovery is enabled, +// can additionally be a whole minute timestamp within the past 7 days. func (c *ProjectsDatabasesDocumentsListDocumentsCall) ReadTime(readTime string) *ProjectsDatabasesDocumentsListDocumentsCall { c.urlParams_.Set("readTime", readTime) return c @@ -5540,7 +5558,7 @@ func (c *ProjectsDatabasesDocumentsListDocumentsCall) Do(opts ...googleapi.CallO // "type": "string" // }, // "readTime": { - // "description": "Perform the read at the provided time. This may not be older than 270 seconds.", + // "description": "Perform the read at the provided time. This must be a microsecond precision timestamp within the past one hour, or if Point-in-Time Recovery is enabled, can additionally be a whole minute timestamp within the past 7 days.", // "format": "google-datetime", // "location": "query", // "type": "string" diff --git a/healthcare/v1/healthcare-api.json b/healthcare/v1/healthcare-api.json index ce2ed794d1c..ca218b16343 100644 --- a/healthcare/v1/healthcare-api.json +++ b/healthcare/v1/healthcare-api.json @@ -4078,7 +4078,7 @@ } } }, - "revision": "20230627", + "revision": "20230713", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "ActivateConsentRequest": { @@ -5192,6 +5192,7 @@ }, "notificationConfig": { "$ref": "NotificationConfig", + "deprecated": true, "description": "Deprecated. Use `notification_configs` instead. If non-empty, publish all resource modifications of this FHIR store to this destination. The Pub/Sub message attributes contain a map with a string describing the action that has triggered the notification. For example, \"action\":\"CreateResource\"." }, "notificationConfigs": { diff --git a/healthcare/v1beta1/healthcare-api.json b/healthcare/v1beta1/healthcare-api.json index d998091be4f..192510b472c 100644 --- a/healthcare/v1beta1/healthcare-api.json +++ b/healthcare/v1beta1/healthcare-api.json @@ -4941,7 +4941,7 @@ } } }, - "revision": "20230627", + "revision": "20230713", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "Action": { @@ -5734,6 +5734,7 @@ }, "dicom": { "$ref": "DicomConfig", + "deprecated": true, "description": "Configures de-id of application/DICOM content. Deprecated. Use `dicom_tag_config` instead." }, "dicomTagConfig": { @@ -5742,6 +5743,7 @@ }, "fhir": { "$ref": "FhirConfig", + "deprecated": true, "description": "Configures de-id of application/FHIR content. Deprecated. Use `fhir_field_config` instead." }, "fhirFieldConfig": { @@ -5750,6 +5752,7 @@ }, "image": { "$ref": "ImageConfig", + "deprecated": true, "description": "Configures the de-identification of image pixels in the source_dataset. Deprecated. Use `dicom_tag_config.options.clean_image` instead." }, "operationMetadata": { @@ -6473,6 +6476,7 @@ }, "notificationConfig": { "$ref": "NotificationConfig", + "deprecated": true, "description": "Deprecated. Use `notification_configs` instead. If non-empty, publish all resource modifications of this FHIR store to this destination. The Pub/Sub message attributes contain a map with a string describing the action that has triggered the notification. For example, \"action\":\"CreateResource\"." }, "notificationConfigs": { @@ -7101,6 +7105,7 @@ }, "notificationConfig": { "$ref": "NotificationConfig", + "deprecated": true, "description": "The notification destination all messages (both Ingest \u0026 Create) are published on. Only the message name is sent as part of the notification. If this is unset, no notifications are sent. Supplied by the client." }, "notificationConfigs": { @@ -8567,6 +8572,7 @@ "type": "string" }, "transformations": { + "deprecated": true, "description": "The transformations to apply to the detected data. Deprecated. Use `additional_transformations` instead.", "items": { "$ref": "InfoTypeTransformation" diff --git a/migrationcenter/v1alpha1/migrationcenter-api.json b/migrationcenter/v1alpha1/migrationcenter-api.json index 986eb7aa47d..c80a07c536e 100644 --- a/migrationcenter/v1alpha1/migrationcenter-api.json +++ b/migrationcenter/v1alpha1/migrationcenter-api.json @@ -2102,7 +2102,7 @@ } } }, - "revision": "20230707", + "revision": "20230714", "rootUrl": "https://migrationcenter.googleapis.com/", "schemas": { "AddAssetsToGroupRequest": { @@ -4448,7 +4448,7 @@ "description": "Network usage sample." }, "sampleTime": { - "description": "Time the sample was collected.", + "description": "Time the sample was collected. If omitted, the frame report time will be used.", "format": "google-datetime", "type": "string" } diff --git a/migrationcenter/v1alpha1/migrationcenter-gen.go b/migrationcenter/v1alpha1/migrationcenter-gen.go index a3346dfb145..0b3c90fb64f 100644 --- a/migrationcenter/v1alpha1/migrationcenter-gen.go +++ b/migrationcenter/v1alpha1/migrationcenter-gen.go @@ -4083,7 +4083,8 @@ type PerformanceSample struct { // Network: Network usage sample. Network *NetworkUsageSample `json:"network,omitempty"` - // SampleTime: Time the sample was collected. + // SampleTime: Time the sample was collected. If omitted, the frame + // report time will be used. SampleTime string `json:"sampleTime,omitempty"` // ForceSendFields is a list of field names (e.g. "Cpu") to diff --git a/networkconnectivity/v1/networkconnectivity-api.json b/networkconnectivity/v1/networkconnectivity-api.json index e793bb7faee..4b870279f38 100644 --- a/networkconnectivity/v1/networkconnectivity-api.json +++ b/networkconnectivity/v1/networkconnectivity-api.json @@ -203,7 +203,7 @@ "type": "string" }, "requestId": { - "description": "Optional. A unique request ID (optional). If you specify this ID, you can use it in cases when you need to retry your request. When you need to retry, this ID lets the server know that it can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes after 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).", + "description": "Optional. A 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 guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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" } @@ -236,7 +236,7 @@ "type": "string" }, "requestId": { - "description": "Optional. A unique request ID (optional). If you specify this ID, you can use it in cases when you need to retry your request. When you need to retry, this ID lets the server know that it can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes after 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).", + "description": "Optional. A 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 guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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" } @@ -395,7 +395,7 @@ "type": "string" }, "view": { - "description": "The view of the spoke to return. The view you use determines which spoke fields are included in the response.", + "description": "The view of the spoke to return. The view that you use determines which spoke fields are included in the response.", "enum": [ "SPOKE_VIEW_UNSPECIFIED", "BASIC", @@ -435,7 +435,7 @@ "type": "string" }, "requestId": { - "description": "Optional. A unique request ID (optional). If you specify this ID, you can use it in cases when you need to retry your request. When you need to retry, this ID lets the server know that it can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes after 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).", + "description": "Optional. A 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 guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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" }, @@ -2137,7 +2137,7 @@ "type": "string" }, "requestId": { - "description": "Optional. A unique request ID (optional). If you specify this ID, you can use it in cases when you need to retry your request. When you need to retry, this ID lets the server know that it can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes after 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).", + "description": "Optional. A 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 guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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" }, @@ -2175,7 +2175,7 @@ "type": "string" }, "requestId": { - "description": "Optional. A unique request ID (optional). If you specify this ID, you can use it in cases when you need to retry your request. When you need to retry, this ID lets the server know that it can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes after 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).", + "description": "Optional. A 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 guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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" } @@ -2307,7 +2307,7 @@ "type": "string" }, "requestId": { - "description": "Optional. A unique request ID (optional). If you specify this ID, you can use it in cases when you need to retry your request. When you need to retry, this ID lets the server know that it can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes after 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).", + "description": "Optional. A 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 guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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" }, @@ -2330,7 +2330,7 @@ ] }, "reject": { - "description": "Does one of the following: * Rejects a proposal to attach a Network Connectivity Center spoke to the hub. * Rejects and removes a previously attached spoke from the hub.", + "description": "Rejects a Network Connectivity Center spoke from being attached to the hub. If the spoke was previously in the `ACTIVE` state, it transitions to the `INACTIVE` state and is no longer able to connect to other spokes that are attached to the hub.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/spokes/{spokesId}:reject", "httpMethod": "POST", "id": "networkconnectivity.projects.locations.spokes.reject", @@ -2420,7 +2420,7 @@ } } }, - "revision": "20230621", + "revision": "20230712", "rootUrl": "https://networkconnectivity.googleapis.com/", "schemas": { "AcceptSpokeRequest": { @@ -2428,7 +2428,7 @@ "id": "AcceptSpokeRequest", "properties": { "requestId": { - "description": "Optional. A unique request ID (optional). If you specify this ID, you can use it in cases when you need to retry your request. When you need to retry, this ID lets the server know that it can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes after 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).", + "description": "Optional. A 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 guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).", "type": "string" } }, @@ -2525,12 +2525,14 @@ "enum": [ "STATE_UNSPECIFIED", "VALID", - "CONNECTION_POLICY_MISSING" + "CONNECTION_POLICY_MISSING", + "POLICY_LIMIT_REACHED" ], "enumDescriptions": [ "Default state, when Connection Map is created initially.", "Set when policy and map configuration is valid, and their matching can lead to allowing creation of PSC Connections subject to other constraints like connections limit.", - "No Service Connection Policy found for this network and Service Class" + "No Service Connection Policy found for this network and Service Class", + "Service Connection Policy limit reached for this network and Service Class" ], "readOnly": true, "type": "string" @@ -2849,11 +2851,13 @@ "items": { "enum": [ "OVERLAP_UNSPECIFIED", - "OVERLAP_ROUTE_RANGE" + "OVERLAP_ROUTE_RANGE", + "OVERLAP_EXISTING_SUBNET_RANGE" ], "enumDescriptions": [ "No overlap overrides.", - "Allow creation of static routes more specific that the current internal range." + "Allow creation of static routes more specific that the current internal range.", + "Allow creation of internal ranges that overlap with existing subnets." ], "type": "string" }, @@ -2968,14 +2972,14 @@ "id": "LinkedVpcNetwork", "properties": { "excludeExportRanges": { - "description": "Optional. IP Ranges encompassing the subnets to be excluded from peering.", + "description": "Optional. IP ranges encompassing the subnets to be excluded from peering.", "items": { "type": "string" }, "type": "array" }, "uri": { - "description": "Required. The URI of the VPC network resource", + "description": "Required. The URI of the VPC network resource.", "type": "string" } }, @@ -3515,11 +3519,11 @@ "id": "RejectSpokeRequest", "properties": { "details": { - "description": "Optional. Additional Details behind the rejection", + "description": "Optional. Additional information provided by the hub administrator in the `RejectSpoke` call.", "type": "string" }, "requestId": { - "description": "Optional. A unique request ID (optional). If you specify this ID, you can use it in cases when you need to retry your request. When you need to retry, this ID lets the server know that it can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes after 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).", + "description": "Optional. A 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 guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).", "type": "string" } }, @@ -3556,7 +3560,7 @@ "type": "string" }, "name": { - "description": "Immutable. The name of the route. Route names must be unique. They use the following form: `projects/{project_number}/locations/global/hubs/{hub}/routeTables/{route_table_id}/routes/{route_id}`", + "description": "Immutable. The name of the route. Route names must be unique. Route names use the following form: `projects/{project_number}/locations/global/hubs/{hub}/routeTables/{route_table_id}/routes/{route_id}`", "type": "string" }, "nextHopVpcNetwork": { @@ -3610,7 +3614,7 @@ "type": "string" }, "uid": { - "description": "Output only. The Google-generated UUID for the route. This value is unique across all Network Connectivity Center route resources. If a route is deleted and another with the same name is created, the new route is assigned a different unique_id.", + "description": "Output only. The Google-generated UUID for the route. This value is unique across all Network Connectivity Center route resources. If a route is deleted and another with the same name is created, the new route is assigned a different `uid`.", "readOnly": true, "type": "string" }, @@ -3644,7 +3648,7 @@ "type": "object" }, "name": { - "description": "Immutable. The name of the route table. Route Table names must be unique. They use the following form: `projects/{project_number}/locations/global/hubs/{hub}/routeTables/{route_table_id}`", + "description": "Immutable. The name of the route table. Route table names must be unique. They use the following form: `projects/{project_number}/locations/global/hubs/{hub}/routeTables/{route_table_id}`", "type": "string" }, "state": { @@ -3675,7 +3679,7 @@ "type": "string" }, "uid": { - "description": "Output only. The Google-generated UUID for the route table. This value is unique across all route table resources. If a route table is deleted and another with the same name is created, the new route table is assigned a different unique_id.", + "description": "Output only. The Google-generated UUID for the route table. This value is unique across all route table resources. If a route table is deleted and another with the same name is created, the new route table is assigned a different `uid`.", "readOnly": true, "type": "string" }, @@ -4042,7 +4046,7 @@ "type": "string" }, "reasons": { - "description": "Output only. The reasons for current state of the spoke.", + "description": "Output only. The reasons for current state of the spoke. Only present when the spoke is in the `INACTIVE` state.", "items": { "$ref": "StateReason" }, @@ -4096,7 +4100,7 @@ "type": "string" }, "uniqueId": { - "description": "Output only. The Google-generated UUID for the spoke. This value is unique across all spoke resources. If a spoke is deleted and another with the same name is created, the new spoke is assigned a different unique_id.", + "description": "Output only. The Google-generated UUID for the spoke. This value is unique across all spoke resources. If a spoke is deleted and another with the same name is created, the new spoke is assigned a different `unique_id`.", "readOnly": true, "type": "string" }, diff --git a/networkconnectivity/v1/networkconnectivity-gen.go b/networkconnectivity/v1/networkconnectivity-gen.go index cbebdf4c355..f6a86211acf 100644 --- a/networkconnectivity/v1/networkconnectivity-gen.go +++ b/networkconnectivity/v1/networkconnectivity-gen.go @@ -317,19 +317,18 @@ type ProjectsLocationsSpokesService struct { // AcceptSpokeRequest: The request for HubService.AcceptSpoke. type AcceptSpokeRequest struct { - // RequestId: Optional. A unique request ID (optional). If you specify - // this ID, you can use it in cases when you need to retry your request. - // When you need to retry, this ID lets the server know that it can - // ignore the request if it has already been completed. The server - // guarantees that for at least 60 minutes after 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 to see whether the original - // operation was received. If it was, the server ignores the second - // request. This behavior prevents clients from mistakenly 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: Optional. A 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 guarantees that a request doesn't result in creation of + // duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. + // If it was, the server ignores the second request. This behavior + // prevents clients from mistakenly 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"` // ForceSendFields is a list of field names (e.g. "RequestId") to @@ -558,6 +557,8 @@ type ConsumerPscConfig struct { // other constraints like connections limit. // "CONNECTION_POLICY_MISSING" - No Service Connection Policy found // for this network and Service Class + // "POLICY_LIMIT_REACHED" - Service Connection Policy limit reached + // for this network and Service Class State string `json:"state,omitempty"` // ForceSendFields is a list of field names (e.g. "DisableGlobalAccess") @@ -1021,6 +1022,8 @@ type InternalRange struct { // "OVERLAP_UNSPECIFIED" - No overlap overrides. // "OVERLAP_ROUTE_RANGE" - Allow creation of static routes more // specific that the current internal range. + // "OVERLAP_EXISTING_SUBNET_RANGE" - Allow creation of internal ranges + // that overlap with existing subnets. Overlaps []string `json:"overlaps,omitempty"` // Peering: The type of peering set for this internal range. @@ -1204,11 +1207,11 @@ func (s *LinkedRouterApplianceInstances) MarshalJSON() ([]byte, error) { // LinkedVpcNetwork: An existing VPC network. type LinkedVpcNetwork struct { - // ExcludeExportRanges: Optional. IP Ranges encompassing the subnets to + // ExcludeExportRanges: Optional. IP ranges encompassing the subnets to // be excluded from peering. ExcludeExportRanges []string `json:"excludeExportRanges,omitempty"` - // Uri: Required. The URI of the VPC network resource + // Uri: Required. The URI of the VPC network resource. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "ExcludeExportRanges") @@ -2141,22 +2144,22 @@ func (s *PscConnection) MarshalJSON() ([]byte, error) { // RejectSpokeRequest: The request for HubService.RejectSpoke. type RejectSpokeRequest struct { - // Details: Optional. Additional Details behind the rejection + // Details: Optional. Additional information provided by the hub + // administrator in the `RejectSpoke` call. Details string `json:"details,omitempty"` - // RequestId: Optional. A unique request ID (optional). If you specify - // this ID, you can use it in cases when you need to retry your request. - // When you need to retry, this ID lets the server know that it can - // ignore the request if it has already been completed. The server - // guarantees that for at least 60 minutes after 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 to see whether the original - // operation was received. If it was, the server ignores the second - // request. This behavior prevents clients from mistakenly 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: Optional. A 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 guarantees that a request doesn't result in creation of + // duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. + // If it was, the server ignores the second request. This behavior + // prevents clients from mistakenly 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"` // ForceSendFields is a list of field names (e.g. "Details") to @@ -2205,7 +2208,7 @@ type Route struct { Location string `json:"location,omitempty"` // Name: Immutable. The name of the route. Route names must be unique. - // They use the following form: + // Route names use the following form: // `projects/{project_number}/locations/global/hubs/{hub}/routeTables/{ro // ute_table_id}/routes/{route_id}` Name string `json:"name,omitempty"` @@ -2247,7 +2250,7 @@ type Route struct { // Uid: Output only. The Google-generated UUID for the route. This value // is unique across all Network Connectivity Center route resources. If // a route is deleted and another with the same name is created, the new - // route is assigned a different unique_id. + // route is assigned a different `uid`. Uid string `json:"uid,omitempty"` // UpdateTime: Output only. The time the route was last updated. @@ -2292,7 +2295,7 @@ type RouteTable struct { // (https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements). Labels map[string]string `json:"labels,omitempty"` - // Name: Immutable. The name of the route table. Route Table names must + // Name: Immutable. The name of the route table. Route table names must // be unique. They use the following form: // `projects/{project_number}/locations/global/hubs/{hub}/routeTables/{ro // ute_table_id}` @@ -2316,7 +2319,7 @@ type RouteTable struct { // Uid: Output only. The Google-generated UUID for the route table. This // value is unique across all route table resources. If a route table is // deleted and another with the same name is created, the new route - // table is assigned a different unique_id. + // table is assigned a different `uid`. Uid string `json:"uid,omitempty"` // UpdateTime: Output only. The time the route table was last updated. @@ -2798,6 +2801,7 @@ type Spoke struct { Name string `json:"name,omitempty"` // Reasons: Output only. The reasons for current state of the spoke. + // Only present when the spoke is in the `INACTIVE` state. Reasons []*StateReason `json:"reasons,omitempty"` // SpokeType: Output only. The type of resource associated with the @@ -2831,7 +2835,7 @@ type Spoke struct { // UniqueId: Output only. The Google-generated UUID for the spoke. This // value is unique across all spoke resources. If a spoke is deleted and // another with the same name is created, the new spoke is assigned a - // different unique_id. + // different `unique_id`. UniqueId string `json:"uniqueId,omitempty"` // UpdateTime: Output only. The time the spoke was last updated. @@ -3531,18 +3535,18 @@ func (c *ProjectsLocationsGlobalHubsCreateCall) HubId(hubId string) *ProjectsLoc return c } -// RequestId sets the optional parameter "requestId": A unique request -// ID (optional). If you specify this ID, you can use it in cases when -// you need to retry your request. When you need to retry, this ID lets -// the server know that it can ignore the request if it has already been -// completed. The server guarantees that for at least 60 minutes after -// 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 to see whether -// the original operation was received. If it was, the server ignores -// the second request. This behavior prevents clients from mistakenly -// creating duplicate commitments. The request ID must be a valid UUID, -// with the exception that zero UUID is not supported +// RequestId sets the optional parameter "requestId": A 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 guarantees that a request +// doesn't result in creation of duplicate commitments for at least 60 +// minutes. 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 to see whether the original +// operation was received. If it was, the server ignores the second +// request. This behavior prevents clients from mistakenly 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 *ProjectsLocationsGlobalHubsCreateCall) RequestId(requestId string) *ProjectsLocationsGlobalHubsCreateCall { c.urlParams_.Set("requestId", requestId) @@ -3661,7 +3665,7 @@ func (c *ProjectsLocationsGlobalHubsCreateCall) Do(opts ...googleapi.CallOption) // "type": "string" // }, // "requestId": { - // "description": "Optional. A unique request ID (optional). If you specify this ID, you can use it in cases when you need to retry your request. When you need to retry, this ID lets the server know that it can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes after 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).", + // "description": "Optional. A 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 guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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" // } @@ -3699,18 +3703,18 @@ func (r *ProjectsLocationsGlobalHubsService) Delete(name string) *ProjectsLocati return c } -// RequestId sets the optional parameter "requestId": A unique request -// ID (optional). If you specify this ID, you can use it in cases when -// you need to retry your request. When you need to retry, this ID lets -// the server know that it can ignore the request if it has already been -// completed. The server guarantees that for at least 60 minutes after -// 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 to see whether -// the original operation was received. If it was, the server ignores -// the second request. This behavior prevents clients from mistakenly -// creating duplicate commitments. The request ID must be a valid UUID, -// with the exception that zero UUID is not supported +// RequestId sets the optional parameter "requestId": A 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 guarantees that a request +// doesn't result in creation of duplicate commitments for at least 60 +// minutes. 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 to see whether the original +// operation was received. If it was, the server ignores the second +// request. This behavior prevents clients from mistakenly 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 *ProjectsLocationsGlobalHubsDeleteCall) RequestId(requestId string) *ProjectsLocationsGlobalHubsDeleteCall { c.urlParams_.Set("requestId", requestId) @@ -3819,7 +3823,7 @@ func (c *ProjectsLocationsGlobalHubsDeleteCall) Do(opts ...googleapi.CallOption) // "type": "string" // }, // "requestId": { - // "description": "Optional. A unique request ID (optional). If you specify this ID, you can use it in cases when you need to retry your request. When you need to retry, this ID lets the server know that it can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes after 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).", + // "description": "Optional. A 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 guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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" // } @@ -4435,8 +4439,8 @@ func (c *ProjectsLocationsGlobalHubsListSpokesCall) SpokeLocations(spokeLocation } // View sets the optional parameter "view": The view of the spoke to -// return. The view you use determines which spoke fields are included -// in the response. +// return. The view that you use determines which spoke fields are +// included in the response. // // Possible values: // @@ -4600,7 +4604,7 @@ func (c *ProjectsLocationsGlobalHubsListSpokesCall) Do(opts ...googleapi.CallOpt // "type": "string" // }, // "view": { - // "description": "The view of the spoke to return. The view you use determines which spoke fields are included in the response.", + // "description": "The view of the spoke to return. The view that you use determines which spoke fields are included in the response.", // "enum": [ // "SPOKE_VIEW_UNSPECIFIED", // "BASIC", @@ -4671,18 +4675,18 @@ func (r *ProjectsLocationsGlobalHubsService) Patch(name string, hub *Hub) *Proje return c } -// RequestId sets the optional parameter "requestId": A unique request -// ID (optional). If you specify this ID, you can use it in cases when -// you need to retry your request. When you need to retry, this ID lets -// the server know that it can ignore the request if it has already been -// completed. The server guarantees that for at least 60 minutes after -// 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 to see whether -// the original operation was received. If it was, the server ignores -// the second request. This behavior prevents clients from mistakenly -// creating duplicate commitments. The request ID must be a valid UUID, -// with the exception that zero UUID is not supported +// RequestId sets the optional parameter "requestId": A 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 guarantees that a request +// doesn't result in creation of duplicate commitments for at least 60 +// minutes. 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 to see whether the original +// operation was received. If it was, the server ignores the second +// request. This behavior prevents clients from mistakenly 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 *ProjectsLocationsGlobalHubsPatchCall) RequestId(requestId string) *ProjectsLocationsGlobalHubsPatchCall { c.urlParams_.Set("requestId", requestId) @@ -4807,7 +4811,7 @@ func (c *ProjectsLocationsGlobalHubsPatchCall) Do(opts ...googleapi.CallOption) // "type": "string" // }, // "requestId": { - // "description": "Optional. A unique request ID (optional). If you specify this ID, you can use it in cases when you need to retry your request. When you need to retry, this ID lets the server know that it can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes after 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).", + // "description": "Optional. A 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 guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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" // }, @@ -13113,18 +13117,18 @@ func (r *ProjectsLocationsSpokesService) Create(parent string, spoke *Spoke) *Pr return c } -// RequestId sets the optional parameter "requestId": A unique request -// ID (optional). If you specify this ID, you can use it in cases when -// you need to retry your request. When you need to retry, this ID lets -// the server know that it can ignore the request if it has already been -// completed. The server guarantees that for at least 60 minutes after -// 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 to see whether -// the original operation was received. If it was, the server ignores -// the second request. This behavior prevents clients from mistakenly -// creating duplicate commitments. The request ID must be a valid UUID, -// with the exception that zero UUID is not supported +// RequestId sets the optional parameter "requestId": A 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 guarantees that a request +// doesn't result in creation of duplicate commitments for at least 60 +// minutes. 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 to see whether the original +// operation was received. If it was, the server ignores the second +// request. This behavior prevents clients from mistakenly 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 *ProjectsLocationsSpokesCreateCall) RequestId(requestId string) *ProjectsLocationsSpokesCreateCall { c.urlParams_.Set("requestId", requestId) @@ -13245,7 +13249,7 @@ func (c *ProjectsLocationsSpokesCreateCall) Do(opts ...googleapi.CallOption) (*G // "type": "string" // }, // "requestId": { - // "description": "Optional. A unique request ID (optional). If you specify this ID, you can use it in cases when you need to retry your request. When you need to retry, this ID lets the server know that it can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes after 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).", + // "description": "Optional. A 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 guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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" // }, @@ -13288,18 +13292,18 @@ func (r *ProjectsLocationsSpokesService) Delete(name string) *ProjectsLocationsS return c } -// RequestId sets the optional parameter "requestId": A unique request -// ID (optional). If you specify this ID, you can use it in cases when -// you need to retry your request. When you need to retry, this ID lets -// the server know that it can ignore the request if it has already been -// completed. The server guarantees that for at least 60 minutes after -// 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 to see whether -// the original operation was received. If it was, the server ignores -// the second request. This behavior prevents clients from mistakenly -// creating duplicate commitments. The request ID must be a valid UUID, -// with the exception that zero UUID is not supported +// RequestId sets the optional parameter "requestId": A 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 guarantees that a request +// doesn't result in creation of duplicate commitments for at least 60 +// minutes. 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 to see whether the original +// operation was received. If it was, the server ignores the second +// request. This behavior prevents clients from mistakenly 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 *ProjectsLocationsSpokesDeleteCall) RequestId(requestId string) *ProjectsLocationsSpokesDeleteCall { c.urlParams_.Set("requestId", requestId) @@ -13408,7 +13412,7 @@ func (c *ProjectsLocationsSpokesDeleteCall) Do(opts ...googleapi.CallOption) (*G // "type": "string" // }, // "requestId": { - // "description": "Optional. A unique request ID (optional). If you specify this ID, you can use it in cases when you need to retry your request. When you need to retry, this ID lets the server know that it can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes after 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).", + // "description": "Optional. A 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 guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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" // } @@ -13984,18 +13988,18 @@ func (r *ProjectsLocationsSpokesService) Patch(name string, spoke *Spoke) *Proje return c } -// RequestId sets the optional parameter "requestId": A unique request -// ID (optional). If you specify this ID, you can use it in cases when -// you need to retry your request. When you need to retry, this ID lets -// the server know that it can ignore the request if it has already been -// completed. The server guarantees that for at least 60 minutes after -// 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 to see whether -// the original operation was received. If it was, the server ignores -// the second request. This behavior prevents clients from mistakenly -// creating duplicate commitments. The request ID must be a valid UUID, -// with the exception that zero UUID is not supported +// RequestId sets the optional parameter "requestId": A 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 guarantees that a request +// doesn't result in creation of duplicate commitments for at least 60 +// minutes. 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 to see whether the original +// operation was received. If it was, the server ignores the second +// request. This behavior prevents clients from mistakenly 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 *ProjectsLocationsSpokesPatchCall) RequestId(requestId string) *ProjectsLocationsSpokesPatchCall { c.urlParams_.Set("requestId", requestId) @@ -14120,7 +14124,7 @@ func (c *ProjectsLocationsSpokesPatchCall) Do(opts ...googleapi.CallOption) (*Go // "type": "string" // }, // "requestId": { - // "description": "Optional. A unique request ID (optional). If you specify this ID, you can use it in cases when you need to retry your request. When you need to retry, this ID lets the server know that it can ignore the request if it has already been completed. The server guarantees that for at least 60 minutes after 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).", + // "description": "Optional. A 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 guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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" // }, @@ -14156,9 +14160,10 @@ type ProjectsLocationsSpokesRejectCall struct { header_ http.Header } -// Reject: Does one of the following: * Rejects a proposal to attach a -// Network Connectivity Center spoke to the hub. * Rejects and removes a -// previously attached spoke from the hub. +// Reject: Rejects a Network Connectivity Center spoke from being +// attached to the hub. If the spoke was previously in the `ACTIVE` +// state, it transitions to the `INACTIVE` state and is no longer able +// to connect to other spokes that are attached to the hub. // // - name: The name of the spoke to reject. func (r *ProjectsLocationsSpokesService) Reject(name string, rejectspokerequest *RejectSpokeRequest) *ProjectsLocationsSpokesRejectCall { @@ -14259,7 +14264,7 @@ func (c *ProjectsLocationsSpokesRejectCall) Do(opts ...googleapi.CallOption) (*G } return ret, nil // { - // "description": "Does one of the following: * Rejects a proposal to attach a Network Connectivity Center spoke to the hub. * Rejects and removes a previously attached spoke from the hub.", + // "description": "Rejects a Network Connectivity Center spoke from being attached to the hub. If the spoke was previously in the `ACTIVE` state, it transitions to the `INACTIVE` state and is no longer able to connect to other spokes that are attached to the hub.", // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/spokes/{spokesId}:reject", // "httpMethod": "POST", // "id": "networkconnectivity.projects.locations.spokes.reject", diff --git a/ondemandscanning/v1/ondemandscanning-api.json b/ondemandscanning/v1/ondemandscanning-api.json index 0f014a9d643..ae0f0874b10 100644 --- a/ondemandscanning/v1/ondemandscanning-api.json +++ b/ondemandscanning/v1/ondemandscanning-api.json @@ -339,7 +339,7 @@ } } }, - "revision": "20230710", + "revision": "20230717", "rootUrl": "https://ondemandscanning.googleapis.com/", "schemas": { "AliasContext": { @@ -2733,7 +2733,8 @@ "id": "VexAssessment", "properties": { "cve": { - "description": "Holds the MITRE standard Common Vulnerabilities and Exposures (CVE) tracking number for the vulnerability.", + "deprecated": true, + "description": "Holds the MITRE standard Common Vulnerabilities and Exposures (CVE) tracking number for the vulnerability. Deprecated: Use vulnerability_id instead to denote CVEs.", "type": "string" }, "impacts": { @@ -2782,6 +2783,10 @@ "It is not known yet whether these versions are or are not affected by the vulnerability. However, it is still under investigation." ], "type": "string" + }, + "vulnerabilityId": { + "description": "The vulnerability identifier for this Assessment. Will hold one of common identifiers e.g. CVE, GHSA etc.", + "type": "string" } }, "type": "object" diff --git a/ondemandscanning/v1/ondemandscanning-gen.go b/ondemandscanning/v1/ondemandscanning-gen.go index fda6ee497a4..14482ee4335 100644 --- a/ondemandscanning/v1/ondemandscanning-gen.go +++ b/ondemandscanning/v1/ondemandscanning-gen.go @@ -3928,7 +3928,8 @@ func (s *Version) MarshalJSON() ([]byte, error) { // information that is related to this vulnerability. type VexAssessment struct { // Cve: Holds the MITRE standard Common Vulnerabilities and Exposures - // (CVE) tracking number for the vulnerability. + // (CVE) tracking number for the vulnerability. Deprecated: Use + // vulnerability_id instead to denote CVEs. Cve string `json:"cve,omitempty"` // Impacts: Contains information about the impact of this vulnerability, @@ -3966,6 +3967,10 @@ type VexAssessment struct { // under investigation. State string `json:"state,omitempty"` + // VulnerabilityId: The vulnerability identifier for this Assessment. + // Will hold one of common identifiers e.g. CVE, GHSA etc. + VulnerabilityId string `json:"vulnerabilityId,omitempty"` + // ForceSendFields is a list of field names (e.g. "Cve") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any diff --git a/ondemandscanning/v1beta1/ondemandscanning-api.json b/ondemandscanning/v1beta1/ondemandscanning-api.json index 6065ab15e79..ebd4bd05274 100644 --- a/ondemandscanning/v1beta1/ondemandscanning-api.json +++ b/ondemandscanning/v1beta1/ondemandscanning-api.json @@ -339,7 +339,7 @@ } } }, - "revision": "20230710", + "revision": "20230717", "rootUrl": "https://ondemandscanning.googleapis.com/", "schemas": { "AliasContext": { @@ -2728,7 +2728,8 @@ "id": "VexAssessment", "properties": { "cve": { - "description": "Holds the MITRE standard Common Vulnerabilities and Exposures (CVE) tracking number for the vulnerability.", + "deprecated": true, + "description": "Holds the MITRE standard Common Vulnerabilities and Exposures (CVE) tracking number for the vulnerability. Deprecated: Use vulnerability_id instead to denote CVEs.", "type": "string" }, "impacts": { @@ -2777,6 +2778,10 @@ "It is not known yet whether these versions are or are not affected by the vulnerability. However, it is still under investigation." ], "type": "string" + }, + "vulnerabilityId": { + "description": "The vulnerability identifier for this Assessment. Will hold one of common identifiers e.g. CVE, GHSA etc.", + "type": "string" } }, "type": "object" diff --git a/ondemandscanning/v1beta1/ondemandscanning-gen.go b/ondemandscanning/v1beta1/ondemandscanning-gen.go index 9133ef7aaa6..c8444eeaa71 100644 --- a/ondemandscanning/v1beta1/ondemandscanning-gen.go +++ b/ondemandscanning/v1beta1/ondemandscanning-gen.go @@ -3922,7 +3922,8 @@ func (s *Version) MarshalJSON() ([]byte, error) { // information that is related to this vulnerability. type VexAssessment struct { // Cve: Holds the MITRE standard Common Vulnerabilities and Exposures - // (CVE) tracking number for the vulnerability. + // (CVE) tracking number for the vulnerability. Deprecated: Use + // vulnerability_id instead to denote CVEs. Cve string `json:"cve,omitempty"` // Impacts: Contains information about the impact of this vulnerability, @@ -3960,6 +3961,10 @@ type VexAssessment struct { // under investigation. State string `json:"state,omitempty"` + // VulnerabilityId: The vulnerability identifier for this Assessment. + // Will hold one of common identifiers e.g. CVE, GHSA etc. + VulnerabilityId string `json:"vulnerabilityId,omitempty"` + // ForceSendFields is a list of field names (e.g. "Cve") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any diff --git a/places/v1/places-api.json b/places/v1/places-api.json new file mode 100644 index 00000000000..6b8be19a36a --- /dev/null +++ b/places/v1/places-api.json @@ -0,0 +1,965 @@ +{ + "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." + }, + "https://www.googleapis.com/auth/maps-platform.places": { + "description": "Private Service: https://www.googleapis.com/auth/maps-platform.places" + }, + "https://www.googleapis.com/auth/maps-platform.places.textsearch": { + "description": "Private Service: https://www.googleapis.com/auth/maps-platform.places.textsearch" + } + } + } + }, + "basePath": "", + "baseUrl": "https://places.googleapis.com/", + "batchPath": "batch", + "canonicalName": "Places API (New)", + "description": "", + "discoveryVersion": "v1", + "documentationLink": "https://mapsplatform.google.com/maps-products/#places-section", + "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": "places:v1", + "kind": "discovery#restDescription", + "mtlsRootUrl": "https://places.mtls.googleapis.com/", + "name": "places", + "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": { + "Text": { + "methods": { + "search": { + "description": "Text query based place search.", + "flatPath": "v1/Text:search", + "httpMethod": "POST", + "id": "places.Text.search", + "parameterOrder": [], + "parameters": {}, + "path": "v1/Text:search", + "request": { + "$ref": "GoogleMapsPlacesV1SearchTextRequest" + }, + "response": { + "$ref": "GoogleMapsPlacesV1SearchTextResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/maps-platform.places", + "https://www.googleapis.com/auth/maps-platform.places.textsearch" + ] + } + } + }, + "places": { + "methods": { + "searchText": { + "description": "Text query based place search.", + "flatPath": "v1/places:searchText", + "httpMethod": "POST", + "id": "places.places.searchText", + "parameterOrder": [], + "parameters": {}, + "path": "v1/places:searchText", + "request": { + "$ref": "GoogleMapsPlacesV1SearchTextRequest" + }, + "response": { + "$ref": "GoogleMapsPlacesV1SearchTextResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/maps-platform.places", + "https://www.googleapis.com/auth/maps-platform.places.textsearch" + ] + } + } + } + }, + "revision": "20230718", + "rootUrl": "https://places.googleapis.com/", + "schemas": { + "GoogleGeoTypeViewport": { + "description": "A latitude-longitude viewport, represented as two diagonally opposite `low` and `high` points. A viewport is considered a closed region, i.e. it includes its boundary. The latitude bounds must range between -90 to 90 degrees inclusive, and the longitude bounds must range between -180 to 180 degrees inclusive. Various cases include: - If `low` = `high`, the viewport consists of that single point. - If `low.longitude` \u003e `high.longitude`, the longitude range is inverted (the viewport crosses the 180 degree longitude line). - If `low.longitude` = -180 degrees and `high.longitude` = 180 degrees, the viewport includes all longitudes. - If `low.longitude` = 180 degrees and `high.longitude` = -180 degrees, the longitude range is empty. - If `low.latitude` \u003e `high.latitude`, the latitude range is empty. Both `low` and `high` must be populated, and the represented box cannot be empty (as specified by the definitions above). An empty viewport will result in an error. For example, this viewport fully encloses New York City: { \"low\": { \"latitude\": 40.477398, \"longitude\": -74.259087 }, \"high\": { \"latitude\": 40.91618, \"longitude\": -73.70018 } }", + "id": "GoogleGeoTypeViewport", + "properties": { + "high": { + "$ref": "GoogleTypeLatLng", + "description": "Required. The high point of the viewport." + }, + "low": { + "$ref": "GoogleTypeLatLng", + "description": "Required. The low point of the viewport." + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1AuthorAttribution": { + "description": "Information about the author of the UGC data. Used in Photo, and Review.", + "id": "GoogleMapsPlacesV1AuthorAttribution", + "properties": { + "displayName": { + "description": "Output only. Name of the author of the Photo or Review.", + "readOnly": true, + "type": "string" + }, + "photoUri": { + "description": "Output only. Profile photo URI of the author of the Photo or Review.", + "readOnly": true, + "type": "string" + }, + "uri": { + "description": "Output only. URI of the author of the Photo or Review.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1Circle": { + "description": "Circle with a LatLng as center and radius.", + "id": "GoogleMapsPlacesV1Circle", + "properties": { + "center": { + "$ref": "GoogleTypeLatLng", + "description": "Required. Center latitude and longitude. The range of latitude must be within [-90.0, 90.0]. The range of the longitude must be within [-180.0, 180.0]." + }, + "radius": { + "description": "Required. Radius measured in meters. The radius must be within [0.0, 50000.0].", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1Int32Range": { + "description": "int 32 range. Both min and max are optional. If only min is set, then the range only has a lower bound. If only max is set, then range only has an upper bound. At least one of min and max must be set. Values are inclusive.", + "id": "GoogleMapsPlacesV1Int32Range", + "properties": { + "max": { + "description": "Upper bound. If unset, behavior is documented on the range field.", + "format": "int32", + "type": "integer" + }, + "min": { + "description": "Lower bound. If unset, behavior is documented on the range field.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1Place": { + "description": "All the information representing a Place.", + "id": "GoogleMapsPlacesV1Place", + "properties": { + "addressComponents": { + "description": "Output only. Repeated components for each locality level.", + "items": { + "$ref": "GoogleMapsPlacesV1PlaceAddressComponent" + }, + "readOnly": true, + "type": "array" + }, + "adrFormatAddress": { + "description": "Output only. The place's address in adr microformat: http://microformats.org/wiki/adr.", + "readOnly": true, + "type": "string" + }, + "attributions": { + "description": "Output only. A set of data provider that must be shown with this result.", + "items": { + "$ref": "GoogleMapsPlacesV1PlaceAttribution" + }, + "readOnly": true, + "type": "array" + }, + "businessStatus": { + "description": "Output only. The business status for the place.", + "enum": [ + "BUSINESS_STATUS_UNSPECIFIED", + "OPERATIONAL", + "CLOSED_TEMPORARILY", + "CLOSED_PERMANENTLY" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "The establishment is operational, not necessarily open now.", + "The establishment is temporarily closed.", + "The establishment is permanently closed." + ], + "readOnly": true, + "type": "string" + }, + "curbsidePickup": { + "description": "Output only. Specifies if the business supports curbside pickup.", + "readOnly": true, + "type": "boolean" + }, + "currentOpeningHours": { + "$ref": "GoogleMapsPlacesV1PlaceOpeningHours", + "description": "Output only. The hours of operation for the next seven days (including today). The time period starts at midnight on the date of the request and ends at 11:59 pm six days later. This field includes the special_days subfield of all hours, set for dates that have exceptional hours.", + "readOnly": true + }, + "currentSecondaryOpeningHours": { + "description": "Output only. Contains an array of entries for the next seven days including information about secondary hours of a business. Secondary hours are different from a business's main hours. For example, a restaurant can specify drive through hours or delivery hours as its secondary hours. This field populates the type subfield, which draws from a predefined list of opening hours types (such as DRIVE_THROUGH, PICKUP, or TAKEOUT) based on the types of the place. This field includes the special_days subfield of all hours, set for dates that have exceptional hours.", + "items": { + "$ref": "GoogleMapsPlacesV1PlaceOpeningHours" + }, + "readOnly": true, + "type": "array" + }, + "delivery": { + "description": "Output only. Specifies if the business supports delivery.", + "readOnly": true, + "type": "boolean" + }, + "dineIn": { + "description": "Output only. Specifies if the business supports indoor or outdoor seating options.", + "readOnly": true, + "type": "boolean" + }, + "displayName": { + "$ref": "GoogleTypeLocalizedText", + "description": "Output only. The localized name of the place, suitable as a short human-readable description. For example, \"Google Sydney\", \"Starbucks\", \"Pyrmont\", etc.", + "readOnly": true + }, + "editorialSummary": { + "$ref": "GoogleTypeLocalizedText", + "description": "Output only. Contains a summary of the place. A summary is comprised of a textual overview, and also includes the language code for these if applicable. Summary text must be presented as-is and can not be modified or altered.", + "readOnly": true + }, + "formattedAddress": { + "description": "Output only. A full, human-readable address for this place.", + "readOnly": true, + "type": "string" + }, + "googleMapsUri": { + "description": "Output only. A URL providing more information about this place.", + "readOnly": true, + "type": "string" + }, + "iconBackgroundColor": { + "description": "Output only. Background color for icon_mask in hex format, e.g. #909CE1.", + "readOnly": true, + "type": "string" + }, + "iconMaskBaseUri": { + "description": "Output only. A truncated URL to an v2 icon mask. User can access different icon type by appending type suffix to the end (eg, \".svg\" or \".png\").", + "readOnly": true, + "type": "string" + }, + "id": { + "description": "Output only. The unique identifier of a place.", + "readOnly": true, + "type": "string" + }, + "internationalPhoneNumber": { + "description": "Output only. A human-readable phone number for the place, in international format.", + "readOnly": true, + "type": "string" + }, + "location": { + "$ref": "GoogleTypeLatLng", + "description": "Output only. The position of this place.", + "readOnly": true + }, + "name": { + "description": "Output only. An ID representing this place which may be used to look up this place again (a.k.a. the API \"resource\" name: places/).", + "readOnly": true, + "type": "string" + }, + "nationalPhoneNumber": { + "description": "Output only. A human-readable phone number for the place, in national format.", + "readOnly": true, + "type": "string" + }, + "openingHours": { + "$ref": "GoogleMapsPlacesV1PlaceOpeningHours", + "description": "Output only. The regular hours of operation.", + "readOnly": true + }, + "plusCode": { + "$ref": "GoogleMapsPlacesV1PlacePlusCode", + "description": "Output only. Plus code of the place location lat/long.", + "readOnly": true + }, + "priceLevel": { + "description": "Output only. Price level of the place.", + "enum": [ + "PRICE_LEVEL_UNSPECIFIED", + "PRICE_LEVEL_FREE", + "PRICE_LEVEL_INEXPENSIVE", + "PRICE_LEVEL_MODERATE", + "PRICE_LEVEL_EXPENSIVE", + "PRICE_LEVEL_VERY_EXPENSIVE" + ], + "enumDescriptions": [ + "Place price level is unspecified or unknown.", + "Place provides free services.", + "Place provides inexpensive services.", + "Place provides moderately priced services.", + "Place provides expensive services.", + "Place provides very expensive services." + ], + "readOnly": true, + "type": "string" + }, + "rating": { + "description": "Output only. A rating between 1.0 and 5.0, based on user reviews of this place.", + "format": "double", + "readOnly": true, + "type": "number" + }, + "reservable": { + "description": "Output only. Specifies if the place supports reservations.", + "readOnly": true, + "type": "boolean" + }, + "reviews": { + "description": "Output only. List of reviews about this place.", + "items": { + "$ref": "GoogleMapsPlacesV1PlaceReview" + }, + "readOnly": true, + "type": "array" + }, + "secondaryOpeningHours": { + "description": "Output only. Contains an array of entries for information about regular secondary hours of a business. Secondary hours are different from a business's main hours. For example, a restaurant can specify drive through hours or delivery hours as its secondary hours. This field populates the type subfield, which draws from a predefined list of opening hours types (such as DRIVE_THROUGH, PICKUP, or TAKEOUT) based on the types of the place.", + "items": { + "$ref": "GoogleMapsPlacesV1PlaceOpeningHours" + }, + "readOnly": true, + "type": "array" + }, + "servesBeer": { + "description": "Output only. Specifies if the place serves beer.", + "readOnly": true, + "type": "boolean" + }, + "servesBreakfast": { + "description": "Output only. Specifies if the place serves breakfast.", + "readOnly": true, + "type": "boolean" + }, + "servesBrunch": { + "description": "Output only. Specifies if the place serves brunch.", + "readOnly": true, + "type": "boolean" + }, + "servesDinner": { + "description": "Output only. Specifies if the place serves dinner.", + "readOnly": true, + "type": "boolean" + }, + "servesLunch": { + "description": "Output only. Specifies if the place serves lunch.", + "readOnly": true, + "type": "boolean" + }, + "servesVegetarianFood": { + "description": "Output only. Specifies if the place serves vegetarian food.", + "readOnly": true, + "type": "boolean" + }, + "servesWine": { + "description": "Output only. Specifies if the place serves wine.", + "readOnly": true, + "type": "boolean" + }, + "takeout": { + "description": "Output only. Specifies if the business supports takeout.", + "readOnly": true, + "type": "boolean" + }, + "types": { + "description": "Output only. A set of type tags for this result. For example, \"political\" and \"locality\".", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "userRatingCount": { + "description": "Output only. The total number of reviews (with or without text) for this place.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "utcOffsetMinutes": { + "description": "Output only. Number of minutes this place's timezone is currently offset from UTC. This is expressed in minutes to support timezones that are offset by fractions of an hour, e.g. X hours and 15 minutes.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "viewport": { + "$ref": "GoogleGeoTypeViewport", + "description": "Output only. A viewport suitable for displaying the place on an average-sized map.", + "readOnly": true + }, + "websiteUri": { + "description": "Output only. The authoritative website for this place, e.g. a business' homepage. Note that for places that are part of a chain (e.g. an IKEA store), this will usually be the website for the individual store, not the overall chain.", + "readOnly": true, + "type": "string" + }, + "wheelchairAccessibleEntrance": { + "description": "Output only. Specifies if the place has an entrance that is wheelchair-accessible.", + "readOnly": true, + "type": "boolean" + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1PlaceAddressComponent": { + "description": "The structured components that form the formatted address, if this information is available.", + "id": "GoogleMapsPlacesV1PlaceAddressComponent", + "properties": { + "languageCode": { + "description": "Output only. The language used to format this components, in CLDR notation.", + "readOnly": true, + "type": "string" + }, + "longText": { + "description": "Output only. The full text description or name of the address component. For example, an address component for the country Australia may have a long_name of \"Australia\".", + "readOnly": true, + "type": "string" + }, + "shortText": { + "description": "Output only. An abbreviated textual name for the address component, if available. For example, an address component for the country of Australia may have a short_name of \"AU\".", + "readOnly": true, + "type": "string" + }, + "types": { + "description": "Output only. An array indicating the type(s) of the address component.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1PlaceAttribution": { + "description": "Information about data providers of this place.", + "id": "GoogleMapsPlacesV1PlaceAttribution", + "properties": { + "provider": { + "description": "Output only. Name of the Place's data provider.", + "readOnly": true, + "type": "string" + }, + "providerUri": { + "description": "Output only. URI to the Place's data provider.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1PlaceOpeningHours": { + "description": "Information about business hour of the place.", + "id": "GoogleMapsPlacesV1PlaceOpeningHours", + "properties": { + "openNow": { + "description": "Output only. Is this place open right now? Always present unless we lack time-of-day or timezone data for these opening hours.", + "readOnly": true, + "type": "boolean" + }, + "periods": { + "description": "Output only. The periods that this place is open during the week. The periods are in chronological order, starting with Sunday in the place-local timezone. An empty (but not absent) value indicates a place that is never open, e.g. because it is closed temporarily for renovations.", + "items": { + "$ref": "GoogleMapsPlacesV1PlaceOpeningHoursPeriod" + }, + "readOnly": true, + "type": "array" + }, + "secondaryHoursType": { + "description": "Output only. A type string used to identify the type of secondary hours.", + "enum": [ + "SECONDARY_HOURS_TYPE_UNSPECIFIED", + "DRIVE_THROUGH", + "HAPPY_HOUR", + "DELIVERY", + "TAKEOUT", + "KITCHEN", + "BREAKFAST", + "LUNCH", + "DINNER", + "BRUNCH", + "PICKUP", + "ACCESS", + "SENIOR_HOURS", + "ONLINE_SERVICE_HOURS" + ], + "enumDescriptions": [ + "Default value when secondary hour type is not specified.", + "The drive-through hour for banks, restaurants, or pharmacies.", + "The happy hour.", + "The delivery hour.", + "The takeout hour.", + "The kitchen hour.", + "The breakfast hour.", + "The lunch hour.", + "The dinner hour.", + "The brunch hour.", + "The pickup hour.", + "The access hours for storage places.", + "The special hours for seniors.", + "The online service hours." + ], + "readOnly": true, + "type": "string" + }, + "specialDays": { + "description": "Output only. Structured information for special days that fall within the period that the returned opening hours cover. Special days are days that could impact the business hours of a place, e.g. Christmas day. Set for current_opening_hours and current_secondary_opening_hours if there are exceptional hours.", + "items": { + "$ref": "GoogleMapsPlacesV1PlaceOpeningHoursSpecialDay" + }, + "readOnly": true, + "type": "array" + }, + "weekdayDescriptions": { + "description": "Output only. Localized strings describing the opening hours of this place, one string for each day of the week. Will be empty if the hours are unknown or could not be converted to localized text. Example: \"Sun: 18:00–06:00\"", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1PlaceOpeningHoursPeriod": { + "description": "A period the place remains in open_now status.", + "id": "GoogleMapsPlacesV1PlaceOpeningHoursPeriod", + "properties": { + "close": { + "$ref": "GoogleMapsPlacesV1PlaceOpeningHoursPeriodPoint", + "description": "Output only. The time that the place starts to be closed.", + "readOnly": true + }, + "open": { + "$ref": "GoogleMapsPlacesV1PlaceOpeningHoursPeriodPoint", + "description": "Output only. The time that the place starts to be open.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1PlaceOpeningHoursPeriodPoint": { + "description": "Status changing points.", + "id": "GoogleMapsPlacesV1PlaceOpeningHoursPeriodPoint", + "properties": { + "date": { + "$ref": "GoogleTypeDate", + "description": "Output only. Date in the local timezone for the place.", + "readOnly": true + }, + "dateDeprecated": { + "deprecated": true, + "description": "Output only. Date of the endpoint expressed in RFC3339 format in the local timezone for the place. For example 2010-12-31.", + "readOnly": true, + "type": "string" + }, + "day": { + "description": "Output only. A day of the week, as an integer in the range 0-6. 0 is Sunday, 1 is Monday, etc.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "hour": { + "description": "Output only. The hour in 2 digits. Ranges from 00 to 23.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "minute": { + "description": "Output only. The minute in 2 digits. Ranges from 00 to 59.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "truncated": { + "description": "Output only. Whether or not this endpoint was truncated. Truncation occurs when the real hours are outside the times we are willing to return hours between, so we truncate the hours back to these boundaries. This ensures that at most 24 * 7 hours from midnight of the day of the request are returned.", + "readOnly": true, + "type": "boolean" + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1PlaceOpeningHoursSpecialDay": { + "description": "Structured information for special days that fall within the period that the returned opening hours cover. Special days are days that could impact the business hours of a place, e.g. Christmas day.", + "id": "GoogleMapsPlacesV1PlaceOpeningHoursSpecialDay", + "properties": { + "date": { + "$ref": "GoogleTypeDate", + "description": "Output only. The date of this special day.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1PlacePlusCode": { + "description": "Plus code (http://plus.codes) is a location reference with two formats: global code defining a 14mx14m (1/8000th of a degree) or smaller rectangle, and compound code, replacing the prefix with a reference location.", + "id": "GoogleMapsPlacesV1PlacePlusCode", + "properties": { + "compoundCode": { + "description": "Output only. Place's compound code, such as \"33GV+HQ, Ramberg, Norway\", containing the suffix of the global code and replacing the prefix with a formatted name of a reference entity.", + "readOnly": true, + "type": "string" + }, + "globalCode": { + "description": "Output only. Place's global (full) code, such as \"9FWM33GV+HQ\", representing an 1/8000 by 1/8000 degree area (~14 by 14 meters).", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1PlaceReview": { + "description": "Information about a review of the place.", + "id": "GoogleMapsPlacesV1PlaceReview", + "properties": { + "authorAttribution": { + "$ref": "GoogleMapsPlacesV1AuthorAttribution", + "description": "Output only. This review's author.", + "readOnly": true + }, + "originalLanguageCode": { + "deprecated": true, + "description": "Output only. A BCP-47 language code indicating the original language of the review. If the review has been translated, then original_language != language. This field contains the main language tag only, and not the secondary tag indicating country or region. For example, all the English reviews are tagged as 'en', and not 'en-AU' or 'en-UK' and so on.This field is empty if there is only a rating with no review text.", + "readOnly": true, + "type": "string" + }, + "originalText": { + "$ref": "GoogleTypeLocalizedText", + "description": "Output only. The review text in its original language.", + "readOnly": true + }, + "publishTime": { + "description": "Output only. Timestamp for the review, expressed in seconds since epoch.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "rating": { + "description": "Output only. A whole number between 1.0 and 5.0, a.k.a. the number of stars.", + "format": "double", + "readOnly": true, + "type": "number" + }, + "relativePublishTimeDescription": { + "description": "Output only. A string of formatted recent time, expressing the review time relative to the current time in a form appropriate for the language and country.", + "readOnly": true, + "type": "string" + }, + "text": { + "$ref": "GoogleTypeLocalizedText", + "description": "Output only. The localized text of the review.", + "readOnly": true + }, + "translated": { + "deprecated": true, + "description": "Output only. A boolean value indicating if the review was translated from the original language it was written in. If a review has been translated, corresponding to a value of true, Google recommends that you indicate this to your users. For example, you can add the following string, “Translated by Google”, to the review.", + "readOnly": true, + "type": "boolean" + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1SearchTextRequest": { + "description": "Request proto for SearchText. ", + "id": "GoogleMapsPlacesV1SearchTextRequest", + "properties": { + "includedType": { + "description": "The requested place type. Full list of types supported: https://developers.google.com/places/supported_types. Only support one included type.", + "type": "string" + }, + "languageCode": { + "description": "Place details will be displayed with the preferred language if available. If the language code is unspecified or unrecognized, place details of any language may be returned, with a preference for English if such details exist. Current list of supported languages: https://developers.google.com/maps/faq#languagesupport.", + "type": "string" + }, + "location": { + "$ref": "GoogleMapsPlacesV1SearchTextRequestLocation", + "deprecated": true, + "description": "[Deprecated!]The region to search. Setting location would usually yields better results. Recommended to set. This location serves as a bias unless strict_restriction is set to true, which turns the location to a strict restriction." + }, + "locationBias": { + "$ref": "GoogleMapsPlacesV1SearchTextRequestLocationBias", + "description": "The region to search. This location serves as a bias which means results around given location might be returned. Cannot be set along with location_restriction." + }, + "locationRestriction": { + "$ref": "GoogleMapsPlacesV1SearchTextRequestLocationRestriction", + "description": "The region to search. This location serves as a restriction which means results outside given location will not be returned. Cannot be set along with location_bias." + }, + "maxResultCount": { + "description": "Maximum number of results to return. It must be between 1 and 20, inclusively. If the number is unset, it falls back to the upper limit. If the number is set to negative or exceeds the upper limit, an INVALID_ARGUMENT error is returned.", + "format": "int32", + "type": "integer" + }, + "minRating": { + "description": "Filter out results whose average user rating is strictly less than this limit. A valid value must be an float between 0 and 5 (inclusively) at a 0.5 cadence i.e. [0, 0.5, 1.0, ... , 5.0] inclusively. This is to keep parity with LocalRefinement_UserRating. The input rating will round up to the nearest 0.5(ceiling). For instance, a rating of 0.6 will eliminate all results with a less than 1.0 rating.", + "format": "double", + "type": "number" + }, + "openNow": { + "description": "Used to restrict the search to places that are open at a specific time. open_now marks if a business is currently open.", + "type": "boolean" + }, + "priceLevels": { + "description": "Used to restrict the search to places that are marked as certain price levels. Users can choose any combinations of price levels. Default to select all price levels.", + "items": { + "enum": [ + "PRICE_LEVEL_UNSPECIFIED", + "PRICE_LEVEL_FREE", + "PRICE_LEVEL_INEXPENSIVE", + "PRICE_LEVEL_MODERATE", + "PRICE_LEVEL_EXPENSIVE", + "PRICE_LEVEL_VERY_EXPENSIVE" + ], + "enumDescriptions": [ + "Place price level is unspecified or unknown.", + "Place provides free services.", + "Place provides inexpensive services.", + "Place provides moderately priced services.", + "Place provides expensive services.", + "Place provides very expensive services." + ], + "type": "string" + }, + "type": "array" + }, + "priceRange": { + "$ref": "GoogleMapsPlacesV1Int32Range", + "deprecated": true, + "description": "[Deprecated!]Used to restrict the search to places that are within a certain price range. This is on a scale of 0 to 4. Set a minimum of 0 or set a maximum of 4 has no effect on the search results. Min price is default to 0 and max price is default to 4. Default value will be used if either min or max is unset." + }, + "rankPreference": { + "description": "How results will be ranked in the response.", + "enum": [ + "RANK_PREFERENCE_UNSPECIFIED", + "DISTANCE", + "RELEVANCE" + ], + "enumDescriptions": [ + "RankPreference value not set. Will default to DISTANCE.", + "Ranks results by distance.", + "Ranks results by relevance. Sort order determined by normal ranking stack. See SortRefinement::RELEVANCE." + ], + "type": "string" + }, + "regionCode": { + "description": "The Unicode country/region code (CLDR) of the location where the request is coming from. It is used to display the place details, like region-specific place name, if available. For more information, see http://www.unicode.org/reports/tr35/#unicode_region_subtag. Note that 3-digit region codes are not currently supported.", + "type": "string" + }, + "strictTypeFiltering": { + "description": "Used to set strict type filtering for included_type. If set to true, only results of the same type will be returned. Default to false.", + "type": "boolean" + }, + "textQuery": { + "description": "Required. The text query for textual search.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1SearchTextRequestLocation": { + "description": "[Deprecated!]The region to search.", + "id": "GoogleMapsPlacesV1SearchTextRequestLocation", + "properties": { + "rectangle": { + "$ref": "GoogleGeoTypeViewport", + "description": "A rectangle box defined by northeast and southwest corner." + }, + "strictRestriction": { + "description": "Make location field a strict restriction and filter out POIs outside of the given location. If location type field is unset this field will have no effect.", + "type": "boolean" + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1SearchTextRequestLocationBias": { + "description": "The region to search. This location serves as a bias which means results around given location might be returned.", + "id": "GoogleMapsPlacesV1SearchTextRequestLocationBias", + "properties": { + "circle": { + "$ref": "GoogleMapsPlacesV1Circle", + "description": "A circle defined by center point and radius." + }, + "rectangle": { + "$ref": "GoogleGeoTypeViewport", + "description": "A rectangle box defined by northeast and southwest corner." + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1SearchTextRequestLocationRestriction": { + "description": "The region to search. This location serves as a restriction which means results outside given location will not be returned.", + "id": "GoogleMapsPlacesV1SearchTextRequestLocationRestriction", + "properties": { + "rectangle": { + "$ref": "GoogleGeoTypeViewport", + "description": "A rectangle box defined by northeast and southwest corner." + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1SearchTextResponse": { + "description": "Response proto for SearchText. ", + "id": "GoogleMapsPlacesV1SearchTextResponse", + "properties": { + "places": { + "description": "A list of places that meet the user's text search criteria.", + "items": { + "$ref": "GoogleMapsPlacesV1Place" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleTypeDate": { + "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp", + "id": "GoogleTypeDate", + "properties": { + "day": { + "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", + "format": "int32", + "type": "integer" + }, + "month": { + "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", + "format": "int32", + "type": "integer" + }, + "year": { + "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "GoogleTypeLatLng": { + "description": "An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the WGS84 standard. Values must be within normalized ranges.", + "id": "GoogleTypeLatLng", + "properties": { + "latitude": { + "description": "The latitude in degrees. It must be in the range [-90.0, +90.0].", + "format": "double", + "type": "number" + }, + "longitude": { + "description": "The longitude in degrees. It must be in the range [-180.0, +180.0].", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleTypeLocalizedText": { + "description": "Localized variant of a text in a particular language.", + "id": "GoogleTypeLocalizedText", + "properties": { + "languageCode": { + "description": "The text's BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.", + "type": "string" + }, + "text": { + "description": "Localized string in the language corresponding to `language_code' below.", + "type": "string" + } + }, + "type": "object" + } + }, + "servicePath": "", + "title": "Places API (New)", + "version": "v1", + "version_module": true +} \ No newline at end of file diff --git a/places/v1/places-gen.go b/places/v1/places-gen.go new file mode 100644 index 00000000000..37610a08c4e --- /dev/null +++ b/places/v1/places-gen.go @@ -0,0 +1,1606 @@ +// 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 places provides access to the Places API (New). +// +// For product documentation, see: https://mapsplatform.google.com/maps-products/#places-section +// +// # Creating a client +// +// Usage example: +// +// import "google.golang.org/api/places/v1" +// ... +// ctx := context.Background() +// placesService, err := places.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 +// +// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes: +// +// placesService, err := places.NewService(ctx, option.WithScopes(places.MapsPlatformPlacesTextsearchScope)) +// +// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey: +// +// placesService, err := places.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, ...) +// placesService, err := places.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token))) +// +// See https://godoc.org/google.golang.org/api/option/ for details on options. +package places // import "google.golang.org/api/places/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 = "places:v1" +const apiName = "places" +const apiVersion = "v1" +const basePath = "https://places.googleapis.com/" +const mtlsBasePath = "https://places.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" + + // Private Service: https://www.googleapis.com/auth/maps-platform.places + MapsPlatformPlacesScope = "https://www.googleapis.com/auth/maps-platform.places" + + // Private Service: + // https://www.googleapis.com/auth/maps-platform.places.textsearch + MapsPlatformPlacesTextsearchScope = "https://www.googleapis.com/auth/maps-platform.places.textsearch" +) + +// NewService creates a new Service. +func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error) { + scopesOption := internaloption.WithDefaultScopes( + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/maps-platform.places", + "https://www.googleapis.com/auth/maps-platform.places.textsearch", + ) + // 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.Text = NewTextService(s) + s.Places = NewPlacesService(s) + return s, nil +} + +type Service struct { + client *http.Client + BasePath string // API endpoint base URL + UserAgent string // optional additional User-Agent fragment + + Text *TextService + + Places *PlacesService +} + +func (s *Service) userAgent() string { + if s.UserAgent == "" { + return googleapi.UserAgent + } + return googleapi.UserAgent + " " + s.UserAgent +} + +func NewTextService(s *Service) *TextService { + rs := &TextService{s: s} + return rs +} + +type TextService struct { + s *Service +} + +func NewPlacesService(s *Service) *PlacesService { + rs := &PlacesService{s: s} + return rs +} + +type PlacesService struct { + s *Service +} + +// GoogleGeoTypeViewport: A latitude-longitude viewport, represented as +// two diagonally opposite `low` and `high` points. A viewport is +// considered a closed region, i.e. it includes its boundary. The +// latitude bounds must range between -90 to 90 degrees inclusive, and +// the longitude bounds must range between -180 to 180 degrees +// inclusive. Various cases include: - If `low` = `high`, the viewport +// consists of that single point. - If `low.longitude` > +// `high.longitude`, the longitude range is inverted (the viewport +// crosses the 180 degree longitude line). - If `low.longitude` = -180 +// degrees and `high.longitude` = 180 degrees, the viewport includes all +// longitudes. - If `low.longitude` = 180 degrees and `high.longitude` = +// -180 degrees, the longitude range is empty. - If `low.latitude` > +// `high.latitude`, the latitude range is empty. Both `low` and `high` +// must be populated, and the represented box cannot be empty (as +// specified by the definitions above). An empty viewport will result in +// an error. For example, this viewport fully encloses New York City: { +// "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { +// "latitude": 40.91618, "longitude": -73.70018 } } +type GoogleGeoTypeViewport struct { + // High: Required. The high point of the viewport. + High *GoogleTypeLatLng `json:"high,omitempty"` + + // Low: Required. The low point of the viewport. + Low *GoogleTypeLatLng `json:"low,omitempty"` + + // ForceSendFields is a list of field names (e.g. "High") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "High") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleGeoTypeViewport) MarshalJSON() ([]byte, error) { + type NoMethod GoogleGeoTypeViewport + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleMapsPlacesV1AuthorAttribution: Information about the author of +// the UGC data. Used in Photo, and Review. +type GoogleMapsPlacesV1AuthorAttribution struct { + // DisplayName: Output only. Name of the author of the Photo or Review. + DisplayName string `json:"displayName,omitempty"` + + // PhotoUri: Output only. Profile photo URI of the author of the Photo + // or Review. + PhotoUri string `json:"photoUri,omitempty"` + + // Uri: Output only. URI of the author of the Photo or Review. + Uri string `json:"uri,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 + // sent to the server regardless of whether the field is empty or 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 *GoogleMapsPlacesV1AuthorAttribution) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1AuthorAttribution + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleMapsPlacesV1Circle: Circle with a LatLng as center and radius. +type GoogleMapsPlacesV1Circle struct { + // Center: Required. Center latitude and longitude. The range of + // latitude must be within [-90.0, 90.0]. The range of the longitude + // must be within [-180.0, 180.0]. + Center *GoogleTypeLatLng `json:"center,omitempty"` + + // Radius: Required. Radius measured in meters. The radius must be + // within [0.0, 50000.0]. + Radius float64 `json:"radius,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Center") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Center") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleMapsPlacesV1Circle) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1Circle + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +func (s *GoogleMapsPlacesV1Circle) UnmarshalJSON(data []byte) error { + type NoMethod GoogleMapsPlacesV1Circle + var s1 struct { + Radius gensupport.JSONFloat64 `json:"radius"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Radius = float64(s1.Radius) + return nil +} + +// GoogleMapsPlacesV1Int32Range: int 32 range. Both min and max are +// optional. If only min is set, then the range only has a lower bound. +// If only max is set, then range only has an upper bound. At least one +// of min and max must be set. Values are inclusive. +type GoogleMapsPlacesV1Int32Range struct { + // Max: Upper bound. If unset, behavior is documented on the range + // field. + Max int64 `json:"max,omitempty"` + + // Min: Lower bound. If unset, behavior is documented on the range + // field. + Min int64 `json:"min,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Max") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Max") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleMapsPlacesV1Int32Range) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1Int32Range + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleMapsPlacesV1Place: All the information representing a Place. +type GoogleMapsPlacesV1Place struct { + // AddressComponents: Output only. Repeated components for each locality + // level. + AddressComponents []*GoogleMapsPlacesV1PlaceAddressComponent `json:"addressComponents,omitempty"` + + // AdrFormatAddress: Output only. The place's address in adr + // microformat: http://microformats.org/wiki/adr. + AdrFormatAddress string `json:"adrFormatAddress,omitempty"` + + // Attributions: Output only. A set of data provider that must be shown + // with this result. + Attributions []*GoogleMapsPlacesV1PlaceAttribution `json:"attributions,omitempty"` + + // BusinessStatus: Output only. The business status for the place. + // + // Possible values: + // "BUSINESS_STATUS_UNSPECIFIED" - Default value. This value is + // unused. + // "OPERATIONAL" - The establishment is operational, not necessarily + // open now. + // "CLOSED_TEMPORARILY" - The establishment is temporarily closed. + // "CLOSED_PERMANENTLY" - The establishment is permanently closed. + BusinessStatus string `json:"businessStatus,omitempty"` + + // CurbsidePickup: Output only. Specifies if the business supports + // curbside pickup. + CurbsidePickup bool `json:"curbsidePickup,omitempty"` + + // CurrentOpeningHours: Output only. The hours of operation for the next + // seven days (including today). The time period starts at midnight on + // the date of the request and ends at 11:59 pm six days later. This + // field includes the special_days subfield of all hours, set for dates + // that have exceptional hours. + CurrentOpeningHours *GoogleMapsPlacesV1PlaceOpeningHours `json:"currentOpeningHours,omitempty"` + + // CurrentSecondaryOpeningHours: Output only. Contains an array of + // entries for the next seven days including information about secondary + // hours of a business. Secondary hours are different from a business's + // main hours. For example, a restaurant can specify drive through hours + // or delivery hours as its secondary hours. This field populates the + // type subfield, which draws from a predefined list of opening hours + // types (such as DRIVE_THROUGH, PICKUP, or TAKEOUT) based on the types + // of the place. This field includes the special_days subfield of all + // hours, set for dates that have exceptional hours. + CurrentSecondaryOpeningHours []*GoogleMapsPlacesV1PlaceOpeningHours `json:"currentSecondaryOpeningHours,omitempty"` + + // Delivery: Output only. Specifies if the business supports delivery. + Delivery bool `json:"delivery,omitempty"` + + // DineIn: Output only. Specifies if the business supports indoor or + // outdoor seating options. + DineIn bool `json:"dineIn,omitempty"` + + // DisplayName: Output only. The localized name of the place, suitable + // as a short human-readable description. For example, "Google Sydney", + // "Starbucks", "Pyrmont", etc. + DisplayName *GoogleTypeLocalizedText `json:"displayName,omitempty"` + + // EditorialSummary: Output only. Contains a summary of the place. A + // summary is comprised of a textual overview, and also includes the + // language code for these if applicable. Summary text must be presented + // as-is and can not be modified or altered. + EditorialSummary *GoogleTypeLocalizedText `json:"editorialSummary,omitempty"` + + // FormattedAddress: Output only. A full, human-readable address for + // this place. + FormattedAddress string `json:"formattedAddress,omitempty"` + + // GoogleMapsUri: Output only. A URL providing more information about + // this place. + GoogleMapsUri string `json:"googleMapsUri,omitempty"` + + // IconBackgroundColor: Output only. Background color for icon_mask in + // hex format, e.g. #909CE1. + IconBackgroundColor string `json:"iconBackgroundColor,omitempty"` + + // IconMaskBaseUri: Output only. A truncated URL to an v2 icon mask. + // User can access different icon type by appending type suffix to the + // end (eg, ".svg" or ".png"). + IconMaskBaseUri string `json:"iconMaskBaseUri,omitempty"` + + // Id: Output only. The unique identifier of a place. + Id string `json:"id,omitempty"` + + // InternationalPhoneNumber: Output only. A human-readable phone number + // for the place, in international format. + InternationalPhoneNumber string `json:"internationalPhoneNumber,omitempty"` + + // Location: Output only. The position of this place. + Location *GoogleTypeLatLng `json:"location,omitempty"` + + // Name: Output only. An ID representing this place which may be used to + // look up this place again (a.k.a. the API "resource" name: places/). + Name string `json:"name,omitempty"` + + // NationalPhoneNumber: Output only. A human-readable phone number for + // the place, in national format. + NationalPhoneNumber string `json:"nationalPhoneNumber,omitempty"` + + // OpeningHours: Output only. The regular hours of operation. + OpeningHours *GoogleMapsPlacesV1PlaceOpeningHours `json:"openingHours,omitempty"` + + // PlusCode: Output only. Plus code of the place location lat/long. + PlusCode *GoogleMapsPlacesV1PlacePlusCode `json:"plusCode,omitempty"` + + // PriceLevel: Output only. Price level of the place. + // + // Possible values: + // "PRICE_LEVEL_UNSPECIFIED" - Place price level is unspecified or + // unknown. + // "PRICE_LEVEL_FREE" - Place provides free services. + // "PRICE_LEVEL_INEXPENSIVE" - Place provides inexpensive services. + // "PRICE_LEVEL_MODERATE" - Place provides moderately priced services. + // "PRICE_LEVEL_EXPENSIVE" - Place provides expensive services. + // "PRICE_LEVEL_VERY_EXPENSIVE" - Place provides very expensive + // services. + PriceLevel string `json:"priceLevel,omitempty"` + + // Rating: Output only. A rating between 1.0 and 5.0, based on user + // reviews of this place. + Rating float64 `json:"rating,omitempty"` + + // Reservable: Output only. Specifies if the place supports + // reservations. + Reservable bool `json:"reservable,omitempty"` + + // Reviews: Output only. List of reviews about this place. + Reviews []*GoogleMapsPlacesV1PlaceReview `json:"reviews,omitempty"` + + // SecondaryOpeningHours: Output only. Contains an array of entries for + // information about regular secondary hours of a business. Secondary + // hours are different from a business's main hours. For example, a + // restaurant can specify drive through hours or delivery hours as its + // secondary hours. This field populates the type subfield, which draws + // from a predefined list of opening hours types (such as DRIVE_THROUGH, + // PICKUP, or TAKEOUT) based on the types of the place. + SecondaryOpeningHours []*GoogleMapsPlacesV1PlaceOpeningHours `json:"secondaryOpeningHours,omitempty"` + + // ServesBeer: Output only. Specifies if the place serves beer. + ServesBeer bool `json:"servesBeer,omitempty"` + + // ServesBreakfast: Output only. Specifies if the place serves + // breakfast. + ServesBreakfast bool `json:"servesBreakfast,omitempty"` + + // ServesBrunch: Output only. Specifies if the place serves brunch. + ServesBrunch bool `json:"servesBrunch,omitempty"` + + // ServesDinner: Output only. Specifies if the place serves dinner. + ServesDinner bool `json:"servesDinner,omitempty"` + + // ServesLunch: Output only. Specifies if the place serves lunch. + ServesLunch bool `json:"servesLunch,omitempty"` + + // ServesVegetarianFood: Output only. Specifies if the place serves + // vegetarian food. + ServesVegetarianFood bool `json:"servesVegetarianFood,omitempty"` + + // ServesWine: Output only. Specifies if the place serves wine. + ServesWine bool `json:"servesWine,omitempty"` + + // Takeout: Output only. Specifies if the business supports takeout. + Takeout bool `json:"takeout,omitempty"` + + // Types: Output only. A set of type tags for this result. For example, + // "political" and "locality". + Types []string `json:"types,omitempty"` + + // UserRatingCount: Output only. The total number of reviews (with or + // without text) for this place. + UserRatingCount int64 `json:"userRatingCount,omitempty"` + + // UtcOffsetMinutes: Output only. Number of minutes this place's + // timezone is currently offset from UTC. This is expressed in minutes + // to support timezones that are offset by fractions of an hour, e.g. X + // hours and 15 minutes. + UtcOffsetMinutes int64 `json:"utcOffsetMinutes,omitempty"` + + // Viewport: Output only. A viewport suitable for displaying the place + // on an average-sized map. + Viewport *GoogleGeoTypeViewport `json:"viewport,omitempty"` + + // WebsiteUri: Output only. The authoritative website for this place, + // e.g. a business' homepage. Note that for places that are part of a + // chain (e.g. an IKEA store), this will usually be the website for the + // individual store, not the overall chain. + WebsiteUri string `json:"websiteUri,omitempty"` + + // WheelchairAccessibleEntrance: Output only. Specifies if the place has + // an entrance that is wheelchair-accessible. + WheelchairAccessibleEntrance bool `json:"wheelchairAccessibleEntrance,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AddressComponents") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AddressComponents") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleMapsPlacesV1Place) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1Place + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +func (s *GoogleMapsPlacesV1Place) UnmarshalJSON(data []byte) error { + type NoMethod GoogleMapsPlacesV1Place + var s1 struct { + Rating gensupport.JSONFloat64 `json:"rating"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Rating = float64(s1.Rating) + return nil +} + +// GoogleMapsPlacesV1PlaceAddressComponent: The structured components +// that form the formatted address, if this information is available. +type GoogleMapsPlacesV1PlaceAddressComponent struct { + // LanguageCode: Output only. The language used to format this + // components, in CLDR notation. + LanguageCode string `json:"languageCode,omitempty"` + + // LongText: Output only. The full text description or name of the + // address component. For example, an address component for the country + // Australia may have a long_name of "Australia". + LongText string `json:"longText,omitempty"` + + // ShortText: Output only. An abbreviated textual name for the address + // component, if available. For example, an address component for the + // country of Australia may have a short_name of "AU". + ShortText string `json:"shortText,omitempty"` + + // Types: Output only. An array indicating the type(s) of the address + // component. + Types []string `json:"types,omitempty"` + + // ForceSendFields is a list of field names (e.g. "LanguageCode") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "LanguageCode") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleMapsPlacesV1PlaceAddressComponent) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1PlaceAddressComponent + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleMapsPlacesV1PlaceAttribution: Information about data providers +// of this place. +type GoogleMapsPlacesV1PlaceAttribution struct { + // Provider: Output only. Name of the Place's data provider. + Provider string `json:"provider,omitempty"` + + // ProviderUri: Output only. URI to the Place's data provider. + ProviderUri string `json:"providerUri,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Provider") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Provider") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleMapsPlacesV1PlaceAttribution) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1PlaceAttribution + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleMapsPlacesV1PlaceOpeningHours: Information about business hour +// of the place. +type GoogleMapsPlacesV1PlaceOpeningHours struct { + // OpenNow: Output only. Is this place open right now? Always present + // unless we lack time-of-day or timezone data for these opening hours. + OpenNow bool `json:"openNow,omitempty"` + + // Periods: Output only. The periods that this place is open during the + // week. The periods are in chronological order, starting with Sunday in + // the place-local timezone. An empty (but not absent) value indicates a + // place that is never open, e.g. because it is closed temporarily for + // renovations. + Periods []*GoogleMapsPlacesV1PlaceOpeningHoursPeriod `json:"periods,omitempty"` + + // SecondaryHoursType: Output only. A type string used to identify the + // type of secondary hours. + // + // Possible values: + // "SECONDARY_HOURS_TYPE_UNSPECIFIED" - Default value when secondary + // hour type is not specified. + // "DRIVE_THROUGH" - The drive-through hour for banks, restaurants, or + // pharmacies. + // "HAPPY_HOUR" - The happy hour. + // "DELIVERY" - The delivery hour. + // "TAKEOUT" - The takeout hour. + // "KITCHEN" - The kitchen hour. + // "BREAKFAST" - The breakfast hour. + // "LUNCH" - The lunch hour. + // "DINNER" - The dinner hour. + // "BRUNCH" - The brunch hour. + // "PICKUP" - The pickup hour. + // "ACCESS" - The access hours for storage places. + // "SENIOR_HOURS" - The special hours for seniors. + // "ONLINE_SERVICE_HOURS" - The online service hours. + SecondaryHoursType string `json:"secondaryHoursType,omitempty"` + + // SpecialDays: Output only. Structured information for special days + // that fall within the period that the returned opening hours cover. + // Special days are days that could impact the business hours of a + // place, e.g. Christmas day. Set for current_opening_hours and + // current_secondary_opening_hours if there are exceptional hours. + SpecialDays []*GoogleMapsPlacesV1PlaceOpeningHoursSpecialDay `json:"specialDays,omitempty"` + + // WeekdayDescriptions: Output only. Localized strings describing the + // opening hours of this place, one string for each day of the week. + // Will be empty if the hours are unknown or could not be converted to + // localized text. Example: "Sun: 18:00–06:00" + WeekdayDescriptions []string `json:"weekdayDescriptions,omitempty"` + + // ForceSendFields is a list of field names (e.g. "OpenNow") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "OpenNow") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleMapsPlacesV1PlaceOpeningHours) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1PlaceOpeningHours + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleMapsPlacesV1PlaceOpeningHoursPeriod: A period the place remains +// in open_now status. +type GoogleMapsPlacesV1PlaceOpeningHoursPeriod struct { + // Close: Output only. The time that the place starts to be closed. + Close *GoogleMapsPlacesV1PlaceOpeningHoursPeriodPoint `json:"close,omitempty"` + + // Open: Output only. The time that the place starts to be open. + Open *GoogleMapsPlacesV1PlaceOpeningHoursPeriodPoint `json:"open,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Close") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Close") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleMapsPlacesV1PlaceOpeningHoursPeriod) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1PlaceOpeningHoursPeriod + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleMapsPlacesV1PlaceOpeningHoursPeriodPoint: Status changing +// points. +type GoogleMapsPlacesV1PlaceOpeningHoursPeriodPoint struct { + // Date: Output only. Date in the local timezone for the place. + Date *GoogleTypeDate `json:"date,omitempty"` + + // DateDeprecated: Output only. Date of the endpoint expressed in + // RFC3339 format in the local timezone for the place. For example + // 2010-12-31. + DateDeprecated string `json:"dateDeprecated,omitempty"` + + // Day: Output only. A day of the week, as an integer in the range 0-6. + // 0 is Sunday, 1 is Monday, etc. + Day int64 `json:"day,omitempty"` + + // Hour: Output only. The hour in 2 digits. Ranges from 00 to 23. + Hour int64 `json:"hour,omitempty"` + + // Minute: Output only. The minute in 2 digits. Ranges from 00 to 59. + Minute int64 `json:"minute,omitempty"` + + // Truncated: Output only. Whether or not this endpoint was truncated. + // Truncation occurs when the real hours are outside the times we are + // willing to return hours between, so we truncate the hours back to + // these boundaries. This ensures that at most 24 * 7 hours from + // midnight of the day of the request are returned. + Truncated bool `json:"truncated,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Date") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Date") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleMapsPlacesV1PlaceOpeningHoursPeriodPoint) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1PlaceOpeningHoursPeriodPoint + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleMapsPlacesV1PlaceOpeningHoursSpecialDay: Structured information +// for special days that fall within the period that the returned +// opening hours cover. Special days are days that could impact the +// business hours of a place, e.g. Christmas day. +type GoogleMapsPlacesV1PlaceOpeningHoursSpecialDay struct { + // Date: Output only. The date of this special day. + Date *GoogleTypeDate `json:"date,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Date") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Date") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleMapsPlacesV1PlaceOpeningHoursSpecialDay) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1PlaceOpeningHoursSpecialDay + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleMapsPlacesV1PlacePlusCode: Plus code (http://plus.codes) is a +// location reference with two formats: global code defining a 14mx14m +// (1/8000th of a degree) or smaller rectangle, and compound code, +// replacing the prefix with a reference location. +type GoogleMapsPlacesV1PlacePlusCode struct { + // CompoundCode: Output only. Place's compound code, such as "33GV+HQ, + // Ramberg, Norway", containing the suffix of the global code and + // replacing the prefix with a formatted name of a reference entity. + CompoundCode string `json:"compoundCode,omitempty"` + + // GlobalCode: Output only. Place's global (full) code, such as + // "9FWM33GV+HQ", representing an 1/8000 by 1/8000 degree area (~14 by + // 14 meters). + GlobalCode string `json:"globalCode,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CompoundCode") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CompoundCode") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleMapsPlacesV1PlacePlusCode) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1PlacePlusCode + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleMapsPlacesV1PlaceReview: Information about a review of the +// place. +type GoogleMapsPlacesV1PlaceReview struct { + // AuthorAttribution: Output only. This review's author. + AuthorAttribution *GoogleMapsPlacesV1AuthorAttribution `json:"authorAttribution,omitempty"` + + // OriginalLanguageCode: Output only. A BCP-47 language code indicating + // the original language of the review. If the review has been + // translated, then original_language != language. This field contains + // the main language tag only, and not the secondary tag indicating + // country or region. For example, all the English reviews are tagged as + // 'en', and not 'en-AU' or 'en-UK' and so on.This field is empty if + // there is only a rating with no review text. + OriginalLanguageCode string `json:"originalLanguageCode,omitempty"` + + // OriginalText: Output only. The review text in its original language. + OriginalText *GoogleTypeLocalizedText `json:"originalText,omitempty"` + + // PublishTime: Output only. Timestamp for the review, expressed in + // seconds since epoch. + PublishTime string `json:"publishTime,omitempty"` + + // Rating: Output only. A whole number between 1.0 and 5.0, a.k.a. the + // number of stars. + Rating float64 `json:"rating,omitempty"` + + // RelativePublishTimeDescription: Output only. A string of formatted + // recent time, expressing the review time relative to the current time + // in a form appropriate for the language and country. + RelativePublishTimeDescription string `json:"relativePublishTimeDescription,omitempty"` + + // Text: Output only. The localized text of the review. + Text *GoogleTypeLocalizedText `json:"text,omitempty"` + + // Translated: Output only. A boolean value indicating if the review was + // translated from the original language it was written in. If a review + // has been translated, corresponding to a value of true, Google + // recommends that you indicate this to your users. For example, you can + // add the following string, “Translated by Google”, to the review. + Translated bool `json:"translated,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AuthorAttribution") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AuthorAttribution") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleMapsPlacesV1PlaceReview) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1PlaceReview + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +func (s *GoogleMapsPlacesV1PlaceReview) UnmarshalJSON(data []byte) error { + type NoMethod GoogleMapsPlacesV1PlaceReview + var s1 struct { + Rating gensupport.JSONFloat64 `json:"rating"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Rating = float64(s1.Rating) + return nil +} + +// GoogleMapsPlacesV1SearchTextRequest: Request proto for SearchText. +type GoogleMapsPlacesV1SearchTextRequest struct { + // IncludedType: The requested place type. Full list of types supported: + // https://developers.google.com/places/supported_types. Only support + // one included type. + IncludedType string `json:"includedType,omitempty"` + + // LanguageCode: Place details will be displayed with the preferred + // language if available. If the language code is unspecified or + // unrecognized, place details of any language may be returned, with a + // preference for English if such details exist. Current list of + // supported languages: + // https://developers.google.com/maps/faq#languagesupport. + LanguageCode string `json:"languageCode,omitempty"` + + // Location: [Deprecated!]The region to search. Setting location would + // usually yields better results. Recommended to set. This location + // serves as a bias unless strict_restriction is set to true, which + // turns the location to a strict restriction. + Location *GoogleMapsPlacesV1SearchTextRequestLocation `json:"location,omitempty"` + + // LocationBias: The region to search. This location serves as a bias + // which means results around given location might be returned. Cannot + // be set along with location_restriction. + LocationBias *GoogleMapsPlacesV1SearchTextRequestLocationBias `json:"locationBias,omitempty"` + + // LocationRestriction: The region to search. This location serves as a + // restriction which means results outside given location will not be + // returned. Cannot be set along with location_bias. + LocationRestriction *GoogleMapsPlacesV1SearchTextRequestLocationRestriction `json:"locationRestriction,omitempty"` + + // MaxResultCount: Maximum number of results to return. It must be + // between 1 and 20, inclusively. If the number is unset, it falls back + // to the upper limit. If the number is set to negative or exceeds the + // upper limit, an INVALID_ARGUMENT error is returned. + MaxResultCount int64 `json:"maxResultCount,omitempty"` + + // MinRating: Filter out results whose average user rating is strictly + // less than this limit. A valid value must be an float between 0 and 5 + // (inclusively) at a 0.5 cadence i.e. [0, 0.5, 1.0, ... , 5.0] + // inclusively. This is to keep parity with LocalRefinement_UserRating. + // The input rating will round up to the nearest 0.5(ceiling). For + // instance, a rating of 0.6 will eliminate all results with a less than + // 1.0 rating. + MinRating float64 `json:"minRating,omitempty"` + + // OpenNow: Used to restrict the search to places that are open at a + // specific time. open_now marks if a business is currently open. + OpenNow bool `json:"openNow,omitempty"` + + // PriceLevels: Used to restrict the search to places that are marked as + // certain price levels. Users can choose any combinations of price + // levels. Default to select all price levels. + // + // Possible values: + // "PRICE_LEVEL_UNSPECIFIED" - Place price level is unspecified or + // unknown. + // "PRICE_LEVEL_FREE" - Place provides free services. + // "PRICE_LEVEL_INEXPENSIVE" - Place provides inexpensive services. + // "PRICE_LEVEL_MODERATE" - Place provides moderately priced services. + // "PRICE_LEVEL_EXPENSIVE" - Place provides expensive services. + // "PRICE_LEVEL_VERY_EXPENSIVE" - Place provides very expensive + // services. + PriceLevels []string `json:"priceLevels,omitempty"` + + // PriceRange: [Deprecated!]Used to restrict the search to places that + // are within a certain price range. This is on a scale of 0 to 4. Set a + // minimum of 0 or set a maximum of 4 has no effect on the search + // results. Min price is default to 0 and max price is default to 4. + // Default value will be used if either min or max is unset. + PriceRange *GoogleMapsPlacesV1Int32Range `json:"priceRange,omitempty"` + + // RankPreference: How results will be ranked in the response. + // + // Possible values: + // "RANK_PREFERENCE_UNSPECIFIED" - RankPreference value not set. Will + // default to DISTANCE. + // "DISTANCE" - Ranks results by distance. + // "RELEVANCE" - Ranks results by relevance. Sort order determined by + // normal ranking stack. See SortRefinement::RELEVANCE. + RankPreference string `json:"rankPreference,omitempty"` + + // RegionCode: The Unicode country/region code (CLDR) of the location + // where the request is coming from. It is used to display the place + // details, like region-specific place name, if available. For more + // information, see + // http://www.unicode.org/reports/tr35/#unicode_region_subtag. Note that + // 3-digit region codes are not currently supported. + RegionCode string `json:"regionCode,omitempty"` + + // StrictTypeFiltering: Used to set strict type filtering for + // included_type. If set to true, only results of the same type will be + // returned. Default to false. + StrictTypeFiltering bool `json:"strictTypeFiltering,omitempty"` + + // TextQuery: Required. The text query for textual search. + TextQuery string `json:"textQuery,omitempty"` + + // ForceSendFields is a list of field names (e.g. "IncludedType") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "IncludedType") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleMapsPlacesV1SearchTextRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1SearchTextRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +func (s *GoogleMapsPlacesV1SearchTextRequest) UnmarshalJSON(data []byte) error { + type NoMethod GoogleMapsPlacesV1SearchTextRequest + var s1 struct { + MinRating gensupport.JSONFloat64 `json:"minRating"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.MinRating = float64(s1.MinRating) + return nil +} + +// GoogleMapsPlacesV1SearchTextRequestLocation: [Deprecated!]The region +// to search. +type GoogleMapsPlacesV1SearchTextRequestLocation struct { + // Rectangle: A rectangle box defined by northeast and southwest corner. + Rectangle *GoogleGeoTypeViewport `json:"rectangle,omitempty"` + + // StrictRestriction: Make location field a strict restriction and + // filter out POIs outside of the given location. If location type field + // is unset this field will have no effect. + StrictRestriction bool `json:"strictRestriction,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Rectangle") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Rectangle") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleMapsPlacesV1SearchTextRequestLocation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1SearchTextRequestLocation + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleMapsPlacesV1SearchTextRequestLocationBias: The region to +// search. This location serves as a bias which means results around +// given location might be returned. +type GoogleMapsPlacesV1SearchTextRequestLocationBias struct { + // Circle: A circle defined by center point and radius. + Circle *GoogleMapsPlacesV1Circle `json:"circle,omitempty"` + + // Rectangle: A rectangle box defined by northeast and southwest corner. + Rectangle *GoogleGeoTypeViewport `json:"rectangle,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Circle") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Circle") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleMapsPlacesV1SearchTextRequestLocationBias) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1SearchTextRequestLocationBias + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleMapsPlacesV1SearchTextRequestLocationRestriction: The region to +// search. This location serves as a restriction which means results +// outside given location will not be returned. +type GoogleMapsPlacesV1SearchTextRequestLocationRestriction struct { + // Rectangle: A rectangle box defined by northeast and southwest corner. + Rectangle *GoogleGeoTypeViewport `json:"rectangle,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Rectangle") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Rectangle") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleMapsPlacesV1SearchTextRequestLocationRestriction) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1SearchTextRequestLocationRestriction + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleMapsPlacesV1SearchTextResponse: Response proto for SearchText. +type GoogleMapsPlacesV1SearchTextResponse struct { + // Places: A list of places that meet the user's text search criteria. + Places []*GoogleMapsPlacesV1Place `json:"places,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Places") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Places") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleMapsPlacesV1SearchTextResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1SearchTextResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleTypeDate: Represents a whole or partial calendar date, such as +// a birthday. The time of day and time zone are either specified +// elsewhere or are insignificant. The date is relative to the Gregorian +// Calendar. This can represent one of the following: * A full date, +// with non-zero year, month, and day values. * A month and day, with a +// zero year (for example, an anniversary). * A year on its own, with a +// zero month and a zero day. * A year and month, with a zero day (for +// example, a credit card expiration date). Related types: * +// google.type.TimeOfDay * google.type.DateTime * +// google.protobuf.Timestamp +type GoogleTypeDate struct { + // Day: Day of a month. Must be from 1 to 31 and valid for the year and + // month, or 0 to specify a year by itself or a year and month where the + // day isn't significant. + Day int64 `json:"day,omitempty"` + + // Month: Month of a year. Must be from 1 to 12, or 0 to specify a year + // without a month and day. + Month int64 `json:"month,omitempty"` + + // Year: Year of the date. Must be from 1 to 9999, or 0 to specify a + // date without a year. + Year int64 `json:"year,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Day") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Day") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleTypeDate) MarshalJSON() ([]byte, error) { + type NoMethod GoogleTypeDate + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleTypeLatLng: An object that represents a latitude/longitude +// pair. This is expressed as a pair of doubles to represent degrees +// latitude and degrees longitude. Unless specified otherwise, this +// object must conform to the WGS84 standard. Values must be within +// normalized ranges. +type GoogleTypeLatLng struct { + // Latitude: The latitude in degrees. It must be in the range [-90.0, + // +90.0]. + Latitude float64 `json:"latitude,omitempty"` + + // Longitude: The longitude in degrees. It must be in the range [-180.0, + // +180.0]. + Longitude float64 `json:"longitude,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Latitude") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Latitude") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleTypeLatLng) MarshalJSON() ([]byte, error) { + type NoMethod GoogleTypeLatLng + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +func (s *GoogleTypeLatLng) UnmarshalJSON(data []byte) error { + type NoMethod GoogleTypeLatLng + var s1 struct { + Latitude gensupport.JSONFloat64 `json:"latitude"` + Longitude gensupport.JSONFloat64 `json:"longitude"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Latitude = float64(s1.Latitude) + s.Longitude = float64(s1.Longitude) + return nil +} + +// GoogleTypeLocalizedText: Localized variant of a text in a particular +// language. +type GoogleTypeLocalizedText struct { + // LanguageCode: The text's BCP-47 language code, such as "en-US" or + // "sr-Latn". For more information, see + // http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. + LanguageCode string `json:"languageCode,omitempty"` + + // Text: Localized string in the language corresponding to + // `language_code' below. + Text string `json:"text,omitempty"` + + // ForceSendFields is a list of field names (e.g. "LanguageCode") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "LanguageCode") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleTypeLocalizedText) MarshalJSON() ([]byte, error) { + type NoMethod GoogleTypeLocalizedText + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// method id "places.Text.search": + +type TextSearchCall struct { + s *Service + googlemapsplacesv1searchtextrequest *GoogleMapsPlacesV1SearchTextRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Search: Text query based place search. +func (r *TextService) Search(googlemapsplacesv1searchtextrequest *GoogleMapsPlacesV1SearchTextRequest) *TextSearchCall { + c := &TextSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.googlemapsplacesv1searchtextrequest = googlemapsplacesv1searchtextrequest + 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 *TextSearchCall) Fields(s ...googleapi.Field) *TextSearchCall { + 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 *TextSearchCall) Context(ctx context.Context) *TextSearchCall { + 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 *TextSearchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *TextSearchCall) 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.googlemapsplacesv1searchtextrequest) + 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/Text:search") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "places.Text.search" call. +// Exactly one of *GoogleMapsPlacesV1SearchTextResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *GoogleMapsPlacesV1SearchTextResponse.ServerResponse.Header or +// (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was +// returned. +func (c *TextSearchCall) Do(opts ...googleapi.CallOption) (*GoogleMapsPlacesV1SearchTextResponse, 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 := &GoogleMapsPlacesV1SearchTextResponse{ + 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": "Text query based place search.", + // "flatPath": "v1/Text:search", + // "httpMethod": "POST", + // "id": "places.Text.search", + // "parameterOrder": [], + // "parameters": {}, + // "path": "v1/Text:search", + // "request": { + // "$ref": "GoogleMapsPlacesV1SearchTextRequest" + // }, + // "response": { + // "$ref": "GoogleMapsPlacesV1SearchTextResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/maps-platform.places", + // "https://www.googleapis.com/auth/maps-platform.places.textsearch" + // ] + // } + +} + +// method id "places.places.searchText": + +type PlacesSearchTextCall struct { + s *Service + googlemapsplacesv1searchtextrequest *GoogleMapsPlacesV1SearchTextRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SearchText: Text query based place search. +func (r *PlacesService) SearchText(googlemapsplacesv1searchtextrequest *GoogleMapsPlacesV1SearchTextRequest) *PlacesSearchTextCall { + c := &PlacesSearchTextCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.googlemapsplacesv1searchtextrequest = googlemapsplacesv1searchtextrequest + 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 *PlacesSearchTextCall) Fields(s ...googleapi.Field) *PlacesSearchTextCall { + 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 *PlacesSearchTextCall) Context(ctx context.Context) *PlacesSearchTextCall { + 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 *PlacesSearchTextCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PlacesSearchTextCall) 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.googlemapsplacesv1searchtextrequest) + 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/places:searchText") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "places.places.searchText" call. +// Exactly one of *GoogleMapsPlacesV1SearchTextResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *GoogleMapsPlacesV1SearchTextResponse.ServerResponse.Header or +// (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was +// returned. +func (c *PlacesSearchTextCall) Do(opts ...googleapi.CallOption) (*GoogleMapsPlacesV1SearchTextResponse, 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 := &GoogleMapsPlacesV1SearchTextResponse{ + 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": "Text query based place search.", + // "flatPath": "v1/places:searchText", + // "httpMethod": "POST", + // "id": "places.places.searchText", + // "parameterOrder": [], + // "parameters": {}, + // "path": "v1/places:searchText", + // "request": { + // "$ref": "GoogleMapsPlacesV1SearchTextRequest" + // }, + // "response": { + // "$ref": "GoogleMapsPlacesV1SearchTextResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/maps-platform.places", + // "https://www.googleapis.com/auth/maps-platform.places.textsearch" + // ] + // } + +} diff --git a/pubsub/v1/pubsub-api.json b/pubsub/v1/pubsub-api.json index 615355588f8..016b92dd8b2 100644 --- a/pubsub/v1/pubsub-api.json +++ b/pubsub/v1/pubsub-api.json @@ -1566,7 +1566,7 @@ } } }, - "revision": "20230627", + "revision": "20230711", "rootUrl": "https://pubsub.googleapis.com/", "schemas": { "AcknowledgeRequest": { @@ -2100,6 +2100,7 @@ "type": "integer" }, "returnImmediately": { + "deprecated": true, "description": "Optional. If this field set to true, the system will respond immediately even if it there are no messages available to return in the `Pull` response. Otherwise, the system may wait (for a bounded amount of time) until at least one message is available, rather than returning no messages. Warning: setting this field to `true` is discouraged because it adversely impacts the performance of `Pull` operations. We recommend that users do not set this field.", "type": "boolean" } diff --git a/pubsub/v1beta1a/pubsub-api.json b/pubsub/v1beta1a/pubsub-api.json index 383155fcfe0..9870ee2da0c 100644 --- a/pubsub/v1beta1a/pubsub-api.json +++ b/pubsub/v1beta1a/pubsub-api.json @@ -457,7 +457,7 @@ } } }, - "revision": "20210809", + "revision": "20230711", "rootUrl": "https://pubsub.googleapis.com/", "schemas": { "AcknowledgeRequest": { @@ -550,6 +550,7 @@ "type": "integer" }, "ackId": { + "deprecated": true, "description": "The acknowledgment ID. Either this or ack_ids must be populated, not both.", "type": "string" }, diff --git a/pubsub/v1beta2/pubsub-api.json b/pubsub/v1beta2/pubsub-api.json index 2c65d318396..4d87f121f37 100644 --- a/pubsub/v1beta2/pubsub-api.json +++ b/pubsub/v1beta2/pubsub-api.json @@ -724,7 +724,7 @@ } } }, - "revision": "20230124", + "revision": "20230711", "rootUrl": "https://pubsub.googleapis.com/", "schemas": { "AcknowledgeRequest": { @@ -985,6 +985,7 @@ "type": "integer" }, "returnImmediately": { + "deprecated": true, "description": "Optional. If this is specified as true the system will respond immediately even if it is not able to return a message in the `Pull` response. Otherwise the system is allowed to wait until at least one message is available rather than returning no messages. The client may cancel the request if it does not wish to wait any longer for the response. Warning: setting this field to `true` is discouraged because it adversely impacts the performance of `Pull` operations. We recommend that users do not set this field.", "type": "boolean" } diff --git a/trafficdirector/v2/trafficdirector-api.json b/trafficdirector/v2/trafficdirector-api.json index 0bd0e9add41..2183641ffd7 100644 --- a/trafficdirector/v2/trafficdirector-api.json +++ b/trafficdirector/v2/trafficdirector-api.json @@ -128,7 +128,7 @@ } } }, - "revision": "20220723", + "revision": "20230711", "rootUrl": "https://trafficdirector.googleapis.com/", "schemas": { "Address": { @@ -431,6 +431,7 @@ "id": "GoogleRE2", "properties": { "maxProgramSize": { + "deprecated": true, "description": "This field controls the RE2 \"program size\" which is a rough estimate of how complex a compiled regex is to evaluate. A regex that has a program size greater than the configured value will fail to compile. In this case, the configured max program size can be increased or the regex can be simplified. If not specified, the default is 100. This field is deprecated; regexp validation should be performed on the management server instead of being done by each individual client.", "format": "uint32", "type": "integer" @@ -524,6 +525,7 @@ "id": "Node", "properties": { "buildVersion": { + "deprecated": true, "description": "This is motivated by informing a management server during canary which version of Envoy is being tested in a heterogeneous fleet. This will be set by Envoy in management server RPCs. This field is deprecated in favor of the user_agent_name and user_agent_version values.", "type": "string" }, @@ -859,6 +861,7 @@ "type": "string" }, "regex": { + "deprecated": true, "description": "The input string must match the regular expression specified here. The regex grammar is defined `here `_. Examples: * The regex ``\\d{3}`` matches the value *123* * The regex ``\\d{3}`` does not match the value *1234* * The regex ``\\d{3}`` does not match the value *123.456* .. attention:: This field has been deprecated in favor of `safe_regex` as it is not safe for use with untrusted input in all cases.", "type": "string" },