diff --git a/CHANGES.md b/CHANGES.md index c018c4edbed..08790c2575e 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -1,5 +1,16 @@ # Changes +## [0.133.0](https://github.com/googleapis/google-api-go-client/compare/v0.132.0...v0.133.0) (2023-07-24) + + +### Features + +* **all:** Auto-regenerate discovery clients ([#2077](https://github.com/googleapis/google-api-go-client/issues/2077)) ([d9bd05b](https://github.com/googleapis/google-api-go-client/commit/d9bd05beb8861c3c1b2ac8e7dd57afcfcf871644)) +* **all:** Auto-regenerate discovery clients ([#2079](https://github.com/googleapis/google-api-go-client/issues/2079)) ([b88678a](https://github.com/googleapis/google-api-go-client/commit/b88678afb55f875ad7673d049c8c0bb75affe116)) +* **all:** Auto-regenerate discovery clients ([#2080](https://github.com/googleapis/google-api-go-client/issues/2080)) ([3a5236c](https://github.com/googleapis/google-api-go-client/commit/3a5236c9a884daf059ba58f90e7a842b18eefc4e)) +* **all:** Auto-regenerate discovery clients ([#2081](https://github.com/googleapis/google-api-go-client/issues/2081)) ([94f3caf](https://github.com/googleapis/google-api-go-client/commit/94f3caf04025b4a169e6a307c54c20b8e388b956)) +* **all:** Auto-regenerate discovery clients ([#2082](https://github.com/googleapis/google-api-go-client/issues/2082)) ([0846d92](https://github.com/googleapis/google-api-go-client/commit/0846d9297408b2a37932a3b907bd57df5e7da79a)) + ## [0.132.0](https://github.com/googleapis/google-api-go-client/compare/v0.131.0...v0.132.0) (2023-07-18) diff --git a/analyticsadmin/v1alpha/analyticsadmin-api.json b/analyticsadmin/v1alpha/analyticsadmin-api.json index 0f4e663f255..66b989d1f59 100644 --- a/analyticsadmin/v1alpha/analyticsadmin-api.json +++ b/analyticsadmin/v1alpha/analyticsadmin-api.json @@ -3140,7 +3140,7 @@ "type": "string" }, "updateMask": { - "description": "The list of fields to be updated. Omitted fields will not be updated.", + "description": "Required. The list of fields to be updated. Omitted fields will not be updated.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -4322,7 +4322,7 @@ } } }, - "revision": "20230716", + "revision": "20230718", "rootUrl": "https://analyticsadmin.googleapis.com/", "schemas": { "GoogleAnalyticsAdminV1alphaAccessBetweenFilter": { diff --git a/analyticsadmin/v1alpha/analyticsadmin-gen.go b/analyticsadmin/v1alpha/analyticsadmin-gen.go index f333a6c1cb1..24498c0003f 100644 --- a/analyticsadmin/v1alpha/analyticsadmin-gen.go +++ b/analyticsadmin/v1alpha/analyticsadmin-gen.go @@ -23011,8 +23011,8 @@ func (r *PropertiesDataStreamsMeasurementProtocolSecretsService) Patch(name stri return c } -// UpdateMask sets the optional parameter "updateMask": The list of -// fields to be updated. Omitted fields will not be updated. +// UpdateMask sets the optional parameter "updateMask": Required. The +// list of fields to be updated. Omitted fields will not be updated. func (c *PropertiesDataStreamsMeasurementProtocolSecretsPatchCall) UpdateMask(updateMask string) *PropertiesDataStreamsMeasurementProtocolSecretsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -23127,7 +23127,7 @@ func (c *PropertiesDataStreamsMeasurementProtocolSecretsPatchCall) Do(opts ...go // "type": "string" // }, // "updateMask": { - // "description": "The list of fields to be updated. Omitted fields will not be updated.", + // "description": "Required. The list of fields to be updated. Omitted fields will not be updated.", // "format": "google-fieldmask", // "location": "query", // "type": "string" diff --git a/analyticsadmin/v1beta/analyticsadmin-api.json b/analyticsadmin/v1beta/analyticsadmin-api.json index 5ecd16e8a93..7e1a0294d06 100644 --- a/analyticsadmin/v1beta/analyticsadmin-api.json +++ b/analyticsadmin/v1beta/analyticsadmin-api.json @@ -1348,7 +1348,7 @@ "type": "string" }, "updateMask": { - "description": "The list of fields to be updated. Omitted fields will not be updated.", + "description": "Required. The list of fields to be updated. Omitted fields will not be updated.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1594,7 +1594,7 @@ } } }, - "revision": "20230704", + "revision": "20230718", "rootUrl": "https://analyticsadmin.googleapis.com/", "schemas": { "GoogleAnalyticsAdminV1betaAccessBetweenFilter": { diff --git a/analyticsadmin/v1beta/analyticsadmin-gen.go b/analyticsadmin/v1beta/analyticsadmin-gen.go index bbb8af6d0f4..75501ae7066 100644 --- a/analyticsadmin/v1beta/analyticsadmin-gen.go +++ b/analyticsadmin/v1beta/analyticsadmin-gen.go @@ -9476,8 +9476,8 @@ func (r *PropertiesDataStreamsMeasurementProtocolSecretsService) Patch(name stri return c } -// UpdateMask sets the optional parameter "updateMask": The list of -// fields to be updated. Omitted fields will not be updated. +// UpdateMask sets the optional parameter "updateMask": Required. The +// list of fields to be updated. Omitted fields will not be updated. func (c *PropertiesDataStreamsMeasurementProtocolSecretsPatchCall) UpdateMask(updateMask string) *PropertiesDataStreamsMeasurementProtocolSecretsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -9592,7 +9592,7 @@ func (c *PropertiesDataStreamsMeasurementProtocolSecretsPatchCall) Do(opts ...go // "type": "string" // }, // "updateMask": { - // "description": "The list of fields to be updated. Omitted fields will not be updated.", + // "description": "Required. The list of fields to be updated. Omitted fields will not be updated.", // "format": "google-fieldmask", // "location": "query", // "type": "string" diff --git a/androidpublisher/v3/androidpublisher-api.json b/androidpublisher/v3/androidpublisher-api.json index 7a07ad93ac2..e59a1087a7a 100644 --- a/androidpublisher/v3/androidpublisher-api.json +++ b/androidpublisher/v3/androidpublisher-api.json @@ -4047,7 +4047,7 @@ } } }, - "revision": "20230717", + "revision": "20230720", "rootUrl": "https://androidpublisher.googleapis.com/", "schemas": { "Abi": { @@ -6391,7 +6391,7 @@ "type": "string" }, "priceIncreaseType": { - "description": "Optional. The behavior the caller wants users to see if there is a price increase during migration. If left unset, the behavior defaults to PRICE_INCREASE_TYPE_OPT_IN.", + "description": "Optional. The behavior the caller wants users to see when there is a price increase during migration. If left unset, the behavior defaults to PRICE_INCREASE_TYPE_OPT_IN. Note that the first opt-out price increase migration for each app must be initiated in Play Console.", "enum": [ "PRICE_INCREASE_TYPE_UNSPECIFIED", "PRICE_INCREASE_TYPE_OPT_IN", diff --git a/androidpublisher/v3/androidpublisher-gen.go b/androidpublisher/v3/androidpublisher-gen.go index 304fe7fb7f1..950ba15b7df 100644 --- a/androidpublisher/v3/androidpublisher-gen.go +++ b/androidpublisher/v3/androidpublisher-gen.go @@ -4585,8 +4585,10 @@ type RegionalPriceMigrationConfig struct { OldestAllowedPriceVersionTime string `json:"oldestAllowedPriceVersionTime,omitempty"` // PriceIncreaseType: Optional. The behavior the caller wants users to - // see if there is a price increase during migration. If left unset, the - // behavior defaults to PRICE_INCREASE_TYPE_OPT_IN. + // see when there is a price increase during migration. If left unset, + // the behavior defaults to PRICE_INCREASE_TYPE_OPT_IN. Note that the + // first opt-out price increase migration for each app must be initiated + // in Play Console. // // Possible values: // "PRICE_INCREASE_TYPE_UNSPECIFIED" - Unspecified state. 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/artifactregistry/v1/artifactregistry-api.json b/artifactregistry/v1/artifactregistry-api.json index 058f90dae1f..44e37563e65 100644 --- a/artifactregistry/v1/artifactregistry-api.json +++ b/artifactregistry/v1/artifactregistry-api.json @@ -1301,7 +1301,7 @@ "type": "string" }, "parent": { - "description": "The name of the parent package whose tags will be listed. Example: \"projects/p1/locations/us-central1/repositories/repo1/packages/pkg1", + "description": "The name of the parent package whose tags will be listed. For example: `projects/p1/locations/us-central1/repositories/repo1/packages/pkg1`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/packages/[^/]+$", "required": true, @@ -1661,7 +1661,7 @@ } } }, - "revision": "20230710", + "revision": "20230719", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "AptArtifact": { diff --git a/artifactregistry/v1/artifactregistry-gen.go b/artifactregistry/v1/artifactregistry-gen.go index fd1bfb08fec..d8164db9dd2 100644 --- a/artifactregistry/v1/artifactregistry-gen.go +++ b/artifactregistry/v1/artifactregistry-gen.go @@ -9262,8 +9262,9 @@ type ProjectsLocationsRepositoriesPackagesTagsListCall struct { // List: Lists tags. // // - parent: The name of the parent package whose tags will be listed. -// Example: -// "projects/p1/locations/us-central1/repositories/repo1/packages/pkg1. +// For example: +// `projects/p1/locations/us-central1/repositories/repo1/packages/pkg1` +// . func (r *ProjectsLocationsRepositoriesPackagesTagsService) List(parent string) *ProjectsLocationsRepositoriesPackagesTagsListCall { c := &ProjectsLocationsRepositoriesPackagesTagsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9420,7 +9421,7 @@ func (c *ProjectsLocationsRepositoriesPackagesTagsListCall) Do(opts ...googleapi // "type": "string" // }, // "parent": { - // "description": "The name of the parent package whose tags will be listed. Example: \"projects/p1/locations/us-central1/repositories/repo1/packages/pkg1", + // "description": "The name of the parent package whose tags will be listed. For example: `projects/p1/locations/us-central1/repositories/repo1/packages/pkg1`.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/packages/[^/]+$", // "required": true, diff --git a/artifactregistry/v1beta1/artifactregistry-api.json b/artifactregistry/v1beta1/artifactregistry-api.json index 3fd090e7771..c5fe7e24615 100644 --- a/artifactregistry/v1beta1/artifactregistry-api.json +++ b/artifactregistry/v1beta1/artifactregistry-api.json @@ -736,7 +736,7 @@ "type": "string" }, "parent": { - "description": "The name of the parent package whose tags will be listed. Example: \"projects/p1/locations/us-central1/repositories/repo1/packages/pkg1", + "description": "The name of the parent package whose tags will be listed. For example: `projects/p1/locations/us-central1/repositories/repo1/packages/pkg1`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/packages/[^/]+$", "required": true, @@ -929,7 +929,7 @@ } } }, - "revision": "20230522", + "revision": "20230719", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "Binding": { diff --git a/artifactregistry/v1beta1/artifactregistry-gen.go b/artifactregistry/v1beta1/artifactregistry-gen.go index 9c1537ce693..08d0c6ddb3f 100644 --- a/artifactregistry/v1beta1/artifactregistry-gen.go +++ b/artifactregistry/v1beta1/artifactregistry-gen.go @@ -4315,8 +4315,9 @@ type ProjectsLocationsRepositoriesPackagesTagsListCall struct { // List: Lists tags. // // - parent: The name of the parent package whose tags will be listed. -// Example: -// "projects/p1/locations/us-central1/repositories/repo1/packages/pkg1. +// For example: +// `projects/p1/locations/us-central1/repositories/repo1/packages/pkg1` +// . func (r *ProjectsLocationsRepositoriesPackagesTagsService) List(parent string) *ProjectsLocationsRepositoriesPackagesTagsListCall { c := &ProjectsLocationsRepositoriesPackagesTagsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -4473,7 +4474,7 @@ func (c *ProjectsLocationsRepositoriesPackagesTagsListCall) Do(opts ...googleapi // "type": "string" // }, // "parent": { - // "description": "The name of the parent package whose tags will be listed. Example: \"projects/p1/locations/us-central1/repositories/repo1/packages/pkg1", + // "description": "The name of the parent package whose tags will be listed. For example: `projects/p1/locations/us-central1/repositories/repo1/packages/pkg1`.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/packages/[^/]+$", // "required": true, diff --git a/artifactregistry/v1beta2/artifactregistry-api.json b/artifactregistry/v1beta2/artifactregistry-api.json index 7e232cc3371..226508deab5 100644 --- a/artifactregistry/v1beta2/artifactregistry-api.json +++ b/artifactregistry/v1beta2/artifactregistry-api.json @@ -870,7 +870,7 @@ "type": "string" }, "parent": { - "description": "The name of the parent package whose tags will be listed. Example: \"projects/p1/locations/us-central1/repositories/repo1/packages/pkg1", + "description": "The name of the parent package whose tags will be listed. For example: `projects/p1/locations/us-central1/repositories/repo1/packages/pkg1`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/packages/[^/]+$", "required": true, @@ -1135,7 +1135,7 @@ } } }, - "revision": "20230710", + "revision": "20230719", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "AptArtifact": { diff --git a/artifactregistry/v1beta2/artifactregistry-gen.go b/artifactregistry/v1beta2/artifactregistry-gen.go index 323485143a5..5d08d8d6866 100644 --- a/artifactregistry/v1beta2/artifactregistry-gen.go +++ b/artifactregistry/v1beta2/artifactregistry-gen.go @@ -5627,8 +5627,9 @@ type ProjectsLocationsRepositoriesPackagesTagsListCall struct { // List: Lists tags. // // - parent: The name of the parent package whose tags will be listed. -// Example: -// "projects/p1/locations/us-central1/repositories/repo1/packages/pkg1. +// For example: +// `projects/p1/locations/us-central1/repositories/repo1/packages/pkg1` +// . func (r *ProjectsLocationsRepositoriesPackagesTagsService) List(parent string) *ProjectsLocationsRepositoriesPackagesTagsListCall { c := &ProjectsLocationsRepositoriesPackagesTagsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -5785,7 +5786,7 @@ func (c *ProjectsLocationsRepositoriesPackagesTagsListCall) Do(opts ...googleapi // "type": "string" // }, // "parent": { - // "description": "The name of the parent package whose tags will be listed. Example: \"projects/p1/locations/us-central1/repositories/repo1/packages/pkg1", + // "description": "The name of the parent package whose tags will be listed. For example: `projects/p1/locations/us-central1/repositories/repo1/packages/pkg1`.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/packages/[^/]+$", // "required": true, diff --git a/bigquerydatatransfer/v1/bigquerydatatransfer-api.json b/bigquerydatatransfer/v1/bigquerydatatransfer-api.json index 2db2852ae2c..3ffb6070d3c 100644 --- a/bigquerydatatransfer/v1/bigquerydatatransfer-api.json +++ b/bigquerydatatransfer/v1/bigquerydatatransfer-api.json @@ -1342,7 +1342,7 @@ } } }, - "revision": "20230701", + "revision": "20230715", "rootUrl": "https://bigquerydatatransfer.googleapis.com/", "schemas": { "CheckValidCredsRequest": { @@ -1554,7 +1554,8 @@ "DOUBLE", "BOOLEAN", "RECORD", - "PLUS_PAGE" + "PLUS_PAGE", + "LIST" ], "enumDescriptions": [ "Type unspecified.", @@ -1563,7 +1564,8 @@ "Double precision floating point parameter.", "Boolean parameter.", "Deprecated. This field has no effect.", - "Page ID for a Google+ Page." + "Page ID for a Google+ Page.", + "List of strings parameter." ], "type": "string" }, @@ -1801,13 +1803,13 @@ "id": "StartManualTransferRunsRequest", "properties": { "requestedRunTime": { - "description": "Specific run_time for a transfer run to be started. The requested_run_time must not be in the future.", + "description": "A run_time timestamp for historical data files or reports that are scheduled to be transferred by the scheduled transfer run. requested_run_time must be a past time and cannot include future time values.", "format": "google-datetime", "type": "string" }, "requestedTimeRange": { "$ref": "TimeRange", - "description": "Time range for the transfer runs that should be started." + "description": "A time_range start and end timestamp for historical data files or reports that are scheduled to be transferred by the scheduled transfer run. requested_time_range must be a past time and cannot include future time values." } }, "type": "object" diff --git a/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go b/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go index 3b9abee409e..79b66ce1a05 100644 --- a/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go +++ b/bigquerydatatransfer/v1/bigquerydatatransfer-gen.go @@ -490,6 +490,7 @@ type DataSourceParameter struct { // "BOOLEAN" - Boolean parameter. // "RECORD" - Deprecated. This field has no effect. // "PLUS_PAGE" - Page ID for a Google+ Page. + // "LIST" - List of strings parameter. Type string `json:"type,omitempty"` // ValidationDescription: Description of the requirements for this @@ -977,12 +978,16 @@ func (s *ScheduleTransferRunsResponse) MarshalJSON() ([]byte, error) { // StartManualTransferRunsRequest: A request to start manual transfer // runs. type StartManualTransferRunsRequest struct { - // RequestedRunTime: Specific run_time for a transfer run to be started. - // The requested_run_time must not be in the future. + // RequestedRunTime: A run_time timestamp for historical data files or + // reports that are scheduled to be transferred by the scheduled + // transfer run. requested_run_time must be a past time and cannot + // include future time values. RequestedRunTime string `json:"requestedRunTime,omitempty"` - // RequestedTimeRange: Time range for the transfer runs that should be - // started. + // RequestedTimeRange: A time_range start and end timestamp for + // historical data files or reports that are scheduled to be transferred + // by the scheduled transfer run. requested_time_range must be a past + // time and cannot include future time values. RequestedTimeRange *TimeRange `json:"requestedTimeRange,omitempty"` // ForceSendFields is a list of field names (e.g. "RequestedRunTime") to diff --git a/bigtableadmin/v2/bigtableadmin-api.json b/bigtableadmin/v2/bigtableadmin-api.json index e470c0d4f97..4a78b01530c 100644 --- a/bigtableadmin/v2/bigtableadmin-api.json +++ b/bigtableadmin/v2/bigtableadmin-api.json @@ -1877,108 +1877,6 @@ "https://www.googleapis.com/auth/cloud-platform" ] } - }, - "resources": { - "views": { - "methods": { - "getIamPolicy": { - "description": "Gets the access control policy for a Table resource. Returns an empty policy if the resource exists but does not have a policy set.", - "flatPath": "v2/projects/{projectsId}/instances/{instancesId}/tables/{tablesId}/views/{viewsId}:getIamPolicy", - "httpMethod": "POST", - "id": "bigtableadmin.projects.instances.tables.views.getIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^projects/[^/]+/instances/[^/]+/tables/[^/]+/views/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v2/{+resource}:getIamPolicy", - "request": { - "$ref": "GetIamPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/bigtable.admin", - "https://www.googleapis.com/auth/bigtable.admin.table", - "https://www.googleapis.com/auth/cloud-bigtable.admin", - "https://www.googleapis.com/auth/cloud-bigtable.admin.table", - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "setIamPolicy": { - "description": "Sets the access control policy on a Table resource. Replaces any existing policy.", - "flatPath": "v2/projects/{projectsId}/instances/{instancesId}/tables/{tablesId}/views/{viewsId}:setIamPolicy", - "httpMethod": "POST", - "id": "bigtableadmin.projects.instances.tables.views.setIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^projects/[^/]+/instances/[^/]+/tables/[^/]+/views/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v2/{+resource}:setIamPolicy", - "request": { - "$ref": "SetIamPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/bigtable.admin", - "https://www.googleapis.com/auth/bigtable.admin.table", - "https://www.googleapis.com/auth/cloud-bigtable.admin", - "https://www.googleapis.com/auth/cloud-bigtable.admin.table", - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "testIamPermissions": { - "description": "Returns permissions that the caller has on the specified table resource.", - "flatPath": "v2/projects/{projectsId}/instances/{instancesId}/tables/{tablesId}/views/{viewsId}:testIamPermissions", - "httpMethod": "POST", - "id": "bigtableadmin.projects.instances.tables.views.testIamPermissions", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^projects/[^/]+/instances/[^/]+/tables/[^/]+/views/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v2/{+resource}:testIamPermissions", - "request": { - "$ref": "TestIamPermissionsRequest" - }, - "response": { - "$ref": "TestIamPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/bigtable.admin", - "https://www.googleapis.com/auth/bigtable.admin.table", - "https://www.googleapis.com/auth/cloud-bigtable.admin", - "https://www.googleapis.com/auth/cloud-bigtable.admin.table", - "https://www.googleapis.com/auth/cloud-platform" - ] - } - } - } } } } @@ -2068,7 +1966,7 @@ } } }, - "revision": "20230622", + "revision": "20230713", "rootUrl": "https://bigtableadmin.googleapis.com/", "schemas": { "AppProfile": { @@ -2196,7 +2094,7 @@ "type": "string" }, "expireTime": { - "description": "Required. The expiration time of the backup, with microseconds granularity that must be at least 6 hours and at most 30 days from the time the request is received. Once the `expire_time` has passed, Cloud Bigtable will delete the backup and free the resources used by the backup.", + "description": "Required. The expiration time of the backup, with microseconds granularity that must be at least 6 hours and at most 90 days from the time the request is received. Once the `expire_time` has passed, Cloud Bigtable will delete the backup and free the resources used by the backup.", "format": "google-datetime", "type": "string" }, diff --git a/bigtableadmin/v2/bigtableadmin-gen.go b/bigtableadmin/v2/bigtableadmin-gen.go index 06c9bb2f3fe..3f5c0fbe823 100644 --- a/bigtableadmin/v2/bigtableadmin-gen.go +++ b/bigtableadmin/v2/bigtableadmin-gen.go @@ -288,23 +288,11 @@ type ProjectsInstancesClustersHotTabletsService struct { func NewProjectsInstancesTablesService(s *Service) *ProjectsInstancesTablesService { rs := &ProjectsInstancesTablesService{s: s} - rs.Views = NewProjectsInstancesTablesViewsService(s) return rs } type ProjectsInstancesTablesService struct { s *Service - - Views *ProjectsInstancesTablesViewsService -} - -func NewProjectsInstancesTablesViewsService(s *Service) *ProjectsInstancesTablesViewsService { - rs := &ProjectsInstancesTablesViewsService{s: s} - return rs -} - -type ProjectsInstancesTablesViewsService struct { - s *Service } func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { @@ -553,7 +541,7 @@ type Backup struct { EndTime string `json:"endTime,omitempty"` // ExpireTime: Required. The expiration time of the backup, with - // microseconds granularity that must be at least 6 hours and at most 30 + // microseconds granularity that must be at least 6 hours and at most 90 // days from the time the request is received. Once the `expire_time` // has passed, Cloud Bigtable will delete the backup and free the // resources used by the backup. @@ -11481,457 +11469,6 @@ func (c *ProjectsInstancesTablesUndeleteCall) Do(opts ...googleapi.CallOption) ( } -// method id "bigtableadmin.projects.instances.tables.views.getIamPolicy": - -type ProjectsInstancesTablesViewsGetIamPolicyCall struct { - s *Service - resource string - getiampolicyrequest *GetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// GetIamPolicy: Gets the access control policy for a Table resource. -// Returns an empty policy if the resource exists but does not have a -// policy set. -// -// - resource: REQUIRED: The resource for which the policy is being -// requested. See Resource names -// (https://cloud.google.com/apis/design/resource_names) for the -// appropriate value for this field. -func (r *ProjectsInstancesTablesViewsService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsInstancesTablesViewsGetIamPolicyCall { - c := &ProjectsInstancesTablesViewsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.getiampolicyrequest = getiampolicyrequest - 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 *ProjectsInstancesTablesViewsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsInstancesTablesViewsGetIamPolicyCall { - 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 *ProjectsInstancesTablesViewsGetIamPolicyCall) Context(ctx context.Context) *ProjectsInstancesTablesViewsGetIamPolicyCall { - 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 *ProjectsInstancesTablesViewsGetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsInstancesTablesViewsGetIamPolicyCall) 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.getiampolicyrequest) - 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, "v2/{+resource}:getIamPolicy") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "bigtableadmin.projects.instances.tables.views.getIamPolicy" call. -// Exactly one of *Policy or error will be non-nil. Any non-2xx status -// code is an error. Response headers are in either -// *Policy.ServerResponse.Header or (if a response was returned at all) -// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified -// was returned. -func (c *ProjectsInstancesTablesViewsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - if err := gensupport.DecodeResponse(target, res); err != nil { - return nil, err - } - return ret, nil - // { - // "description": "Gets the access control policy for a Table resource. Returns an empty policy if the resource exists but does not have a policy set.", - // "flatPath": "v2/projects/{projectsId}/instances/{instancesId}/tables/{tablesId}/views/{viewsId}:getIamPolicy", - // "httpMethod": "POST", - // "id": "bigtableadmin.projects.instances.tables.views.getIamPolicy", - // "parameterOrder": [ - // "resource" - // ], - // "parameters": { - // "resource": { - // "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - // "location": "path", - // "pattern": "^projects/[^/]+/instances/[^/]+/tables/[^/]+/views/[^/]+$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v2/{+resource}:getIamPolicy", - // "request": { - // "$ref": "GetIamPolicyRequest" - // }, - // "response": { - // "$ref": "Policy" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/bigtable.admin", - // "https://www.googleapis.com/auth/bigtable.admin.table", - // "https://www.googleapis.com/auth/cloud-bigtable.admin", - // "https://www.googleapis.com/auth/cloud-bigtable.admin.table", - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - -// method id "bigtableadmin.projects.instances.tables.views.setIamPolicy": - -type ProjectsInstancesTablesViewsSetIamPolicyCall struct { - s *Service - resource string - setiampolicyrequest *SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// SetIamPolicy: Sets the access control policy on a Table resource. -// Replaces any existing policy. -// -// - resource: REQUIRED: The resource for which the policy is being -// specified. See Resource names -// (https://cloud.google.com/apis/design/resource_names) for the -// appropriate value for this field. -func (r *ProjectsInstancesTablesViewsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsInstancesTablesViewsSetIamPolicyCall { - c := &ProjectsInstancesTablesViewsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.setiampolicyrequest = setiampolicyrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse -// for more information. -func (c *ProjectsInstancesTablesViewsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsInstancesTablesViewsSetIamPolicyCall { - 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 *ProjectsInstancesTablesViewsSetIamPolicyCall) Context(ctx context.Context) *ProjectsInstancesTablesViewsSetIamPolicyCall { - 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 *ProjectsInstancesTablesViewsSetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsInstancesTablesViewsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) - for k, v := range c.header_ { - reqHeaders[k] = v - } - reqHeaders.Set("User-Agent", c.s.userAgent()) - var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.setiampolicyrequest) - if err != nil { - return nil, err - } - reqHeaders.Set("Content-Type", "application/json") - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+resource}:setIamPolicy") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "bigtableadmin.projects.instances.tables.views.setIamPolicy" call. -// Exactly one of *Policy or error will be non-nil. Any non-2xx status -// code is an error. Response headers are in either -// *Policy.ServerResponse.Header or (if a response was returned at all) -// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified -// was returned. -func (c *ProjectsInstancesTablesViewsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - if err := gensupport.DecodeResponse(target, res); err != nil { - return nil, err - } - return ret, nil - // { - // "description": "Sets the access control policy on a Table resource. Replaces any existing policy.", - // "flatPath": "v2/projects/{projectsId}/instances/{instancesId}/tables/{tablesId}/views/{viewsId}:setIamPolicy", - // "httpMethod": "POST", - // "id": "bigtableadmin.projects.instances.tables.views.setIamPolicy", - // "parameterOrder": [ - // "resource" - // ], - // "parameters": { - // "resource": { - // "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - // "location": "path", - // "pattern": "^projects/[^/]+/instances/[^/]+/tables/[^/]+/views/[^/]+$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v2/{+resource}:setIamPolicy", - // "request": { - // "$ref": "SetIamPolicyRequest" - // }, - // "response": { - // "$ref": "Policy" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/bigtable.admin", - // "https://www.googleapis.com/auth/bigtable.admin.table", - // "https://www.googleapis.com/auth/cloud-bigtable.admin", - // "https://www.googleapis.com/auth/cloud-bigtable.admin.table", - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - -// method id "bigtableadmin.projects.instances.tables.views.testIamPermissions": - -type ProjectsInstancesTablesViewsTestIamPermissionsCall struct { - s *Service - resource string - testiampermissionsrequest *TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// TestIamPermissions: Returns permissions that the caller has on the -// specified table resource. -// -// - resource: REQUIRED: The resource for which the policy detail is -// being requested. See Resource names -// (https://cloud.google.com/apis/design/resource_names) for the -// appropriate value for this field. -func (r *ProjectsInstancesTablesViewsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsInstancesTablesViewsTestIamPermissionsCall { - c := &ProjectsInstancesTablesViewsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.testiampermissionsrequest = testiampermissionsrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse -// for more information. -func (c *ProjectsInstancesTablesViewsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsInstancesTablesViewsTestIamPermissionsCall { - 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 *ProjectsInstancesTablesViewsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsInstancesTablesViewsTestIamPermissionsCall { - 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 *ProjectsInstancesTablesViewsTestIamPermissionsCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsInstancesTablesViewsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) - for k, v := range c.header_ { - reqHeaders[k] = v - } - reqHeaders.Set("User-Agent", c.s.userAgent()) - var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.testiampermissionsrequest) - if err != nil { - return nil, err - } - reqHeaders.Set("Content-Type", "application/json") - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+resource}:testIamPermissions") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "bigtableadmin.projects.instances.tables.views.testIamPermissions" call. -// Exactly one of *TestIamPermissionsResponse or error will be non-nil. -// Any non-2xx status code is an error. Response headers are in either -// *TestIamPermissionsResponse.ServerResponse.Header or (if a response -// was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was -// because http.StatusNotModified was returned. -func (c *ProjectsInstancesTablesViewsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &TestIamPermissionsResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - if err := gensupport.DecodeResponse(target, res); err != nil { - return nil, err - } - return ret, nil - // { - // "description": "Returns permissions that the caller has on the specified table resource.", - // "flatPath": "v2/projects/{projectsId}/instances/{instancesId}/tables/{tablesId}/views/{viewsId}:testIamPermissions", - // "httpMethod": "POST", - // "id": "bigtableadmin.projects.instances.tables.views.testIamPermissions", - // "parameterOrder": [ - // "resource" - // ], - // "parameters": { - // "resource": { - // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - // "location": "path", - // "pattern": "^projects/[^/]+/instances/[^/]+/tables/[^/]+/views/[^/]+$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v2/{+resource}:testIamPermissions", - // "request": { - // "$ref": "TestIamPermissionsRequest" - // }, - // "response": { - // "$ref": "TestIamPermissionsResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/bigtable.admin", - // "https://www.googleapis.com/auth/bigtable.admin.table", - // "https://www.googleapis.com/auth/cloud-bigtable.admin", - // "https://www.googleapis.com/auth/cloud-bigtable.admin.table", - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - // method id "bigtableadmin.projects.locations.get": type ProjectsLocationsGetCall struct { diff --git a/calendar/v3/calendar-api.json b/calendar/v3/calendar-api.json index 0c084378a4b..f9e3a33a230 100644 --- a/calendar/v3/calendar-api.json +++ b/calendar/v3/calendar-api.json @@ -1164,7 +1164,7 @@ "type": "boolean" }, "syncToken": { - "description": "Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of this list request contain only entries that have changed since then. All events deleted since the previous list request will always be in the result set and it is not allowed to set showDeleted to False.\nThere are several query parameters that cannot be specified together with nextSyncToken to ensure consistency of the client state.\n\nThese are: \n- iCalUID \n- orderBy \n- privateExtendedProperty \n- q \n- sharedExtendedProperty \n- timeMin \n- timeMax \n- updatedMin If the syncToken expires, the server will respond with a 410 GONE response code and the client should clear its storage and perform a full synchronization without any syncToken.\nLearn more about incremental synchronization.\nOptional. The default is to return all entries.", + "description": "Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of this list request contain only entries that have changed since then. All events deleted since the previous list request will always be in the result set and it is not allowed to set showDeleted to False.\nThere are several query parameters that cannot be specified together with nextSyncToken to ensure consistency of the client state.\n\nThese are: \n- iCalUID \n- orderBy \n- privateExtendedProperty \n- q \n- sharedExtendedProperty \n- timeMin \n- timeMax \n- updatedMin All other query parameters should be the same as for the initial synchronization to avoid undefined behavior. If the syncToken expires, the server will respond with a 410 GONE response code and the client should clear its storage and perform a full synchronization without any syncToken.\nLearn more about incremental synchronization.\nOptional. The default is to return all entries.", "location": "query", "type": "string" }, @@ -1567,7 +1567,7 @@ "type": "boolean" }, "syncToken": { - "description": "Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of this list request contain only entries that have changed since then. All events deleted since the previous list request will always be in the result set and it is not allowed to set showDeleted to False.\nThere are several query parameters that cannot be specified together with nextSyncToken to ensure consistency of the client state.\n\nThese are: \n- iCalUID \n- orderBy \n- privateExtendedProperty \n- q \n- sharedExtendedProperty \n- timeMin \n- timeMax \n- updatedMin If the syncToken expires, the server will respond with a 410 GONE response code and the client should clear its storage and perform a full synchronization without any syncToken.\nLearn more about incremental synchronization.\nOptional. The default is to return all entries.", + "description": "Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of this list request contain only entries that have changed since then. All events deleted since the previous list request will always be in the result set and it is not allowed to set showDeleted to False.\nThere are several query parameters that cannot be specified together with nextSyncToken to ensure consistency of the client state.\n\nThese are: \n- iCalUID \n- orderBy \n- privateExtendedProperty \n- q \n- sharedExtendedProperty \n- timeMin \n- timeMax \n- updatedMin All other query parameters should be the same as for the initial synchronization to avoid undefined behavior. If the syncToken expires, the server will respond with a 410 GONE response code and the client should clear its storage and perform a full synchronization without any syncToken.\nLearn more about incremental synchronization.\nOptional. The default is to return all entries.", "location": "query", "type": "string" }, @@ -1735,7 +1735,7 @@ } } }, - "revision": "20230623", + "revision": "20230714", "rootUrl": "https://www.googleapis.com/", "schemas": { "Acl": { diff --git a/calendar/v3/calendar-gen.go b/calendar/v3/calendar-gen.go index 65d413c097a..b3bc355b648 100644 --- a/calendar/v3/calendar-gen.go +++ b/calendar/v3/calendar-gen.go @@ -7219,9 +7219,11 @@ func (c *EventsListCall) SingleEvents(singleEvents bool) *EventsListCall { // - sharedExtendedProperty // - timeMin // - timeMax -// - updatedMin If the syncToken expires, the server will respond with a -// 410 GONE response code and the client should clear its storage and -// perform a full synchronization without any syncToken. +// - updatedMin All other query parameters should be the same as for the +// initial synchronization to avoid undefined behavior. If the syncToken +// expires, the server will respond with a 410 GONE response code and +// the client should clear its storage and perform a full +// synchronization without any syncToken. // Learn more about incremental synchronization. // // The default is to return all entries. @@ -7463,7 +7465,7 @@ func (c *EventsListCall) Do(opts ...googleapi.CallOption) (*Events, error) { // "type": "boolean" // }, // "syncToken": { - // "description": "Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of this list request contain only entries that have changed since then. All events deleted since the previous list request will always be in the result set and it is not allowed to set showDeleted to False.\nThere are several query parameters that cannot be specified together with nextSyncToken to ensure consistency of the client state.\n\nThese are: \n- iCalUID \n- orderBy \n- privateExtendedProperty \n- q \n- sharedExtendedProperty \n- timeMin \n- timeMax \n- updatedMin If the syncToken expires, the server will respond with a 410 GONE response code and the client should clear its storage and perform a full synchronization without any syncToken.\nLearn more about incremental synchronization.\nOptional. The default is to return all entries.", + // "description": "Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of this list request contain only entries that have changed since then. All events deleted since the previous list request will always be in the result set and it is not allowed to set showDeleted to False.\nThere are several query parameters that cannot be specified together with nextSyncToken to ensure consistency of the client state.\n\nThese are: \n- iCalUID \n- orderBy \n- privateExtendedProperty \n- q \n- sharedExtendedProperty \n- timeMin \n- timeMax \n- updatedMin All other query parameters should be the same as for the initial synchronization to avoid undefined behavior. If the syncToken expires, the server will respond with a 410 GONE response code and the client should clear its storage and perform a full synchronization without any syncToken.\nLearn more about incremental synchronization.\nOptional. The default is to return all entries.", // "location": "query", // "type": "string" // }, @@ -8643,9 +8645,11 @@ func (c *EventsWatchCall) SingleEvents(singleEvents bool) *EventsWatchCall { // - sharedExtendedProperty // - timeMin // - timeMax -// - updatedMin If the syncToken expires, the server will respond with a -// 410 GONE response code and the client should clear its storage and -// perform a full synchronization without any syncToken. +// - updatedMin All other query parameters should be the same as for the +// initial synchronization to avoid undefined behavior. If the syncToken +// expires, the server will respond with a 410 GONE response code and +// the client should clear its storage and perform a full +// synchronization without any syncToken. // Learn more about incremental synchronization. // // The default is to return all entries. @@ -8879,7 +8883,7 @@ func (c *EventsWatchCall) Do(opts ...googleapi.CallOption) (*Channel, error) { // "type": "boolean" // }, // "syncToken": { - // "description": "Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of this list request contain only entries that have changed since then. All events deleted since the previous list request will always be in the result set and it is not allowed to set showDeleted to False.\nThere are several query parameters that cannot be specified together with nextSyncToken to ensure consistency of the client state.\n\nThese are: \n- iCalUID \n- orderBy \n- privateExtendedProperty \n- q \n- sharedExtendedProperty \n- timeMin \n- timeMax \n- updatedMin If the syncToken expires, the server will respond with a 410 GONE response code and the client should clear its storage and perform a full synchronization without any syncToken.\nLearn more about incremental synchronization.\nOptional. The default is to return all entries.", + // "description": "Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of this list request contain only entries that have changed since then. All events deleted since the previous list request will always be in the result set and it is not allowed to set showDeleted to False.\nThere are several query parameters that cannot be specified together with nextSyncToken to ensure consistency of the client state.\n\nThese are: \n- iCalUID \n- orderBy \n- privateExtendedProperty \n- q \n- sharedExtendedProperty \n- timeMin \n- timeMax \n- updatedMin All other query parameters should be the same as for the initial synchronization to avoid undefined behavior. If the syncToken expires, the server will respond with a 410 GONE response code and the client should clear its storage and perform a full synchronization without any syncToken.\nLearn more about incremental synchronization.\nOptional. The default is to return all entries.", // "location": "query", // "type": "string" // }, diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index 5e701abf5e1..1cfa008be6d 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -519,13 +519,13 @@ "type": "string" }, "pageSize": { - "description": "The maximum number of memberships to return. The service might return fewer than this value. If unspecified, at most 100 memberships are returned. The maximum value is 1,000. If you use a value more than 1,000, it's automatically changed to 1,000. Negative values return an `INVALID_ARGUMENT` error.", + "description": "Optional. The maximum number of memberships to return. The service might return fewer than this value. If unspecified, at most 100 memberships are returned. The maximum value is 1,000. If you use a value more than 1,000, it's automatically changed to 1,000. Negative values return an `INVALID_ARGUMENT` error.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "A page token, received from a previous call to list memberships. Provide this parameter to retrieve the subsequent page. When paginating, all other parameters provided should match the call that provided the page token. Passing different values to the other parameters might lead to unexpected results.", + "description": "Optional. A page token, received from a previous call to list memberships. Provide this parameter to retrieve the subsequent page. When paginating, all other parameters provided should match the call that provided the page token. Passing different values to the other parameters might lead to unexpected results.", "location": "query", "type": "string" }, @@ -954,7 +954,7 @@ } } }, - "revision": "20230711", + "revision": "20230718", "rootUrl": "https://chat.googleapis.com/", "schemas": { "ActionParameter": { diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index de184635034..3bde0e2fcb5 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -7351,13 +7351,13 @@ func (c *SpacesMembersListCall) Do(opts ...googleapi.CallOption) (*ListMembershi // "type": "string" // }, // "pageSize": { - // "description": "The maximum number of memberships to return. The service might return fewer than this value. If unspecified, at most 100 memberships are returned. The maximum value is 1,000. If you use a value more than 1,000, it's automatically changed to 1,000. Negative values return an `INVALID_ARGUMENT` error.", + // "description": "Optional. The maximum number of memberships to return. The service might return fewer than this value. If unspecified, at most 100 memberships are returned. The maximum value is 1,000. If you use a value more than 1,000, it's automatically changed to 1,000. Negative values return an `INVALID_ARGUMENT` error.", // "format": "int32", // "location": "query", // "type": "integer" // }, // "pageToken": { - // "description": "A page token, received from a previous call to list memberships. Provide this parameter to retrieve the subsequent page. When paginating, all other parameters provided should match the call that provided the page token. Passing different values to the other parameters might lead to unexpected results.", + // "description": "Optional. A page token, received from a previous call to list memberships. Provide this parameter to retrieve the subsequent page. When paginating, all other parameters provided should match the call that provided the page token. Passing different values to the other parameters might lead to unexpected results.", // "location": "query", // "type": "string" // }, diff --git a/checks/v1alpha/checks-api.json b/checks/v1alpha/checks-api.json index bcbb4a49289..2aff3d33c9f 100644 --- a/checks/v1alpha/checks-api.json +++ b/checks/v1alpha/checks-api.json @@ -111,6 +111,59 @@ "resources": { "operations": { "methods": { + "cancel": { + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "flatPath": "v1alpha/accounts/{accountsId}/apps/{appsId}/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "checks.accounts.apps.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^accounts/[^/]+/apps/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}:cancel", + "request": { + "$ref": "CancelOperationRequest" + }, + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/xapi.zoo" + ] + }, + "delete": { + "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", + "flatPath": "v1alpha/accounts/{accountsId}/apps/{appsId}/operations/{operationsId}", + "httpMethod": "DELETE", + "id": "checks.accounts.apps.operations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be deleted.", + "location": "path", + "pattern": "^accounts/[^/]+/apps/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/xapi.zoo" + ] + }, "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/accounts/{accountsId}/apps/{appsId}/operations/{operationsId}", @@ -135,6 +188,75 @@ "scopes": [ "https://www.googleapis.com/auth/xapi.zoo" ] + }, + "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/accounts/{accountsId}/apps/{appsId}/operations", + "httpMethod": "GET", + "id": "checks.accounts.apps.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": "^accounts/[^/]+/apps/[^/]+$", + "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": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/xapi.zoo" + ] + }, + "wait": { + "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", + "flatPath": "v1alpha/accounts/{accountsId}/apps/{appsId}/operations/{operationsId}:wait", + "httpMethod": "POST", + "id": "checks.accounts.apps.operations.wait", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to wait on.", + "location": "path", + "pattern": "^accounts/[^/]+/apps/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}:wait", + "request": { + "$ref": "WaitOperationRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/xapi.zoo" + ] } } } @@ -163,10 +285,108 @@ }, "projects": { "resources": { + "privacyPolicies": { + "methods": { + "delete": { + "description": "Deletes a privacy policy.", + "flatPath": "v1alpha/projects/{projectsId}/privacyPolicies/{privacyPoliciesId}", + "httpMethod": "DELETE", + "id": "checks.projects.privacyPolicies.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Resource name of the privacy policy.", + "location": "path", + "pattern": "^projects/[^/]+/privacyPolicies/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "Empty" + } + }, + "get": { + "description": "Gets a privacy policy.", + "flatPath": "v1alpha/projects/{projectsId}/privacyPolicies/{privacyPoliciesId}", + "httpMethod": "GET", + "id": "checks.projects.privacyPolicies.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Resource name of the privacy policy.", + "location": "path", + "pattern": "^projects/[^/]+/privacyPolicies/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "PrivacyPolicy" + } + } + } + }, "privacypolicy": { "resources": { "operations": { "methods": { + "cancel": { + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "flatPath": "v1alpha/projects/{projectsId}/privacypolicy/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "checks.projects.privacypolicy.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^projects/[^/]+/privacypolicy/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}:cancel", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/xapi.zoo" + ] + }, + "delete": { + "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", + "flatPath": "v1alpha/projects/{projectsId}/privacypolicy/operations/{operationsId}", + "httpMethod": "DELETE", + "id": "checks.projects.privacypolicy.operations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be deleted.", + "location": "path", + "pattern": "^projects/[^/]+/privacypolicy/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/xapi.zoo" + ] + }, "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}/privacypolicy/operations/{operationsId}", @@ -191,6 +411,78 @@ "scopes": [ "https://www.googleapis.com/auth/xapi.zoo" ] + }, + "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}/privacypolicy/operations", + "httpMethod": "GET", + "id": "checks.projects.privacypolicy.operations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "The standard list filter.", + "location": "query", + "type": "string" + }, + "name": { + "description": "The name of the operation's parent resource.", + "location": "path", + "pattern": "^projects/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+name}/privacypolicy/operations", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/xapi.zoo" + ] + }, + "wait": { + "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", + "flatPath": "v1alpha/projects/{projectsId}/privacypolicy/operations/{operationsId}:wait", + "httpMethod": "POST", + "id": "checks.projects.privacypolicy.operations.wait", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to wait on.", + "location": "path", + "pattern": "^projects/[^/]+/privacypolicy/operations/[^/]+$", + "required": true, + "type": "string" + }, + "timeout": { + "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", + "format": "google-duration", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+name}:wait", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/xapi.zoo" + ] } } } @@ -199,7 +491,7 @@ } } }, - "revision": "20230716", + "revision": "20230720", "rootUrl": "https://checks.googleapis.com/", "schemas": { "AnalyzePrivacyPolicyRequest": { @@ -253,6 +545,12 @@ }, "type": "object" }, + "CancelOperationRequest": { + "description": "The request message for Operations.CancelOperation.", + "id": "CancelOperationRequest", + "properties": {}, + "type": "object" + }, "Date": { "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": "Date", @@ -275,6 +573,12 @@ }, "type": "object" }, + "Empty": { + "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", + "id": "Empty", + "properties": {}, + "type": "object" + }, "LastUpdatedDate": { "description": "Information about the date when the privacy policy was last updated.", "id": "LastUpdatedDate", @@ -300,6 +604,24 @@ }, "type": "object" }, + "ListOperationsResponse": { + "description": "The response message for Operations.ListOperations.", + "id": "ListOperationsResponse", + "properties": { + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + }, + "operations": { + "description": "A list of operations that matches the specified filter in the request.", + "items": { + "$ref": "Operation" + }, + "type": "array" + } + }, + "type": "object" + }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -632,6 +954,34 @@ }, "type": "object" }, + "PrivacyPolicy": { + "description": "Privacy policy.", + "id": "PrivacyPolicy", + "properties": { + "htmlContent": { + "description": "HTML content for the privacy policy page.", + "type": "string" + }, + "name": { + "description": "Resource name. Example: projects/123/privacyPolicies/456", + "type": "string" + }, + "privacyPolicyUri": { + "description": "URI of the privacy policy corresponding to this resource.", + "type": "string" + }, + "score": { + "description": "Confidence that the privacy policy URI is indeed from a privacy policy.", + "format": "float", + "type": "number" + }, + "websiteUri": { + "description": "URI of the original website used to find this privacy policy. Only populated for resources created by the FindPrivacyPolicy API.", + "type": "string" + } + }, + "type": "object" + }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", @@ -658,6 +1008,18 @@ } }, "type": "object" + }, + "WaitOperationRequest": { + "description": "The request message for Operations.WaitOperation.", + "id": "WaitOperationRequest", + "properties": { + "timeout": { + "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", + "format": "google-duration", + "type": "string" + } + }, + "type": "object" } }, "servicePath": "", diff --git a/checks/v1alpha/checks-gen.go b/checks/v1alpha/checks-gen.go index 81db8c69569..98a8406831b 100644 --- a/checks/v1alpha/checks-gen.go +++ b/checks/v1alpha/checks-gen.go @@ -187,6 +187,7 @@ type PrivacypolicyService struct { func NewProjectsService(s *Service) *ProjectsService { rs := &ProjectsService{s: s} + rs.PrivacyPolicies = NewProjectsPrivacyPoliciesService(s) rs.Privacypolicy = NewProjectsPrivacypolicyService(s) return rs } @@ -194,9 +195,20 @@ func NewProjectsService(s *Service) *ProjectsService { type ProjectsService struct { s *Service + PrivacyPolicies *ProjectsPrivacyPoliciesService + Privacypolicy *ProjectsPrivacypolicyService } +func NewProjectsPrivacyPoliciesService(s *Service) *ProjectsPrivacyPoliciesService { + rs := &ProjectsPrivacyPoliciesService{s: s} + return rs +} + +type ProjectsPrivacyPoliciesService struct { + s *Service +} + func NewProjectsPrivacypolicyService(s *Service) *ProjectsPrivacypolicyService { rs := &ProjectsPrivacypolicyService{s: s} rs.Operations = NewProjectsPrivacypolicyOperationsService(s) @@ -304,6 +316,11 @@ func (s *AnalyzePrivacyPolicyResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// CancelOperationRequest: The request message for +// Operations.CancelOperation. +type CancelOperationRequest struct { +} + // Date: 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 @@ -351,6 +368,17 @@ func (s *Date) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// Empty: A generic empty message that you can re-use to avoid defining +// duplicated empty messages in your APIs. A typical example is to use +// it as the request or the response type of an API method. For +// instance: service Foo { rpc Bar(google.protobuf.Empty) returns +// (google.protobuf.Empty); } +type Empty struct { + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` +} + // LastUpdatedDate: Information about the date when the privacy policy // was last updated. type LastUpdatedDate struct { @@ -393,6 +421,43 @@ func (s *LastUpdatedDate) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ListOperationsResponse: The response message for +// Operations.ListOperations. +type ListOperationsResponse struct { + // NextPageToken: The standard List next-page token. + NextPageToken string `json:"nextPageToken,omitempty"` + + // Operations: A list of operations that matches the specified filter in + // the request. + Operations []*Operation `json:"operations,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "NextPageToken") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NextPageToken") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListOperationsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Operation: This resource represents a long-running operation that is // the result of a network API call. type Operation struct { @@ -851,6 +916,68 @@ func (s *PolicySectionAnnotation) UnmarshalJSON(data []byte) error { return nil } +// PrivacyPolicy: Privacy policy. +type PrivacyPolicy struct { + // HtmlContent: HTML content for the privacy policy page. + HtmlContent string `json:"htmlContent,omitempty"` + + // Name: Resource name. Example: projects/123/privacyPolicies/456 + Name string `json:"name,omitempty"` + + // PrivacyPolicyUri: URI of the privacy policy corresponding to this + // resource. + PrivacyPolicyUri string `json:"privacyPolicyUri,omitempty"` + + // Score: Confidence that the privacy policy URI is indeed from a + // privacy policy. + Score float64 `json:"score,omitempty"` + + // WebsiteUri: URI of the original website used to find this privacy + // policy. Only populated for resources created by the FindPrivacyPolicy + // API. + WebsiteUri string `json:"websiteUri,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "HtmlContent") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "HtmlContent") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *PrivacyPolicy) MarshalJSON() ([]byte, error) { + type NoMethod PrivacyPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +func (s *PrivacyPolicy) UnmarshalJSON(data []byte) error { + type NoMethod PrivacyPolicy + var s1 struct { + Score gensupport.JSONFloat64 `json:"score"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Score = float64(s1.Score) + return nil +} + // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs // and RPC APIs. It is used by gRPC (https://github.com/grpc). Each @@ -895,79 +1022,111 @@ func (s *Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// method id "checks.accounts.apps.operations.get": +// WaitOperationRequest: The request message for +// Operations.WaitOperation. +type WaitOperationRequest struct { + // Timeout: The maximum duration to wait before timing out. If left + // blank, the wait will be at most the time permitted by the underlying + // HTTP/RPC protocol. If RPC context deadline is also specified, the + // shorter one will be used. + Timeout string `json:"timeout,omitempty"` -type AccountsAppsOperationsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header + // ForceSendFields is a list of field names (e.g. "Timeout") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Timeout") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` } -// 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. +func (s *WaitOperationRequest) MarshalJSON() ([]byte, error) { + type NoMethod WaitOperationRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// method id "checks.accounts.apps.operations.cancel": + +type AccountsAppsOperationsCancelCall struct { + s *Service + name string + canceloperationrequest *CancelOperationRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Cancel: Starts asynchronous cancellation on a long-running operation. +// The server makes a best effort to cancel the operation, but success +// is not guaranteed. If the server doesn't support this method, it +// returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use +// Operations.GetOperation or other methods to check whether the +// cancellation succeeded or whether the operation completed despite +// cancellation. On successful cancellation, the operation is not +// deleted; instead, it becomes an operation with an Operation.error +// value with a google.rpc.Status.code of 1, corresponding to +// `Code.CANCELLED`. // -// - name: The name of the operation resource. -func (r *AccountsAppsOperationsService) Get(name string) *AccountsAppsOperationsGetCall { - c := &AccountsAppsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The name of the operation resource to be cancelled. +func (r *AccountsAppsOperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *AccountsAppsOperationsCancelCall { + c := &AccountsAppsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name + c.canceloperationrequest = canceloperationrequest return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *AccountsAppsOperationsGetCall) Fields(s ...googleapi.Field) *AccountsAppsOperationsGetCall { +func (c *AccountsAppsOperationsCancelCall) Fields(s ...googleapi.Field) *AccountsAppsOperationsCancelCall { 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 *AccountsAppsOperationsGetCall) IfNoneMatch(entityTag string) *AccountsAppsOperationsGetCall { - 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 *AccountsAppsOperationsGetCall) Context(ctx context.Context) *AccountsAppsOperationsGetCall { +func (c *AccountsAppsOperationsCancelCall) Context(ctx context.Context) *AccountsAppsOperationsCancelCall { 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 *AccountsAppsOperationsGetCall) Header() http.Header { +func (c *AccountsAppsOperationsCancelCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *AccountsAppsOperationsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *AccountsAppsOperationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.canceloperationrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}:cancel") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, body) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } @@ -978,14 +1137,14 @@ func (c *AccountsAppsOperationsGetCall) doRequest(alt string) (*http.Response, e return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "checks.accounts.apps.operations.get" call. -// Exactly one of *Operation or error will be non-nil. Any non-2xx -// status code is an error. Response headers are in either -// *Operation.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified -// to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *AccountsAppsOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error) { +// Do executes the "checks.accounts.apps.operations.cancel" call. +// Exactly one of *Empty or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Empty.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *AccountsAppsOperationsCancelCall) Do(opts ...googleapi.CallOption) (*Empty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -1004,7 +1163,7 @@ func (c *AccountsAppsOperationsGetCall) Do(opts ...googleapi.CallOption) (*Opera if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Operation{ + ret := &Empty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -1016,25 +1175,28 @@ func (c *AccountsAppsOperationsGetCall) Do(opts ...googleapi.CallOption) (*Opera } 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/accounts/{accountsId}/apps/{appsId}/operations/{operationsId}", - // "httpMethod": "GET", - // "id": "checks.accounts.apps.operations.get", + // "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + // "flatPath": "v1alpha/accounts/{accountsId}/apps/{appsId}/operations/{operationsId}:cancel", + // "httpMethod": "POST", + // "id": "checks.accounts.apps.operations.cancel", // "parameterOrder": [ // "name" // ], // "parameters": { // "name": { - // "description": "The name of the operation resource.", + // "description": "The name of the operation resource to be cancelled.", // "location": "path", // "pattern": "^accounts/[^/]+/apps/[^/]+/operations/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1alpha/{+name}", + // "path": "v1alpha/{+name}:cancel", + // "request": { + // "$ref": "CancelOperationRequest" + // }, // "response": { - // "$ref": "Operation" + // "$ref": "Empty" // }, // "scopes": [ // "https://www.googleapis.com/auth/xapi.zoo" @@ -1043,28 +1205,32 @@ func (c *AccountsAppsOperationsGetCall) Do(opts ...googleapi.CallOption) (*Opera } -// method id "checks.privacypolicy.analyze": +// method id "checks.accounts.apps.operations.delete": -type PrivacypolicyAnalyzeCall struct { - s *Service - analyzeprivacypolicyrequest *AnalyzePrivacyPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type AccountsAppsOperationsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Analyze: Analyzes the privacy policy of the given policy URL or -// content. -func (r *PrivacypolicyService) Analyze(analyzeprivacypolicyrequest *AnalyzePrivacyPolicyRequest) *PrivacypolicyAnalyzeCall { - c := &PrivacypolicyAnalyzeCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.analyzeprivacypolicyrequest = analyzeprivacypolicyrequest +// Delete: Deletes a long-running operation. This method indicates that +// the client is no longer interested in the operation result. It does +// not cancel the operation. If the server doesn't support this method, +// it returns `google.rpc.Code.UNIMPLEMENTED`. +// +// - name: The name of the operation resource to be deleted. +func (r *AccountsAppsOperationsService) Delete(name string) *AccountsAppsOperationsDeleteCall { + c := &AccountsAppsOperationsDeleteCall{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 *PrivacypolicyAnalyzeCall) Fields(s ...googleapi.Field) *PrivacypolicyAnalyzeCall { +func (c *AccountsAppsOperationsDeleteCall) Fields(s ...googleapi.Field) *AccountsAppsOperationsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -1072,21 +1238,21 @@ func (c *PrivacypolicyAnalyzeCall) Fields(s ...googleapi.Field) *PrivacypolicyAn // 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 *PrivacypolicyAnalyzeCall) Context(ctx context.Context) *PrivacypolicyAnalyzeCall { +func (c *AccountsAppsOperationsDeleteCall) Context(ctx context.Context) *AccountsAppsOperationsDeleteCall { 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 *PrivacypolicyAnalyzeCall) Header() http.Header { +func (c *AccountsAppsOperationsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *PrivacypolicyAnalyzeCall) doRequest(alt string) (*http.Response, error) { +func (c *AccountsAppsOperationsDeleteCall) 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_ { @@ -1094,31 +1260,29 @@ func (c *PrivacypolicyAnalyzeCall) doRequest(alt string) (*http.Response, error) } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.analyzeprivacypolicyrequest) - if err != nil { - return nil, err - } - reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/privacypolicy:analyze") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("DELETE", urls, body) if err != nil { return nil, err } req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "checks.privacypolicy.analyze" call. -// Exactly one of *AnalyzePrivacyPolicyResponse or error will be -// non-nil. Any non-2xx status code is an error. Response headers are in -// either *AnalyzePrivacyPolicyResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was -// because http.StatusNotModified was returned. -func (c *PrivacypolicyAnalyzeCall) Do(opts ...googleapi.CallOption) (*AnalyzePrivacyPolicyResponse, error) { +// Do executes the "checks.accounts.apps.operations.delete" call. +// Exactly one of *Empty or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Empty.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *AccountsAppsOperationsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -1137,7 +1301,7 @@ func (c *PrivacypolicyAnalyzeCall) Do(opts ...googleapi.CallOption) (*AnalyzePri if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &AnalyzePrivacyPolicyResponse{ + ret := &Empty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -1149,26 +1313,36 @@ func (c *PrivacypolicyAnalyzeCall) Do(opts ...googleapi.CallOption) (*AnalyzePri } return ret, nil // { - // "description": "Analyzes the privacy policy of the given policy URL or content.", - // "flatPath": "v1alpha/privacypolicy:analyze", - // "httpMethod": "POST", - // "id": "checks.privacypolicy.analyze", - // "parameterOrder": [], - // "parameters": {}, - // "path": "v1alpha/privacypolicy:analyze", - // "request": { - // "$ref": "AnalyzePrivacyPolicyRequest" + // "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", + // "flatPath": "v1alpha/accounts/{accountsId}/apps/{appsId}/operations/{operationsId}", + // "httpMethod": "DELETE", + // "id": "checks.accounts.apps.operations.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource to be deleted.", + // "location": "path", + // "pattern": "^accounts/[^/]+/apps/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } // }, + // "path": "v1alpha/{+name}", // "response": { - // "$ref": "AnalyzePrivacyPolicyResponse" - // } + // "$ref": "Empty" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/xapi.zoo" + // ] // } } -// method id "checks.projects.privacypolicy.operations.get": +// method id "checks.accounts.apps.operations.get": -type ProjectsPrivacypolicyOperationsGetCall struct { +type AccountsAppsOperationsGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -1182,8 +1356,8 @@ type ProjectsPrivacypolicyOperationsGetCall struct { // recommended by the API service. // // - name: The name of the operation resource. -func (r *ProjectsPrivacypolicyOperationsService) Get(name string) *ProjectsPrivacypolicyOperationsGetCall { - c := &ProjectsPrivacypolicyOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *AccountsAppsOperationsService) Get(name string) *AccountsAppsOperationsGetCall { + c := &AccountsAppsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -1191,7 +1365,7 @@ func (r *ProjectsPrivacypolicyOperationsService) Get(name string) *ProjectsPriva // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *ProjectsPrivacypolicyOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsPrivacypolicyOperationsGetCall { +func (c *AccountsAppsOperationsGetCall) Fields(s ...googleapi.Field) *AccountsAppsOperationsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -1201,7 +1375,7 @@ func (c *ProjectsPrivacypolicyOperationsGetCall) Fields(s ...googleapi.Field) *P // getting updates only after the object has changed since the last // request. Use googleapi.IsNotModified to check whether the response // error from Do is the result of In-None-Match. -func (c *ProjectsPrivacypolicyOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsPrivacypolicyOperationsGetCall { +func (c *AccountsAppsOperationsGetCall) IfNoneMatch(entityTag string) *AccountsAppsOperationsGetCall { c.ifNoneMatch_ = entityTag return c } @@ -1209,21 +1383,21 @@ func (c *ProjectsPrivacypolicyOperationsGetCall) IfNoneMatch(entityTag string) * // Context sets the context to be used in this call's Do method. Any // pending HTTP request will be aborted if the provided context is // canceled. -func (c *ProjectsPrivacypolicyOperationsGetCall) Context(ctx context.Context) *ProjectsPrivacypolicyOperationsGetCall { +func (c *AccountsAppsOperationsGetCall) Context(ctx context.Context) *AccountsAppsOperationsGetCall { 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 *ProjectsPrivacypolicyOperationsGetCall) Header() http.Header { +func (c *AccountsAppsOperationsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsPrivacypolicyOperationsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *AccountsAppsOperationsGetCall) 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_ { @@ -1249,14 +1423,14 @@ func (c *ProjectsPrivacypolicyOperationsGetCall) doRequest(alt string) (*http.Re return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "checks.projects.privacypolicy.operations.get" call. +// Do executes the "checks.accounts.apps.operations.get" call. // Exactly one of *Operation or error will be non-nil. Any non-2xx // status code is an error. Response headers are in either // *Operation.ServerResponse.Header or (if a response was returned at // all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified // to check whether the returned error was because // http.StatusNotModified was returned. -func (c *ProjectsPrivacypolicyOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error) { +func (c *AccountsAppsOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -1288,9 +1462,9 @@ func (c *ProjectsPrivacypolicyOperationsGetCall) Do(opts ...googleapi.CallOption 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}/privacypolicy/operations/{operationsId}", + // "flatPath": "v1alpha/accounts/{accountsId}/apps/{appsId}/operations/{operationsId}", // "httpMethod": "GET", - // "id": "checks.projects.privacypolicy.operations.get", + // "id": "checks.accounts.apps.operations.get", // "parameterOrder": [ // "name" // ], @@ -1298,7 +1472,7 @@ func (c *ProjectsPrivacypolicyOperationsGetCall) Do(opts ...googleapi.CallOption // "name": { // "description": "The name of the operation resource.", // "location": "path", - // "pattern": "^projects/[^/]+/privacypolicy/operations/[^/]+$", + // "pattern": "^accounts/[^/]+/apps/[^/]+/operations/[^/]+$", // "required": true, // "type": "string" // } @@ -1313,3 +1487,1541 @@ func (c *ProjectsPrivacypolicyOperationsGetCall) Do(opts ...googleapi.CallOption // } } + +// method id "checks.accounts.apps.operations.list": + +type AccountsAppsOperationsListCall 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 *AccountsAppsOperationsService) List(name string) *AccountsAppsOperationsListCall { + c := &AccountsAppsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *AccountsAppsOperationsListCall) Filter(filter string) *AccountsAppsOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *AccountsAppsOperationsListCall) PageSize(pageSize int64) *AccountsAppsOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *AccountsAppsOperationsListCall) PageToken(pageToken string) *AccountsAppsOperationsListCall { + 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 *AccountsAppsOperationsListCall) Fields(s ...googleapi.Field) *AccountsAppsOperationsListCall { + 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 *AccountsAppsOperationsListCall) IfNoneMatch(entityTag string) *AccountsAppsOperationsListCall { + 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 *AccountsAppsOperationsListCall) Context(ctx context.Context) *AccountsAppsOperationsListCall { + 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 *AccountsAppsOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsAppsOperationsListCall) 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 "checks.accounts.apps.operations.list" call. +// Exactly one of *ListOperationsResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListOperationsResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *AccountsAppsOperationsListCall) Do(opts ...googleapi.CallOption) (*ListOperationsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ListOperationsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", + // "flatPath": "v1alpha/accounts/{accountsId}/apps/{appsId}/operations", + // "httpMethod": "GET", + // "id": "checks.accounts.apps.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": "^accounts/[^/]+/apps/[^/]+$", + // "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": "ListOperationsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/xapi.zoo" + // ] + // } + +} + +// 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 *AccountsAppsOperationsListCall) Pages(ctx context.Context, f func(*ListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +// method id "checks.accounts.apps.operations.wait": + +type AccountsAppsOperationsWaitCall struct { + s *Service + name string + waitoperationrequest *WaitOperationRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Wait: Waits until the specified long-running operation is done or +// reaches at most a specified timeout, returning the latest state. If +// the operation is already done, the latest state is immediately +// returned. If the timeout specified is greater than the default +// HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does +// not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. +// Note that this method is on a best-effort basis. It may return the +// latest state before the specified timeout (including immediately), +// meaning even an immediate response is no guarantee that the operation +// is done. +// +// - name: The name of the operation resource to wait on. +func (r *AccountsAppsOperationsService) Wait(name string, waitoperationrequest *WaitOperationRequest) *AccountsAppsOperationsWaitCall { + c := &AccountsAppsOperationsWaitCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.waitoperationrequest = waitoperationrequest + 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 *AccountsAppsOperationsWaitCall) Fields(s ...googleapi.Field) *AccountsAppsOperationsWaitCall { + 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 *AccountsAppsOperationsWaitCall) Context(ctx context.Context) *AccountsAppsOperationsWaitCall { + 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 *AccountsAppsOperationsWaitCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsAppsOperationsWaitCall) 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.waitoperationrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}:wait") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "checks.accounts.apps.operations.wait" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *AccountsAppsOperationsWaitCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", + // "flatPath": "v1alpha/accounts/{accountsId}/apps/{appsId}/operations/{operationsId}:wait", + // "httpMethod": "POST", + // "id": "checks.accounts.apps.operations.wait", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource to wait on.", + // "location": "path", + // "pattern": "^accounts/[^/]+/apps/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}:wait", + // "request": { + // "$ref": "WaitOperationRequest" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/xapi.zoo" + // ] + // } + +} + +// method id "checks.privacypolicy.analyze": + +type PrivacypolicyAnalyzeCall struct { + s *Service + analyzeprivacypolicyrequest *AnalyzePrivacyPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Analyze: Analyzes the privacy policy of the given policy URL or +// content. +func (r *PrivacypolicyService) Analyze(analyzeprivacypolicyrequest *AnalyzePrivacyPolicyRequest) *PrivacypolicyAnalyzeCall { + c := &PrivacypolicyAnalyzeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.analyzeprivacypolicyrequest = analyzeprivacypolicyrequest + 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 *PrivacypolicyAnalyzeCall) Fields(s ...googleapi.Field) *PrivacypolicyAnalyzeCall { + 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 *PrivacypolicyAnalyzeCall) Context(ctx context.Context) *PrivacypolicyAnalyzeCall { + 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 *PrivacypolicyAnalyzeCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PrivacypolicyAnalyzeCall) 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.analyzeprivacypolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/privacypolicy:analyze") + 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 "checks.privacypolicy.analyze" call. +// Exactly one of *AnalyzePrivacyPolicyResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *AnalyzePrivacyPolicyResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *PrivacypolicyAnalyzeCall) Do(opts ...googleapi.CallOption) (*AnalyzePrivacyPolicyResponse, 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 := &AnalyzePrivacyPolicyResponse{ + 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": "Analyzes the privacy policy of the given policy URL or content.", + // "flatPath": "v1alpha/privacypolicy:analyze", + // "httpMethod": "POST", + // "id": "checks.privacypolicy.analyze", + // "parameterOrder": [], + // "parameters": {}, + // "path": "v1alpha/privacypolicy:analyze", + // "request": { + // "$ref": "AnalyzePrivacyPolicyRequest" + // }, + // "response": { + // "$ref": "AnalyzePrivacyPolicyResponse" + // } + // } + +} + +// method id "checks.projects.privacyPolicies.delete": + +type ProjectsPrivacyPoliciesDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a privacy policy. +// +// - name: Resource name of the privacy policy. +func (r *ProjectsPrivacyPoliciesService) Delete(name string) *ProjectsPrivacyPoliciesDeleteCall { + c := &ProjectsPrivacyPoliciesDeleteCall{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 *ProjectsPrivacyPoliciesDeleteCall) Fields(s ...googleapi.Field) *ProjectsPrivacyPoliciesDeleteCall { + 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 *ProjectsPrivacyPoliciesDeleteCall) Context(ctx context.Context) *ProjectsPrivacyPoliciesDeleteCall { + 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 *ProjectsPrivacyPoliciesDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsPrivacyPoliciesDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "checks.projects.privacyPolicies.delete" call. +// Exactly one of *Empty or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Empty.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsPrivacyPoliciesDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Empty{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Deletes a privacy policy.", + // "flatPath": "v1alpha/projects/{projectsId}/privacyPolicies/{privacyPoliciesId}", + // "httpMethod": "DELETE", + // "id": "checks.projects.privacyPolicies.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Resource name of the privacy policy.", + // "location": "path", + // "pattern": "^projects/[^/]+/privacyPolicies/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}", + // "response": { + // "$ref": "Empty" + // } + // } + +} + +// method id "checks.projects.privacyPolicies.get": + +type ProjectsPrivacyPoliciesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets a privacy policy. +// +// - name: Resource name of the privacy policy. +func (r *ProjectsPrivacyPoliciesService) Get(name string) *ProjectsPrivacyPoliciesGetCall { + c := &ProjectsPrivacyPoliciesGetCall{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 *ProjectsPrivacyPoliciesGetCall) Fields(s ...googleapi.Field) *ProjectsPrivacyPoliciesGetCall { + 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 *ProjectsPrivacyPoliciesGetCall) IfNoneMatch(entityTag string) *ProjectsPrivacyPoliciesGetCall { + 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 *ProjectsPrivacyPoliciesGetCall) Context(ctx context.Context) *ProjectsPrivacyPoliciesGetCall { + 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 *ProjectsPrivacyPoliciesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsPrivacyPoliciesGetCall) 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 "checks.projects.privacyPolicies.get" call. +// Exactly one of *PrivacyPolicy or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *PrivacyPolicy.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *ProjectsPrivacyPoliciesGetCall) Do(opts ...googleapi.CallOption) (*PrivacyPolicy, 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 := &PrivacyPolicy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets a privacy policy.", + // "flatPath": "v1alpha/projects/{projectsId}/privacyPolicies/{privacyPoliciesId}", + // "httpMethod": "GET", + // "id": "checks.projects.privacyPolicies.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Resource name of the privacy policy.", + // "location": "path", + // "pattern": "^projects/[^/]+/privacyPolicies/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}", + // "response": { + // "$ref": "PrivacyPolicy" + // } + // } + +} + +// method id "checks.projects.privacypolicy.operations.cancel": + +type ProjectsPrivacypolicyOperationsCancelCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Cancel: Starts asynchronous cancellation on a long-running operation. +// The server makes a best effort to cancel the operation, but success +// is not guaranteed. If the server doesn't support this method, it +// returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use +// Operations.GetOperation or other methods to check whether the +// cancellation succeeded or whether the operation completed despite +// cancellation. On successful cancellation, the operation is not +// deleted; instead, it becomes an operation with an Operation.error +// value with a google.rpc.Status.code of 1, corresponding to +// `Code.CANCELLED`. +// +// - name: The name of the operation resource to be cancelled. +func (r *ProjectsPrivacypolicyOperationsService) Cancel(name string) *ProjectsPrivacypolicyOperationsCancelCall { + c := &ProjectsPrivacypolicyOperationsCancelCall{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 *ProjectsPrivacypolicyOperationsCancelCall) Fields(s ...googleapi.Field) *ProjectsPrivacypolicyOperationsCancelCall { + 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 *ProjectsPrivacypolicyOperationsCancelCall) Context(ctx context.Context) *ProjectsPrivacypolicyOperationsCancelCall { + 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 *ProjectsPrivacypolicyOperationsCancelCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsPrivacypolicyOperationsCancelCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}:cancel") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "checks.projects.privacypolicy.operations.cancel" call. +// Exactly one of *Empty or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Empty.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsPrivacypolicyOperationsCancelCall) Do(opts ...googleapi.CallOption) (*Empty, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Empty{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + // "flatPath": "v1alpha/projects/{projectsId}/privacypolicy/operations/{operationsId}:cancel", + // "httpMethod": "POST", + // "id": "checks.projects.privacypolicy.operations.cancel", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource to be cancelled.", + // "location": "path", + // "pattern": "^projects/[^/]+/privacypolicy/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}:cancel", + // "response": { + // "$ref": "Empty" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/xapi.zoo" + // ] + // } + +} + +// method id "checks.projects.privacypolicy.operations.delete": + +type ProjectsPrivacypolicyOperationsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a long-running operation. This method indicates that +// the client is no longer interested in the operation result. It does +// not cancel the operation. If the server doesn't support this method, +// it returns `google.rpc.Code.UNIMPLEMENTED`. +// +// - name: The name of the operation resource to be deleted. +func (r *ProjectsPrivacypolicyOperationsService) Delete(name string) *ProjectsPrivacypolicyOperationsDeleteCall { + c := &ProjectsPrivacypolicyOperationsDeleteCall{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 *ProjectsPrivacypolicyOperationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsPrivacypolicyOperationsDeleteCall { + 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 *ProjectsPrivacypolicyOperationsDeleteCall) Context(ctx context.Context) *ProjectsPrivacypolicyOperationsDeleteCall { + 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 *ProjectsPrivacypolicyOperationsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsPrivacypolicyOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "checks.projects.privacypolicy.operations.delete" call. +// Exactly one of *Empty or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Empty.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsPrivacypolicyOperationsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Empty{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", + // "flatPath": "v1alpha/projects/{projectsId}/privacypolicy/operations/{operationsId}", + // "httpMethod": "DELETE", + // "id": "checks.projects.privacypolicy.operations.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource to be deleted.", + // "location": "path", + // "pattern": "^projects/[^/]+/privacypolicy/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}", + // "response": { + // "$ref": "Empty" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/xapi.zoo" + // ] + // } + +} + +// method id "checks.projects.privacypolicy.operations.get": + +type ProjectsPrivacypolicyOperationsGetCall 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 *ProjectsPrivacypolicyOperationsService) Get(name string) *ProjectsPrivacypolicyOperationsGetCall { + c := &ProjectsPrivacypolicyOperationsGetCall{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 *ProjectsPrivacypolicyOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsPrivacypolicyOperationsGetCall { + 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 *ProjectsPrivacypolicyOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsPrivacypolicyOperationsGetCall { + 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 *ProjectsPrivacypolicyOperationsGetCall) Context(ctx context.Context) *ProjectsPrivacypolicyOperationsGetCall { + 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 *ProjectsPrivacypolicyOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsPrivacypolicyOperationsGetCall) 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 "checks.projects.privacypolicy.operations.get" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsPrivacypolicyOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", + // "flatPath": "v1alpha/projects/{projectsId}/privacypolicy/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "checks.projects.privacypolicy.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/privacypolicy/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/xapi.zoo" + // ] + // } + +} + +// method id "checks.projects.privacypolicy.operations.list": + +type ProjectsPrivacypolicyOperationsListCall 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 *ProjectsPrivacypolicyOperationsService) List(name string) *ProjectsPrivacypolicyOperationsListCall { + c := &ProjectsPrivacypolicyOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *ProjectsPrivacypolicyOperationsListCall) Filter(filter string) *ProjectsPrivacypolicyOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *ProjectsPrivacypolicyOperationsListCall) PageSize(pageSize int64) *ProjectsPrivacypolicyOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *ProjectsPrivacypolicyOperationsListCall) PageToken(pageToken string) *ProjectsPrivacypolicyOperationsListCall { + 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 *ProjectsPrivacypolicyOperationsListCall) Fields(s ...googleapi.Field) *ProjectsPrivacypolicyOperationsListCall { + 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 *ProjectsPrivacypolicyOperationsListCall) IfNoneMatch(entityTag string) *ProjectsPrivacypolicyOperationsListCall { + 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 *ProjectsPrivacypolicyOperationsListCall) Context(ctx context.Context) *ProjectsPrivacypolicyOperationsListCall { + 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 *ProjectsPrivacypolicyOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsPrivacypolicyOperationsListCall) 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}/privacypolicy/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 "checks.projects.privacypolicy.operations.list" call. +// Exactly one of *ListOperationsResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListOperationsResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *ProjectsPrivacypolicyOperationsListCall) Do(opts ...googleapi.CallOption) (*ListOperationsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ListOperationsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", + // "flatPath": "v1alpha/projects/{projectsId}/privacypolicy/operations", + // "httpMethod": "GET", + // "id": "checks.projects.privacypolicy.operations.list", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "filter": { + // "description": "The standard list filter.", + // "location": "query", + // "type": "string" + // }, + // "name": { + // "description": "The name of the operation's parent resource.", + // "location": "path", + // "pattern": "^projects/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "pageSize": { + // "description": "The standard list page size.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The standard list page token.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}/privacypolicy/operations", + // "response": { + // "$ref": "ListOperationsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/xapi.zoo" + // ] + // } + +} + +// 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 *ProjectsPrivacypolicyOperationsListCall) Pages(ctx context.Context, f func(*ListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +// method id "checks.projects.privacypolicy.operations.wait": + +type ProjectsPrivacypolicyOperationsWaitCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Wait: Waits until the specified long-running operation is done or +// reaches at most a specified timeout, returning the latest state. If +// the operation is already done, the latest state is immediately +// returned. If the timeout specified is greater than the default +// HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does +// not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. +// Note that this method is on a best-effort basis. It may return the +// latest state before the specified timeout (including immediately), +// meaning even an immediate response is no guarantee that the operation +// is done. +// +// - name: The name of the operation resource to wait on. +func (r *ProjectsPrivacypolicyOperationsService) Wait(name string) *ProjectsPrivacypolicyOperationsWaitCall { + c := &ProjectsPrivacypolicyOperationsWaitCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Timeout sets the optional parameter "timeout": The maximum duration +// to wait before timing out. If left blank, the wait will be at most +// the time permitted by the underlying HTTP/RPC protocol. If RPC +// context deadline is also specified, the shorter one will be used. +func (c *ProjectsPrivacypolicyOperationsWaitCall) Timeout(timeout string) *ProjectsPrivacypolicyOperationsWaitCall { + c.urlParams_.Set("timeout", timeout) + 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 *ProjectsPrivacypolicyOperationsWaitCall) Fields(s ...googleapi.Field) *ProjectsPrivacypolicyOperationsWaitCall { + 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 *ProjectsPrivacypolicyOperationsWaitCall) Context(ctx context.Context) *ProjectsPrivacypolicyOperationsWaitCall { + 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 *ProjectsPrivacypolicyOperationsWaitCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsPrivacypolicyOperationsWaitCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}:wait") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "checks.projects.privacypolicy.operations.wait" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsPrivacypolicyOperationsWaitCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", + // "flatPath": "v1alpha/projects/{projectsId}/privacypolicy/operations/{operationsId}:wait", + // "httpMethod": "POST", + // "id": "checks.projects.privacypolicy.operations.wait", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource to wait on.", + // "location": "path", + // "pattern": "^projects/[^/]+/privacypolicy/operations/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "timeout": { + // "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", + // "format": "google-duration", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1alpha/{+name}:wait", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/xapi.zoo" + // ] + // } + +} 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/clouddeploy/v1/clouddeploy-api.json b/clouddeploy/v1/clouddeploy-api.json index 73ee2309637..7638026ed8b 100644 --- a/clouddeploy/v1/clouddeploy-api.json +++ b/clouddeploy/v1/clouddeploy-api.json @@ -1451,7 +1451,7 @@ } } }, - "revision": "20230621", + "revision": "20230712", "rootUrl": "https://clouddeploy.googleapis.com/", "schemas": { "AbandonReleaseRequest": { @@ -2172,6 +2172,11 @@ "description": "Required. Name of the Gateway API HTTPRoute.", "type": "string" }, + "routeUpdateWaitTime": { + "description": "Optional. The time to wait for route updates to propagate. The maximum configurable time is 3 hours, in seconds format. If unspecified, there is no wait time.", + "format": "google-duration", + "type": "string" + }, "service": { "description": "Required. Name of the Kubernetes Service.", "type": "string" diff --git a/clouddeploy/v1/clouddeploy-gen.go b/clouddeploy/v1/clouddeploy-gen.go index c9879705856..d2eb77df1fa 100644 --- a/clouddeploy/v1/clouddeploy-gen.go +++ b/clouddeploy/v1/clouddeploy-gen.go @@ -1518,6 +1518,11 @@ type GatewayServiceMesh struct { // HttpRoute: Required. Name of the Gateway API HTTPRoute. HttpRoute string `json:"httpRoute,omitempty"` + // RouteUpdateWaitTime: Optional. The time to wait for route updates to + // propagate. The maximum configurable time is 3 hours, in seconds + // format. If unspecified, there is no wait time. + RouteUpdateWaitTime string `json:"routeUpdateWaitTime,omitempty"` + // Service: Required. Name of the Kubernetes Service. Service string `json:"service,omitempty"` 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/containeranalysis/v1/containeranalysis-api.json b/containeranalysis/v1/containeranalysis-api.json index aa08c117f6b..40df9e036b6 100644 --- a/containeranalysis/v1/containeranalysis-api.json +++ b/containeranalysis/v1/containeranalysis-api.json @@ -755,7 +755,7 @@ } } }, - "revision": "20230707", + "revision": "20230717", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AliasContext": { @@ -825,7 +825,8 @@ "id": "Assessment", "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": { @@ -878,6 +879,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" @@ -997,6 +1002,52 @@ }, "type": "object" }, + "BuildDefinition": { + "id": "BuildDefinition", + "properties": { + "buildType": { + "type": "string" + }, + "externalParameters": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "type": "object" + }, + "internalParameters": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "type": "object" + }, + "resolvedDependencies": { + "items": { + "$ref": "ResourceDescriptor" + }, + "type": "array" + } + }, + "type": "object" + }, + "BuildMetadata": { + "id": "BuildMetadata", + "properties": { + "finishedOn": { + "format": "google-datetime", + "type": "string" + }, + "invocationId": { + "type": "string" + }, + "startedOn": { + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "BuildNote": { "description": "Note holding the version of the provider's builder and the signature of the provenance message in the build details occurrence.", "id": "BuildNote", @@ -1012,6 +1063,10 @@ "description": "Details of a build occurrence.", "id": "BuildOccurrence", "properties": { + "inTotoSlsaProvenanceV1": { + "$ref": "InTotoSlsaProvenanceV1", + "description": "In-Toto Slsa Provenance V1 represents a slsa provenance meeting the slsa spec, wrapped in an in-toto statement. This allows for direct jsonification of a to-spec in-toto slsa statement with a to-spec slsa provenance." + }, "intotoProvenance": { "$ref": "InTotoProvenance", "description": "Deprecated. See InTotoStatement for the replacement. In-toto Provenance representation as defined in spec." @@ -2174,7 +2229,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" }, @@ -3714,6 +3769,28 @@ }, "type": "object" }, + "InTotoSlsaProvenanceV1": { + "id": "InTotoSlsaProvenanceV1", + "properties": { + "_type": { + "description": "InToto spec defined at https://github.com/in-toto/attestation/tree/main/spec#statement", + "type": "string" + }, + "predicate": { + "$ref": "SlsaProvenanceV1" + }, + "predicateType": { + "type": "string" + }, + "subject": { + "items": { + "$ref": "Subject" + }, + "type": "array" + } + }, + "type": "object" + }, "InTotoStatement": { "description": "Spec defined at https://github.com/in-toto/attestation/tree/main/spec#statement The serialized InTotoStatement will be stored as Envelope.payload. Envelope.payloadType is always \"application/vnd.in-toto+json\".", "id": "InTotoStatement", @@ -4455,6 +4532,27 @@ }, "type": "object" }, + "ProvenanceBuilder": { + "id": "ProvenanceBuilder", + "properties": { + "builderDependencies": { + "items": { + "$ref": "ResourceDescriptor" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "version": { + "additionalProperties": { + "type": "string" + }, + "type": "object" + } + }, + "type": "object" + }, "Publisher": { "description": "Publisher contains information about the publisher of this Note.", "id": "Publisher", @@ -4581,6 +4679,58 @@ }, "type": "object" }, + "ResourceDescriptor": { + "id": "ResourceDescriptor", + "properties": { + "annotations": { + "additionalProperties": { + "type": "any" + }, + "type": "object" + }, + "content": { + "format": "byte", + "type": "string" + }, + "digest": { + "additionalProperties": { + "type": "string" + }, + "type": "object" + }, + "downloadLocation": { + "type": "string" + }, + "mediaType": { + "type": "string" + }, + "name": { + "type": "string" + }, + "uri": { + "type": "string" + } + }, + "type": "object" + }, + "RunDetails": { + "id": "RunDetails", + "properties": { + "builder": { + "$ref": "ProvenanceBuilder" + }, + "byproducts": { + "items": { + "$ref": "ResourceDescriptor" + }, + "type": "array" + }, + "metadata": { + "$ref": "BuildMetadata" + } + }, + "type": "object" + }, "SBOMReferenceNote": { "description": "The note representing an SBOM reference.", "id": "SBOMReferenceNote", @@ -4803,6 +4953,19 @@ }, "type": "object" }, + "SlsaProvenanceV1": { + "description": "Keep in sync with schema at https://github.com/slsa-framework/slsa/blob/main/docs/provenance/schema/v1/provenance.proto Builder renamed to ProvenanceBuilder because of Java conflicts.", + "id": "SlsaProvenanceV1", + "properties": { + "buildDefinition": { + "$ref": "BuildDefinition" + }, + "runDetails": { + "$ref": "RunDetails" + } + }, + "type": "object" + }, "SlsaProvenanceZeroTwo": { "description": "See full explanation of fields at slsa.dev/provenance/v0.2.", "id": "SlsaProvenanceZeroTwo", @@ -5138,7 +5301,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": { @@ -5187,6 +5351,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/containeranalysis/v1/containeranalysis-gen.go b/containeranalysis/v1/containeranalysis-gen.go index 145980bffd1..a968280bfe7 100644 --- a/containeranalysis/v1/containeranalysis-gen.go +++ b/containeranalysis/v1/containeranalysis-gen.go @@ -293,7 +293,8 @@ func (s *Artifact) MarshalJSON() ([]byte, error) { // single vulnerability for this product. type Assessment 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, @@ -335,6 +336,10 @@ type Assessment 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 @@ -649,6 +654,68 @@ func (s *Binding) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type BuildDefinition struct { + BuildType string `json:"buildType,omitempty"` + + ExternalParameters googleapi.RawMessage `json:"externalParameters,omitempty"` + + InternalParameters googleapi.RawMessage `json:"internalParameters,omitempty"` + + ResolvedDependencies []*ResourceDescriptor `json:"resolvedDependencies,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BuildType") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BuildType") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BuildDefinition) MarshalJSON() ([]byte, error) { + type NoMethod BuildDefinition + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +type BuildMetadata struct { + FinishedOn string `json:"finishedOn,omitempty"` + + InvocationId string `json:"invocationId,omitempty"` + + StartedOn string `json:"startedOn,omitempty"` + + // ForceSendFields is a list of field names (e.g. "FinishedOn") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "FinishedOn") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BuildMetadata) MarshalJSON() ([]byte, error) { + type NoMethod BuildMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // BuildNote: Note holding the version of the provider's builder and the // signature of the provenance message in the build details occurrence. type BuildNote struct { @@ -682,6 +749,12 @@ func (s *BuildNote) MarshalJSON() ([]byte, error) { // BuildOccurrence: Details of a build occurrence. type BuildOccurrence struct { + // InTotoSlsaProvenanceV1: In-Toto Slsa Provenance V1 represents a slsa + // provenance meeting the slsa spec, wrapped in an in-toto statement. + // This allows for direct jsonification of a to-spec in-toto slsa + // statement with a to-spec slsa provenance. + InTotoSlsaProvenanceV1 *InTotoSlsaProvenanceV1 `json:"inTotoSlsaProvenanceV1,omitempty"` + // IntotoProvenance: Deprecated. See InTotoStatement for the // replacement. In-toto Provenance representation as defined in spec. IntotoProvenance *InTotoProvenance `json:"intotoProvenance,omitempty"` @@ -707,18 +780,19 @@ type BuildOccurrence struct { // changes. ProvenanceBytes string `json:"provenanceBytes,omitempty"` - // ForceSendFields is a list of field names (e.g. "IntotoProvenance") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. + // ForceSendFields is a list of field names (e.g. + // "InTotoSlsaProvenanceV1") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "IntotoProvenance") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the + // NullFields is a list of field names (e.g. "InTotoSlsaProvenanceV1") + // to include in API requests with the JSON null value. By default, + // fields with empty values are omitted from API requests. However, any + // field with an empty value appearing in NullFields will be sent to the // server as null. It is an error if a field in this list has a // non-empty value. This may be used to include null fields in Patch // requests. @@ -2109,8 +2183,8 @@ type ContaineranalysisGoogleDevtoolsCloudbuildV1BuildOptions 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 @@ -4596,6 +4670,40 @@ func (s *InTotoProvenance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type InTotoSlsaProvenanceV1 struct { + // Type: InToto spec defined at + // https://github.com/in-toto/attestation/tree/main/spec#statement + Type string `json:"_type,omitempty"` + + Predicate *SlsaProvenanceV1 `json:"predicate,omitempty"` + + PredicateType string `json:"predicateType,omitempty"` + + Subject []*Subject `json:"subject,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Type") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Type") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *InTotoSlsaProvenanceV1) MarshalJSON() ([]byte, error) { + type NoMethod InTotoSlsaProvenanceV1 + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // InTotoStatement: Spec defined at // https://github.com/in-toto/attestation/tree/main/spec#statement The // serialized InTotoStatement will be stored as Envelope.payload. @@ -5702,6 +5810,37 @@ func (s *ProjectRepoId) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type ProvenanceBuilder struct { + BuilderDependencies []*ResourceDescriptor `json:"builderDependencies,omitempty"` + + Id string `json:"id,omitempty"` + + Version map[string]string `json:"version,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BuilderDependencies") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BuilderDependencies") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *ProvenanceBuilder) MarshalJSON() ([]byte, error) { + type NoMethod ProvenanceBuilder + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Publisher: Publisher contains information about the publisher of this // Note. type Publisher struct { @@ -5911,6 +6050,74 @@ func (s *RepoId) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type ResourceDescriptor struct { + Annotations googleapi.RawMessage `json:"annotations,omitempty"` + + Content string `json:"content,omitempty"` + + Digest map[string]string `json:"digest,omitempty"` + + DownloadLocation string `json:"downloadLocation,omitempty"` + + MediaType string `json:"mediaType,omitempty"` + + Name string `json:"name,omitempty"` + + Uri string `json:"uri,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Annotations") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Annotations") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ResourceDescriptor) MarshalJSON() ([]byte, error) { + type NoMethod ResourceDescriptor + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +type RunDetails struct { + Builder *ProvenanceBuilder `json:"builder,omitempty"` + + Byproducts []*ResourceDescriptor `json:"byproducts,omitempty"` + + Metadata *BuildMetadata `json:"metadata,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Builder") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Builder") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *RunDetails) MarshalJSON() ([]byte, error) { + type NoMethod RunDetails + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SBOMReferenceNote: The note representing an SBOM reference. type SBOMReferenceNote struct { // Format: The format that SBOM takes. E.g. may be spdx, cyclonedx, @@ -6354,6 +6561,38 @@ func (s *SlsaProvenance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// SlsaProvenanceV1: Keep in sync with schema at +// https://github.com/slsa-framework/slsa/blob/main/docs/provenance/schema/v1/provenance.proto +// Builder renamed to ProvenanceBuilder because of Java conflicts. +type SlsaProvenanceV1 struct { + BuildDefinition *BuildDefinition `json:"buildDefinition,omitempty"` + + RunDetails *RunDetails `json:"runDetails,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BuildDefinition") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BuildDefinition") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *SlsaProvenanceV1) MarshalJSON() ([]byte, error) { + type NoMethod SlsaProvenanceV1 + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SlsaProvenanceZeroTwo: See full explanation of fields at // slsa.dev/provenance/v0.2. type SlsaProvenanceZeroTwo struct { @@ -6913,7 +7152,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, @@ -6951,6 +7191,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/containeranalysis/v1alpha1/containeranalysis-api.json b/containeranalysis/v1alpha1/containeranalysis-api.json index 661254a6e9d..f0ff6b7d764 100644 --- a/containeranalysis/v1alpha1/containeranalysis-api.json +++ b/containeranalysis/v1alpha1/containeranalysis-api.json @@ -1233,7 +1233,7 @@ } } }, - "revision": "20230707", + "revision": "20230717", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AnalysisCompleted": { @@ -1335,6 +1335,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" @@ -1407,10 +1411,43 @@ }, "type": "object" }, + "BuildDefinition": { + "id": "BuildDefinition", + "properties": { + "buildType": { + "type": "string" + }, + "externalParameters": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "type": "object" + }, + "internalParameters": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "type": "object" + }, + "resolvedDependencies": { + "items": { + "$ref": "ResourceDescriptor" + }, + "type": "array" + } + }, + "type": "object" + }, "BuildDetails": { "description": "Message encapsulating build provenance details.", "id": "BuildDetails", "properties": { + "inTotoSlsaProvenanceV1": { + "$ref": "InTotoSlsaProvenanceV1", + "description": "In-Toto Slsa Provenance V1 represents a slsa provenance meeting the slsa spec, wrapped in an in-toto statement. This allows for direct jsonification of a to-spec in-toto slsa statement with a to-spec slsa provenance." + }, "intotoProvenance": { "$ref": "InTotoProvenance", "description": "Deprecated. See InTotoStatement for the replacement. In-toto Provenance representation as defined in spec." @@ -1430,6 +1467,23 @@ }, "type": "object" }, + "BuildMetadata": { + "id": "BuildMetadata", + "properties": { + "finishedOn": { + "format": "google-datetime", + "type": "string" + }, + "invocationId": { + "type": "string" + }, + "startedOn": { + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "BuildProvenance": { "description": "Provenance of a build. Contains all information needed to verify the full details about the build from source to completion.", "id": "BuildProvenance", @@ -2464,7 +2518,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" }, @@ -4307,6 +4361,28 @@ }, "type": "object" }, + "InTotoSlsaProvenanceV1": { + "id": "InTotoSlsaProvenanceV1", + "properties": { + "_type": { + "description": "InToto spec defined at https://github.com/in-toto/attestation/tree/main/spec#statement", + "type": "string" + }, + "predicate": { + "$ref": "SlsaProvenanceV1" + }, + "predicateType": { + "type": "string" + }, + "subject": { + "items": { + "$ref": "Subject" + }, + "type": "array" + } + }, + "type": "object" + }, "InTotoStatement": { "description": "Spec defined at https://github.com/in-toto/attestation/tree/main/spec#statement The serialized InTotoStatement will be stored as Envelope.payload. Envelope.payloadType is always \"application/vnd.in-toto+json\".", "id": "InTotoStatement", @@ -5290,6 +5366,27 @@ }, "type": "object" }, + "ProvenanceBuilder": { + "id": "ProvenanceBuilder", + "properties": { + "builderDependencies": { + "items": { + "$ref": "ResourceDescriptor" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "version": { + "additionalProperties": { + "type": "string" + }, + "type": "object" + } + }, + "type": "object" + }, "Publisher": { "description": "Publisher contains information about the publisher of this Note.", "id": "Publisher", @@ -5667,6 +5764,58 @@ }, "type": "object" }, + "ResourceDescriptor": { + "id": "ResourceDescriptor", + "properties": { + "annotations": { + "additionalProperties": { + "type": "any" + }, + "type": "object" + }, + "content": { + "format": "byte", + "type": "string" + }, + "digest": { + "additionalProperties": { + "type": "string" + }, + "type": "object" + }, + "downloadLocation": { + "type": "string" + }, + "mediaType": { + "type": "string" + }, + "name": { + "type": "string" + }, + "uri": { + "type": "string" + } + }, + "type": "object" + }, + "RunDetails": { + "id": "RunDetails", + "properties": { + "builder": { + "$ref": "ProvenanceBuilder" + }, + "byproducts": { + "items": { + "$ref": "ResourceDescriptor" + }, + "type": "array" + }, + "metadata": { + "$ref": "BuildMetadata" + } + }, + "type": "object" + }, "SBOMReferenceNote": { "description": "The note representing an SBOM reference.", "id": "SBOMReferenceNote", @@ -5940,6 +6089,19 @@ }, "type": "object" }, + "SlsaProvenanceV1": { + "description": "Keep in sync with schema at https://github.com/slsa-framework/slsa/blob/main/docs/provenance/schema/v1/provenance.proto Builder renamed to ProvenanceBuilder because of Java conflicts.", + "id": "SlsaProvenanceV1", + "properties": { + "buildDefinition": { + "$ref": "BuildDefinition" + }, + "runDetails": { + "$ref": "RunDetails" + } + }, + "type": "object" + }, "SlsaProvenanceZeroTwo": { "description": "SlsaProvenanceZeroTwo is the slsa provenance as defined by the slsa spec. See full explanation of fields at slsa.dev/provenance/v0.2.", "id": "SlsaProvenanceZeroTwo", @@ -6353,6 +6515,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/containeranalysis/v1alpha1/containeranalysis-gen.go b/containeranalysis/v1alpha1/containeranalysis-gen.go index a31471f420a..1c170ce08c1 100644 --- a/containeranalysis/v1alpha1/containeranalysis-gen.go +++ b/containeranalysis/v1alpha1/containeranalysis-gen.go @@ -368,6 +368,10 @@ type Assessment 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 @@ -613,8 +617,46 @@ func (s *Binding) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type BuildDefinition struct { + BuildType string `json:"buildType,omitempty"` + + ExternalParameters googleapi.RawMessage `json:"externalParameters,omitempty"` + + InternalParameters googleapi.RawMessage `json:"internalParameters,omitempty"` + + ResolvedDependencies []*ResourceDescriptor `json:"resolvedDependencies,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BuildType") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BuildType") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BuildDefinition) MarshalJSON() ([]byte, error) { + type NoMethod BuildDefinition + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // BuildDetails: Message encapsulating build provenance details. type BuildDetails struct { + // InTotoSlsaProvenanceV1: In-Toto Slsa Provenance V1 represents a slsa + // provenance meeting the slsa spec, wrapped in an in-toto statement. + // This allows for direct jsonification of a to-spec in-toto slsa + // statement with a to-spec slsa provenance. + InTotoSlsaProvenanceV1 *InTotoSlsaProvenanceV1 `json:"inTotoSlsaProvenanceV1,omitempty"` + // IntotoProvenance: Deprecated. See InTotoStatement for the // replacement. In-toto Provenance representation as defined in spec. IntotoProvenance *InTotoProvenance `json:"intotoProvenance,omitempty"` @@ -639,18 +681,19 @@ type BuildDetails struct { // to json as well to prevent incompatibilities with future changes. ProvenanceBytes string `json:"provenanceBytes,omitempty"` - // ForceSendFields is a list of field names (e.g. "IntotoProvenance") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. + // ForceSendFields is a list of field names (e.g. + // "InTotoSlsaProvenanceV1") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "IntotoProvenance") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the + // NullFields is a list of field names (e.g. "InTotoSlsaProvenanceV1") + // to include in API requests with the JSON null value. By default, + // fields with empty values are omitted from API requests. However, any + // field with an empty value appearing in NullFields will be sent to the // server as null. It is an error if a field in this list has a // non-empty value. This may be used to include null fields in Patch // requests. @@ -663,6 +706,36 @@ func (s *BuildDetails) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type BuildMetadata struct { + FinishedOn string `json:"finishedOn,omitempty"` + + InvocationId string `json:"invocationId,omitempty"` + + StartedOn string `json:"startedOn,omitempty"` + + // ForceSendFields is a list of field names (e.g. "FinishedOn") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "FinishedOn") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *BuildMetadata) MarshalJSON() ([]byte, error) { + type NoMethod BuildMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // BuildProvenance: Provenance of a build. Contains all information // needed to verify the full details about the build from source to // completion. @@ -1985,8 +2058,8 @@ type ContaineranalysisGoogleDevtoolsCloudbuildV1BuildOptions 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 @@ -4912,6 +4985,40 @@ func (s *InTotoProvenance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type InTotoSlsaProvenanceV1 struct { + // Type: InToto spec defined at + // https://github.com/in-toto/attestation/tree/main/spec#statement + Type string `json:"_type,omitempty"` + + Predicate *SlsaProvenanceV1 `json:"predicate,omitempty"` + + PredicateType string `json:"predicateType,omitempty"` + + Subject []*Subject `json:"subject,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Type") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Type") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *InTotoSlsaProvenanceV1) MarshalJSON() ([]byte, error) { + type NoMethod InTotoSlsaProvenanceV1 + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // InTotoStatement: Spec defined at // https://github.com/in-toto/attestation/tree/main/spec#statement The // serialized InTotoStatement will be stored as Envelope.payload. @@ -6305,6 +6412,37 @@ func (s *Product) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type ProvenanceBuilder struct { + BuilderDependencies []*ResourceDescriptor `json:"builderDependencies,omitempty"` + + Id string `json:"id,omitempty"` + + Version map[string]string `json:"version,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BuilderDependencies") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BuilderDependencies") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *ProvenanceBuilder) MarshalJSON() ([]byte, error) { + type NoMethod ProvenanceBuilder + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Publisher: Publisher contains information about the publisher of this // Note. type Publisher struct { @@ -6809,6 +6947,74 @@ func (s *Resource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type ResourceDescriptor struct { + Annotations googleapi.RawMessage `json:"annotations,omitempty"` + + Content string `json:"content,omitempty"` + + Digest map[string]string `json:"digest,omitempty"` + + DownloadLocation string `json:"downloadLocation,omitempty"` + + MediaType string `json:"mediaType,omitempty"` + + Name string `json:"name,omitempty"` + + Uri string `json:"uri,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Annotations") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Annotations") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ResourceDescriptor) MarshalJSON() ([]byte, error) { + type NoMethod ResourceDescriptor + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +type RunDetails struct { + Builder *ProvenanceBuilder `json:"builder,omitempty"` + + Byproducts []*ResourceDescriptor `json:"byproducts,omitempty"` + + Metadata *BuildMetadata `json:"metadata,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Builder") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Builder") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *RunDetails) MarshalJSON() ([]byte, error) { + type NoMethod RunDetails + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SBOMReferenceNote: The note representing an SBOM reference. type SBOMReferenceNote struct { // Format: The format that SBOM takes. E.g. may be spdx, cyclonedx, @@ -7278,6 +7484,38 @@ func (s *SlsaProvenance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// SlsaProvenanceV1: Keep in sync with schema at +// https://github.com/slsa-framework/slsa/blob/main/docs/provenance/schema/v1/provenance.proto +// Builder renamed to ProvenanceBuilder because of Java conflicts. +type SlsaProvenanceV1 struct { + BuildDefinition *BuildDefinition `json:"buildDefinition,omitempty"` + + RunDetails *RunDetails `json:"runDetails,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BuildDefinition") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BuildDefinition") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *SlsaProvenanceV1) MarshalJSON() ([]byte, error) { + type NoMethod SlsaProvenanceV1 + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SlsaProvenanceZeroTwo: SlsaProvenanceZeroTwo is the slsa provenance // as defined by the slsa spec. See full explanation of fields at // slsa.dev/provenance/v0.2. @@ -7936,6 +8174,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/containeranalysis/v1beta1/containeranalysis-api.json b/containeranalysis/v1beta1/containeranalysis-api.json index 0f24050d2be..356e1836f0f 100644 --- a/containeranalysis/v1beta1/containeranalysis-api.json +++ b/containeranalysis/v1beta1/containeranalysis-api.json @@ -815,7 +815,7 @@ } } }, - "revision": "20230707", + "revision": "20230717", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AliasContext": { @@ -908,7 +908,8 @@ "id": "Assessment", "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": { @@ -961,6 +962,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" @@ -2197,7 +2202,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" }, @@ -5747,7 +5752,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": { @@ -5796,6 +5802,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/containeranalysis/v1beta1/containeranalysis-gen.go b/containeranalysis/v1beta1/containeranalysis-gen.go index ed387ce86bb..23cb661bcce 100644 --- a/containeranalysis/v1beta1/containeranalysis-gen.go +++ b/containeranalysis/v1beta1/containeranalysis-gen.go @@ -360,7 +360,8 @@ func (s *ArtifactRule) MarshalJSON() ([]byte, error) { // single vulnerability for this product. type Assessment 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, @@ -402,6 +403,10 @@ type Assessment 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 @@ -2067,8 +2072,8 @@ type ContaineranalysisGoogleDevtoolsCloudbuildV1BuildOptions 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 @@ -7519,7 +7524,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, @@ -7557,6 +7563,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/datacatalog/v1/datacatalog-api.json b/datacatalog/v1/datacatalog-api.json index 72b9c869805..b379de73218 100644 --- a/datacatalog/v1/datacatalog-api.json +++ b/datacatalog/v1/datacatalog-api.json @@ -2144,7 +2144,7 @@ } } }, - "revision": "20230707", + "revision": "20230716", "rootUrl": "https://datacatalog.googleapis.com/", "schemas": { "Binding": { @@ -3693,6 +3693,10 @@ "description": "Request message for SearchCatalog.", "id": "GoogleCloudDatacatalogV1SearchCatalogRequest", "properties": { + "adminSearch": { + "description": "Optional. If set, use searchAll permission granted on organizations from `include_org_ids` and projects from `include_project_ids` instead of the fine grained per resource permissions when filtering the search results. The only allowed `order_by` criteria for admin_search mode is `default`. Using this flags guarantees a full recall of the search results.", + "type": "boolean" + }, "orderBy": { "description": "Specifies the order of results. Currently supported case-sensitive values are: * `relevance` that can only be descending * `last_modified_timestamp [asc|desc]` with descending (`desc`) as default * `default` that can only be descending Search queries don't guarantee full recall. Results that match your query might not be returned, even in subsequent result pages. Additionally, returned (and not returned) results can vary if you repeat search queries. If you are experiencing recall issues and you don't have to fetch the results in any specific order, consider setting this parameter to `default`. If this parameter is omitted, it defaults to the descending `relevance`.", "type": "string" diff --git a/datacatalog/v1/datacatalog-gen.go b/datacatalog/v1/datacatalog-gen.go index b962b28e1f4..2f1a40d7477 100644 --- a/datacatalog/v1/datacatalog-gen.go +++ b/datacatalog/v1/datacatalog-gen.go @@ -3101,6 +3101,14 @@ func (s *GoogleCloudDatacatalogV1Schema) MarshalJSON() ([]byte, error) { // GoogleCloudDatacatalogV1SearchCatalogRequest: Request message for // SearchCatalog. type GoogleCloudDatacatalogV1SearchCatalogRequest struct { + // AdminSearch: Optional. If set, use searchAll permission granted on + // organizations from `include_org_ids` and projects from + // `include_project_ids` instead of the fine grained per resource + // permissions when filtering the search results. The only allowed + // `order_by` criteria for admin_search mode is `default`. Using this + // flags guarantees a full recall of the search results. + AdminSearch bool `json:"adminSearch,omitempty"` + // OrderBy: Specifies the order of results. Currently supported // case-sensitive values are: * `relevance` that can only be descending // * `last_modified_timestamp [asc|desc]` with descending (`desc`) as @@ -3140,7 +3148,7 @@ type GoogleCloudDatacatalogV1SearchCatalogRequest struct { // request returns an error. Scope *GoogleCloudDatacatalogV1SearchCatalogRequestScope `json:"scope,omitempty"` - // ForceSendFields is a list of field names (e.g. "OrderBy") to + // ForceSendFields is a list of field names (e.g. "AdminSearch") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3148,10 +3156,10 @@ type GoogleCloudDatacatalogV1SearchCatalogRequest struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "OrderBy") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "AdminSearch") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` diff --git a/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/dialogflow/v2/dialogflow-api.json b/dialogflow/v2/dialogflow-api.json index 27bda716519..f11649d82f8 100644 --- a/dialogflow/v2/dialogflow-api.json +++ b/dialogflow/v2/dialogflow-api.json @@ -1230,7 +1230,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", "location": "path", "pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -2256,7 +2256,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", "location": "path", "pattern": "^projects/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -3284,7 +3284,7 @@ ], "parameters": { "conversationId": { - "description": "Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula \"a-zA-Z*\" with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.", + "description": "Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula `a-zA-Z*` with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.", "location": "query", "type": "string" }, @@ -5320,7 +5320,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -5986,7 +5986,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -7098,7 +7098,7 @@ ], "parameters": { "conversationId": { - "description": "Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula \"a-zA-Z*\" with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.", + "description": "Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula `a-zA-Z*` with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.", "location": "query", "type": "string" }, @@ -8211,7 +8211,7 @@ } } }, - "revision": "20230714", + "revision": "20230717", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { @@ -8615,7 +8615,7 @@ "type": "string" }, "commitSha": { - "description": "Commit SHA of the git push. This field is populated if `git_destination` are specified in ExportAgentRequest.", + "description": "Commit SHA of the git push. This field is populated if `git_destination` is specified in ExportAgentRequest.", "type": "string" } }, @@ -9308,6 +9308,22 @@ "$ref": "GoogleCloudDialogflowCxV3ResponseMessagePlayAudio", "description": "Signal that the client should play an audio clip hosted at a client-specific URI. Dialogflow uses this to construct mixed_audio. However, Dialogflow itself does not try to read or process the URI in any way." }, + "responseType": { + "description": "Response type.", + "enum": [ + "RESPONSE_TYPE_UNSPECIFIED", + "ENTRY_PROMPT", + "PARAMETER_PROMPT", + "HANDLER_PROMPT" + ], + "enumDescriptions": [ + "Not specified.", + "The response is from an entry prompt in the page.", + "The response is from form-filling prompt in the page.", + "The response is from a transition route or an event handler in the page or flow or transition route group." + ], + "type": "string" + }, "telephonyTransferCall": { "$ref": "GoogleCloudDialogflowCxV3ResponseMessageTelephonyTransferCall", "description": "A signal that the client should transfer the phone call connected to this agent to a third-party endpoint." @@ -10547,7 +10563,7 @@ "type": "string" }, "commitSha": { - "description": "Commit SHA of the git push. This field is populated if `git_destination` are specified in ExportAgentRequest.", + "description": "Commit SHA of the git push. This field is populated if `git_destination` is specified in ExportAgentRequest.", "type": "string" } }, @@ -12832,7 +12848,7 @@ "type": "integer" }, "name": { - "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", "type": "string" }, "parameters": { @@ -12840,7 +12856,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" } }, @@ -13752,7 +13768,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" } }, @@ -13935,7 +13951,7 @@ "id": "GoogleCloudDialogflowV2GcsDestination", "properties": { "uri": { - "description": "The Google Cloud Storage URIs for the output. A URI is of the form: gs://bucket/object-prefix-or-name Whether a prefix or name is used depends on the use case. The requesting user must have \"write-permission\" to the bucket.", + "description": "The Google Cloud Storage URIs for the output. A URI is of the form: `gs://bucket/object-prefix-or-name` Whether a prefix or name is used depends on the use case. The requesting user must have \"write-permission\" to the bucket.", "type": "string" } }, @@ -13946,7 +13962,7 @@ "id": "GoogleCloudDialogflowV2GcsSources", "properties": { "uris": { - "description": "Required. Google Cloud Storage URIs for the inputs. A URI is of the form: gs://bucket/object-prefix-or-name Whether a prefix or name is used depends on the use case.", + "description": "Required. Google Cloud Storage URIs for the inputs. A URI is of the form: `gs://bucket/object-prefix-or-name` Whether a prefix or name is used depends on the use case.", "items": { "type": "string" }, @@ -14526,7 +14542,7 @@ }, "phraseHints": { "deprecated": true, - "description": "A list of strings containing words and phrases that the speech recognizer should recognize with higher likelihood. See [the Cloud Speech documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) for more details. This field is deprecated. Please use [speech_contexts]() instead. If you specify both [phrase_hints]() and [speech_contexts](), Dialogflow will treat the [phrase_hints]() as a single additional [SpeechContext]().", + "description": "A list of strings containing words and phrases that the speech recognizer should recognize with higher likelihood. See [the Cloud Speech documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) for more details. This field is deprecated. Please use [`speech_contexts`]() instead. If you specify both [`phrase_hints`]() and [`speech_contexts`](), Dialogflow will treat the [`phrase_hints`]() as a single additional [`SpeechContext`]().", "items": { "type": "string" }, @@ -16205,7 +16221,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" }, "queryText": { @@ -16835,7 +16851,7 @@ "type": "object" }, "GoogleCloudDialogflowV2TextInput": { - "description": "============================================================================ Auxiliary proto messages. Represents the natural language text to be processed.", + "description": "Auxiliary proto messages. Represents the natural language text to be processed.", "id": "GoogleCloudDialogflowV2TextInput", "properties": { "languageCode": { @@ -16925,7 +16941,7 @@ "id": "GoogleCloudDialogflowV2ValidationError", "properties": { "entries": { - "description": "The names of the entries that the error is associated with. Format: - \"projects//agent\", if the error is associated with the entire agent. - \"projects//agent/intents/\", if the error is associated with certain intents. - \"projects//agent/intents//trainingPhrases/\", if the error is associated with certain intent training phrases. - \"projects//agent/intents//parameters/\", if the error is associated with certain intent parameters. - \"projects//agent/entities/\", if the error is associated with certain entities.", + "description": "The names of the entries that the error is associated with. Format: - `projects//agent`, if the error is associated with the entire agent. - `projects//agent/intents/`, if the error is associated with certain intents. - `projects//agent/intents//trainingPhrases/`, if the error is associated with certain intent training phrases. - `projects//agent/intents//parameters/`, if the error is associated with certain intent parameters. - `projects//agent/entities/`, if the error is associated with certain entities.", "items": { "type": "string" }, @@ -17255,7 +17271,7 @@ "type": "integer" }, "name": { - "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", "type": "string" }, "parameters": { @@ -17263,7 +17279,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" } }, @@ -17416,7 +17432,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" } }, @@ -17489,7 +17505,7 @@ "id": "GoogleCloudDialogflowV2beta1GcsDestination", "properties": { "uri": { - "description": "Required. The Google Cloud Storage URIs for the output. A URI is of the form: gs://bucket/object-prefix-or-name Whether a prefix or name is used depends on the use case. The requesting user must have \"write-permission\" to the bucket.", + "description": "Required. The Google Cloud Storage URIs for the output. A URI is of the form: `gs://bucket/object-prefix-or-name` Whether a prefix or name is used depends on the use case. The requesting user must have \"write-permission\" to the bucket.", "type": "string" } }, @@ -19015,7 +19031,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" }, "queryText": { diff --git a/dialogflow/v2/dialogflow-gen.go b/dialogflow/v2/dialogflow-gen.go index 4c250582310..7f8bbce7cd6 100644 --- a/dialogflow/v2/dialogflow-gen.go +++ b/dialogflow/v2/dialogflow-gen.go @@ -1613,7 +1613,7 @@ type GoogleCloudDialogflowCxV3ExportAgentResponse struct { AgentUri string `json:"agentUri,omitempty"` // CommitSha: Commit SHA of the git push. This field is populated if - // `git_destination` are specified in ExportAgentRequest. + // `git_destination` is specified in ExportAgentRequest. CommitSha string `json:"commitSha,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -2968,6 +2968,17 @@ type GoogleCloudDialogflowCxV3ResponseMessage struct { // any way. PlayAudio *GoogleCloudDialogflowCxV3ResponseMessagePlayAudio `json:"playAudio,omitempty"` + // ResponseType: Response type. + // + // Possible values: + // "RESPONSE_TYPE_UNSPECIFIED" - Not specified. + // "ENTRY_PROMPT" - The response is from an entry prompt in the page. + // "PARAMETER_PROMPT" - The response is from form-filling prompt in + // the page. + // "HANDLER_PROMPT" - The response is from a transition route or an + // event handler in the page or flow or transition route group. + ResponseType string `json:"responseType,omitempty"` + // TelephonyTransferCall: A signal that the client should transfer the // phone call connected to this agent to a third-party endpoint. TelephonyTransferCall *GoogleCloudDialogflowCxV3ResponseMessageTelephonyTransferCall `json:"telephonyTransferCall,omitempty"` @@ -5190,7 +5201,7 @@ type GoogleCloudDialogflowCxV3beta1ExportAgentResponse struct { AgentUri string `json:"agentUri,omitempty"` // CommitSha: Commit SHA of the git push. This field is populated if - // `git_destination` are specified in ExportAgentRequest. + // `git_destination` is specified in ExportAgentRequest. CommitSha string `json:"commitSha,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -9293,7 +9304,7 @@ type GoogleCloudDialogflowV2Context struct { // `projects//agent/sessions//contexts/`, or // `projects//agent/environments//users//sessions//contexts/`. The // `Context ID` is always converted to lowercase, may only contain - // characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If + // characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If // `Environment ID` is not specified, we assume default 'draft' // environment. If `User ID` is not specified, we assume default '-' // user. The following context names are reserved for internal use by @@ -9305,13 +9316,14 @@ type GoogleCloudDialogflowV2Context struct { // Parameters: Optional. The collection of parameters associated with // this context. Depending on your protocol or client library language, // this is a map, associative array, symbol table, dictionary, or JSON - // object composed of a collection of (MapKey, MapValue) pairs: - MapKey - // type: string - MapKey value: parameter name - MapValue type: - If - // parameter's entity type is a composite entity: map - Else: depending - // on parameter value type, could be one of string, number, boolean, - // null, list or map - MapValue value: - If parameter's entity type is a - // composite entity: map from composite entity property names to - // property values - Else: parameter value + // object composed of a collection of (MapKey, MapValue) pairs: * MapKey + // type: string * MapKey value: parameter name * MapValue type: If + // parameter's entity type is a composite entity then use map, + // otherwise, depending on the parameter value type, it could be one of + // string, number, boolean, null, list or map. * MapValue value: If + // parameter's entity type is a composite entity then use map from + // composite entity property names to property values, otherwise, use + // parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -10818,13 +10830,13 @@ type GoogleCloudDialogflowV2EventInput struct { // Parameters: The collection of parameters associated with the event. // Depending on your protocol or client library language, this is a map, // associative array, symbol table, dictionary, or JSON object composed - // of a collection of (MapKey, MapValue) pairs: - MapKey type: string - - // MapKey value: parameter name - MapValue type: - If parameter's entity - // type is a composite entity: map - Else: depending on parameter value - // type, could be one of string, number, boolean, null, list or map - - // MapValue value: - If parameter's entity type is a composite entity: - // map from composite entity property names to property values - Else: - // parameter value + // of a collection of (MapKey, MapValue) pairs: * MapKey type: string * + // MapKey value: parameter name * MapValue type: If parameter's entity + // type is a composite entity then use map, otherwise, depending on the + // parameter value type, it could be one of string, number, boolean, + // null, list or map. * MapValue value: If parameter's entity type is a + // composite entity then use map from composite entity property names to + // property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "LanguageCode") to @@ -11199,7 +11211,7 @@ func (s *GoogleCloudDialogflowV2FulfillmentGenericWebService) MarshalJSON() ([]b // for the output. type GoogleCloudDialogflowV2GcsDestination struct { // Uri: The Google Cloud Storage URIs for the output. A URI is of the - // form: gs://bucket/object-prefix-or-name Whether a prefix or name is + // form: `gs://bucket/object-prefix-or-name` Whether a prefix or name is // used depends on the use case. The requesting user must have // "write-permission" to the bucket. Uri string `json:"uri,omitempty"` @@ -11231,8 +11243,8 @@ func (s *GoogleCloudDialogflowV2GcsDestination) MarshalJSON() ([]byte, error) { // the inputs. type GoogleCloudDialogflowV2GcsSources struct { // Uris: Required. Google Cloud Storage URIs for the inputs. A URI is of - // the form: gs://bucket/object-prefix-or-name Whether a prefix or name - // is used depends on the use case. + // the form: `gs://bucket/object-prefix-or-name` Whether a prefix or + // name is used depends on the use case. Uris []string `json:"uris,omitempty"` // ForceSendFields is a list of field names (e.g. "Uris") to @@ -12457,9 +12469,9 @@ type GoogleCloudDialogflowV2InputAudioConfig struct { // Cloud Speech documentation // (https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) // for more details. This field is deprecated. Please use - // speech_contexts () instead. If you specify both phrase_hints () and - // speech_contexts (), Dialogflow will treat the phrase_hints () as a - // single additional SpeechContext (). + // `speech_contexts` () instead. If you specify both `phrase_hints` () + // and `speech_contexts` (), Dialogflow will treat the `phrase_hints` () + // as a single additional `SpeechContext` (). PhraseHints []string `json:"phraseHints,omitempty"` // SampleRateHertz: Required. Sample rate (in Hertz) of the audio @@ -15308,13 +15320,13 @@ type GoogleCloudDialogflowV2QueryResult struct { // Parameters: The collection of extracted parameters. Depending on your // protocol or client library language, this is a map, associative // array, symbol table, dictionary, or JSON object composed of a - // collection of (MapKey, MapValue) pairs: - MapKey type: string - - // MapKey value: parameter name - MapValue type: - If parameter's entity - // type is a composite entity: map - Else: depending on parameter value - // type, could be one of string, number, boolean, null, list or map - - // MapValue value: - If parameter's entity type is a composite entity: - // map from composite entity property names to property values - Else: - // parameter value + // collection of (MapKey, MapValue) pairs: * MapKey type: string * + // MapKey value: parameter name * MapValue type: If parameter's entity + // type is a composite entity then use map, otherwise, depending on the + // parameter value type, it could be one of string, number, boolean, + // null, list or map. * MapValue value: If parameter's entity type is a + // composite entity then use map from composite entity property names to + // property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // QueryText: The original conversational query text: - If natural @@ -16659,10 +16671,8 @@ func (s *GoogleCloudDialogflowV2SynthesizeSpeechConfig) UnmarshalJSON(data []byt return nil } -// GoogleCloudDialogflowV2TextInput: -// ====================================================================== -// ====== Auxiliary proto messages. Represents the natural language text -// to be processed. +// GoogleCloudDialogflowV2TextInput: Auxiliary proto messages. +// Represents the natural language text to be processed. type GoogleCloudDialogflowV2TextInput struct { // LanguageCode: Required. The language of this conversational query. // See Language Support @@ -16815,13 +16825,13 @@ type GoogleCloudDialogflowV2UndeployConversationModelRequest struct { // validation error. type GoogleCloudDialogflowV2ValidationError struct { // Entries: The names of the entries that the error is associated with. - // Format: - "projects//agent", if the error is associated with the - // entire agent. - "projects//agent/intents/", if the error is + // Format: - `projects//agent`, if the error is associated with the + // entire agent. - `projects//agent/intents/`, if the error is // associated with certain intents. - - // "projects//agent/intents//trainingPhrases/", if the error is + // `projects//agent/intents//trainingPhrases/`, if the error is // associated with certain intent training phrases. - - // "projects//agent/intents//parameters/", if the error is associated - // with certain intent parameters. - "projects//agent/entities/", if the + // `projects//agent/intents//parameters/`, if the error is associated + // with certain intent parameters. - `projects//agent/entities/`, if the // error is associated with certain entities. Entries []string `json:"entries,omitempty"` @@ -17377,7 +17387,7 @@ type GoogleCloudDialogflowV2beta1Context struct { // `projects//agent/environments//users//sessions//contexts/`, - // `projects//locations//agent/environments//users//sessions//contexts/`, // The `Context ID` is always converted to lowercase, may only contain - // characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If + // characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If // `Environment ID` is not specified, we assume default 'draft' // environment. If `User ID` is not specified, we assume default '-' // user. The following context names are reserved for internal use by @@ -17389,13 +17399,14 @@ type GoogleCloudDialogflowV2beta1Context struct { // Parameters: Optional. The collection of parameters associated with // this context. Depending on your protocol or client library language, // this is a map, associative array, symbol table, dictionary, or JSON - // object composed of a collection of (MapKey, MapValue) pairs: - MapKey - // type: string - MapKey value: parameter name - MapValue type: - If - // parameter's entity type is a composite entity: map - Else: depending - // on parameter value type, could be one of string, number, boolean, - // null, list or map - MapValue value: - If parameter's entity type is a - // composite entity: map from composite entity property names to - // property values - Else: parameter value + // object composed of a collection of (MapKey, MapValue) pairs: * MapKey + // type: string * MapKey value: parameter name * MapValue type: If + // parameter's entity type is a composite entity then use map, + // otherwise, depending on the parameter value type, it could be one of + // string, number, boolean, null, list or map. * MapValue value: If + // parameter's entity type is a composite entity then use map from + // composite entity property names to property values, otherwise, use + // parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "LifespanCount") to @@ -17657,13 +17668,13 @@ type GoogleCloudDialogflowV2beta1EventInput struct { // Parameters: The collection of parameters associated with the event. // Depending on your protocol or client library language, this is a map, // associative array, symbol table, dictionary, or JSON object composed - // of a collection of (MapKey, MapValue) pairs: - MapKey type: string - - // MapKey value: parameter name - MapValue type: - If parameter's entity - // type is a composite entity: map - Else: depending on parameter value - // type, could be one of string, number, boolean, null, list or map - - // MapValue value: - If parameter's entity type is a composite entity: - // map from composite entity property names to property values - Else: - // parameter value + // of a collection of (MapKey, MapValue) pairs: * MapKey type: string * + // MapKey value: parameter name * MapValue type: If parameter's entity + // type is a composite entity then use map, otherwise, depending on the + // parameter value type, it could be one of string, number, boolean, + // null, list or map. * MapValue value: If parameter's entity type is a + // composite entity then use map from composite entity property names to + // property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "LanguageCode") to @@ -17822,7 +17833,7 @@ func (s *GoogleCloudDialogflowV2beta1FaqAnswer) UnmarshalJSON(data []byte) error // location for the output. type GoogleCloudDialogflowV2beta1GcsDestination struct { // Uri: Required. The Google Cloud Storage URIs for the output. A URI is - // of the form: gs://bucket/object-prefix-or-name Whether a prefix or + // of the form: `gs://bucket/object-prefix-or-name` Whether a prefix or // name is used depends on the use case. The requesting user must have // "write-permission" to the bucket. Uri string `json:"uri,omitempty"` @@ -20296,13 +20307,13 @@ type GoogleCloudDialogflowV2beta1QueryResult struct { // Parameters: The collection of extracted parameters. Depending on your // protocol or client library language, this is a map, associative // array, symbol table, dictionary, or JSON object composed of a - // collection of (MapKey, MapValue) pairs: - MapKey type: string - - // MapKey value: parameter name - MapValue type: - If parameter's entity - // type is a composite entity: map - Else: depending on parameter value - // type, could be one of string, number, boolean, null, list or map - - // MapValue value: - If parameter's entity type is a composite entity: - // map from composite entity property names to property values - Else: - // parameter value + // collection of (MapKey, MapValue) pairs: * MapKey type: string * + // MapKey value: parameter name * MapValue type: If parameter's entity + // type is a composite entity then use map, otherwise, depending on the + // parameter value type, it could be one of string, number, boolean, + // null, list or map. * MapValue value: If parameter's entity type is a + // composite entity then use map from composite entity property names to + // property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // QueryText: The original conversational query text: - If natural @@ -27242,7 +27253,7 @@ type ProjectsAgentEnvironmentsUsersSessionsContextsPatchCall struct { // `projects//agent/sessions//contexts/`, or // `projects//agent/environments//users//sessions//contexts/`. The // `Context ID` is always converted to lowercase, may only contain -// characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If +// characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If // `Environment ID` is not specified, we assume default 'draft' // environment. If `User ID` is not specified, we assume default '-' // user. The following context names are reserved for internal use by @@ -27363,7 +27374,7 @@ func (c *ProjectsAgentEnvironmentsUsersSessionsContextsPatchCall) Do(opts ...goo // ], // "parameters": { // "name": { - // "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + // "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", // "location": "path", // "pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$", // "required": true, @@ -32232,7 +32243,7 @@ type ProjectsAgentSessionsContextsPatchCall struct { // `projects//agent/sessions//contexts/`, or // `projects//agent/environments//users//sessions//contexts/`. The // `Context ID` is always converted to lowercase, may only contain -// characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If +// characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If // `Environment ID` is not specified, we assume default 'draft' // environment. If `User ID` is not specified, we assume default '-' // user. The following context names are reserved for internal use by @@ -32353,7 +32364,7 @@ func (c *ProjectsAgentSessionsContextsPatchCall) Do(opts ...googleapi.CallOption // ], // "parameters": { // "name": { - // "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + // "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", // "location": "path", // "pattern": "^projects/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$", // "required": true, @@ -37427,7 +37438,7 @@ func (r *ProjectsConversationsService) Create(parentid string, googleclouddialog // Identifier of the conversation. Generally it's auto generated by // Google. Only set it if you cannot wait for the response to return a // auto-generated one to you. The conversation ID must be compliant with -// the regression fomula "a-zA-Z*" with the characters length in range +// the regression fomula `a-zA-Z*` with the characters length in range // of [3,64]. If the field is provided, the caller is resposible for 1. // the uniqueness of the ID, otherwise the request will be rejected. 2. // the consistency for whether to use custom ID or not under a project @@ -37538,7 +37549,7 @@ func (c *ProjectsConversationsCreateCall) Do(opts ...googleapi.CallOption) (*Goo // ], // "parameters": { // "conversationId": { - // "description": "Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula \"a-zA-Z*\" with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.", + // "description": "Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula `a-zA-Z*` with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.", // "location": "query", // "type": "string" // }, @@ -47588,7 +47599,7 @@ type ProjectsLocationsAgentEnvironmentsUsersSessionsContextsPatchCall struct { // `projects//agent/sessions//contexts/`, or // `projects//agent/environments//users//sessions//contexts/`. The // `Context ID` is always converted to lowercase, may only contain -// characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If +// characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If // `Environment ID` is not specified, we assume default 'draft' // environment. If `User ID` is not specified, we assume default '-' // user. The following context names are reserved for internal use by @@ -47709,7 +47720,7 @@ func (c *ProjectsLocationsAgentEnvironmentsUsersSessionsContextsPatchCall) Do(op // ], // "parameters": { // "name": { - // "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + // "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$", // "required": true, @@ -50784,7 +50795,7 @@ type ProjectsLocationsAgentSessionsContextsPatchCall struct { // `projects//agent/sessions//contexts/`, or // `projects//agent/environments//users//sessions//contexts/`. The // `Context ID` is always converted to lowercase, may only contain -// characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If +// characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If // `Environment ID` is not specified, we assume default 'draft' // environment. If `User ID` is not specified, we assume default '-' // user. The following context names are reserved for internal use by @@ -50905,7 +50916,7 @@ func (c *ProjectsLocationsAgentSessionsContextsPatchCall) Do(opts ...googleapi.C // ], // "parameters": { // "name": { - // "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + // "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$", // "required": true, @@ -56412,7 +56423,7 @@ func (r *ProjectsLocationsConversationsService) Create(parentid string, googlecl // Identifier of the conversation. Generally it's auto generated by // Google. Only set it if you cannot wait for the response to return a // auto-generated one to you. The conversation ID must be compliant with -// the regression fomula "a-zA-Z*" with the characters length in range +// the regression fomula `a-zA-Z*` with the characters length in range // of [3,64]. If the field is provided, the caller is resposible for 1. // the uniqueness of the ID, otherwise the request will be rejected. 2. // the consistency for whether to use custom ID or not under a project @@ -56523,7 +56534,7 @@ func (c *ProjectsLocationsConversationsCreateCall) Do(opts ...googleapi.CallOpti // ], // "parameters": { // "conversationId": { - // "description": "Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula \"a-zA-Z*\" with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.", + // "description": "Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula `a-zA-Z*` with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.", // "location": "query", // "type": "string" // }, diff --git a/dialogflow/v2beta1/dialogflow-api.json b/dialogflow/v2beta1/dialogflow-api.json index 36d55204dfe..3a5f4cf8899 100644 --- a/dialogflow/v2beta1/dialogflow-api.json +++ b/dialogflow/v2beta1/dialogflow-api.json @@ -1230,7 +1230,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", "location": "path", "pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -2261,7 +2261,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", "location": "path", "pattern": "^projects/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -2971,7 +2971,7 @@ ], "parameters": { "conversationId": { - "description": "Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula \"a-zA-Z*\" with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.", + "description": "Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula `a-zA-Z*` with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.", "location": "query", "type": "string" }, @@ -5085,7 +5085,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -5751,7 +5751,7 @@ ], "parameters": { "name": { - "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$", "required": true, @@ -6461,7 +6461,7 @@ ], "parameters": { "conversationId": { - "description": "Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula \"a-zA-Z*\" with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.", + "description": "Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula `a-zA-Z*` with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.", "location": "query", "type": "string" }, @@ -7579,7 +7579,7 @@ } } }, - "revision": "20230714", + "revision": "20230717", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { @@ -7983,7 +7983,7 @@ "type": "string" }, "commitSha": { - "description": "Commit SHA of the git push. This field is populated if `git_destination` are specified in ExportAgentRequest.", + "description": "Commit SHA of the git push. This field is populated if `git_destination` is specified in ExportAgentRequest.", "type": "string" } }, @@ -8676,6 +8676,22 @@ "$ref": "GoogleCloudDialogflowCxV3ResponseMessagePlayAudio", "description": "Signal that the client should play an audio clip hosted at a client-specific URI. Dialogflow uses this to construct mixed_audio. However, Dialogflow itself does not try to read or process the URI in any way." }, + "responseType": { + "description": "Response type.", + "enum": [ + "RESPONSE_TYPE_UNSPECIFIED", + "ENTRY_PROMPT", + "PARAMETER_PROMPT", + "HANDLER_PROMPT" + ], + "enumDescriptions": [ + "Not specified.", + "The response is from an entry prompt in the page.", + "The response is from form-filling prompt in the page.", + "The response is from a transition route or an event handler in the page or flow or transition route group." + ], + "type": "string" + }, "telephonyTransferCall": { "$ref": "GoogleCloudDialogflowCxV3ResponseMessageTelephonyTransferCall", "description": "A signal that the client should transfer the phone call connected to this agent to a third-party endpoint." @@ -9915,7 +9931,7 @@ "type": "string" }, "commitSha": { - "description": "Commit SHA of the git push. This field is populated if `git_destination` are specified in ExportAgentRequest.", + "description": "Commit SHA of the git push. This field is populated if `git_destination` is specified in ExportAgentRequest.", "type": "string" } }, @@ -11610,7 +11626,7 @@ "type": "integer" }, "name": { - "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", "type": "string" }, "parameters": { @@ -11618,7 +11634,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" } }, @@ -11946,7 +11962,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" } }, @@ -12019,7 +12035,7 @@ "id": "GoogleCloudDialogflowV2GcsDestination", "properties": { "uri": { - "description": "The Google Cloud Storage URIs for the output. A URI is of the form: gs://bucket/object-prefix-or-name Whether a prefix or name is used depends on the use case. The requesting user must have \"write-permission\" to the bucket.", + "description": "The Google Cloud Storage URIs for the output. A URI is of the form: `gs://bucket/object-prefix-or-name` Whether a prefix or name is used depends on the use case. The requesting user must have \"write-permission\" to the bucket.", "type": "string" } }, @@ -13221,7 +13237,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" }, "queryText": { @@ -13806,7 +13822,7 @@ "description": "An input event to send to Dialogflow." }, "messageSendTime": { - "description": "Optional. The send time of the message from end user or human agent's perspective. It is used for identifying the same message under one participant. Given two messages under the same participant: - If send time are different regardless of whether the content of the messages are exactly the same, the conversation will regard them as two distinct messages sent by the participant. - If send time is the same regardless of whether the content of the messages are exactly the same, the conversation will regard them as same message, and ignore the message received later. If the value is not provided, a new request will always be regarded as a new message without any de-duplication.", + "description": "Optional. The send time of the message from end user or human agent's perspective. It is used for identifying the same message under one participant. Given two messages under the same participant: * If send time are different regardless of whether the content of the messages are exactly the same, the conversation will regard them as two distinct messages sent by the participant. * If send time is the same regardless of whether the content of the messages are exactly the same, the conversation will regard them as same message, and ignore the message received later. If the value is not provided, a new request will always be regarded as a new message without any de-duplication.", "format": "google-datetime", "type": "string" }, @@ -14107,7 +14123,7 @@ "type": "object" }, "GoogleCloudDialogflowV2beta1BargeInConfig": { - "description": "Configuration of the barge-in behavior. Barge-in instructs the API to return a detected utterance at a proper time while the client is playing back the response audio from a previous request. When the client sees the utterance, it should stop the playback and immediately get ready for receiving the responses for the current request. The barge-in handling requires the client to start streaming audio input as soon as it starts playing back the audio from the previous response. The playback is modeled into two phases: * No barge-in phase: which goes first and during which speech detection should not be carried out. * Barge-in phase: which follows the no barge-in phase and during which the API starts speech detection and may inform the client that an utterance has been detected. Note that no-speech event is not expected in this phase. The client provides this configuration in terms of the durations of those two phases. The durations are measured in terms of the audio length fromt the the start of the input audio. The flow goes like below: --\u003e Time without speech detection | utterance only | utterance or no-speech event | | +-------------+ | +------------+ | +---------------+ ----------+ no barge-in +-|-+ barge-in +-|-+ normal period +----------- +-------------+ | +------------+ | +---------------+ No-speech event is a response with END_OF_UTTERANCE without any transcript following up.", + "description": "Configuration of the barge-in behavior. Barge-in instructs the API to return a detected utterance at a proper time while the client is playing back the response audio from a previous request. When the client sees the utterance, it should stop the playback and immediately get ready for receiving the responses for the current request. The barge-in handling requires the client to start streaming audio input as soon as it starts playing back the audio from the previous response. The playback is modeled into two phases: * No barge-in phase: which goes first and during which speech detection should not be carried out. * Barge-in phase: which follows the no barge-in phase and during which the API starts speech detection and may inform the client that an utterance has been detected. Note that no-speech event is not expected in this phase. The client provides this configuration in terms of the durations of those two phases. The durations are measured in terms of the audio length fromt the the start of the input audio. The flow goes like below: ``` --\u003e Time without speech detection | utterance only | utterance or no-speech event | | +-------------+ | +------------+ | +---------------+ ----------+ no barge-in +-|-+ barge-in +-|-+ normal period +----------- +-------------+ | +------------+ | +---------------+ ``` No-speech event is a response with END_OF_UTTERANCE without any transcript following up.", "id": "GoogleCloudDialogflowV2beta1BargeInConfig", "properties": { "noBargeInDuration": { @@ -14475,7 +14491,7 @@ "type": "integer" }, "name": { - "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", "type": "string" }, "parameters": { @@ -14483,7 +14499,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" } }, @@ -15090,7 +15106,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" } }, @@ -15254,7 +15270,7 @@ "id": "GoogleCloudDialogflowV2beta1GcsDestination", "properties": { "uri": { - "description": "Required. The Google Cloud Storage URIs for the output. A URI is of the form: gs://bucket/object-prefix-or-name Whether a prefix or name is used depends on the use case. The requesting user must have \"write-permission\" to the bucket.", + "description": "Required. The Google Cloud Storage URIs for the output. A URI is of the form: `gs://bucket/object-prefix-or-name` Whether a prefix or name is used depends on the use case. The requesting user must have \"write-permission\" to the bucket.", "type": "string" } }, @@ -15265,7 +15281,7 @@ "id": "GoogleCloudDialogflowV2beta1GcsSource", "properties": { "uri": { - "description": "Required. The Google Cloud Storage URIs for the inputs. A URI is of the form: gs://bucket/object-prefix-or-name Whether a prefix or name is used depends on the use case.", + "description": "Required. The Google Cloud Storage URIs for the inputs. A URI is of the form: `gs://bucket/object-prefix-or-name` Whether a prefix or name is used depends on the use case.", "type": "string" } }, @@ -15276,7 +15292,7 @@ "id": "GoogleCloudDialogflowV2beta1GcsSources", "properties": { "uris": { - "description": "Required. Google Cloud Storage URIs for the inputs. A URI is of the form: gs://bucket/object-prefix-or-name Whether a prefix or name is used depends on the use case.", + "description": "Required. Google Cloud Storage URIs for the inputs. A URI is of the form: `gs://bucket/object-prefix-or-name` Whether a prefix or name is used depends on the use case.", "items": { "type": "string" }, @@ -15827,7 +15843,7 @@ }, "phraseHints": { "deprecated": true, - "description": "A list of strings containing words and phrases that the speech recognizer should recognize with higher likelihood. See [the Cloud Speech documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) for more details. This field is deprecated. Please use [speech_contexts]() instead. If you specify both [phrase_hints]() and [speech_contexts](), Dialogflow will treat the [phrase_hints]() as a single additional [SpeechContext]().", + "description": "A list of strings containing words and phrases that the speech recognizer should recognize with higher likelihood. See [the Cloud Speech documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) for more details. This field is deprecated. Please use [`speech_contexts`]() instead. If you specify both [`phrase_hints`]() and [`speech_contexts`](), Dialogflow will treat the [`phrase_hints`]() as a single additional [`SpeechContext`]().", "items": { "type": "string" }, @@ -17852,7 +17868,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" }, "queryText": { @@ -18643,7 +18659,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "In Dialogflow assist for v3, the user can submit a form by sending a SuggestionInput. The form is uniquely determined by the answer_record field, which identifies a v3 QueryResult containing the current page. The form parameters are specified via the parameters field. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "In Dialogflow assist for v3, the user can submit a form by sending a SuggestionInput. The form is uniquely determined by the answer_record field, which identifies a v3 QueryResult containing the current page. The form parameters are specified via the parameters field. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" }, "textOverride": { @@ -18838,7 +18854,7 @@ "id": "GoogleCloudDialogflowV2beta1ValidationError", "properties": { "entries": { - "description": "The names of the entries that the error is associated with. Format: - \"projects//agent\", if the error is associated with the entire agent. - \"projects//agent/intents/\", if the error is associated with certain intents. - \"projects//agent/intents//trainingPhrases/\", if the error is associated with certain intent training phrases. - \"projects//agent/intents//parameters/\", if the error is associated with certain intent parameters. - \"projects//agent/entities/\", if the error is associated with certain entities.", + "description": "The names of the entries that the error is associated with. Format: - `projects//agent`, if the error is associated with the entire agent. - `projects//agent/intents/`, if the error is associated with certain intents. - `projects//agent/intents//trainingPhrases/`, if the error is associated with certain intent training phrases. - `projects//agent/intents//parameters/`, if the error is associated with certain intent parameters. - `projects//agent/entities/`, if the error is associated with certain entities.", "items": { "type": "string" }, diff --git a/dialogflow/v2beta1/dialogflow-gen.go b/dialogflow/v2beta1/dialogflow-gen.go index 728e66a185d..d3c75f41ed0 100644 --- a/dialogflow/v2beta1/dialogflow-gen.go +++ b/dialogflow/v2beta1/dialogflow-gen.go @@ -1541,7 +1541,7 @@ type GoogleCloudDialogflowCxV3ExportAgentResponse struct { AgentUri string `json:"agentUri,omitempty"` // CommitSha: Commit SHA of the git push. This field is populated if - // `git_destination` are specified in ExportAgentRequest. + // `git_destination` is specified in ExportAgentRequest. CommitSha string `json:"commitSha,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -2896,6 +2896,17 @@ type GoogleCloudDialogflowCxV3ResponseMessage struct { // any way. PlayAudio *GoogleCloudDialogflowCxV3ResponseMessagePlayAudio `json:"playAudio,omitempty"` + // ResponseType: Response type. + // + // Possible values: + // "RESPONSE_TYPE_UNSPECIFIED" - Not specified. + // "ENTRY_PROMPT" - The response is from an entry prompt in the page. + // "PARAMETER_PROMPT" - The response is from form-filling prompt in + // the page. + // "HANDLER_PROMPT" - The response is from a transition route or an + // event handler in the page or flow or transition route group. + ResponseType string `json:"responseType,omitempty"` + // TelephonyTransferCall: A signal that the client should transfer the // phone call connected to this agent to a third-party endpoint. TelephonyTransferCall *GoogleCloudDialogflowCxV3ResponseMessageTelephonyTransferCall `json:"telephonyTransferCall,omitempty"` @@ -5118,7 +5129,7 @@ type GoogleCloudDialogflowCxV3beta1ExportAgentResponse struct { AgentUri string `json:"agentUri,omitempty"` // CommitSha: Commit SHA of the git push. This field is populated if - // `git_destination` are specified in ExportAgentRequest. + // `git_destination` is specified in ExportAgentRequest. CommitSha string `json:"commitSha,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -8233,7 +8244,7 @@ type GoogleCloudDialogflowV2Context struct { // `projects//agent/sessions//contexts/`, or // `projects//agent/environments//users//sessions//contexts/`. The // `Context ID` is always converted to lowercase, may only contain - // characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If + // characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If // `Environment ID` is not specified, we assume default 'draft' // environment. If `User ID` is not specified, we assume default '-' // user. The following context names are reserved for internal use by @@ -8245,13 +8256,14 @@ type GoogleCloudDialogflowV2Context struct { // Parameters: Optional. The collection of parameters associated with // this context. Depending on your protocol or client library language, // this is a map, associative array, symbol table, dictionary, or JSON - // object composed of a collection of (MapKey, MapValue) pairs: - MapKey - // type: string - MapKey value: parameter name - MapValue type: - If - // parameter's entity type is a composite entity: map - Else: depending - // on parameter value type, could be one of string, number, boolean, - // null, list or map - MapValue value: - If parameter's entity type is a - // composite entity: map from composite entity property names to - // property values - Else: parameter value + // object composed of a collection of (MapKey, MapValue) pairs: * MapKey + // type: string * MapKey value: parameter name * MapValue type: If + // parameter's entity type is a composite entity then use map, + // otherwise, depending on the parameter value type, it could be one of + // string, number, boolean, null, list or map. * MapValue value: If + // parameter's entity type is a composite entity then use map from + // composite entity property names to property values, otherwise, use + // parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "LifespanCount") to @@ -8756,13 +8768,13 @@ type GoogleCloudDialogflowV2EventInput struct { // Parameters: The collection of parameters associated with the event. // Depending on your protocol or client library language, this is a map, // associative array, symbol table, dictionary, or JSON object composed - // of a collection of (MapKey, MapValue) pairs: - MapKey type: string - - // MapKey value: parameter name - MapValue type: - If parameter's entity - // type is a composite entity: map - Else: depending on parameter value - // type, could be one of string, number, boolean, null, list or map - - // MapValue value: - If parameter's entity type is a composite entity: - // map from composite entity property names to property values - Else: - // parameter value + // of a collection of (MapKey, MapValue) pairs: * MapKey type: string * + // MapKey value: parameter name * MapValue type: If parameter's entity + // type is a composite entity then use map, otherwise, depending on the + // parameter value type, it could be one of string, number, boolean, + // null, list or map. * MapValue value: If parameter's entity type is a + // composite entity then use map from composite entity property names to + // property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "LanguageCode") to @@ -8921,7 +8933,7 @@ func (s *GoogleCloudDialogflowV2FaqAnswer) UnmarshalJSON(data []byte) error { // for the output. type GoogleCloudDialogflowV2GcsDestination struct { // Uri: The Google Cloud Storage URIs for the output. A URI is of the - // form: gs://bucket/object-prefix-or-name Whether a prefix or name is + // form: `gs://bucket/object-prefix-or-name` Whether a prefix or name is // used depends on the use case. The requesting user must have // "write-permission" to the bucket. Uri string `json:"uri,omitempty"` @@ -10796,13 +10808,13 @@ type GoogleCloudDialogflowV2QueryResult struct { // Parameters: The collection of extracted parameters. Depending on your // protocol or client library language, this is a map, associative // array, symbol table, dictionary, or JSON object composed of a - // collection of (MapKey, MapValue) pairs: - MapKey type: string - - // MapKey value: parameter name - MapValue type: - If parameter's entity - // type is a composite entity: map - Else: depending on parameter value - // type, could be one of string, number, boolean, null, list or map - - // MapValue value: - If parameter's entity type is a composite entity: - // map from composite entity property names to property values - Else: - // parameter value + // collection of (MapKey, MapValue) pairs: * MapKey type: string * + // MapKey value: parameter name * MapValue type: If parameter's entity + // type is a composite entity then use map, otherwise, depending on the + // parameter value type, it could be one of string, number, boolean, + // null, list or map. * MapValue value: If parameter's entity type is a + // composite entity then use map from composite entity property names to + // property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // QueryText: The original conversational query text: - If natural @@ -11824,9 +11836,9 @@ type GoogleCloudDialogflowV2beta1AnalyzeContentRequest struct { // MessageSendTime: Optional. The send time of the message from end user // or human agent's perspective. It is used for identifying the same // message under one participant. Given two messages under the same - // participant: - If send time are different regardless of whether the + // participant: * If send time are different regardless of whether the // content of the messages are exactly the same, the conversation will - // regard them as two distinct messages sent by the participant. - If + // regard them as two distinct messages sent by the participant. * If // send time is the same regardless of whether the content of the // messages are exactly the same, the conversation will regard them as // same message, and ignore the message received later. If the value is @@ -12397,13 +12409,13 @@ func (s *GoogleCloudDialogflowV2beta1AutomatedAgentReply) UnmarshalJSON(data []b // expected in this phase. The client provides this configuration in // terms of the durations of those two phases. The durations are // measured in terms of the audio length fromt the the start of the -// input audio. The flow goes like below: --> Time without speech +// input audio. The flow goes like below: ``` --> Time without speech // detection | utterance only | utterance or no-speech event | | // +-------------+ | +------------+ | +---------------+ ----------+ no // barge-in +-|-+ barge-in +-|-+ normal period +----------- -// +-------------+ | +------------+ | +---------------+ No-speech event -// is a response with END_OF_UTTERANCE without any transcript following -// up. +// +-------------+ | +------------+ | +---------------+ ``` No-speech +// event is a response with END_OF_UTTERANCE without any transcript +// following up. type GoogleCloudDialogflowV2beta1BargeInConfig struct { // NoBargeInDuration: Duration that is not eligible for barge-in at the // beginning of the input audio. @@ -13059,7 +13071,7 @@ type GoogleCloudDialogflowV2beta1Context struct { // `projects//agent/environments//users//sessions//contexts/`, - // `projects//locations//agent/environments//users//sessions//contexts/`, // The `Context ID` is always converted to lowercase, may only contain - // characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If + // characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If // `Environment ID` is not specified, we assume default 'draft' // environment. If `User ID` is not specified, we assume default '-' // user. The following context names are reserved for internal use by @@ -13071,13 +13083,14 @@ type GoogleCloudDialogflowV2beta1Context struct { // Parameters: Optional. The collection of parameters associated with // this context. Depending on your protocol or client library language, // this is a map, associative array, symbol table, dictionary, or JSON - // object composed of a collection of (MapKey, MapValue) pairs: - MapKey - // type: string - MapKey value: parameter name - MapValue type: - If - // parameter's entity type is a composite entity: map - Else: depending - // on parameter value type, could be one of string, number, boolean, - // null, list or map - MapValue value: - If parameter's entity type is a - // composite entity: map from composite entity property names to - // property values - Else: parameter value + // object composed of a collection of (MapKey, MapValue) pairs: * MapKey + // type: string * MapKey value: parameter name * MapValue type: If + // parameter's entity type is a composite entity then use map, + // otherwise, depending on the parameter value type, it could be one of + // string, number, boolean, null, list or map. * MapValue value: If + // parameter's entity type is a composite entity then use map from + // composite entity property names to property values, otherwise, use + // parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -14086,13 +14099,13 @@ type GoogleCloudDialogflowV2beta1EventInput struct { // Parameters: The collection of parameters associated with the event. // Depending on your protocol or client library language, this is a map, // associative array, symbol table, dictionary, or JSON object composed - // of a collection of (MapKey, MapValue) pairs: - MapKey type: string - - // MapKey value: parameter name - MapValue type: - If parameter's entity - // type is a composite entity: map - Else: depending on parameter value - // type, could be one of string, number, boolean, null, list or map - - // MapValue value: - If parameter's entity type is a composite entity: - // map from composite entity property names to property values - Else: - // parameter value + // of a collection of (MapKey, MapValue) pairs: * MapKey type: string * + // MapKey value: parameter name * MapValue type: If parameter's entity + // type is a composite entity then use map, otherwise, depending on the + // parameter value type, it could be one of string, number, boolean, + // null, list or map. * MapValue value: If parameter's entity type is a + // composite entity then use map from composite entity property names to + // property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "LanguageCode") to @@ -14430,7 +14443,7 @@ func (s *GoogleCloudDialogflowV2beta1FulfillmentGenericWebService) MarshalJSON() // location for the output. type GoogleCloudDialogflowV2beta1GcsDestination struct { // Uri: Required. The Google Cloud Storage URIs for the output. A URI is - // of the form: gs://bucket/object-prefix-or-name Whether a prefix or + // of the form: `gs://bucket/object-prefix-or-name` Whether a prefix or // name is used depends on the use case. The requesting user must have // "write-permission" to the bucket. Uri string `json:"uri,omitempty"` @@ -14462,7 +14475,7 @@ func (s *GoogleCloudDialogflowV2beta1GcsDestination) MarshalJSON() ([]byte, erro // for single input. type GoogleCloudDialogflowV2beta1GcsSource struct { // Uri: Required. The Google Cloud Storage URIs for the inputs. A URI is - // of the form: gs://bucket/object-prefix-or-name Whether a prefix or + // of the form: `gs://bucket/object-prefix-or-name` Whether a prefix or // name is used depends on the use case. Uri string `json:"uri,omitempty"` @@ -14493,8 +14506,8 @@ func (s *GoogleCloudDialogflowV2beta1GcsSource) MarshalJSON() ([]byte, error) { // locations for the inputs. type GoogleCloudDialogflowV2beta1GcsSources struct { // Uris: Required. Google Cloud Storage URIs for the inputs. A URI is of - // the form: gs://bucket/object-prefix-or-name Whether a prefix or name - // is used depends on the use case. + // the form: `gs://bucket/object-prefix-or-name` Whether a prefix or + // name is used depends on the use case. Uris []string `json:"uris,omitempty"` // ForceSendFields is a list of field names (e.g. "Uris") to @@ -15659,9 +15672,9 @@ type GoogleCloudDialogflowV2beta1InputAudioConfig struct { // Cloud Speech documentation // (https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) // for more details. This field is deprecated. Please use - // speech_contexts () instead. If you specify both phrase_hints () and - // speech_contexts (), Dialogflow will treat the phrase_hints () as a - // single additional SpeechContext (). + // `speech_contexts` () instead. If you specify both `phrase_hints` () + // and `speech_contexts` (), Dialogflow will treat the `phrase_hints` () + // as a single additional `SpeechContext` (). PhraseHints []string `json:"phraseHints,omitempty"` // SampleRateHertz: Required. Sample rate (in Hertz) of the audio @@ -19120,13 +19133,13 @@ type GoogleCloudDialogflowV2beta1QueryResult struct { // Parameters: The collection of extracted parameters. Depending on your // protocol or client library language, this is a map, associative // array, symbol table, dictionary, or JSON object composed of a - // collection of (MapKey, MapValue) pairs: - MapKey type: string - - // MapKey value: parameter name - MapValue type: - If parameter's entity - // type is a composite entity: map - Else: depending on parameter value - // type, could be one of string, number, boolean, null, list or map - - // MapValue value: - If parameter's entity type is a composite entity: - // map from composite entity property names to property values - Else: - // parameter value + // collection of (MapKey, MapValue) pairs: * MapKey type: string * + // MapKey value: parameter name * MapValue type: If parameter's entity + // type is a composite entity then use map, otherwise, depending on the + // parameter value type, it could be one of string, number, boolean, + // null, list or map. * MapValue value: If parameter's entity type is a + // composite entity then use map from composite entity property names to + // property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // QueryText: The original conversational query text: - If natural @@ -20693,13 +20706,13 @@ type GoogleCloudDialogflowV2beta1SuggestionInput struct { // current page. The form parameters are specified via the parameters // field. Depending on your protocol or client library language, this is // a map, associative array, symbol table, dictionary, or JSON object - // composed of a collection of (MapKey, MapValue) pairs: - MapKey type: - // string - MapKey value: parameter name - MapValue type: - If - // parameter's entity type is a composite entity: map - Else: depending - // on parameter value type, could be one of string, number, boolean, - // null, list or map - MapValue value: - If parameter's entity type is a - // composite entity: map from composite entity property names to - // property values - Else: parameter value + // composed of a collection of (MapKey, MapValue) pairs: * MapKey type: + // string * MapKey value: parameter name * MapValue type: If parameter's + // entity type is a composite entity then use map, otherwise, depending + // on the parameter value type, it could be one of string, number, + // boolean, null, list or map. * MapValue value: If parameter's entity + // type is a composite entity then use map from composite entity + // property names to property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // TextOverride: Optional. If the customer edited the suggestion before @@ -21019,13 +21032,13 @@ type GoogleCloudDialogflowV2beta1TrainAgentRequest struct { // validation error. type GoogleCloudDialogflowV2beta1ValidationError struct { // Entries: The names of the entries that the error is associated with. - // Format: - "projects//agent", if the error is associated with the - // entire agent. - "projects//agent/intents/", if the error is + // Format: - `projects//agent`, if the error is associated with the + // entire agent. - `projects//agent/intents/`, if the error is // associated with certain intents. - - // "projects//agent/intents//trainingPhrases/", if the error is + // `projects//agent/intents//trainingPhrases/`, if the error is // associated with certain intent training phrases. - - // "projects//agent/intents//parameters/", if the error is associated - // with certain intent parameters. - "projects//agent/entities/", if the + // `projects//agent/intents//parameters/`, if the error is associated + // with certain intent parameters. - `projects//agent/entities/`, if the // error is associated with certain entities. Entries []string `json:"entries,omitempty"` @@ -27623,7 +27636,7 @@ type ProjectsAgentEnvironmentsUsersSessionsContextsPatchCall struct { // `projects//agent/environments//users//sessions//contexts/`, - // `projects//locations//agent/environments//users//sessions//contexts/ // `, The `Context ID` is always converted to lowercase, may only -// contain characters in a-zA-Z0-9_-% and may be at most 250 bytes +// contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes // long. If `Environment ID` is not specified, we assume default // 'draft' environment. If `User ID` is not specified, we assume // default '-' user. The following context names are reserved for @@ -27745,7 +27758,7 @@ func (c *ProjectsAgentEnvironmentsUsersSessionsContextsPatchCall) Do(opts ...goo // ], // "parameters": { // "name": { - // "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + // "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", // "location": "path", // "pattern": "^projects/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$", // "required": true, @@ -32709,7 +32722,7 @@ type ProjectsAgentSessionsContextsPatchCall struct { // `projects//agent/environments//users//sessions//contexts/`, - // `projects//locations//agent/environments//users//sessions//contexts/ // `, The `Context ID` is always converted to lowercase, may only -// contain characters in a-zA-Z0-9_-% and may be at most 250 bytes +// contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes // long. If `Environment ID` is not specified, we assume default // 'draft' environment. If `User ID` is not specified, we assume // default '-' user. The following context names are reserved for @@ -32831,7 +32844,7 @@ func (c *ProjectsAgentSessionsContextsPatchCall) Do(opts ...googleapi.CallOption // ], // "parameters": { // "name": { - // "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + // "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", // "location": "path", // "pattern": "^projects/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$", // "required": true, @@ -36300,7 +36313,7 @@ func (r *ProjectsConversationsService) Create(parentid string, googleclouddialog // Identifier of the conversation. Generally it's auto generated by // Google. Only set it if you cannot wait for the response to return a // auto-generated one to you. The conversation ID must be compliant with -// the regression fomula "a-zA-Z*" with the characters length in range +// the regression fomula `a-zA-Z*` with the characters length in range // of [3,64]. If the field is provided, the caller is resposible for 1. // the uniqueness of the ID, otherwise the request will be rejected. 2. // the consistency for whether to use custom ID or not under a project @@ -36412,7 +36425,7 @@ func (c *ProjectsConversationsCreateCall) Do(opts ...googleapi.CallOption) (*Goo // ], // "parameters": { // "conversationId": { - // "description": "Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula \"a-zA-Z*\" with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.", + // "description": "Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula `a-zA-Z*` with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.", // "location": "query", // "type": "string" // }, @@ -46918,7 +46931,7 @@ type ProjectsLocationsAgentEnvironmentsUsersSessionsContextsPatchCall struct { // `projects//agent/environments//users//sessions//contexts/`, - // `projects//locations//agent/environments//users//sessions//contexts/ // `, The `Context ID` is always converted to lowercase, may only -// contain characters in a-zA-Z0-9_-% and may be at most 250 bytes +// contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes // long. If `Environment ID` is not specified, we assume default // 'draft' environment. If `User ID` is not specified, we assume // default '-' user. The following context names are reserved for @@ -47040,7 +47053,7 @@ func (c *ProjectsLocationsAgentEnvironmentsUsersSessionsContextsPatchCall) Do(op // ], // "parameters": { // "name": { - // "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + // "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/agent/environments/[^/]+/users/[^/]+/sessions/[^/]+/contexts/[^/]+$", // "required": true, @@ -50169,7 +50182,7 @@ type ProjectsLocationsAgentSessionsContextsPatchCall struct { // `projects//agent/environments//users//sessions//contexts/`, - // `projects//locations//agent/environments//users//sessions//contexts/ // `, The `Context ID` is always converted to lowercase, may only -// contain characters in a-zA-Z0-9_-% and may be at most 250 bytes +// contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes // long. If `Environment ID` is not specified, we assume default // 'draft' environment. If `User ID` is not specified, we assume // default '-' user. The following context names are reserved for @@ -50291,7 +50304,7 @@ func (c *ProjectsLocationsAgentSessionsContextsPatchCall) Do(opts ...googleapi.C // ], // "parameters": { // "name": { - // "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + // "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/agent/sessions/[^/]+/contexts/[^/]+$", // "required": true, @@ -53760,7 +53773,7 @@ func (r *ProjectsLocationsConversationsService) Create(parentid string, googlecl // Identifier of the conversation. Generally it's auto generated by // Google. Only set it if you cannot wait for the response to return a // auto-generated one to you. The conversation ID must be compliant with -// the regression fomula "a-zA-Z*" with the characters length in range +// the regression fomula `a-zA-Z*` with the characters length in range // of [3,64]. If the field is provided, the caller is resposible for 1. // the uniqueness of the ID, otherwise the request will be rejected. 2. // the consistency for whether to use custom ID or not under a project @@ -53872,7 +53885,7 @@ func (c *ProjectsLocationsConversationsCreateCall) Do(opts ...googleapi.CallOpti // ], // "parameters": { // "conversationId": { - // "description": "Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula \"a-zA-Z*\" with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.", + // "description": "Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula `a-zA-Z*` with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.", // "location": "query", // "type": "string" // }, diff --git a/dialogflow/v3/dialogflow-api.json b/dialogflow/v3/dialogflow-api.json index 6eef6919583..e0d383c310a 100644 --- a/dialogflow/v3/dialogflow-api.json +++ b/dialogflow/v3/dialogflow-api.json @@ -3820,7 +3820,7 @@ } } }, - "revision": "20230714", + "revision": "20230717", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -3963,7 +3963,7 @@ "type": "string" }, "trackingBranch": { - "description": "The branch of GitHub repository tracked for this agent.", + "description": "The branch of the GitHub repository tracked for this agent.", "type": "string" } }, @@ -5025,7 +5025,7 @@ "type": "string" }, "commitSha": { - "description": "Commit SHA of the git push. This field is populated if `git_destination` are specified in ExportAgentRequest.", + "description": "Commit SHA of the git push. This field is populated if `git_destination` is specified in ExportAgentRequest.", "type": "string" } }, @@ -6664,6 +6664,22 @@ "$ref": "GoogleCloudDialogflowCxV3ResponseMessagePlayAudio", "description": "Signal that the client should play an audio clip hosted at a client-specific URI. Dialogflow uses this to construct mixed_audio. However, Dialogflow itself does not try to read or process the URI in any way." }, + "responseType": { + "description": "Response type.", + "enum": [ + "RESPONSE_TYPE_UNSPECIFIED", + "ENTRY_PROMPT", + "PARAMETER_PROMPT", + "HANDLER_PROMPT" + ], + "enumDescriptions": [ + "Not specified.", + "The response is from an entry prompt in the page.", + "The response is from form-filling prompt in the page.", + "The response is from a transition route or an event handler in the page or flow or transition route group." + ], + "type": "string" + }, "telephonyTransferCall": { "$ref": "GoogleCloudDialogflowCxV3ResponseMessageTelephonyTransferCall", "description": "A signal that the client should transfer the phone call connected to this agent to a third-party endpoint." @@ -8644,7 +8660,7 @@ "type": "string" }, "commitSha": { - "description": "Commit SHA of the git push. This field is populated if `git_destination` are specified in ExportAgentRequest.", + "description": "Commit SHA of the git push. This field is populated if `git_destination` is specified in ExportAgentRequest.", "type": "string" } }, @@ -10339,7 +10355,7 @@ "type": "integer" }, "name": { - "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", "type": "string" }, "parameters": { @@ -10347,7 +10363,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" } }, @@ -10675,7 +10691,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" } }, @@ -10748,7 +10764,7 @@ "id": "GoogleCloudDialogflowV2GcsDestination", "properties": { "uri": { - "description": "The Google Cloud Storage URIs for the output. A URI is of the form: gs://bucket/object-prefix-or-name Whether a prefix or name is used depends on the use case. The requesting user must have \"write-permission\" to the bucket.", + "description": "The Google Cloud Storage URIs for the output. A URI is of the form: `gs://bucket/object-prefix-or-name` Whether a prefix or name is used depends on the use case. The requesting user must have \"write-permission\" to the bucket.", "type": "string" } }, @@ -11950,7 +11966,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" }, "queryText": { @@ -12452,7 +12468,7 @@ "type": "integer" }, "name": { - "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", "type": "string" }, "parameters": { @@ -12460,7 +12476,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" } }, @@ -12613,7 +12629,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" } }, @@ -12686,7 +12702,7 @@ "id": "GoogleCloudDialogflowV2beta1GcsDestination", "properties": { "uri": { - "description": "Required. The Google Cloud Storage URIs for the output. A URI is of the form: gs://bucket/object-prefix-or-name Whether a prefix or name is used depends on the use case. The requesting user must have \"write-permission\" to the bucket.", + "description": "Required. The Google Cloud Storage URIs for the output. A URI is of the form: `gs://bucket/object-prefix-or-name` Whether a prefix or name is used depends on the use case. The requesting user must have \"write-permission\" to the bucket.", "type": "string" } }, @@ -14212,7 +14228,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" }, "queryText": { diff --git a/dialogflow/v3/dialogflow-gen.go b/dialogflow/v3/dialogflow-gen.go index 44e64fcc0b2..513e54a1825 100644 --- a/dialogflow/v3/dialogflow-gen.go +++ b/dialogflow/v3/dialogflow-gen.go @@ -671,7 +671,7 @@ type GoogleCloudDialogflowCxV3AgentGitIntegrationSettingsGithubSettings struct { // RepositoryUri: The GitHub repository URI related to the agent. RepositoryUri string `json:"repositoryUri,omitempty"` - // TrackingBranch: The branch of GitHub repository tracked for this + // TrackingBranch: The branch of the GitHub repository tracked for this // agent. TrackingBranch string `json:"trackingBranch,omitempty"` @@ -2576,7 +2576,7 @@ type GoogleCloudDialogflowCxV3ExportAgentResponse struct { AgentUri string `json:"agentUri,omitempty"` // CommitSha: Commit SHA of the git push. This field is populated if - // `git_destination` are specified in ExportAgentRequest. + // `git_destination` is specified in ExportAgentRequest. CommitSha string `json:"commitSha,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -5766,6 +5766,17 @@ type GoogleCloudDialogflowCxV3ResponseMessage struct { // any way. PlayAudio *GoogleCloudDialogflowCxV3ResponseMessagePlayAudio `json:"playAudio,omitempty"` + // ResponseType: Response type. + // + // Possible values: + // "RESPONSE_TYPE_UNSPECIFIED" - Not specified. + // "ENTRY_PROMPT" - The response is from an entry prompt in the page. + // "PARAMETER_PROMPT" - The response is from form-filling prompt in + // the page. + // "HANDLER_PROMPT" - The response is from a transition route or an + // event handler in the page or flow or transition route group. + ResponseType string `json:"responseType,omitempty"` + // TelephonyTransferCall: A signal that the client should transfer the // phone call connected to this agent to a third-party endpoint. TelephonyTransferCall *GoogleCloudDialogflowCxV3ResponseMessageTelephonyTransferCall `json:"telephonyTransferCall,omitempty"` @@ -9382,7 +9393,7 @@ type GoogleCloudDialogflowCxV3beta1ExportAgentResponse struct { AgentUri string `json:"agentUri,omitempty"` // CommitSha: Commit SHA of the git push. This field is populated if - // `git_destination` are specified in ExportAgentRequest. + // `git_destination` is specified in ExportAgentRequest. CommitSha string `json:"commitSha,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -12497,7 +12508,7 @@ type GoogleCloudDialogflowV2Context struct { // `projects//agent/sessions//contexts/`, or // `projects//agent/environments//users//sessions//contexts/`. The // `Context ID` is always converted to lowercase, may only contain - // characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If + // characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If // `Environment ID` is not specified, we assume default 'draft' // environment. If `User ID` is not specified, we assume default '-' // user. The following context names are reserved for internal use by @@ -12509,13 +12520,14 @@ type GoogleCloudDialogflowV2Context struct { // Parameters: Optional. The collection of parameters associated with // this context. Depending on your protocol or client library language, // this is a map, associative array, symbol table, dictionary, or JSON - // object composed of a collection of (MapKey, MapValue) pairs: - MapKey - // type: string - MapKey value: parameter name - MapValue type: - If - // parameter's entity type is a composite entity: map - Else: depending - // on parameter value type, could be one of string, number, boolean, - // null, list or map - MapValue value: - If parameter's entity type is a - // composite entity: map from composite entity property names to - // property values - Else: parameter value + // object composed of a collection of (MapKey, MapValue) pairs: * MapKey + // type: string * MapKey value: parameter name * MapValue type: If + // parameter's entity type is a composite entity then use map, + // otherwise, depending on the parameter value type, it could be one of + // string, number, boolean, null, list or map. * MapValue value: If + // parameter's entity type is a composite entity then use map from + // composite entity property names to property values, otherwise, use + // parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "LifespanCount") to @@ -13020,13 +13032,13 @@ type GoogleCloudDialogflowV2EventInput struct { // Parameters: The collection of parameters associated with the event. // Depending on your protocol or client library language, this is a map, // associative array, symbol table, dictionary, or JSON object composed - // of a collection of (MapKey, MapValue) pairs: - MapKey type: string - - // MapKey value: parameter name - MapValue type: - If parameter's entity - // type is a composite entity: map - Else: depending on parameter value - // type, could be one of string, number, boolean, null, list or map - - // MapValue value: - If parameter's entity type is a composite entity: - // map from composite entity property names to property values - Else: - // parameter value + // of a collection of (MapKey, MapValue) pairs: * MapKey type: string * + // MapKey value: parameter name * MapValue type: If parameter's entity + // type is a composite entity then use map, otherwise, depending on the + // parameter value type, it could be one of string, number, boolean, + // null, list or map. * MapValue value: If parameter's entity type is a + // composite entity then use map from composite entity property names to + // property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "LanguageCode") to @@ -13185,7 +13197,7 @@ func (s *GoogleCloudDialogflowV2FaqAnswer) UnmarshalJSON(data []byte) error { // for the output. type GoogleCloudDialogflowV2GcsDestination struct { // Uri: The Google Cloud Storage URIs for the output. A URI is of the - // form: gs://bucket/object-prefix-or-name Whether a prefix or name is + // form: `gs://bucket/object-prefix-or-name` Whether a prefix or name is // used depends on the use case. The requesting user must have // "write-permission" to the bucket. Uri string `json:"uri,omitempty"` @@ -15060,13 +15072,13 @@ type GoogleCloudDialogflowV2QueryResult struct { // Parameters: The collection of extracted parameters. Depending on your // protocol or client library language, this is a map, associative // array, symbol table, dictionary, or JSON object composed of a - // collection of (MapKey, MapValue) pairs: - MapKey type: string - - // MapKey value: parameter name - MapValue type: - If parameter's entity - // type is a composite entity: map - Else: depending on parameter value - // type, could be one of string, number, boolean, null, list or map - - // MapValue value: - If parameter's entity type is a composite entity: - // map from composite entity property names to property values - Else: - // parameter value + // collection of (MapKey, MapValue) pairs: * MapKey type: string * + // MapKey value: parameter name * MapValue type: If parameter's entity + // type is a composite entity then use map, otherwise, depending on the + // parameter value type, it could be one of string, number, boolean, + // null, list or map. * MapValue value: If parameter's entity type is a + // composite entity then use map from composite entity property names to + // property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // QueryText: The original conversational query text: - If natural @@ -16013,7 +16025,7 @@ type GoogleCloudDialogflowV2beta1Context struct { // `projects//agent/environments//users//sessions//contexts/`, - // `projects//locations//agent/environments//users//sessions//contexts/`, // The `Context ID` is always converted to lowercase, may only contain - // characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If + // characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If // `Environment ID` is not specified, we assume default 'draft' // environment. If `User ID` is not specified, we assume default '-' // user. The following context names are reserved for internal use by @@ -16025,13 +16037,14 @@ type GoogleCloudDialogflowV2beta1Context struct { // Parameters: Optional. The collection of parameters associated with // this context. Depending on your protocol or client library language, // this is a map, associative array, symbol table, dictionary, or JSON - // object composed of a collection of (MapKey, MapValue) pairs: - MapKey - // type: string - MapKey value: parameter name - MapValue type: - If - // parameter's entity type is a composite entity: map - Else: depending - // on parameter value type, could be one of string, number, boolean, - // null, list or map - MapValue value: - If parameter's entity type is a - // composite entity: map from composite entity property names to - // property values - Else: parameter value + // object composed of a collection of (MapKey, MapValue) pairs: * MapKey + // type: string * MapKey value: parameter name * MapValue type: If + // parameter's entity type is a composite entity then use map, + // otherwise, depending on the parameter value type, it could be one of + // string, number, boolean, null, list or map. * MapValue value: If + // parameter's entity type is a composite entity then use map from + // composite entity property names to property values, otherwise, use + // parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "LifespanCount") to @@ -16293,13 +16306,13 @@ type GoogleCloudDialogflowV2beta1EventInput struct { // Parameters: The collection of parameters associated with the event. // Depending on your protocol or client library language, this is a map, // associative array, symbol table, dictionary, or JSON object composed - // of a collection of (MapKey, MapValue) pairs: - MapKey type: string - - // MapKey value: parameter name - MapValue type: - If parameter's entity - // type is a composite entity: map - Else: depending on parameter value - // type, could be one of string, number, boolean, null, list or map - - // MapValue value: - If parameter's entity type is a composite entity: - // map from composite entity property names to property values - Else: - // parameter value + // of a collection of (MapKey, MapValue) pairs: * MapKey type: string * + // MapKey value: parameter name * MapValue type: If parameter's entity + // type is a composite entity then use map, otherwise, depending on the + // parameter value type, it could be one of string, number, boolean, + // null, list or map. * MapValue value: If parameter's entity type is a + // composite entity then use map from composite entity property names to + // property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "LanguageCode") to @@ -16458,7 +16471,7 @@ func (s *GoogleCloudDialogflowV2beta1FaqAnswer) UnmarshalJSON(data []byte) error // location for the output. type GoogleCloudDialogflowV2beta1GcsDestination struct { // Uri: Required. The Google Cloud Storage URIs for the output. A URI is - // of the form: gs://bucket/object-prefix-or-name Whether a prefix or + // of the form: `gs://bucket/object-prefix-or-name` Whether a prefix or // name is used depends on the use case. The requesting user must have // "write-permission" to the bucket. Uri string `json:"uri,omitempty"` @@ -18932,13 +18945,13 @@ type GoogleCloudDialogflowV2beta1QueryResult struct { // Parameters: The collection of extracted parameters. Depending on your // protocol or client library language, this is a map, associative // array, symbol table, dictionary, or JSON object composed of a - // collection of (MapKey, MapValue) pairs: - MapKey type: string - - // MapKey value: parameter name - MapValue type: - If parameter's entity - // type is a composite entity: map - Else: depending on parameter value - // type, could be one of string, number, boolean, null, list or map - - // MapValue value: - If parameter's entity type is a composite entity: - // map from composite entity property names to property values - Else: - // parameter value + // collection of (MapKey, MapValue) pairs: * MapKey type: string * + // MapKey value: parameter name * MapValue type: If parameter's entity + // type is a composite entity then use map, otherwise, depending on the + // parameter value type, it could be one of string, number, boolean, + // null, list or map. * MapValue value: If parameter's entity type is a + // composite entity then use map from composite entity property names to + // property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // QueryText: The original conversational query text: - If natural diff --git a/dialogflow/v3beta1/dialogflow-api.json b/dialogflow/v3beta1/dialogflow-api.json index 40f602e617f..b2d8bb31012 100644 --- a/dialogflow/v3beta1/dialogflow-api.json +++ b/dialogflow/v3beta1/dialogflow-api.json @@ -3820,7 +3820,7 @@ } } }, - "revision": "20230705", + "revision": "20230717", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { @@ -4224,7 +4224,7 @@ "type": "string" }, "commitSha": { - "description": "Commit SHA of the git push. This field is populated if `git_destination` are specified in ExportAgentRequest.", + "description": "Commit SHA of the git push. This field is populated if `git_destination` is specified in ExportAgentRequest.", "type": "string" } }, @@ -4917,6 +4917,22 @@ "$ref": "GoogleCloudDialogflowCxV3ResponseMessagePlayAudio", "description": "Signal that the client should play an audio clip hosted at a client-specific URI. Dialogflow uses this to construct mixed_audio. However, Dialogflow itself does not try to read or process the URI in any way." }, + "responseType": { + "description": "Response type.", + "enum": [ + "RESPONSE_TYPE_UNSPECIFIED", + "ENTRY_PROMPT", + "PARAMETER_PROMPT", + "HANDLER_PROMPT" + ], + "enumDescriptions": [ + "Not specified.", + "The response is from an entry prompt in the page.", + "The response is from form-filling prompt in the page.", + "The response is from a transition route or an event handler in the page or flow or transition route group." + ], + "type": "string" + }, "telephonyTransferCall": { "$ref": "GoogleCloudDialogflowCxV3ResponseMessageTelephonyTransferCall", "description": "A signal that the client should transfer the phone call connected to this agent to a third-party endpoint." @@ -5895,7 +5911,7 @@ "type": "string" }, "trackingBranch": { - "description": "The branch of GitHub repository tracked for this agent.", + "description": "The branch of the GitHub repository tracked for this agent.", "type": "string" } }, @@ -6957,7 +6973,7 @@ "type": "string" }, "commitSha": { - "description": "Commit SHA of the git push. This field is populated if `git_destination` are specified in ExportAgentRequest.", + "description": "Commit SHA of the git push. This field is populated if `git_destination` is specified in ExportAgentRequest.", "type": "string" } }, @@ -10339,7 +10355,7 @@ "type": "integer" }, "name": { - "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + "description": "Required. The unique identifier of the context. Format: `projects//agent/sessions//contexts/`, or `projects//agent/environments//users//sessions//contexts/`. The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", "type": "string" }, "parameters": { @@ -10347,7 +10363,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" } }, @@ -10675,7 +10691,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" } }, @@ -10748,7 +10764,7 @@ "id": "GoogleCloudDialogflowV2GcsDestination", "properties": { "uri": { - "description": "The Google Cloud Storage URIs for the output. A URI is of the form: gs://bucket/object-prefix-or-name Whether a prefix or name is used depends on the use case. The requesting user must have \"write-permission\" to the bucket.", + "description": "The Google Cloud Storage URIs for the output. A URI is of the form: `gs://bucket/object-prefix-or-name` Whether a prefix or name is used depends on the use case. The requesting user must have \"write-permission\" to the bucket.", "type": "string" } }, @@ -11950,7 +11966,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" }, "queryText": { @@ -12452,7 +12468,7 @@ "type": "integer" }, "name": { - "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", + "description": "Required. The unique identifier of the context. Supported formats: - `projects//agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `projects//agent/environments//users//sessions//contexts/`, - `projects//locations//agent/environments//users//sessions//contexts/`, The `Context ID` is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. The following context names are reserved for internal use by Dialogflow. You should not use these contexts or create contexts with these names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`", "type": "string" }, "parameters": { @@ -12460,7 +12476,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "Optional. The collection of parameters associated with this context. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" } }, @@ -12613,7 +12629,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "The collection of parameters associated with the event. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" } }, @@ -12686,7 +12702,7 @@ "id": "GoogleCloudDialogflowV2beta1GcsDestination", "properties": { "uri": { - "description": "Required. The Google Cloud Storage URIs for the output. A URI is of the form: gs://bucket/object-prefix-or-name Whether a prefix or name is used depends on the use case. The requesting user must have \"write-permission\" to the bucket.", + "description": "Required. The Google Cloud Storage URIs for the output. A URI is of the form: `gs://bucket/object-prefix-or-name` Whether a prefix or name is used depends on the use case. The requesting user must have \"write-permission\" to the bucket.", "type": "string" } }, @@ -14212,7 +14228,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: - MapKey type: string - MapKey value: parameter name - MapValue type: - If parameter's entity type is a composite entity: map - Else: depending on parameter value type, could be one of string, number, boolean, null, list or map - MapValue value: - If parameter's entity type is a composite entity: map from composite entity property names to property values - Else: parameter value", + "description": "The collection of extracted parameters. Depending on your protocol or client library language, this is a map, associative array, symbol table, dictionary, or JSON object composed of a collection of (MapKey, MapValue) pairs: * MapKey type: string * MapKey value: parameter name * MapValue type: If parameter's entity type is a composite entity then use map, otherwise, depending on the parameter value type, it could be one of string, number, boolean, null, list or map. * MapValue value: If parameter's entity type is a composite entity then use map from composite entity property names to property values, otherwise, use parameter value.", "type": "object" }, "queryText": { diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index bc799b41ab1..01533d0cb6e 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -1181,7 +1181,7 @@ type GoogleCloudDialogflowCxV3ExportAgentResponse struct { AgentUri string `json:"agentUri,omitempty"` // CommitSha: Commit SHA of the git push. This field is populated if - // `git_destination` are specified in ExportAgentRequest. + // `git_destination` is specified in ExportAgentRequest. CommitSha string `json:"commitSha,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -2536,6 +2536,17 @@ type GoogleCloudDialogflowCxV3ResponseMessage struct { // any way. PlayAudio *GoogleCloudDialogflowCxV3ResponseMessagePlayAudio `json:"playAudio,omitempty"` + // ResponseType: Response type. + // + // Possible values: + // "RESPONSE_TYPE_UNSPECIFIED" - Not specified. + // "ENTRY_PROMPT" - The response is from an entry prompt in the page. + // "PARAMETER_PROMPT" - The response is from form-filling prompt in + // the page. + // "HANDLER_PROMPT" - The response is from a transition route or an + // event handler in the page or flow or transition route group. + ResponseType string `json:"responseType,omitempty"` + // TelephonyTransferCall: A signal that the client should transfer the // phone call connected to this agent to a third-party endpoint. TelephonyTransferCall *GoogleCloudDialogflowCxV3ResponseMessageTelephonyTransferCall `json:"telephonyTransferCall,omitempty"` @@ -4247,7 +4258,7 @@ type GoogleCloudDialogflowCxV3beta1AgentGitIntegrationSettingsGithubSettings str // RepositoryUri: The GitHub repository URI related to the agent. RepositoryUri string `json:"repositoryUri,omitempty"` - // TrackingBranch: The branch of GitHub repository tracked for this + // TrackingBranch: The branch of the GitHub repository tracked for this // agent. TrackingBranch string `json:"trackingBranch,omitempty"` @@ -6155,7 +6166,7 @@ type GoogleCloudDialogflowCxV3beta1ExportAgentResponse struct { AgentUri string `json:"agentUri,omitempty"` // CommitSha: Commit SHA of the git push. This field is populated if - // `git_destination` are specified in ExportAgentRequest. + // `git_destination` is specified in ExportAgentRequest. CommitSha string `json:"commitSha,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -12504,7 +12515,7 @@ type GoogleCloudDialogflowV2Context struct { // `projects//agent/sessions//contexts/`, or // `projects//agent/environments//users//sessions//contexts/`. The // `Context ID` is always converted to lowercase, may only contain - // characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If + // characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If // `Environment ID` is not specified, we assume default 'draft' // environment. If `User ID` is not specified, we assume default '-' // user. The following context names are reserved for internal use by @@ -12516,13 +12527,14 @@ type GoogleCloudDialogflowV2Context struct { // Parameters: Optional. The collection of parameters associated with // this context. Depending on your protocol or client library language, // this is a map, associative array, symbol table, dictionary, or JSON - // object composed of a collection of (MapKey, MapValue) pairs: - MapKey - // type: string - MapKey value: parameter name - MapValue type: - If - // parameter's entity type is a composite entity: map - Else: depending - // on parameter value type, could be one of string, number, boolean, - // null, list or map - MapValue value: - If parameter's entity type is a - // composite entity: map from composite entity property names to - // property values - Else: parameter value + // object composed of a collection of (MapKey, MapValue) pairs: * MapKey + // type: string * MapKey value: parameter name * MapValue type: If + // parameter's entity type is a composite entity then use map, + // otherwise, depending on the parameter value type, it could be one of + // string, number, boolean, null, list or map. * MapValue value: If + // parameter's entity type is a composite entity then use map from + // composite entity property names to property values, otherwise, use + // parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "LifespanCount") to @@ -13027,13 +13039,13 @@ type GoogleCloudDialogflowV2EventInput struct { // Parameters: The collection of parameters associated with the event. // Depending on your protocol or client library language, this is a map, // associative array, symbol table, dictionary, or JSON object composed - // of a collection of (MapKey, MapValue) pairs: - MapKey type: string - - // MapKey value: parameter name - MapValue type: - If parameter's entity - // type is a composite entity: map - Else: depending on parameter value - // type, could be one of string, number, boolean, null, list or map - - // MapValue value: - If parameter's entity type is a composite entity: - // map from composite entity property names to property values - Else: - // parameter value + // of a collection of (MapKey, MapValue) pairs: * MapKey type: string * + // MapKey value: parameter name * MapValue type: If parameter's entity + // type is a composite entity then use map, otherwise, depending on the + // parameter value type, it could be one of string, number, boolean, + // null, list or map. * MapValue value: If parameter's entity type is a + // composite entity then use map from composite entity property names to + // property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "LanguageCode") to @@ -13192,7 +13204,7 @@ func (s *GoogleCloudDialogflowV2FaqAnswer) UnmarshalJSON(data []byte) error { // for the output. type GoogleCloudDialogflowV2GcsDestination struct { // Uri: The Google Cloud Storage URIs for the output. A URI is of the - // form: gs://bucket/object-prefix-or-name Whether a prefix or name is + // form: `gs://bucket/object-prefix-or-name` Whether a prefix or name is // used depends on the use case. The requesting user must have // "write-permission" to the bucket. Uri string `json:"uri,omitempty"` @@ -15067,13 +15079,13 @@ type GoogleCloudDialogflowV2QueryResult struct { // Parameters: The collection of extracted parameters. Depending on your // protocol or client library language, this is a map, associative // array, symbol table, dictionary, or JSON object composed of a - // collection of (MapKey, MapValue) pairs: - MapKey type: string - - // MapKey value: parameter name - MapValue type: - If parameter's entity - // type is a composite entity: map - Else: depending on parameter value - // type, could be one of string, number, boolean, null, list or map - - // MapValue value: - If parameter's entity type is a composite entity: - // map from composite entity property names to property values - Else: - // parameter value + // collection of (MapKey, MapValue) pairs: * MapKey type: string * + // MapKey value: parameter name * MapValue type: If parameter's entity + // type is a composite entity then use map, otherwise, depending on the + // parameter value type, it could be one of string, number, boolean, + // null, list or map. * MapValue value: If parameter's entity type is a + // composite entity then use map from composite entity property names to + // property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // QueryText: The original conversational query text: - If natural @@ -16020,7 +16032,7 @@ type GoogleCloudDialogflowV2beta1Context struct { // `projects//agent/environments//users//sessions//contexts/`, - // `projects//locations//agent/environments//users//sessions//contexts/`, // The `Context ID` is always converted to lowercase, may only contain - // characters in a-zA-Z0-9_-% and may be at most 250 bytes long. If + // characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long. If // `Environment ID` is not specified, we assume default 'draft' // environment. If `User ID` is not specified, we assume default '-' // user. The following context names are reserved for internal use by @@ -16032,13 +16044,14 @@ type GoogleCloudDialogflowV2beta1Context struct { // Parameters: Optional. The collection of parameters associated with // this context. Depending on your protocol or client library language, // this is a map, associative array, symbol table, dictionary, or JSON - // object composed of a collection of (MapKey, MapValue) pairs: - MapKey - // type: string - MapKey value: parameter name - MapValue type: - If - // parameter's entity type is a composite entity: map - Else: depending - // on parameter value type, could be one of string, number, boolean, - // null, list or map - MapValue value: - If parameter's entity type is a - // composite entity: map from composite entity property names to - // property values - Else: parameter value + // object composed of a collection of (MapKey, MapValue) pairs: * MapKey + // type: string * MapKey value: parameter name * MapValue type: If + // parameter's entity type is a composite entity then use map, + // otherwise, depending on the parameter value type, it could be one of + // string, number, boolean, null, list or map. * MapValue value: If + // parameter's entity type is a composite entity then use map from + // composite entity property names to property values, otherwise, use + // parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "LifespanCount") to @@ -16300,13 +16313,13 @@ type GoogleCloudDialogflowV2beta1EventInput struct { // Parameters: The collection of parameters associated with the event. // Depending on your protocol or client library language, this is a map, // associative array, symbol table, dictionary, or JSON object composed - // of a collection of (MapKey, MapValue) pairs: - MapKey type: string - - // MapKey value: parameter name - MapValue type: - If parameter's entity - // type is a composite entity: map - Else: depending on parameter value - // type, could be one of string, number, boolean, null, list or map - - // MapValue value: - If parameter's entity type is a composite entity: - // map from composite entity property names to property values - Else: - // parameter value + // of a collection of (MapKey, MapValue) pairs: * MapKey type: string * + // MapKey value: parameter name * MapValue type: If parameter's entity + // type is a composite entity then use map, otherwise, depending on the + // parameter value type, it could be one of string, number, boolean, + // null, list or map. * MapValue value: If parameter's entity type is a + // composite entity then use map from composite entity property names to + // property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "LanguageCode") to @@ -16465,7 +16478,7 @@ func (s *GoogleCloudDialogflowV2beta1FaqAnswer) UnmarshalJSON(data []byte) error // location for the output. type GoogleCloudDialogflowV2beta1GcsDestination struct { // Uri: Required. The Google Cloud Storage URIs for the output. A URI is - // of the form: gs://bucket/object-prefix-or-name Whether a prefix or + // of the form: `gs://bucket/object-prefix-or-name` Whether a prefix or // name is used depends on the use case. The requesting user must have // "write-permission" to the bucket. Uri string `json:"uri,omitempty"` @@ -18939,13 +18952,13 @@ type GoogleCloudDialogflowV2beta1QueryResult struct { // Parameters: The collection of extracted parameters. Depending on your // protocol or client library language, this is a map, associative // array, symbol table, dictionary, or JSON object composed of a - // collection of (MapKey, MapValue) pairs: - MapKey type: string - - // MapKey value: parameter name - MapValue type: - If parameter's entity - // type is a composite entity: map - Else: depending on parameter value - // type, could be one of string, number, boolean, null, list or map - - // MapValue value: - If parameter's entity type is a composite entity: - // map from composite entity property names to property values - Else: - // parameter value + // collection of (MapKey, MapValue) pairs: * MapKey type: string * + // MapKey value: parameter name * MapValue type: If parameter's entity + // type is a composite entity then use map, otherwise, depending on the + // parameter value type, it could be one of string, number, boolean, + // null, list or map. * MapValue value: If parameter's entity type is a + // composite entity then use map from composite entity property names to + // property values, otherwise, use parameter value. Parameters googleapi.RawMessage `json:"parameters,omitempty"` // QueryText: The original conversational query text: - If natural 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/displayvideo/v1/displayvideo-api.json b/displayvideo/v1/displayvideo-api.json index 3fcc33b568f..e4984f51773 100644 --- a/displayvideo/v1/displayvideo-api.json +++ b/displayvideo/v1/displayvideo-api.json @@ -8152,7 +8152,7 @@ } } }, - "revision": "20230713", + "revision": "20230720", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActivateManualTriggerRequest": { @@ -15493,7 +15493,8 @@ "CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS", "NO_CREATIVE_FOR_TARGETED_DEALS", "TARGETING_DEPRECATED_GEO_TARGET", - "DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION" + "DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION", + "NO_INPUT_REVENUE_MODEL_TYPE_SPECIFIED" ], "enumDescriptions": [ "Not specified or is unknown.", @@ -15514,7 +15515,8 @@ "Deals targeted by this line item accept creative sizes which are not in use. This may limit the line item's delivery or performance.", "This line item does not contain any creative for the targeted deals.", "This line item targets a geo target that is deprecated.", - "This line item uses the exclude_first_party_audience setting, which is deprecated and scheduled to sunset after **March 25, 2023**. Update your API integration to directly exclude any first-party audiences using audience targeting before **March 25, 2023** to account for the sunset of the exclude_first_party_audience field." + "This line item uses the exclude_first_party_audience setting, which is deprecated and scheduled to sunset after **March 25, 2023**. Update your API integration to directly exclude any first-party audiences using audience targeting before **March 25, 2023** to account for the sunset of the exclude_first_party_audience field.", + "The partner revenue model of the line item was updated without specifying the revenue model type, which is required for updating any of the revenue model fields." ], "type": "string" }, diff --git a/displayvideo/v1/displayvideo-gen.go b/displayvideo/v1/displayvideo-gen.go index 4f81bee7cf4..ac780855215 100644 --- a/displayvideo/v1/displayvideo-gen.go +++ b/displayvideo/v1/displayvideo-gen.go @@ -10754,6 +10754,9 @@ type LineItem struct { // integration to directly exclude any first-party audiences using // audience targeting before **March 25, 2023** to account for the // sunset of the exclude_first_party_audience field. + // "NO_INPUT_REVENUE_MODEL_TYPE_SPECIFIED" - The partner revenue model + // of the line item was updated without specifying the revenue model + // type, which is required for updating any of the revenue model fields. WarningMessages []string `json:"warningMessages,omitempty"` // ServerResponse contains the HTTP response code and headers from the diff --git a/displayvideo/v2/displayvideo-api.json b/displayvideo/v2/displayvideo-api.json index 0a330013efd..b52259daffa 100644 --- a/displayvideo/v2/displayvideo-api.json +++ b/displayvideo/v2/displayvideo-api.json @@ -9178,7 +9178,7 @@ } } }, - "revision": "20230713", + "revision": "20230720", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActivateManualTriggerRequest": { @@ -17081,7 +17081,8 @@ "NO_VALID_CREATIVE", "PARENT_INSERTION_ORDER_PAUSED", "PARENT_INSERTION_ORDER_EXPIRED", - "DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION" + "DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION", + "NO_INPUT_REVENUE_MODEL_TYPE_SPECIFIED" ], "enumDescriptions": [ "Not specified or is unknown.", @@ -17095,7 +17096,8 @@ "This line item does not contain any valid creative. The line item will not run.", "The insertion order of this line item is paused. The line item will not run.", "The insertion order of this line item has its end date set in the past. The line item will not run.", - "This line item uses the exclude_first_party_audience setting, which is deprecated and scheduled to sunset after **March 25, 2023**. Update your API integration to directly exclude any first-party audiences using audience targeting before **March 25, 2023** to account for the sunset of the exclude_first_party_audience field." + "This line item uses the exclude_first_party_audience setting, which is deprecated and scheduled to sunset after **March 25, 2023**. Update your API integration to directly exclude any first-party audiences using audience targeting before **March 25, 2023** to account for the sunset of the exclude_first_party_audience field.", + "The partner revenue model of the line item was updated without specifying the revenue model type, which is required for updating any of the revenue model fields." ], "type": "string" }, diff --git a/displayvideo/v2/displayvideo-gen.go b/displayvideo/v2/displayvideo-gen.go index 953600aeae0..6e99948f34e 100644 --- a/displayvideo/v2/displayvideo-gen.go +++ b/displayvideo/v2/displayvideo-gen.go @@ -11659,6 +11659,9 @@ type LineItem struct { // integration to directly exclude any first-party audiences using // audience targeting before **March 25, 2023** to account for the // sunset of the exclude_first_party_audience field. + // "NO_INPUT_REVENUE_MODEL_TYPE_SPECIFIED" - The partner revenue model + // of the line item was updated without specifying the revenue model + // type, which is required for updating any of the revenue model fields. WarningMessages []string `json:"warningMessages,omitempty"` // YoutubeAndPartnersSettings: Output only. Settings specific to YouTube diff --git a/documentai/v1/documentai-api.json b/documentai/v1/documentai-api.json index f42d4de0afe..1f3a1fe7f03 100644 --- a/documentai/v1/documentai-api.json +++ b/documentai/v1/documentai-api.json @@ -1042,7 +1042,7 @@ } } }, - "revision": "20230706", + "revision": "20230719", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -1928,6 +1928,10 @@ "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" @@ -4237,7 +4241,8 @@ "description": "The schema of the processor version. Describes the output." }, "googleManaged": { - "description": "Denotes that this `ProcessorVersion` is managed by Google.", + "description": "Output only. Denotes that this `ProcessorVersion` is managed by Google.", + "readOnly": true, "type": "boolean" }, "kmsKeyName": { @@ -4317,6 +4322,20 @@ }, "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 dd7453c6c8e..8c20c8c7197 100644 --- a/documentai/v1/documentai-gen.go +++ b/documentai/v1/documentai-gen.go @@ -1907,6 +1907,9 @@ 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 @@ -5707,8 +5710,8 @@ type GoogleCloudDocumentaiV1ProcessorVersion struct { // output. DocumentSchema *GoogleCloudDocumentaiV1DocumentSchema `json:"documentSchema,omitempty"` - // GoogleManaged: Denotes that this `ProcessorVersion` is managed by - // Google. + // GoogleManaged: Output only. Denotes that this `ProcessorVersion` is + // managed by Google. GoogleManaged bool `json:"googleManaged,omitempty"` // KmsKeyName: The KMS key name used for encryption. @@ -5839,6 +5842,35 @@ 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 0e85008a7cf..a7c3fdcbafa 100644 --- a/documentai/v1beta3/documentai-api.json +++ b/documentai/v1beta3/documentai-api.json @@ -1256,7 +1256,7 @@ } } }, - "revision": "20230706", + "revision": "20230719", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -5400,6 +5400,10 @@ "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" @@ -8096,7 +8100,8 @@ "description": "The schema of the processor version. Describes the output." }, "googleManaged": { - "description": "Denotes that this `ProcessorVersion` is managed by Google.", + "description": "Output only. Denotes that this `ProcessorVersion` is managed by Google.", + "readOnly": true, "type": "boolean" }, "kmsKeyName": { @@ -8187,6 +8192,20 @@ }, "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 3050f1d4e27..1ecd354dfaf 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -7254,6 +7254,9 @@ 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 @@ -11832,8 +11835,8 @@ type GoogleCloudDocumentaiV1beta3ProcessorVersion struct { // output. DocumentSchema *GoogleCloudDocumentaiV1beta3DocumentSchema `json:"documentSchema,omitempty"` - // GoogleManaged: Denotes that this `ProcessorVersion` is managed by - // Google. + // GoogleManaged: Output only. Denotes that this `ProcessorVersion` is + // managed by Google. GoogleManaged bool `json:"googleManaged,omitempty"` // KmsKeyName: The KMS key name used for encryption. @@ -11993,6 +11996,35 @@ 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/drive/v2/drive-api.json b/drive/v2/drive-api.json index 9905fc39d58..0518f114516 100644 --- a/drive/v2/drive-api.json +++ b/drive/v2/drive-api.json @@ -3842,7 +3842,7 @@ } } }, - "revision": "20230708", + "revision": "20230714", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { @@ -4717,6 +4717,10 @@ "description": "A restriction for accessing the content of the file.", "id": "ContentRestriction", "properties": { + "ownerRestricted": { + "description": "Whether the content restriction can only be modified or removed by a user who owns the file. For files in shared drives, any user with `organizer` capabilities can modify or remove this content restriction.", + "type": "boolean" + }, "readOnly": { "description": "Whether the content of the file is read-only. If a file is read-only, a new revision of the file may not be added, comments may not be added or modified, and the title of the file may not be modified.", "type": "boolean" @@ -5038,13 +5042,22 @@ "type": "boolean" }, "canModifyContentRestriction": { - "description": "Output only. Whether the current user can modify restrictions on content of this file.", + "deprecated": true, + "description": "Deprecated: Output only. Use one of `canModifyEditorContentRestriction`, `canModifyOwnerContentRestriction` or `canRemoveContentRestriction`.", + "type": "boolean" + }, + "canModifyEditorContentRestriction": { + "description": "Output only. Whether the current user can add or modify content restrictions on the file which are editor restricted.", "type": "boolean" }, "canModifyLabels": { "description": "Output only. Whether the current user can modify the labels on the file.", "type": "boolean" }, + "canModifyOwnerContentRestriction": { + "description": "Output only. Whether the current user can add or modify content restrictions which are owner restricted.", + "type": "boolean" + }, "canMoveChildrenOutOfDrive": { "description": "Output only. Whether the current user can move children of this folder outside of the shared drive. This is false when the item is not a folder. Only populated for items in shared drives.", "type": "boolean" @@ -5112,6 +5125,10 @@ "description": "Output only. Whether the current user can remove children from this folder. This is always false when the item is not a folder. For a folder in a shared drive, use `canDeleteChildren` or `canTrashChildren` instead.", "type": "boolean" }, + "canRemoveContentRestriction": { + "description": "Output only. Whether there is a content restriction on the file that can be removed by the current user.", + "type": "boolean" + }, "canRemoveMyDriveParent": { "description": "Output only. Whether the current user can remove a parent from the item without adding another parent in the same request. Not populated for shared drive files.", "type": "boolean" diff --git a/drive/v2/drive-gen.go b/drive/v2/drive-gen.go index 4713a1d8151..c140225b24a 100644 --- a/drive/v2/drive-gen.go +++ b/drive/v2/drive-gen.go @@ -1540,6 +1540,12 @@ func (s *CommentReplyList) MarshalJSON() ([]byte, error) { // ContentRestriction: A restriction for accessing the content of the // file. type ContentRestriction struct { + // OwnerRestricted: Whether the content restriction can only be modified + // or removed by a user who owns the file. For files in shared drives, + // any user with `organizer` capabilities can modify or remove this + // content restriction. + OwnerRestricted bool `json:"ownerRestricted,omitempty"` + // ReadOnly: Whether the content of the file is read-only. If a file is // read-only, a new revision of the file may not be added, comments may // not be added or modified, and the title of the file may not be @@ -1562,7 +1568,7 @@ type ContentRestriction struct { // only possible value is `globalContentRestriction`. Type string `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "ReadOnly") to + // ForceSendFields is a list of field names (e.g. "OwnerRestricted") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -1570,12 +1576,13 @@ type ContentRestriction struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ReadOnly") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. + // NullFields is a list of field names (e.g. "OwnerRestricted") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. NullFields []string `json:"-"` } @@ -2385,14 +2392,25 @@ type FileCapabilities struct { // the content of this file. CanModifyContent bool `json:"canModifyContent,omitempty"` - // CanModifyContentRestriction: Output only. Whether the current user - // can modify restrictions on content of this file. + // CanModifyContentRestriction: Deprecated: Output only. Use one of + // `canModifyEditorContentRestriction`, + // `canModifyOwnerContentRestriction` or `canRemoveContentRestriction`. CanModifyContentRestriction bool `json:"canModifyContentRestriction,omitempty"` + // CanModifyEditorContentRestriction: Output only. Whether the current + // user can add or modify content restrictions on the file which are + // editor restricted. + CanModifyEditorContentRestriction bool `json:"canModifyEditorContentRestriction,omitempty"` + // CanModifyLabels: Output only. Whether the current user can modify the // labels on the file. CanModifyLabels bool `json:"canModifyLabels,omitempty"` + // CanModifyOwnerContentRestriction: Output only. Whether the current + // user can add or modify content restrictions which are owner + // restricted. + CanModifyOwnerContentRestriction bool `json:"canModifyOwnerContentRestriction,omitempty"` + // CanMoveChildrenOutOfDrive: Output only. Whether the current user can // move children of this folder outside of the shared drive. This is // false when the item is not a folder. Only populated for items in @@ -2467,6 +2485,10 @@ type FileCapabilities struct { // `canTrashChildren` instead. CanRemoveChildren bool `json:"canRemoveChildren,omitempty"` + // CanRemoveContentRestriction: Output only. Whether there is a content + // restriction on the file that can be removed by the current user. + CanRemoveContentRestriction bool `json:"canRemoveContentRestriction,omitempty"` + // CanRemoveMyDriveParent: Output only. Whether the current user can // remove a parent from the item without adding another parent in the // same request. Not populated for shared drive files. diff --git a/drive/v3/drive-api.json b/drive/v3/drive-api.json index b10a763f427..6838acc3cca 100644 --- a/drive/v3/drive-api.json +++ b/drive/v3/drive-api.json @@ -2433,7 +2433,7 @@ } } }, - "revision": "20230708", + "revision": "20230714", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { @@ -2816,6 +2816,10 @@ "description": "A restriction for accessing the content of the file.", "id": "ContentRestriction", "properties": { + "ownerRestricted": { + "description": "Whether the content restriction can only be modified or removed by a user who owns the file. For files in shared drives, any user with `organizer` capabilities can modify or remove this content restriction.", + "type": "boolean" + }, "readOnly": { "description": "Whether the content of the file is read-only. If a file is read-only, a new revision of the file may not be added, comments may not be added or modified, and the title of the file may not be modified.", "type": "boolean" @@ -3121,13 +3125,22 @@ "type": "boolean" }, "canModifyContentRestriction": { - "description": "Output only. Whether the current user can modify restrictions on content of this file.", + "deprecated": true, + "description": "Deprecated: Output only. Use one of `canModifyEditorContentRestriction`, `canModifyOwnerContentRestriction` or `canRemoveContentRestriction`.", + "type": "boolean" + }, + "canModifyEditorContentRestriction": { + "description": "Output only. Whether the current user can add or modify content restrictions on the file which are editor restricted.", "type": "boolean" }, "canModifyLabels": { "description": "Output only. Whether the current user can modify the labels on the file.", "type": "boolean" }, + "canModifyOwnerContentRestriction": { + "description": "Output only. Whether the current user can add or modify content restrictions which are owner restricted.", + "type": "boolean" + }, "canMoveChildrenOutOfDrive": { "description": "Output only. Whether the current user can move children of this folder outside of the shared drive. This is false when the item is not a folder. Only populated for items in shared drives.", "type": "boolean" @@ -3195,6 +3208,10 @@ "description": "Output only. Whether the current user can remove children from this folder. This is always false when the item is not a folder. For a folder in a shared drive, use `canDeleteChildren` or `canTrashChildren` instead.", "type": "boolean" }, + "canRemoveContentRestriction": { + "description": "Output only. Whether there is a content restriction on the file that can be removed by the current user.", + "type": "boolean" + }, "canRemoveMyDriveParent": { "description": "Output only. Whether the current user can remove a parent from the item without adding another parent in the same request. Not populated for shared drive files.", "type": "boolean" diff --git a/drive/v3/drive-gen.go b/drive/v3/drive-gen.go index 0a9444ee92b..5bd3a6a3f46 100644 --- a/drive/v3/drive-gen.go +++ b/drive/v3/drive-gen.go @@ -809,6 +809,12 @@ func (s *CommentList) MarshalJSON() ([]byte, error) { // ContentRestriction: A restriction for accessing the content of the // file. type ContentRestriction struct { + // OwnerRestricted: Whether the content restriction can only be modified + // or removed by a user who owns the file. For files in shared drives, + // any user with `organizer` capabilities can modify or remove this + // content restriction. + OwnerRestricted bool `json:"ownerRestricted,omitempty"` + // ReadOnly: Whether the content of the file is read-only. If a file is // read-only, a new revision of the file may not be added, comments may // not be added or modified, and the title of the file may not be @@ -831,7 +837,7 @@ type ContentRestriction struct { // only possible value is `globalContentRestriction`. Type string `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "ReadOnly") to + // ForceSendFields is a list of field names (e.g. "OwnerRestricted") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -839,12 +845,13 @@ type ContentRestriction struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ReadOnly") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. + // NullFields is a list of field names (e.g. "OwnerRestricted") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. NullFields []string `json:"-"` } @@ -1617,14 +1624,25 @@ type FileCapabilities struct { // the content of this file. CanModifyContent bool `json:"canModifyContent,omitempty"` - // CanModifyContentRestriction: Output only. Whether the current user - // can modify restrictions on content of this file. + // CanModifyContentRestriction: Deprecated: Output only. Use one of + // `canModifyEditorContentRestriction`, + // `canModifyOwnerContentRestriction` or `canRemoveContentRestriction`. CanModifyContentRestriction bool `json:"canModifyContentRestriction,omitempty"` + // CanModifyEditorContentRestriction: Output only. Whether the current + // user can add or modify content restrictions on the file which are + // editor restricted. + CanModifyEditorContentRestriction bool `json:"canModifyEditorContentRestriction,omitempty"` + // CanModifyLabels: Output only. Whether the current user can modify the // labels on the file. CanModifyLabels bool `json:"canModifyLabels,omitempty"` + // CanModifyOwnerContentRestriction: Output only. Whether the current + // user can add or modify content restrictions which are owner + // restricted. + CanModifyOwnerContentRestriction bool `json:"canModifyOwnerContentRestriction,omitempty"` + // CanMoveChildrenOutOfDrive: Output only. Whether the current user can // move children of this folder outside of the shared drive. This is // false when the item is not a folder. Only populated for items in @@ -1699,6 +1717,10 @@ type FileCapabilities struct { // `canTrashChildren` instead. CanRemoveChildren bool `json:"canRemoveChildren,omitempty"` + // CanRemoveContentRestriction: Output only. Whether there is a content + // restriction on the file that can be removed by the current user. + CanRemoveContentRestriction bool `json:"canRemoveContentRestriction,omitempty"` + // CanRemoveMyDriveParent: Output only. Whether the current user can // remove a parent from the item without adding another parent in the // same request. Not populated for shared drive files. 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/games/v1/games-api.json b/games/v1/games-api.json index ab52f81219a..bb333cae1a3 100644 --- a/games/v1/games-api.json +++ b/games/v1/games-api.json @@ -782,6 +782,11 @@ "VISIBLE", "FRIENDS_ALL" ], + "enumDeprecated": [ + true, + true, + false + ], "enumDescriptions": [ "Retrieve a list of players that are also playing this game in reverse chronological order.", "Retrieve a list of players in the user's social graph that are visible to this game.", @@ -868,6 +873,13 @@ "SOCIAL", "FRIENDS" ], + "enumDeprecated": [ + false, + false, + false, + true, + false + ], "enumDescriptions": [ "Default value. Should be unused.", "Retrieve all supported ranks. In HTTP, this parameter value can also be specified as `ALL`.", @@ -954,6 +966,12 @@ "SOCIAL", "FRIENDS" ], + "enumDeprecated": [ + false, + false, + true, + false + ], "enumDescriptions": [ "Default value. This value is unused.", "List all scores in the public leaderboard.", @@ -1032,6 +1050,12 @@ "SOCIAL", "FRIENDS" ], + "enumDeprecated": [ + false, + false, + true, + false + ], "enumDescriptions": [ "Default value. This value is unused.", "List all scores in the public leaderboard.", @@ -1266,7 +1290,7 @@ } } }, - "revision": "20230310", + "revision": "20230712", "rootUrl": "https://games.googleapis.com/", "schemas": { "AchievementDefinition": { diff --git a/games/v1/games-gen.go b/games/v1/games-gen.go index 83b0bca0d43..8704f4dbad3 100644 --- a/games/v1/games-gen.go +++ b/games/v1/games-gen.go @@ -6794,6 +6794,11 @@ func (c *PlayersListCall) Do(opts ...googleapi.CallOption) (*PlayerListResponse, // "VISIBLE", // "FRIENDS_ALL" // ], + // "enumDeprecated": [ + // true, + // true, + // false + // ], // "enumDescriptions": [ // "Retrieve a list of players that are also playing this game in reverse chronological order.", // "Retrieve a list of players in the user's social graph that are visible to this game.", @@ -7196,6 +7201,13 @@ func (c *ScoresGetCall) Do(opts ...googleapi.CallOption) (*PlayerLeaderboardScor // "SOCIAL", // "FRIENDS" // ], + // "enumDeprecated": [ + // false, + // false, + // false, + // true, + // false + // ], // "enumDescriptions": [ // "Default value. Should be unused.", // "Retrieve all supported ranks. In HTTP, this parameter value can also be specified as `ALL`.", @@ -7453,6 +7465,12 @@ func (c *ScoresListCall) Do(opts ...googleapi.CallOption) (*LeaderboardScores, e // "SOCIAL", // "FRIENDS" // ], + // "enumDeprecated": [ + // false, + // false, + // true, + // false + // ], // "enumDescriptions": [ // "Default value. This value is unused.", // "List all scores in the public leaderboard.", @@ -7721,6 +7739,12 @@ func (c *ScoresListWindowCall) Do(opts ...googleapi.CallOption) (*LeaderboardSco // "SOCIAL", // "FRIENDS" // ], + // "enumDeprecated": [ + // false, + // false, + // true, + // false + // ], // "enumDescriptions": [ // "Default value. This value is unused.", // "List all scores in the public leaderboard.", diff --git a/gkeonprem/v1/gkeonprem-api.json b/gkeonprem/v1/gkeonprem-api.json index fc6f325623b..cabbc4f3f39 100644 --- a/gkeonprem/v1/gkeonprem-api.json +++ b/gkeonprem/v1/gkeonprem-api.json @@ -2996,7 +2996,7 @@ } } }, - "revision": "20230705", + "revision": "20230717", "rootUrl": "https://gkeonprem.googleapis.com/", "schemas": { "Authorization": { @@ -4195,7 +4195,7 @@ "id": "BareMetalParallelUpgradeConfig", "properties": { "concurrentNodes": { - "description": "Required. The maximum number of nodes that can be upgraded at once. Defaults to 1.", + "description": "The maximum number of nodes that can be upgraded at once.", "format": "int32", "type": "integer" }, @@ -5513,6 +5513,11 @@ "description": "The number of mebibytes of memory for the control-plane node of the admin cluster.", "format": "int64", "type": "string" + }, + "replicas": { + "description": "The number of control plane nodes for this VMware admin cluster. (default: 1 replica).", + "format": "int64", + "type": "string" } }, "type": "object" @@ -5536,6 +5541,17 @@ }, "type": "object" }, + "VmwareAdminHAControlPlaneConfig": { + "description": "Specifies HA admin control plane config.", + "id": "VmwareAdminHAControlPlaneConfig", + "properties": { + "controlPlaneIpBlock": { + "$ref": "VmwareIpBlock", + "description": "Static IP addresses for the admin control plane nodes." + } + }, + "type": "object" + }, "VmwareAdminLoadBalancerConfig": { "description": "VmwareAdminLoadBalancerConfig contains load balancer configuration for VMware admin cluster.", "id": "VmwareAdminLoadBalancerConfig", @@ -5552,6 +5568,11 @@ "$ref": "VmwareAdminMetalLbConfig", "description": "MetalLB load balancers." }, + "seesawConfig": { + "$ref": "VmwareAdminSeesawConfig", + "description": "Output only. Configuration for Seesaw typed load balancers.", + "readOnly": true + }, "vipConfig": { "$ref": "VmwareAdminVipConfig", "description": "The VIPs used by the load balancer." @@ -5604,6 +5625,10 @@ "$ref": "VmwareDhcpIpConfig", "description": "Configuration settings for a DHCP IP configuration." }, + "haControlPlaneConfig": { + "$ref": "VmwareAdminHAControlPlaneConfig", + "description": "Configuration for HA admin cluster control plane." + }, "hostConfig": { "$ref": "VmwareHostConfig", "description": "Represents common network settings irrespective of the host's IP address." @@ -5633,6 +5658,39 @@ }, "type": "object" }, + "VmwareAdminSeesawConfig": { + "description": "VmwareSeesawConfig represents configuration parameters for an already existing Seesaw load balancer. IMPORTANT: Please note that the Anthos On-Prem API will not generate or update Seesaw configurations it can only bind a pre-existing configuration to a new user cluster. IMPORTANT: When attempting to create a user cluster with a pre-existing Seesaw load balancer you will need to follow some preparation steps before calling the 'CreateVmwareCluster' API method. First you will need to create the user cluster's namespace via kubectl. The namespace will need to use the following naming convention : -gke-onprem-mgmt or -gke-onprem-mgmt depending on whether you used the 'VmwareCluster.local_name' to disambiguate collisions; for more context see the documentation of 'VmwareCluster.local_name'. Once the namespace is created you will need to create a secret resource via kubectl. This secret will contain copies of your Seesaw credentials. The Secret must be called 'user-cluster-creds' and contain Seesaw's SSH and Cert credentials. The credentials must be keyed with the following names: 'seesaw-ssh-private-key', 'seesaw-ssh-public-key', 'seesaw-ssh-ca-key', 'seesaw-ssh-ca-cert'.", + "id": "VmwareAdminSeesawConfig", + "properties": { + "enableHa": { + "description": "Enable two load balancer VMs to achieve a highly-available Seesaw load balancer.", + "type": "boolean" + }, + "group": { + "description": "In general the following format should be used for the Seesaw group name: seesaw-for-[cluster_name].", + "type": "string" + }, + "ipBlocks": { + "description": "The IP Blocks to be used by the Seesaw load balancer", + "items": { + "$ref": "VmwareIpBlock" + }, + "type": "array" + }, + "masterIp": { + "description": "MasterIP is the IP announced by the master of Seesaw group.", + "type": "string" + }, + "vms": { + "description": "Names of the VMs created for this Seesaw group.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "VmwareAdminVCenterConfig": { "description": "VmwareAdminVCenterConfig contains VCenter configuration for VMware admin cluster.", "id": "VmwareAdminVCenterConfig", @@ -5910,8 +5968,7 @@ }, "vsphereConfig": { "$ref": "VmwareControlPlaneVsphereConfig", - "description": "Output only. Vsphere-specific config.", - "readOnly": true + "description": "Vsphere-specific config." } }, "type": "object" @@ -6210,8 +6267,7 @@ }, "vsphereConfig": { "$ref": "VmwareVsphereConfig", - "description": "Output only. Specifies the vSphere config for node pool.", - "readOnly": true + "description": "Specifies the vSphere config for node pool." } }, "type": "object" diff --git a/gkeonprem/v1/gkeonprem-gen.go b/gkeonprem/v1/gkeonprem-gen.go index 06a5ca209d3..c230329ab02 100644 --- a/gkeonprem/v1/gkeonprem-gen.go +++ b/gkeonprem/v1/gkeonprem-gen.go @@ -2461,8 +2461,8 @@ func (s *BareMetalOsEnvironmentConfig) MarshalJSON() ([]byte, error) { // BareMetalParallelUpgradeConfig: BareMetalParallelUpgradeConfig // defines the parallel upgrade settings for worker node pools. type BareMetalParallelUpgradeConfig struct { - // ConcurrentNodes: Required. The maximum number of nodes that can be - // upgraded at once. Defaults to 1. + // ConcurrentNodes: The maximum number of nodes that can be upgraded at + // once. ConcurrentNodes int64 `json:"concurrentNodes,omitempty"` // MinimumAvailableNodes: The minimum number of nodes that should be @@ -4815,6 +4815,10 @@ type VmwareAdminControlPlaneNodeConfig struct { // of the admin cluster. Memory int64 `json:"memory,omitempty,string"` + // Replicas: The number of control plane nodes for this VMware admin + // cluster. (default: 1 replica). + Replicas int64 `json:"replicas,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "Cpus") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -4875,6 +4879,37 @@ func (s *VmwareAdminF5BigIpConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// VmwareAdminHAControlPlaneConfig: Specifies HA admin control plane +// config. +type VmwareAdminHAControlPlaneConfig struct { + // ControlPlaneIpBlock: Static IP addresses for the admin control plane + // nodes. + ControlPlaneIpBlock *VmwareIpBlock `json:"controlPlaneIpBlock,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ControlPlaneIpBlock") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ControlPlaneIpBlock") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *VmwareAdminHAControlPlaneConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareAdminHAControlPlaneConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // VmwareAdminLoadBalancerConfig: VmwareAdminLoadBalancerConfig contains // load balancer configuration for VMware admin cluster. type VmwareAdminLoadBalancerConfig struct { @@ -4887,6 +4922,10 @@ type VmwareAdminLoadBalancerConfig struct { // MetalLbConfig: MetalLB load balancers. MetalLbConfig *VmwareAdminMetalLbConfig `json:"metalLbConfig,omitempty"` + // SeesawConfig: Output only. Configuration for Seesaw typed load + // balancers. + SeesawConfig *VmwareAdminSeesawConfig `json:"seesawConfig,omitempty"` + // VipConfig: The VIPs used by the load balancer. VipConfig *VmwareAdminVipConfig `json:"vipConfig,omitempty"` @@ -4972,6 +5011,10 @@ type VmwareAdminNetworkConfig struct { // DhcpIpConfig: Configuration settings for a DHCP IP configuration. DhcpIpConfig *VmwareDhcpIpConfig `json:"dhcpIpConfig,omitempty"` + // HaControlPlaneConfig: Configuration for HA admin cluster control + // plane. + HaControlPlaneConfig *VmwareAdminHAControlPlaneConfig `json:"haControlPlaneConfig,omitempty"` + // HostConfig: Represents common network settings irrespective of the // host's IP address. HostConfig *VmwareHostConfig `json:"hostConfig,omitempty"` @@ -5015,6 +5058,66 @@ func (s *VmwareAdminNetworkConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// VmwareAdminSeesawConfig: VmwareSeesawConfig represents configuration +// parameters for an already existing Seesaw load balancer. IMPORTANT: +// Please note that the Anthos On-Prem API will not generate or update +// Seesaw configurations it can only bind a pre-existing configuration +// to a new user cluster. IMPORTANT: When attempting to create a user +// cluster with a pre-existing Seesaw load balancer you will need to +// follow some preparation steps before calling the +// 'CreateVmwareCluster' API method. First you will need to create the +// user cluster's namespace via kubectl. The namespace will need to use +// the following naming convention : -gke-onprem-mgmt or +// -gke-onprem-mgmt depending on whether you used the +// 'VmwareCluster.local_name' to disambiguate collisions; for more +// context see the documentation of 'VmwareCluster.local_name'. Once the +// namespace is created you will need to create a secret resource via +// kubectl. This secret will contain copies of your Seesaw credentials. +// The Secret must be called 'user-cluster-creds' and contain Seesaw's +// SSH and Cert credentials. The credentials must be keyed with the +// following names: 'seesaw-ssh-private-key', 'seesaw-ssh-public-key', +// 'seesaw-ssh-ca-key', 'seesaw-ssh-ca-cert'. +type VmwareAdminSeesawConfig struct { + // EnableHa: Enable two load balancer VMs to achieve a highly-available + // Seesaw load balancer. + EnableHa bool `json:"enableHa,omitempty"` + + // Group: In general the following format should be used for the Seesaw + // group name: seesaw-for-[cluster_name]. + Group string `json:"group,omitempty"` + + // IpBlocks: The IP Blocks to be used by the Seesaw load balancer + IpBlocks []*VmwareIpBlock `json:"ipBlocks,omitempty"` + + // MasterIp: MasterIP is the IP announced by the master of Seesaw group. + MasterIp string `json:"masterIp,omitempty"` + + // Vms: Names of the VMs created for this Seesaw group. + Vms []string `json:"vms,omitempty"` + + // ForceSendFields is a list of field names (e.g. "EnableHa") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "EnableHa") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *VmwareAdminSeesawConfig) MarshalJSON() ([]byte, error) { + type NoMethod VmwareAdminSeesawConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // VmwareAdminVCenterConfig: VmwareAdminVCenterConfig contains VCenter // configuration for VMware admin cluster. type VmwareAdminVCenterConfig struct { @@ -5384,7 +5487,7 @@ type VmwareControlPlaneNodeConfig struct { // cluster. (default: 1 replica). Replicas int64 `json:"replicas,omitempty,string"` - // VsphereConfig: Output only. Vsphere-specific config. + // VsphereConfig: Vsphere-specific config. VsphereConfig *VmwareControlPlaneVsphereConfig `json:"vsphereConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "AutoResizeConfig") to @@ -5897,8 +6000,7 @@ type VmwareNodeConfig struct { // Taints: The initial taints assigned to nodes of this node pool. Taints []*NodeTaint `json:"taints,omitempty"` - // VsphereConfig: Output only. Specifies the vSphere config for node - // pool. + // VsphereConfig: Specifies the vSphere config for node pool. VsphereConfig *VmwareVsphereConfig `json:"vsphereConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "BootDiskSizeGb") to diff --git a/go.mod b/go.mod index e52e0e20f07..a7c1e3f649c 100644 --- a/go.mod +++ b/go.mod @@ -14,8 +14,8 @@ require ( golang.org/x/oauth2 v0.10.0 golang.org/x/sync v0.3.0 google.golang.org/appengine v1.6.7 - google.golang.org/genproto/googleapis/bytestream v0.0.0-20230711160842-782d3b101e98 - google.golang.org/genproto/googleapis/rpc v0.0.0-20230711160842-782d3b101e98 + google.golang.org/genproto/googleapis/bytestream v0.0.0-20230720185612-659f7aaaa771 + google.golang.org/genproto/googleapis/rpc v0.0.0-20230720185612-659f7aaaa771 google.golang.org/grpc v1.56.2 google.golang.org/protobuf v1.31.0 ) diff --git a/go.sum b/go.sum index 84bcf1b7f10..382e4c61933 100644 --- a/go.sum +++ b/go.sum @@ -160,10 +160,10 @@ google.golang.org/genproto v0.0.0-20230706204954-ccb25ca9f130 h1:Au6te5hbKUV8pIY google.golang.org/genproto v0.0.0-20230706204954-ccb25ca9f130/go.mod h1:O9kGHb51iE/nOGvQaDUuadVYqovW56s5emA88lQnj6Y= google.golang.org/genproto/googleapis/api v0.0.0-20230706204954-ccb25ca9f130 h1:XVeBY8d/FaK4848myy41HBqnDwvxeV3zMZhwN1TvAMU= google.golang.org/genproto/googleapis/api v0.0.0-20230706204954-ccb25ca9f130/go.mod h1:mPBs5jNgx2GuQGvFwUvVKqtn6HsUw9nP64BedgvqEsQ= -google.golang.org/genproto/googleapis/bytestream v0.0.0-20230711160842-782d3b101e98 h1:Hm7pO7oy28D47G/nht5kL85gWK/270UoRu7tx7rU0xg= -google.golang.org/genproto/googleapis/bytestream v0.0.0-20230711160842-782d3b101e98/go.mod h1:3QoBVwTHkXbY1oRGzlhwhOykfcATQN43LJ6iT8Wy8kE= -google.golang.org/genproto/googleapis/rpc v0.0.0-20230711160842-782d3b101e98 h1:bVf09lpb+OJbByTj913DRJioFFAjf/ZGxEz7MajTp2U= -google.golang.org/genproto/googleapis/rpc v0.0.0-20230711160842-782d3b101e98/go.mod h1:TUfxEVdsvPg18p6AslUXFoLdpED4oBnGwyqk3dV1XzM= +google.golang.org/genproto/googleapis/bytestream v0.0.0-20230720185612-659f7aaaa771 h1:gm8vsVR64Jx1GxHY8M+p8YA2bxU/H/lymcutB2l7l9s= +google.golang.org/genproto/googleapis/bytestream v0.0.0-20230720185612-659f7aaaa771/go.mod h1:3QoBVwTHkXbY1oRGzlhwhOykfcATQN43LJ6iT8Wy8kE= +google.golang.org/genproto/googleapis/rpc v0.0.0-20230720185612-659f7aaaa771 h1:Z8qdAF9GFsmcUuWQ5KVYIpP3PCKydn/YKORnghIalu4= +google.golang.org/genproto/googleapis/rpc v0.0.0-20230720185612-659f7aaaa771/go.mod h1:TUfxEVdsvPg18p6AslUXFoLdpED4oBnGwyqk3dV1XzM= google.golang.org/grpc v1.19.0/go.mod h1:mqu4LbDTu4XGKhr4mRzUsmM4RtVoemTSY81AxZiDr8c= google.golang.org/grpc v1.23.0/go.mod h1:Y5yQAOtifL1yxbo5wqy6BxZv8vAUGQwXBOALyacEbxg= google.golang.org/grpc v1.25.1/go.mod h1:c3i+UQWmh7LiEpx4sFZnkU36qjEYZ0imhYfXVyQciAY= 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/internal/version.go b/internal/version.go index 7a7266777bb..f91a0a3a60b 100644 --- a/internal/version.go +++ b/internal/version.go @@ -5,4 +5,4 @@ package internal // Version is the current tagged release of the library. -const Version = "0.132.0" +const Version = "0.133.0" 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/monitoring/v3/monitoring-api.json b/monitoring/v3/monitoring-api.json index f10a7fef98b..352c170ed1d 100644 --- a/monitoring/v3/monitoring-api.json +++ b/monitoring/v3/monitoring-api.json @@ -2714,7 +2714,7 @@ } } }, - "revision": "20230703", + "revision": "20230716", "rootUrl": "https://monitoring.googleapis.com/", "schemas": { "Aggregation": { @@ -2854,7 +2854,7 @@ "description": "A read-only record of the creation of the alerting policy. If provided in a call to create or update, this field will be ignored." }, "displayName": { - "description": "A short name or phrase used to identify the policy in dashboards, notifications, and incidents. To avoid confusion, don't use the same display name for multiple policies in the same project. The name is limited to 512 Unicode characters.The convention for the display_name of a PrometheusQueryLanguageCondition is \"/\", where the and should be taken from the corresponding Prometheus configuration file. This convention is not enforced. In any case the display_name is not a unique key of the AlertPolicy.", + "description": "A short name or phrase used to identify the policy in dashboards, notifications, and incidents. To avoid confusion, don't use the same display name for multiple policies in the same project. The name is limited to 512 Unicode characters.The convention for the display_name of a PrometheusQueryLanguageCondition is \"{rule group name}/{alert name}\", where the {rule group name} and {alert name} should be taken from the corresponding Prometheus configuration file. This convention is not enforced. In any case the display_name is not a unique key of the AlertPolicy.", "type": "string" }, "documentation": { @@ -2884,7 +2884,7 @@ "additionalProperties": { "type": "string" }, - "description": "User-supplied key/value data to be used for organizing and identifying the AlertPolicy objects.The field can contain up to 64 entries. Each key and value is limited to 63 Unicode characters or 128 bytes, whichever is smaller. Labels and values can contain only lowercase letters, numerals, underscores, and dashes. Keys must begin with a letter.Note that Prometheus and are valid Prometheus label names (https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels). This means that they cannot be stored as is in user labels, because Prometheus labels may contain upper-case letters.", + "description": "User-supplied key/value data to be used for organizing and identifying the AlertPolicy objects.The field can contain up to 64 entries. Each key and value is limited to 63 Unicode characters or 128 bytes, whichever is smaller. Labels and values can contain only lowercase letters, numerals, underscores, and dashes. Keys must begin with a letter.Note that Prometheus {rule group name} and {alert name} are valid Prometheus label names (https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels). This means that they cannot be stored as-is in user labels, because Prometheus labels may contain upper-case letters.", "type": "object" }, "validity": { @@ -3033,6 +3033,22 @@ }, "type": "object" }, + "CloudFunctionV2Target": { + "description": "A Synthetic Monitor deployed to a Cloud Functions V2 instance.", + "id": "CloudFunctionV2Target", + "properties": { + "cloudRunRevision": { + "$ref": "MonitoredResource", + "description": "Output only. The cloud_run_revision Monitored Resource associated with the GCFv2. The Synthetic Monitor execution results (metrics, logs, and spans) are reported against this Monitored Resource. This field is output only.", + "readOnly": true + }, + "name": { + "description": "Required. Fully qualified GCFv2 resource name i.e. projects/{project}/locations/{location}/functions/{function} Required.", + "type": "string" + } + }, + "type": "object" + }, "CloudRun": { "description": "Cloud Run service. Learn more at https://cloud.google.com/run.", "id": "CloudRun", @@ -5503,6 +5519,17 @@ }, "type": "object" }, + "SyntheticMonitorTarget": { + "description": "Describes a Synthetic Monitor to be invoked by Uptime.", + "id": "SyntheticMonitorTarget", + "properties": { + "cloudFunctionV2": { + "$ref": "CloudFunctionV2Target", + "description": "Target a Synthetic Monitor GCFv2 instance." + } + }, + "type": "object" + }, "TcpCheck": { "description": "Information required for a TCP Uptime check request.", "id": "TcpCheck", @@ -5866,6 +5893,10 @@ }, "type": "array" }, + "syntheticMonitor": { + "$ref": "SyntheticMonitorTarget", + "description": "Specifies a Synthetic Monitor to invoke." + }, "tcpCheck": { "$ref": "TcpCheck", "description": "Contains information needed to make a TCP check." diff --git a/monitoring/v3/monitoring-gen.go b/monitoring/v3/monitoring-gen.go index 243f415aab4..ae02f2fbe5e 100644 --- a/monitoring/v3/monitoring-gen.go +++ b/monitoring/v3/monitoring-gen.go @@ -702,10 +702,11 @@ type AlertPolicy struct { // dashboards, notifications, and incidents. To avoid confusion, don't // use the same display name for multiple policies in the same project. // The name is limited to 512 Unicode characters.The convention for the - // display_name of a PrometheusQueryLanguageCondition is "/", where the - // and should be taken from the corresponding Prometheus configuration - // file. This convention is not enforced. In any case the display_name - // is not a unique key of the AlertPolicy. + // display_name of a PrometheusQueryLanguageCondition is "{rule group + // name}/{alert name}", where the {rule group name} and {alert name} + // should be taken from the corresponding Prometheus configuration file. + // This convention is not enforced. In any case the display_name is not + // a unique key of the AlertPolicy. DisplayName string `json:"displayName,omitempty"` // Documentation: Documentation that is included with notifications and @@ -752,10 +753,10 @@ type AlertPolicy struct { // 64 entries. Each key and value is limited to 63 Unicode characters or // 128 bytes, whichever is smaller. Labels and values can contain only // lowercase letters, numerals, underscores, and dashes. Keys must begin - // with a letter.Note that Prometheus and are valid Prometheus label - // names + // with a letter.Note that Prometheus {rule group name} and {alert name} + // are valid Prometheus label names // (https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels). - // This means that they cannot be stored as is in user labels, because + // This means that they cannot be stored as-is in user labels, because // Prometheus labels may contain upper-case letters. UserLabels map[string]string `json:"userLabels,omitempty"` @@ -1081,6 +1082,44 @@ func (s *CloudEndpoints) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// CloudFunctionV2Target: A Synthetic Monitor deployed to a Cloud +// Functions V2 instance. +type CloudFunctionV2Target struct { + // CloudRunRevision: Output only. The cloud_run_revision Monitored + // Resource associated with the GCFv2. The Synthetic Monitor execution + // results (metrics, logs, and spans) are reported against this + // Monitored Resource. This field is output only. + CloudRunRevision *MonitoredResource `json:"cloudRunRevision,omitempty"` + + // Name: Required. Fully qualified GCFv2 resource name i.e. + // projects/{project}/locations/{location}/functions/{function} + // Required. + Name string `json:"name,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CloudRunRevision") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CloudRunRevision") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *CloudFunctionV2Target) MarshalJSON() ([]byte, error) { + type NoMethod CloudFunctionV2Target + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // CloudRun: Cloud Run service. Learn more at // https://cloud.google.com/run. type CloudRun struct { @@ -5795,6 +5834,36 @@ func (s *Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// SyntheticMonitorTarget: Describes a Synthetic Monitor to be invoked +// by Uptime. +type SyntheticMonitorTarget struct { + // CloudFunctionV2: Target a Synthetic Monitor GCFv2 instance. + CloudFunctionV2 *CloudFunctionV2Target `json:"cloudFunctionV2,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CloudFunctionV2") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CloudFunctionV2") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *SyntheticMonitorTarget) MarshalJSON() ([]byte, error) { + type NoMethod SyntheticMonitorTarget + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // TcpCheck: Information required for a TCP Uptime check request. type TcpCheck struct { // PingConfig: Contains information needed to add pings to a TCP check. @@ -6404,6 +6473,9 @@ type UptimeCheckConfig struct { // eastern United States of America SelectedRegions []string `json:"selectedRegions,omitempty"` + // SyntheticMonitor: Specifies a Synthetic Monitor to invoke. + SyntheticMonitor *SyntheticMonitorTarget `json:"syntheticMonitor,omitempty"` + // TcpCheck: Contains information needed to make a TCP check. TcpCheck *TcpCheck `json:"tcpCheck,omitempty"` 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/networkconnectivity/v1alpha1/networkconnectivity-api.json b/networkconnectivity/v1alpha1/networkconnectivity-api.json index 108a32d6911..ece2bbdecef 100644 --- a/networkconnectivity/v1alpha1/networkconnectivity-api.json +++ b/networkconnectivity/v1alpha1/networkconnectivity-api.json @@ -203,7 +203,7 @@ "type": "string" }, "requestId": { - "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "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 if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" } @@ -236,7 +236,7 @@ "type": "string" }, "requestId": { - "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes 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 if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "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 if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" } @@ -368,7 +368,7 @@ "type": "string" }, "requestId": { - "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "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 if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, @@ -861,7 +861,7 @@ "type": "string" }, "requestId": { - "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "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 if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, @@ -899,7 +899,7 @@ "type": "string" }, "requestId": { - "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes 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 if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "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 if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" } @@ -1031,7 +1031,7 @@ "type": "string" }, "requestId": { - "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "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 if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, @@ -1116,7 +1116,7 @@ } } }, - "revision": "20230627", + "revision": "20230712", "rootUrl": "https://networkconnectivity.googleapis.com/", "schemas": { "AuditConfig": { diff --git a/networkconnectivity/v1alpha1/networkconnectivity-gen.go b/networkconnectivity/v1alpha1/networkconnectivity-gen.go index 6287fdcd50f..2d2b9bf5b1f 100644 --- a/networkconnectivity/v1alpha1/networkconnectivity-gen.go +++ b/networkconnectivity/v1alpha1/networkconnectivity-gen.go @@ -1787,16 +1787,16 @@ func (c *ProjectsLocationsGlobalHubsCreateCall) HubId(hubId string) *ProjectsLoc return c } -// RequestId sets the optional parameter "requestId": An optional -// request ID to identify requests. Specify a unique request ID so that -// if you must retry your request, the server will know to ignore the -// request if it has already been completed. The server will guarantee -// that for at least 60 minutes since the first request. For example, -// consider a situation where you make an initial request and the -// request times out. If you make the request again with the same -// request ID, the server can check if original operation with the same -// request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate +// 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 if original operation with +// the same request ID was received, and if so, will ignore the second +// request. This prevents clients from accidentally creating duplicate // commitments. The request ID must be a valid UUID with the exception // that zero UUID is not supported // (00000000-0000-0000-0000-000000000000). @@ -1917,7 +1917,7 @@ func (c *ProjectsLocationsGlobalHubsCreateCall) Do(opts ...googleapi.CallOption) // "type": "string" // }, // "requestId": { - // "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + // "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 if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", // "location": "query", // "type": "string" // } @@ -1955,16 +1955,16 @@ func (r *ProjectsLocationsGlobalHubsService) Delete(name string) *ProjectsLocati return c } -// RequestId sets the optional parameter "requestId": An optional -// request ID to identify requests. Specify a unique request ID so that -// if you must retry your request, the server will know to ignore the -// request if it has already been completed. The server will guarantee -// that for at least 60 minutes 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 if original operation with the same -// request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate +// 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 if original operation with +// the same request ID was received, and if so, will ignore the second +// request. This prevents clients from accidentally creating duplicate // commitments. The request ID must be a valid UUID with the exception // that zero UUID is not supported // (00000000-0000-0000-0000-000000000000). @@ -2075,7 +2075,7 @@ func (c *ProjectsLocationsGlobalHubsDeleteCall) Do(opts ...googleapi.CallOption) // "type": "string" // }, // "requestId": { - // "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes 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 if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + // "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 if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", // "location": "query", // "type": "string" // } @@ -2650,16 +2650,16 @@ func (r *ProjectsLocationsGlobalHubsService) Patch(name string, hub *Hub) *Proje return c } -// RequestId sets the optional parameter "requestId": An optional -// request ID to identify requests. Specify a unique request ID so that -// if you must retry your request, the server will know to ignore the -// request if it has already been completed. The server will guarantee -// that for at least 60 minutes since the first request. For example, -// consider a situation where you make an initial request and the -// request times out. If you make the request again with the same -// request ID, the server can check if original operation with the same -// request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate +// 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 if original operation with +// the same request ID was received, and if so, will ignore the second +// request. This prevents clients from accidentally creating duplicate // commitments. The request ID must be a valid UUID with the exception // that zero UUID is not supported // (00000000-0000-0000-0000-000000000000). @@ -2786,7 +2786,7 @@ func (c *ProjectsLocationsGlobalHubsPatchCall) Do(opts ...googleapi.CallOption) // "type": "string" // }, // "requestId": { - // "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + // "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 if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", // "location": "query", // "type": "string" // }, @@ -5122,16 +5122,16 @@ func (r *ProjectsLocationsSpokesService) Create(parent string, spoke *Spoke) *Pr return c } -// RequestId sets the optional parameter "requestId": An optional -// request ID to identify requests. Specify a unique request ID so that -// if you must retry your request, the server will know to ignore the -// request if it has already been completed. The server will guarantee -// that for at least 60 minutes since the first request. For example, -// consider a situation where you make an initial request and the -// request times out. If you make the request again with the same -// request ID, the server can check if original operation with the same -// request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate +// 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 if original operation with +// the same request ID was received, and if so, will ignore the second +// request. This prevents clients from accidentally creating duplicate // commitments. The request ID must be a valid UUID with the exception // that zero UUID is not supported // (00000000-0000-0000-0000-000000000000). @@ -5254,7 +5254,7 @@ func (c *ProjectsLocationsSpokesCreateCall) Do(opts ...googleapi.CallOption) (*G // "type": "string" // }, // "requestId": { - // "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + // "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 if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", // "location": "query", // "type": "string" // }, @@ -5297,16 +5297,16 @@ func (r *ProjectsLocationsSpokesService) Delete(name string) *ProjectsLocationsS return c } -// RequestId sets the optional parameter "requestId": An optional -// request ID to identify requests. Specify a unique request ID so that -// if you must retry your request, the server will know to ignore the -// request if it has already been completed. The server will guarantee -// that for at least 60 minutes 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 if original operation with the same -// request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate +// 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 if original operation with +// the same request ID was received, and if so, will ignore the second +// request. This prevents clients from accidentally creating duplicate // commitments. The request ID must be a valid UUID with the exception // that zero UUID is not supported // (00000000-0000-0000-0000-000000000000). @@ -5417,7 +5417,7 @@ func (c *ProjectsLocationsSpokesDeleteCall) Do(opts ...googleapi.CallOption) (*G // "type": "string" // }, // "requestId": { - // "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes 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 if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + // "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 if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", // "location": "query", // "type": "string" // } @@ -5991,16 +5991,16 @@ func (r *ProjectsLocationsSpokesService) Patch(name string, spoke *Spoke) *Proje return c } -// RequestId sets the optional parameter "requestId": An optional -// request ID to identify requests. Specify a unique request ID so that -// if you must retry your request, the server will know to ignore the -// request if it has already been completed. The server will guarantee -// that for at least 60 minutes since the first request. For example, -// consider a situation where you make an initial request and the -// request times out. If you make the request again with the same -// request ID, the server can check if original operation with the same -// request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate +// 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 if original operation with +// the same request ID was received, and if so, will ignore the second +// request. This prevents clients from accidentally creating duplicate // commitments. The request ID must be a valid UUID with the exception // that zero UUID is not supported // (00000000-0000-0000-0000-000000000000). @@ -6127,7 +6127,7 @@ func (c *ProjectsLocationsSpokesPatchCall) Do(opts ...googleapi.CallOption) (*Go // "type": "string" // }, // "requestId": { - // "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + // "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 if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", // "location": "query", // "type": "string" // }, diff --git a/networksecurity/v1beta1/networksecurity-api.json b/networksecurity/v1beta1/networksecurity-api.json index b736c28f9d2..7634a4b5aec 100644 --- a/networksecurity/v1beta1/networksecurity-api.json +++ b/networksecurity/v1beta1/networksecurity-api.json @@ -705,6 +705,330 @@ ] } } + }, + "securityProfileGroups": { + "methods": { + "create": { + "description": "Creates a new SecurityProfileGroup in a given organization and location.", + "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfileGroups", + "httpMethod": "POST", + "id": "networksecurity.organizations.locations.securityProfileGroups.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource of the SecurityProfileGroup. Must be in the format `projects|organizations/*/locations/{location}`.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "securityProfileGroupId": { + "description": "Required. Short name of the SecurityProfileGroup resource to be created. This value should be 1-63 characters long, containing only letters, numbers, hyphens, and underscores, and should not start with a number. E.g. \"security_profile_group1\".", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/{+parent}/securityProfileGroups", + "request": { + "$ref": "SecurityProfileGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single SecurityProfileGroup.", + "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfileGroups/{securityProfileGroupsId}", + "httpMethod": "DELETE", + "id": "networksecurity.organizations.locations.securityProfileGroups.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "etag": { + "description": "Optional. If client provided etag is out of date, delete will return FAILED_PRECONDITION error.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. A name of the SecurityProfileGroup to delete. Must be in the format `projects|organizations/*/locations/{location}/securityProfileGroups/{security_profile_group}`.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/securityProfileGroups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single SecurityProfileGroup.", + "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfileGroups/{securityProfileGroupsId}", + "httpMethod": "GET", + "id": "networksecurity.organizations.locations.securityProfileGroups.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. A name of the SecurityProfileGroup to get. Must be in the format `projects|organizations/*/locations/{location}/securityProfileGroups/{security_profile_group}`.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/securityProfileGroups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "response": { + "$ref": "SecurityProfileGroup" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists SecurityProfileGroups in a given organization and location.", + "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfileGroups", + "httpMethod": "GET", + "id": "networksecurity.organizations.locations.securityProfileGroups.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Maximum number of SecurityProfileGroups to return per call.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The value returned by the last `ListSecurityProfileGroupsResponse` Indicates that this is a continuation of a prior `ListSecurityProfileGroups` call, and that the system should return the next page of data.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The project or organization and location from which the SecurityProfileGroups should be listed, specified in the format `projects|organizations/*/locations/{location}`.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+parent}/securityProfileGroups", + "response": { + "$ref": "ListSecurityProfileGroupsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single SecurityProfileGroup.", + "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfileGroups/{securityProfileGroupsId}", + "httpMethod": "PATCH", + "id": "networksecurity.organizations.locations.securityProfileGroups.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Immutable. Name of the SecurityProfileGroup resource. It matches pattern `projects|organizations/*/locations/{location}/securityProfileGroups/{security_profile_group}`.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/securityProfileGroups/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. Field mask is used to specify the fields to be overwritten in the SecurityProfileGroup resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "request": { + "$ref": "SecurityProfileGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, + "securityProfiles": { + "methods": { + "create": { + "description": "Creates a new SecurityProfile in a given organization and location.", + "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfiles", + "httpMethod": "POST", + "id": "networksecurity.organizations.locations.securityProfiles.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource of the SecurityProfile. Must be in the format `projects|organizations/*/locations/{location}`.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "securityProfileId": { + "description": "Required. Short name of the SecurityProfile resource to be created. This value should be 1-63 characters long, containing only letters, numbers, hyphens, and underscores, and should not start with a number. E.g. \"security_profile1\".", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/{+parent}/securityProfiles", + "request": { + "$ref": "SecurityProfile" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single SecurityProfile.", + "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfiles/{securityProfilesId}", + "httpMethod": "DELETE", + "id": "networksecurity.organizations.locations.securityProfiles.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "etag": { + "description": "Optional. If client provided etag is out of date, delete will return FAILED_PRECONDITION error.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. A name of the SecurityProfile to delete. Must be in the format `projects|organizations/*/locations/{location}/securityProfiles/{security_profile_id}`.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/securityProfiles/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single SecurityProfile.", + "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfiles/{securityProfilesId}", + "httpMethod": "GET", + "id": "networksecurity.organizations.locations.securityProfiles.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. A name of the SecurityProfile to get. Must be in the format `projects|organizations/*/locations/{location}/securityProfiles/{security_profile_id}`.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/securityProfiles/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "response": { + "$ref": "SecurityProfile" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists SecurityProfiles in a given organization and location.", + "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfiles", + "httpMethod": "GET", + "id": "networksecurity.organizations.locations.securityProfiles.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Maximum number of SecurityProfiles to return per call.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The value returned by the last `ListSecurityProfilesResponse` Indicates that this is a continuation of a prior `ListSecurityProfiles` call, and that the system should return the next page of data.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The project or organization and location from which the SecurityProfiles should be listed, specified in the format `projects|organizations/*/locations/{location}`.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+parent}/securityProfiles", + "response": { + "$ref": "ListSecurityProfilesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single SecurityProfile.", + "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfiles/{securityProfilesId}", + "httpMethod": "PATCH", + "id": "networksecurity.organizations.locations.securityProfiles.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Immutable. Name of the SecurityProfile resource. It matches pattern `projects|organizations/*/locations/{location}/securityProfiles/{security_profile}`.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/securityProfiles/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. Field mask is used to specify the fields to be overwritten in the SecurityProfile resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "request": { + "$ref": "SecurityProfile" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } } } } @@ -2838,7 +3162,7 @@ } } }, - "revision": "20230710", + "revision": "20230719", "rootUrl": "https://networksecurity.googleapis.com/", "schemas": { "AddAddressGroupItemsRequest": { @@ -3755,6 +4079,42 @@ }, "type": "object" }, + "ListSecurityProfileGroupsResponse": { + "description": "Response returned by the ListSecurityProfileGroups method.", + "id": "ListSecurityProfileGroupsResponse", + "properties": { + "nextPageToken": { + "description": "If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`.", + "type": "string" + }, + "securityProfileGroups": { + "description": "List of SecurityProfileGroups resources.", + "items": { + "$ref": "SecurityProfileGroup" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListSecurityProfilesResponse": { + "description": "Response returned by the ListSecurityProfiles method.", + "id": "ListSecurityProfilesResponse", + "properties": { + "nextPageToken": { + "description": "If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`.", + "type": "string" + }, + "securityProfiles": { + "description": "List of SecurityProfile resources.", + "items": { + "$ref": "SecurityProfile" + }, + "type": "array" + } + }, + "type": "object" + }, "ListServerTlsPoliciesResponse": { "description": "Response returned by the ListServerTlsPolicies method.", "id": "ListServerTlsPoliciesResponse", @@ -4007,6 +4367,104 @@ }, "type": "object" }, + "SecurityProfile": { + "description": "SecurityProfile is a resource that defines the behavior for one of many ProfileTypes. Next ID: 9", + "id": "SecurityProfile", + "properties": { + "createTime": { + "description": "Output only. Resource creation timestamp.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. An optional description of the profile. Max length 512 characters.", + "type": "string" + }, + "etag": { + "description": "Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.", + "readOnly": true, + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Labels as key value pairs.", + "type": "object" + }, + "name": { + "description": "Immutable. Name of the SecurityProfile resource. It matches pattern `projects|organizations/*/locations/{location}/securityProfiles/{security_profile}`.", + "type": "string" + }, + "threatPreventionProfile": { + "$ref": "ThreatPreventionProfile", + "description": "The threat prevention configuration for the SecurityProfile." + }, + "type": { + "description": "Immutable. The single ProfileType that the SecurityProfile resource configures.", + "enum": [ + "PROFILE_TYPE_UNSPECIFIED", + "THREAT_PREVENTION" + ], + "enumDescriptions": [ + "Profile type not specified.", + "Profile type for threat prevention." + ], + "type": "string" + }, + "updateTime": { + "description": "Output only. Last resource update timestamp.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "SecurityProfileGroup": { + "description": "SecurityProfileGroup is a resource that defines the behavior for various ProfileTypes. Next ID: 8", + "id": "SecurityProfileGroup", + "properties": { + "createTime": { + "description": "Output only. Resource creation timestamp.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. An optional description of the profile group. Max length 2048 characters.", + "type": "string" + }, + "etag": { + "description": "Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.", + "readOnly": true, + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Labels as key value pairs.", + "type": "object" + }, + "name": { + "description": "Immutable. Name of the SecurityProfileGroup resource. It matches pattern `projects|organizations/*/locations/{location}/securityProfileGroups/{security_profile_group}`.", + "type": "string" + }, + "threatPreventionProfile": { + "description": "Optional. Reference to a SecurityProfile with the threat prevention configuration for the SecurityProfileGroup.", + "type": "string" + }, + "updateTime": { + "description": "Output only. Last resource update timestamp.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "ServerTlsPolicy": { "description": "ServerTlsPolicy is a resource that specifies how a server should authenticate incoming requests. This resource itself does not affect configuration unless it is attached to a target HTTPS proxy or endpoint config selector resource. ServerTlsPolicy in the form accepted by external HTTPS load balancers can be attached only to TargetHttpsProxy with an `EXTERNAL` or `EXTERNAL_MANAGED` load balancing scheme. Traffic Director compatible ServerTlsPolicies can be attached to EndpointPolicy and TargetHttpsProxy with Traffic Director `INTERNAL_SELF_MANAGED` load balancing scheme.", "id": "ServerTlsPolicy", @@ -4053,6 +4511,51 @@ }, "type": "object" }, + "SeverityOverride": { + "description": "Defines what action to take for a specific severity match.", + "id": "SeverityOverride", + "properties": { + "action": { + "description": "Required. Threat action override.", + "enum": [ + "THREAT_ACTION_UNSPECIFIED", + "DEFAULT_ACTION", + "ALLOW", + "ALERT", + "DENY" + ], + "enumDescriptions": [ + "Threat action not specified.", + "The default action (as specified by the vendor) is taken.", + "The packet matching this rule will be allowed to transmit.", + "The packet matching this rule will be allowed to transmit, but a threat_log entry will be sent to the consumer project.", + "The packet matching this rule will be dropped, and a threat_log entry will be sent to the consumer project." + ], + "type": "string" + }, + "severity": { + "description": "Required. Severity level to match.", + "enum": [ + "SEVERITY_UNSPECIFIED", + "INFORMATIONAL", + "LOW", + "MEDIUM", + "HIGH", + "CRITICAL" + ], + "enumDescriptions": [ + "Severity level not specified.", + "Suspicious events that do not pose an immediate threat, but that are reported to call attention to deeper problems that could possibly exist.", + "Warning-level threats that have very little impact on an organization's infrastructure. They usually require local or physical system access and may often result in victim privacy issues and information leakage.", + "Minor threats in which impact is minimized, that do not compromise the target or exploits that require an attacker to reside on the same local network as the victim, affect only non-standard configurations or obscure applications, or provide very limited access.", + "Threats that have the ability to become critical but have mitigating factors; for example, they may be difficult to exploit, do not result in elevated privileges, or do not have a large victim pool.", + "Serious threats, such as those that affect default installations of widely deployed software, result in root compromise of servers, and the exploit code is widely available to attackers. The attacker usually does not need any special authentication credentials or knowledge about the individual victims and the target does not need to be manipulated into performing any special functions." + ], + "type": "string" + } + }, + "type": "object" + }, "Source": { "description": "Specification of traffic source attributes.", "id": "Source", @@ -4101,6 +4604,77 @@ }, "type": "object" }, + "ThreatOverride": { + "description": "Defines what action to take for a specific threat_id match.", + "id": "ThreatOverride", + "properties": { + "action": { + "description": "Required. Threat action override. For some threat types, only a subset of actions applies.", + "enum": [ + "THREAT_ACTION_UNSPECIFIED", + "DEFAULT_ACTION", + "ALLOW", + "ALERT", + "DENY" + ], + "enumDescriptions": [ + "Threat action not specified.", + "The default action (as specified by the vendor) is taken.", + "The packet matching this rule will be allowed to transmit.", + "The packet matching this rule will be allowed to transmit, but a threat_log entry will be sent to the consumer project.", + "The packet matching this rule will be dropped, and a threat_log entry will be sent to the consumer project." + ], + "type": "string" + }, + "threatId": { + "description": "Required. Vendor-specific ID of a threat to override.", + "type": "string" + }, + "type": { + "description": "Output only. Type of the threat (read only).", + "enum": [ + "THREAT_TYPE_UNSPECIFIED", + "UNKNOWN", + "VULNERABILITY", + "ANTIVIRUS", + "SPYWARE", + "DNS" + ], + "enumDescriptions": [ + "Type of threat not specified.", + "Type of threat is not derivable from threat ID. An override will be created for all types. Firewall will ignore overridden signature ID's that don't exist in the specific type.", + "Threats related to system flaws that an attacker might otherwise attempt to exploit.", + "Threats related to viruses and malware found in executables and file types.", + "Threats related to command-and-control (C2) activity, where spyware on an infected client is collecting data without the user's consent and/or communicating with a remote attacker.", + "Threats related to DNS." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ThreatPreventionProfile": { + "description": "ThreatPreventionProfile defines an action for specific threat signatures or severity levels.", + "id": "ThreatPreventionProfile", + "properties": { + "severityOverrides": { + "description": "Optional. Configuration for overriding threats actions by severity match.", + "items": { + "$ref": "SeverityOverride" + }, + "type": "array" + }, + "threatOverrides": { + "description": "Optional. Configuration for overriding threats actions by threat_id match. If a threat is matched both by configuration provided in severity_overrides and threat_overrides, the threat_overrides action is applied.", + "items": { + "$ref": "ThreatOverride" + }, + "type": "array" + } + }, + "type": "object" + }, "TlsInspectionPolicy": { "description": "The TlsInspectionPolicy resource contains references to CA pools in Certificate Authority Service and associated metadata.", "id": "TlsInspectionPolicy", diff --git a/networksecurity/v1beta1/networksecurity-gen.go b/networksecurity/v1beta1/networksecurity-gen.go index 17bc11e106d..890b0119cc9 100644 --- a/networksecurity/v1beta1/networksecurity-gen.go +++ b/networksecurity/v1beta1/networksecurity-gen.go @@ -158,6 +158,8 @@ func NewOrganizationsLocationsService(s *Service) *OrganizationsLocationsService rs.AddressGroups = NewOrganizationsLocationsAddressGroupsService(s) rs.FirewallEndpoints = NewOrganizationsLocationsFirewallEndpointsService(s) rs.Operations = NewOrganizationsLocationsOperationsService(s) + rs.SecurityProfileGroups = NewOrganizationsLocationsSecurityProfileGroupsService(s) + rs.SecurityProfiles = NewOrganizationsLocationsSecurityProfilesService(s) return rs } @@ -169,6 +171,10 @@ type OrganizationsLocationsService struct { FirewallEndpoints *OrganizationsLocationsFirewallEndpointsService Operations *OrganizationsLocationsOperationsService + + SecurityProfileGroups *OrganizationsLocationsSecurityProfileGroupsService + + SecurityProfiles *OrganizationsLocationsSecurityProfilesService } func NewOrganizationsLocationsAddressGroupsService(s *Service) *OrganizationsLocationsAddressGroupsService { @@ -198,6 +204,24 @@ type OrganizationsLocationsOperationsService struct { s *Service } +func NewOrganizationsLocationsSecurityProfileGroupsService(s *Service) *OrganizationsLocationsSecurityProfileGroupsService { + rs := &OrganizationsLocationsSecurityProfileGroupsService{s: s} + return rs +} + +type OrganizationsLocationsSecurityProfileGroupsService struct { + s *Service +} + +func NewOrganizationsLocationsSecurityProfilesService(s *Service) *OrganizationsLocationsSecurityProfilesService { + rs := &OrganizationsLocationsSecurityProfilesService{s: s} + return rs +} + +type OrganizationsLocationsSecurityProfilesService struct { + s *Service +} + func NewProjectsService(s *Service) *ProjectsService { rs := &ProjectsService{s: s} rs.Locations = NewProjectsLocationsService(s) @@ -1980,6 +2004,84 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ListSecurityProfileGroupsResponse: Response returned by the +// ListSecurityProfileGroups method. +type ListSecurityProfileGroupsResponse struct { + // NextPageToken: If there might be more results than those appearing in + // this response, then `next_page_token` is included. To get the next + // set of results, call this method again using the value of + // `next_page_token` as `page_token`. + NextPageToken string `json:"nextPageToken,omitempty"` + + // SecurityProfileGroups: List of SecurityProfileGroups resources. + SecurityProfileGroups []*SecurityProfileGroup `json:"securityProfileGroups,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "NextPageToken") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NextPageToken") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListSecurityProfileGroupsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListSecurityProfileGroupsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListSecurityProfilesResponse: Response returned by the +// ListSecurityProfiles method. +type ListSecurityProfilesResponse struct { + // NextPageToken: If there might be more results than those appearing in + // this response, then `next_page_token` is included. To get the next + // set of results, call this method again using the value of + // `next_page_token` as `page_token`. + NextPageToken string `json:"nextPageToken,omitempty"` + + // SecurityProfiles: List of SecurityProfile resources. + SecurityProfiles []*SecurityProfile `json:"securityProfiles,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "NextPageToken") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NextPageToken") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListSecurityProfilesResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListSecurityProfilesResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ListServerTlsPoliciesResponse: Response returned by the // ListServerTlsPolicies method. type ListServerTlsPoliciesResponse struct { @@ -2407,6 +2509,133 @@ func (s *Rule) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// SecurityProfile: SecurityProfile is a resource that defines the +// behavior for one of many ProfileTypes. Next ID: 9 +type SecurityProfile struct { + // CreateTime: Output only. Resource creation timestamp. + CreateTime string `json:"createTime,omitempty"` + + // Description: Optional. An optional description of the profile. Max + // length 512 characters. + Description string `json:"description,omitempty"` + + // Etag: Output only. This checksum is computed by the server based on + // the value of other fields, and may be sent on update and delete + // requests to ensure the client has an up-to-date value before + // proceeding. + Etag string `json:"etag,omitempty"` + + // Labels: Optional. Labels as key value pairs. + Labels map[string]string `json:"labels,omitempty"` + + // Name: Immutable. Name of the SecurityProfile resource. It matches + // pattern + // `projects|organizations/*/locations/{location}/securityProfiles/{secur + // ity_profile}`. + Name string `json:"name,omitempty"` + + // ThreatPreventionProfile: The threat prevention configuration for the + // SecurityProfile. + ThreatPreventionProfile *ThreatPreventionProfile `json:"threatPreventionProfile,omitempty"` + + // Type: Immutable. The single ProfileType that the SecurityProfile + // resource configures. + // + // Possible values: + // "PROFILE_TYPE_UNSPECIFIED" - Profile type not specified. + // "THREAT_PREVENTION" - Profile type for threat prevention. + Type string `json:"type,omitempty"` + + // UpdateTime: Output only. Last resource update timestamp. + UpdateTime string `json:"updateTime,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CreateTime") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *SecurityProfile) MarshalJSON() ([]byte, error) { + type NoMethod SecurityProfile + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// SecurityProfileGroup: SecurityProfileGroup is a resource that defines +// the behavior for various ProfileTypes. Next ID: 8 +type SecurityProfileGroup struct { + // CreateTime: Output only. Resource creation timestamp. + CreateTime string `json:"createTime,omitempty"` + + // Description: Optional. An optional description of the profile group. + // Max length 2048 characters. + Description string `json:"description,omitempty"` + + // Etag: Output only. This checksum is computed by the server based on + // the value of other fields, and may be sent on update and delete + // requests to ensure the client has an up-to-date value before + // proceeding. + Etag string `json:"etag,omitempty"` + + // Labels: Optional. Labels as key value pairs. + Labels map[string]string `json:"labels,omitempty"` + + // Name: Immutable. Name of the SecurityProfileGroup resource. It + // matches pattern + // `projects|organizations/*/locations/{location}/securityProfileGroups/{ + // security_profile_group}`. + Name string `json:"name,omitempty"` + + // ThreatPreventionProfile: Optional. Reference to a SecurityProfile + // with the threat prevention configuration for the + // SecurityProfileGroup. + ThreatPreventionProfile string `json:"threatPreventionProfile,omitempty"` + + // UpdateTime: Output only. Last resource update timestamp. + UpdateTime string `json:"updateTime,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CreateTime") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *SecurityProfileGroup) MarshalJSON() ([]byte, error) { + type NoMethod SecurityProfileGroup + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ServerTlsPolicy: ServerTlsPolicy is a resource that specifies how a // server should authenticate incoming requests. This resource itself // does not affect configuration unless it is attached to a target HTTPS @@ -2491,6 +2720,76 @@ func (s *ServerTlsPolicy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// SeverityOverride: Defines what action to take for a specific severity +// match. +type SeverityOverride struct { + // Action: Required. Threat action override. + // + // Possible values: + // "THREAT_ACTION_UNSPECIFIED" - Threat action not specified. + // "DEFAULT_ACTION" - The default action (as specified by the vendor) + // is taken. + // "ALLOW" - The packet matching this rule will be allowed to + // transmit. + // "ALERT" - The packet matching this rule will be allowed to + // transmit, but a threat_log entry will be sent to the consumer + // project. + // "DENY" - The packet matching this rule will be dropped, and a + // threat_log entry will be sent to the consumer project. + Action string `json:"action,omitempty"` + + // Severity: Required. Severity level to match. + // + // Possible values: + // "SEVERITY_UNSPECIFIED" - Severity level not specified. + // "INFORMATIONAL" - Suspicious events that do not pose an immediate + // threat, but that are reported to call attention to deeper problems + // that could possibly exist. + // "LOW" - Warning-level threats that have very little impact on an + // organization's infrastructure. They usually require local or physical + // system access and may often result in victim privacy issues and + // information leakage. + // "MEDIUM" - Minor threats in which impact is minimized, that do not + // compromise the target or exploits that require an attacker to reside + // on the same local network as the victim, affect only non-standard + // configurations or obscure applications, or provide very limited + // access. + // "HIGH" - Threats that have the ability to become critical but have + // mitigating factors; for example, they may be difficult to exploit, do + // not result in elevated privileges, or do not have a large victim + // pool. + // "CRITICAL" - Serious threats, such as those that affect default + // installations of widely deployed software, result in root compromise + // of servers, and the exploit code is widely available to attackers. + // The attacker usually does not need any special authentication + // credentials or knowledge about the individual victims and the target + // does not need to be manipulated into performing any special + // functions. + Severity string `json:"severity,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Action") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Action") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *SeverityOverride) MarshalJSON() ([]byte, error) { + type NoMethod SeverityOverride + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Source: Specification of traffic source attributes. type Source struct { // IpBlocks: Optional. List of CIDR ranges to match based on source IP @@ -2576,6 +2875,105 @@ func (s *Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ThreatOverride: Defines what action to take for a specific threat_id +// match. +type ThreatOverride struct { + // Action: Required. Threat action override. For some threat types, only + // a subset of actions applies. + // + // Possible values: + // "THREAT_ACTION_UNSPECIFIED" - Threat action not specified. + // "DEFAULT_ACTION" - The default action (as specified by the vendor) + // is taken. + // "ALLOW" - The packet matching this rule will be allowed to + // transmit. + // "ALERT" - The packet matching this rule will be allowed to + // transmit, but a threat_log entry will be sent to the consumer + // project. + // "DENY" - The packet matching this rule will be dropped, and a + // threat_log entry will be sent to the consumer project. + Action string `json:"action,omitempty"` + + // ThreatId: Required. Vendor-specific ID of a threat to override. + ThreatId string `json:"threatId,omitempty"` + + // Type: Output only. Type of the threat (read only). + // + // Possible values: + // "THREAT_TYPE_UNSPECIFIED" - Type of threat not specified. + // "UNKNOWN" - Type of threat is not derivable from threat ID. An + // override will be created for all types. Firewall will ignore + // overridden signature ID's that don't exist in the specific type. + // "VULNERABILITY" - Threats related to system flaws that an attacker + // might otherwise attempt to exploit. + // "ANTIVIRUS" - Threats related to viruses and malware found in + // executables and file types. + // "SPYWARE" - Threats related to command-and-control (C2) activity, + // where spyware on an infected client is collecting data without the + // user's consent and/or communicating with a remote attacker. + // "DNS" - Threats related to DNS. + Type string `json:"type,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Action") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Action") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ThreatOverride) MarshalJSON() ([]byte, error) { + type NoMethod ThreatOverride + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ThreatPreventionProfile: ThreatPreventionProfile defines an action +// for specific threat signatures or severity levels. +type ThreatPreventionProfile struct { + // SeverityOverrides: Optional. Configuration for overriding threats + // actions by severity match. + SeverityOverrides []*SeverityOverride `json:"severityOverrides,omitempty"` + + // ThreatOverrides: Optional. Configuration for overriding threats + // actions by threat_id match. If a threat is matched both by + // configuration provided in severity_overrides and threat_overrides, + // the threat_overrides action is applied. + ThreatOverrides []*ThreatOverride `json:"threatOverrides,omitempty"` + + // ForceSendFields is a list of field names (e.g. "SeverityOverrides") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "SeverityOverrides") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *ThreatPreventionProfile) MarshalJSON() ([]byte, error) { + type NoMethod ThreatPreventionProfile + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // TlsInspectionPolicy: The TlsInspectionPolicy resource contains // references to CA pools in Certificate Authority Service and // associated metadata. @@ -5793,6 +6191,1632 @@ func (c *OrganizationsLocationsOperationsListCall) Pages(ctx context.Context, f } } +// method id "networksecurity.organizations.locations.securityProfileGroups.create": + +type OrganizationsLocationsSecurityProfileGroupsCreateCall struct { + s *Service + parent string + securityprofilegroup *SecurityProfileGroup + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new SecurityProfileGroup in a given organization +// and location. +// +// - parent: The parent resource of the SecurityProfileGroup. Must be in +// the format `projects|organizations/*/locations/{location}`. +func (r *OrganizationsLocationsSecurityProfileGroupsService) Create(parent string, securityprofilegroup *SecurityProfileGroup) *OrganizationsLocationsSecurityProfileGroupsCreateCall { + c := &OrganizationsLocationsSecurityProfileGroupsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.securityprofilegroup = securityprofilegroup + return c +} + +// SecurityProfileGroupId sets the optional parameter +// "securityProfileGroupId": Required. Short name of the +// SecurityProfileGroup resource to be created. This value should be +// 1-63 characters long, containing only letters, numbers, hyphens, and +// underscores, and should not start with a number. E.g. +// "security_profile_group1". +func (c *OrganizationsLocationsSecurityProfileGroupsCreateCall) SecurityProfileGroupId(securityProfileGroupId string) *OrganizationsLocationsSecurityProfileGroupsCreateCall { + c.urlParams_.Set("securityProfileGroupId", securityProfileGroupId) + 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 *OrganizationsLocationsSecurityProfileGroupsCreateCall) Fields(s ...googleapi.Field) *OrganizationsLocationsSecurityProfileGroupsCreateCall { + 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 *OrganizationsLocationsSecurityProfileGroupsCreateCall) Context(ctx context.Context) *OrganizationsLocationsSecurityProfileGroupsCreateCall { + 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 *OrganizationsLocationsSecurityProfileGroupsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsSecurityProfileGroupsCreateCall) 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.securityprofilegroup) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/securityProfileGroups") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networksecurity.organizations.locations.securityProfileGroups.create" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsLocationsSecurityProfileGroupsCreateCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates a new SecurityProfileGroup in a given organization and location.", + // "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfileGroups", + // "httpMethod": "POST", + // "id": "networksecurity.organizations.locations.securityProfileGroups.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The parent resource of the SecurityProfileGroup. Must be in the format `projects|organizations/*/locations/{location}`.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "securityProfileGroupId": { + // "description": "Required. Short name of the SecurityProfileGroup resource to be created. This value should be 1-63 characters long, containing only letters, numbers, hyphens, and underscores, and should not start with a number. E.g. \"security_profile_group1\".", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1beta1/{+parent}/securityProfileGroups", + // "request": { + // "$ref": "SecurityProfileGroup" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "networksecurity.organizations.locations.securityProfileGroups.delete": + +type OrganizationsLocationsSecurityProfileGroupsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a single SecurityProfileGroup. +// +// - name: A name of the SecurityProfileGroup to delete. Must be in the +// format +// `projects|organizations/*/locations/{location}/securityProfileGroups +// /{security_profile_group}`. +func (r *OrganizationsLocationsSecurityProfileGroupsService) Delete(name string) *OrganizationsLocationsSecurityProfileGroupsDeleteCall { + c := &OrganizationsLocationsSecurityProfileGroupsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Etag sets the optional parameter "etag": If client provided etag is +// out of date, delete will return FAILED_PRECONDITION error. +func (c *OrganizationsLocationsSecurityProfileGroupsDeleteCall) Etag(etag string) *OrganizationsLocationsSecurityProfileGroupsDeleteCall { + c.urlParams_.Set("etag", etag) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *OrganizationsLocationsSecurityProfileGroupsDeleteCall) Fields(s ...googleapi.Field) *OrganizationsLocationsSecurityProfileGroupsDeleteCall { + 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 *OrganizationsLocationsSecurityProfileGroupsDeleteCall) Context(ctx context.Context) *OrganizationsLocationsSecurityProfileGroupsDeleteCall { + 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 *OrganizationsLocationsSecurityProfileGroupsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsSecurityProfileGroupsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networksecurity.organizations.locations.securityProfileGroups.delete" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsLocationsSecurityProfileGroupsDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Deletes a single SecurityProfileGroup.", + // "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfileGroups/{securityProfileGroupsId}", + // "httpMethod": "DELETE", + // "id": "networksecurity.organizations.locations.securityProfileGroups.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "etag": { + // "description": "Optional. If client provided etag is out of date, delete will return FAILED_PRECONDITION error.", + // "location": "query", + // "type": "string" + // }, + // "name": { + // "description": "Required. A name of the SecurityProfileGroup to delete. Must be in the format `projects|organizations/*/locations/{location}/securityProfileGroups/{security_profile_group}`.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/[^/]+/securityProfileGroups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta1/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "networksecurity.organizations.locations.securityProfileGroups.get": + +type OrganizationsLocationsSecurityProfileGroupsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of a single SecurityProfileGroup. +// +// - name: A name of the SecurityProfileGroup to get. Must be in the +// format +// `projects|organizations/*/locations/{location}/securityProfileGroups +// /{security_profile_group}`. +func (r *OrganizationsLocationsSecurityProfileGroupsService) Get(name string) *OrganizationsLocationsSecurityProfileGroupsGetCall { + c := &OrganizationsLocationsSecurityProfileGroupsGetCall{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 *OrganizationsLocationsSecurityProfileGroupsGetCall) Fields(s ...googleapi.Field) *OrganizationsLocationsSecurityProfileGroupsGetCall { + 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 *OrganizationsLocationsSecurityProfileGroupsGetCall) IfNoneMatch(entityTag string) *OrganizationsLocationsSecurityProfileGroupsGetCall { + 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 *OrganizationsLocationsSecurityProfileGroupsGetCall) Context(ctx context.Context) *OrganizationsLocationsSecurityProfileGroupsGetCall { + 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 *OrganizationsLocationsSecurityProfileGroupsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsSecurityProfileGroupsGetCall) 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, "v1beta1/{+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 "networksecurity.organizations.locations.securityProfileGroups.get" call. +// Exactly one of *SecurityProfileGroup or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *SecurityProfileGroup.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *OrganizationsLocationsSecurityProfileGroupsGetCall) Do(opts ...googleapi.CallOption) (*SecurityProfileGroup, 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 := &SecurityProfileGroup{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets details of a single SecurityProfileGroup.", + // "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfileGroups/{securityProfileGroupsId}", + // "httpMethod": "GET", + // "id": "networksecurity.organizations.locations.securityProfileGroups.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. A name of the SecurityProfileGroup to get. Must be in the format `projects|organizations/*/locations/{location}/securityProfileGroups/{security_profile_group}`.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/[^/]+/securityProfileGroups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta1/{+name}", + // "response": { + // "$ref": "SecurityProfileGroup" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "networksecurity.organizations.locations.securityProfileGroups.list": + +type OrganizationsLocationsSecurityProfileGroupsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists SecurityProfileGroups in a given organization and +// location. +// +// - parent: The project or organization and location from which the +// SecurityProfileGroups should be listed, specified in the format +// `projects|organizations/*/locations/{location}`. +func (r *OrganizationsLocationsSecurityProfileGroupsService) List(parent string) *OrganizationsLocationsSecurityProfileGroupsListCall { + c := &OrganizationsLocationsSecurityProfileGroupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// SecurityProfileGroups to return per call. +func (c *OrganizationsLocationsSecurityProfileGroupsListCall) PageSize(pageSize int64) *OrganizationsLocationsSecurityProfileGroupsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The value returned +// by the last `ListSecurityProfileGroupsResponse` Indicates that this +// is a continuation of a prior `ListSecurityProfileGroups` call, and +// that the system should return the next page of data. +func (c *OrganizationsLocationsSecurityProfileGroupsListCall) PageToken(pageToken string) *OrganizationsLocationsSecurityProfileGroupsListCall { + 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 *OrganizationsLocationsSecurityProfileGroupsListCall) Fields(s ...googleapi.Field) *OrganizationsLocationsSecurityProfileGroupsListCall { + 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 *OrganizationsLocationsSecurityProfileGroupsListCall) IfNoneMatch(entityTag string) *OrganizationsLocationsSecurityProfileGroupsListCall { + 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 *OrganizationsLocationsSecurityProfileGroupsListCall) Context(ctx context.Context) *OrganizationsLocationsSecurityProfileGroupsListCall { + 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 *OrganizationsLocationsSecurityProfileGroupsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsSecurityProfileGroupsListCall) 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, "v1beta1/{+parent}/securityProfileGroups") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networksecurity.organizations.locations.securityProfileGroups.list" call. +// Exactly one of *ListSecurityProfileGroupsResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *ListSecurityProfileGroupsResponse.ServerResponse.Header or +// (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was +// returned. +func (c *OrganizationsLocationsSecurityProfileGroupsListCall) Do(opts ...googleapi.CallOption) (*ListSecurityProfileGroupsResponse, 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 := &ListSecurityProfileGroupsResponse{ + 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 SecurityProfileGroups in a given organization and location.", + // "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfileGroups", + // "httpMethod": "GET", + // "id": "networksecurity.organizations.locations.securityProfileGroups.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "Maximum number of SecurityProfileGroups to return per call.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The value returned by the last `ListSecurityProfileGroupsResponse` Indicates that this is a continuation of a prior `ListSecurityProfileGroups` call, and that the system should return the next page of data.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The project or organization and location from which the SecurityProfileGroups should be listed, specified in the format `projects|organizations/*/locations/{location}`.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta1/{+parent}/securityProfileGroups", + // "response": { + // "$ref": "ListSecurityProfileGroupsResponse" + // }, + // "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 *OrganizationsLocationsSecurityProfileGroupsListCall) Pages(ctx context.Context, f func(*ListSecurityProfileGroupsResponse) 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 "networksecurity.organizations.locations.securityProfileGroups.patch": + +type OrganizationsLocationsSecurityProfileGroupsPatchCall struct { + s *Service + name string + securityprofilegroup *SecurityProfileGroup + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the parameters of a single SecurityProfileGroup. +// +// - name: Immutable. Name of the SecurityProfileGroup resource. It +// matches pattern +// `projects|organizations/*/locations/{location}/securityProfileGroups +// /{security_profile_group}`. +func (r *OrganizationsLocationsSecurityProfileGroupsService) Patch(name string, securityprofilegroup *SecurityProfileGroup) *OrganizationsLocationsSecurityProfileGroupsPatchCall { + c := &OrganizationsLocationsSecurityProfileGroupsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.securityprofilegroup = securityprofilegroup + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Field +// mask is used to specify the fields to be overwritten in the +// SecurityProfileGroup resource by the update. The fields specified in +// the update_mask are relative to the resource, not the full request. A +// field will be overwritten if it is in the mask. +func (c *OrganizationsLocationsSecurityProfileGroupsPatchCall) UpdateMask(updateMask string) *OrganizationsLocationsSecurityProfileGroupsPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *OrganizationsLocationsSecurityProfileGroupsPatchCall) Fields(s ...googleapi.Field) *OrganizationsLocationsSecurityProfileGroupsPatchCall { + 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 *OrganizationsLocationsSecurityProfileGroupsPatchCall) Context(ctx context.Context) *OrganizationsLocationsSecurityProfileGroupsPatchCall { + 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 *OrganizationsLocationsSecurityProfileGroupsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsSecurityProfileGroupsPatchCall) 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.securityprofilegroup) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networksecurity.organizations.locations.securityProfileGroups.patch" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsLocationsSecurityProfileGroupsPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates the parameters of a single SecurityProfileGroup.", + // "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfileGroups/{securityProfileGroupsId}", + // "httpMethod": "PATCH", + // "id": "networksecurity.organizations.locations.securityProfileGroups.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Immutable. Name of the SecurityProfileGroup resource. It matches pattern `projects|organizations/*/locations/{location}/securityProfileGroups/{security_profile_group}`.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/[^/]+/securityProfileGroups/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Required. Field mask is used to specify the fields to be overwritten in the SecurityProfileGroup resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1beta1/{+name}", + // "request": { + // "$ref": "SecurityProfileGroup" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "networksecurity.organizations.locations.securityProfiles.create": + +type OrganizationsLocationsSecurityProfilesCreateCall struct { + s *Service + parent string + securityprofile *SecurityProfile + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new SecurityProfile in a given organization and +// location. +// +// - parent: The parent resource of the SecurityProfile. Must be in the +// format `projects|organizations/*/locations/{location}`. +func (r *OrganizationsLocationsSecurityProfilesService) Create(parent string, securityprofile *SecurityProfile) *OrganizationsLocationsSecurityProfilesCreateCall { + c := &OrganizationsLocationsSecurityProfilesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.securityprofile = securityprofile + return c +} + +// SecurityProfileId sets the optional parameter "securityProfileId": +// Required. Short name of the SecurityProfile resource to be created. +// This value should be 1-63 characters long, containing only letters, +// numbers, hyphens, and underscores, and should not start with a +// number. E.g. "security_profile1". +func (c *OrganizationsLocationsSecurityProfilesCreateCall) SecurityProfileId(securityProfileId string) *OrganizationsLocationsSecurityProfilesCreateCall { + c.urlParams_.Set("securityProfileId", securityProfileId) + 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 *OrganizationsLocationsSecurityProfilesCreateCall) Fields(s ...googleapi.Field) *OrganizationsLocationsSecurityProfilesCreateCall { + 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 *OrganizationsLocationsSecurityProfilesCreateCall) Context(ctx context.Context) *OrganizationsLocationsSecurityProfilesCreateCall { + 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 *OrganizationsLocationsSecurityProfilesCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsSecurityProfilesCreateCall) 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.securityprofile) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/securityProfiles") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networksecurity.organizations.locations.securityProfiles.create" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsLocationsSecurityProfilesCreateCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates a new SecurityProfile in a given organization and location.", + // "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfiles", + // "httpMethod": "POST", + // "id": "networksecurity.organizations.locations.securityProfiles.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The parent resource of the SecurityProfile. Must be in the format `projects|organizations/*/locations/{location}`.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "securityProfileId": { + // "description": "Required. Short name of the SecurityProfile resource to be created. This value should be 1-63 characters long, containing only letters, numbers, hyphens, and underscores, and should not start with a number. E.g. \"security_profile1\".", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1beta1/{+parent}/securityProfiles", + // "request": { + // "$ref": "SecurityProfile" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "networksecurity.organizations.locations.securityProfiles.delete": + +type OrganizationsLocationsSecurityProfilesDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a single SecurityProfile. +// +// - name: A name of the SecurityProfile to delete. Must be in the +// format +// `projects|organizations/*/locations/{location}/securityProfiles/{sec +// urity_profile_id}`. +func (r *OrganizationsLocationsSecurityProfilesService) Delete(name string) *OrganizationsLocationsSecurityProfilesDeleteCall { + c := &OrganizationsLocationsSecurityProfilesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Etag sets the optional parameter "etag": If client provided etag is +// out of date, delete will return FAILED_PRECONDITION error. +func (c *OrganizationsLocationsSecurityProfilesDeleteCall) Etag(etag string) *OrganizationsLocationsSecurityProfilesDeleteCall { + c.urlParams_.Set("etag", etag) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *OrganizationsLocationsSecurityProfilesDeleteCall) Fields(s ...googleapi.Field) *OrganizationsLocationsSecurityProfilesDeleteCall { + 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 *OrganizationsLocationsSecurityProfilesDeleteCall) Context(ctx context.Context) *OrganizationsLocationsSecurityProfilesDeleteCall { + 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 *OrganizationsLocationsSecurityProfilesDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsSecurityProfilesDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networksecurity.organizations.locations.securityProfiles.delete" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsLocationsSecurityProfilesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Deletes a single SecurityProfile.", + // "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfiles/{securityProfilesId}", + // "httpMethod": "DELETE", + // "id": "networksecurity.organizations.locations.securityProfiles.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "etag": { + // "description": "Optional. If client provided etag is out of date, delete will return FAILED_PRECONDITION error.", + // "location": "query", + // "type": "string" + // }, + // "name": { + // "description": "Required. A name of the SecurityProfile to delete. Must be in the format `projects|organizations/*/locations/{location}/securityProfiles/{security_profile_id}`.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/[^/]+/securityProfiles/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta1/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "networksecurity.organizations.locations.securityProfiles.get": + +type OrganizationsLocationsSecurityProfilesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of a single SecurityProfile. +// +// - name: A name of the SecurityProfile to get. Must be in the format +// `projects|organizations/*/locations/{location}/securityProfiles/{sec +// urity_profile_id}`. +func (r *OrganizationsLocationsSecurityProfilesService) Get(name string) *OrganizationsLocationsSecurityProfilesGetCall { + c := &OrganizationsLocationsSecurityProfilesGetCall{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 *OrganizationsLocationsSecurityProfilesGetCall) Fields(s ...googleapi.Field) *OrganizationsLocationsSecurityProfilesGetCall { + 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 *OrganizationsLocationsSecurityProfilesGetCall) IfNoneMatch(entityTag string) *OrganizationsLocationsSecurityProfilesGetCall { + 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 *OrganizationsLocationsSecurityProfilesGetCall) Context(ctx context.Context) *OrganizationsLocationsSecurityProfilesGetCall { + 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 *OrganizationsLocationsSecurityProfilesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsSecurityProfilesGetCall) 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, "v1beta1/{+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 "networksecurity.organizations.locations.securityProfiles.get" call. +// Exactly one of *SecurityProfile or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *SecurityProfile.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *OrganizationsLocationsSecurityProfilesGetCall) Do(opts ...googleapi.CallOption) (*SecurityProfile, 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 := &SecurityProfile{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets details of a single SecurityProfile.", + // "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfiles/{securityProfilesId}", + // "httpMethod": "GET", + // "id": "networksecurity.organizations.locations.securityProfiles.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. A name of the SecurityProfile to get. Must be in the format `projects|organizations/*/locations/{location}/securityProfiles/{security_profile_id}`.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/[^/]+/securityProfiles/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta1/{+name}", + // "response": { + // "$ref": "SecurityProfile" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "networksecurity.organizations.locations.securityProfiles.list": + +type OrganizationsLocationsSecurityProfilesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists SecurityProfiles in a given organization and location. +// +// - parent: The project or organization and location from which the +// SecurityProfiles should be listed, specified in the format +// `projects|organizations/*/locations/{location}`. +func (r *OrganizationsLocationsSecurityProfilesService) List(parent string) *OrganizationsLocationsSecurityProfilesListCall { + c := &OrganizationsLocationsSecurityProfilesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// SecurityProfiles to return per call. +func (c *OrganizationsLocationsSecurityProfilesListCall) PageSize(pageSize int64) *OrganizationsLocationsSecurityProfilesListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The value returned +// by the last `ListSecurityProfilesResponse` Indicates that this is a +// continuation of a prior `ListSecurityProfiles` call, and that the +// system should return the next page of data. +func (c *OrganizationsLocationsSecurityProfilesListCall) PageToken(pageToken string) *OrganizationsLocationsSecurityProfilesListCall { + 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 *OrganizationsLocationsSecurityProfilesListCall) Fields(s ...googleapi.Field) *OrganizationsLocationsSecurityProfilesListCall { + 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 *OrganizationsLocationsSecurityProfilesListCall) IfNoneMatch(entityTag string) *OrganizationsLocationsSecurityProfilesListCall { + 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 *OrganizationsLocationsSecurityProfilesListCall) Context(ctx context.Context) *OrganizationsLocationsSecurityProfilesListCall { + 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 *OrganizationsLocationsSecurityProfilesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsSecurityProfilesListCall) 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, "v1beta1/{+parent}/securityProfiles") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networksecurity.organizations.locations.securityProfiles.list" call. +// Exactly one of *ListSecurityProfilesResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *ListSecurityProfilesResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *OrganizationsLocationsSecurityProfilesListCall) Do(opts ...googleapi.CallOption) (*ListSecurityProfilesResponse, 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 := &ListSecurityProfilesResponse{ + 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 SecurityProfiles in a given organization and location.", + // "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfiles", + // "httpMethod": "GET", + // "id": "networksecurity.organizations.locations.securityProfiles.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "Maximum number of SecurityProfiles to return per call.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The value returned by the last `ListSecurityProfilesResponse` Indicates that this is a continuation of a prior `ListSecurityProfiles` call, and that the system should return the next page of data.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The project or organization and location from which the SecurityProfiles should be listed, specified in the format `projects|organizations/*/locations/{location}`.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta1/{+parent}/securityProfiles", + // "response": { + // "$ref": "ListSecurityProfilesResponse" + // }, + // "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 *OrganizationsLocationsSecurityProfilesListCall) Pages(ctx context.Context, f func(*ListSecurityProfilesResponse) 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 "networksecurity.organizations.locations.securityProfiles.patch": + +type OrganizationsLocationsSecurityProfilesPatchCall struct { + s *Service + name string + securityprofile *SecurityProfile + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the parameters of a single SecurityProfile. +// +// - name: Immutable. Name of the SecurityProfile resource. It matches +// pattern +// `projects|organizations/*/locations/{location}/securityProfiles/{sec +// urity_profile}`. +func (r *OrganizationsLocationsSecurityProfilesService) Patch(name string, securityprofile *SecurityProfile) *OrganizationsLocationsSecurityProfilesPatchCall { + c := &OrganizationsLocationsSecurityProfilesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.securityprofile = securityprofile + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Field +// mask is used to specify the fields to be overwritten in the +// SecurityProfile resource by the update. The fields specified in the +// update_mask are relative to the resource, not the full request. A +// field will be overwritten if it is in the mask. +func (c *OrganizationsLocationsSecurityProfilesPatchCall) UpdateMask(updateMask string) *OrganizationsLocationsSecurityProfilesPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *OrganizationsLocationsSecurityProfilesPatchCall) Fields(s ...googleapi.Field) *OrganizationsLocationsSecurityProfilesPatchCall { + 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 *OrganizationsLocationsSecurityProfilesPatchCall) Context(ctx context.Context) *OrganizationsLocationsSecurityProfilesPatchCall { + 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 *OrganizationsLocationsSecurityProfilesPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsSecurityProfilesPatchCall) 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.securityprofile) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networksecurity.organizations.locations.securityProfiles.patch" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *OrganizationsLocationsSecurityProfilesPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates the parameters of a single SecurityProfile.", + // "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/securityProfiles/{securityProfilesId}", + // "httpMethod": "PATCH", + // "id": "networksecurity.organizations.locations.securityProfiles.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Immutable. Name of the SecurityProfile resource. It matches pattern `projects|organizations/*/locations/{location}/securityProfiles/{security_profile}`.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/[^/]+/securityProfiles/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Required. Field mask is used to specify the fields to be overwritten in the SecurityProfile resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1beta1/{+name}", + // "request": { + // "$ref": "SecurityProfile" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "networksecurity.projects.locations.get": type ProjectsLocationsGetCall struct { 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/serviceconsumermanagement/v1/serviceconsumermanagement-api.json b/serviceconsumermanagement/v1/serviceconsumermanagement-api.json index 65a79602510..6331742dc1f 100644 --- a/serviceconsumermanagement/v1/serviceconsumermanagement-api.json +++ b/serviceconsumermanagement/v1/serviceconsumermanagement-api.json @@ -542,7 +542,7 @@ } } }, - "revision": "20230704", + "revision": "20230719", "rootUrl": "https://serviceconsumermanagement.googleapis.com/", "schemas": { "AddTenantProjectRequest": { @@ -1030,6 +1030,13 @@ "environment": { "description": "The service controller environment to use. If empty, no control plane feature (like quota and billing) will be enabled. The recommended value for most services is servicecontrol.googleapis.com", "type": "string" + }, + "methodPolicies": { + "description": "Defines policies applying to the API methods of the service.", + "items": { + "$ref": "MethodPolicy" + }, + "type": "array" } }, "type": "object" @@ -1440,6 +1447,25 @@ }, "type": "object" }, + "FieldPolicy": { + "description": "Google API Policy Annotation This message defines a simple API policy annotation that can be used to annotate API request and response message fields with applicable policies. One field may have multiple applicable policies that must all be satisfied before a request can be processed. This policy annotation is used to generate the overall policy that will be used for automatic runtime policy enforcement and documentation generation.", + "id": "FieldPolicy", + "properties": { + "resourcePermission": { + "description": "Specifies the required permission(s) for the resource referred to by the field. It requires the field contains a valid resource reference, and the request must pass the permission checks to proceed. For example, \"resourcemanager.projects.get\".", + "type": "string" + }, + "resourceType": { + "description": "Specifies the resource type for the resource referred to by the field.", + "type": "string" + }, + "selector": { + "description": "Selects one or more request or response message fields to apply this `FieldPolicy`. When a `FieldPolicy` is used in proto annotation, the selector must be left as empty. The service config generator will automatically fill the correct value. When a `FieldPolicy` is used in service config, the selector must be a comma-separated string with valid request or response field paths, such as \"foo.bar\" or \"foo.bar,foo.baz\".", + "type": "string" + } + }, + "type": "object" + }, "GoSettings": { "description": "Settings for Go client libraries.", "id": "GoSettings", @@ -1769,6 +1795,24 @@ }, "type": "object" }, + "MethodPolicy": { + "description": "Defines policies applying to an RPC method.", + "id": "MethodPolicy", + "properties": { + "requestPolicies": { + "description": "Policies that are applicable to the request message.", + "items": { + "$ref": "FieldPolicy" + }, + "type": "array" + }, + "selector": { + "description": "Selects a method to which these policies should be enforced, for example, \"google.pubsub.v1.Subscriber.CreateSubscription\". Refer to selector for syntax details. NOTE: This field must not be set in the proto annotation. It will be automatically filled by the service config compiler .", + "type": "string" + } + }, + "type": "object" + }, "MethodSettings": { "description": "Describes the generator configuration for a method.", "id": "MethodSettings", diff --git a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go index a1185e0aabc..5b33cc1df0e 100644 --- a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go @@ -1086,6 +1086,10 @@ type Control struct { // recommended value for most services is servicecontrol.googleapis.com Environment string `json:"environment,omitempty"` + // MethodPolicies: Defines policies applying to the API methods of the + // service. + MethodPolicies []*MethodPolicy `json:"methodPolicies,omitempty"` + // ForceSendFields is a list of field names (e.g. "Environment") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -1752,6 +1756,57 @@ func (s *Field) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// FieldPolicy: Google API Policy Annotation This message defines a +// simple API policy annotation that can be used to annotate API request +// and response message fields with applicable policies. One field may +// have multiple applicable policies that must all be satisfied before a +// request can be processed. This policy annotation is used to generate +// the overall policy that will be used for automatic runtime policy +// enforcement and documentation generation. +type FieldPolicy struct { + // ResourcePermission: Specifies the required permission(s) for the + // resource referred to by the field. It requires the field contains a + // valid resource reference, and the request must pass the permission + // checks to proceed. For example, "resourcemanager.projects.get". + ResourcePermission string `json:"resourcePermission,omitempty"` + + // ResourceType: Specifies the resource type for the resource referred + // to by the field. + ResourceType string `json:"resourceType,omitempty"` + + // Selector: Selects one or more request or response message fields to + // apply this `FieldPolicy`. When a `FieldPolicy` is used in proto + // annotation, the selector must be left as empty. The service config + // generator will automatically fill the correct value. When a + // `FieldPolicy` is used in service config, the selector must be a + // comma-separated string with valid request or response field paths, + // such as "foo.bar" or "foo.bar,foo.baz". + Selector string `json:"selector,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ResourcePermission") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ResourcePermission") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *FieldPolicy) MarshalJSON() ([]byte, error) { + type NoMethod FieldPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoSettings: Settings for Go client libraries. type GoSettings struct { // Common: Some settings. @@ -2489,6 +2544,43 @@ func (s *Method) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// MethodPolicy: Defines policies applying to an RPC method. +type MethodPolicy struct { + // RequestPolicies: Policies that are applicable to the request message. + RequestPolicies []*FieldPolicy `json:"requestPolicies,omitempty"` + + // Selector: Selects a method to which these policies should be + // enforced, for example, + // "google.pubsub.v1.Subscriber.CreateSubscription". Refer to selector + // for syntax details. NOTE: This field must not be set in the proto + // annotation. It will be automatically filled by the service config + // compiler . + Selector string `json:"selector,omitempty"` + + // ForceSendFields is a list of field names (e.g. "RequestPolicies") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "RequestPolicies") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *MethodPolicy) MarshalJSON() ([]byte, error) { + type NoMethod MethodPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // MethodSettings: Describes the generator configuration for a method. type MethodSettings struct { // LongRunning: Describes settings to use for long-running operations diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json index 5aa214f18cf..8e5641e5a55 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json @@ -500,7 +500,7 @@ } } }, - "revision": "20230704", + "revision": "20230719", "rootUrl": "https://serviceconsumermanagement.googleapis.com/", "schemas": { "Api": { @@ -922,6 +922,13 @@ "environment": { "description": "The service controller environment to use. If empty, no control plane feature (like quota and billing) will be enabled. The recommended value for most services is servicecontrol.googleapis.com", "type": "string" + }, + "methodPolicies": { + "description": "Defines policies applying to the API methods of the service.", + "items": { + "$ref": "MethodPolicy" + }, + "type": "array" } }, "type": "object" @@ -1310,6 +1317,25 @@ }, "type": "object" }, + "FieldPolicy": { + "description": "Google API Policy Annotation This message defines a simple API policy annotation that can be used to annotate API request and response message fields with applicable policies. One field may have multiple applicable policies that must all be satisfied before a request can be processed. This policy annotation is used to generate the overall policy that will be used for automatic runtime policy enforcement and documentation generation.", + "id": "FieldPolicy", + "properties": { + "resourcePermission": { + "description": "Specifies the required permission(s) for the resource referred to by the field. It requires the field contains a valid resource reference, and the request must pass the permission checks to proceed. For example, \"resourcemanager.projects.get\".", + "type": "string" + }, + "resourceType": { + "description": "Specifies the resource type for the resource referred to by the field.", + "type": "string" + }, + "selector": { + "description": "Selects one or more request or response message fields to apply this `FieldPolicy`. When a `FieldPolicy` is used in proto annotation, the selector must be left as empty. The service config generator will automatically fill the correct value. When a `FieldPolicy` is used in service config, the selector must be a comma-separated string with valid request or response field paths, such as \"foo.bar\" or \"foo.bar,foo.baz\".", + "type": "string" + } + }, + "type": "object" + }, "GoSettings": { "description": "Settings for Go client libraries.", "id": "GoSettings", @@ -1603,6 +1629,24 @@ }, "type": "object" }, + "MethodPolicy": { + "description": "Defines policies applying to an RPC method.", + "id": "MethodPolicy", + "properties": { + "requestPolicies": { + "description": "Policies that are applicable to the request message.", + "items": { + "$ref": "FieldPolicy" + }, + "type": "array" + }, + "selector": { + "description": "Selects a method to which these policies should be enforced, for example, \"google.pubsub.v1.Subscriber.CreateSubscription\". Refer to selector for syntax details. NOTE: This field must not be set in the proto annotation. It will be automatically filled by the service config compiler .", + "type": "string" + } + }, + "type": "object" + }, "MethodSettings": { "description": "Describes the generator configuration for a method.", "id": "MethodSettings", diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go index a5bda59d15c..df9f05e41f2 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go @@ -965,6 +965,10 @@ type Control struct { // recommended value for most services is servicecontrol.googleapis.com Environment string `json:"environment,omitempty"` + // MethodPolicies: Defines policies applying to the API methods of the + // service. + MethodPolicies []*MethodPolicy `json:"methodPolicies,omitempty"` + // ForceSendFields is a list of field names (e.g. "Environment") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -1563,6 +1567,57 @@ func (s *Field) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// FieldPolicy: Google API Policy Annotation This message defines a +// simple API policy annotation that can be used to annotate API request +// and response message fields with applicable policies. One field may +// have multiple applicable policies that must all be satisfied before a +// request can be processed. This policy annotation is used to generate +// the overall policy that will be used for automatic runtime policy +// enforcement and documentation generation. +type FieldPolicy struct { + // ResourcePermission: Specifies the required permission(s) for the + // resource referred to by the field. It requires the field contains a + // valid resource reference, and the request must pass the permission + // checks to proceed. For example, "resourcemanager.projects.get". + ResourcePermission string `json:"resourcePermission,omitempty"` + + // ResourceType: Specifies the resource type for the resource referred + // to by the field. + ResourceType string `json:"resourceType,omitempty"` + + // Selector: Selects one or more request or response message fields to + // apply this `FieldPolicy`. When a `FieldPolicy` is used in proto + // annotation, the selector must be left as empty. The service config + // generator will automatically fill the correct value. When a + // `FieldPolicy` is used in service config, the selector must be a + // comma-separated string with valid request or response field paths, + // such as "foo.bar" or "foo.bar,foo.baz". + Selector string `json:"selector,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ResourcePermission") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ResourcePermission") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *FieldPolicy) MarshalJSON() ([]byte, error) { + type NoMethod FieldPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoSettings: Settings for Go client libraries. type GoSettings struct { // Common: Some settings. @@ -2228,6 +2283,43 @@ func (s *Method) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// MethodPolicy: Defines policies applying to an RPC method. +type MethodPolicy struct { + // RequestPolicies: Policies that are applicable to the request message. + RequestPolicies []*FieldPolicy `json:"requestPolicies,omitempty"` + + // Selector: Selects a method to which these policies should be + // enforced, for example, + // "google.pubsub.v1.Subscriber.CreateSubscription". Refer to selector + // for syntax details. NOTE: This field must not be set in the proto + // annotation. It will be automatically filled by the service config + // compiler . + Selector string `json:"selector,omitempty"` + + // ForceSendFields is a list of field names (e.g. "RequestPolicies") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "RequestPolicies") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *MethodPolicy) MarshalJSON() ([]byte, error) { + type NoMethod MethodPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // MethodSettings: Describes the generator configuration for a method. type MethodSettings struct { // LongRunning: Describes settings to use for long-running operations diff --git a/servicedirectory/v1beta1/servicedirectory-api.json b/servicedirectory/v1beta1/servicedirectory-api.json index 89bfedd75fa..bd95bd2be64 100644 --- a/servicedirectory/v1beta1/servicedirectory-api.json +++ b/servicedirectory/v1beta1/servicedirectory-api.json @@ -428,94 +428,6 @@ } }, "resources": { - "serviceWorkloads": { - "methods": { - "getIamPolicy": { - "description": "Gets the IAM Policy for a resource", - "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/namespaces/{namespacesId}/serviceWorkloads/{serviceWorkloadsId}:getIamPolicy", - "httpMethod": "POST", - "id": "servicedirectory.projects.locations.namespaces.serviceWorkloads.getIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/namespaces/[^/]+/serviceWorkloads/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta1/{+resource}:getIamPolicy", - "request": { - "$ref": "GetIamPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "setIamPolicy": { - "description": "Sets the IAM Policy for a resource", - "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/namespaces/{namespacesId}/serviceWorkloads/{serviceWorkloadsId}:setIamPolicy", - "httpMethod": "POST", - "id": "servicedirectory.projects.locations.namespaces.serviceWorkloads.setIamPolicy", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/namespaces/[^/]+/serviceWorkloads/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta1/{+resource}:setIamPolicy", - "request": { - "$ref": "SetIamPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "testIamPermissions": { - "description": "Tests IAM permissions for a resource (namespace, service or service workload only).", - "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/namespaces/{namespacesId}/serviceWorkloads/{serviceWorkloadsId}:testIamPermissions", - "httpMethod": "POST", - "id": "servicedirectory.projects.locations.namespaces.serviceWorkloads.testIamPermissions", - "parameterOrder": [ - "resource" - ], - "parameters": { - "resource": { - "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/namespaces/[^/]+/serviceWorkloads/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta1/{+resource}:testIamPermissions", - "request": { - "$ref": "TestIamPermissionsRequest" - }, - "response": { - "$ref": "TestIamPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - } - } - }, "services": { "methods": { "create": { @@ -1059,7 +971,7 @@ } } }, - "revision": "20230618", + "revision": "20230716", "rootUrl": "https://servicedirectory.googleapis.com/", "schemas": { "Binding": { diff --git a/servicedirectory/v1beta1/servicedirectory-gen.go b/servicedirectory/v1beta1/servicedirectory-gen.go index ec5cd78934d..129708e9024 100644 --- a/servicedirectory/v1beta1/servicedirectory-gen.go +++ b/servicedirectory/v1beta1/servicedirectory-gen.go @@ -164,7 +164,6 @@ type ProjectsLocationsService struct { func NewProjectsLocationsNamespacesService(s *APIService) *ProjectsLocationsNamespacesService { rs := &ProjectsLocationsNamespacesService{s: s} - rs.ServiceWorkloads = NewProjectsLocationsNamespacesServiceWorkloadsService(s) rs.Services = NewProjectsLocationsNamespacesServicesService(s) rs.Workloads = NewProjectsLocationsNamespacesWorkloadsService(s) return rs @@ -173,22 +172,11 @@ func NewProjectsLocationsNamespacesService(s *APIService) *ProjectsLocationsName type ProjectsLocationsNamespacesService struct { s *APIService - ServiceWorkloads *ProjectsLocationsNamespacesServiceWorkloadsService - Services *ProjectsLocationsNamespacesServicesService Workloads *ProjectsLocationsNamespacesWorkloadsService } -func NewProjectsLocationsNamespacesServiceWorkloadsService(s *APIService) *ProjectsLocationsNamespacesServiceWorkloadsService { - rs := &ProjectsLocationsNamespacesServiceWorkloadsService{s: s} - return rs -} - -type ProjectsLocationsNamespacesServiceWorkloadsService struct { - s *APIService -} - func NewProjectsLocationsNamespacesServicesService(s *APIService) *ProjectsLocationsNamespacesServicesService { rs := &ProjectsLocationsNamespacesServicesService{s: s} rs.Endpoints = NewProjectsLocationsNamespacesServicesEndpointsService(s) @@ -2758,442 +2746,6 @@ func (c *ProjectsLocationsNamespacesTestIamPermissionsCall) Do(opts ...googleapi } -// method id "servicedirectory.projects.locations.namespaces.serviceWorkloads.getIamPolicy": - -type ProjectsLocationsNamespacesServiceWorkloadsGetIamPolicyCall struct { - s *APIService - resource string - getiampolicyrequest *GetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// GetIamPolicy: Gets the IAM Policy for a resource -// -// - resource: REQUIRED: The resource for which the policy is being -// requested. See Resource names -// (https://cloud.google.com/apis/design/resource_names) for the -// appropriate value for this field. -func (r *ProjectsLocationsNamespacesServiceWorkloadsService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsLocationsNamespacesServiceWorkloadsGetIamPolicyCall { - c := &ProjectsLocationsNamespacesServiceWorkloadsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.getiampolicyrequest = getiampolicyrequest - 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 *ProjectsLocationsNamespacesServiceWorkloadsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsNamespacesServiceWorkloadsGetIamPolicyCall { - 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 *ProjectsLocationsNamespacesServiceWorkloadsGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsNamespacesServiceWorkloadsGetIamPolicyCall { - 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 *ProjectsLocationsNamespacesServiceWorkloadsGetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsNamespacesServiceWorkloadsGetIamPolicyCall) 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.getiampolicyrequest) - if err != nil { - return nil, err - } - reqHeaders.Set("Content-Type", "application/json") - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+resource}:getIamPolicy") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "servicedirectory.projects.locations.namespaces.serviceWorkloads.getIamPolicy" call. -// Exactly one of *Policy or error will be non-nil. Any non-2xx status -// code is an error. Response headers are in either -// *Policy.ServerResponse.Header or (if a response was returned at all) -// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified -// was returned. -func (c *ProjectsLocationsNamespacesServiceWorkloadsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - if err := gensupport.DecodeResponse(target, res); err != nil { - return nil, err - } - return ret, nil - // { - // "description": "Gets the IAM Policy for a resource", - // "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/namespaces/{namespacesId}/serviceWorkloads/{serviceWorkloadsId}:getIamPolicy", - // "httpMethod": "POST", - // "id": "servicedirectory.projects.locations.namespaces.serviceWorkloads.getIamPolicy", - // "parameterOrder": [ - // "resource" - // ], - // "parameters": { - // "resource": { - // "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/namespaces/[^/]+/serviceWorkloads/[^/]+$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v1beta1/{+resource}:getIamPolicy", - // "request": { - // "$ref": "GetIamPolicyRequest" - // }, - // "response": { - // "$ref": "Policy" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - -// method id "servicedirectory.projects.locations.namespaces.serviceWorkloads.setIamPolicy": - -type ProjectsLocationsNamespacesServiceWorkloadsSetIamPolicyCall struct { - s *APIService - resource string - setiampolicyrequest *SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// SetIamPolicy: Sets the IAM Policy for a resource -// -// - resource: REQUIRED: The resource for which the policy is being -// specified. See Resource names -// (https://cloud.google.com/apis/design/resource_names) for the -// appropriate value for this field. -func (r *ProjectsLocationsNamespacesServiceWorkloadsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsNamespacesServiceWorkloadsSetIamPolicyCall { - c := &ProjectsLocationsNamespacesServiceWorkloadsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.setiampolicyrequest = setiampolicyrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse -// for more information. -func (c *ProjectsLocationsNamespacesServiceWorkloadsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsNamespacesServiceWorkloadsSetIamPolicyCall { - 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 *ProjectsLocationsNamespacesServiceWorkloadsSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsNamespacesServiceWorkloadsSetIamPolicyCall { - 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 *ProjectsLocationsNamespacesServiceWorkloadsSetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsNamespacesServiceWorkloadsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) - for k, v := range c.header_ { - reqHeaders[k] = v - } - reqHeaders.Set("User-Agent", c.s.userAgent()) - var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.setiampolicyrequest) - if err != nil { - return nil, err - } - reqHeaders.Set("Content-Type", "application/json") - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+resource}:setIamPolicy") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "servicedirectory.projects.locations.namespaces.serviceWorkloads.setIamPolicy" call. -// Exactly one of *Policy or error will be non-nil. Any non-2xx status -// code is an error. Response headers are in either -// *Policy.ServerResponse.Header or (if a response was returned at all) -// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified -// was returned. -func (c *ProjectsLocationsNamespacesServiceWorkloadsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &Policy{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - if err := gensupport.DecodeResponse(target, res); err != nil { - return nil, err - } - return ret, nil - // { - // "description": "Sets the IAM Policy for a resource", - // "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/namespaces/{namespacesId}/serviceWorkloads/{serviceWorkloadsId}:setIamPolicy", - // "httpMethod": "POST", - // "id": "servicedirectory.projects.locations.namespaces.serviceWorkloads.setIamPolicy", - // "parameterOrder": [ - // "resource" - // ], - // "parameters": { - // "resource": { - // "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/namespaces/[^/]+/serviceWorkloads/[^/]+$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v1beta1/{+resource}:setIamPolicy", - // "request": { - // "$ref": "SetIamPolicyRequest" - // }, - // "response": { - // "$ref": "Policy" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - -// method id "servicedirectory.projects.locations.namespaces.serviceWorkloads.testIamPermissions": - -type ProjectsLocationsNamespacesServiceWorkloadsTestIamPermissionsCall struct { - s *APIService - resource string - testiampermissionsrequest *TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// TestIamPermissions: Tests IAM permissions for a resource (namespace, -// service or service workload only). -// -// - resource: REQUIRED: The resource for which the policy detail is -// being requested. See Resource names -// (https://cloud.google.com/apis/design/resource_names) for the -// appropriate value for this field. -func (r *ProjectsLocationsNamespacesServiceWorkloadsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsNamespacesServiceWorkloadsTestIamPermissionsCall { - c := &ProjectsLocationsNamespacesServiceWorkloadsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.testiampermissionsrequest = testiampermissionsrequest - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse -// for more information. -func (c *ProjectsLocationsNamespacesServiceWorkloadsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsNamespacesServiceWorkloadsTestIamPermissionsCall { - 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 *ProjectsLocationsNamespacesServiceWorkloadsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsNamespacesServiceWorkloadsTestIamPermissionsCall { - 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 *ProjectsLocationsNamespacesServiceWorkloadsTestIamPermissionsCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsNamespacesServiceWorkloadsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := make(http.Header) - reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) - for k, v := range c.header_ { - reqHeaders[k] = v - } - reqHeaders.Set("User-Agent", c.s.userAgent()) - var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.testiampermissionsrequest) - if err != nil { - return nil, err - } - reqHeaders.Set("Content-Type", "application/json") - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+resource}:testIamPermissions") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "servicedirectory.projects.locations.namespaces.serviceWorkloads.testIamPermissions" call. -// Exactly one of *TestIamPermissionsResponse or error will be non-nil. -// Any non-2xx status code is an error. Response headers are in either -// *TestIamPermissionsResponse.ServerResponse.Header or (if a response -// was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was -// because http.StatusNotModified was returned. -func (c *ProjectsLocationsNamespacesServiceWorkloadsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &TestIamPermissionsResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - if err := gensupport.DecodeResponse(target, res); err != nil { - return nil, err - } - return ret, nil - // { - // "description": "Tests IAM permissions for a resource (namespace, service or service workload only).", - // "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/namespaces/{namespacesId}/serviceWorkloads/{serviceWorkloadsId}:testIamPermissions", - // "httpMethod": "POST", - // "id": "servicedirectory.projects.locations.namespaces.serviceWorkloads.testIamPermissions", - // "parameterOrder": [ - // "resource" - // ], - // "parameters": { - // "resource": { - // "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", - // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/namespaces/[^/]+/serviceWorkloads/[^/]+$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v1beta1/{+resource}:testIamPermissions", - // "request": { - // "$ref": "TestIamPermissionsRequest" - // }, - // "response": { - // "$ref": "TestIamPermissionsResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - // method id "servicedirectory.projects.locations.namespaces.services.create": type ProjectsLocationsNamespacesServicesCreateCall struct { diff --git a/servicenetworking/v1/servicenetworking-api.json b/servicenetworking/v1/servicenetworking-api.json index 48cbbf0d3aa..3d03d854a00 100644 --- a/servicenetworking/v1/servicenetworking-api.json +++ b/servicenetworking/v1/servicenetworking-api.json @@ -639,6 +639,32 @@ "https://www.googleapis.com/auth/service.management" ] }, + "list": { + "description": "* Service producers can use this method to retrieve a list of available DNS zones in the shared producer host project and the matching peering zones in the consumer project. *", + "flatPath": "v1/services/{servicesId}/dnsZones:list", + "httpMethod": "GET", + "id": "servicenetworking.services.dnsZones.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. Parent resource identifying the connection which owns this collection of DNS zones in the format services/{service}/projects/{project}/global/networks/{network} Service: The service that is managing connectivity for the service producer's organization. For Google services that support this functionality, this value is `servicenetworking.googleapis.com`. Projects: the consumer project containing the consumer network. Network: The consumer network accessible from the tenant project.", + "location": "path", + "pattern": "^services/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/dnsZones:list", + "response": { + "$ref": "ListDnsZonesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/service.management" + ] + }, "remove": { "description": "Service producers can use this method to remove private DNS zones in the shared producer host project and matching peering zones in the consumer project.", "flatPath": "v1/services/{servicesId}/dnsZones:remove", @@ -865,7 +891,7 @@ } } }, - "revision": "20230703", + "revision": "20230719", "rootUrl": "https://servicenetworking.googleapis.com/", "schemas": { "AddDnsRecordSetMetadata": { @@ -1624,6 +1650,13 @@ "environment": { "description": "The service controller environment to use. If empty, no control plane feature (like quota and billing) will be enabled. The recommended value for most services is servicecontrol.googleapis.com", "type": "string" + }, + "methodPolicies": { + "description": "Defines policies applying to the API methods of the service.", + "items": { + "$ref": "MethodPolicy" + }, + "type": "array" } }, "type": "object" @@ -1766,6 +1799,21 @@ }, "type": "object" }, + "DnsZonePair": { + "description": "* Represents a pair of private and peering DNS zone resources. *", + "id": "DnsZonePair", + "properties": { + "consumerPeeringZone": { + "$ref": "DnsZone", + "description": "The DNS peering zone in the consumer project." + }, + "producerPrivateZone": { + "$ref": "DnsZone", + "description": "The private DNS zone in the shared producer host project." + } + }, + "type": "object" + }, "Documentation": { "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: \u003e The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: \u003e ... - selector: google.calendar.Calendar.Put description: \u003e ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.", "id": "Documentation", @@ -2099,6 +2147,25 @@ }, "type": "object" }, + "FieldPolicy": { + "description": "Google API Policy Annotation This message defines a simple API policy annotation that can be used to annotate API request and response message fields with applicable policies. One field may have multiple applicable policies that must all be satisfied before a request can be processed. This policy annotation is used to generate the overall policy that will be used for automatic runtime policy enforcement and documentation generation.", + "id": "FieldPolicy", + "properties": { + "resourcePermission": { + "description": "Specifies the required permission(s) for the resource referred to by the field. It requires the field contains a valid resource reference, and the request must pass the permission checks to proceed. For example, \"resourcemanager.projects.get\".", + "type": "string" + }, + "resourceType": { + "description": "Specifies the resource type for the resource referred to by the field.", + "type": "string" + }, + "selector": { + "description": "Selects one or more request or response message fields to apply this `FieldPolicy`. When a `FieldPolicy` is used in proto annotation, the selector must be left as empty. The service config generator will automatically fill the correct value. When a `FieldPolicy` is used in service config, the selector must be a comma-separated string with valid request or response field paths, such as \"foo.bar\" or \"foo.bar,foo.baz\".", + "type": "string" + } + }, + "type": "object" + }, "GoSettings": { "description": "Settings for Go client libraries.", "id": "GoSettings", @@ -2335,6 +2402,20 @@ }, "type": "object" }, + "ListDnsZonesResponse": { + "description": "Represents all DNS zones in the shared producer host project and the matching peering zones in the consumer project.", + "id": "ListDnsZonesResponse", + "properties": { + "dnsZonePairs": { + "description": "All pairs of private DNS zones in the shared producer host project and the matching peering zones in the consumer project..", + "items": { + "$ref": "DnsZonePair" + }, + "type": "array" + } + }, + "type": "object" + }, "ListOperationsResponse": { "description": "The response message for Operations.ListOperations.", "id": "ListOperationsResponse", @@ -2507,6 +2588,24 @@ }, "type": "object" }, + "MethodPolicy": { + "description": "Defines policies applying to an RPC method.", + "id": "MethodPolicy", + "properties": { + "requestPolicies": { + "description": "Policies that are applicable to the request message.", + "items": { + "$ref": "FieldPolicy" + }, + "type": "array" + }, + "selector": { + "description": "Selects a method to which these policies should be enforced, for example, \"google.pubsub.v1.Subscriber.CreateSubscription\". Refer to selector for syntax details. NOTE: This field must not be set in the proto annotation. It will be automatically filled by the service config compiler .", + "type": "string" + } + }, + "type": "object" + }, "MethodSettings": { "description": "Describes the generator configuration for a method.", "id": "MethodSettings", diff --git a/servicenetworking/v1/servicenetworking-gen.go b/servicenetworking/v1/servicenetworking-gen.go index d23aaf6aa5c..f15274cb6b7 100644 --- a/servicenetworking/v1/servicenetworking-gen.go +++ b/servicenetworking/v1/servicenetworking-gen.go @@ -1601,6 +1601,10 @@ type Control struct { // recommended value for most services is servicecontrol.googleapis.com Environment string `json:"environment,omitempty"` + // MethodPolicies: Defines policies applying to the API methods of the + // service. + MethodPolicies []*MethodPolicy `json:"methodPolicies,omitempty"` + // ForceSendFields is a list of field names (e.g. "Environment") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -1909,6 +1913,40 @@ func (s *DnsZone) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// DnsZonePair: * Represents a pair of private and peering DNS zone +// resources. * +type DnsZonePair struct { + // ConsumerPeeringZone: The DNS peering zone in the consumer project. + ConsumerPeeringZone *DnsZone `json:"consumerPeeringZone,omitempty"` + + // ProducerPrivateZone: The private DNS zone in the shared producer host + // project. + ProducerPrivateZone *DnsZone `json:"producerPrivateZone,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ConsumerPeeringZone") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ConsumerPeeringZone") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *DnsZonePair) MarshalJSON() ([]byte, error) { + type NoMethod DnsZonePair + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Documentation: `Documentation` provides the information for // describing a service. Example: documentation: summary: > The Google // Calendar API gives access to most calendar features. pages: - name: @@ -2389,6 +2427,57 @@ func (s *Field) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// FieldPolicy: Google API Policy Annotation This message defines a +// simple API policy annotation that can be used to annotate API request +// and response message fields with applicable policies. One field may +// have multiple applicable policies that must all be satisfied before a +// request can be processed. This policy annotation is used to generate +// the overall policy that will be used for automatic runtime policy +// enforcement and documentation generation. +type FieldPolicy struct { + // ResourcePermission: Specifies the required permission(s) for the + // resource referred to by the field. It requires the field contains a + // valid resource reference, and the request must pass the permission + // checks to proceed. For example, "resourcemanager.projects.get". + ResourcePermission string `json:"resourcePermission,omitempty"` + + // ResourceType: Specifies the resource type for the resource referred + // to by the field. + ResourceType string `json:"resourceType,omitempty"` + + // Selector: Selects one or more request or response message fields to + // apply this `FieldPolicy`. When a `FieldPolicy` is used in proto + // annotation, the selector must be left as empty. The service config + // generator will automatically fill the correct value. When a + // `FieldPolicy` is used in service config, the selector must be a + // comma-separated string with valid request or response field paths, + // such as "foo.bar" or "foo.bar,foo.baz". + Selector string `json:"selector,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ResourcePermission") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ResourcePermission") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *FieldPolicy) MarshalJSON() ([]byte, error) { + type NoMethod FieldPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoSettings: Settings for Go client libraries. type GoSettings struct { // Common: Some settings. @@ -2974,6 +3063,40 @@ func (s *ListConnectionsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ListDnsZonesResponse: Represents all DNS zones in the shared producer +// host project and the matching peering zones in the consumer project. +type ListDnsZonesResponse struct { + // DnsZonePairs: All pairs of private DNS zones in the shared producer + // host project and the matching peering zones in the consumer project.. + DnsZonePairs []*DnsZonePair `json:"dnsZonePairs,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "DnsZonePairs") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DnsZonePairs") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListDnsZonesResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListDnsZonesResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ListOperationsResponse: The response message for // Operations.ListOperations. type ListOperationsResponse struct { @@ -3289,6 +3412,43 @@ func (s *Method) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// MethodPolicy: Defines policies applying to an RPC method. +type MethodPolicy struct { + // RequestPolicies: Policies that are applicable to the request message. + RequestPolicies []*FieldPolicy `json:"requestPolicies,omitempty"` + + // Selector: Selects a method to which these policies should be + // enforced, for example, + // "google.pubsub.v1.Subscriber.CreateSubscription". Refer to selector + // for syntax details. NOTE: This field must not be set in the proto + // annotation. It will be automatically filled by the service config + // compiler . + Selector string `json:"selector,omitempty"` + + // ForceSendFields is a list of field names (e.g. "RequestPolicies") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "RequestPolicies") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *MethodPolicy) MarshalJSON() ([]byte, error) { + type NoMethod MethodPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // MethodSettings: Describes the generator configuration for a method. type MethodSettings struct { // LongRunning: Describes settings to use for long-running operations @@ -8311,6 +8471,162 @@ func (c *ServicesDnsZonesAddCall) Do(opts ...googleapi.CallOption) (*Operation, } +// method id "servicenetworking.services.dnsZones.list": + +type ServicesDnsZonesListCall struct { + s *APIService + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: * Service producers can use this method to retrieve a list of +// available DNS zones in the shared producer host project and the +// matching peering zones in the consumer project. * +// +// - parent: Parent resource identifying the connection which owns this +// collection of DNS zones in the format +// services/{service}/projects/{project}/global/networks/{network} +// Service: The service that is managing connectivity for the service +// producer's organization. For Google services that support this +// functionality, this value is `servicenetworking.googleapis.com`. +// Projects: the consumer project containing the consumer network. +// Network: The consumer network accessible from the tenant project. +func (r *ServicesDnsZonesService) List(parent string) *ServicesDnsZonesListCall { + c := &ServicesDnsZonesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + 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 *ServicesDnsZonesListCall) Fields(s ...googleapi.Field) *ServicesDnsZonesListCall { + 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 *ServicesDnsZonesListCall) IfNoneMatch(entityTag string) *ServicesDnsZonesListCall { + 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 *ServicesDnsZonesListCall) Context(ctx context.Context) *ServicesDnsZonesListCall { + 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 *ServicesDnsZonesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ServicesDnsZonesListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/dnsZones:list") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "servicenetworking.services.dnsZones.list" call. +// Exactly one of *ListDnsZonesResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListDnsZonesResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *ServicesDnsZonesListCall) Do(opts ...googleapi.CallOption) (*ListDnsZonesResponse, 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 := &ListDnsZonesResponse{ + 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": "* Service producers can use this method to retrieve a list of available DNS zones in the shared producer host project and the matching peering zones in the consumer project. *", + // "flatPath": "v1/services/{servicesId}/dnsZones:list", + // "httpMethod": "GET", + // "id": "servicenetworking.services.dnsZones.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. Parent resource identifying the connection which owns this collection of DNS zones in the format services/{service}/projects/{project}/global/networks/{network} Service: The service that is managing connectivity for the service producer's organization. For Google services that support this functionality, this value is `servicenetworking.googleapis.com`. Projects: the consumer project containing the consumer network. Network: The consumer network accessible from the tenant project.", + // "location": "path", + // "pattern": "^services/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/dnsZones:list", + // "response": { + // "$ref": "ListDnsZonesResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/service.management" + // ] + // } + +} + // method id "servicenetworking.services.dnsZones.remove": type ServicesDnsZonesRemoveCall struct { diff --git a/servicenetworking/v1beta/servicenetworking-api.json b/servicenetworking/v1beta/servicenetworking-api.json index 10cc4cb7cb7..6272f27fe9d 100644 --- a/servicenetworking/v1beta/servicenetworking-api.json +++ b/servicenetworking/v1beta/servicenetworking-api.json @@ -307,7 +307,7 @@ } } }, - "revision": "20230703", + "revision": "20230719", "rootUrl": "https://servicenetworking.googleapis.com/", "schemas": { "AddDnsRecordSetMetadata": { @@ -945,6 +945,13 @@ "environment": { "description": "The service controller environment to use. If empty, no control plane feature (like quota and billing) will be enabled. The recommended value for most services is servicecontrol.googleapis.com", "type": "string" + }, + "methodPolicies": { + "description": "Defines policies applying to the API methods of the service.", + "items": { + "$ref": "MethodPolicy" + }, + "type": "array" } }, "type": "object" @@ -1381,6 +1388,25 @@ }, "type": "object" }, + "FieldPolicy": { + "description": "Google API Policy Annotation This message defines a simple API policy annotation that can be used to annotate API request and response message fields with applicable policies. One field may have multiple applicable policies that must all be satisfied before a request can be processed. This policy annotation is used to generate the overall policy that will be used for automatic runtime policy enforcement and documentation generation.", + "id": "FieldPolicy", + "properties": { + "resourcePermission": { + "description": "Specifies the required permission(s) for the resource referred to by the field. It requires the field contains a valid resource reference, and the request must pass the permission checks to proceed. For example, \"resourcemanager.projects.get\".", + "type": "string" + }, + "resourceType": { + "description": "Specifies the resource type for the resource referred to by the field.", + "type": "string" + }, + "selector": { + "description": "Selects one or more request or response message fields to apply this `FieldPolicy`. When a `FieldPolicy` is used in proto annotation, the selector must be left as empty. The service config generator will automatically fill the correct value. When a `FieldPolicy` is used in service config, the selector must be a comma-separated string with valid request or response field paths, such as \"foo.bar\" or \"foo.bar,foo.baz\".", + "type": "string" + } + }, + "type": "object" + }, "GoSettings": { "description": "Settings for Go client libraries.", "id": "GoSettings", @@ -1757,6 +1783,24 @@ }, "type": "object" }, + "MethodPolicy": { + "description": "Defines policies applying to an RPC method.", + "id": "MethodPolicy", + "properties": { + "requestPolicies": { + "description": "Policies that are applicable to the request message.", + "items": { + "$ref": "FieldPolicy" + }, + "type": "array" + }, + "selector": { + "description": "Selects a method to which these policies should be enforced, for example, \"google.pubsub.v1.Subscriber.CreateSubscription\". Refer to selector for syntax details. NOTE: This field must not be set in the proto annotation. It will be automatically filled by the service config compiler .", + "type": "string" + } + }, + "type": "object" + }, "MethodSettings": { "description": "Describes the generator configuration for a method.", "id": "MethodSettings", diff --git a/servicenetworking/v1beta/servicenetworking-gen.go b/servicenetworking/v1beta/servicenetworking-gen.go index a8b7d1f41e7..7890f75528e 100644 --- a/servicenetworking/v1beta/servicenetworking-gen.go +++ b/servicenetworking/v1beta/servicenetworking-gen.go @@ -1280,6 +1280,10 @@ type Control struct { // recommended value for most services is servicecontrol.googleapis.com Environment string `json:"environment,omitempty"` + // MethodPolicies: Defines policies applying to the API methods of the + // service. + MethodPolicies []*MethodPolicy `json:"methodPolicies,omitempty"` + // ForceSendFields is a list of field names (e.g. "Environment") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -1957,6 +1961,57 @@ func (s *Field) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// FieldPolicy: Google API Policy Annotation This message defines a +// simple API policy annotation that can be used to annotate API request +// and response message fields with applicable policies. One field may +// have multiple applicable policies that must all be satisfied before a +// request can be processed. This policy annotation is used to generate +// the overall policy that will be used for automatic runtime policy +// enforcement and documentation generation. +type FieldPolicy struct { + // ResourcePermission: Specifies the required permission(s) for the + // resource referred to by the field. It requires the field contains a + // valid resource reference, and the request must pass the permission + // checks to proceed. For example, "resourcemanager.projects.get". + ResourcePermission string `json:"resourcePermission,omitempty"` + + // ResourceType: Specifies the resource type for the resource referred + // to by the field. + ResourceType string `json:"resourceType,omitempty"` + + // Selector: Selects one or more request or response message fields to + // apply this `FieldPolicy`. When a `FieldPolicy` is used in proto + // annotation, the selector must be left as empty. The service config + // generator will automatically fill the correct value. When a + // `FieldPolicy` is used in service config, the selector must be a + // comma-separated string with valid request or response field paths, + // such as "foo.bar" or "foo.bar,foo.baz". + Selector string `json:"selector,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ResourcePermission") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ResourcePermission") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *FieldPolicy) MarshalJSON() ([]byte, error) { + type NoMethod FieldPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoSettings: Settings for Go client libraries. type GoSettings struct { // Common: Some settings. @@ -2786,6 +2841,43 @@ func (s *Method) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// MethodPolicy: Defines policies applying to an RPC method. +type MethodPolicy struct { + // RequestPolicies: Policies that are applicable to the request message. + RequestPolicies []*FieldPolicy `json:"requestPolicies,omitempty"` + + // Selector: Selects a method to which these policies should be + // enforced, for example, + // "google.pubsub.v1.Subscriber.CreateSubscription". Refer to selector + // for syntax details. NOTE: This field must not be set in the proto + // annotation. It will be automatically filled by the service config + // compiler . + Selector string `json:"selector,omitempty"` + + // ForceSendFields is a list of field names (e.g. "RequestPolicies") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "RequestPolicies") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *MethodPolicy) MarshalJSON() ([]byte, error) { + type NoMethod MethodPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // MethodSettings: Describes the generator configuration for a method. type MethodSettings struct { // LongRunning: Describes settings to use for long-running operations diff --git a/serviceusage/v1/serviceusage-api.json b/serviceusage/v1/serviceusage-api.json index a004898f3b7..e6ca2d16316 100644 --- a/serviceusage/v1/serviceusage-api.json +++ b/serviceusage/v1/serviceusage-api.json @@ -426,7 +426,7 @@ } } }, - "revision": "20230710", + "revision": "20230719", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -1025,6 +1025,13 @@ "environment": { "description": "The service controller environment to use. If empty, no control plane feature (like quota and billing) will be enabled. The recommended value for most services is servicecontrol.googleapis.com", "type": "string" + }, + "methodPolicies": { + "description": "Defines policies applying to the API methods of the service.", + "items": { + "$ref": "MethodPolicy" + }, + "type": "array" } }, "type": "object" @@ -1539,6 +1546,25 @@ }, "type": "object" }, + "FieldPolicy": { + "description": "Google API Policy Annotation This message defines a simple API policy annotation that can be used to annotate API request and response message fields with applicable policies. One field may have multiple applicable policies that must all be satisfied before a request can be processed. This policy annotation is used to generate the overall policy that will be used for automatic runtime policy enforcement and documentation generation.", + "id": "FieldPolicy", + "properties": { + "resourcePermission": { + "description": "Specifies the required permission(s) for the resource referred to by the field. It requires the field contains a valid resource reference, and the request must pass the permission checks to proceed. For example, \"resourcemanager.projects.get\".", + "type": "string" + }, + "resourceType": { + "description": "Specifies the resource type for the resource referred to by the field.", + "type": "string" + }, + "selector": { + "description": "Selects one or more request or response message fields to apply this `FieldPolicy`. When a `FieldPolicy` is used in proto annotation, the selector must be left as empty. The service config generator will automatically fill the correct value. When a `FieldPolicy` is used in service config, the selector must be a comma-separated string with valid request or response field paths, such as \"foo.bar\" or \"foo.bar,foo.baz\".", + "type": "string" + } + }, + "type": "object" + }, "GetServiceIdentityMetadata": { "description": "Metadata for the `GetServiceIdentity` method.", "id": "GetServiceIdentityMetadata", @@ -2242,6 +2268,24 @@ }, "type": "object" }, + "MethodPolicy": { + "description": "Defines policies applying to an RPC method.", + "id": "MethodPolicy", + "properties": { + "requestPolicies": { + "description": "Policies that are applicable to the request message.", + "items": { + "$ref": "FieldPolicy" + }, + "type": "array" + }, + "selector": { + "description": "Selects a method to which these policies should be enforced, for example, \"google.pubsub.v1.Subscriber.CreateSubscription\". Refer to selector for syntax details. NOTE: This field must not be set in the proto annotation. It will be automatically filled by the service config compiler .", + "type": "string" + } + }, + "type": "object" + }, "MethodSettings": { "description": "Describes the generator configuration for a method.", "id": "MethodSettings", diff --git a/serviceusage/v1/serviceusage-gen.go b/serviceusage/v1/serviceusage-gen.go index 8e3177a9daf..35901aece8b 100644 --- a/serviceusage/v1/serviceusage-gen.go +++ b/serviceusage/v1/serviceusage-gen.go @@ -1260,6 +1260,10 @@ type Control struct { // recommended value for most services is servicecontrol.googleapis.com Environment string `json:"environment,omitempty"` + // MethodPolicies: Defines policies applying to the API methods of the + // service. + MethodPolicies []*MethodPolicy `json:"methodPolicies,omitempty"` + // ForceSendFields is a list of field names (e.g. "Environment") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -2077,6 +2081,57 @@ func (s *Field) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// FieldPolicy: Google API Policy Annotation This message defines a +// simple API policy annotation that can be used to annotate API request +// and response message fields with applicable policies. One field may +// have multiple applicable policies that must all be satisfied before a +// request can be processed. This policy annotation is used to generate +// the overall policy that will be used for automatic runtime policy +// enforcement and documentation generation. +type FieldPolicy struct { + // ResourcePermission: Specifies the required permission(s) for the + // resource referred to by the field. It requires the field contains a + // valid resource reference, and the request must pass the permission + // checks to proceed. For example, "resourcemanager.projects.get". + ResourcePermission string `json:"resourcePermission,omitempty"` + + // ResourceType: Specifies the resource type for the resource referred + // to by the field. + ResourceType string `json:"resourceType,omitempty"` + + // Selector: Selects one or more request or response message fields to + // apply this `FieldPolicy`. When a `FieldPolicy` is used in proto + // annotation, the selector must be left as empty. The service config + // generator will automatically fill the correct value. When a + // `FieldPolicy` is used in service config, the selector must be a + // comma-separated string with valid request or response field paths, + // such as "foo.bar" or "foo.bar,foo.baz". + Selector string `json:"selector,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ResourcePermission") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ResourcePermission") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *FieldPolicy) MarshalJSON() ([]byte, error) { + type NoMethod FieldPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GetServiceIdentityMetadata: Metadata for the `GetServiceIdentity` // method. type GetServiceIdentityMetadata struct { @@ -3350,6 +3405,43 @@ func (s *Method) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// MethodPolicy: Defines policies applying to an RPC method. +type MethodPolicy struct { + // RequestPolicies: Policies that are applicable to the request message. + RequestPolicies []*FieldPolicy `json:"requestPolicies,omitempty"` + + // Selector: Selects a method to which these policies should be + // enforced, for example, + // "google.pubsub.v1.Subscriber.CreateSubscription". Refer to selector + // for syntax details. NOTE: This field must not be set in the proto + // annotation. It will be automatically filled by the service config + // compiler . + Selector string `json:"selector,omitempty"` + + // ForceSendFields is a list of field names (e.g. "RequestPolicies") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "RequestPolicies") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *MethodPolicy) MarshalJSON() ([]byte, error) { + type NoMethod MethodPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // MethodSettings: Describes the generator configuration for a method. type MethodSettings struct { // LongRunning: Describes settings to use for long-running operations diff --git a/serviceusage/v1beta1/serviceusage-api.json b/serviceusage/v1beta1/serviceusage-api.json index 7c15e279000..b390a628a2c 100644 --- a/serviceusage/v1beta1/serviceusage-api.json +++ b/serviceusage/v1beta1/serviceusage-api.json @@ -964,7 +964,7 @@ } } }, - "revision": "20230710", + "revision": "20230719", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -1621,6 +1621,13 @@ "environment": { "description": "The service controller environment to use. If empty, no control plane feature (like quota and billing) will be enabled. The recommended value for most services is servicecontrol.googleapis.com", "type": "string" + }, + "methodPolicies": { + "description": "Defines policies applying to the API methods of the service.", + "items": { + "$ref": "MethodPolicy" + }, + "type": "array" } }, "type": "object" @@ -2116,6 +2123,25 @@ }, "type": "object" }, + "FieldPolicy": { + "description": "Google API Policy Annotation This message defines a simple API policy annotation that can be used to annotate API request and response message fields with applicable policies. One field may have multiple applicable policies that must all be satisfied before a request can be processed. This policy annotation is used to generate the overall policy that will be used for automatic runtime policy enforcement and documentation generation.", + "id": "FieldPolicy", + "properties": { + "resourcePermission": { + "description": "Specifies the required permission(s) for the resource referred to by the field. It requires the field contains a valid resource reference, and the request must pass the permission checks to proceed. For example, \"resourcemanager.projects.get\".", + "type": "string" + }, + "resourceType": { + "description": "Specifies the resource type for the resource referred to by the field.", + "type": "string" + }, + "selector": { + "description": "Selects one or more request or response message fields to apply this `FieldPolicy`. When a `FieldPolicy` is used in proto annotation, the selector must be left as empty. The service config generator will automatically fill the correct value. When a `FieldPolicy` is used in service config, the selector must be a comma-separated string with valid request or response field paths, such as \"foo.bar\" or \"foo.bar,foo.baz\".", + "type": "string" + } + }, + "type": "object" + }, "GetServiceIdentityMetadata": { "description": "Metadata for the `GetServiceIdentity` method.", "id": "GetServiceIdentityMetadata", @@ -2937,6 +2963,24 @@ }, "type": "object" }, + "MethodPolicy": { + "description": "Defines policies applying to an RPC method.", + "id": "MethodPolicy", + "properties": { + "requestPolicies": { + "description": "Policies that are applicable to the request message.", + "items": { + "$ref": "FieldPolicy" + }, + "type": "array" + }, + "selector": { + "description": "Selects a method to which these policies should be enforced, for example, \"google.pubsub.v1.Subscriber.CreateSubscription\". Refer to selector for syntax details. NOTE: This field must not be set in the proto annotation. It will be automatically filled by the service config compiler .", + "type": "string" + } + }, + "type": "object" + }, "MethodSettings": { "description": "Describes the generator configuration for a method.", "id": "MethodSettings", diff --git a/serviceusage/v1beta1/serviceusage-gen.go b/serviceusage/v1beta1/serviceusage-gen.go index 8a41c2ada57..936837a61fd 100644 --- a/serviceusage/v1beta1/serviceusage-gen.go +++ b/serviceusage/v1beta1/serviceusage-gen.go @@ -1398,6 +1398,10 @@ type Control struct { // recommended value for most services is servicecontrol.googleapis.com Environment string `json:"environment,omitempty"` + // MethodPolicies: Defines policies applying to the API methods of the + // service. + MethodPolicies []*MethodPolicy `json:"methodPolicies,omitempty"` + // ForceSendFields is a list of field names (e.g. "Environment") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -2169,6 +2173,57 @@ func (s *Field) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// FieldPolicy: Google API Policy Annotation This message defines a +// simple API policy annotation that can be used to annotate API request +// and response message fields with applicable policies. One field may +// have multiple applicable policies that must all be satisfied before a +// request can be processed. This policy annotation is used to generate +// the overall policy that will be used for automatic runtime policy +// enforcement and documentation generation. +type FieldPolicy struct { + // ResourcePermission: Specifies the required permission(s) for the + // resource referred to by the field. It requires the field contains a + // valid resource reference, and the request must pass the permission + // checks to proceed. For example, "resourcemanager.projects.get". + ResourcePermission string `json:"resourcePermission,omitempty"` + + // ResourceType: Specifies the resource type for the resource referred + // to by the field. + ResourceType string `json:"resourceType,omitempty"` + + // Selector: Selects one or more request or response message fields to + // apply this `FieldPolicy`. When a `FieldPolicy` is used in proto + // annotation, the selector must be left as empty. The service config + // generator will automatically fill the correct value. When a + // `FieldPolicy` is used in service config, the selector must be a + // comma-separated string with valid request or response field paths, + // such as "foo.bar" or "foo.bar,foo.baz". + Selector string `json:"selector,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ResourcePermission") + // to unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ResourcePermission") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *FieldPolicy) MarshalJSON() ([]byte, error) { + type NoMethod FieldPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GetServiceIdentityMetadata: Metadata for the `GetServiceIdentity` // method. type GetServiceIdentityMetadata struct { @@ -3649,6 +3704,43 @@ func (s *Method) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// MethodPolicy: Defines policies applying to an RPC method. +type MethodPolicy struct { + // RequestPolicies: Policies that are applicable to the request message. + RequestPolicies []*FieldPolicy `json:"requestPolicies,omitempty"` + + // Selector: Selects a method to which these policies should be + // enforced, for example, + // "google.pubsub.v1.Subscriber.CreateSubscription". Refer to selector + // for syntax details. NOTE: This field must not be set in the proto + // annotation. It will be automatically filled by the service config + // compiler . + Selector string `json:"selector,omitempty"` + + // ForceSendFields is a list of field names (e.g. "RequestPolicies") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "RequestPolicies") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *MethodPolicy) MarshalJSON() ([]byte, error) { + type NoMethod MethodPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // MethodSettings: Describes the generator configuration for a method. type MethodSettings struct { // LongRunning: Describes settings to use for long-running operations diff --git a/tpu/v2alpha1/tpu-api.json b/tpu/v2alpha1/tpu-api.json index 3c9c69ad838..1bc94ede653 100644 --- a/tpu/v2alpha1/tpu-api.json +++ b/tpu/v2alpha1/tpu-api.json @@ -897,7 +897,7 @@ } } }, - "revision": "20230707", + "revision": "20230717", "rootUrl": "https://tpu.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -1761,6 +1761,21 @@ ], "type": "string" }, + "stateInitiator": { + "description": "Output only. The initiator of the QueuedResources's current state.", + "enum": [ + "STATE_INITIATOR_UNSPECIFIED", + "USER", + "SERVICE" + ], + "enumDescriptions": [ + "The state initiator is unspecified.", + "The current QueuedResource state was initiated by the user.", + "The current QueuedResource state was initiated by the service." + ], + "readOnly": true, + "type": "string" + }, "suspendedData": { "$ref": "SuspendedData", "description": "Further data for the suspended state." diff --git a/tpu/v2alpha1/tpu-gen.go b/tpu/v2alpha1/tpu-gen.go index f905f8c2066..17494d1ade2 100644 --- a/tpu/v2alpha1/tpu-gen.go +++ b/tpu/v2alpha1/tpu-gen.go @@ -1466,6 +1466,17 @@ type QueuedResourceState struct { // have been deleted. State string `json:"state,omitempty"` + // StateInitiator: Output only. The initiator of the QueuedResources's + // current state. + // + // Possible values: + // "STATE_INITIATOR_UNSPECIFIED" - The state initiator is unspecified. + // "USER" - The current QueuedResource state was initiated by the + // user. + // "SERVICE" - The current QueuedResource state was initiated by the + // service. + StateInitiator string `json:"stateInitiator,omitempty"` + // SuspendedData: Further data for the suspended state. SuspendedData *SuspendedData `json:"suspendedData,omitempty"` 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" }, diff --git a/transcoder/v1/transcoder-api.json b/transcoder/v1/transcoder-api.json index 28bb9493a3f..db0894124bb 100644 --- a/transcoder/v1/transcoder-api.json +++ b/transcoder/v1/transcoder-api.json @@ -385,7 +385,7 @@ } } }, - "revision": "20230621", + "revision": "20230712", "rootUrl": "https://transcoder.googleapis.com/", "schemas": { "AdBreak": { @@ -426,7 +426,7 @@ "type": "object" }, "AnimationEnd": { - "description": "End previous overlay animation from the video. Without AnimationEnd, the overlay object will keep the state of previous animation until the end of the video.", + "description": "End previous overlay animation from the video. Without `AnimationEnd`, the overlay object will keep the state of previous animation until the end of the video.", "id": "AnimationEnd", "properties": { "startTimeOffset": { @@ -509,11 +509,11 @@ "type": "object" }, "AudioMapping": { - "description": "The mapping for the `Job.edit_list` atoms with audio `EditAtom.inputs`.", + "description": "The mapping for the JobConfig.edit_list atoms with audio EditAtom.inputs.", "id": "AudioMapping", "properties": { "atomKey": { - "description": "Required. The `EditAtom.key` that references the atom with audio inputs in the `Job.edit_list`.", + "description": "Required. The EditAtom.key that references the atom with audio inputs in the JobConfig.edit_list.", "type": "string" }, "gainDb": { @@ -527,7 +527,7 @@ "type": "integer" }, "inputKey": { - "description": "Required. The `Input.key` that identifies the input file.", + "description": "Required. The Input.key that identifies the input file.", "type": "string" }, "inputTrack": { @@ -577,7 +577,7 @@ "type": "string" }, "mapping": { - "description": "The mapping for the `Job.edit_list` atoms with audio `EditAtom.inputs`.", + "description": "The mapping for the JobConfig.edit_list atoms with audio EditAtom.inputs.", "items": { "$ref": "AudioMapping" }, @@ -670,7 +670,7 @@ "id": "DashConfig", "properties": { "segmentReferenceScheme": { - "description": "The segment reference scheme for a `DASH` manifest. The default is `SEGMENT_LIST`", + "description": "The segment reference scheme for a `DASH` manifest. The default is `SEGMENT_LIST`.", "enum": [ "SEGMENT_REFERENCE_SCHEME_UNSPECIFIED", "SEGMENT_LIST", @@ -678,8 +678,8 @@ ], "enumDescriptions": [ "The segment reference scheme is not specified.", - "Lists the URLs of media files for each segment.", - "Lists each segment from a template with $Number$ variable." + "Explicitly lists the URLs of media files for each segment. For example, if SegmentSettings.individual_segments is `true`, then the manifest contains fields similar to the following: ```xml ... ```", + "SegmentSettings.individual_segments must be set to `true` to use this segment reference scheme. Uses the DASH specification `` tag to determine the URLs of media files for each segment. For example: ```xml ... ```" ], "type": "string" } @@ -766,7 +766,7 @@ "type": "string" }, "inputs": { - "description": "List of `Input.key`s identifying files that should be used in this atom. The listed `inputs` must have the same timeline.", + "description": "List of Input.key values identifying files that should be used in this atom. The listed `inputs` must have the same timeline.", "items": { "type": "string" }, @@ -864,7 +864,7 @@ "type": "number" }, "bFrameCount": { - "description": "The number of consecutive B-frames. Must be greater than or equal to zero. Must be less than `VideoStream.gop_frame_count` if set. The default is 0.", + "description": "The number of consecutive B-frames. Must be greater than or equal to zero. Must be less than H264CodecSettings.gop_frame_count if set. The default is 0.", "format": "int32", "type": "integer" }, @@ -883,7 +883,7 @@ "type": "integer" }, "enableTwoPass": { - "description": "Use two-pass encoding strategy to achieve better video quality. `VideoStream.rate_control_mode` must be `vbr`. The default is `false`.", + "description": "Use two-pass encoding strategy to achieve better video quality. H264CodecSettings.rate_control_mode must be `vbr`. The default is `false`.", "type": "boolean" }, "entropyCoder": { @@ -923,7 +923,7 @@ "type": "string" }, "rateControlMode": { - "description": "Specify the `rate_control_mode`. The default is `vbr`. Supported rate control modes: - `vbr` - variable bitrate - `crf` - constant rate factor", + "description": "Specify the mode. The default is `vbr`. Supported rate control modes: - `vbr` - variable bitrate - `crf` - constant rate factor", "type": "string" }, "tune": { @@ -931,12 +931,12 @@ "type": "string" }, "vbvFullnessBits": { - "description": "Initial fullness of the Video Buffering Verifier (VBV) buffer in bits. Must be greater than zero. The default is equal to 90% of `VideoStream.vbv_size_bits`.", + "description": "Initial fullness of the Video Buffering Verifier (VBV) buffer in bits. Must be greater than zero. The default is equal to 90% of H264CodecSettings.vbv_size_bits.", "format": "int32", "type": "integer" }, "vbvSizeBits": { - "description": "Size of the Video Buffering Verifier (VBV) buffer in bits. Must be greater than zero. The default is equal to `VideoStream.bitrate_bps`.", + "description": "Size of the Video Buffering Verifier (VBV) buffer in bits. Must be greater than zero. The default is equal to H264CodecSettings.bitrate_bps.", "format": "int32", "type": "integer" }, @@ -962,7 +962,7 @@ "type": "number" }, "bFrameCount": { - "description": "The number of consecutive B-frames. Must be greater than or equal to zero. Must be less than `VideoStream.gop_frame_count` if set. The default is 0.", + "description": "The number of consecutive B-frames. Must be greater than or equal to zero. Must be less than H265CodecSettings.gop_frame_count if set. The default is 0.", "format": "int32", "type": "integer" }, @@ -981,7 +981,7 @@ "type": "integer" }, "enableTwoPass": { - "description": "Use two-pass encoding strategy to achieve better video quality. `VideoStream.rate_control_mode` must be `vbr`. The default is `false`.", + "description": "Use two-pass encoding strategy to achieve better video quality. H265CodecSettings.rate_control_mode must be `vbr`. The default is `false`.", "type": "boolean" }, "frameRate": { @@ -1017,7 +1017,7 @@ "type": "string" }, "rateControlMode": { - "description": "Specify the `rate_control_mode`. The default is `vbr`. Supported rate control modes: - `vbr` - variable bitrate - `crf` - constant rate factor", + "description": "Specify the mode. The default is `vbr`. Supported rate control modes: - `vbr` - variable bitrate - `crf` - constant rate factor", "type": "string" }, "tune": { @@ -1025,7 +1025,7 @@ "type": "string" }, "vbvFullnessBits": { - "description": "Initial fullness of the Video Buffering Verifier (VBV) buffer in bits. Must be greater than zero. The default is equal to 90% of `VideoStream.vbv_size_bits`.", + "description": "Initial fullness of the Video Buffering Verifier (VBV) buffer in bits. Must be greater than zero. The default is equal to 90% of H265CodecSettings.vbv_size_bits.", "format": "int32", "type": "integer" }, @@ -1075,7 +1075,7 @@ "description": "Preprocessing configurations." }, "uri": { - "description": "URI of the media. Input files must be at least 5 seconds in duration and stored in Cloud Storage (for example, `gs://bucket/inputs/file.mp4`). If empty, the value is populated from `Job.input_uri`. See [Supported input and output formats](https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats).", + "description": "URI of the media. Input files must be at least 5 seconds in duration and stored in Cloud Storage (for example, `gs://bucket/inputs/file.mp4`). If empty, the value is populated from Job.input_uri. See [Supported input and output formats](https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats).", "type": "string" } }, @@ -1086,7 +1086,7 @@ "id": "Job", "properties": { "batchModePriority": { - "description": "The processing priority of a batch job. This field can only be set for batch mode jobs, and the default value is 0. This value cannot be negative. Higher values correspond to higher priorities for the job.", + "description": "The processing priority of a batch job. This field can only be set for batch mode jobs. The default value is 0. This value cannot be negative. Higher values correspond to higher priorities for the job.", "format": "int32", "type": "integer" }, @@ -1108,7 +1108,7 @@ }, "error": { "$ref": "Status", - "description": "Output only. An error object that describes the reason for the failure. This property is always present when `state` is `FAILED`.", + "description": "Output only. An error object that describes the reason for the failure. This property is always present when ProcessingState is `FAILED`.", "readOnly": true }, "inputUri": { @@ -1178,7 +1178,7 @@ "The job is enqueued and will be picked up for processing soon.", "The job is being processed.", "The job has been completed successfully.", - "The job has failed. For additional information, see `failure_reason` and `failure_details`" + "The job has failed. For additional information, see [Troubleshooting](https://cloud.google.com/transcoder/docs/troubleshooting)." ], "readOnly": true, "type": "string" @@ -1207,7 +1207,7 @@ "type": "array" }, "editList": { - "description": "List of `Edit atom`s. Defines the ultimate timeline of the resulting file or manifest.", + "description": "List of edit atoms. Defines the ultimate timeline of the resulting file or manifest.", "items": { "$ref": "EditAtom" }, @@ -1354,11 +1354,11 @@ "description": "`DASH` manifest configuration." }, "fileName": { - "description": "The name of the generated file. The default is `manifest` with the extension suffix corresponding to the `Manifest.type`.", + "description": "The name of the generated file. The default is `manifest` with the extension suffix corresponding to the Manifest.type.", "type": "string" }, "muxStreams": { - "description": "Required. List of user given `MuxStream.key`s that should appear in this manifest. When `Manifest.type` is `HLS`, a media manifest with name `MuxStream.key` and `.m3u8` extension is generated for each element of the `Manifest.mux_streams`.", + "description": "Required. List of user supplied MuxStream.key values that should appear in this manifest. When Manifest.type is `HLS`, a media manifest with name MuxStream.key and `.m3u8` extension is generated for each element in this list.", "items": { "type": "string" }, @@ -1401,7 +1401,7 @@ "type": "string" }, "elementaryStreams": { - "description": "List of `ElementaryStream.key`s multiplexed in this stream.", + "description": "List of ElementaryStream.key values multiplexed in this stream.", "items": { "type": "string" }, @@ -1412,11 +1412,11 @@ "type": "string" }, "fileName": { - "description": "The name of the generated file. The default is `MuxStream.key` with the extension suffix corresponding to the `MuxStream.container`. Individual segments also have an incremental 10-digit zero-padded suffix starting from 0 before the extension, such as `mux_stream0000000123.ts`.", + "description": "The name of the generated file. The default is MuxStream.key with the extension suffix corresponding to the MuxStream.container. Individual segments also have an incremental 10-digit zero-padded suffix starting from 0 before the extension, such as `mux_stream0000000123.ts`.", "type": "string" }, "key": { - "description": "A unique key for this multiplexed stream. HLS media manifests will be named `MuxStream.key` with the `.m3u8` extension suffix.", + "description": "A unique key for this multiplexed stream.", "type": "string" }, "segmentSettings": { @@ -1448,7 +1448,7 @@ "id": "Output", "properties": { "uri": { - "description": "URI for the output file(s). For example, `gs://my-bucket/outputs/`. If empty, the value is populated from `Job.output_uri`. See [Supported input and output formats](https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats).", + "description": "URI for the output file(s). For example, `gs://my-bucket/outputs/`. If empty, the value is populated from Job.output_uri. See [Supported input and output formats](https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats).", "type": "string" } }, @@ -1459,7 +1459,7 @@ "id": "Overlay", "properties": { "animations": { - "description": "List of Animations. The list should be chronological, without any time overlap.", + "description": "List of animations. The list should be chronological, without any time overlap.", "items": { "$ref": "Animation" }, @@ -1672,15 +1672,15 @@ "type": "object" }, "TextMapping": { - "description": "The mapping for the `Job.edit_list` atoms with text `EditAtom.inputs`.", + "description": "The mapping for the JobConfig.edit_list atoms with text EditAtom.inputs.", "id": "TextMapping", "properties": { "atomKey": { - "description": "Required. The `EditAtom.key` that references atom with text inputs in the `Job.edit_list`.", + "description": "Required. The EditAtom.key that references atom with text inputs in the JobConfig.edit_list.", "type": "string" }, "inputKey": { - "description": "Required. The `Input.key` that identifies the input file.", + "description": "Required. The Input.key that identifies the input file.", "type": "string" }, "inputTrack": { @@ -1708,7 +1708,7 @@ "type": "string" }, "mapping": { - "description": "The mapping for the `Job.edit_list` atoms with text `EditAtom.inputs`.", + "description": "The mapping for the JobConfig.edit_list atoms with text EditAtom.inputs.", "items": { "$ref": "TextMapping" }, @@ -1779,7 +1779,7 @@ "type": "string" }, "rateControlMode": { - "description": "Specify the `rate_control_mode`. The default is `vbr`. Supported rate control modes: - `vbr` - variable bitrate", + "description": "Specify the mode. The default is `vbr`. Supported rate control modes: - `vbr` - variable bitrate", "type": "string" }, "widthPixels": { diff --git a/transcoder/v1/transcoder-gen.go b/transcoder/v1/transcoder-gen.go index 7ba5608de87..85cf8a0ad38 100644 --- a/transcoder/v1/transcoder-gen.go +++ b/transcoder/v1/transcoder-gen.go @@ -252,7 +252,7 @@ func (s *Animation) MarshalJSON() ([]byte, error) { } // AnimationEnd: End previous overlay animation from the video. Without -// AnimationEnd, the overlay object will keep the state of previous +// `AnimationEnd`, the overlay object will keep the state of previous // animation until the end of the video. type AnimationEnd struct { // StartTimeOffset: The time to end overlay object, in seconds. Default: @@ -425,11 +425,11 @@ func (s *Audio) UnmarshalJSON(data []byte) error { return nil } -// AudioMapping: The mapping for the `Job.edit_list` atoms with audio -// `EditAtom.inputs`. +// AudioMapping: The mapping for the JobConfig.edit_list atoms with +// audio EditAtom.inputs. type AudioMapping struct { - // AtomKey: Required. The `EditAtom.key` that references the atom with - // audio inputs in the `Job.edit_list`. + // AtomKey: Required. The EditAtom.key that references the atom with + // audio inputs in the JobConfig.edit_list. AtomKey string `json:"atomKey,omitempty"` // GainDb: Audio volume control in dB. Negative values decrease volume, @@ -440,7 +440,7 @@ type AudioMapping struct { // input audio stream. InputChannel int64 `json:"inputChannel,omitempty"` - // InputKey: Required. The `Input.key` that identifies the input file. + // InputKey: Required. The Input.key that identifies the input file. InputKey string `json:"inputKey,omitempty"` // InputTrack: Required. The zero-based index of the track in the input @@ -521,8 +521,8 @@ type AudioStream struct { // supported in MP4 files. LanguageCode string `json:"languageCode,omitempty"` - // Mapping: The mapping for the `Job.edit_list` atoms with audio - // `EditAtom.inputs`. + // Mapping: The mapping for the JobConfig.edit_list atoms with audio + // EditAtom.inputs. Mapping []*AudioMapping `json:"mapping,omitempty"` // SampleRateHertz: The audio sample rate in Hertz. The default is 48000 @@ -702,14 +702,19 @@ func (s *Crop) MarshalJSON() ([]byte, error) { // DashConfig: `DASH` manifest configuration. type DashConfig struct { // SegmentReferenceScheme: The segment reference scheme for a `DASH` - // manifest. The default is `SEGMENT_LIST` + // manifest. The default is `SEGMENT_LIST`. // // Possible values: // "SEGMENT_REFERENCE_SCHEME_UNSPECIFIED" - The segment reference // scheme is not specified. - // "SEGMENT_LIST" - Lists the URLs of media files for each segment. - // "SEGMENT_TEMPLATE_NUMBER" - Lists each segment from a template with - // $Number$ variable. + // "SEGMENT_LIST" - Explicitly lists the URLs of media files for each + // segment. For example, if SegmentSettings.individual_segments is + // `true`, then the manifest contains fields similar to the following: + // ```xml ... ``` + // "SEGMENT_TEMPLATE_NUMBER" - SegmentSettings.individual_segments + // must be set to `true` to use this segment reference scheme. Uses the + // DASH specification `` tag to determine the URLs of media files for + // each segment. For example: ```xml ... ``` SegmentReferenceScheme string `json:"segmentReferenceScheme,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -909,8 +914,8 @@ type EditAtom struct { // `inputs` are used until the end of the atom. EndTimeOffset string `json:"endTimeOffset,omitempty"` - // Inputs: List of `Input.key`s identifying files that should be used in - // this atom. The listed `inputs` must have the same timeline. + // Inputs: List of Input.key values identifying files that should be + // used in this atom. The listed `inputs` must have the same timeline. Inputs []string `json:"inputs,omitempty"` // Key: A unique key for this atom. Must be specified when using @@ -1056,8 +1061,8 @@ type H264CodecSettings struct { AqStrength float64 `json:"aqStrength,omitempty"` // BFrameCount: The number of consecutive B-frames. Must be greater than - // or equal to zero. Must be less than `VideoStream.gop_frame_count` if - // set. The default is 0. + // or equal to zero. Must be less than H264CodecSettings.gop_frame_count + // if set. The default is 0. BFrameCount int64 `json:"bFrameCount,omitempty"` // BPyramid: Allow B-pyramid for reference frame selection. This may not @@ -1074,8 +1079,8 @@ type H264CodecSettings struct { CrfLevel int64 `json:"crfLevel,omitempty"` // EnableTwoPass: Use two-pass encoding strategy to achieve better video - // quality. `VideoStream.rate_control_mode` must be `vbr`. The default - // is `false`. + // quality. H264CodecSettings.rate_control_mode must be `vbr`. The + // default is `false`. EnableTwoPass bool `json:"enableTwoPass,omitempty"` // EntropyCoder: The entropy coder to use. The default is `cabac`. @@ -1134,9 +1139,9 @@ type H264CodecSettings struct { // fields you set in the `H264CodecSettings` message. Profile string `json:"profile,omitempty"` - // RateControlMode: Specify the `rate_control_mode`. The default is - // `vbr`. Supported rate control modes: - `vbr` - variable bitrate - - // `crf` - constant rate factor + // RateControlMode: Specify the mode. The default is `vbr`. Supported + // rate control modes: - `vbr` - variable bitrate - `crf` - constant + // rate factor RateControlMode string `json:"rateControlMode,omitempty"` // Tune: Enforces the specified codec tune. The available options are @@ -1147,12 +1152,12 @@ type H264CodecSettings struct { // VbvFullnessBits: Initial fullness of the Video Buffering Verifier // (VBV) buffer in bits. Must be greater than zero. The default is equal - // to 90% of `VideoStream.vbv_size_bits`. + // to 90% of H264CodecSettings.vbv_size_bits. VbvFullnessBits int64 `json:"vbvFullnessBits,omitempty"` // VbvSizeBits: Size of the Video Buffering Verifier (VBV) buffer in // bits. Must be greater than zero. The default is equal to - // `VideoStream.bitrate_bps`. + // H264CodecSettings.bitrate_bps. VbvSizeBits int64 `json:"vbvSizeBits,omitempty"` // WidthPixels: The width of the video in pixels. Must be an even @@ -1217,8 +1222,8 @@ type H265CodecSettings struct { AqStrength float64 `json:"aqStrength,omitempty"` // BFrameCount: The number of consecutive B-frames. Must be greater than - // or equal to zero. Must be less than `VideoStream.gop_frame_count` if - // set. The default is 0. + // or equal to zero. Must be less than H265CodecSettings.gop_frame_count + // if set. The default is 0. BFrameCount int64 `json:"bFrameCount,omitempty"` // BPyramid: Allow B-pyramid for reference frame selection. This may not @@ -1235,8 +1240,8 @@ type H265CodecSettings struct { CrfLevel int64 `json:"crfLevel,omitempty"` // EnableTwoPass: Use two-pass encoding strategy to achieve better video - // quality. `VideoStream.rate_control_mode` must be `vbr`. The default - // is `false`. + // quality. H265CodecSettings.rate_control_mode must be `vbr`. The + // default is `false`. EnableTwoPass bool `json:"enableTwoPass,omitempty"` // FrameRate: Required. The target video frame rate in frames per second @@ -1295,9 +1300,9 @@ type H265CodecSettings struct { // the `H265CodecSettings` message. Profile string `json:"profile,omitempty"` - // RateControlMode: Specify the `rate_control_mode`. The default is - // `vbr`. Supported rate control modes: - `vbr` - variable bitrate - - // `crf` - constant rate factor + // RateControlMode: Specify the mode. The default is `vbr`. Supported + // rate control modes: - `vbr` - variable bitrate - `crf` - constant + // rate factor RateControlMode string `json:"rateControlMode,omitempty"` // Tune: Enforces the specified codec tune. The available options are @@ -1308,7 +1313,7 @@ type H265CodecSettings struct { // VbvFullnessBits: Initial fullness of the Video Buffering Verifier // (VBV) buffer in bits. Must be greater than zero. The default is equal - // to 90% of `VideoStream.vbv_size_bits`. + // to 90% of H265CodecSettings.vbv_size_bits. VbvFullnessBits int64 `json:"vbvFullnessBits,omitempty"` // VbvSizeBits: Size of the Video Buffering Verifier (VBV) buffer in @@ -1432,7 +1437,7 @@ type Input struct { // Uri: URI of the media. Input files must be at least 5 seconds in // duration and stored in Cloud Storage (for example, // `gs://bucket/inputs/file.mp4`). If empty, the value is populated from - // `Job.input_uri`. See Supported input and output formats + // Job.input_uri. See Supported input and output formats // (https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats). Uri string `json:"uri,omitempty"` @@ -1462,7 +1467,7 @@ func (s *Input) MarshalJSON() ([]byte, error) { // Job: Transcoding job resource. type Job struct { // BatchModePriority: The processing priority of a batch job. This field - // can only be set for batch mode jobs, and the default value is 0. This + // can only be set for batch mode jobs. The default value is 0. This // value cannot be negative. Higher values correspond to higher // priorities for the job. BatchModePriority int64 `json:"batchModePriority,omitempty"` @@ -1477,7 +1482,8 @@ type Job struct { EndTime string `json:"endTime,omitempty"` // Error: Output only. An error object that describes the reason for the - // failure. This property is always present when `state` is `FAILED`. + // failure. This property is always present when ProcessingState is + // `FAILED`. Error *Status `json:"error,omitempty"` // InputUri: Input only. Specify the `input_uri` to populate empty `uri` @@ -1540,7 +1546,8 @@ type Job struct { // "RUNNING" - The job is being processed. // "SUCCEEDED" - The job has been completed successfully. // "FAILED" - The job has failed. For additional information, see - // `failure_reason` and `failure_details` + // [Troubleshooting](https://cloud.google.com/transcoder/docs/troubleshoo + // ting). State string `json:"state,omitempty"` // TemplateId: Input only. Specify the `template_id` to use for @@ -1588,7 +1595,7 @@ type JobConfig struct { // in the output manifests. AdBreaks []*AdBreak `json:"adBreaks,omitempty"` - // EditList: List of `Edit atom`s. Defines the ultimate timeline of the + // EditList: List of edit atoms. Defines the ultimate timeline of the // resulting file or manifest. EditList []*EditAtom `json:"editList,omitempty"` @@ -1771,13 +1778,13 @@ type Manifest struct { Dash *DashConfig `json:"dash,omitempty"` // FileName: The name of the generated file. The default is `manifest` - // with the extension suffix corresponding to the `Manifest.type`. + // with the extension suffix corresponding to the Manifest.type. FileName string `json:"fileName,omitempty"` - // MuxStreams: Required. List of user given `MuxStream.key`s that should - // appear in this manifest. When `Manifest.type` is `HLS`, a media - // manifest with name `MuxStream.key` and `.m3u8` extension is generated - // for each element of the `Manifest.mux_streams`. + // MuxStreams: Required. List of user supplied MuxStream.key values that + // should appear in this manifest. When Manifest.type is `HLS`, a media + // manifest with name MuxStream.key and `.m3u8` extension is generated + // for each element in this list. MuxStreams []string `json:"muxStreams,omitempty"` // Type: Required. Type of the manifest. @@ -1852,7 +1859,7 @@ type MuxStream struct { // (https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats) Container string `json:"container,omitempty"` - // ElementaryStreams: List of `ElementaryStream.key`s multiplexed in + // ElementaryStreams: List of ElementaryStream.key values multiplexed in // this stream. ElementaryStreams []string `json:"elementaryStreams,omitempty"` @@ -1861,14 +1868,13 @@ type MuxStream struct { EncryptionId string `json:"encryptionId,omitempty"` // FileName: The name of the generated file. The default is - // `MuxStream.key` with the extension suffix corresponding to the - // `MuxStream.container`. Individual segments also have an incremental + // MuxStream.key with the extension suffix corresponding to the + // MuxStream.container. Individual segments also have an incremental // 10-digit zero-padded suffix starting from 0 before the extension, // such as `mux_stream0000000123.ts`. FileName string `json:"fileName,omitempty"` - // Key: A unique key for this multiplexed stream. HLS media manifests - // will be named `MuxStream.key` with the `.m3u8` extension suffix. + // Key: A unique key for this multiplexed stream. Key string `json:"key,omitempty"` // SegmentSettings: Segment settings for `ts`, `fmp4` and `vtt`. @@ -1949,7 +1955,7 @@ func (s *NormalizedCoordinate) UnmarshalJSON(data []byte) error { type Output struct { // Uri: URI for the output file(s). For example, // `gs://my-bucket/outputs/`. If empty, the value is populated from - // `Job.output_uri`. See Supported input and output formats + // Job.output_uri. See Supported input and output formats // (https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats). Uri string `json:"uri,omitempty"` @@ -1978,7 +1984,7 @@ func (s *Output) MarshalJSON() ([]byte, error) { // Overlay: Overlay configuration. type Overlay struct { - // Animations: List of Animations. The list should be chronological, + // Animations: List of animations. The list should be chronological, // without any time overlap. Animations []*Animation `json:"animations,omitempty"` @@ -2336,14 +2342,14 @@ func (s *Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// TextMapping: The mapping for the `Job.edit_list` atoms with text -// `EditAtom.inputs`. +// TextMapping: The mapping for the JobConfig.edit_list atoms with text +// EditAtom.inputs. type TextMapping struct { - // AtomKey: Required. The `EditAtom.key` that references atom with text - // inputs in the `Job.edit_list`. + // AtomKey: Required. The EditAtom.key that references atom with text + // inputs in the JobConfig.edit_list. AtomKey string `json:"atomKey,omitempty"` - // InputKey: Required. The `Input.key` that identifies the input file. + // InputKey: Required. The Input.key that identifies the input file. InputKey string `json:"inputKey,omitempty"` // InputTrack: Required. The zero-based index of the track in the input @@ -2391,8 +2397,8 @@ type TextStream struct { // supported in MP4 files. LanguageCode string `json:"languageCode,omitempty"` - // Mapping: The mapping for the `Job.edit_list` atoms with text - // `EditAtom.inputs`. + // Mapping: The mapping for the JobConfig.edit_list atoms with text + // EditAtom.inputs. Mapping []*TextMapping `json:"mapping,omitempty"` // ForceSendFields is a list of field names (e.g. "Codec") to @@ -2508,8 +2514,8 @@ type Vp9CodecSettings struct { // set in the `Vp9CodecSettings` message. Profile string `json:"profile,omitempty"` - // RateControlMode: Specify the `rate_control_mode`. The default is - // `vbr`. Supported rate control modes: - `vbr` - variable bitrate + // RateControlMode: Specify the mode. The default is `vbr`. Supported + // rate control modes: - `vbr` - variable bitrate RateControlMode string `json:"rateControlMode,omitempty"` // WidthPixels: The width of the video in pixels. Must be an even diff --git a/vault/v1/vault-api.json b/vault/v1/vault-api.json index 7dc4207bf78..303cad01512 100644 --- a/vault/v1/vault-api.json +++ b/vault/v1/vault-api.json @@ -1193,7 +1193,7 @@ } } }, - "revision": "20230626", + "revision": "20230711", "rootUrl": "https://vault.googleapis.com/", "schemas": { "AccountCount": { @@ -1520,6 +1520,7 @@ "type": "boolean" }, "includeTeamDrives": { + "deprecated": true, "description": "Set to true to include Team Drive.", "type": "boolean" }, @@ -1804,6 +1805,7 @@ "type": "boolean" }, "includeTeamDriveFiles": { + "deprecated": true, "description": "To include files in Team Drives in the hold, set to **true**.", "type": "boolean" } @@ -2348,6 +2350,16 @@ "SITES_URL", "SHARED_DRIVE" ], + "enumDeprecated": [ + false, + false, + false, + true, + false, + false, + false, + false + ], "enumDescriptions": [ "A search method must be specified or else it is rejected.", "Search the data of the accounts specified in [AccountInfo](https://developers.google.com/vault/reference/rest/v1/Query#accountinfo).", @@ -2365,6 +2377,7 @@ "description": "Required when **SearchMethod** is **ORG_UNIT**." }, "searchMethod": { + "deprecated": true, "description": "The search method to use.", "enum": [ "SEARCH_METHOD_UNSPECIFIED", @@ -2376,6 +2389,16 @@ "SITES_URL", "SHARED_DRIVE" ], + "enumDeprecated": [ + false, + false, + false, + true, + false, + false, + false, + false + ], "enumDescriptions": [ "A search method must be specified or else it is rejected.", "Search the data of the accounts specified in [AccountInfo](https://developers.google.com/vault/reference/rest/v1/Query#accountinfo).", @@ -2403,6 +2426,7 @@ }, "teamDriveInfo": { "$ref": "TeamDriveInfo", + "deprecated": true, "description": "Required when **SearchMethod** is **TEAM_DRIVE**." }, "terms": { @@ -2560,10 +2584,12 @@ "type": "object" }, "TeamDriveInfo": { + "deprecated": true, "description": "Team Drives to search", "id": "TeamDriveInfo", "properties": { "teamDriveIds": { + "deprecated": true, "description": "List of Team Drive IDs, as provided by the [Drive API](https://developers.google.com/drive).", "items": { "type": "string" diff --git a/videointelligence/v1/videointelligence-api.json b/videointelligence/v1/videointelligence-api.json index 72cd32f960c..d19b8bab3fc 100644 --- a/videointelligence/v1/videointelligence-api.json +++ b/videointelligence/v1/videointelligence-api.json @@ -350,7 +350,7 @@ } } }, - "revision": "20230303", + "revision": "20230706", "rootUrl": "https://videointelligence.googleapis.com/", "schemas": { "GoogleCloudVideointelligenceV1_AnnotateVideoProgress": { @@ -561,6 +561,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1_FaceAnnotation", "properties": { @@ -629,6 +630,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1_FaceFrame", "properties": { @@ -1282,6 +1284,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1_FaceAnnotation" @@ -1617,6 +1620,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1beta2_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1beta2_FaceAnnotation", "properties": { @@ -1666,6 +1670,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1beta2_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1beta2_FaceFrame", "properties": { @@ -2153,6 +2158,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1beta2_FaceAnnotation" @@ -2442,6 +2448,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation", "properties": { @@ -2491,6 +2498,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p1beta1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p1beta1_FaceFrame", "properties": { @@ -2978,6 +2986,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation" @@ -3267,6 +3276,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation", "properties": { @@ -3316,6 +3326,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p2beta1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p2beta1_FaceFrame", "properties": { @@ -3803,6 +3814,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation" @@ -4147,6 +4159,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation", "properties": { @@ -4196,6 +4209,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p3beta1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p3beta1_FaceFrame", "properties": { @@ -4761,6 +4775,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation" diff --git a/videointelligence/v1beta2/videointelligence-api.json b/videointelligence/v1beta2/videointelligence-api.json index 02bebcf7424..b7cb418ff53 100644 --- a/videointelligence/v1beta2/videointelligence-api.json +++ b/videointelligence/v1beta2/videointelligence-api.json @@ -128,7 +128,7 @@ } } }, - "revision": "20210902", + "revision": "20230706", "rootUrl": "https://videointelligence.googleapis.com/", "schemas": { "GoogleCloudVideointelligenceV1_AnnotateVideoProgress": { @@ -269,6 +269,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1_FaceAnnotation", "properties": { @@ -318,6 +319,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1_FaceFrame", "properties": { @@ -805,6 +807,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1_FaceAnnotation" @@ -1164,6 +1167,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1beta2_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1beta2_FaceAnnotation", "properties": { @@ -1232,6 +1236,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1beta2_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1beta2_FaceFrame", "properties": { @@ -1885,6 +1890,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1beta2_FaceAnnotation" @@ -2220,6 +2226,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation", "properties": { @@ -2269,6 +2276,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p1beta1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p1beta1_FaceFrame", "properties": { @@ -2756,6 +2764,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation" @@ -3045,6 +3054,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation", "properties": { @@ -3094,6 +3104,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p2beta1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p2beta1_FaceFrame", "properties": { @@ -3581,6 +3592,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation" @@ -3925,6 +3937,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation", "properties": { @@ -3974,6 +3987,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p3beta1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p3beta1_FaceFrame", "properties": { @@ -4539,6 +4553,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation" diff --git a/videointelligence/v1p1beta1/videointelligence-api.json b/videointelligence/v1p1beta1/videointelligence-api.json index 372d24ee147..fa3604849de 100644 --- a/videointelligence/v1p1beta1/videointelligence-api.json +++ b/videointelligence/v1p1beta1/videointelligence-api.json @@ -128,7 +128,7 @@ } } }, - "revision": "20210902", + "revision": "20230706", "rootUrl": "https://videointelligence.googleapis.com/", "schemas": { "GoogleCloudVideointelligenceV1_AnnotateVideoProgress": { @@ -269,6 +269,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1_FaceAnnotation", "properties": { @@ -318,6 +319,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1_FaceFrame", "properties": { @@ -805,6 +807,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1_FaceAnnotation" @@ -1094,6 +1097,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1beta2_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1beta2_FaceAnnotation", "properties": { @@ -1143,6 +1147,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1beta2_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1beta2_FaceFrame", "properties": { @@ -1630,6 +1635,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1beta2_FaceAnnotation" @@ -1989,6 +1995,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation", "properties": { @@ -2057,6 +2064,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p1beta1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p1beta1_FaceFrame", "properties": { @@ -2710,6 +2718,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation" @@ -3045,6 +3054,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation", "properties": { @@ -3094,6 +3104,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p2beta1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p2beta1_FaceFrame", "properties": { @@ -3581,6 +3592,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation" @@ -3925,6 +3937,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation", "properties": { @@ -3974,6 +3987,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p3beta1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p3beta1_FaceFrame", "properties": { @@ -4539,6 +4553,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation" diff --git a/videointelligence/v1p2beta1/videointelligence-api.json b/videointelligence/v1p2beta1/videointelligence-api.json index f3f0323fa07..173b6c41972 100644 --- a/videointelligence/v1p2beta1/videointelligence-api.json +++ b/videointelligence/v1p2beta1/videointelligence-api.json @@ -128,7 +128,7 @@ } } }, - "revision": "20210902", + "revision": "20230706", "rootUrl": "https://videointelligence.googleapis.com/", "schemas": { "GoogleCloudVideointelligenceV1_AnnotateVideoProgress": { @@ -269,6 +269,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1_FaceAnnotation", "properties": { @@ -318,6 +319,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1_FaceFrame", "properties": { @@ -805,6 +807,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1_FaceAnnotation" @@ -1094,6 +1097,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1beta2_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1beta2_FaceAnnotation", "properties": { @@ -1143,6 +1147,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1beta2_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1beta2_FaceFrame", "properties": { @@ -1630,6 +1635,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1beta2_FaceAnnotation" @@ -1919,6 +1925,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation", "properties": { @@ -1968,6 +1975,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p1beta1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p1beta1_FaceFrame", "properties": { @@ -2455,6 +2463,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation" @@ -2814,6 +2823,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation", "properties": { @@ -2882,6 +2892,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p2beta1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p2beta1_FaceFrame", "properties": { @@ -3535,6 +3546,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation" @@ -3925,6 +3937,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation", "properties": { @@ -3974,6 +3987,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p3beta1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p3beta1_FaceFrame", "properties": { @@ -4539,6 +4553,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation" diff --git a/videointelligence/v1p3beta1/videointelligence-api.json b/videointelligence/v1p3beta1/videointelligence-api.json index e6465499310..8df91735ff8 100644 --- a/videointelligence/v1p3beta1/videointelligence-api.json +++ b/videointelligence/v1p3beta1/videointelligence-api.json @@ -128,7 +128,7 @@ } } }, - "revision": "20210902", + "revision": "20230706", "rootUrl": "https://videointelligence.googleapis.com/", "schemas": { "GoogleCloudVideointelligenceV1_AnnotateVideoProgress": { @@ -269,6 +269,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1_FaceAnnotation", "properties": { @@ -318,6 +319,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1_FaceFrame", "properties": { @@ -805,6 +807,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1_FaceAnnotation" @@ -1094,6 +1097,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1beta2_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1beta2_FaceAnnotation", "properties": { @@ -1143,6 +1147,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1beta2_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1beta2_FaceFrame", "properties": { @@ -1630,6 +1635,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1beta2_FaceAnnotation" @@ -1919,6 +1925,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation", "properties": { @@ -1968,6 +1975,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p1beta1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p1beta1_FaceFrame", "properties": { @@ -2455,6 +2463,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation" @@ -2744,6 +2753,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation", "properties": { @@ -2793,6 +2803,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p2beta1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p2beta1_FaceFrame", "properties": { @@ -3280,6 +3291,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation" @@ -3696,6 +3708,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation", "properties": { @@ -3764,6 +3777,7 @@ "type": "object" }, "GoogleCloudVideointelligenceV1p3beta1_FaceFrame": { + "deprecated": true, "description": "Deprecated. No effect.", "id": "GoogleCloudVideointelligenceV1p3beta1_FaceFrame", "properties": { @@ -4495,6 +4509,7 @@ "description": "Explicit content annotation." }, "faceAnnotations": { + "deprecated": true, "description": "Deprecated. Please use `face_detection_annotations` instead.", "items": { "$ref": "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation" diff --git a/vmmigration/v1/vmmigration-api.json b/vmmigration/v1/vmmigration-api.json index 4b636edf5e9..7cd634655fa 100644 --- a/vmmigration/v1/vmmigration-api.json +++ b/vmmigration/v1/vmmigration-api.json @@ -1972,7 +1972,7 @@ } } }, - "revision": "20230622", + "revision": "20230713", "rootUrl": "https://vmmigration.googleapis.com/", "schemas": { "AccessKeyCredentials": { @@ -2382,6 +2382,11 @@ "description": "CloneJob describes the process of creating a clone of a MigratingVM to the requested target based on the latest successful uploaded snapshots. While the migration cycles of a MigratingVm take place, it is possible to verify the uploaded VM can be started in the cloud, by creating a clone. The clone can be created without any downtime, and it is created using the latest snapshots which are already in the cloud. The cloneJob is only responsible for its work, not its products, which means once it is finished, it will never touch the instance it created. It will only delete it in case of the CloneJob being cancelled or upon failure to clone.", "id": "CloneJob", "properties": { + "computeEngineDisksTargetDetails": { + "$ref": "ComputeEngineDisksTargetDetails", + "description": "Output only. Details of the target Persistent Disks in Compute Engine.", + "readOnly": true + }, "computeEngineTargetDetails": { "$ref": "ComputeEngineTargetDetails", "description": "Output only. Details of the target VM in Compute Engine.", @@ -2480,6 +2485,42 @@ }, "type": "object" }, + "ComputeEngineDisksTargetDefaults": { + "description": "ComputeEngineDisksTargetDefaults is a collection of details for creating Persistent Disks in a target Compute Engine project.", + "id": "ComputeEngineDisksTargetDefaults", + "properties": { + "disks": { + "description": "The details of each Persistent Disk to create.", + "items": { + "$ref": "PersistentDiskDefaults" + }, + "type": "array" + }, + "targetProject": { + "description": "The full path of the resource of type TargetProject which represents the Compute Engine project in which to create the Persistent Disks.", + "type": "string" + }, + "zone": { + "description": "The zone in which to create the Persistent Disks.", + "type": "string" + } + }, + "type": "object" + }, + "ComputeEngineDisksTargetDetails": { + "description": "ComputeEngineDisksTargetDetails is a collection of created Persistent Disks details.", + "id": "ComputeEngineDisksTargetDetails", + "properties": { + "disks": { + "description": "The details of each created Persistent Disk.", + "items": { + "$ref": "PersistentDisk" + }, + "type": "array" + } + }, + "type": "object" + }, "ComputeEngineTargetDefaults": { "description": "ComputeEngineTargetDefaults is a collection of details for creating a VM in a target Compute Engine project.", "id": "ComputeEngineTargetDefaults", @@ -2798,6 +2839,11 @@ "description": "CutoverJob message describes a cutover of a migrating VM. The CutoverJob is the operation of shutting down the VM, creating a snapshot and clonning the VM using the replicated snapshot.", "id": "CutoverJob", "properties": { + "computeEngineDisksTargetDetails": { + "$ref": "ComputeEngineDisksTargetDetails", + "description": "Output only. Details of the target Persistent Disks in Compute Engine.", + "readOnly": true + }, "computeEngineTargetDetails": { "$ref": "ComputeEngineTargetDetails", "description": "Output only. Details of the target VM in Compute Engine.", @@ -3091,6 +3137,20 @@ "description": "Display name is a user defined name for this group which can be updated.", "type": "string" }, + "migrationTargetType": { + "description": "Immutable. The target type of this group.", + "enum": [ + "MIGRATION_TARGET_TYPE_UNSPECIFIED", + "MIGRATION_TARGET_TYPE_GCE", + "MIGRATION_TARGET_TYPE_DISKS" + ], + "enumDescriptions": [ + "Group type is not specified. This defaults to Compute Engine targets.", + "All MigratingVMs in the group must have Compute Engine targets.", + "All MigratingVMs in the group must have Compute Engine Disks targets." + ], + "type": "string" + }, "name": { "description": "Output only. The Group name.", "readOnly": true, @@ -3478,6 +3538,10 @@ "description": "Output only. Details of the VM from an AWS source.", "readOnly": true }, + "computeEngineDisksTargetDefaults": { + "$ref": "ComputeEngineDisksTargetDefaults", + "description": "Details of the target Persistent Disks in Compute Engine." + }, "computeEngineTargetDefaults": { "$ref": "ComputeEngineTargetDefaults", "description": "Details of the target VM in Compute Engine." @@ -3817,6 +3881,61 @@ "properties": {}, "type": "object" }, + "PersistentDisk": { + "description": "Details of a created Persistent Disk.", + "id": "PersistentDisk", + "properties": { + "diskUri": { + "description": "The URI of the Persistent Disk.", + "type": "string" + }, + "sourceDiskNumber": { + "description": "The ordinal number of the source VM disk.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "PersistentDiskDefaults": { + "description": "Details for creation of a Persistent Disk.", + "id": "PersistentDiskDefaults", + "properties": { + "additionalLabels": { + "additionalProperties": { + "type": "string" + }, + "description": "A map of labels to associate with the Persistent Disk.", + "type": "object" + }, + "diskName": { + "description": "Optional. The name of the Persistent Disk to create.", + "type": "string" + }, + "diskType": { + "description": "The disk type to use.", + "enum": [ + "COMPUTE_ENGINE_DISK_TYPE_UNSPECIFIED", + "COMPUTE_ENGINE_DISK_TYPE_STANDARD", + "COMPUTE_ENGINE_DISK_TYPE_SSD", + "COMPUTE_ENGINE_DISK_TYPE_BALANCED" + ], + "enumDescriptions": [ + "An unspecified disk type. Will be used as STANDARD.", + "A Standard disk type.", + "SSD hard disk type.", + "An alternative to SSD persistent disks that balance performance and cost." + ], + "type": "string" + }, + "sourceDiskNumber": { + "description": "The ordinal number of the source VM disk.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "PostProcessingStep": { "description": "PostProcessingStep contains specific step details.", "id": "PostProcessingStep", diff --git a/vmmigration/v1/vmmigration-gen.go b/vmmigration/v1/vmmigration-gen.go index cead2d31491..8a1cb787441 100644 --- a/vmmigration/v1/vmmigration-gen.go +++ b/vmmigration/v1/vmmigration-gen.go @@ -801,6 +801,10 @@ type CancelOperationRequest struct { // touch the instance it created. It will only delete it in case of the // CloneJob being cancelled or upon failure to clone. type CloneJob struct { + // ComputeEngineDisksTargetDetails: Output only. Details of the target + // Persistent Disks in Compute Engine. + ComputeEngineDisksTargetDetails *ComputeEngineDisksTargetDetails `json:"computeEngineDisksTargetDetails,omitempty"` + // ComputeEngineTargetDetails: Output only. Details of the target VM in // Compute Engine. ComputeEngineTargetDetails *ComputeEngineTargetDetails `json:"computeEngineTargetDetails,omitempty"` @@ -845,7 +849,7 @@ type CloneJob struct { googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. - // "ComputeEngineTargetDetails") to unconditionally include in API + // "ComputeEngineDisksTargetDetails") to unconditionally include in API // requests. By default, fields with empty or default values are omitted // from API requests. However, any non-pointer, non-interface field // appearing in ForceSendFields will be sent to the server regardless of @@ -854,8 +858,8 @@ type CloneJob struct { ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. - // "ComputeEngineTargetDetails") to include in API requests with the - // JSON null value. By default, fields with empty values are omitted + // "ComputeEngineDisksTargetDetails") to include in API requests with + // the JSON null value. By default, fields with empty values are omitted // from API requests. However, any field with an empty value appearing // in NullFields will be sent to the server as null. It is an error if a // field in this list has a non-empty value. This may be used to include @@ -909,6 +913,73 @@ func (s *CloneStep) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ComputeEngineDisksTargetDefaults: ComputeEngineDisksTargetDefaults is +// a collection of details for creating Persistent Disks in a target +// Compute Engine project. +type ComputeEngineDisksTargetDefaults struct { + // Disks: The details of each Persistent Disk to create. + Disks []*PersistentDiskDefaults `json:"disks,omitempty"` + + // TargetProject: The full path of the resource of type TargetProject + // which represents the Compute Engine project in which to create the + // Persistent Disks. + TargetProject string `json:"targetProject,omitempty"` + + // Zone: The zone in which to create the Persistent Disks. + Zone string `json:"zone,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Disks") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Disks") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ComputeEngineDisksTargetDefaults) MarshalJSON() ([]byte, error) { + type NoMethod ComputeEngineDisksTargetDefaults + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ComputeEngineDisksTargetDetails: ComputeEngineDisksTargetDetails is a +// collection of created Persistent Disks details. +type ComputeEngineDisksTargetDetails struct { + // Disks: The details of each created Persistent Disk. + Disks []*PersistentDisk `json:"disks,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Disks") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Disks") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ComputeEngineDisksTargetDetails) MarshalJSON() ([]byte, error) { + type NoMethod ComputeEngineDisksTargetDetails + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ComputeEngineTargetDefaults: ComputeEngineTargetDefaults is a // collection of details for creating a VM in a target Compute Engine // project. @@ -1226,6 +1297,10 @@ func (s *CutoverForecast) MarshalJSON() ([]byte, error) { // The CutoverJob is the operation of shutting down the VM, creating a // snapshot and clonning the VM using the replicated snapshot. type CutoverJob struct { + // ComputeEngineDisksTargetDetails: Output only. Details of the target + // Persistent Disks in Compute Engine. + ComputeEngineDisksTargetDetails *ComputeEngineDisksTargetDetails `json:"computeEngineDisksTargetDetails,omitempty"` + // ComputeEngineTargetDetails: Output only. Details of the target VM in // Compute Engine. ComputeEngineTargetDetails *ComputeEngineTargetDetails `json:"computeEngineTargetDetails,omitempty"` @@ -1278,7 +1353,7 @@ type CutoverJob struct { googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. - // "ComputeEngineTargetDetails") to unconditionally include in API + // "ComputeEngineDisksTargetDetails") to unconditionally include in API // requests. By default, fields with empty or default values are omitted // from API requests. However, any non-pointer, non-interface field // appearing in ForceSendFields will be sent to the server regardless of @@ -1287,8 +1362,8 @@ type CutoverJob struct { ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. - // "ComputeEngineTargetDetails") to include in API requests with the - // JSON null value. By default, fields with empty values are omitted + // "ComputeEngineDisksTargetDetails") to include in API requests with + // the JSON null value. By default, fields with empty values are omitted // from API requests. However, any field with an empty value appearing // in NullFields will be sent to the server as null. It is an error if a // field in this list has a non-empty value. This may be used to include @@ -1567,6 +1642,17 @@ type Group struct { // can be updated. DisplayName string `json:"displayName,omitempty"` + // MigrationTargetType: Immutable. The target type of this group. + // + // Possible values: + // "MIGRATION_TARGET_TYPE_UNSPECIFIED" - Group type is not specified. + // This defaults to Compute Engine targets. + // "MIGRATION_TARGET_TYPE_GCE" - All MigratingVMs in the group must + // have Compute Engine targets. + // "MIGRATION_TARGET_TYPE_DISKS" - All MigratingVMs in the group must + // have Compute Engine Disks targets. + MigrationTargetType string `json:"migrationTargetType,omitempty"` + // Name: Output only. The Group name. Name string `json:"name,omitempty"` @@ -2175,6 +2261,10 @@ type MigratingVm struct { // source. AwsSourceVmDetails *AwsSourceVmDetails `json:"awsSourceVmDetails,omitempty"` + // ComputeEngineDisksTargetDefaults: Details of the target Persistent + // Disks in Compute Engine. + ComputeEngineDisksTargetDefaults *ComputeEngineDisksTargetDefaults `json:"computeEngineDisksTargetDefaults,omitempty"` + // ComputeEngineTargetDefaults: Details of the target VM in Compute // Engine. ComputeEngineTargetDefaults *ComputeEngineTargetDefaults `json:"computeEngineTargetDefaults,omitempty"` @@ -2578,6 +2668,84 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { type PauseMigrationRequest struct { } +// PersistentDisk: Details of a created Persistent Disk. +type PersistentDisk struct { + // DiskUri: The URI of the Persistent Disk. + DiskUri string `json:"diskUri,omitempty"` + + // SourceDiskNumber: The ordinal number of the source VM disk. + SourceDiskNumber int64 `json:"sourceDiskNumber,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DiskUri") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DiskUri") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *PersistentDisk) MarshalJSON() ([]byte, error) { + type NoMethod PersistentDisk + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// PersistentDiskDefaults: Details for creation of a Persistent Disk. +type PersistentDiskDefaults struct { + // AdditionalLabels: A map of labels to associate with the Persistent + // Disk. + AdditionalLabels map[string]string `json:"additionalLabels,omitempty"` + + // DiskName: Optional. The name of the Persistent Disk to create. + DiskName string `json:"diskName,omitempty"` + + // DiskType: The disk type to use. + // + // Possible values: + // "COMPUTE_ENGINE_DISK_TYPE_UNSPECIFIED" - An unspecified disk type. + // Will be used as STANDARD. + // "COMPUTE_ENGINE_DISK_TYPE_STANDARD" - A Standard disk type. + // "COMPUTE_ENGINE_DISK_TYPE_SSD" - SSD hard disk type. + // "COMPUTE_ENGINE_DISK_TYPE_BALANCED" - An alternative to SSD + // persistent disks that balance performance and cost. + DiskType string `json:"diskType,omitempty"` + + // SourceDiskNumber: The ordinal number of the source VM disk. + SourceDiskNumber int64 `json:"sourceDiskNumber,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AdditionalLabels") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AdditionalLabels") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *PersistentDiskDefaults) MarshalJSON() ([]byte, error) { + type NoMethod PersistentDiskDefaults + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // PostProcessingStep: PostProcessingStep contains specific step // details. type PostProcessingStep struct { diff --git a/vmmigration/v1alpha1/vmmigration-api.json b/vmmigration/v1alpha1/vmmigration-api.json index c840f891279..36c0071a26c 100644 --- a/vmmigration/v1alpha1/vmmigration-api.json +++ b/vmmigration/v1alpha1/vmmigration-api.json @@ -1972,7 +1972,7 @@ } } }, - "revision": "20230622", + "revision": "20230713", "rootUrl": "https://vmmigration.googleapis.com/", "schemas": { "AccessKeyCredentials": { @@ -2382,6 +2382,11 @@ "description": "CloneJob describes the process of creating a clone of a MigratingVM to the requested target based on the latest successful uploaded snapshots. While the migration cycles of a MigratingVm take place, it is possible to verify the uploaded VM can be started in the cloud, by creating a clone. The clone can be created without any downtime, and it is created using the latest snapshots which are already in the cloud. The cloneJob is only responsible for its work, not its products, which means once it is finished, it will never touch the instance it created. It will only delete it in case of the CloneJob being cancelled or upon failure to clone.", "id": "CloneJob", "properties": { + "computeEngineDisksTargetDetails": { + "$ref": "ComputeEngineDisksTargetDetails", + "description": "Output only. Details of the target Persistent Disks in Compute Engine.", + "readOnly": true + }, "computeEngineTargetDetails": { "$ref": "ComputeEngineTargetDetails", "description": "Output only. Details of the target VM in Compute Engine.", @@ -2492,6 +2497,42 @@ }, "type": "object" }, + "ComputeEngineDisksTargetDefaults": { + "description": "ComputeEngineDisksTargetDefaults is a collection of details for creating Persistent Disks in a target Compute Engine project.", + "id": "ComputeEngineDisksTargetDefaults", + "properties": { + "disks": { + "description": "The details of each Persistent Disk to create.", + "items": { + "$ref": "PersistentDiskDefaults" + }, + "type": "array" + }, + "targetProject": { + "description": "The full path of the resource of type TargetProject which represents the Compute Engine project in which to create the Persistent Disks.", + "type": "string" + }, + "zone": { + "description": "The zone in which to create the Persistent Disks.", + "type": "string" + } + }, + "type": "object" + }, + "ComputeEngineDisksTargetDetails": { + "description": "ComputeEngineDisksTargetDetails is a collection of created Persistent Disks details.", + "id": "ComputeEngineDisksTargetDetails", + "properties": { + "disks": { + "description": "The details of each created Persistent Disk.", + "items": { + "$ref": "PersistentDisk" + }, + "type": "array" + } + }, + "type": "object" + }, "ComputeEngineTargetDefaults": { "description": "ComputeEngineTargetDefaults is a collection of details for creating a VM in a target Compute Engine project.", "id": "ComputeEngineTargetDefaults", @@ -2814,6 +2855,11 @@ "description": "CutoverJob message describes a cutover of a migrating VM. The CutoverJob is the operation of shutting down the VM, creating a snapshot and clonning the VM using the replicated snapshot.", "id": "CutoverJob", "properties": { + "computeEngineDisksTargetDetails": { + "$ref": "ComputeEngineDisksTargetDetails", + "description": "Output only. Details of the target Persistent Disks in Compute Engine.", + "readOnly": true + }, "computeEngineTargetDetails": { "$ref": "ComputeEngineTargetDetails", "description": "Output only. Details of the target VM in Compute Engine.", @@ -3126,6 +3172,20 @@ "description": "Display name is a user defined name for this group which can be updated.", "type": "string" }, + "migrationTargetType": { + "description": "Immutable. The target type of this group.", + "enum": [ + "MIGRATION_TARGET_TYPE_UNSPECIFIED", + "MIGRATION_TARGET_TYPE_GCE", + "MIGRATION_TARGET_TYPE_DISKS" + ], + "enumDescriptions": [ + "Group type is not specified. This defaults to Compute Engine targets.", + "All MigratingVMs in the group must have Compute Engine targets.", + "All MigratingVMs in the group must have Compute Engine Disks targets." + ], + "type": "string" + }, "name": { "description": "Output only. The Group name.", "readOnly": true, @@ -3513,6 +3573,10 @@ "description": "Output only. Details of the VM from an AWS source.", "readOnly": true }, + "computeEngineDisksTargetDefaults": { + "$ref": "ComputeEngineDisksTargetDefaults", + "description": "Details of the target Persistent Disks in Compute Engine." + }, "computeEngineTargetDefaults": { "$ref": "ComputeEngineTargetDefaults", "description": "Details of the target VM in Compute Engine." @@ -3862,6 +3926,61 @@ "properties": {}, "type": "object" }, + "PersistentDisk": { + "description": "Details of a created Persistent Disk.", + "id": "PersistentDisk", + "properties": { + "diskUri": { + "description": "The URI of the Persistent Disk.", + "type": "string" + }, + "sourceDiskNumber": { + "description": "The ordinal number of the source VM disk.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "PersistentDiskDefaults": { + "description": "Details for creation of a Persistent Disk.", + "id": "PersistentDiskDefaults", + "properties": { + "additionalLabels": { + "additionalProperties": { + "type": "string" + }, + "description": "A map of labels to associate with the Persistent Disk.", + "type": "object" + }, + "diskName": { + "description": "Optional. The name of the Persistent Disk to create.", + "type": "string" + }, + "diskType": { + "description": "The disk type to use.", + "enum": [ + "COMPUTE_ENGINE_DISK_TYPE_UNSPECIFIED", + "COMPUTE_ENGINE_DISK_TYPE_STANDARD", + "COMPUTE_ENGINE_DISK_TYPE_SSD", + "COMPUTE_ENGINE_DISK_TYPE_BALANCED" + ], + "enumDescriptions": [ + "An unspecified disk type. Will be used as STANDARD.", + "A Standard disk type.", + "SSD hard disk type.", + "An alternative to SSD persistent disks that balance performance and cost." + ], + "type": "string" + }, + "sourceDiskNumber": { + "description": "The ordinal number of the source VM disk.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "PostProcessingStep": { "description": "PostProcessingStep contains specific step details.", "id": "PostProcessingStep", diff --git a/vmmigration/v1alpha1/vmmigration-gen.go b/vmmigration/v1alpha1/vmmigration-gen.go index 7e98714b1c3..ebf08c36983 100644 --- a/vmmigration/v1alpha1/vmmigration-gen.go +++ b/vmmigration/v1alpha1/vmmigration-gen.go @@ -801,6 +801,10 @@ type CancelOperationRequest struct { // touch the instance it created. It will only delete it in case of the // CloneJob being cancelled or upon failure to clone. type CloneJob struct { + // ComputeEngineDisksTargetDetails: Output only. Details of the target + // Persistent Disks in Compute Engine. + ComputeEngineDisksTargetDetails *ComputeEngineDisksTargetDetails `json:"computeEngineDisksTargetDetails,omitempty"` + // ComputeEngineTargetDetails: Output only. Details of the target VM in // Compute Engine. ComputeEngineTargetDetails *ComputeEngineTargetDetails `json:"computeEngineTargetDetails,omitempty"` @@ -854,7 +858,7 @@ type CloneJob struct { googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. - // "ComputeEngineTargetDetails") to unconditionally include in API + // "ComputeEngineDisksTargetDetails") to unconditionally include in API // requests. By default, fields with empty or default values are omitted // from API requests. However, any non-pointer, non-interface field // appearing in ForceSendFields will be sent to the server regardless of @@ -863,8 +867,8 @@ type CloneJob struct { ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. - // "ComputeEngineTargetDetails") to include in API requests with the - // JSON null value. By default, fields with empty values are omitted + // "ComputeEngineDisksTargetDetails") to include in API requests with + // the JSON null value. By default, fields with empty values are omitted // from API requests. However, any field with an empty value appearing // in NullFields will be sent to the server as null. It is an error if a // field in this list has a non-empty value. This may be used to include @@ -918,6 +922,73 @@ func (s *CloneStep) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ComputeEngineDisksTargetDefaults: ComputeEngineDisksTargetDefaults is +// a collection of details for creating Persistent Disks in a target +// Compute Engine project. +type ComputeEngineDisksTargetDefaults struct { + // Disks: The details of each Persistent Disk to create. + Disks []*PersistentDiskDefaults `json:"disks,omitempty"` + + // TargetProject: The full path of the resource of type TargetProject + // which represents the Compute Engine project in which to create the + // Persistent Disks. + TargetProject string `json:"targetProject,omitempty"` + + // Zone: The zone in which to create the Persistent Disks. + Zone string `json:"zone,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Disks") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Disks") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ComputeEngineDisksTargetDefaults) MarshalJSON() ([]byte, error) { + type NoMethod ComputeEngineDisksTargetDefaults + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ComputeEngineDisksTargetDetails: ComputeEngineDisksTargetDetails is a +// collection of created Persistent Disks details. +type ComputeEngineDisksTargetDetails struct { + // Disks: The details of each created Persistent Disk. + Disks []*PersistentDisk `json:"disks,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Disks") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Disks") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ComputeEngineDisksTargetDetails) MarshalJSON() ([]byte, error) { + type NoMethod ComputeEngineDisksTargetDetails + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ComputeEngineTargetDefaults: ComputeEngineTargetDefaults is a // collection of details for creating a VM in a target Compute Engine // project. @@ -1238,6 +1309,10 @@ func (s *CutoverForecast) MarshalJSON() ([]byte, error) { // The CutoverJob is the operation of shutting down the VM, creating a // snapshot and clonning the VM using the replicated snapshot. type CutoverJob struct { + // ComputeEngineDisksTargetDetails: Output only. Details of the target + // Persistent Disks in Compute Engine. + ComputeEngineDisksTargetDetails *ComputeEngineDisksTargetDetails `json:"computeEngineDisksTargetDetails,omitempty"` + // ComputeEngineTargetDetails: Output only. Details of the target VM in // Compute Engine. ComputeEngineTargetDetails *ComputeEngineTargetDetails `json:"computeEngineTargetDetails,omitempty"` @@ -1303,7 +1378,7 @@ type CutoverJob struct { googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. - // "ComputeEngineTargetDetails") to unconditionally include in API + // "ComputeEngineDisksTargetDetails") to unconditionally include in API // requests. By default, fields with empty or default values are omitted // from API requests. However, any non-pointer, non-interface field // appearing in ForceSendFields will be sent to the server regardless of @@ -1312,8 +1387,8 @@ type CutoverJob struct { ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. - // "ComputeEngineTargetDetails") to include in API requests with the - // JSON null value. By default, fields with empty values are omitted + // "ComputeEngineDisksTargetDetails") to include in API requests with + // the JSON null value. By default, fields with empty values are omitted // from API requests. However, any field with an empty value appearing // in NullFields will be sent to the server as null. It is an error if a // field in this list has a non-empty value. This may be used to include @@ -1592,6 +1667,17 @@ type Group struct { // can be updated. DisplayName string `json:"displayName,omitempty"` + // MigrationTargetType: Immutable. The target type of this group. + // + // Possible values: + // "MIGRATION_TARGET_TYPE_UNSPECIFIED" - Group type is not specified. + // This defaults to Compute Engine targets. + // "MIGRATION_TARGET_TYPE_GCE" - All MigratingVMs in the group must + // have Compute Engine targets. + // "MIGRATION_TARGET_TYPE_DISKS" - All MigratingVMs in the group must + // have Compute Engine Disks targets. + MigrationTargetType string `json:"migrationTargetType,omitempty"` + // Name: Output only. The Group name. Name string `json:"name,omitempty"` @@ -2200,6 +2286,10 @@ type MigratingVm struct { // source. AwsSourceVmDetails *AwsSourceVmDetails `json:"awsSourceVmDetails,omitempty"` + // ComputeEngineDisksTargetDefaults: Details of the target Persistent + // Disks in Compute Engine. + ComputeEngineDisksTargetDefaults *ComputeEngineDisksTargetDefaults `json:"computeEngineDisksTargetDefaults,omitempty"` + // ComputeEngineTargetDefaults: Details of the target VM in Compute // Engine. ComputeEngineTargetDefaults *ComputeEngineTargetDefaults `json:"computeEngineTargetDefaults,omitempty"` @@ -2612,6 +2702,84 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { type PauseMigrationRequest struct { } +// PersistentDisk: Details of a created Persistent Disk. +type PersistentDisk struct { + // DiskUri: The URI of the Persistent Disk. + DiskUri string `json:"diskUri,omitempty"` + + // SourceDiskNumber: The ordinal number of the source VM disk. + SourceDiskNumber int64 `json:"sourceDiskNumber,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DiskUri") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DiskUri") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *PersistentDisk) MarshalJSON() ([]byte, error) { + type NoMethod PersistentDisk + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// PersistentDiskDefaults: Details for creation of a Persistent Disk. +type PersistentDiskDefaults struct { + // AdditionalLabels: A map of labels to associate with the Persistent + // Disk. + AdditionalLabels map[string]string `json:"additionalLabels,omitempty"` + + // DiskName: Optional. The name of the Persistent Disk to create. + DiskName string `json:"diskName,omitempty"` + + // DiskType: The disk type to use. + // + // Possible values: + // "COMPUTE_ENGINE_DISK_TYPE_UNSPECIFIED" - An unspecified disk type. + // Will be used as STANDARD. + // "COMPUTE_ENGINE_DISK_TYPE_STANDARD" - A Standard disk type. + // "COMPUTE_ENGINE_DISK_TYPE_SSD" - SSD hard disk type. + // "COMPUTE_ENGINE_DISK_TYPE_BALANCED" - An alternative to SSD + // persistent disks that balance performance and cost. + DiskType string `json:"diskType,omitempty"` + + // SourceDiskNumber: The ordinal number of the source VM disk. + SourceDiskNumber int64 `json:"sourceDiskNumber,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AdditionalLabels") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AdditionalLabels") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *PersistentDiskDefaults) MarshalJSON() ([]byte, error) { + type NoMethod PersistentDiskDefaults + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // PostProcessingStep: PostProcessingStep contains specific step // details. type PostProcessingStep struct { diff --git a/workloadmanager/v1/workloadmanager-api.json b/workloadmanager/v1/workloadmanager-api.json index e85afb840d6..a479d19d3b1 100644 --- a/workloadmanager/v1/workloadmanager-api.json +++ b/workloadmanager/v1/workloadmanager-api.json @@ -707,7 +707,7 @@ } } }, - "revision": "20230630", + "revision": "20230710", "rootUrl": "https://workloadmanager.googleapis.com/", "schemas": { "CancelOperationRequest": { @@ -1368,13 +1368,13 @@ "description": "Message describing the system component.", "id": "SapDiscoveryComponent", "properties": { - "applicationType": { - "description": "The component is a SAP application.", - "type": "string" + "applicationProperties": { + "$ref": "SapDiscoveryComponentApplicationProperties", + "description": "Optional. The component is a SAP application." }, - "databaseType": { - "description": "The component is a SAP database.", - "type": "string" + "databaseProperties": { + "$ref": "SapDiscoveryComponentDatabaseProperties", + "description": "Optional. The component is a SAP database." }, "hostProject": { "description": "Pantheon Project in which the resources reside.", @@ -1394,6 +1394,64 @@ }, "type": "object" }, + "SapDiscoveryComponentApplicationProperties": { + "description": "A set of properties describing an SAP Application layer.", + "id": "SapDiscoveryComponentApplicationProperties", + "properties": { + "applicationType": { + "description": "Required. Type of the application. Netweaver, etc.", + "enum": [ + "APPLICATION_TYPE_UNSPECIFIED", + "NETWEAVER" + ], + "enumDescriptions": [ + "Unspecified application type", + "SAP Netweaver" + ], + "type": "string" + }, + "ascsUri": { + "description": "Required. Resource URI of the recognized ASCS host of the application.", + "type": "string" + }, + "nfsUri": { + "description": "Optional. Resource URI of the recognized shared NFS of the application. May be empty if the application server has only a single node.", + "type": "string" + } + }, + "type": "object" + }, + "SapDiscoveryComponentDatabaseProperties": { + "description": "A set of properties describing an SAP Database layer.", + "id": "SapDiscoveryComponentDatabaseProperties", + "properties": { + "databaseType": { + "description": "Required. Type of the database. HANA, DB2, etc.", + "enum": [ + "DATABASE_TYPE_UNSPECIFIED", + "HANA", + "MAX_DB", + "DB2" + ], + "enumDescriptions": [ + "Unspecified database type.", + "SAP HANA", + "SAP MAX_DB", + "IBM DB2" + ], + "type": "string" + }, + "primaryInstanceUri": { + "description": "Required. URI of the recognized primary instance of the database.", + "type": "string" + }, + "sharedNfsUri": { + "description": "Optional. URI of the recognized shared NFS of the database. May be empty if the database has only a single node.", + "type": "string" + } + }, + "type": "object" + }, "SapDiscoveryMetadata": { "description": "Message describing SAP discovery system metadata", "id": "SapDiscoveryMetadata", @@ -1464,9 +1522,9 @@ "description": "Required. The type of this resource.", "enum": [ "RESOURCE_TYPE_UNSPECIFIED", - "COMPUTE", - "STORAGE", - "NETWORK" + "RESOURCE_TYPE_COMPUTE", + "RESOURCE_TYPE_STORAGE", + "RESOURCE_TYPE_NETWORK" ], "enumDescriptions": [ "Undefined resource type.", diff --git a/workloadmanager/v1/workloadmanager-gen.go b/workloadmanager/v1/workloadmanager-gen.go index a5199417a92..dcdaddad497 100644 --- a/workloadmanager/v1/workloadmanager-gen.go +++ b/workloadmanager/v1/workloadmanager-gen.go @@ -1200,11 +1200,11 @@ func (s *SapDiscovery) MarshalJSON() ([]byte, error) { // SapDiscoveryComponent: Message describing the system component. type SapDiscoveryComponent struct { - // ApplicationType: The component is a SAP application. - ApplicationType string `json:"applicationType,omitempty"` + // ApplicationProperties: Optional. The component is a SAP application. + ApplicationProperties *SapDiscoveryComponentApplicationProperties `json:"applicationProperties,omitempty"` - // DatabaseType: The component is a SAP database. - DatabaseType string `json:"databaseType,omitempty"` + // DatabaseProperties: Optional. The component is a SAP database. + DatabaseProperties *SapDiscoveryComponentDatabaseProperties `json:"databaseProperties,omitempty"` // HostProject: Pantheon Project in which the resources reside. HostProject string `json:"hostProject,omitempty"` @@ -1216,6 +1216,50 @@ type SapDiscoveryComponent struct { // differentiate systems for customers. Sid string `json:"sid,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "ApplicationProperties") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. However, any non-pointer, non-interface field appearing in + // ForceSendFields will be sent to the server regardless of whether the + // field is empty or not. This may be used to include empty fields in + // Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "ApplicationProperties") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *SapDiscoveryComponent) MarshalJSON() ([]byte, error) { + type NoMethod SapDiscoveryComponent + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// SapDiscoveryComponentApplicationProperties: A set of properties +// describing an SAP Application layer. +type SapDiscoveryComponentApplicationProperties struct { + // ApplicationType: Required. Type of the application. Netweaver, etc. + // + // Possible values: + // "APPLICATION_TYPE_UNSPECIFIED" - Unspecified application type + // "NETWEAVER" - SAP Netweaver + ApplicationType string `json:"applicationType,omitempty"` + + // AscsUri: Required. Resource URI of the recognized ASCS host of the + // application. + AscsUri string `json:"ascsUri,omitempty"` + + // NfsUri: Optional. Resource URI of the recognized shared NFS of the + // application. May be empty if the application server has only a single + // node. + NfsUri string `json:"nfsUri,omitempty"` + // ForceSendFields is a list of field names (e.g. "ApplicationType") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -1234,8 +1278,51 @@ type SapDiscoveryComponent struct { NullFields []string `json:"-"` } -func (s *SapDiscoveryComponent) MarshalJSON() ([]byte, error) { - type NoMethod SapDiscoveryComponent +func (s *SapDiscoveryComponentApplicationProperties) MarshalJSON() ([]byte, error) { + type NoMethod SapDiscoveryComponentApplicationProperties + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// SapDiscoveryComponentDatabaseProperties: A set of properties +// describing an SAP Database layer. +type SapDiscoveryComponentDatabaseProperties struct { + // DatabaseType: Required. Type of the database. HANA, DB2, etc. + // + // Possible values: + // "DATABASE_TYPE_UNSPECIFIED" - Unspecified database type. + // "HANA" - SAP HANA + // "MAX_DB" - SAP MAX_DB + // "DB2" - IBM DB2 + DatabaseType string `json:"databaseType,omitempty"` + + // PrimaryInstanceUri: Required. URI of the recognized primary instance + // of the database. + PrimaryInstanceUri string `json:"primaryInstanceUri,omitempty"` + + // SharedNfsUri: Optional. URI of the recognized shared NFS of the + // database. May be empty if the database has only a single node. + SharedNfsUri string `json:"sharedNfsUri,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DatabaseType") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DatabaseType") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *SapDiscoveryComponentDatabaseProperties) MarshalJSON() ([]byte, error) { + type NoMethod SapDiscoveryComponentDatabaseProperties raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } @@ -1310,9 +1397,9 @@ type SapDiscoveryResource struct { // // Possible values: // "RESOURCE_TYPE_UNSPECIFIED" - Undefined resource type. - // "COMPUTE" - This is a compute resource. - // "STORAGE" - This a storage resource. - // "NETWORK" - This is a network resource. + // "RESOURCE_TYPE_COMPUTE" - This is a compute resource. + // "RESOURCE_TYPE_STORAGE" - This a storage resource. + // "RESOURCE_TYPE_NETWORK" - This is a network resource. ResourceType string `json:"resourceType,omitempty"` // ResourceUri: URI of the resource, includes project, location, and