From 05df6bd9d66805c772a8899bfc467de61b32f01e Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Thu, 20 Apr 2023 07:14:01 +0000 Subject: [PATCH] feat(all): auto-regenerate discovery clients --- .../v2beta1/adexchangebuyer2-api.json | 4 +- .../v2beta1/adexchangebuyer2-gen.go | 1 + alertcenter/v1beta1/alertcenter-api.json | 10 +- alertcenter/v1beta1/alertcenter-gen.go | 11 +- androidpublisher/v3/androidpublisher-api.json | 24 +- androidpublisher/v3/androidpublisher-gen.go | 23 +- .../v1/businessprofileperformance-api.json | 4 +- .../v1/businessprofileperformance-gen.go | 3 +- cloudbuild/v1/cloudbuild-api.json | 63 +++++- cloudbuild/v1/cloudbuild-gen.go | 84 +++++++ datacatalog/v1/datacatalog-api.json | 11 +- datacatalog/v1/datacatalog-gen.go | 28 +-- datacatalog/v1beta1/datacatalog-api.json | 9 +- datacatalog/v1beta1/datacatalog-gen.go | 20 +- documentai/v1beta3/documentai-api.json | 4 +- documentai/v1beta3/documentai-gen.go | 6 +- drive/v2/drive-api.json | 9 +- drive/v2/drive-gen.go | 12 + drive/v3/drive-api.json | 81 +++---- drive/v3/drive-gen.go | 127 ++++++----- firestore/v1/firestore-api.json | 4 +- firestore/v1/firestore-gen.go | 2 +- retail/v2/retail-api.json | 22 +- retail/v2/retail-gen.go | 66 +++--- retail/v2alpha/retail-api.json | 28 +-- retail/v2alpha/retail-gen.go | 94 ++++---- retail/v2beta/retail-api.json | 22 +- retail/v2beta/retail-gen.go | 66 +++--- run/v1/run-api.json | 118 +++++----- run/v1/run-gen.go | 212 +++++++----------- speech/v1/speech-api.json | 22 +- speech/v1/speech-gen.go | 32 +++ speech/v1p1beta1/speech-api.json | 22 +- speech/v1p1beta1/speech-gen.go | 32 +++ webfonts/v1/webfonts-api.json | 61 ++++- webfonts/v1/webfonts-gen.go | 120 +++++++++- 36 files changed, 931 insertions(+), 526 deletions(-) diff --git a/adexchangebuyer2/v2beta1/adexchangebuyer2-api.json b/adexchangebuyer2/v2beta1/adexchangebuyer2-api.json index e04c9a71148..5feb20648dd 100644 --- a/adexchangebuyer2/v2beta1/adexchangebuyer2-api.json +++ b/adexchangebuyer2/v2beta1/adexchangebuyer2-api.json @@ -2568,7 +2568,7 @@ } } }, - "revision": "20220914", + "revision": "20230419", "rootUrl": "https://adexchangebuyer.googleapis.com/", "schemas": { "AbsoluteDateRange": { @@ -2732,7 +2732,7 @@ }, "billedImpressions": { "$ref": "MetricValue", - "description": "The number of bids for which the buyer was billed." + "description": "The number of bids for which the buyer was billed. Also called valid impressions as invalid impressions are not billed." }, "impressionsWon": { "$ref": "MetricValue", diff --git a/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go b/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go index 45bc2a32770..6ea5954db39 100644 --- a/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go +++ b/adexchangebuyer2/v2beta1/adexchangebuyer2-gen.go @@ -844,6 +844,7 @@ type BidMetricsRow struct { BidsInAuction *MetricValue `json:"bidsInAuction,omitempty"` // BilledImpressions: The number of bids for which the buyer was billed. + // Also called valid impressions as invalid impressions are not billed. BilledImpressions *MetricValue `json:"billedImpressions,omitempty"` // ImpressionsWon: The number of bids that won the auction. diff --git a/alertcenter/v1beta1/alertcenter-api.json b/alertcenter/v1beta1/alertcenter-api.json index 3e32dca6b50..69d0d32bf40 100644 --- a/alertcenter/v1beta1/alertcenter-api.json +++ b/alertcenter/v1beta1/alertcenter-api.json @@ -423,7 +423,7 @@ } } }, - "revision": "20230403", + "revision": "20230417", "rootUrl": "https://alertcenter.googleapis.com/", "schemas": { "AccountSuspensionDetails": { @@ -733,20 +733,20 @@ "type": "object" }, "ApnsCertificateExpirationInfo": { - "description": "The explanation message associated with ApnsCertificationExpiring and ApnsCertificationExpired alerts.", + "description": "The explanation message associated with \"APNS certificate is expiring soon\" and \"APNS certificate has expired\" alerts.", "id": "ApnsCertificateExpirationInfo", "properties": { "appleId": { - "description": "The Apple ID used for the certificate may be blank if admins didn't enter it.", + "description": "The Apple ID used to create the certificate. It may be blank if admins didn't enter it.", "type": "string" }, "expirationTime": { - "description": "The expiration date of the APNS Certificate.", + "description": "The expiration date of the APNS certificate.", "format": "google-datetime", "type": "string" }, "uid": { - "description": "The UID for the certificate.", + "description": "The UID of the certificate.", "type": "string" } }, diff --git a/alertcenter/v1beta1/alertcenter-gen.go b/alertcenter/v1beta1/alertcenter-gen.go index c8773cd8180..b26f761970a 100644 --- a/alertcenter/v1beta1/alertcenter-gen.go +++ b/alertcenter/v1beta1/alertcenter-gen.go @@ -589,16 +589,17 @@ func (s *AlertMetadata) MarshalJSON() ([]byte, error) { } // ApnsCertificateExpirationInfo: The explanation message associated -// with ApnsCertificationExpiring and ApnsCertificationExpired alerts. +// with "APNS certificate is expiring soon" and "APNS certificate has +// expired" alerts. type ApnsCertificateExpirationInfo struct { - // AppleId: The Apple ID used for the certificate may be blank if admins - // didn't enter it. + // AppleId: The Apple ID used to create the certificate. It may be blank + // if admins didn't enter it. AppleId string `json:"appleId,omitempty"` - // ExpirationTime: The expiration date of the APNS Certificate. + // ExpirationTime: The expiration date of the APNS certificate. ExpirationTime string `json:"expirationTime,omitempty"` - // Uid: The UID for the certificate. + // Uid: The UID of the certificate. Uid string `json:"uid,omitempty"` // ForceSendFields is a list of field names (e.g. "AppleId") to diff --git a/androidpublisher/v3/androidpublisher-api.json b/androidpublisher/v3/androidpublisher-api.json index d729f9bd5bd..436413f98d1 100644 --- a/androidpublisher/v3/androidpublisher-api.json +++ b/androidpublisher/v3/androidpublisher-api.json @@ -2099,7 +2099,7 @@ "inappproducts": { "methods": { "delete": { - "description": "Deletes an in-app product (i.e. a managed product or a subscriptions).", + "description": "Deletes an in-app product (i.e. a managed product or a subscription).", "flatPath": "androidpublisher/v3/applications/{packageName}/inappproducts/{sku}", "httpMethod": "DELETE", "id": "androidpublisher.inappproducts.delete", @@ -2158,7 +2158,7 @@ ] }, "insert": { - "description": "Creates an in-app product (i.e. a managed product or a subscriptions).", + "description": "Creates an in-app product (i.e. a managed product or a subscription).", "flatPath": "androidpublisher/v3/applications/{packageName}/inappproducts", "httpMethod": "POST", "id": "androidpublisher.inappproducts.insert", @@ -2211,7 +2211,7 @@ "type": "string" }, "startIndex": { - "description": "Deprecated and ignored. Set the `token` parameter to rertieve the next page.", + "description": "Deprecated and ignored. Set the `token` parameter to retrieve the next page.", "format": "uint32", "location": "query", "type": "integer" @@ -2231,7 +2231,7 @@ ] }, "patch": { - "description": "Patches an in-app product (i.e. a managed product or a subscriptions).", + "description": "Patches an in-app product (i.e. a managed product or a subscription).", "flatPath": "androidpublisher/v3/applications/{packageName}/inappproducts/{sku}", "httpMethod": "PATCH", "id": "androidpublisher.inappproducts.patch", @@ -2270,7 +2270,7 @@ ] }, "update": { - "description": "Updates an in-app product (i.e. a managed product or a subscriptions).", + "description": "Updates an in-app product (i.e. a managed product or a subscription).", "flatPath": "androidpublisher/v3/applications/{packageName}/inappproducts/{sku}", "httpMethod": "PUT", "id": "androidpublisher.inappproducts.update", @@ -4045,7 +4045,7 @@ } } }, - "revision": "20230406", + "revision": "20230418", "rootUrl": "https://androidpublisher.googleapis.com/", "schemas": { "AcquisitionTargetingRule": { @@ -5191,7 +5191,8 @@ "CAN_MANAGE_TRACK_USERS", "CAN_MANAGE_PUBLIC_LISTING", "CAN_MANAGE_DRAFT_APPS", - "CAN_MANAGE_ORDERS" + "CAN_MANAGE_ORDERS", + "CAN_MANAGE_APP_CONTENT" ], "enumDescriptions": [ "Unknown or unspecified permission.", @@ -5204,7 +5205,8 @@ "Manage testing tracks and edit tester lists.", "Manage store presence.", "Edit and delete draft apps.", - "Manage orders and subscriptions." + "Manage orders and subscriptions.", + "Manage policy related pages." ], "type": "string" }, @@ -7112,7 +7114,8 @@ "CAN_MANAGE_DRAFT_APPS_GLOBAL", "CAN_CREATE_MANAGED_PLAY_APPS_GLOBAL", "CAN_CHANGE_MANAGED_PLAY_SETTING_GLOBAL", - "CAN_MANAGE_ORDERS_GLOBAL" + "CAN_MANAGE_ORDERS_GLOBAL", + "CAN_MANAGE_APP_CONTENT_GLOBAL" ], "enumDescriptions": [ "Unknown or unspecified permission.", @@ -7129,7 +7132,8 @@ "Create, edit, and delete draft apps.", "Create and publish private apps to your organization.", "Choose whether apps are public, or only available to your organization.", - "Manage orders and subscriptions." + "Manage orders and subscriptions.", + "Manage policy related pages on all apps for the developer." ], "type": "string" }, diff --git a/androidpublisher/v3/androidpublisher-gen.go b/androidpublisher/v3/androidpublisher-gen.go index 68f31406aa0..4e7e922b8fc 100644 --- a/androidpublisher/v3/androidpublisher-gen.go +++ b/androidpublisher/v3/androidpublisher-gen.go @@ -2450,6 +2450,7 @@ type Grant struct { // "CAN_MANAGE_PUBLIC_LISTING" - Manage store presence. // "CAN_MANAGE_DRAFT_APPS" - Edit and delete draft apps. // "CAN_MANAGE_ORDERS" - Manage orders and subscriptions. + // "CAN_MANAGE_APP_CONTENT" - Manage policy related pages. AppLevelPermissions []string `json:"appLevelPermissions,omitempty"` // Name: Required. Resource name for this grant, following the pattern @@ -5975,6 +5976,8 @@ type User struct { // "CAN_CHANGE_MANAGED_PLAY_SETTING_GLOBAL" - Choose whether apps are // public, or only available to your organization. // "CAN_MANAGE_ORDERS_GLOBAL" - Manage orders and subscriptions. + // "CAN_MANAGE_APP_CONTENT_GLOBAL" - Manage policy related pages on + // all apps for the developer. DeveloperAccountPermissions []string `json:"developerAccountPermissions,omitempty"` // Email: Immutable. The user's email address. @@ -14301,7 +14304,7 @@ type InappproductsDeleteCall struct { } // Delete: Deletes an in-app product (i.e. a managed product or a -// subscriptions). +// subscription). // // - packageName: Package name of the app. // - sku: Unique identifier for the in-app product. @@ -14374,7 +14377,7 @@ func (c *InappproductsDeleteCall) Do(opts ...googleapi.CallOption) error { } return nil // { - // "description": "Deletes an in-app product (i.e. a managed product or a subscriptions).", + // "description": "Deletes an in-app product (i.e. a managed product or a subscription).", // "flatPath": "androidpublisher/v3/applications/{packageName}/inappproducts/{sku}", // "httpMethod": "DELETE", // "id": "androidpublisher.inappproducts.delete", @@ -14573,7 +14576,7 @@ type InappproductsInsertCall struct { } // Insert: Creates an in-app product (i.e. a managed product or a -// subscriptions). +// subscription). // // - packageName: Package name of the app. func (r *InappproductsService) Insert(packageName string, inappproduct *InAppProduct) *InappproductsInsertCall { @@ -14684,7 +14687,7 @@ func (c *InappproductsInsertCall) Do(opts ...googleapi.CallOption) (*InAppProduc } return ret, nil // { - // "description": "Creates an in-app product (i.e. a managed product or a subscriptions).", + // "description": "Creates an in-app product (i.e. a managed product or a subscription).", // "flatPath": "androidpublisher/v3/applications/{packageName}/inappproducts", // "httpMethod": "POST", // "id": "androidpublisher.inappproducts.insert", @@ -14751,7 +14754,7 @@ func (c *InappproductsListCall) MaxResults(maxResults int64) *InappproductsListC } // StartIndex sets the optional parameter "startIndex": Deprecated and -// ignored. Set the `token` parameter to rertieve the next page. +// ignored. Set the `token` parameter to retrieve the next page. func (c *InappproductsListCall) StartIndex(startIndex int64) *InappproductsListCall { c.urlParams_.Set("startIndex", fmt.Sprint(startIndex)) return c @@ -14884,7 +14887,7 @@ func (c *InappproductsListCall) Do(opts ...googleapi.CallOption) (*Inappproducts // "type": "string" // }, // "startIndex": { - // "description": "Deprecated and ignored. Set the `token` parameter to rertieve the next page.", + // "description": "Deprecated and ignored. Set the `token` parameter to retrieve the next page.", // "format": "uint32", // "location": "query", // "type": "integer" @@ -14919,7 +14922,7 @@ type InappproductsPatchCall struct { } // Patch: Patches an in-app product (i.e. a managed product or a -// subscriptions). +// subscription). // // - packageName: Package name of the app. // - sku: Unique identifier for the in-app product. @@ -15033,7 +15036,7 @@ func (c *InappproductsPatchCall) Do(opts ...googleapi.CallOption) (*InAppProduct } return ret, nil // { - // "description": "Patches an in-app product (i.e. a managed product or a subscriptions).", + // "description": "Patches an in-app product (i.e. a managed product or a subscription).", // "flatPath": "androidpublisher/v3/applications/{packageName}/inappproducts/{sku}", // "httpMethod": "PATCH", // "id": "androidpublisher.inappproducts.patch", @@ -15087,7 +15090,7 @@ type InappproductsUpdateCall struct { } // Update: Updates an in-app product (i.e. a managed product or a -// subscriptions). +// subscription). // // - packageName: Package name of the app. // - sku: Unique identifier for the in-app product. @@ -15209,7 +15212,7 @@ func (c *InappproductsUpdateCall) Do(opts ...googleapi.CallOption) (*InAppProduc } return ret, nil // { - // "description": "Updates an in-app product (i.e. a managed product or a subscriptions).", + // "description": "Updates an in-app product (i.e. a managed product or a subscription).", // "flatPath": "androidpublisher/v3/applications/{packageName}/inappproducts/{sku}", // "httpMethod": "PUT", // "id": "androidpublisher.inappproducts.update", diff --git a/businessprofileperformance/v1/businessprofileperformance-api.json b/businessprofileperformance/v1/businessprofileperformance-api.json index 9b88f9c9678..c35ebae5de8 100644 --- a/businessprofileperformance/v1/businessprofileperformance-api.json +++ b/businessprofileperformance/v1/businessprofileperformance-api.json @@ -417,7 +417,7 @@ } } }, - "revision": "20230416", + "revision": "20230419", "rootUrl": "https://businessprofileperformance.googleapis.com/", "schemas": { "DailyMetricTimeSeries": { @@ -533,7 +533,7 @@ "description": "The date that the datapoint corresponds to. This represents a month value if the day field is not set." }, "value": { - "description": "The value of the datapoint.", + "description": "The value of the datapoint. This will not be present when the value is zero.", "format": "int64", "type": "string" } diff --git a/businessprofileperformance/v1/businessprofileperformance-gen.go b/businessprofileperformance/v1/businessprofileperformance-gen.go index 25f3d4a7015..41be917ee68 100644 --- a/businessprofileperformance/v1/businessprofileperformance-gen.go +++ b/businessprofileperformance/v1/businessprofileperformance-gen.go @@ -336,7 +336,8 @@ type DatedValue struct { // month value if the day field is not set. Date *Date `json:"date,omitempty"` - // Value: The value of the datapoint. + // Value: The value of the datapoint. This will not be present when the + // value is zero. Value int64 `json:"value,omitempty,string"` // ForceSendFields is a list of field names (e.g. "Date") to diff --git a/cloudbuild/v1/cloudbuild-api.json b/cloudbuild/v1/cloudbuild-api.json index be5e5c95cda..48af4e213dc 100644 --- a/cloudbuild/v1/cloudbuild-api.json +++ b/cloudbuild/v1/cloudbuild-api.json @@ -2295,7 +2295,7 @@ } } }, - "revision": "20230406", + "revision": "20230417", "rootUrl": "https://cloudbuild.googleapis.com/", "schemas": { "ApprovalConfig": { @@ -2419,6 +2419,13 @@ }, "type": "array" }, + "npmPackages": { + "description": "A list of npm packages to be uploaded to Artifact Registry upon successful completion of all build steps. Npm packages in the specified paths will be uploaded to the specified Artifact Registry repository using the builder service account's credentials. If any packages fail to be pushed, the build is marked FAILURE.", + "items": { + "$ref": "NpmPackage" + }, + "type": "array" + }, "objects": { "$ref": "ArtifactObjects", "description": "A list of objects to be uploaded to Cloud Storage upon successful completion of all build steps. Files in the workspace matching specified paths globs will be uploaded to the specified Cloud Storage location using the builder service account's credentials. The location and generation of the uploaded objects will be stored in the Build resource's results field. If any objects fail to be pushed, the build is marked FAILURE." @@ -3052,12 +3059,14 @@ "enum": [ "NONE", "SHA256", - "MD5" + "MD5", + "SHA512" ], "enumDescriptions": [ "No hash requested.", "Use a sha256 hash.", - "Use a md5 hash." + "Use a md5 hash.", + "Use a sha512 hash." ], "type": "string" }, @@ -4067,12 +4076,14 @@ "enum": [ "NONE", "SHA256", - "MD5" + "MD5", + "SHA512" ], "enumDescriptions": [ "No hash requested.", "Use a sha256 hash.", - "Use a md5 hash." + "Use a md5 hash.", + "Use a sha512 hash." ], "type": "string" }, @@ -4326,6 +4337,21 @@ }, "type": "object" }, + "NpmPackage": { + "description": "Npm package to upload to Artifact Registry upon successful completion of all build steps.", + "id": "NpmPackage", + "properties": { + "packagePath": { + "description": "Path to the package.json. e.g. workspace/path/to/package", + "type": "string" + }, + "repository": { + "description": "Artifact Registry repository, in the form \"https://$REGION-npm.pkg.dev/$PROJECT/$REPOSITORY\" Npm package in the workspace specified by path will be zipped and uploaded to Artifact Registry with this location as a prefix.", + "type": "string" + } + }, + "type": "object" + }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -4703,6 +4729,13 @@ }, "type": "array" }, + "npmPackages": { + "description": "Npm packages uploaded to Artifact Registry at the end of the build.", + "items": { + "$ref": "UploadedNpmPackage" + }, + "type": "array" + }, "numArtifacts": { "description": "Number of non-container artifacts uploaded to Cloud Storage. Only populated when artifacts are uploaded to Cloud Storage.", "format": "int64", @@ -5060,6 +5093,26 @@ }, "type": "object" }, + "UploadedNpmPackage": { + "description": "An npm package uploaded to Artifact Registry using the NpmPackage directive.", + "id": "UploadedNpmPackage", + "properties": { + "fileHashes": { + "$ref": "FileHashes", + "description": "Hash types and values of the npm package." + }, + "pushTiming": { + "$ref": "TimeSpan", + "description": "Output only. Stores timing information for pushing the specified artifact.", + "readOnly": true + }, + "uri": { + "description": "URI of the uploaded npm package.", + "type": "string" + } + }, + "type": "object" + }, "UploadedPythonPackage": { "description": "Artifact uploaded using the PythonPackage directive.", "id": "UploadedPythonPackage", diff --git a/cloudbuild/v1/cloudbuild-gen.go b/cloudbuild/v1/cloudbuild-gen.go index 535fc721a09..554386fdc73 100644 --- a/cloudbuild/v1/cloudbuild-gen.go +++ b/cloudbuild/v1/cloudbuild-gen.go @@ -582,6 +582,13 @@ type Artifacts struct { // is marked FAILURE. MavenArtifacts []*MavenArtifact `json:"mavenArtifacts,omitempty"` + // NpmPackages: A list of npm packages to be uploaded to Artifact + // Registry upon successful completion of all build steps. Npm packages + // in the specified paths will be uploaded to the specified Artifact + // Registry repository using the builder service account's credentials. + // If any packages fail to be pushed, the build is marked FAILURE. + NpmPackages []*NpmPackage `json:"npmPackages,omitempty"` + // Objects: A list of objects to be uploaded to Cloud Storage upon // successful completion of all build steps. Files in the workspace // matching specified paths globs will be uploaded to the specified @@ -1467,6 +1474,7 @@ type BuildOptions struct { // "NONE" - No hash requested. // "SHA256" - Use a sha256 hash. // "MD5" - Use a md5 hash. + // "SHA512" - Use a sha512 hash. SourceProvenanceHash []string `json:"sourceProvenanceHash,omitempty"` // SubstitutionOption: Option to specify behavior when there is an error @@ -3036,6 +3044,7 @@ type Hash struct { // "NONE" - No hash requested. // "SHA256" - Use a sha256 hash. // "MD5" - Use a md5 hash. + // "SHA512" - Use a sha512 hash. Type string `json:"type,omitempty"` // Value: The hash value. @@ -3562,6 +3571,41 @@ func (s *NetworkConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// NpmPackage: Npm package to upload to Artifact Registry upon +// successful completion of all build steps. +type NpmPackage struct { + // PackagePath: Path to the package.json. e.g. workspace/path/to/package + PackagePath string `json:"packagePath,omitempty"` + + // Repository: Artifact Registry repository, in the form + // "https://$REGION-npm.pkg.dev/$PROJECT/$REPOSITORY" Npm package in the + // workspace specified by path will be zipped and uploaded to Artifact + // Registry with this location as a prefix. + Repository string `json:"repository,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PackagePath") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "PackagePath") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *NpmPackage) MarshalJSON() ([]byte, error) { + type NoMethod NpmPackage + 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 { @@ -4161,6 +4205,10 @@ type Results struct { // end of the build. MavenArtifacts []*UploadedMavenArtifact `json:"mavenArtifacts,omitempty"` + // NpmPackages: Npm packages uploaded to Artifact Registry at the end of + // the build. + NpmPackages []*UploadedNpmPackage `json:"npmPackages,omitempty"` + // NumArtifacts: Number of non-container artifacts uploaded to Cloud // Storage. Only populated when artifacts are uploaded to Cloud Storage. NumArtifacts int64 `json:"numArtifacts,omitempty,string"` @@ -4834,6 +4882,42 @@ func (s *UploadedMavenArtifact) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// UploadedNpmPackage: An npm package uploaded to Artifact Registry +// using the NpmPackage directive. +type UploadedNpmPackage struct { + // FileHashes: Hash types and values of the npm package. + FileHashes *FileHashes `json:"fileHashes,omitempty"` + + // PushTiming: Output only. Stores timing information for pushing the + // specified artifact. + PushTiming *TimeSpan `json:"pushTiming,omitempty"` + + // Uri: URI of the uploaded npm package. + Uri string `json:"uri,omitempty"` + + // ForceSendFields is a list of field names (e.g. "FileHashes") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "FileHashes") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *UploadedNpmPackage) MarshalJSON() ([]byte, error) { + type NoMethod UploadedNpmPackage + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // UploadedPythonPackage: Artifact uploaded using the PythonPackage // directive. type UploadedPythonPackage struct { diff --git a/datacatalog/v1/datacatalog-api.json b/datacatalog/v1/datacatalog-api.json index 30a0f7e441c..7ed1c4729ca 100644 --- a/datacatalog/v1/datacatalog-api.json +++ b/datacatalog/v1/datacatalog-api.json @@ -137,7 +137,7 @@ "parameterOrder": [], "parameters": { "fullyQualifiedName": { - "description": "Fully qualified name (FQN) of the resource. FQNs take two forms: * For non-regionalized resources: `{SYSTEM}:{PROJECT}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}` * For regionalized resources: `{SYSTEM}:{PROJECT}.{LOCATION_ID}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}` Example for a DPMS table: `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INSTANCE_ID}.{DATABASE_ID}.{TABLE_ID}`", + "description": "[Fully Qualified Name (FQN)](https://cloud.google.com//data-catalog/docs/fully-qualified-names) of the resource. FQNs take two forms: * For non-regionalized resources: `{SYSTEM}:{PROJECT}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}` * For regionalized resources: `{SYSTEM}:{PROJECT}.{LOCATION_ID}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}` Example for a DPMS table: `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INSTANCE_ID}.{DATABASE_ID}.{TABLE_ID}`", "location": "query", "type": "string" }, @@ -2134,7 +2134,7 @@ } } }, - "revision": "20230404", + "revision": "20230414", "rootUrl": "https://datacatalog.googleapis.com/", "schemas": { "Binding": { @@ -2812,7 +2812,7 @@ "description": "Specification that applies to a fileset resource. Valid only for entries with the `FILESET` type." }, "fullyQualifiedName": { - "description": "Fully qualified name (FQN) of the resource. Set automatically for entries representing resources from synced systems. Settable only during creation and read-only afterwards. Can be used for search and lookup of the entries. FQNs take two forms: * For non-regionalized resources: `{SYSTEM}:{PROJECT}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}` * For regionalized resources: `{SYSTEM}:{PROJECT}.{LOCATION_ID}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}` Example for a DPMS table: `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INSTANCE_ID}.{DATABASE_ID}.{TABLE_ID}`", + "description": "[Fully Qualified Name (FQN)](https://cloud.google.com//data-catalog/docs/fully-qualified-names) of the resource. Set automatically for entries representing resources from synced systems. Settable only during creation, and read-only later. Can be used for search and lookup of the entries. ", "type": "string" }, "gcsFilesetSpec": { @@ -3758,6 +3758,11 @@ }, "type": "array" }, + "totalSize": { + "description": "The approximate total number of entries matched by the query.", + "format": "int32", + "type": "integer" + }, "unreachable": { "description": "Unreachable locations. Search results don't include data from those locations. To get additional information on an error, repeat the search request and restrict it to specific locations by setting the `SearchCatalogRequest.scope.restricted_locations` parameter.", "items": { diff --git a/datacatalog/v1/datacatalog-gen.go b/datacatalog/v1/datacatalog-gen.go index 235d418cfd3..1cd31d650b5 100644 --- a/datacatalog/v1/datacatalog-gen.go +++ b/datacatalog/v1/datacatalog-gen.go @@ -1506,17 +1506,11 @@ type GoogleCloudDatacatalogV1Entry struct { // only for entries with the `FILESET` type. FilesetSpec *GoogleCloudDatacatalogV1FilesetSpec `json:"filesetSpec,omitempty"` - // FullyQualifiedName: Fully qualified name (FQN) of the resource. Set - // automatically for entries representing resources from synced systems. - // Settable only during creation and read-only afterwards. Can be used - // for search and lookup of the entries. FQNs take two forms: * For - // non-regionalized resources: - // `{SYSTEM}:{PROJECT}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}` * For - // regionalized resources: - // `{SYSTEM}:{PROJECT}.{LOCATION_ID}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOT - // S}` Example for a DPMS table: - // `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INSTANCE_ID}.{DATABASE - // _ID}.{TABLE_ID}` + // FullyQualifiedName: Fully Qualified Name (FQN) + // (https://cloud.google.com//data-catalog/docs/fully-qualified-names) + // of the resource. Set automatically for entries representing resources + // from synced systems. Settable only during creation, and read-only + // later. Can be used for search and lookup of the entries. FullyQualifiedName string `json:"fullyQualifiedName,omitempty"` // GcsFilesetSpec: Specification that applies to a Cloud Storage @@ -3232,6 +3226,10 @@ type GoogleCloudDatacatalogV1SearchCatalogResponse struct { // Results: Search results. Results []*GoogleCloudDatacatalogV1SearchCatalogResult `json:"results,omitempty"` + // TotalSize: The approximate total number of entries matched by the + // query. + TotalSize int64 `json:"totalSize,omitempty"` + // Unreachable: Unreachable locations. Search results don't include data // from those locations. To get additional information on an error, // repeat the search request and restrict it to specific locations by @@ -4777,8 +4775,10 @@ func (r *EntriesService) Lookup() *EntriesLookupCall { } // FullyQualifiedName sets the optional parameter "fullyQualifiedName": -// Fully qualified name (FQN) of the resource. FQNs take two forms: * -// For non-regionalized resources: +// Fully Qualified Name (FQN) +// (https://cloud.google.com//data-catalog/docs/fully-qualified-names) +// of the resource. FQNs take two forms: * For non-regionalized +// resources: // `{SYSTEM}:{PROJECT}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}` * For // regionalized resources: // `{SYSTEM}:{PROJECT}.{LOCATION_ID}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOT @@ -4921,7 +4921,7 @@ func (c *EntriesLookupCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataca // "parameterOrder": [], // "parameters": { // "fullyQualifiedName": { - // "description": "Fully qualified name (FQN) of the resource. FQNs take two forms: * For non-regionalized resources: `{SYSTEM}:{PROJECT}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}` * For regionalized resources: `{SYSTEM}:{PROJECT}.{LOCATION_ID}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}` Example for a DPMS table: `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INSTANCE_ID}.{DATABASE_ID}.{TABLE_ID}`", + // "description": "[Fully Qualified Name (FQN)](https://cloud.google.com//data-catalog/docs/fully-qualified-names) of the resource. FQNs take two forms: * For non-regionalized resources: `{SYSTEM}:{PROJECT}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}` * For regionalized resources: `{SYSTEM}:{PROJECT}.{LOCATION_ID}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}` Example for a DPMS table: `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INSTANCE_ID}.{DATABASE_ID}.{TABLE_ID}`", // "location": "query", // "type": "string" // }, diff --git a/datacatalog/v1beta1/datacatalog-api.json b/datacatalog/v1beta1/datacatalog-api.json index 43aa9cf8bf2..a42db2bb2e1 100644 --- a/datacatalog/v1beta1/datacatalog-api.json +++ b/datacatalog/v1beta1/datacatalog-api.json @@ -1813,7 +1813,7 @@ } } }, - "revision": "20230404", + "revision": "20230414", "rootUrl": "https://datacatalog.googleapis.com/", "schemas": { "Binding": { @@ -2480,7 +2480,7 @@ "description": "Specification that applies to a fileset resource. Valid only for entries with the `FILESET` type." }, "fullyQualifiedName": { - "description": "Fully qualified name (FQN) of the resource. Set automatically for entries representing resources from synced systems. Settable only during creation and read-only afterwards. Can be used for search and lookup of the entries. FQNs take two forms: * For non-regionalized resources: `{SYSTEM}:{PROJECT}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}` * For regionalized resources: `{SYSTEM}:{PROJECT}.{LOCATION_ID}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}` Example for a DPMS table: `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INSTANCE_ID}.{DATABASE_ID}.{TABLE_ID}`", + "description": "[Fully Qualified Name (FQN)](https://cloud.google.com//data-catalog/docs/fully-qualified-names) of the resource. Set automatically for entries representing resources from synced systems. Settable only during creation, and read-only later. Can be used for search and lookup of the entries. ", "type": "string" }, "gcsFilesetSpec": { @@ -3844,6 +3844,11 @@ }, "type": "array" }, + "totalSize": { + "description": "The approximate total number of entries matched by the query.", + "format": "int32", + "type": "integer" + }, "unreachable": { "description": "Unreachable locations. Search result does not include data from those locations. Users can get additional information on the error by repeating the search request with a more restrictive parameter -- setting the value for `SearchDataCatalogRequest.scope.restricted_locations`.", "items": { diff --git a/datacatalog/v1beta1/datacatalog-gen.go b/datacatalog/v1beta1/datacatalog-gen.go index bceaed88f99..74d6cf0ae75 100644 --- a/datacatalog/v1beta1/datacatalog-gen.go +++ b/datacatalog/v1beta1/datacatalog-gen.go @@ -1460,17 +1460,11 @@ type GoogleCloudDatacatalogV1Entry struct { // only for entries with the `FILESET` type. FilesetSpec *GoogleCloudDatacatalogV1FilesetSpec `json:"filesetSpec,omitempty"` - // FullyQualifiedName: Fully qualified name (FQN) of the resource. Set - // automatically for entries representing resources from synced systems. - // Settable only during creation and read-only afterwards. Can be used - // for search and lookup of the entries. FQNs take two forms: * For - // non-regionalized resources: - // `{SYSTEM}:{PROJECT}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}` * For - // regionalized resources: - // `{SYSTEM}:{PROJECT}.{LOCATION_ID}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOT - // S}` Example for a DPMS table: - // `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INSTANCE_ID}.{DATABASE - // _ID}.{TABLE_ID}` + // FullyQualifiedName: Fully Qualified Name (FQN) + // (https://cloud.google.com//data-catalog/docs/fully-qualified-names) + // of the resource. Set automatically for entries representing resources + // from synced systems. Settable only during creation, and read-only + // later. Can be used for search and lookup of the entries. FullyQualifiedName string `json:"fullyQualifiedName,omitempty"` // GcsFilesetSpec: Specification that applies to a Cloud Storage @@ -3922,6 +3916,10 @@ type GoogleCloudDatacatalogV1beta1SearchCatalogResponse struct { // Results: Search results. Results []*GoogleCloudDatacatalogV1beta1SearchCatalogResult `json:"results,omitempty"` + // TotalSize: The approximate total number of entries matched by the + // query. + TotalSize int64 `json:"totalSize,omitempty"` + // Unreachable: Unreachable locations. Search result does not include // data from those locations. Users can get additional information on // the error by repeating the search request with a more restrictive diff --git a/documentai/v1beta3/documentai-api.json b/documentai/v1beta3/documentai-api.json index 2fc47f890a3..dcede92a70b 100644 --- a/documentai/v1beta3/documentai-api.json +++ b/documentai/v1beta3/documentai-api.json @@ -1012,7 +1012,7 @@ } } }, - "revision": "20230330", + "revision": "20230417", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -6720,7 +6720,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3ImportProcessorVersionRequest": { - "description": "The request message for the ImportProcessorVersion method. This method requires Document AI Service Agent of the destination project in the source project's IAM with [Document AI Editor role](https://cloud.google.com/document-ai/docs/access-control/iam-roles). The destination project is specified as part of the `parent` field. The source project is specified as part of `source` field. The Service Agent for Document AI can be found in https://cloud.google.com/iam/docs/service-agents.", + "description": "The request message for the ImportProcessorVersion method. This method requires source processor version and destination processor are in the same location. This method requires Document AI Service Agent of the destination project in the source project's IAM with [Document AI Editor role](https://cloud.google.com/document-ai/docs/access-control/iam-roles). The destination project is specified as part of the `parent` field. The source project is specified as part of `source` field. The Service Agent for Document AI can be found in https://cloud.google.com/iam/docs/service-agents.", "id": "GoogleCloudDocumentaiV1beta3ImportProcessorVersionRequest", "properties": { "processorVersionSource": { diff --git a/documentai/v1beta3/documentai-gen.go b/documentai/v1beta3/documentai-gen.go index 126ddca3030..6ae33876176 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -9928,8 +9928,10 @@ func (s *GoogleCloudDocumentaiV1beta3ImportProcessorVersionMetadata) MarshalJSON // GoogleCloudDocumentaiV1beta3ImportProcessorVersionRequest: The // request message for the ImportProcessorVersion method. This method -// requires Document AI Service Agent of the destination project in the -// source project's IAM with Document AI Editor role +// requires source processor version and destination processor are in +// the same location. This method requires Document AI Service Agent of +// the destination project in the source project's IAM with Document AI +// Editor role // (https://cloud.google.com/document-ai/docs/access-control/iam-roles). // The destination project is specified as part of the `parent` field. // The source project is specified as part of `source` field. The diff --git a/drive/v2/drive-api.json b/drive/v2/drive-api.json index f046a23ec2a..1d9e12f340e 100644 --- a/drive/v2/drive-api.json +++ b/drive/v2/drive-api.json @@ -38,7 +38,7 @@ "description": "Manages files in Drive including uploading, downloading, searching, detecting changes, and updating sharing permissions.", "discoveryVersion": "v1", "documentationLink": "https://developers.google.com/drive/", - "etag": "\"uWj2hSb4GVjzdDlAnRd2gbM1ZQ8/YVCKnp3Zl6X5A7iBN9YZ0dNBIBk\"", + "etag": "\"VYc8DWo_6wRTElVugbtvWfkARsc/LYVlaRfUrd22kdDK7YfGWrMedUY\"", "icons": { "x16": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_16.png", "x32": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_32.png" @@ -1294,6 +1294,11 @@ "httpMethod": "DELETE", "id": "drive.files.emptyTrash", "parameters": { + "driveId": { + "description": "If set, empties the trash of the provided shared drive.", + "location": "query", + "type": "string" + }, "enforceSingleParent": { "default": "false", "description": "Deprecated. If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root.", @@ -3668,7 +3673,7 @@ } } }, - "revision": "20230212", + "revision": "20230413", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { diff --git a/drive/v2/drive-gen.go b/drive/v2/drive-gen.go index 4f4049f9863..bca8095c520 100644 --- a/drive/v2/drive-gen.go +++ b/drive/v2/drive-gen.go @@ -9306,6 +9306,13 @@ func (r *FilesService) EmptyTrash() *FilesEmptyTrashCall { return c } +// DriveId sets the optional parameter "driveId": If set, empties the +// trash of the provided shared drive. +func (c *FilesEmptyTrashCall) DriveId(driveId string) *FilesEmptyTrashCall { + c.urlParams_.Set("driveId", driveId) + return c +} + // EnforceSingleParent sets the optional parameter // "enforceSingleParent": Deprecated. If an item is not in a shared // drive and its last parent is deleted but the item itself is not, the @@ -9377,6 +9384,11 @@ func (c *FilesEmptyTrashCall) Do(opts ...googleapi.CallOption) error { // "httpMethod": "DELETE", // "id": "drive.files.emptyTrash", // "parameters": { + // "driveId": { + // "description": "If set, empties the trash of the provided shared drive.", + // "location": "query", + // "type": "string" + // }, // "enforceSingleParent": { // "default": "false", // "description": "Deprecated. If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root.", diff --git a/drive/v3/drive-api.json b/drive/v3/drive-api.json index c043fa399dc..a58f7461b3d 100644 --- a/drive/v3/drive-api.json +++ b/drive/v3/drive-api.json @@ -35,7 +35,7 @@ "description": "Manages files in Drive including uploading, downloading, searching, detecting changes, and updating sharing permissions.", "discoveryVersion": "v1", "documentationLink": "https://developers.google.com/drive/", - "etag": "\"uWj2hSb4GVjzdDlAnRd2gbM1ZQ8/y-B53r5mcDm2TryM80Julc5jb34\"", + "etag": "\"VYc8DWo_6wRTElVugbtvWfkARsc/LNE_sW6QDmVvlTRH3pwh_AYe3ik\"", "icons": { "x16": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_16.png", "x32": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_32.png" @@ -1001,6 +1001,11 @@ "httpMethod": "DELETE", "id": "drive.files.emptyTrash", "parameters": { + "driveId": { + "description": "If set, empties the trash of the provided shared drive.", + "location": "query", + "type": "string" + }, "enforceSingleParent": { "default": "false", "description": "Deprecated. If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root.", @@ -1424,7 +1429,7 @@ "supportsMediaUpload": true }, "watch": { - "description": "Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification.", + "description": "Subscribes to changes to a file.", "httpMethod": "POST", "id": "drive.files.watch", "parameterOrder": [ @@ -2312,7 +2317,7 @@ } } }, - "revision": "20230306", + "revision": "20230413", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { @@ -2930,22 +2935,22 @@ "additionalProperties": { "type": "string" }, - "description": "A collection of arbitrary key-value pairs which are private to the requesting app.\nEntries with null values are cleared in update and copy requests. These properties can only be retrieved using an authenticated request. An authenticated request uses an access token obtained with a OAuth 2 client ID. You cannot use an API key to retrieve private properties.", + "description": "A collection of arbitrary key-value pairs that are private to the requesting app.\nEntries with null values are cleared in update and copy requests. These properties can only be retrieved using an authenticated request. An authenticated request uses an access token obtained with an OAuth 2 client ID. You cannot use an API key to retrieve private properties.", "type": "object" }, "capabilities": { - "description": "Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take.", + "description": "Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user can take.", "properties": { "canAcceptOwnership": { "description": "Whether the current user is the pending owner of the file. Not populated for shared drive files.", "type": "boolean" }, "canAddChildren": { - "description": "Whether the current user can add children to this folder. This is always false when the item is not a folder.", + "description": "Whether the current user can add children to this folder. This is always false when the item isn't a folder.", "type": "boolean" }, "canAddFolderFromAnotherDrive": { - "description": "Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives.", + "description": "Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item isn't a folder. Only populated for items in shared drives.", "type": "boolean" }, "canAddMyDriveParent": { @@ -2969,7 +2974,7 @@ "type": "boolean" }, "canCopy": { - "description": "Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it is not a folder.", + "description": "Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it's not a folder.", "type": "boolean" }, "canDelete": { @@ -2977,7 +2982,7 @@ "type": "boolean" }, "canDeleteChildren": { - "description": "Whether the current user can delete children of this folder. This is false when the item is not a folder. Only populated for items in shared drives.", + "description": "Whether the current user can delete children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives.", "type": "boolean" }, "canDownload": { @@ -2985,11 +2990,11 @@ "type": "boolean" }, "canEdit": { - "description": "Whether the current user can edit this file. Other factors may limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent.", + "description": "Whether the current user can edit this file. Other factors might limit the type of changes a user can make to a file. For example, see canChangeCopyRequiresWriterPermission or canModifyContent.", "type": "boolean" }, "canListChildren": { - "description": "Whether the current user can list the children of this folder. This is always false when the item is not a folder.", + "description": "Whether the current user can list the children of this folder. This is always false when the item isn't a folder.", "type": "boolean" }, "canModifyContent": { @@ -3005,7 +3010,7 @@ "type": "boolean" }, "canMoveChildrenOutOfDrive": { - "description": "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.", + "description": "Whether the current user can move children of this folder outside of the shared drive. This is false when the item isn't a folder. Only populated for items in shared drives.", "type": "boolean" }, "canMoveChildrenOutOfTeamDrive": { @@ -3013,7 +3018,7 @@ "type": "boolean" }, "canMoveChildrenWithinDrive": { - "description": "Whether the current user can move children of this folder within this drive. This is false when the item is not a folder. Note that a request to move the child may still fail depending on the current user's access to the child and to the destination folder.", + "description": "Whether the current user can move children of this folder within this shared drive or My Drive. This is false when the item isn't a folder. Note that a request to move the child might still fail depending on the current user's access to the child and to the destination folder.", "type": "boolean" }, "canMoveChildrenWithinTeamDrive": { @@ -3025,7 +3030,7 @@ "type": "boolean" }, "canMoveItemOutOfDrive": { - "description": "Whether the current user can move this item outside of this drive by changing its parent. Note that a request to change the parent of the item may still fail depending on the new parent that is being added.", + "description": "Whether the current user can move this item outside of this shared drive or My Drive by changing its parent. Note that a request to change the parent of the item might still fail depending on the new parent that's being added.", "type": "boolean" }, "canMoveItemOutOfTeamDrive": { @@ -3033,7 +3038,7 @@ "type": "boolean" }, "canMoveItemWithinDrive": { - "description": "Whether the current user can move this item within this drive. Note that a request to change the parent of the item may still fail depending on the new parent that is being added and the parent that is being removed.", + "description": "Whether the current user can move this item within this shared drive or My Drive. Note that a request to change the parent of the item might still fail depending on the new parent that's being added and the parent that's being removed.", "type": "boolean" }, "canMoveItemWithinTeamDrive": { @@ -3053,7 +3058,7 @@ "type": "boolean" }, "canReadRevisions": { - "description": "Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it isn't a folder, can be read.", + "description": "Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it's not a folder, can be read.", "type": "boolean" }, "canReadTeamDrive": { @@ -3061,7 +3066,7 @@ "type": "boolean" }, "canRemoveChildren": { - "description": "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.", + "description": "Whether the current user can remove children from this folder. This is always false when the item isn't a folder. For a folder in a shared drive, use canDeleteChildren or canTrashChildren instead.", "type": "boolean" }, "canRemoveMyDriveParent": { @@ -3081,7 +3086,7 @@ "type": "boolean" }, "canTrashChildren": { - "description": "Whether the current user can trash children of this folder. This is false when the item is not a folder. Only populated for items in shared drives.", + "description": "Whether the current user can trash children of this folder. This is false when the item isn't a folder. Only populated for items in shared drives.", "type": "boolean" }, "canUntrash": { @@ -3095,7 +3100,7 @@ "description": "Additional information about the content of the file. These fields are never populated in responses.", "properties": { "indexableText": { - "description": "Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and may contain HTML elements. For more information, see Manage file metadata.", + "description": "Text to be indexed for the file to improve fullText queries. This is limited to 128 KB in length and might contain HTML elements. For more information, see Manage file metadata.", "type": "string" }, "thumbnail": { @@ -3162,7 +3167,7 @@ "type": "string" }, "fullFileExtension": { - "description": "The full file extension extracted from the name field. May contain multiple concatenated extensions, such as \"tar.gz\". This is only available for files with binary content in Google Drive.\nThis is automatically updated when the name field changes, however it isn't cleared if the new name does not contain a valid extension.", + "description": "The full file extension extracted from the name field. Can contain multiple concatenated extensions, such as \"tar.gz\". This is only available for files with binary content in Google Drive.\nThis is automatically updated when the name field changes, however it's not cleared if the new name does not contain a valid extension.", "type": "string" }, "hasAugmentedPermissions": { @@ -3174,7 +3179,7 @@ "type": "boolean" }, "headRevisionId": { - "description": "The ID of the file's head revision. This is currently only available for files with binary content in Google Drive.", + "description": "The ID of the file's head revision. This is only available for files with binary content in Google Drive.", "type": "string" }, "iconLink": { @@ -3273,7 +3278,7 @@ "type": "string" }, "rotation": { - "description": "The number of clockwise 90 degree rotations applied from the image's original orientation.", + "description": "The number of clockwise 90-degree rotations applied from the image's original orientation.", "format": "int32", "type": "integer" }, @@ -3303,7 +3308,7 @@ "type": "object" }, "isAppAuthorized": { - "description": "Whether the file was created or opened by the requesting app.", + "description": "Whether the requesting app created or opened the file.", "type": "boolean" }, "kind": { @@ -3351,21 +3356,21 @@ "type": "string" }, "modifiedByMe": { - "description": "Whether the file has been modified by this user.", + "description": "Whether this user has modified the file.", "type": "boolean" }, "modifiedByMeTime": { - "description": "The last time the file was modified by the user (RFC 3339 date-time).", + "description": "The last time the user modified the file (RFC 3339 date-time).", "format": "date-time", "type": "string" }, "modifiedTime": { - "description": "The last time the file was modified by anyone (RFC 3339 date-time).\nNote that setting modifiedTime will also update modifiedByMeTime for the user.", + "description": "The last time anyone modified the file (RFC 3339 date-time).\nNote that setting modifiedTime will also update modifiedByMeTime for the user.", "format": "date-time", "type": "string" }, "name": { - "description": "The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant.", + "description": "The name of the file. This isn't necessarily unique within a folder. Note that for immutable items such as the top-level folders of shared drives, My Drive root folder, and Application Data folder the name is constant.", "type": "string" }, "originalFilename": { @@ -3377,14 +3382,14 @@ "type": "boolean" }, "owners": { - "description": "The owner of this file. Only certain legacy files may have more than one owner. This field isn't populated for items in shared drives.", + "description": "The owner of this file. Only certain legacy files might have more than one owner. This field isn't populated for items in shared drives.", "items": { "$ref": "User" }, "type": "array" }, "parents": { - "description": "The IDs of the parent folders which contain the file.\nIf not specified as part of a create request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list.", + "description": "The IDs of the parent folders that contain the file.\nIf not specified as part of a create request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list.", "items": { "type": "string" }, @@ -3408,7 +3413,7 @@ "additionalProperties": { "type": "string" }, - "description": "A collection of arbitrary key-value pairs which are visible to all apps.\nEntries with null values are cleared in update and copy requests.", + "description": "A collection of arbitrary key-value pairs that are visible to all apps.\nEntries with null values are cleared in update and copy requests.", "type": "object" }, "quotaBytesUsed": { @@ -3421,11 +3426,11 @@ "type": "string" }, "sha1Checksum": { - "description": "The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files.", + "description": "The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files.", "type": "string" }, "sha256Checksum": { - "description": "The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it isn't populated for Docs Editors or shortcut files.", + "description": "The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it's not populated for Docs Editors or shortcut files.", "type": "string" }, "shared": { @@ -3460,12 +3465,12 @@ "type": "object" }, "size": { - "description": "The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it is not populated for shortcuts or folders.", + "description": "The size of the file's content in bytes. This field is populated for files with binary content stored in Google Drive and for Docs Editors files; it's not populated for shortcuts or folders.", "format": "int64", "type": "string" }, "spaces": { - "description": "The list of spaces which contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'.", + "description": "The list of spaces that contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'.", "items": { "type": "string" }, @@ -3489,7 +3494,7 @@ "type": "string" }, "trashed": { - "description": "Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file.", + "description": "Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner can trash a file. The trashed item is excluded from all files.list responses returned for any user who does not own the file. However, all users with access to the file can see the trashed item metadata in an API response. All users with access can copy, download, export, and share the file.", "type": "boolean" }, "trashedTime": { @@ -3507,7 +3512,7 @@ "type": "string" }, "videoMediaMetadata": { - "description": "Additional metadata about video media. This may not be available immediately upon upload.", + "description": "Additional metadata about video media. This might not be available immediately upon upload.", "properties": { "durationMillis": { "description": "The duration of the video in milliseconds.", @@ -3528,11 +3533,11 @@ "type": "object" }, "viewedByMe": { - "description": "Whether the file has been viewed by this user.", + "description": "Whether this user has viewed the file.", "type": "boolean" }, "viewedByMeTime": { - "description": "The last time the file was viewed by the user (RFC 3339 date-time).", + "description": "The last time the user viewed the file (RFC 3339 date-time).", "format": "date-time", "type": "string" }, diff --git a/drive/v3/drive-gen.go b/drive/v3/drive-gen.go index 6a35d99db6c..b5b87fe11a8 100644 --- a/drive/v3/drive-gen.go +++ b/drive/v3/drive-gen.go @@ -1218,17 +1218,17 @@ func (s *DriveList) MarshalJSON() ([]byte, error) { // File: The metadata for a file. type File struct { - // AppProperties: A collection of arbitrary key-value pairs which are + // AppProperties: A collection of arbitrary key-value pairs that are // private to the requesting app. // Entries with null values are cleared in update and copy requests. // These properties can only be retrieved using an authenticated // request. An authenticated request uses an access token obtained with - // a OAuth 2 client ID. You cannot use an API key to retrieve private + // an OAuth 2 client ID. You cannot use an API key to retrieve private // properties. AppProperties map[string]string `json:"appProperties,omitempty"` // Capabilities: Capabilities the current user has on this file. Each - // capability corresponds to a fine-grained action that a user may take. + // capability corresponds to a fine-grained action that a user can take. Capabilities *FileCapabilities `json:"capabilities,omitempty"` // ContentHints: Additional information about the content of the file. @@ -1274,11 +1274,11 @@ type File struct { FolderColorRgb string `json:"folderColorRgb,omitempty"` // FullFileExtension: The full file extension extracted from the name - // field. May contain multiple concatenated extensions, such as + // field. Can contain multiple concatenated extensions, such as // "tar.gz". This is only available for files with binary content in // Google Drive. - // This is automatically updated when the name field changes, however it - // isn't cleared if the new name does not contain a valid extension. + // This is automatically updated when the name field changes, however + // it's not cleared if the new name does not contain a valid extension. FullFileExtension string `json:"fullFileExtension,omitempty"` // HasAugmentedPermissions: Whether there are permissions directly on @@ -1290,8 +1290,8 @@ type File struct { // check access, look for the presence of the thumbnailLink field. HasThumbnail bool `json:"hasThumbnail,omitempty"` - // HeadRevisionId: The ID of the file's head revision. This is currently - // only available for files with binary content in Google Drive. + // HeadRevisionId: The ID of the file's head revision. This is only + // available for files with binary content in Google Drive. HeadRevisionId string `json:"headRevisionId,omitempty"` // IconLink: A static, unauthenticated link to the file's icon. @@ -1304,8 +1304,8 @@ type File struct { // available. ImageMediaMetadata *FileImageMediaMetadata `json:"imageMediaMetadata,omitempty"` - // IsAppAuthorized: Whether the file was created or opened by the - // requesting app. + // IsAppAuthorized: Whether the requesting app created or opened the + // file. IsAppAuthorized bool `json:"isAppAuthorized,omitempty"` // Kind: Identifies what kind of resource this is. Value: the fixed @@ -1335,21 +1335,21 @@ type File struct { // are published in the About resource. MimeType string `json:"mimeType,omitempty"` - // ModifiedByMe: Whether the file has been modified by this user. + // ModifiedByMe: Whether this user has modified the file. ModifiedByMe bool `json:"modifiedByMe,omitempty"` - // ModifiedByMeTime: The last time the file was modified by the user - // (RFC 3339 date-time). + // ModifiedByMeTime: The last time the user modified the file (RFC 3339 + // date-time). ModifiedByMeTime string `json:"modifiedByMeTime,omitempty"` - // ModifiedTime: The last time the file was modified by anyone (RFC 3339 + // ModifiedTime: The last time anyone modified the file (RFC 3339 // date-time). // Note that setting modifiedTime will also update modifiedByMeTime for // the user. ModifiedTime string `json:"modifiedTime,omitempty"` - // Name: The name of the file. This is not necessarily unique within a - // folder. Note that for immutable items such as the top level folders + // Name: The name of the file. This isn't necessarily unique within a + // folder. Note that for immutable items such as the top-level folders // of shared drives, My Drive root folder, and Application Data folder // the name is constant. Name string `json:"name,omitempty"` @@ -1363,12 +1363,12 @@ type File struct { // shared drives. OwnedByMe bool `json:"ownedByMe,omitempty"` - // Owners: The owner of this file. Only certain legacy files may have + // Owners: The owner of this file. Only certain legacy files might have // more than one owner. This field isn't populated for items in shared // drives. Owners []*User `json:"owners,omitempty"` - // Parents: The IDs of the parent folders which contain the file. + // Parents: The IDs of the parent folders that contain the file. // If not specified as part of a create request, the file will be placed // directly in the user's My Drive folder. If not specified as part of a // copy request, the file will inherit any discoverable parents of the @@ -1385,7 +1385,7 @@ type File struct { // for items in shared drives. Permissions []*Permission `json:"permissions,omitempty"` - // Properties: A collection of arbitrary key-value pairs which are + // Properties: A collection of arbitrary key-value pairs that are // visible to all apps. // Entries with null values are cleared in update and copy requests. Properties map[string]string `json:"properties,omitempty"` @@ -1400,13 +1400,13 @@ type File struct { // Sha1Checksum: The SHA1 checksum associated with this file, if // available. This field is only populated for files with content stored - // in Google Drive; it isn't populated for Docs Editors or shortcut + // in Google Drive; it's not populated for Docs Editors or shortcut // files. Sha1Checksum string `json:"sha1Checksum,omitempty"` // Sha256Checksum: The SHA256 checksum associated with this file, if // available. This field is only populated for files with content stored - // in Google Drive; it isn't populated for Docs Editors or shortcut + // in Google Drive; it's not populated for Docs Editors or shortcut // files. Sha256Checksum string `json:"sha256Checksum,omitempty"` @@ -1429,10 +1429,10 @@ type File struct { // Size: The size of the file's content in bytes. This field is // populated for files with binary content stored in Google Drive and - // for Docs Editors files; it is not populated for shortcuts or folders. + // for Docs Editors files; it's not populated for shortcuts or folders. Size int64 `json:"size,omitempty,string"` - // Spaces: The list of spaces which contain the file. The currently + // Spaces: The list of spaces that contain the file. The currently // supported values are 'drive', 'appDataFolder' and 'photos'. Spaces []string `json:"spaces,omitempty"` @@ -1454,7 +1454,7 @@ type File struct { ThumbnailVersion int64 `json:"thumbnailVersion,omitempty,string"` // Trashed: Whether the file has been trashed, either explicitly or from - // a trashed parent folder. Only the owner may trash a file. The trashed + // a trashed parent folder. Only the owner can trash a file. The trashed // item is excluded from all files.list responses returned for any user // who does not own the file. However, all users with access to the file // can see the trashed item metadata in an API response. All users with @@ -1474,15 +1474,15 @@ type File struct { // visible to the user. Version int64 `json:"version,omitempty,string"` - // VideoMediaMetadata: Additional metadata about video media. This may + // VideoMediaMetadata: Additional metadata about video media. This might // not be available immediately upon upload. VideoMediaMetadata *FileVideoMediaMetadata `json:"videoMediaMetadata,omitempty"` - // ViewedByMe: Whether the file has been viewed by this user. + // ViewedByMe: Whether this user has viewed the file. ViewedByMe bool `json:"viewedByMe,omitempty"` - // ViewedByMeTime: The last time the file was viewed by the user (RFC - // 3339 date-time). + // ViewedByMeTime: The last time the user viewed the file (RFC 3339 + // date-time). ViewedByMeTime string `json:"viewedByMeTime,omitempty"` // ViewersCanCopyContent: Deprecated - use copyRequiresWriterPermission @@ -1530,7 +1530,7 @@ func (s *File) MarshalJSON() ([]byte, error) { } // FileCapabilities: Capabilities the current user has on this file. -// Each capability corresponds to a fine-grained action that a user may +// Each capability corresponds to a fine-grained action that a user can // take. type FileCapabilities struct { // CanAcceptOwnership: Whether the current user is the pending owner of @@ -1538,12 +1538,12 @@ type FileCapabilities struct { CanAcceptOwnership bool `json:"canAcceptOwnership,omitempty"` // CanAddChildren: Whether the current user can add children to this - // folder. This is always false when the item is not a folder. + // folder. This is always false when the item isn't a folder. CanAddChildren bool `json:"canAddChildren,omitempty"` // CanAddFolderFromAnotherDrive: Whether the current user can add a // folder from another drive (different shared drive or My Drive) to - // this folder. This is false when the item is not a folder. Only + // this folder. This is false when the item isn't a folder. Only // populated for items in shared drives. CanAddFolderFromAnotherDrive bool `json:"canAddFolderFromAnotherDrive,omitempty"` @@ -1568,14 +1568,14 @@ type FileCapabilities struct { // CanCopy: Whether the current user can copy this file. For an item in // a shared drive, whether the current user can copy non-folder - // descendants of this item, or this item itself if it is not a folder. + // descendants of this item, or this item itself if it's not a folder. CanCopy bool `json:"canCopy,omitempty"` // CanDelete: Whether the current user can delete this file. CanDelete bool `json:"canDelete,omitempty"` // CanDeleteChildren: Whether the current user can delete children of - // this folder. This is false when the item is not a folder. Only + // this folder. This is false when the item isn't a folder. Only // populated for items in shared drives. CanDeleteChildren bool `json:"canDeleteChildren,omitempty"` @@ -1583,12 +1583,13 @@ type FileCapabilities struct { CanDownload bool `json:"canDownload,omitempty"` // CanEdit: Whether the current user can edit this file. Other factors - // may limit the type of changes a user can make to a file. For example, - // see canChangeCopyRequiresWriterPermission or canModifyContent. + // might limit the type of changes a user can make to a file. For + // example, see canChangeCopyRequiresWriterPermission or + // canModifyContent. CanEdit bool `json:"canEdit,omitempty"` // CanListChildren: Whether the current user can list the children of - // this folder. This is always false when the item is not a folder. + // this folder. This is always false when the item isn't a folder. CanListChildren bool `json:"canListChildren,omitempty"` // CanModifyContent: Whether the current user can modify the content of @@ -1605,7 +1606,7 @@ type FileCapabilities struct { // CanMoveChildrenOutOfDrive: 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. + // item isn't a folder. Only populated for items in shared drives. CanMoveChildrenOutOfDrive bool `json:"canMoveChildrenOutOfDrive,omitempty"` // CanMoveChildrenOutOfTeamDrive: Deprecated - use @@ -1613,10 +1614,10 @@ type FileCapabilities struct { CanMoveChildrenOutOfTeamDrive bool `json:"canMoveChildrenOutOfTeamDrive,omitempty"` // CanMoveChildrenWithinDrive: Whether the current user can move - // children of this folder within this drive. This is false when the - // item is not a folder. Note that a request to move the child may still - // fail depending on the current user's access to the child and to the - // destination folder. + // children of this folder within this shared drive or My Drive. This is + // false when the item isn't a folder. Note that a request to move the + // child might still fail depending on the current user's access to the + // child and to the destination folder. CanMoveChildrenWithinDrive bool `json:"canMoveChildrenWithinDrive,omitempty"` // CanMoveChildrenWithinTeamDrive: Deprecated - use @@ -1628,9 +1629,9 @@ type FileCapabilities struct { CanMoveItemIntoTeamDrive bool `json:"canMoveItemIntoTeamDrive,omitempty"` // CanMoveItemOutOfDrive: Whether the current user can move this item - // outside of this drive by changing its parent. Note that a request to - // change the parent of the item may still fail depending on the new - // parent that is being added. + // outside of this shared drive or My Drive by changing its parent. Note + // that a request to change the parent of the item might still fail + // depending on the new parent that's being added. CanMoveItemOutOfDrive bool `json:"canMoveItemOutOfDrive,omitempty"` // CanMoveItemOutOfTeamDrive: Deprecated - use canMoveItemOutOfDrive @@ -1638,9 +1639,9 @@ type FileCapabilities struct { CanMoveItemOutOfTeamDrive bool `json:"canMoveItemOutOfTeamDrive,omitempty"` // CanMoveItemWithinDrive: Whether the current user can move this item - // within this drive. Note that a request to change the parent of the - // item may still fail depending on the new parent that is being added - // and the parent that is being removed. + // within this shared drive or My Drive. Note that a request to change + // the parent of the item might still fail depending on the new parent + // that's being added and the parent that's being removed. CanMoveItemWithinDrive bool `json:"canMoveItemWithinDrive,omitempty"` // CanMoveItemWithinTeamDrive: Deprecated - use canMoveItemWithinDrive @@ -1661,7 +1662,7 @@ type FileCapabilities struct { // CanReadRevisions: Whether the current user can read the revisions // resource of this file. For a shared drive item, whether revisions of - // non-folder descendants of this item, or this item itself if it isn't + // non-folder descendants of this item, or this item itself if it's not // a folder, can be read. CanReadRevisions bool `json:"canReadRevisions,omitempty"` @@ -1669,8 +1670,8 @@ type FileCapabilities struct { CanReadTeamDrive bool `json:"canReadTeamDrive,omitempty"` // CanRemoveChildren: 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 + // this folder. This is always false when the item isn't a folder. For a + // folder in a shared drive, use canDeleteChildren or canTrashChildren // instead. CanRemoveChildren bool `json:"canRemoveChildren,omitempty"` @@ -1690,7 +1691,7 @@ type FileCapabilities struct { CanTrash bool `json:"canTrash,omitempty"` // CanTrashChildren: Whether the current user can trash children of this - // folder. This is false when the item is not a folder. Only populated + // folder. This is false when the item isn't a folder. Only populated // for items in shared drives. CanTrashChildren bool `json:"canTrashChildren,omitempty"` @@ -1726,7 +1727,7 @@ func (s *FileCapabilities) MarshalJSON() ([]byte, error) { // file. These fields are never populated in responses. type FileContentHints struct { // IndexableText: Text to be indexed for the file to improve fullText - // queries. This is limited to 128 KB in length and may contain HTML + // queries. This is limited to 128 KB in length and might contain HTML // elements. For more information, see Manage file metadata. IndexableText string `json:"indexableText,omitempty"` @@ -1840,7 +1841,7 @@ type FileImageMediaMetadata struct { // MeteringMode: The metering mode used to create the photo. MeteringMode string `json:"meteringMode,omitempty"` - // Rotation: The number of clockwise 90 degree rotations applied from + // Rotation: The number of clockwise 90-degree rotations applied from // the image's original orientation. Rotation int64 `json:"rotation,omitempty"` @@ -2061,7 +2062,7 @@ func (s *FileShortcutDetails) MarshalJSON() ([]byte, error) { } // FileVideoMediaMetadata: Additional metadata about video media. This -// may not be available immediately upon upload. +// might not be available immediately upon upload. type FileVideoMediaMetadata struct { // DurationMillis: The duration of the video in milliseconds. DurationMillis int64 `json:"durationMillis,omitempty,string"` @@ -7122,6 +7123,13 @@ func (r *FilesService) EmptyTrash() *FilesEmptyTrashCall { return c } +// DriveId sets the optional parameter "driveId": If set, empties the +// trash of the provided shared drive. +func (c *FilesEmptyTrashCall) DriveId(driveId string) *FilesEmptyTrashCall { + c.urlParams_.Set("driveId", driveId) + return c +} + // EnforceSingleParent sets the optional parameter // "enforceSingleParent": Deprecated. If an item is not in a shared // drive and its last parent is deleted but the item itself is not, the @@ -7193,6 +7201,11 @@ func (c *FilesEmptyTrashCall) Do(opts ...googleapi.CallOption) error { // "httpMethod": "DELETE", // "id": "drive.files.emptyTrash", // "parameters": { + // "driveId": { + // "description": "If set, empties the trash of the provided shared drive.", + // "location": "query", + // "type": "string" + // }, // "enforceSingleParent": { // "default": "false", // "description": "Deprecated. If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root.", @@ -8868,9 +8881,7 @@ type FilesWatchCall struct { header_ http.Header } -// Watch: Subscribes to changes to a file. While you can establish a -// channel for changes to a file on a shared drive, a change to a shared -// drive file won't create a notification. +// Watch: Subscribes to changes to a file. // // - fileId: The ID of the file. func (r *FilesService) Watch(fileId string, channel *Channel) *FilesWatchCall { @@ -9028,7 +9039,7 @@ func (c *FilesWatchCall) Do(opts ...googleapi.CallOption) (*Channel, error) { } return ret, nil // { - // "description": "Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification.", + // "description": "Subscribes to changes to a file.", // "httpMethod": "POST", // "id": "drive.files.watch", // "parameterOrder": [ diff --git a/firestore/v1/firestore-api.json b/firestore/v1/firestore-api.json index d8e22f610f4..1e264fdeb82 100644 --- a/firestore/v1/firestore-api.json +++ b/firestore/v1/firestore-api.json @@ -1423,7 +1423,7 @@ } } }, - "revision": "20230408", + "revision": "20230415", "rootUrl": "https://firestore.googleapis.com/", "schemas": { "Aggregation": { @@ -2027,7 +2027,7 @@ "type": "string" }, "createTime": { - "description": "Output only. The timestamp at which this database was created.", + "description": "Output only. The timestamp at which this database was created. Databases created before 2016 do not populate create_time.", "format": "google-datetime", "readOnly": true, "type": "string" diff --git a/firestore/v1/firestore-gen.go b/firestore/v1/firestore-gen.go index d48413b0e45..f49911881c1 100644 --- a/firestore/v1/firestore-gen.go +++ b/firestore/v1/firestore-gen.go @@ -1381,7 +1381,7 @@ type GoogleFirestoreAdminV1Database struct { ConcurrencyMode string `json:"concurrencyMode,omitempty"` // CreateTime: Output only. The timestamp at which this database was - // created. + // created. Databases created before 2016 do not populate create_time. CreateTime string `json:"createTime,omitempty"` // DeleteProtectionState: State of delete protection for the database. diff --git a/retail/v2/retail-api.json b/retail/v2/retail-api.json index 73736c73317..7adf839f9c0 100644 --- a/retail/v2/retail-api.json +++ b/retail/v2/retail-api.json @@ -138,7 +138,7 @@ "type": "string" }, "entity": { - "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, \"Google US\", \"Google Ads\", \"Waymo\", \"google.com\", \"youtube.com\", etc. If this is set, it should be exactly matched with UserEvent.entity to get per-entity autocomplete results.", + "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is set, it should be exactly matched with UserEvent.entity to get per-entity autocomplete results.", "location": "query", "type": "string" }, @@ -2031,7 +2031,7 @@ } } }, - "revision": "20230406", + "revision": "20230413", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -2814,7 +2814,7 @@ "description": "Metadata for active A/B testing Experiments.", "id": "GoogleCloudRetailV2ExperimentInfo", "properties": { - "experimentName": { + "experiment": { "description": "The fully qualified resource name of the experiment that provides the serving config under test, should an active experiment exist. For example: `projects/*/locations/global/catalogs/default_catalog/experiments/experiment_id`", "type": "string" }, @@ -4277,7 +4277,7 @@ "description": "Deprecated. Refer to https://cloud.google.com/retail/docs/configs#dynamic to enable dynamic facets. Do not set this field. The specification for dynamically generated facets. Notice that only textual facets can be dynamically generated." }, "entity": { - "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, \"Google US\", \"Google Ads\", \"Waymo\", \"google.com\", \"youtube.com\", etc. If this is set, it should be exactly matched with UserEvent.entity to get search results boosted by entity.", + "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is set, it should be exactly matched with UserEvent.entity to get search results boosted by entity.", "type": "string" }, "facetSpecs": { @@ -4308,7 +4308,7 @@ "type": "string" }, "pageCategories": { - "description": "The categories associated with a category page. Required for category navigation queries to achieve good search quality. The format should be the same as UserEvent.page_categories; To represent full path of category, use '\u003e' sign to separate different hierarchies. If '\u003e' is part of the category name, replace it with other character(s). Category pages include special pages such as sales or promotions. For instance, a special sale page may have the category hierarchy: \"pageCategories\" : [\"Sales \u003e 2017 Black Friday Deals\"].", + "description": "The categories associated with a category page. Must be set for category navigation queries to achieve good search quality. The format should be the same as UserEvent.page_categories; To represent full path of category, use '\u003e' sign to separate different hierarchies. If '\u003e' is part of the category name, replace it with other character(s). Category pages include special pages such as sales or promotions. For instance, a special sale page may have the category hierarchy: \"pageCategories\" : [\"Sales \u003e 2017 Black Friday Deals\"].", "items": { "type": "string" }, @@ -4469,7 +4469,7 @@ "type": "array" }, "intervals": { - "description": "For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90 and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles will become the bounds for its intervals and will be returned in the response. If the facet key intervals are specified in the request, then the specified intervals will be returned instead.", + "description": "Set only if values should be bucketized into intervals. Must be set for facets with numerical values. Must not be set for facet with text values. Maximum number of intervals is 40. For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90 and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles will become the bounds for its intervals and will be returned in the response. If the facet key intervals are specified in the request, then the specified intervals will be returned instead.", "items": { "$ref": "GoogleCloudRetailV2Interval" }, @@ -4988,7 +4988,7 @@ "description": "The main auto-completion details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search." }, "entity": { - "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, \"Google US\", \"Google Ads\", \"Waymo\", \"google.com\", \"youtube.com\", etc. It is recommended to set this field to get better per-entity search, completion and prediction results.", + "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. It is recommended to set this field to get better per-entity search, completion and prediction results.", "type": "string" }, "eventTime": { @@ -5397,7 +5397,7 @@ "type": "object" }, "GoogleCloudRetailV2alphaMerchantCenterAccountLink": { - "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch. LINT.IfChange(MerchantCenterAccountLink)", + "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch.", "id": "GoogleCloudRetailV2alphaMerchantCenterAccountLink", "properties": { "branchId": { @@ -5435,7 +5435,7 @@ "type": "string" }, "projectId": { - "description": "Output only. GCP project ID.", + "description": "Output only. Google Cloud project ID.", "readOnly": true, "type": "string" }, @@ -6133,7 +6133,7 @@ "type": "object" }, "GoogleCloudRetailV2betaMerchantCenterAccountLink": { - "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch. LINT.IfChange(MerchantCenterAccountLink)", + "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch.", "id": "GoogleCloudRetailV2betaMerchantCenterAccountLink", "properties": { "branchId": { @@ -6171,7 +6171,7 @@ "type": "string" }, "projectId": { - "description": "Output only. GCP project ID.", + "description": "Output only. Google Cloud project ID.", "readOnly": true, "type": "string" }, diff --git a/retail/v2/retail-gen.go b/retail/v2/retail-gen.go index 6fffdfdd02c..5543227b651 100644 --- a/retail/v2/retail-gen.go +++ b/retail/v2/retail-gen.go @@ -1780,18 +1780,18 @@ func (s *GoogleCloudRetailV2CustomAttribute) MarshalJSON() ([]byte, error) { // GoogleCloudRetailV2ExperimentInfo: Metadata for active A/B testing // Experiments. type GoogleCloudRetailV2ExperimentInfo struct { - // ExperimentName: The fully qualified resource name of the experiment - // that provides the serving config under test, should an active - // experiment exist. For example: + // Experiment: The fully qualified resource name of the experiment that + // provides the serving config under test, should an active experiment + // exist. For example: // `projects/*/locations/global/catalogs/default_catalog/experiments/expe // riment_id` - ExperimentName string `json:"experimentName,omitempty"` + Experiment string `json:"experiment,omitempty"` // ServingConfigExperiment: A/B test between existing Cloud Retail // Search ServingConfigs. ServingConfigExperiment *GoogleCloudRetailV2ExperimentInfoServingConfigExperiment `json:"servingConfigExperiment,omitempty"` - // ForceSendFields is a list of field names (e.g. "ExperimentName") to + // ForceSendFields is a list of field names (e.g. "Experiment") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -1799,13 +1799,12 @@ type GoogleCloudRetailV2ExperimentInfo struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ExperimentName") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the - // server as null. It is an 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. "Experiment") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } @@ -4684,8 +4683,8 @@ type GoogleCloudRetailV2SearchRequest struct { DynamicFacetSpec *GoogleCloudRetailV2SearchRequestDynamicFacetSpec `json:"dynamicFacetSpec,omitempty"` // Entity: The entity for customers that may run multiple different - // entities, domains, sites or regions, for example, "Google US", - // "Google Ads", "Waymo", "google.com", "youtube.com", etc. If this is + // entities, domains, sites or regions, for example, `Google US`, + // `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is // set, it should be exactly matched with UserEvent.entity to get search // results boosted by entity. Entity string `json:"entity,omitempty"` @@ -4733,8 +4732,8 @@ type GoogleCloudRetailV2SearchRequest struct { // this field is unrecognizable, an INVALID_ARGUMENT is returned. OrderBy string `json:"orderBy,omitempty"` - // PageCategories: The categories associated with a category page. - // Required for category navigation queries to achieve good search + // PageCategories: The categories associated with a category page. Must + // be set for category navigation queries to achieve good search // quality. The format should be the same as UserEvent.page_categories; // To represent full path of category, use '>' sign to separate // different hierarchies. If '>' is part of the category name, replace @@ -5100,14 +5099,17 @@ type GoogleCloudRetailV2SearchRequestFacetSpecFacetKey struct { // Only supported on textual fields. Maximum is 10. Contains []string `json:"contains,omitempty"` - // Intervals: For all numerical facet keys that appear in the list of - // products from the catalog, the percentiles 0, 10, 30, 50, 70, 90 and - // 100 are computed from their distribution weekly. If the model assigns - // a high score to a numerical facet key and its intervals are not - // specified in the search request, these percentiles will become the - // bounds for its intervals and will be returned in the response. If the - // facet key intervals are specified in the request, then the specified - // intervals will be returned instead. + // Intervals: Set only if values should be bucketized into intervals. + // Must be set for facets with numerical values. Must not be set for + // facet with text values. Maximum number of intervals is 40. For all + // numerical facet keys that appear in the list of products from the + // catalog, the percentiles 0, 10, 30, 50, 70, 90 and 100 are computed + // from their distribution weekly. If the model assigns a high score to + // a numerical facet key and its intervals are not specified in the + // search request, these percentiles will become the bounds for its + // intervals and will be returned in the response. If the facet key + // intervals are specified in the request, then the specified intervals + // will be returned instead. Intervals []*GoogleCloudRetailV2Interval `json:"intervals,omitempty"` // Key: Required. Supported textual and numerical facet keys in Product @@ -6012,8 +6014,8 @@ type GoogleCloudRetailV2UserEvent struct { CompletionDetail *GoogleCloudRetailV2CompletionDetail `json:"completionDetail,omitempty"` // Entity: The entity for customers that may run multiple different - // entities, domains, sites or regions, for example, "Google US", - // "Google Ads", "Waymo", "google.com", "youtube.com", etc. It is + // entities, domains, sites or regions, for example, `Google US`, + // `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. It is // recommended to set this field to get better per-entity search, // completion and prediction results. Entity string `json:"entity,omitempty"` @@ -6836,7 +6838,6 @@ func (s *GoogleCloudRetailV2alphaImportUserEventsResponse) MarshalJSON() ([]byte // between a Merchant Center account and a branch. Once a link is // established, products from the linked merchant center account will be // streamed to the linked branch. -// LINT.IfChange(MerchantCenterAccountLink) type GoogleCloudRetailV2alphaMerchantCenterAccountLink struct { // BranchId: Required. The branch id (e.g. 0/1/2) within the catalog // that products from merchant_center_account_id are streamed to. When @@ -6884,7 +6885,7 @@ type GoogleCloudRetailV2alphaMerchantCenterAccountLink struct { // countLinks/merchant_center_account_link`. Name string `json:"name,omitempty"` - // ProjectId: Output only. GCP project ID. + // ProjectId: Output only. Google Cloud project ID. ProjectId string `json:"projectId,omitempty"` // State: Output only. Represents the state of the link. @@ -8163,7 +8164,6 @@ func (s *GoogleCloudRetailV2betaImportUserEventsResponse) MarshalJSON() ([]byte, // between a Merchant Center account and a branch. Once a link is // established, products from the linked merchant center account will be // streamed to the linked branch. -// LINT.IfChange(MerchantCenterAccountLink) type GoogleCloudRetailV2betaMerchantCenterAccountLink struct { // BranchId: Required. The branch id (e.g. 0/1/2) within the catalog // that products from merchant_center_account_id are streamed to. When @@ -8211,7 +8211,7 @@ type GoogleCloudRetailV2betaMerchantCenterAccountLink struct { // countLinks/merchant_center_account_link`. Name string `json:"name,omitempty"` - // ProjectId: Output only. GCP project ID. + // ProjectId: Output only. Google Cloud project ID. ProjectId string `json:"projectId,omitempty"` // State: Output only. Represents the state of the link. @@ -8951,8 +8951,8 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) DeviceType(deviceType strin // Entity sets the optional parameter "entity": The entity for customers // that may run multiple different entities, domains, sites or regions, -// for example, "Google US", "Google Ads", "Waymo", "google.com", -// "youtube.com", etc. If this is set, it should be exactly matched with +// for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, +// `youtube.com`, etc. If this is set, it should be exactly matched with // UserEvent.entity to get per-entity autocomplete results. func (c *ProjectsLocationsCatalogsCompleteQueryCall) Entity(entity string) *ProjectsLocationsCatalogsCompleteQueryCall { c.urlParams_.Set("entity", entity) @@ -9131,7 +9131,7 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) Do(opts ...googleapi.CallOp // "type": "string" // }, // "entity": { - // "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, \"Google US\", \"Google Ads\", \"Waymo\", \"google.com\", \"youtube.com\", etc. If this is set, it should be exactly matched with UserEvent.entity to get per-entity autocomplete results.", + // "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is set, it should be exactly matched with UserEvent.entity to get per-entity autocomplete results.", // "location": "query", // "type": "string" // }, diff --git a/retail/v2alpha/retail-api.json b/retail/v2alpha/retail-api.json index 86353143c0c..f9898637e87 100644 --- a/retail/v2alpha/retail-api.json +++ b/retail/v2alpha/retail-api.json @@ -143,7 +143,7 @@ "type": "boolean" }, "entity": { - "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, \"Google US\", \"Google Ads\", \"Waymo\", \"google.com\", \"youtube.com\", etc. If this is set, it should be exactly matched with UserEvent.entity to get per-entity autocomplete results.", + "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is set, it should be exactly matched with UserEvent.entity to get per-entity autocomplete results.", "location": "query", "type": "string" }, @@ -701,7 +701,7 @@ "name" ], "parameters": { - "cascadeDelete": { + "force": { "description": "This value only applies to the case when the target product is of type PRIMARY. When deleting a product of VARIANT/COLLECTION type, this value will be ignored. When set to true, the subsequent variant products will be deleted. When set to false, if the primary product has active variant products, an error will be returned.", "location": "query", "type": "boolean" @@ -2222,7 +2222,7 @@ } } }, - "revision": "20230406", + "revision": "20230413", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -3213,7 +3213,7 @@ "type": "object" }, "facets": { - "description": "Facet information for the suggestion term. Gives the number of items resulting from a search with this suggestion term for each facet. This is an experimental feature for limited customers. Please reach out to the support team if you would like to receive this information.", + "description": "Facet information for the suggestion term. Gives the number of items resulting from a search with this suggestion term for each facet. This is an experimental feature for limited customers. If you want to receive this facet information, reach out to the Retail support team.", "items": { "$ref": "GoogleCloudRetailV2alphaSearchResponseFacet" }, @@ -3224,7 +3224,7 @@ "type": "string" }, "totalProductCount": { - "description": "Total number of products associated with a search with this suggestion. This is an experimental feature for limited customers. Please reach out to the support team if you would like to receive this information.", + "description": "Total number of products associated with a search with this suggestion. This is an experimental feature for limited customers. If you want to receive this product count information, reach out to the Retail support team.", "format": "int32", "type": "integer" } @@ -3512,7 +3512,7 @@ "description": "Metadata for active A/B testing Experiments.", "id": "GoogleCloudRetailV2alphaExperimentInfo", "properties": { - "experimentName": { + "experiment": { "description": "The fully qualified resource name of the experiment that provides the serving config under test, should an active experiment exist. For example: `projects/*/locations/global/catalogs/default_catalog/experiments/experiment_id`", "type": "string" }, @@ -4044,7 +4044,7 @@ "type": "object" }, "GoogleCloudRetailV2alphaMerchantCenterAccountLink": { - "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch. LINT.IfChange(MerchantCenterAccountLink)", + "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch.", "id": "GoogleCloudRetailV2alphaMerchantCenterAccountLink", "properties": { "branchId": { @@ -4082,7 +4082,7 @@ "type": "string" }, "projectId": { - "description": "Output only. GCP project ID.", + "description": "Output only. Google Cloud project ID.", "readOnly": true, "type": "string" }, @@ -5387,7 +5387,7 @@ "description": "Deprecated. Refer to https://cloud.google.com/retail/docs/configs#dynamic to enable dynamic facets. Do not set this field. The specification for dynamically generated facets. Notice that only textual facets can be dynamically generated." }, "entity": { - "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, \"Google US\", \"Google Ads\", \"Waymo\", \"google.com\", \"youtube.com\", etc. If this is set, it should be exactly matched with UserEvent.entity to get search results boosted by entity.", + "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is set, it should be exactly matched with UserEvent.entity to get search results boosted by entity.", "type": "string" }, "facetSpecs": { @@ -5418,7 +5418,7 @@ "type": "string" }, "pageCategories": { - "description": "The categories associated with a category page. Required for category navigation queries to achieve good search quality. The format should be the same as UserEvent.page_categories; To represent full path of category, use '\u003e' sign to separate different hierarchies. If '\u003e' is part of the category name, replace it with other character(s). Category pages include special pages such as sales or promotions. For instance, a special sale page may have the category hierarchy: \"pageCategories\" : [\"Sales \u003e 2017 Black Friday Deals\"].", + "description": "The categories associated with a category page. Must be set for category navigation queries to achieve good search quality. The format should be the same as UserEvent.page_categories; To represent full path of category, use '\u003e' sign to separate different hierarchies. If '\u003e' is part of the category name, replace it with other character(s). Category pages include special pages such as sales or promotions. For instance, a special sale page may have the category hierarchy: \"pageCategories\" : [\"Sales \u003e 2017 Black Friday Deals\"].", "items": { "type": "string" }, @@ -5597,7 +5597,7 @@ "type": "array" }, "intervals": { - "description": "For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90 and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles will become the bounds for its intervals and will be returned in the response. If the facet key intervals are specified in the request, then the specified intervals will be returned instead.", + "description": "Set only if values should be bucketized into intervals. Must be set for facets with numerical values. Must not be set for facet with text values. Maximum number of intervals is 40. For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90 and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles will become the bounds for its intervals and will be returned in the response. If the facet key intervals are specified in the request, then the specified intervals will be returned instead.", "items": { "$ref": "GoogleCloudRetailV2alphaInterval" }, @@ -6133,7 +6133,7 @@ "description": "The main auto-completion details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search." }, "entity": { - "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, \"Google US\", \"Google Ads\", \"Waymo\", \"google.com\", \"youtube.com\", etc. It is recommended to set this field to get better per-entity search, completion and prediction results.", + "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. It is recommended to set this field to get better per-entity search, completion and prediction results.", "type": "string" }, "eventTime": { @@ -6538,7 +6538,7 @@ "type": "object" }, "GoogleCloudRetailV2betaMerchantCenterAccountLink": { - "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch. LINT.IfChange(MerchantCenterAccountLink)", + "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch.", "id": "GoogleCloudRetailV2betaMerchantCenterAccountLink", "properties": { "branchId": { @@ -6576,7 +6576,7 @@ "type": "string" }, "projectId": { - "description": "Output only. GCP project ID.", + "description": "Output only. Google Cloud project ID.", "readOnly": true, "type": "string" }, diff --git a/retail/v2alpha/retail-gen.go b/retail/v2alpha/retail-gen.go index ec9d8855caa..fa5c5c41acd 100644 --- a/retail/v2alpha/retail-gen.go +++ b/retail/v2alpha/retail-gen.go @@ -2119,9 +2119,9 @@ type GoogleCloudRetailV2alphaCompleteQueryResponseCompletionResult struct { // Facets: Facet information for the suggestion term. Gives the number // of items resulting from a search with this suggestion term for each - // facet. This is an experimental feature for limited customers. Please - // reach out to the support team if you would like to receive this - // information. + // facet. This is an experimental feature for limited customers. If you + // want to receive this facet information, reach out to the Retail + // support team. Facets []*GoogleCloudRetailV2alphaSearchResponseFacet `json:"facets,omitempty"` // Suggestion: The suggestion for the query. @@ -2129,8 +2129,8 @@ type GoogleCloudRetailV2alphaCompleteQueryResponseCompletionResult struct { // TotalProductCount: Total number of products associated with a search // with this suggestion. This is an experimental feature for limited - // customers. Please reach out to the support team if you would like to - // receive this information. + // customers. If you want to receive this product count information, + // reach out to the Retail support team. TotalProductCount int64 `json:"totalProductCount,omitempty"` // ForceSendFields is a list of field names (e.g. "Attributes") to @@ -2674,18 +2674,18 @@ func (s *GoogleCloudRetailV2alphaCustomAttribute) MarshalJSON() ([]byte, error) // GoogleCloudRetailV2alphaExperimentInfo: Metadata for active A/B // testing Experiments. type GoogleCloudRetailV2alphaExperimentInfo struct { - // ExperimentName: The fully qualified resource name of the experiment - // that provides the serving config under test, should an active - // experiment exist. For example: + // Experiment: The fully qualified resource name of the experiment that + // provides the serving config under test, should an active experiment + // exist. For example: // `projects/*/locations/global/catalogs/default_catalog/experiments/expe // riment_id` - ExperimentName string `json:"experimentName,omitempty"` + Experiment string `json:"experiment,omitempty"` // ServingConfigExperiment: A/B test between existing Cloud Retail // Search ServingConfigs. ServingConfigExperiment *GoogleCloudRetailV2alphaExperimentInfoServingConfigExperiment `json:"servingConfigExperiment,omitempty"` - // ForceSendFields is a list of field names (e.g. "ExperimentName") to + // ForceSendFields is a list of field names (e.g. "Experiment") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -2693,13 +2693,12 @@ type GoogleCloudRetailV2alphaExperimentInfo struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ExperimentName") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the - // server as null. It is an 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. "Experiment") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } @@ -3789,7 +3788,6 @@ func (s *GoogleCloudRetailV2alphaLocalInventory) MarshalJSON() ([]byte, error) { // between a Merchant Center account and a branch. Once a link is // established, products from the linked merchant center account will be // streamed to the linked branch. -// LINT.IfChange(MerchantCenterAccountLink) type GoogleCloudRetailV2alphaMerchantCenterAccountLink struct { // BranchId: Required. The branch id (e.g. 0/1/2) within the catalog // that products from merchant_center_account_id are streamed to. When @@ -3837,7 +3835,7 @@ type GoogleCloudRetailV2alphaMerchantCenterAccountLink struct { // countLinks/merchant_center_account_link`. Name string `json:"name,omitempty"` - // ProjectId: Output only. GCP project ID. + // ProjectId: Output only. Google Cloud project ID. ProjectId string `json:"projectId,omitempty"` // State: Output only. Represents the state of the link. @@ -6406,8 +6404,8 @@ type GoogleCloudRetailV2alphaSearchRequest struct { DynamicFacetSpec *GoogleCloudRetailV2alphaSearchRequestDynamicFacetSpec `json:"dynamicFacetSpec,omitempty"` // Entity: The entity for customers that may run multiple different - // entities, domains, sites or regions, for example, "Google US", - // "Google Ads", "Waymo", "google.com", "youtube.com", etc. If this is + // entities, domains, sites or regions, for example, `Google US`, + // `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is // set, it should be exactly matched with UserEvent.entity to get search // results boosted by entity. Entity string `json:"entity,omitempty"` @@ -6455,8 +6453,8 @@ type GoogleCloudRetailV2alphaSearchRequest struct { // this field is unrecognizable, an INVALID_ARGUMENT is returned. OrderBy string `json:"orderBy,omitempty"` - // PageCategories: The categories associated with a category page. - // Required for category navigation queries to achieve good search + // PageCategories: The categories associated with a category page. Must + // be set for category navigation queries to achieve good search // quality. The format should be the same as UserEvent.page_categories; // To represent full path of category, use '>' sign to separate // different hierarchies. If '>' is part of the category name, replace @@ -6837,14 +6835,17 @@ type GoogleCloudRetailV2alphaSearchRequestFacetSpecFacetKey struct { // Only supported on textual fields. Maximum is 10. Contains []string `json:"contains,omitempty"` - // Intervals: For all numerical facet keys that appear in the list of - // products from the catalog, the percentiles 0, 10, 30, 50, 70, 90 and - // 100 are computed from their distribution weekly. If the model assigns - // a high score to a numerical facet key and its intervals are not - // specified in the search request, these percentiles will become the - // bounds for its intervals and will be returned in the response. If the - // facet key intervals are specified in the request, then the specified - // intervals will be returned instead. + // Intervals: Set only if values should be bucketized into intervals. + // Must be set for facets with numerical values. Must not be set for + // facet with text values. Maximum number of intervals is 40. For all + // numerical facet keys that appear in the list of products from the + // catalog, the percentiles 0, 10, 30, 50, 70, 90 and 100 are computed + // from their distribution weekly. If the model assigns a high score to + // a numerical facet key and its intervals are not specified in the + // search request, these percentiles will become the bounds for its + // intervals and will be returned in the response. If the facet key + // intervals are specified in the request, then the specified intervals + // will be returned instead. Intervals []*GoogleCloudRetailV2alphaInterval `json:"intervals,omitempty"` // Key: Required. Supported textual and numerical facet keys in Product @@ -7786,8 +7787,8 @@ type GoogleCloudRetailV2alphaUserEvent struct { CompletionDetail *GoogleCloudRetailV2alphaCompletionDetail `json:"completionDetail,omitempty"` // Entity: The entity for customers that may run multiple different - // entities, domains, sites or regions, for example, "Google US", - // "Google Ads", "Waymo", "google.com", "youtube.com", etc. It is + // entities, domains, sites or regions, for example, `Google US`, + // `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. It is // recommended to set this field to get better per-entity search, // completion and prediction results. Entity string `json:"entity,omitempty"` @@ -8606,7 +8607,6 @@ func (s *GoogleCloudRetailV2betaImportUserEventsResponse) MarshalJSON() ([]byte, // between a Merchant Center account and a branch. Once a link is // established, products from the linked merchant center account will be // streamed to the linked branch. -// LINT.IfChange(MerchantCenterAccountLink) type GoogleCloudRetailV2betaMerchantCenterAccountLink struct { // BranchId: Required. The branch id (e.g. 0/1/2) within the catalog // that products from merchant_center_account_id are streamed to. When @@ -8654,7 +8654,7 @@ type GoogleCloudRetailV2betaMerchantCenterAccountLink struct { // countLinks/merchant_center_account_link`. Name string `json:"name,omitempty"` - // ProjectId: Output only. GCP project ID. + // ProjectId: Output only. Google Cloud project ID. ProjectId string `json:"projectId,omitempty"` // State: Output only. Represents the state of the link. @@ -9403,8 +9403,8 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) EnableAttributeSuggestions( // Entity sets the optional parameter "entity": The entity for customers // that may run multiple different entities, domains, sites or regions, -// for example, "Google US", "Google Ads", "Waymo", "google.com", -// "youtube.com", etc. If this is set, it should be exactly matched with +// for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, +// `youtube.com`, etc. If this is set, it should be exactly matched with // UserEvent.entity to get per-entity autocomplete results. func (c *ProjectsLocationsCatalogsCompleteQueryCall) Entity(entity string) *ProjectsLocationsCatalogsCompleteQueryCall { c.urlParams_.Set("entity", entity) @@ -9588,7 +9588,7 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) Do(opts ...googleapi.CallOp // "type": "boolean" // }, // "entity": { - // "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, \"Google US\", \"Google Ads\", \"Waymo\", \"google.com\", \"youtube.com\", etc. If this is set, it should be exactly matched with UserEvent.entity to get per-entity autocomplete results.", + // "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is set, it should be exactly matched with UserEvent.entity to get per-entity autocomplete results.", // "location": "query", // "type": "string" // }, @@ -12329,14 +12329,14 @@ func (r *ProjectsLocationsCatalogsBranchesProductsService) Delete(name string) * return c } -// CascadeDelete sets the optional parameter "cascadeDelete": This value -// only applies to the case when the target product is of type PRIMARY. -// When deleting a product of VARIANT/COLLECTION type, this value will -// be ignored. When set to true, the subsequent variant products will be -// deleted. When set to false, if the primary product has active variant -// products, an error will be returned. -func (c *ProjectsLocationsCatalogsBranchesProductsDeleteCall) CascadeDelete(cascadeDelete bool) *ProjectsLocationsCatalogsBranchesProductsDeleteCall { - c.urlParams_.Set("cascadeDelete", fmt.Sprint(cascadeDelete)) +// Force sets the optional parameter "force": This value only applies to +// the case when the target product is of type PRIMARY. When deleting a +// product of VARIANT/COLLECTION type, this value will be ignored. When +// set to true, the subsequent variant products will be deleted. When +// set to false, if the primary product has active variant products, an +// error will be returned. +func (c *ProjectsLocationsCatalogsBranchesProductsDeleteCall) Force(force bool) *ProjectsLocationsCatalogsBranchesProductsDeleteCall { + c.urlParams_.Set("force", fmt.Sprint(force)) return c } @@ -12434,7 +12434,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsDeleteCall) Do(opts ...googlea // "name" // ], // "parameters": { - // "cascadeDelete": { + // "force": { // "description": "This value only applies to the case when the target product is of type PRIMARY. When deleting a product of VARIANT/COLLECTION type, this value will be ignored. When set to true, the subsequent variant products will be deleted. When set to false, if the primary product has active variant products, an error will be returned.", // "location": "query", // "type": "boolean" diff --git a/retail/v2beta/retail-api.json b/retail/v2beta/retail-api.json index a5f1a334b9a..95b20c7a862 100644 --- a/retail/v2beta/retail-api.json +++ b/retail/v2beta/retail-api.json @@ -138,7 +138,7 @@ "type": "string" }, "entity": { - "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, \"Google US\", \"Google Ads\", \"Waymo\", \"google.com\", \"youtube.com\", etc. If this is set, it should be exactly matched with UserEvent.entity to get per-entity autocomplete results.", + "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is set, it should be exactly matched with UserEvent.entity to get per-entity autocomplete results.", "location": "query", "type": "string" }, @@ -2059,7 +2059,7 @@ } } }, - "revision": "20230406", + "revision": "20230413", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -2852,7 +2852,7 @@ "type": "object" }, "GoogleCloudRetailV2alphaMerchantCenterAccountLink": { - "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch. LINT.IfChange(MerchantCenterAccountLink)", + "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch.", "id": "GoogleCloudRetailV2alphaMerchantCenterAccountLink", "properties": { "branchId": { @@ -2890,7 +2890,7 @@ "type": "string" }, "projectId": { - "description": "Output only. GCP project ID.", + "description": "Output only. Google Cloud project ID.", "readOnly": true, "type": "string" }, @@ -4056,7 +4056,7 @@ "description": "Metadata for active A/B testing Experiments.", "id": "GoogleCloudRetailV2betaExperimentInfo", "properties": { - "experimentName": { + "experiment": { "description": "The fully qualified resource name of the experiment that provides the serving config under test, should an active experiment exist. For example: `projects/*/locations/global/catalogs/default_catalog/experiments/experiment_id`", "type": "string" }, @@ -4561,7 +4561,7 @@ "type": "object" }, "GoogleCloudRetailV2betaMerchantCenterAccountLink": { - "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch. LINT.IfChange(MerchantCenterAccountLink)", + "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch.", "id": "GoogleCloudRetailV2betaMerchantCenterAccountLink", "properties": { "branchId": { @@ -4599,7 +4599,7 @@ "type": "string" }, "projectId": { - "description": "Output only. GCP project ID.", + "description": "Output only. Google Cloud project ID.", "readOnly": true, "type": "string" }, @@ -5770,7 +5770,7 @@ "description": "Deprecated. Refer to https://cloud.google.com/retail/docs/configs#dynamic to enable dynamic facets. Do not set this field. The specification for dynamically generated facets. Notice that only textual facets can be dynamically generated." }, "entity": { - "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, \"Google US\", \"Google Ads\", \"Waymo\", \"google.com\", \"youtube.com\", etc. If this is set, it should be exactly matched with UserEvent.entity to get search results boosted by entity.", + "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is set, it should be exactly matched with UserEvent.entity to get search results boosted by entity.", "type": "string" }, "facetSpecs": { @@ -5801,7 +5801,7 @@ "type": "string" }, "pageCategories": { - "description": "The categories associated with a category page. Required for category navigation queries to achieve good search quality. The format should be the same as UserEvent.page_categories; To represent full path of category, use '\u003e' sign to separate different hierarchies. If '\u003e' is part of the category name, replace it with other character(s). Category pages include special pages such as sales or promotions. For instance, a special sale page may have the category hierarchy: \"pageCategories\" : [\"Sales \u003e 2017 Black Friday Deals\"].", + "description": "The categories associated with a category page. Must be set for category navigation queries to achieve good search quality. The format should be the same as UserEvent.page_categories; To represent full path of category, use '\u003e' sign to separate different hierarchies. If '\u003e' is part of the category name, replace it with other character(s). Category pages include special pages such as sales or promotions. For instance, a special sale page may have the category hierarchy: \"pageCategories\" : [\"Sales \u003e 2017 Black Friday Deals\"].", "items": { "type": "string" }, @@ -5962,7 +5962,7 @@ "type": "array" }, "intervals": { - "description": "For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90 and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles will become the bounds for its intervals and will be returned in the response. If the facet key intervals are specified in the request, then the specified intervals will be returned instead.", + "description": "Set only if values should be bucketized into intervals. Must be set for facets with numerical values. Must not be set for facet with text values. Maximum number of intervals is 40. For all numerical facet keys that appear in the list of products from the catalog, the percentiles 0, 10, 30, 50, 70, 90 and 100 are computed from their distribution weekly. If the model assigns a high score to a numerical facet key and its intervals are not specified in the search request, these percentiles will become the bounds for its intervals and will be returned in the response. If the facet key intervals are specified in the request, then the specified intervals will be returned instead.", "items": { "$ref": "GoogleCloudRetailV2betaInterval" }, @@ -6481,7 +6481,7 @@ "description": "The main auto-completion details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search." }, "entity": { - "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, \"Google US\", \"Google Ads\", \"Waymo\", \"google.com\", \"youtube.com\", etc. It is recommended to set this field to get better per-entity search, completion and prediction results.", + "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. It is recommended to set this field to get better per-entity search, completion and prediction results.", "type": "string" }, "eventTime": { diff --git a/retail/v2beta/retail-gen.go b/retail/v2beta/retail-gen.go index a83596ad52c..97adb6f51e3 100644 --- a/retail/v2beta/retail-gen.go +++ b/retail/v2beta/retail-gen.go @@ -1757,7 +1757,6 @@ func (s *GoogleCloudRetailV2alphaImportUserEventsResponse) MarshalJSON() ([]byte // between a Merchant Center account and a branch. Once a link is // established, products from the linked merchant center account will be // streamed to the linked branch. -// LINT.IfChange(MerchantCenterAccountLink) type GoogleCloudRetailV2alphaMerchantCenterAccountLink struct { // BranchId: Required. The branch id (e.g. 0/1/2) within the catalog // that products from merchant_center_account_id are streamed to. When @@ -1805,7 +1804,7 @@ type GoogleCloudRetailV2alphaMerchantCenterAccountLink struct { // countLinks/merchant_center_account_link`. Name string `json:"name,omitempty"` - // ProjectId: Output only. GCP project ID. + // ProjectId: Output only. Google Cloud project ID. ProjectId string `json:"projectId,omitempty"` // State: Output only. Represents the state of the link. @@ -3921,18 +3920,18 @@ func (s *GoogleCloudRetailV2betaCustomAttribute) MarshalJSON() ([]byte, error) { // GoogleCloudRetailV2betaExperimentInfo: Metadata for active A/B // testing Experiments. type GoogleCloudRetailV2betaExperimentInfo struct { - // ExperimentName: The fully qualified resource name of the experiment - // that provides the serving config under test, should an active - // experiment exist. For example: + // Experiment: The fully qualified resource name of the experiment that + // provides the serving config under test, should an active experiment + // exist. For example: // `projects/*/locations/global/catalogs/default_catalog/experiments/expe // riment_id` - ExperimentName string `json:"experimentName,omitempty"` + Experiment string `json:"experiment,omitempty"` // ServingConfigExperiment: A/B test between existing Cloud Retail // Search ServingConfigs. ServingConfigExperiment *GoogleCloudRetailV2betaExperimentInfoServingConfigExperiment `json:"servingConfigExperiment,omitempty"` - // ForceSendFields is a list of field names (e.g. "ExperimentName") to + // ForceSendFields is a list of field names (e.g. "Experiment") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -3940,13 +3939,12 @@ type GoogleCloudRetailV2betaExperimentInfo struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ExperimentName") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the - // server as null. It is an 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. "Experiment") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } @@ -4981,7 +4979,6 @@ func (s *GoogleCloudRetailV2betaLocalInventory) MarshalJSON() ([]byte, error) { // between a Merchant Center account and a branch. Once a link is // established, products from the linked merchant center account will be // streamed to the linked branch. -// LINT.IfChange(MerchantCenterAccountLink) type GoogleCloudRetailV2betaMerchantCenterAccountLink struct { // BranchId: Required. The branch id (e.g. 0/1/2) within the catalog // that products from merchant_center_account_id are streamed to. When @@ -5029,7 +5026,7 @@ type GoogleCloudRetailV2betaMerchantCenterAccountLink struct { // countLinks/merchant_center_account_link`. Name string `json:"name,omitempty"` - // ProjectId: Output only. GCP project ID. + // ProjectId: Output only. Google Cloud project ID. ProjectId string `json:"projectId,omitempty"` // State: Output only. Represents the state of the link. @@ -7287,8 +7284,8 @@ type GoogleCloudRetailV2betaSearchRequest struct { DynamicFacetSpec *GoogleCloudRetailV2betaSearchRequestDynamicFacetSpec `json:"dynamicFacetSpec,omitempty"` // Entity: The entity for customers that may run multiple different - // entities, domains, sites or regions, for example, "Google US", - // "Google Ads", "Waymo", "google.com", "youtube.com", etc. If this is + // entities, domains, sites or regions, for example, `Google US`, + // `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is // set, it should be exactly matched with UserEvent.entity to get search // results boosted by entity. Entity string `json:"entity,omitempty"` @@ -7336,8 +7333,8 @@ type GoogleCloudRetailV2betaSearchRequest struct { // this field is unrecognizable, an INVALID_ARGUMENT is returned. OrderBy string `json:"orderBy,omitempty"` - // PageCategories: The categories associated with a category page. - // Required for category navigation queries to achieve good search + // PageCategories: The categories associated with a category page. Must + // be set for category navigation queries to achieve good search // quality. The format should be the same as UserEvent.page_categories; // To represent full path of category, use '>' sign to separate // different hierarchies. If '>' is part of the category name, replace @@ -7703,14 +7700,17 @@ type GoogleCloudRetailV2betaSearchRequestFacetSpecFacetKey struct { // Only supported on textual fields. Maximum is 10. Contains []string `json:"contains,omitempty"` - // Intervals: For all numerical facet keys that appear in the list of - // products from the catalog, the percentiles 0, 10, 30, 50, 70, 90 and - // 100 are computed from their distribution weekly. If the model assigns - // a high score to a numerical facet key and its intervals are not - // specified in the search request, these percentiles will become the - // bounds for its intervals and will be returned in the response. If the - // facet key intervals are specified in the request, then the specified - // intervals will be returned instead. + // Intervals: Set only if values should be bucketized into intervals. + // Must be set for facets with numerical values. Must not be set for + // facet with text values. Maximum number of intervals is 40. For all + // numerical facet keys that appear in the list of products from the + // catalog, the percentiles 0, 10, 30, 50, 70, 90 and 100 are computed + // from their distribution weekly. If the model assigns a high score to + // a numerical facet key and its intervals are not specified in the + // search request, these percentiles will become the bounds for its + // intervals and will be returned in the response. If the facet key + // intervals are specified in the request, then the specified intervals + // will be returned instead. Intervals []*GoogleCloudRetailV2betaInterval `json:"intervals,omitempty"` // Key: Required. Supported textual and numerical facet keys in Product @@ -8615,8 +8615,8 @@ type GoogleCloudRetailV2betaUserEvent struct { CompletionDetail *GoogleCloudRetailV2betaCompletionDetail `json:"completionDetail,omitempty"` // Entity: The entity for customers that may run multiple different - // entities, domains, sites or regions, for example, "Google US", - // "Google Ads", "Waymo", "google.com", "youtube.com", etc. It is + // entities, domains, sites or regions, for example, `Google US`, + // `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. It is // recommended to set this field to get better per-entity search, // completion and prediction results. Entity string `json:"entity,omitempty"` @@ -9192,8 +9192,8 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) DeviceType(deviceType strin // Entity sets the optional parameter "entity": The entity for customers // that may run multiple different entities, domains, sites or regions, -// for example, "Google US", "Google Ads", "Waymo", "google.com", -// "youtube.com", etc. If this is set, it should be exactly matched with +// for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, +// `youtube.com`, etc. If this is set, it should be exactly matched with // UserEvent.entity to get per-entity autocomplete results. func (c *ProjectsLocationsCatalogsCompleteQueryCall) Entity(entity string) *ProjectsLocationsCatalogsCompleteQueryCall { c.urlParams_.Set("entity", entity) @@ -9372,7 +9372,7 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) Do(opts ...googleapi.CallOp // "type": "string" // }, // "entity": { - // "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, \"Google US\", \"Google Ads\", \"Waymo\", \"google.com\", \"youtube.com\", etc. If this is set, it should be exactly matched with UserEvent.entity to get per-entity autocomplete results.", + // "description": "The entity for customers that may run multiple different entities, domains, sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is set, it should be exactly matched with UserEvent.entity to get per-entity autocomplete results.", // "location": "query", // "type": "string" // }, diff --git a/run/v1/run-api.json b/run/v1/run-api.json index 158009b060f..b9ecdcaa2ba 100644 --- a/run/v1/run-api.json +++ b/run/v1/run-api.json @@ -254,7 +254,7 @@ "type": "string" }, "parent": { - "description": "The namespace in which the domain mapping should be created. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + "description": "Required. The namespace in which the domain mapping should be created. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+$", "required": true, @@ -297,7 +297,7 @@ "type": "string" }, "name": { - "description": "The name of the domain mapping to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + "description": "Required. The name of the domain mapping to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/domainmappings/[^/]+$", "required": true, @@ -327,7 +327,7 @@ ], "parameters": { "name": { - "description": "The name of the domain mapping to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + "description": "Required. The name of the domain mapping to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/domainmappings/[^/]+$", "required": true, @@ -378,7 +378,7 @@ "type": "integer" }, "parent": { - "description": "The namespace from which the domain mappings should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + "description": "Required. The namespace from which the domain mappings should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+$", "required": true, @@ -462,7 +462,7 @@ "type": "string" }, "propagationPolicy": { - "description": "Optional. Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see https://kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.", + "description": "Optional. Specifies the propagation policy of delete. Cloud Run currently ignores this setting.", "location": "query", "type": "string" } @@ -811,7 +811,7 @@ "type": "string" }, "propagationPolicy": { - "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see https://kubernetes.io/docs/concepts/architecture/garbage-collection/ for more information.", + "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background.", "location": "query", "type": "string" } @@ -1529,7 +1529,7 @@ "type": "string" }, "parent": { - "description": "The namespace in which the domain mapping should be created. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + "description": "Required. The namespace in which the domain mapping should be created. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -1572,7 +1572,7 @@ "type": "string" }, "name": { - "description": "The name of the domain mapping to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + "description": "Required. The name of the domain mapping to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/domainmappings/[^/]+$", "required": true, @@ -1602,7 +1602,7 @@ ], "parameters": { "name": { - "description": "The name of the domain mapping to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + "description": "Required. The name of the domain mapping to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/domainmappings/[^/]+$", "required": true, @@ -1653,7 +1653,7 @@ "type": "integer" }, "parent": { - "description": "The namespace from which the domain mappings should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + "description": "Required. The namespace from which the domain mappings should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -1805,7 +1805,7 @@ "type": "string" }, "propagationPolicy": { - "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see https://kubernetes.io/docs/concepts/architecture/garbage-collection/ for more information.", + "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background.", "location": "query", "type": "string" } @@ -2289,7 +2289,7 @@ } } }, - "revision": "20230409", + "revision": "20230416", "rootUrl": "https://run.googleapis.com/", "schemas": { "Addressable": { @@ -2463,7 +2463,7 @@ "type": "object" }, "Configuration": { - "description": "Configuration represents the \"floating HEAD\" of a linear history of Revisions, and optionally how the containers those revisions reference are built. Users create new Revisions by updating the Configuration's spec. The \"latest created\" revision's name is available under status, as is the \"latest ready\" revision's name. See also: https://github.com/knative/specs/blob/main/specs/serving/overview.md#configuration", + "description": "Configuration represents the \"floating HEAD\" of a linear history of Revisions, and optionally how the containers those revisions reference are built. Users create new Revisions by updating the Configuration's spec. The \"latest created\" revision's name is available under status, as is the \"latest ready\" revision's name.", "id": "Configuration", "properties": { "apiVersion": { @@ -2560,19 +2560,19 @@ "type": "array" }, "image": { - "description": "Required. Name of the container image in Dockerhub, Google Artifact Registry, or Google Container Registry. If the host is not provided, Dockerhub is assumed. More info: https://kubernetes.io/docs/concepts/containers/images", + "description": "Required. Name of the container image in Dockerhub, Google Artifact Registry, or Google Container Registry. If the host is not provided, Dockerhub is assumed.", "type": "string" }, "imagePullPolicy": { - "description": "Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images", + "description": "Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise.", "type": "string" }, "livenessProbe": { "$ref": "Probe", - "description": "Periodic probe of container liveness. Container will be restarted if the probe fails. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes" + "description": "Periodic probe of container liveness. Container will be restarted if the probe fails." }, "name": { - "description": "Name of the container specified as a DNS_LABEL (RFC 1123). More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#dns-label-names", + "description": "Name of the container specified as a DNS_LABEL (RFC 1123).", "type": "string" }, "ports": { @@ -2588,7 +2588,7 @@ }, "resources": { "$ref": "ResourceRequirements", - "description": "Compute Resources required by this container. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources" + "description": "Compute Resources required by this container." }, "securityContext": { "$ref": "SecurityContext", @@ -2596,7 +2596,7 @@ }, "startupProbe": { "$ref": "Probe", - "description": "Startup probe of application within the container. All other probes are disabled if a startup probe is provided, until it succeeds. Container will not receive traffic if the probe fails. If not provided, a default startup probe with TCP socket action is used. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes" + "description": "Startup probe of application within the container. All other probes are disabled if a startup probe is provided, until it succeeds. Container will not receive traffic if the probe fails. If not provided, a default startup probe with TCP socket action is used." }, "terminationMessagePath": { "description": "Path at which the file to which the container's termination message will be written is mounted into the container's filesystem. Message written is intended to be brief final status, such as an assertion failure message. Will be truncated by the node if greater than 4096 bytes. The total message length across all containers will be limited to 12kb. Defaults to /dev/termination-log.", @@ -2827,24 +2827,24 @@ "id": "Execution", "properties": { "apiVersion": { - "description": "Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources", + "description": "Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values.", "type": "string" }, "kind": { - "description": "Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds", + "description": "Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase.", "type": "string" }, "metadata": { "$ref": "ObjectMeta", - "description": "Optional. Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata" + "description": "Optional. Standard object's metadata." }, "spec": { "$ref": "ExecutionSpec", - "description": "Optional. Specification of the desired behavior of an execution. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status" + "description": "Optional. Specification of the desired behavior of an execution." }, "status": { "$ref": "ExecutionStatus", - "description": "Output only. Current status of an execution. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status", + "description": "Output only. Current status of an execution.", "readOnly": true } }, @@ -2951,7 +2951,7 @@ "type": "object" }, "ExecutionTemplateSpec": { - "description": "ExecutionTemplateSpec describes the metadata and spec an Execution should have when created from a job. Based on: https://github.com/kubernetes/api/blob/e771f807/core/v1/types.go#L3179-L3190", + "description": "ExecutionTemplateSpec describes the metadata and spec an Execution should have when created from a job.", "id": "ExecutionTemplateSpec", "properties": { "metadata": { @@ -2998,7 +2998,7 @@ "type": "integer" }, "service": { - "description": "Service is the name of the service to place in the gRPC HealthCheckRequest (see https://github.com/grpc/grpc/blob/master/doc/health-checking.md). If this is not specified, the default behavior is defined by gRPC.", + "description": "Service is the name of the service to place in the gRPC HealthCheckRequest. If this is not specified, the default behavior is defined by gRPC.", "type": "string" } }, @@ -3030,7 +3030,7 @@ "type": "string" }, "type": { - "description": "type is used to communicate the status of the reconciliation process. See also: https://github.com/knative/serving/blob/main/docs/spec/errors.md#error-conditions-and-reporting Types common to all resources include: * \"Ready\" or \"Completed\": True when the Resource is ready.", + "description": "type is used to communicate the status of the reconciliation process. Types common to all resources include: * \"Ready\" or \"Completed\": True when the Resource is ready.", "type": "string" } }, @@ -3114,24 +3114,24 @@ "id": "Job", "properties": { "apiVersion": { - "description": "Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources", + "description": "Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values.", "type": "string" }, "kind": { - "description": "Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds", + "description": "Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase.", "type": "string" }, "metadata": { "$ref": "ObjectMeta", - "description": "Optional. Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata" + "description": "Optional. Standard object's metadata." }, "spec": { "$ref": "JobSpec", - "description": "Optional. Specification of the desired behavior of a job. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status" + "description": "Optional. Specification of the desired behavior of a job." }, "status": { "$ref": "JobStatus", - "description": "Output only. Current status of a job. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status", + "description": "Output only. Current status of a job.", "readOnly": true } }, @@ -3373,7 +3373,7 @@ "type": "string" }, "resourceVersion": { - "description": "Opaque string that identifies the server's internal version of this object. It can be used by clients to determine when objects have changed. If the message is passed back to the server, it must be left unmodified. https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency", + "description": "Opaque string that identifies the server's internal version of this object. It can be used by clients to determine when objects have changed. If the message is passed back to the server, it must be left unmodified.", "type": "string" }, "selfLink": { @@ -3520,7 +3520,7 @@ "id": "LocalObjectReference", "properties": { "name": { - "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names", + "description": "Name of the referent.", "type": "string" } }, @@ -3568,7 +3568,7 @@ "additionalProperties": { "type": "string" }, - "description": "Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution. * `run.googleapis.com/container-dependencies`: Revision. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/ingress`: Service. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/network-interfaces`: Revision, Execution. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution. Execution. More info: https://kubernetes.io/docs/user-guide/annotations", + "description": "Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution. * `run.googleapis.com/container-dependencies`: Revision. * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/ingress`: Service. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/network-interfaces`: Revision, Execution. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution.", "type": "object" }, "clusterName": { @@ -3576,7 +3576,7 @@ "type": "string" }, "creationTimestamp": { - "description": "UTC timestamp representing the server time when this object was created. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata", + "description": "UTC timestamp representing the server time when this object was created.", "format": "google-datetime", "type": "string" }, @@ -3610,11 +3610,11 @@ "additionalProperties": { "type": "string" }, - "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and routes. More info: https://kubernetes.io/docs/user-guide/labels", + "description": "Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and routes.", "type": "object" }, "name": { - "description": "Required. The name of the resource. In Cloud Run, name is required when creating top-level resources (Service, Job), must be unique within a Cloud Run project/region, and cannot be changed once created. More info: https://kubernetes.io/docs/user-guide/identifiers#names", + "description": "Required. The name of the resource. Name is required when creating top-level resources (Service, Job), must be unique within a Cloud Run project/region, and cannot be changed once created.", "type": "string" }, "namespace": { @@ -3629,7 +3629,7 @@ "type": "array" }, "resourceVersion": { - "description": "Opaque, system-generated value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server or omit the value to disable conflict-detection. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency", + "description": "Opaque, system-generated value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server or omit the value to disable conflict-detection.", "type": "string" }, "selfLink": { @@ -3637,7 +3637,7 @@ "type": "string" }, "uid": { - "description": "Unique, system-generated identifier for this resource. More info: https://kubernetes.io/docs/user-guide/identifiers#uids", + "description": "Unique, system-generated identifier for this resource.", "type": "string" } }, @@ -3751,7 +3751,7 @@ "description": "HTTPGet specifies the http request to perform." }, "initialDelaySeconds": { - "description": "Number of seconds after the container has started before the probe is initiated. Defaults to 0 seconds. Minimum value is 0. Maximum value for liveness probe is 3600. Maximum value for startup probe is 240. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes", + "description": "Number of seconds after the container has started before the probe is initiated. Defaults to 0 seconds. Minimum value is 0. Maximum value for liveness probe is 3600. Maximum value for startup probe is 240.", "format": "int32", "type": "integer" }, @@ -3770,7 +3770,7 @@ "description": "TCPSocket specifies an action involving a TCP port." }, "timeoutSeconds": { - "description": "Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1. Maximum value is 3600. Must be smaller than period_seconds. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes", + "description": "Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1. Maximum value is 3600. Must be smaller than period_seconds.", "format": "int32", "type": "integer" } @@ -3816,14 +3816,14 @@ "additionalProperties": { "type": "string" }, - "description": "Only memory and CPU are supported. Limits describes the maximum amount of compute resources allowed. The values of the map is string form of the 'quantity' k8s type: https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go", + "description": "Limits describes the maximum amount of compute resources allowed. Only 'cpu' and 'memory' keys are supported. * For supported 'cpu' values, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits", "type": "object" }, "requests": { "additionalProperties": { "type": "string" }, - "description": "Only memory and CPU are supported. Requests describes the minimum amount of compute resources required. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an implementation-defined value. The values of the map is string form of the 'quantity' k8s type: https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go", + "description": "Requests describes the minimum amount of compute resources required. Only `cpu` and `memory` are supported. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an implementation-defined value. * For supported 'cpu' values, go to https://cloud.google.com/run/docs/configuring/cpu. * For supported 'memory' values and syntax, go to https://cloud.google.com/run/docs/configuring/memory-limits", "type": "object" } }, @@ -3866,7 +3866,7 @@ "type": "integer" }, "containers": { - "description": "Containers holds the single container that defines the unit of execution for this Revision. In the context of a Revision, we disallow a number of fields on this Container, including: name and lifecycle. In Cloud Run, only a single container may be provided. The runtime contract is documented here: https://github.com/knative/specs/blob/main/specs/serving/runtime-contract.md", + "description": "Containers holds the single container that defines the unit of execution for this Revision. In the context of a Revision, we disallow a number of fields on this Container, including: name and lifecycle. In Cloud Run, only a single container may be provided.", "items": { "$ref": "Container" }, @@ -3933,7 +3933,7 @@ "type": "object" }, "RevisionTemplate": { - "description": "RevisionTemplateSpec describes the data a revision should have when created from a template. Based on: https://github.com/kubernetes/api/blob/e771f807/core/v1/types.go#L3179-L3190", + "description": "RevisionTemplateSpec describes the data a revision should have when created from a template.", "id": "RevisionTemplate", "properties": { "metadata": { @@ -3948,7 +3948,7 @@ "type": "object" }, "Route": { - "description": "Route is responsible for configuring ingress over a collection of Revisions. Some of the Revisions a Route distributes traffic over may be specified by referencing the Configuration responsible for creating them; in these cases the Route is additionally responsible for monitoring the Configuration for \"latest ready\" revision changes, and smoothly rolling out latest revisions. See also: https://github.com/knative/specs/blob/main/specs/serving/overview.md#route Cloud Run currently supports referencing a single Configuration to automatically deploy the \"latest ready\" Revision from that Configuration.", + "description": "Route is responsible for configuring ingress over a collection of Revisions. Some of the Revisions a Route distributes traffic over may be specified by referencing the Configuration responsible for creating them; in these cases the Route is additionally responsible for monitoring the Configuration for \"latest ready\" revision changes, and smoothly rolling out latest revisions. Cloud Run currently supports referencing a single Configuration to automatically deploy the \"latest ready\" Revision from that Configuration.", "id": "Route", "properties": { "apiVersion": { @@ -4115,7 +4115,7 @@ "type": "object" }, "Service": { - "description": "Service acts as a top-level container that manages a set of Routes and Configurations which implement a network service. Service exists to provide a singular abstraction which can be access controlled, reasoned about, and which encapsulates software lifecycle decisions such as rollout policy and team resource ownership. Service acts only as an orchestrator of the underlying Routes and Configurations (much as a kubernetes Deployment orchestrates ReplicaSets). The Service's controller will track the statuses of its owned Configuration and Route, reflecting their statuses and conditions as its own. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#service", + "description": "Service acts as a top-level container that manages a set of Routes and Configurations which implement a network service. Service exists to provide a singular abstraction which can be access controlled, reasoned about, and which encapsulates software lifecycle decisions such as rollout policy and team resource ownership. Service acts only as an orchestrator of the underlying Routes and Configurations (much as a kubernetes Deployment orchestrates ReplicaSets). The Service's controller will track the statuses of its owned Configuration and Route, reflecting their statuses and conditions as its own.", "id": "Service", "properties": { "apiVersion": { @@ -4236,14 +4236,14 @@ }, "metadata": { "$ref": "ListMeta", - "description": "Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds" + "description": "Standard list metadata." }, "reason": { "description": "A machine-readable description of why this operation is in the \"Failure\" status. If this value is empty there is no information available. A Reason clarifies an HTTP status code but does not override it.", "type": "string" }, "status": { - "description": "Status of the operation. One of: \"Success\" or \"Failure\". More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status", + "description": "Status of the operation. One of: \"Success\" or \"Failure\".", "type": "string" } }, @@ -4284,7 +4284,7 @@ "type": "string" }, "kind": { - "description": "The kind attribute of the resource associated with the status StatusReason. On some operations may differ from the requested resource Kind. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds", + "description": "The kind attribute of the resource associated with the status StatusReason. On some operations may differ from the requested resource Kind.", "type": "string" }, "name": { @@ -4297,7 +4297,7 @@ "type": "integer" }, "uid": { - "description": "UID of the resource. (when there is a single resource which can be described). More info: https://kubernetes.io/docs/user-guide/identifiers#uids", + "description": "UID of the resource. (when there is a single resource which can be described).", "type": "string" } }, @@ -4324,24 +4324,24 @@ "id": "Task", "properties": { "apiVersion": { - "description": "Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources", + "description": "Optional. APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values.", "type": "string" }, "kind": { - "description": "Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds", + "description": "Optional. Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase.", "type": "string" }, "metadata": { "$ref": "ObjectMeta", - "description": "Optional. Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata" + "description": "Optional. Standard object's metadata." }, "spec": { "$ref": "TaskSpec", - "description": "Optional. Specification of the desired behavior of a task. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status" + "description": "Optional. Specification of the desired behavior of a task." }, "status": { "$ref": "TaskStatus", - "description": "Output only. Current status of a task. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status", + "description": "Output only. Current status of a task.", "readOnly": true } }, @@ -4389,7 +4389,7 @@ "type": "string" }, "volumes": { - "description": "Optional. List of volumes that can be mounted by containers belonging to the task. More info: https://kubernetes.io/docs/concepts/storage/volumes", + "description": "Optional. List of volumes that can be mounted by containers belonging to the task.", "items": { "$ref": "Volume" }, @@ -4451,7 +4451,7 @@ "properties": { "spec": { "$ref": "TaskSpec", - "description": "Optional. Specification of the desired behavior of the task. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status" + "description": "Optional. Specification of the desired behavior of the task." } }, "type": "object" diff --git a/run/v1/run-gen.go b/run/v1/run-gen.go index 857e7089701..a6046a4381b 100644 --- a/run/v1/run-gen.go +++ b/run/v1/run-gen.go @@ -760,9 +760,7 @@ func (s *ConfigMapVolumeSource) MarshalJSON() ([]byte, error) { // linear history of Revisions, and optionally how the containers those // revisions reference are built. Users create new Revisions by updating // the Configuration's spec. The "latest created" revision's name is -// available under status, as is the "latest ready" revision's name. See -// also: -// https://github.com/knative/specs/blob/main/specs/serving/overview.md#configuration +// available under status, as is the "latest ready" revision's name. type Configuration struct { // ApiVersion: The API version for this call such as // "serving.knative.dev/v1". @@ -917,24 +915,19 @@ type Container struct { // Image: Required. Name of the container image in Dockerhub, Google // Artifact Registry, or Google Container Registry. If the host is not - // provided, Dockerhub is assumed. More info: - // https://kubernetes.io/docs/concepts/containers/images + // provided, Dockerhub is assumed. Image string `json:"image,omitempty"` // ImagePullPolicy: Image pull policy. One of Always, Never, // IfNotPresent. Defaults to Always if :latest tag is specified, or - // IfNotPresent otherwise. More info: - // https://kubernetes.io/docs/concepts/containers/images#updating-images + // IfNotPresent otherwise. ImagePullPolicy string `json:"imagePullPolicy,omitempty"` // LivenessProbe: Periodic probe of container liveness. Container will - // be restarted if the probe fails. More info: - // https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes + // be restarted if the probe fails. LivenessProbe *Probe `json:"livenessProbe,omitempty"` - // Name: Name of the container specified as a DNS_LABEL (RFC 1123). More - // info: - // https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#dns-label-names + // Name: Name of the container specified as a DNS_LABEL (RFC 1123). Name string `json:"name,omitempty"` // Ports: List of ports to expose from the container. Only a single port @@ -947,8 +940,7 @@ type Container struct { // ReadinessProbe: Not supported by Cloud Run. ReadinessProbe *Probe `json:"readinessProbe,omitempty"` - // Resources: Compute Resources required by this container. More info: - // https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources + // Resources: Compute Resources required by this container. Resources *ResourceRequirements `json:"resources,omitempty"` // SecurityContext: Not supported by Cloud Run. @@ -958,8 +950,6 @@ type Container struct { // other probes are disabled if a startup probe is provided, until it // succeeds. Container will not receive traffic if the probe fails. If // not provided, a default startup probe with TCP socket action is used. - // More info: - // https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes StartupProbe *Probe `json:"startupProbe,omitempty"` // TerminationMessagePath: Path at which the file to which the @@ -1378,28 +1368,22 @@ type Execution struct { // ApiVersion: Optional. APIVersion defines the versioned schema of this // representation of an object. Servers should convert recognized // schemas to the latest internal value, and may reject unrecognized - // values. More info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources + // values. ApiVersion string `json:"apiVersion,omitempty"` // Kind: Optional. Kind is a string value representing the REST resource // this object represents. Servers may infer this from the endpoint the - // client submits requests to. Cannot be updated. In CamelCase. More - // info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds + // client submits requests to. Cannot be updated. In CamelCase. Kind string `json:"kind,omitempty"` - // Metadata: Optional. Standard object's metadata. More info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata + // Metadata: Optional. Standard object's metadata. Metadata *ObjectMeta `json:"metadata,omitempty"` // Spec: Optional. Specification of the desired behavior of an - // execution. More info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status + // execution. Spec *ExecutionSpec `json:"spec,omitempty"` - // Status: Output only. Current status of an execution. More info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status + // Status: Output only. Current status of an execution. Status *ExecutionStatus `json:"status,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1585,8 +1569,7 @@ func (s *ExecutionStatus) MarshalJSON() ([]byte, error) { } // ExecutionTemplateSpec: ExecutionTemplateSpec describes the metadata -// and spec an Execution should have when created from a job. Based on: -// https://github.com/kubernetes/api/blob/e771f807/core/v1/types.go#L3179-L3190 +// and spec an Execution should have when created from a job. type ExecutionTemplateSpec struct { // Metadata: Optional. Optional metadata for this Execution, including // labels and annotations. The following annotation keys set properties @@ -1695,9 +1678,8 @@ type GRPCAction struct { Port int64 `json:"port,omitempty"` // Service: Service is the name of the service to place in the gRPC - // HealthCheckRequest (see - // https://github.com/grpc/grpc/blob/master/doc/health-checking.md). If - // this is not specified, the default behavior is defined by gRPC. + // HealthCheckRequest. If this is not specified, the default behavior is + // defined by gRPC. Service string `json:"service,omitempty"` // ForceSendFields is a list of field names (e.g. "Port") to @@ -1754,10 +1736,8 @@ type GoogleCloudRunV1Condition struct { Status string `json:"status,omitempty"` // Type: type is used to communicate the status of the reconciliation - // process. See also: - // https://github.com/knative/serving/blob/main/docs/spec/errors.md#error-conditions-and-reporting - // Types common to all resources include: * "Ready" or "Completed": True - // when the Resource is ready. + // process. Types common to all resources include: * "Ready" or + // "Completed": True when the Resource is ready. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "LastTransitionTime") @@ -1909,28 +1889,21 @@ type Job struct { // ApiVersion: Optional. APIVersion defines the versioned schema of this // representation of an object. Servers should convert recognized // schemas to the latest internal value, and may reject unrecognized - // values. More info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources + // values. ApiVersion string `json:"apiVersion,omitempty"` // Kind: Optional. Kind is a string value representing the REST resource // this object represents. Servers may infer this from the endpoint the - // client submits requests to. Cannot be updated. In CamelCase. More - // info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds + // client submits requests to. Cannot be updated. In CamelCase. Kind string `json:"kind,omitempty"` - // Metadata: Optional. Standard object's metadata. More info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata + // Metadata: Optional. Standard object's metadata. Metadata *ObjectMeta `json:"metadata,omitempty"` - // Spec: Optional. Specification of the desired behavior of a job. More - // info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status + // Spec: Optional. Specification of the desired behavior of a job. Spec *JobSpec `json:"spec,omitempty"` - // Status: Output only. Current status of a job. More info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status + // Status: Output only. Current status of a job. Status *JobStatus `json:"status,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2350,7 +2323,6 @@ type ListMeta struct { // version of this object. It can be used by clients to determine when // objects have changed. If the message is passed back to the server, it // must be left unmodified. - // https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency ResourceVersion string `json:"resourceVersion,omitempty"` // SelfLink: URL representing this object. @@ -2566,8 +2538,7 @@ func (s *ListTasksResponse) MarshalJSON() ([]byte, error) { // LocalObjectReference contains enough information to let you locate // the referenced object inside the same namespace. type LocalObjectReference struct { - // Name: Name of the referent. More info: - // https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names + // Name: Name of the referent. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -2673,16 +2644,13 @@ type ObjectMeta struct { // `run.googleapis.com/startup-cpu-boost`: Revision. * // `run.googleapis.com/vpc-access-connector`: Revision, Execution. * // `run.googleapis.com/vpc-access-egress`: Revision, Execution. - // Execution. More info: - // https://kubernetes.io/docs/user-guide/annotations Annotations map[string]string `json:"annotations,omitempty"` // ClusterName: Not supported by Cloud Run ClusterName string `json:"clusterName,omitempty"` // CreationTimestamp: UTC timestamp representing the server time when - // this object was created. More info: - // https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata + // this object was created. CreationTimestamp string `json:"creationTimestamp,omitempty"` // DeletionGracePeriodSeconds: Not supported by Cloud Run @@ -2705,15 +2673,12 @@ type ObjectMeta struct { // Labels: Map of string keys and values that can be used to organize // and categorize (scope and select) objects. May match selectors of - // replication controllers and routes. More info: - // https://kubernetes.io/docs/user-guide/labels + // replication controllers and routes. Labels map[string]string `json:"labels,omitempty"` - // Name: Required. The name of the resource. In Cloud Run, name is - // required when creating top-level resources (Service, Job), must be - // unique within a Cloud Run project/region, and cannot be changed once - // created. More info: - // https://kubernetes.io/docs/user-guide/identifiers#names + // Name: Required. The name of the resource. Name is required when + // creating top-level resources (Service, Job), must be unique within a + // Cloud Run project/region, and cannot be changed once created. Name string `json:"name,omitempty"` // Namespace: Required. Defines the space within each name must be @@ -2730,15 +2695,13 @@ type ObjectMeta struct { // concurrency, change detection, and the watch operation on a resource // or set of resources. Clients must treat these values as opaque and // passed unmodified back to the server or omit the value to disable - // conflict-detection. More info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency + // conflict-detection. ResourceVersion string `json:"resourceVersion,omitempty"` // SelfLink: URL representing this object. SelfLink string `json:"selfLink,omitempty"` - // Uid: Unique, system-generated identifier for this resource. More - // info: https://kubernetes.io/docs/user-guide/identifiers#uids + // Uid: Unique, system-generated identifier for this resource. Uid string `json:"uid,omitempty"` // ForceSendFields is a list of field names (e.g. "Annotations") to @@ -2977,8 +2940,7 @@ type Probe struct { // InitialDelaySeconds: Number of seconds after the container has // started before the probe is initiated. Defaults to 0 seconds. Minimum // value is 0. Maximum value for liveness probe is 3600. Maximum value - // for startup probe is 240. More info: - // https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes + // for startup probe is 240. InitialDelaySeconds int64 `json:"initialDelaySeconds,omitempty"` // PeriodSeconds: How often (in seconds) to perform the probe. Default @@ -2996,8 +2958,7 @@ type Probe struct { // TimeoutSeconds: Number of seconds after which the probe times out. // Defaults to 1 second. Minimum value is 1. Maximum value is 3600. Must - // be smaller than period_seconds. More info: - // https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes + // be smaller than period_seconds. TimeoutSeconds int64 `json:"timeoutSeconds,omitempty"` // ForceSendFields is a list of field names (e.g. "Exec") to @@ -3069,18 +3030,22 @@ func (s *ResourceRecord) MarshalJSON() ([]byte, error) { // ResourceRequirements: ResourceRequirements describes the compute // resource requirements. type ResourceRequirements struct { - // Limits: Only memory and CPU are supported. Limits describes the - // maximum amount of compute resources allowed. The values of the map is - // string form of the 'quantity' k8s type: - // https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go + // Limits: Limits describes the maximum amount of compute resources + // allowed. Only 'cpu' and 'memory' keys are supported. * For supported + // 'cpu' values, go to + // https://cloud.google.com/run/docs/configuring/cpu. * For supported + // 'memory' values and syntax, go to + // https://cloud.google.com/run/docs/configuring/memory-limits Limits map[string]string `json:"limits,omitempty"` - // Requests: Only memory and CPU are supported. Requests describes the - // minimum amount of compute resources required. If Requests is omitted - // for a container, it defaults to Limits if that is explicitly - // specified, otherwise to an implementation-defined value. The values - // of the map is string form of the 'quantity' k8s type: - // https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go + // Requests: Requests describes the minimum amount of compute resources + // required. Only `cpu` and `memory` are supported. If Requests is + // omitted for a container, it defaults to Limits if that is explicitly + // specified, otherwise to an implementation-defined value. * For + // supported 'cpu' values, go to + // https://cloud.google.com/run/docs/configuring/cpu. * For supported + // 'memory' values and syntax, go to + // https://cloud.google.com/run/docs/configuring/memory-limits Requests map[string]string `json:"requests,omitempty"` // ForceSendFields is a list of field names (e.g. "Limits") to @@ -3167,9 +3132,7 @@ type RevisionSpec struct { // Containers: Containers holds the single container that defines the // unit of execution for this Revision. In the context of a Revision, we // disallow a number of fields on this Container, including: name and - // lifecycle. In Cloud Run, only a single container may be provided. The - // runtime contract is documented here: - // https://github.com/knative/specs/blob/main/specs/serving/runtime-contract.md + // lifecycle. In Cloud Run, only a single container may be provided. Containers []*Container `json:"containers,omitempty"` // EnableServiceLinks: Not supported by Cloud Run. @@ -3276,8 +3239,7 @@ func (s *RevisionStatus) MarshalJSON() ([]byte, error) { } // RevisionTemplate: RevisionTemplateSpec describes the data a revision -// should have when created from a template. Based on: -// https://github.com/kubernetes/api/blob/e771f807/core/v1/types.go#L3179-L3190 +// should have when created from a template. type RevisionTemplate struct { // Metadata: Optional metadata for this Revision, including labels and // annotations. Name will be generated by the Configuration. The @@ -3326,11 +3288,9 @@ func (s *RevisionTemplate) MarshalJSON() ([]byte, error) { // may be specified by referencing the Configuration responsible for // creating them; in these cases the Route is additionally responsible // for monitoring the Configuration for "latest ready" revision changes, -// and smoothly rolling out latest revisions. See also: -// https://github.com/knative/specs/blob/main/specs/serving/overview.md#route -// Cloud Run currently supports referencing a single Configuration to -// automatically deploy the "latest ready" Revision from that -// Configuration. +// and smoothly rolling out latest revisions. Cloud Run currently +// supports referencing a single Configuration to automatically deploy +// the "latest ready" Revision from that Configuration. type Route struct { // ApiVersion: The API version for this call such as // "serving.knative.dev/v1". @@ -3694,8 +3654,7 @@ func (s *SecurityContext) MarshalJSON() ([]byte, error) { // Configurations (much as a kubernetes Deployment orchestrates // ReplicaSets). The Service's controller will track the statuses of its // owned Configuration and Route, reflecting their statuses and -// conditions as its own. See also: -// https://github.com/knative/serving/blob/main/docs/spec/overview.md#service +// conditions as its own. type Service struct { // ApiVersion: The API version for this call. It must be // "serving.knative.dev/v1". @@ -3916,8 +3875,7 @@ type Status struct { // operation. Message string `json:"message,omitempty"` - // Metadata: Standard list metadata. More info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds + // Metadata: Standard list metadata. Metadata *ListMeta `json:"metadata,omitempty"` // Reason: A machine-readable description of why this operation is in @@ -3926,9 +3884,7 @@ type Status struct { // override it. Reason string `json:"reason,omitempty"` - // Status: Status of the operation. One of: "Success" or "Failure". More - // info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status + // Status: Status of the operation. One of: "Success" or "Failure". Status string `json:"status,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -4020,8 +3976,7 @@ type StatusDetails struct { // Kind: The kind attribute of the resource associated with the status // StatusReason. On some operations may differ from the requested - // resource Kind. More info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds + // resource Kind. Kind string `json:"kind,omitempty"` // Name: The name attribute of the resource associated with the status @@ -4035,8 +3990,7 @@ type StatusDetails struct { RetryAfterSeconds int64 `json:"retryAfterSeconds,omitempty"` // Uid: UID of the resource. (when there is a single resource which can - // be described). More info: - // https://kubernetes.io/docs/user-guide/identifiers#uids + // be described). Uid string `json:"uid,omitempty"` // ForceSendFields is a list of field names (e.g. "Causes") to @@ -4100,28 +4054,21 @@ type Task struct { // ApiVersion: Optional. APIVersion defines the versioned schema of this // representation of an object. Servers should convert recognized // schemas to the latest internal value, and may reject unrecognized - // values. More info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources + // values. ApiVersion string `json:"apiVersion,omitempty"` // Kind: Optional. Kind is a string value representing the REST resource // this object represents. Servers may infer this from the endpoint the - // client submits requests to. Cannot be updated. In CamelCase. More - // info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds + // client submits requests to. Cannot be updated. In CamelCase. Kind string `json:"kind,omitempty"` - // Metadata: Optional. Standard object's metadata. More info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata + // Metadata: Optional. Standard object's metadata. Metadata *ObjectMeta `json:"metadata,omitempty"` - // Spec: Optional. Specification of the desired behavior of a task. More - // info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status + // Spec: Optional. Specification of the desired behavior of a task. Spec *TaskSpec `json:"spec,omitempty"` - // Status: Output only. Current status of a task. More info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status + // Status: Output only. Current status of a task. Status *TaskStatus `json:"status,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -4210,8 +4157,7 @@ type TaskSpec struct { TimeoutSeconds int64 `json:"timeoutSeconds,omitempty,string"` // Volumes: Optional. List of volumes that can be mounted by containers - // belonging to the task. More info: - // https://kubernetes.io/docs/concepts/storage/volumes + // belonging to the task. Volumes []*Volume `json:"volumes,omitempty"` // ForceSendFields is a list of field names (e.g. "Containers") to @@ -4305,8 +4251,6 @@ func (s *TaskStatus) MarshalJSON() ([]byte, error) { // have when created from a template. type TaskTemplateSpec struct { // Spec: Optional. Specification of the desired behavior of the task. - // More info: - // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status Spec *TaskSpec `json:"spec,omitempty"` // ForceSendFields is a list of field names (e.g. "Spec") to @@ -5246,7 +5190,7 @@ func (c *NamespacesDomainmappingsCreateCall) Do(opts ...googleapi.CallOption) (* // "type": "string" // }, // "parent": { - // "description": "The namespace in which the domain mapping should be created. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + // "description": "Required. The namespace in which the domain mapping should be created. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+$", // "required": true, @@ -5431,7 +5375,7 @@ func (c *NamespacesDomainmappingsDeleteCall) Do(opts ...googleapi.CallOption) (* // "type": "string" // }, // "name": { - // "description": "The name of the domain mapping to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + // "description": "Required. The name of the domain mapping to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/domainmappings/[^/]+$", // "required": true, @@ -5585,7 +5529,7 @@ func (c *NamespacesDomainmappingsGetCall) Do(opts ...googleapi.CallOption) (*Dom // ], // "parameters": { // "name": { - // "description": "The name of the domain mapping to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + // "description": "Required. The name of the domain mapping to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/domainmappings/[^/]+$", // "required": true, @@ -5814,7 +5758,7 @@ func (c *NamespacesDomainmappingsListCall) Do(opts ...googleapi.CallOption) (*Li // "type": "integer" // }, // "parent": { - // "description": "The namespace from which the domain mappings should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + // "description": "Required. The namespace from which the domain mappings should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+$", // "required": true, @@ -6023,9 +5967,7 @@ func (c *NamespacesExecutionsDeleteCall) Kind(kind string) *NamespacesExecutions // PropagationPolicy sets the optional parameter "propagationPolicy": // Specifies the propagation policy of delete. Cloud Run currently -// ignores this setting, and deletes in the background. Please see -// https://kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ -// for more information. +// ignores this setting. func (c *NamespacesExecutionsDeleteCall) PropagationPolicy(propagationPolicy string) *NamespacesExecutionsDeleteCall { c.urlParams_.Set("propagationPolicy", propagationPolicy) return c @@ -6143,7 +6085,7 @@ func (c *NamespacesExecutionsDeleteCall) Do(opts ...googleapi.CallOption) (*Stat // "type": "string" // }, // "propagationPolicy": { - // "description": "Optional. Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see https://kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.", + // "description": "Optional. Specifies the propagation policy of delete. Cloud Run currently ignores this setting.", // "location": "query", // "type": "string" // } @@ -7578,9 +7520,7 @@ func (c *NamespacesRevisionsDeleteCall) Kind(kind string) *NamespacesRevisionsDe // PropagationPolicy sets the optional parameter "propagationPolicy": // Specifies the propagation policy of delete. Cloud Run currently -// ignores this setting, and deletes in the background. Please see -// https://kubernetes.io/docs/concepts/architecture/garbage-collection/ -// for more information. +// ignores this setting, and deletes in the background. func (c *NamespacesRevisionsDeleteCall) PropagationPolicy(propagationPolicy string) *NamespacesRevisionsDeleteCall { c.urlParams_.Set("propagationPolicy", propagationPolicy) return c @@ -7703,7 +7643,7 @@ func (c *NamespacesRevisionsDeleteCall) Do(opts ...googleapi.CallOption) (*Statu // "type": "string" // }, // "propagationPolicy": { - // "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see https://kubernetes.io/docs/concepts/architecture/garbage-collection/ for more information.", + // "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background.", // "location": "query", // "type": "string" // } @@ -10909,7 +10849,7 @@ func (c *ProjectsLocationsDomainmappingsCreateCall) Do(opts ...googleapi.CallOpt // "type": "string" // }, // "parent": { - // "description": "The namespace in which the domain mapping should be created. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + // "description": "Required. The namespace in which the domain mapping should be created. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, @@ -11094,7 +11034,7 @@ func (c *ProjectsLocationsDomainmappingsDeleteCall) Do(opts ...googleapi.CallOpt // "type": "string" // }, // "name": { - // "description": "The name of the domain mapping to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + // "description": "Required. The name of the domain mapping to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/domainmappings/[^/]+$", // "required": true, @@ -11248,7 +11188,7 @@ func (c *ProjectsLocationsDomainmappingsGetCall) Do(opts ...googleapi.CallOption // ], // "parameters": { // "name": { - // "description": "The name of the domain mapping to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + // "description": "Required. The name of the domain mapping to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/domainmappings/[^/]+$", // "required": true, @@ -11477,7 +11417,7 @@ func (c *ProjectsLocationsDomainmappingsListCall) Do(opts ...googleapi.CallOptio // "type": "integer" // }, // "parent": { - // "description": "The namespace from which the domain mappings should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + // "description": "Required. The namespace from which the domain mappings should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, @@ -12019,9 +11959,7 @@ func (c *ProjectsLocationsRevisionsDeleteCall) Kind(kind string) *ProjectsLocati // PropagationPolicy sets the optional parameter "propagationPolicy": // Specifies the propagation policy of delete. Cloud Run currently -// ignores this setting, and deletes in the background. Please see -// https://kubernetes.io/docs/concepts/architecture/garbage-collection/ -// for more information. +// ignores this setting, and deletes in the background. func (c *ProjectsLocationsRevisionsDeleteCall) PropagationPolicy(propagationPolicy string) *ProjectsLocationsRevisionsDeleteCall { c.urlParams_.Set("propagationPolicy", propagationPolicy) return c @@ -12144,7 +12082,7 @@ func (c *ProjectsLocationsRevisionsDeleteCall) Do(opts ...googleapi.CallOption) // "type": "string" // }, // "propagationPolicy": { - // "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see https://kubernetes.io/docs/concepts/architecture/garbage-collection/ for more information.", + // "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background.", // "location": "query", // "type": "string" // } diff --git a/speech/v1/speech-api.json b/speech/v1/speech-api.json index b571b009ca1..b420208901e 100644 --- a/speech/v1/speech-api.json +++ b/speech/v1/speech-api.json @@ -524,7 +524,7 @@ } } }, - "revision": "20230323", + "revision": "20230418", "rootUrl": "https://speech.googleapis.com/", "schemas": { "ABNFGrammar": { @@ -596,6 +596,16 @@ }, "type": "array" }, + "kmsKeyName": { + "description": "Output only. The [KMS key name](https://cloud.google.com/kms/docs/resource-hierarchy#keys) with which the content of the ClassItem is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.", + "readOnly": true, + "type": "string" + }, + "kmsKeyVersionName": { + "description": "Output only. The [KMS key version name](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) with which content of the ClassItem is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.", + "readOnly": true, + "type": "string" + }, "name": { "description": "The resource name of the custom class.", "type": "string" @@ -805,6 +815,16 @@ "format": "float", "type": "number" }, + "kmsKeyName": { + "description": "Output only. The [KMS key name](https://cloud.google.com/kms/docs/resource-hierarchy#keys) with which the content of the PhraseSet is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.", + "readOnly": true, + "type": "string" + }, + "kmsKeyVersionName": { + "description": "Output only. The [KMS key version name](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) with which content of the PhraseSet is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.", + "readOnly": true, + "type": "string" + }, "name": { "description": "The resource name of the phrase set.", "type": "string" diff --git a/speech/v1/speech-gen.go b/speech/v1/speech-gen.go index 8373d218412..808f2ffec92 100644 --- a/speech/v1/speech-gen.go +++ b/speech/v1/speech-gen.go @@ -350,6 +350,22 @@ type CustomClass struct { // Items: A collection of class items. Items []*ClassItem `json:"items,omitempty"` + // KmsKeyName: Output only. The KMS key name + // (https://cloud.google.com/kms/docs/resource-hierarchy#keys) with + // which the content of the ClassItem is encrypted. The expected format + // is + // `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKey + // s/{crypto_key}`. + KmsKeyName string `json:"kmsKeyName,omitempty"` + + // KmsKeyVersionName: Output only. The KMS key version name + // (https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) + // with which content of the ClassItem is encrypted. The expected format + // is + // `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKey + // s/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`. + KmsKeyVersionName string `json:"kmsKeyVersionName,omitempty"` + // Name: The resource name of the custom class. Name string `json:"name,omitempty"` @@ -791,6 +807,22 @@ type PhraseSet struct { // both with and without boost to your requests. Boost float64 `json:"boost,omitempty"` + // KmsKeyName: Output only. The KMS key name + // (https://cloud.google.com/kms/docs/resource-hierarchy#keys) with + // which the content of the PhraseSet is encrypted. The expected format + // is + // `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKey + // s/{crypto_key}`. + KmsKeyName string `json:"kmsKeyName,omitempty"` + + // KmsKeyVersionName: Output only. The KMS key version name + // (https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) + // with which content of the PhraseSet is encrypted. The expected format + // is + // `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKey + // s/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`. + KmsKeyVersionName string `json:"kmsKeyVersionName,omitempty"` + // Name: The resource name of the phrase set. Name string `json:"name,omitempty"` diff --git a/speech/v1p1beta1/speech-api.json b/speech/v1p1beta1/speech-api.json index 27749f8c83a..f0997c51a8e 100644 --- a/speech/v1p1beta1/speech-api.json +++ b/speech/v1p1beta1/speech-api.json @@ -524,7 +524,7 @@ } } }, - "revision": "20230323", + "revision": "20230418", "rootUrl": "https://speech.googleapis.com/", "schemas": { "ABNFGrammar": { @@ -596,6 +596,16 @@ }, "type": "array" }, + "kmsKeyName": { + "description": "Output only. The [KMS key name](https://cloud.google.com/kms/docs/resource-hierarchy#keys) with which the content of the ClassItem is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.", + "readOnly": true, + "type": "string" + }, + "kmsKeyVersionName": { + "description": "Output only. The [KMS key version name](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) with which content of the ClassItem is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.", + "readOnly": true, + "type": "string" + }, "name": { "description": "The resource name of the custom class.", "type": "string" @@ -829,6 +839,16 @@ "format": "float", "type": "number" }, + "kmsKeyName": { + "description": "Output only. The [KMS key name](https://cloud.google.com/kms/docs/resource-hierarchy#keys) with which the content of the PhraseSet is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.", + "readOnly": true, + "type": "string" + }, + "kmsKeyVersionName": { + "description": "Output only. The [KMS key version name](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) with which content of the PhraseSet is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.", + "readOnly": true, + "type": "string" + }, "name": { "description": "The resource name of the phrase set.", "type": "string" diff --git a/speech/v1p1beta1/speech-gen.go b/speech/v1p1beta1/speech-gen.go index ac4dcb928a0..78994f7e283 100644 --- a/speech/v1p1beta1/speech-gen.go +++ b/speech/v1p1beta1/speech-gen.go @@ -350,6 +350,22 @@ type CustomClass struct { // Items: A collection of class items. Items []*ClassItem `json:"items,omitempty"` + // KmsKeyName: Output only. The KMS key name + // (https://cloud.google.com/kms/docs/resource-hierarchy#keys) with + // which the content of the ClassItem is encrypted. The expected format + // is + // `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKey + // s/{crypto_key}`. + KmsKeyName string `json:"kmsKeyName,omitempty"` + + // KmsKeyVersionName: Output only. The KMS key version name + // (https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) + // with which content of the ClassItem is encrypted. The expected format + // is + // `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKey + // s/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`. + KmsKeyVersionName string `json:"kmsKeyVersionName,omitempty"` + // Name: The resource name of the custom class. Name string `json:"name,omitempty"` @@ -829,6 +845,22 @@ type PhraseSet struct { // both with and without boost to your requests. Boost float64 `json:"boost,omitempty"` + // KmsKeyName: Output only. The KMS key name + // (https://cloud.google.com/kms/docs/resource-hierarchy#keys) with + // which the content of the PhraseSet is encrypted. The expected format + // is + // `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKey + // s/{crypto_key}`. + KmsKeyName string `json:"kmsKeyName,omitempty"` + + // KmsKeyVersionName: Output only. The KMS key version name + // (https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) + // with which content of the PhraseSet is encrypted. The expected format + // is + // `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKey + // s/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`. + KmsKeyVersionName string `json:"kmsKeyVersionName,omitempty"` + // Name: The resource name of the phrase set. Name string `json:"name,omitempty"` diff --git a/webfonts/v1/webfonts-api.json b/webfonts/v1/webfonts-api.json index 394cd8da5d8..2dd4a735035 100644 --- a/webfonts/v1/webfonts-api.json +++ b/webfonts/v1/webfonts-api.json @@ -104,6 +104,28 @@ "id": "webfonts.webfonts.list", "parameterOrder": [], "parameters": { + "capability": { + "description": "Controls the font urls in `Webfont.files`, by default, static ttf fonts are sent.", + "enum": [ + "CAPABILITY_UNSPECIFIED", + "WOFF2", + "VF" + ], + "enumDescriptions": [ + "Default means static ttf fonts.", + "Use WOFF2(Compressed)instead of ttf.", + "Prefer variable font files instead of static fonts instantiated at standard weights." + ], + "location": "query", + "repeated": true, + "type": "string" + }, + "family": { + "description": "Filters by Webfont.family, using literal match. If not set, returns all families", + "location": "query", + "repeated": true, + "type": "string" + }, "sort": { "description": "Enables sorting of the list.", "enum": [ @@ -124,6 +146,11 @@ ], "location": "query", "type": "string" + }, + "subset": { + "description": "Filters by Webfont.subset, if subset is found in Webfont.subsets. If not set, returns all families.", + "location": "query", + "type": "string" } }, "path": "v1/webfonts", @@ -134,13 +161,41 @@ } } }, - "revision": "20200819", + "revision": "20230419", "rootUrl": "https://webfonts.googleapis.com/", "schemas": { + "Axis": { + "description": "Metadata for a variable font axis.", + "id": "Axis", + "properties": { + "end": { + "description": "maximum value", + "format": "float", + "type": "number" + }, + "start": { + "description": "minimum value", + "format": "float", + "type": "number" + }, + "tag": { + "description": "tag name.", + "type": "string" + } + }, + "type": "object" + }, "Webfont": { "description": "Metadata describing a family of fonts.", "id": "Webfont", "properties": { + "axes": { + "description": "Axis for variable fonts.", + "items": { + "$ref": "Axis" + }, + "type": "array" + }, "category": { "description": "The category of the font.", "type": "string" @@ -164,6 +219,10 @@ "description": "The date (format \"yyyy-MM-dd\") the font was modified for the last time.", "type": "string" }, + "menu": { + "description": "Font URL for menu subset, a subset of the font that is enough to display the font name", + "type": "string" + }, "subsets": { "description": "The scripts supported by the font.", "items": { diff --git a/webfonts/v1/webfonts-gen.go b/webfonts/v1/webfonts-gen.go index dfaa4aff99f..21be279a9f2 100644 --- a/webfonts/v1/webfonts-gen.go +++ b/webfonts/v1/webfonts-gen.go @@ -135,8 +135,61 @@ type WebfontsService struct { s *Service } +// Axis: Metadata for a variable font axis. +type Axis struct { + // End: maximum value + End float64 `json:"end,omitempty"` + + // Start: minimum value + Start float64 `json:"start,omitempty"` + + // Tag: tag name. + Tag string `json:"tag,omitempty"` + + // ForceSendFields is a list of field names (e.g. "End") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "End") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Axis) MarshalJSON() ([]byte, error) { + type NoMethod Axis + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +func (s *Axis) UnmarshalJSON(data []byte) error { + type NoMethod Axis + var s1 struct { + End gensupport.JSONFloat64 `json:"end"` + Start gensupport.JSONFloat64 `json:"start"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.End = float64(s1.End) + s.Start = float64(s1.Start) + return nil +} + // Webfont: Metadata describing a family of fonts. type Webfont struct { + // Axes: Axis for variable fonts. + Axes []*Axis `json:"axes,omitempty"` + // Category: The category of the font. Category string `json:"category,omitempty"` @@ -154,6 +207,10 @@ type Webfont struct { // for the last time. LastModified string `json:"lastModified,omitempty"` + // Menu: Font URL for menu subset, a subset of the font that is enough + // to display the font name + Menu string `json:"menu,omitempty"` + // Subsets: The scripts supported by the font. Subsets []string `json:"subsets,omitempty"` @@ -163,7 +220,7 @@ type Webfont struct { // Version: The font version. Version string `json:"version,omitempty"` - // ForceSendFields is a list of field names (e.g. "Category") to + // ForceSendFields is a list of field names (e.g. "Axes") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -171,8 +228,8 @@ type Webfont struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Category") to include in - // API requests with the JSON null value. By default, fields with empty + // NullFields is a list of field names (e.g. "Axes") to include in API + // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. @@ -240,6 +297,28 @@ func (r *WebfontsService) List() *WebfontsListCall { return c } +// Capability sets the optional parameter "capability": Controls the +// font urls in `Webfont.files`, by default, static ttf fonts are sent. +// +// Possible values: +// +// "CAPABILITY_UNSPECIFIED" - Default means static ttf fonts. +// "WOFF2" - Use WOFF2(Compressed)instead of ttf. +// "VF" - Prefer variable font files instead of static fonts +// +// instantiated at standard weights. +func (c *WebfontsListCall) Capability(capability ...string) *WebfontsListCall { + c.urlParams_.SetMulti("capability", append([]string{}, capability...)) + return c +} + +// Family sets the optional parameter "family": Filters by +// Webfont.family, using literal match. If not set, returns all families +func (c *WebfontsListCall) Family(family ...string) *WebfontsListCall { + c.urlParams_.SetMulti("family", append([]string{}, family...)) + return c +} + // Sort sets the optional parameter "sort": Enables sorting of the list. // // Possible values: @@ -258,6 +337,14 @@ func (c *WebfontsListCall) Sort(sort string) *WebfontsListCall { return c } +// Subset sets the optional parameter "subset": Filters by +// Webfont.subset, if subset is found in Webfont.subsets. If not set, +// returns all families. +func (c *WebfontsListCall) Subset(subset string) *WebfontsListCall { + c.urlParams_.Set("subset", subset) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. @@ -360,6 +447,28 @@ func (c *WebfontsListCall) Do(opts ...googleapi.CallOption) (*WebfontList, error // "id": "webfonts.webfonts.list", // "parameterOrder": [], // "parameters": { + // "capability": { + // "description": "Controls the font urls in `Webfont.files`, by default, static ttf fonts are sent.", + // "enum": [ + // "CAPABILITY_UNSPECIFIED", + // "WOFF2", + // "VF" + // ], + // "enumDescriptions": [ + // "Default means static ttf fonts.", + // "Use WOFF2(Compressed)instead of ttf.", + // "Prefer variable font files instead of static fonts instantiated at standard weights." + // ], + // "location": "query", + // "repeated": true, + // "type": "string" + // }, + // "family": { + // "description": "Filters by Webfont.family, using literal match. If not set, returns all families", + // "location": "query", + // "repeated": true, + // "type": "string" + // }, // "sort": { // "description": "Enables sorting of the list.", // "enum": [ @@ -380,6 +489,11 @@ func (c *WebfontsListCall) Do(opts ...googleapi.CallOption) (*WebfontList, error // ], // "location": "query", // "type": "string" + // }, + // "subset": { + // "description": "Filters by Webfont.subset, if subset is found in Webfont.subsets. If not set, returns all families.", + // "location": "query", + // "type": "string" // } // }, // "path": "v1/webfonts",